ECS: OBS: xDoctor: Manuell oppgraderingsprosedyre

Summary: Oppgrader xDoctor manuelt fra kommandolinjen.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Check out other resources

Instructions

xDoctor er et støtte- og diagnoseverktøy som identifiserer og hjelper til med å løse kjente konfigurasjons-, programvare- og maskinvareproblemer som kan ha negativ innvirkning på ECS- og OBS-systemer. Viktige funksjoner inkluderer:

Feilsøking: Hjelper støtteteam og kunder med å identifisere hovedårsakene til ECS-problemer.
Proaktiv overvåking: Oppdager tidlige tegn på problemer
Støtteengasjement: Noen handlinger og løsninger krever at Dell støtter involveres.

Dell teknisk støtte anbefaler at du tar den nyeste xDoctor-helsesjekken på alle VDC-rack. Som med hver versjon, er xDoctor oppdatert med forbedret helse sjekker og auto healere. Auto healere ble introdusert i senere xDoctor versjoner.

Fastslå hvilken ECS/OBS- og xDoctor-versjon som er installert:

admin@node1:~> sudo xdoctor -x
....................
ECS Version: 3.8.1.6
-----------------------
xDoctor Version: 4.8-104.0
-----------------------

Finn ut om alle noder har samme xDoctor-versjon:

admin@node1:~> sudo xdoctor -s
xDoctor Uniform on all nodes: 4.8-104.0

Manuell xDoctor oppgradering:

Last ned den nyeste versjonen av xDoctor avhengig av ECS / OBS-versjonen som ovenfor. Merk når du laster ned xDoctor-pakken, avhenger dette av kodeversjonen din i ECS og OBS - legg også merke til filformatene nedenfor:
1. Pålogging kreves for å laste ned den nyeste versjonen:
  1. ECS (3.8 og lavere): xDoctor-pakken starter med 4.x. (Eksempel: 4.8-105.0 – ECS-produktstøtteside
  2. OBS (3.9 og høyere): xDoctor-pakken starter med 5.x (Eksempel: 5.1-105.0) – OBS Product Support nettside
  3. Den xDoctor produktmerknader for den versjonen som er lastet ned har en dedikert seksjon for å oppgradere xDoctor.
Last opp den nyeste xDoctor RPM-filen til /home/admin katalog over en node på racket – eksempelet nedenfor dekker ECS, følg de samme trinnene som ved endring av filnavnet for OBS):

admin@node1~> ls -l | grep xDoctor
-rw-r--r-- 1 admin users   20057045 Jul  6  2025 xDoctor4ECS-4.8-104.0.noarch.rpm
-rw-r--r-- 1 admin users   31927626 Aug 26 15:11 xDoctor4ECS-4.8-105.0.noarch.rpm

Kjør xDoctor oppgraderingskommandoen. Oppgradering kan utføres per rack eller per VDC.

Rackoppgraderingskommando - aktiver alle autohealere ved å skrive A:

# sudo xdoctor --upgrade --local=/home/admin/xDoctor4ECS-4.8-105.0.noarch.rpm

admin@node1:~> sudo xdoctor --upgrade --local=/home/admin/xDoctor4ECS-4.8-105.0.noarch.rpm
This new xDoctor RPM has the following Auto Healers:

┌──────────────┐
│ Auto Healers │
└───┬──────────┘
    │
    │ time_zone                              = Enabled
    │ pmon_crontab_check                     = Disabled
    │ pmon_swapiness_check                   = Disabled
    │ rsyslogd_check                         = Disabled
    │ task_md_cleanup_status                 = Disabled
    │ ntpd_not_running                 (New) = Disabled
    │ cron_not_running                 (New) = Disabled
    │ machines_file_error              (New) = Disabled
    │ non_uniform_psnt                 (New) = Disabled
    │ racadm_stale_pid                 (New) = Disabled
    │ obj_control_svc_check            (New) = Disabled

In order to have them active, they need to be enabled ...
You can do this during this upgrade or later post upgrade via `xdoctor --config`

Would you like to enable (A)ll, only the (N)ew ones or (I)gnore them [I]: A

