ECS: OBS: xDoctor: Manuel opgraderingsprocedure

Summary: Opgrader 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 support- og diagnosticeringsværktøj, der identificerer og hjælper med at løse kendte konfigurations-, software- og hardwareproblemer, der kan påvirke ECS- og OBS-systemer negativt. De vigtigste funktioner omfatter:

Fejlfinding: Hjælper supportteams og kunder med at identificere de grundlæggende årsager til ECS-problemer.
Proaktiv overvågning: Registrerer tidlige tegn på problemer
Supportengagement: Nogle handlinger og løsninger kræver involvering af Dell-support.

Dells tekniske support anbefaler, at du udfører det nyeste xDoctor-helbredstjek på alle VDC-racks. Som med hver version opdateres xDoctor med forbedrede sundhedstjek og autohealere. Auto healere blev introduceret i senere xDoctor versioner.

Find ud af, hvilken ECS/OBS- og xDoctor-version der er installeret:

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

Find ud af, om alle noder har den samme xDoctor-version:

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

Manuel xDoctor-opgradering:

Download den nyeste version af xDoctor afhængigt af ECS / OBS-versionen som ovenfor. Bemærk, når du downloader xDoctor-pakken, dette afhænger af din kodeversion i ECS og OBS - vær også opmærksom på filformaterne nedenfor:
1. Log ind kræves for at downloade den nyeste version:
  1. ECS (3.8 og derunder): xDoctor-pakken starter med 4.x. (Eksempel: 4.8-105.0 - ECS-produktsupportwebsted
  2. OBS (3.9 og derover): xDoctor-pakken starter med 5.x (Eksempel: 5.1-105.0) - OBS Product Support webside
  3. Den xDoctor produktbemærkninger til den downloadede version har en dedikeret sektion til at opgradere xDoctor.
Upload den nyeste xDoctor RPM fil til /home/admin mappe for en node på racket - eksempel under dæksel ECS, følg de samme trin som med OBS, der ændrer filnavnet):

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

Kør xDoctor-opgraderingskommandoen. Opgraderingen kan udføres pr. rack eller VDC.

Rack upgrade command - aktiver alle auto healere ved at 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-opgraderingskommando - aktiver alle automatiske healere ved at skrive A:

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

xDoctor er ikke ensartet på tværs af alle knuder:

Hvis en node geninstalleres eller var offline under xDoctor-opdateringer, kan den ende med en anden version end resten af 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, der advarer 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øg på en xDoctor-opgradering mislykkes, da xDoctor registrerer, at de andre noder har den version, du forsøger at 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 der er noder i den nyeste version, men du vil genanvende den samme xDoctor-version i racket, skal du bruge indstillingen til geninstallation af xDoctor:

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

Find ud af, om alle noder nu har den samme xDoctor-version:

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

Kontroller xDoctor-versionen igen:

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

Find ud af, om alle noder har den samme xDoctor-version:

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

Kør xDoctor Health Check:

Hvis du vil køre et xDoctor-helbredstjek, skal du først rydde cachen og derefter kø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.

Sådan kører du xDoctor-helbredstjekket:

admin@node1:~> sudo xdoctor --hr

Ikonet --hr mulighed forsøger at sende ECS-support den seneste xDoctor-tilstandskontrolrapport, da forbindelsen kan være blokeret.

xDoctor kører fra en enkelt knude som den primære og trækker de andre knuders xDoctor-rapporter sammen på den knude. Kør derfor xDoctor på den node, som standard er den første node på racket. Hvis noden ikke reagerer på VDC, bliver den næste node den "primære node", dvs. knude 2. Se "xDoctor Activation skipped" i ovenstående xDoctor-opgradering, der kun er aktiv på den primære node.

I slutningen af xDoctor-kørslen genererer xDoctor en sessionsrapport, ADVARSEL, FEJL eller KRITISK er de elementer, der skal kontrolleres for 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 at kontrollere 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

Resultaterne kan resultere i RAP-koder (Recommended Action Plan). Disse er nyttige til søgning efter sammenkædede videnartikler, der muligvis kan være relevante for advarselskoden.

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: Manuel opgraderingsprocedure

Summary: Opgrader xDoctor manuelt fra kommandolinjen.

Instructions

Find ud af, hvilken ECS/OBS- og xDoctor-version der er installeret:

Find ud af, om alle noder har den samme xDoctor-version:

Manuel xDoctor-opgradering:

xDoctor er ikke ensartet på tværs af alle knuder:

Kø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: Manuel opgraderingsprocedure

Summary: Opgrader xDoctor manuelt fra kommandolinjen.

Detailed Article

Instructions

Affected Products

Instructions

Find ud af, hvilken ECS/OBS- og xDoctor-version der er installeret:

Find ud af, om alle noder har den samme xDoctor-version:

Manuel xDoctor-opgradering:

xDoctor er ikke ensartet på tværs af alle knuder:

Kø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