ECS: OBS: xDoctor: Manual Upgrade Procedure

Summary: Voer een handmatige upgrade uit van xDoctor vanaf de opdrachtregel.

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 is een ondersteunings- en diagnosetool die bekende configuratie-, software- en hardwareproblemen identificeert en helpt oplossen die een negatieve invloed kunnen hebben op ECS- en OBS-systemen. De belangrijkste kenmerken zijn:

Probleemoplossing: Helpt supportteams en klanten bij het identificeren van hoofdoorzaken van ECS-problemen.
Proactieve controle: Detecteert vroege tekenen van problemen
Support Engagement: Voor sommige acties en oplossingen is de betrokkenheid van Dell Support vereist.

De technische support van Dell raadt aan om de meest recente xDoctor-healthcheck uit te voeren op alle VDC-racks. Zoals bij elke versie is xDoctor bijgewerkt met verbeterde statuscontroles en automatische herstellers. Autogenezers werden geïntroduceerd in latere xDoctor-versies.

Controleer of de ECS/OBS- en xDoctor-versie is geïnstalleerd:

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

Bepaal of alle knooppunten dezelfde xDoctor-versie hebben:

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

Handmatige xDoctor-upgrade:

Download de nieuwste versie van xDoctor, afhankelijk van de ECS/OBS-versie zoals hierboven. Houd er rekening mee dat bij het downloaden van het xDoctor-pakket dit afhankelijk is van uw codeversie in ECS en OBS - let ook op de onderstaande bestandsindelingen:
1. Meld u aan om de nieuwste versie te downloaden:
  1. ECS (3.8 en lager): het xDoctor-pakket begint met 4.x. (Voorbeeld: 4.8-105.0 - ECS productsupportpagina
  2. OBS (3.9 en hoger): xDoctor-pakket begint met 5.x (voorbeeld: 5.1-105.0) - OBS Product Support webpagina
  3. De xDoctor-releaseopmerkingen voor de gedownloade versie hebben een speciale sectie om xDoctor te upgraden.
Upload het nieuwste xDoctor RPM-bestand naar /home/admin directory van een knooppunt op het rack - voorbeeld onder dekt ECS, volg dezelfde stappen als bij OBS waarbij de bestandsnaam wordt gewijzigd):

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

Voer de xDoctor-upgradeopdracht uit. Upgrade kan per rack of per VDC worden uitgevoerd.

Rackupgrade-opdracht - schakel alle automatische genezers in door A te typen:

# 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-upgradeopdracht - schakel alle automatische herstelers in door A te typen:

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

xDoctor is niet uniform voor alle knooppunten:

Als een knooppunt opnieuw wordt geïnstalleerd of offline was tijdens xDoctor-updates, kan het eindigen met een andere versie dan de rest van het cluster:

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-uitgang met de melding dat deze niet uniform is op alle knooppunten van het rack:

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

Een poging tot een xDoctor-upgrade zou mislukken omdat xDoctor detecteert dat de andere knooppunten de versie hebben die u probeert te installeren:

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 ...

Als er knooppunten op de nieuwste versie staan, maar u dezelfde xDoctor-versie opnieuw op het rack wilt toepassen, gebruikt u de optie xDoctor opnieuw installeren:

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

Bepaal of alle knooppunten nu dezelfde xDoctor-versie hebben:

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

Controleer de xDoctor-versie opnieuw:

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

Bepaal of alle knooppunten dezelfde xDoctor-versie hebben:

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

Voer xDoctor Health Check uit:

Als u een xDoctor-healthcheck wilt uitvoeren, moet u eerst de cache wissen en vervolgens xDoctor uitvoeren:

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.

De xDoctor-healthcheck uitvoeren:

admin@node1:~> sudo xdoctor --hr

De --hr optie probeert ECS-support het meest recente xDoctor-healthcheckrapport te verzenden, omdat de verbinding mogelijk is geblokkeerd.

xDoctor wordt uitgevoerd vanaf een enkel knooppunt als het primaire knooppunt en trekt de xDoctor-rapporten van de andere knooppunten samen naar dat knooppunt. Voer daarom xDoctor uit op dat knooppunt. Standaard is dit knooppunt in het rack. Als het knooppunt niet reageert op de VDC, wordt het volgende knooppunt het "primaire knooppunt", dat wil zeggen knooppunt 2. Zie "xDoctor Activation skipped" in de bovenstaande xDoctor-upgrade, alleen actief op het primaire knooppunt.

Aan het einde van de xDoctor-run genereert xDoctor een sessierapport. De items WARNING, ERROR of CRITICAL zijn de items waarop moet worden gecontroleerd in xDoctor-rapporten:

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

Het xDoctor-rapport controleren:

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

Voorbeeld:

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

De resultaten kunnen RAP-codes (Recommended Action Plan) opleveren. Deze zijn handig om te zoeken naar gekoppelde kennisartikelen die mogelijk relevant kunnen zijn voor de waarschuwingscode.

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: Manual Upgrade Procedure

Summary: Voer een handmatige upgrade uit van xDoctor vanaf de opdrachtregel.

Instructions

Controleer of de ECS/OBS- en xDoctor-versie is geïnstalleerd:

Bepaal of alle knooppunten dezelfde xDoctor-versie hebben:

Handmatige xDoctor-upgrade:

xDoctor is niet uniform voor alle knooppunten:

Voer xDoctor Health Check uit:

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: Manual Upgrade Procedure

Summary: Voer een handmatige upgrade uit van xDoctor vanaf de opdrachtregel.

Detailed Article

Instructions

Affected Products

Instructions

Controleer of de ECS/OBS- en xDoctor-versie is geïnstalleerd:

Bepaal of alle knooppunten dezelfde xDoctor-versie hebben:

Handmatige xDoctor-upgrade:

xDoctor is niet uniform voor alle knooppunten:

Voer xDoctor Health Check uit:

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