2025-10-09 11:36:15,663: xDoctor_4.8-104.0 - INFO    : User selected to enable all Auto Healers ...
2025-10-09 11:36:15,663: xDoctor_4.8-104.0 - INFO    : Local Upgrade (/home/admin/xDoctor4ECS-4.8-105.0.noarch.rpm)
2025-10-09 11:36:15,696: xDoctor_4.8-104.0 - INFO    : Current Installed xDoctor version is 4.8-104.0
2025-10-09 11:36:15,712: xDoctor_4.8-104.0 - INFO    : Requested package version is 4.8-105.0
2025-10-09 11:36:15,713: xDoctor_4.8-104.0 - INFO    : Updating xDoctor RPM Package (RPM)
2025-10-09 11:36:15,935: xDoctor_4.8-104.0 - INFO    :  - Distribute package
2025-10-09 11:36:17,402: xDoctor_4.8-104.0 - INFO    :  - Install new rpm package
2025-10-09 11:36:33,562: xDoctor_4.8-104.0 - INFO    : Enabling Auto Healer: pmon_crontab_check ...
2025-10-09 11:36:33,563: xDoctor_4.8-104.0 - INFO    : Enabling Auto Healer: pmon_swapiness_check ...
2025-10-09 11:36:33,563: xDoctor_4.8-104.0 - INFO    : Enabling Auto Healer: rsyslogd_check ...
2025-10-09 11:36:33,563: xDoctor_4.8-104.0 - INFO    : Enabling Auto Healer: task_md_cleanup_status ...
2025-10-09 11:36:33,563: xDoctor_4.8-104.0 - INFO    : Enabling Auto Healer: ntpd_not_running ...
2025-10-09 11:36:33,563: xDoctor_4.8-104.0 - INFO    : Enabling Auto Healer: cron_not_running ...
2025-10-09 11:36:33,563: xDoctor_4.8-104.0 - INFO    : Enabling Auto Healer: machines_file_error ...
2025-10-09 11:36:33,563: xDoctor_4.8-104.0 - INFO    : Enabling Auto Healer: non_uniform_psnt ...
2025-10-09 11:36:33,563: xDoctor_4.8-104.0 - INFO    : Enabling Auto Healer: racadm_stale_pid ...
2025-10-09 11:36:33,563: xDoctor_4.8-104.0 - INFO    : Enabling Auto Healer: obj_control_svc_check ...
2025-10-09 11:36:33,828: xDoctor_4.8-104.0 - INFO    : Auto Healer Settings saved and distributed ...

┌──────────────────────┐
│ Updated Auto Healers │
└───┬──────────────────┘
    │
    │ time_zone                              = Enabled
    │ pmon_crontab_check                     = Enabled
    │ pmon_swapiness_check                   = Enabled
    │ rsyslogd_check                         = Enabled
    │ task_md_cleanup_status                 = Enabled
    │ ntpd_not_running                 (New) = Enabled
    │ cron_not_running                 (New) = Enabled
    │ machines_file_error              (New) = Enabled
    │ non_uniform_psnt                 (New) = Enabled
    │ racadm_stale_pid                 (New) = Enabled
    │ obj_control_svc_check            (New) = Enabled

2025-10-09 11:36:33,829: xDoctor_4.8-104.0 - INFO    : xDoctor successfully updated to version 4.8-105.0

VDC-oppgraderingskommando - aktiver alle autohealere ved å skrive A:

# sudo xdoctor --upgrade --vdc-upgrade --local=/home/admin/xDoctor4ECS-4.8.105.0.noarch.rpm

xDoctor er ikke lik på tvers av alle noder:

Hvis en node installeres på nytt eller var frakoblet under xDoctor-oppdateringer, kan den ende opp med en annen versjon enn resten av klyngen:

admin@node1:~> sudo xdoctor -s
xDoctor not uniform across all nodes ...
Trying xDoctor Resync ...
Resync failed: No xDoctor package found for re-installation
[4.8-104.0] -> ['169.254.1.2']
[4.8-105.0] -> ['169.254.1.6', '169.254.1.5', '169.254.1.4', '169.254.1.3', '169.254.1.1']

xDoctor output varsler om at det ikke er ensartet på alle noder i racket:

admin@node1:~> sudo xdoctor --report --archive=2022-06-26_101004 -WEC

xDoctor 4.8.105.0
CKM00xxxxxxxx - ECS 3.8.1.2

Displaying xDoctor Report (2022-06-26_101004) Filter:['CRITICAL', 'ERROR', 'WARNING'] ...

--------------------------------------------
ERROR - xDoctor not uniform across all nodes
--------------------------------------------
Extra     = Not allowed to use the SYSTEM scope, use LOCAL scope instead or reinstall xDoctor -> xdr_versions={'4.8-104.0': ['169.254.1.2'], '4.8-105.0': ['169.254.1.1', '169.254.1.6', '169.254.1.4', '169.254.1.3', '169.254.1.5']}
RAP       = RAP099
Solution  = KB 91703
Timestamp = 2022-06-26_101004
PSNT      = CKM00xxxxxxxx @ 4.8.105.0

Forsøk på en xDoctor oppgradering ville mislykkes som xDoctor oppdager at de andre nodene har den versjonen som du prøver å installere:

admin@node1:~> sudo xdoctor --upgrade --local=/home/admin/xDoctor4ECS-4.8.105.0.noarch.rpm
2022-06-28 15:11:40,101: xDoctor_4.8-105.0 - INFO    : xDoctor Upgrader Instance (2:FTP_SFTP)
2022-06-28 15:11:40,101: xDoctor_4.8-105.0 - INFO    : Local Upgrade (/home/admin/xDoctor4ECS-4.8-105.0.noarch.rpm)
2022-06-28 15:11:40,134: xDoctor_4.8-105.0 - INFO    : Current Installed xDoctor version is 4.8-105.0
2022-06-28 15:11:40,174: xDoctor_4.8-105.0 - INFO    : Requested package version is 4.8-105.0
2022-06-28 15:11:40,174: xDoctor_4.8-105.0 - INFO    : xDoctor is up-to-date, only newer versions allowed ...

Hvis det er noder på den nyeste versjonen, men du vil bruke den samme xDoctor-versjonen på racket, bruk xDoctor reinstall alternativet:

admin@node1:~> sudo xdoctor --upgrade --local=/home/admin/xDoctor4ECS-4.8-105.0.noarch.rpm --reinstall
2022-06-28 15:12:53,079: xDoctor_4.8-105.0 - INFO    : xDoctor Upgrader Instance (2:FTP_SFTP)
2022-06-28 15:12:53,079: xDoctor_4.8-105.0 - INFO    : Local Upgrade (/home/admin/xDoctor4ECS-4.8-105.0.noarch.rpm)
2022-06-28 15:12:53,112: xDoctor_4.8-105.0 - INFO    : Current Installed xDoctor version is 4.8-105.0
2022-06-28 15:12:53,147: xDoctor_4.8-105.0 - INFO    : Requested package version is 4.8-105.0
2022-06-28 15:12:53,148: xDoctor_4.8-105.0 - WARNING : (Re)installing requested xDoctor package ...
2022-06-28 15:12:53,148: xDoctor_4.8-105.0 - INFO    : Updating xDoctor RPM Package (RPM)
2022-06-28 15:12:53,244: xDoctor_4.8-105.0 - INFO    :  - Distribute package
2022-06-28 15:12:54,115: xDoctor_4.8-105.0 - INFO    :  - Install new rpm package
2022-06-28 15:13:08,544: xDoctor_4.8-105.0 - INFO    : xDoctor successfully updated to version 4.8-105.0
2020-09-01 09:04:30,184: xDoctor_4.8-105.0 - INFO    : xDoctor Activation skipped. Only tested on Rack Master

Finn ut om alle noder nå har samme xDoctor-versjon:

admin@node1:~> sudo xdoctor -s
xDoctor Uniform on all nodes: 4.8-105.0.

Kontroller xDoctor-versjonen på nytt:

admin@node1:~> sudo xdoctor -x
........
ECS Version: 3.8.1.6
-----------------------
xDoctor Version: 4.8-105.0
-----------------------

Finn ut om alle noder har samme xDoctor-versjon:

admin@node1:~> sudo xdoctor -s
xDoctor Uniform on all nodes: 4.8-105.0

Kjør xDoctor Health Check:

For å kjøre en xDoctor helsesjekk, tømme hurtigbufferen først, deretter kjøre xDoctor:

admin@node1:~> sudo xdoctor --clear
You are about to clear all xDoctor Cache files. Are you sure you want to proceed?  [No]: yes
2020-09-07 14:03:34,263: xDoctor_4.8-105.0- INFO    : xDoctor Cache files successfully cleared.

Slik kjører du xDoctor-helsesjekken:

admin@node1:~> sudo xdoctor --hr

Informasjonen i --hr -alternativet forsøker å sende ECS-støtte den nyeste xDoctor-helsekontrollrapporten, da tilkoblingen kan være blokkert.

xDoctor kjører fra en enkelt node som den primære, og trekker de andre nodenes xDoctor rapporter sammen på denne noden. Kjør derfor xDoctor på den noden, standard er den første noden på racket. Hvis noden ikke svarer på VDC, blir neste node "primærnoden", det vil si node 2. Se "xDoctor Activation skipped" i xDoctor-oppgraderingen ovenfor, kun aktiv på primærnoden.

På slutten av xDoctor kjøre, genererer xDoctor en økt rapport, den advarsel, feil, eller kritisk er elementene for å se etter i xDoctor rapporter:

admin@node1:~> sudo xdoctor --hr
....................
2020-09-07 13:58:33,520: xDoctor_4.8-105.0 - INFO    : PSNT: CKM00xxxxxxxxxx
2020-09-07 13:58:33,520: xDoctor_4.8-105.0 - INFO    : --------------------
2020-09-07 13:58:33,520: xDoctor_4.8-105.0 - INFO    : Number of CRITICAL:    0
2020-09-07 13:58:33,520: xDoctor_4.8-105.0 - INFO    : Number of FIXED:         0
2020-09-07 13:58:33,520: xDoctor_4.8-105.0 - INFO    : Number of ERROR:       0
2020-09-07 13:58:33,520: xDoctor_4.8-105.0 - INFO    : Number of WARNING:     1
....................
....................
2020-09-07 13:58:42,910: xDoctor_4.8-105.0 - INFO    : --------------------------
2020-09-07 13:58:42,910: xDoctor_4.8-105.0 - INFO    : Session Report                - xdoctor --report --archive=2020-09-07_135109

For å sjekke xDoctor rapporten:

sudo xdoctor --report --archive=2022-xxxxxxxxxxxxx -WEC

Eksempel:

admin@node1:~> sudo xdoctor --report --archive=2XXX-0X-01_0XXXX9 -WEC

xDoctor 4.8-105.0
CKM00xxxxxxxxx - ECS 3.8 Patch 2 (??) - 3.8.0.2 

Displaying xDoctor Report (2XX0-0X-01_0XXXX9) Filter:['CRITICAL', 'ERROR', 'WARNING'] ...

Timestamp    = 2XX0-0X-01_0XXXX9
    Category = Health
    Source   = Disk
    Severity = ERROR
    Node     = 169.254.1.1
    Message  = Boot device is not accessible
    Extra    = {'1XX.2XX.X.5': ['/dev/sdl']}
    RAP      = RAP004
    Solution = 46306

Resultatene kan produsere anbefalte handlingsplan (RAP) koder. Disse er nyttige for å søke etter koblede kunnskapsartikler som muligens kan være relevante for varselkoden.

Affected Products

ECS Appliance

Products

ECS Appliance, ECS Appliance Hardware Gen1 U-Series, ECS Appliance Software with Encryption, ECS Appliance Software without Encryption

Article Number: 000021704

Article Type: How To

Last Modified: 07 نوفمبر 2025

Version: 14

Check if your device is covered by Support Services.

ECS: OBS: xDoctor: Manuell oppgraderingsprosedyre

Summary: Oppgrader xDoctor manuelt fra kommandolinjen.

Instructions

Fastslå hvilken ECS/OBS- og xDoctor-versjon som er installert:

Finn ut om alle noder har samme xDoctor-versjon:

Manuell xDoctor oppgradering:

xDoctor er ikke lik på tvers av alle noder:

Kjør xDoctor Health Check:

Affected Products

Products

Article Properties

Find answers to your questions from other Dell users

Support Services

Article Properties

Find answers to your questions from other Dell users

Support Services

ECS: OBS: xDoctor: Manuell oppgraderingsprosedyre

Summary: Oppgrader xDoctor manuelt fra kommandolinjen.

Detailed Article

Instructions

Affected Products

Instructions

Fastslå hvilken ECS/OBS- og xDoctor-versjon som er installert:

Finn ut om alle noder har samme xDoctor-versjon:

Manuell xDoctor oppgradering:

xDoctor er ikke lik på tvers av alle noder:

Kjør xDoctor Health Check:

Affected Products

Products

Article Properties

Find answers to your questions from other Dell users

Support Services

Article Properties

Find answers to your questions from other Dell users

Support Services