ECS: OBS: xDoctor: Manuelles Upgrade – Verfahren

Summary: Führen Sie ein manuelles Upgrade von xDoctor über die Befehlszeile durch.

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 ist ein Support- und Diagnosetool, das bekannte Konfigurations-, Software- und Hardwareprobleme, die sich negativ auf ECS- und OBS-Systeme auswirken können, identifiziert und behebt. Zu den wichtigsten Merkmalen gehören:

Fehlerbehebung: Hilft Supportteams und Kunden, die Ursachen von ECS-Problemen zu identifizieren.
Proaktives Monitoring: Erkennt frühe Anzeichen von Problemen
Supportprojekt: Einige Aktionen und Lösungen erfordern die Beteiligung des Dell Supports.

Der technische Support von Dell empfiehlt, die neueste xDoctor-Integritätsprüfung auf allen VDC-Racks auszuführen. Wie mit jeder Version wird xDoctor mit verbesserten Gesundheitsprüfungen und automatischen Heilern aktualisiert. Autoheiler wurden in späteren xDoctor-Versionen eingeführt.

Ermitteln Sie die installierte ECS/OBS- und xDoctor-Version:

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

Stellen Sie fest, ob alle Nodes die gleiche xDoctor-Version haben:

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

Manuelles xDoctor-Upgrade:

Laden Sie die neueste Version von xDoctor je nach ECS/OBS-Version wie oben beschrieben herunter. Hinweis: Beim Herunterladen des xDoctor-Pakets hängt dies von Ihrer Codeversion in ECS und OBS ab – beachten Sie auch die folgenden Dateiformate:
1. Anmeldung erforderlich , um die neueste Version herunterzuladen:
  1. ECS (3.8 und niedriger): xDoctor-Paket beginnt mit 4.x. (Beispiel: 4.8-105.0 – ECS-Produktsupport-Webseite
  2. OBS (3.9 und höher): xDoctor-Paket beginnt mit 5.x (Beispiel: 5.1-105.0) – OBS-Produktsupport-Webseite
  3. Die xDoctor-Versionshinweise für die heruntergeladene Version enthalten einen eigenen Abschnitt zum Upgrade von xDoctor.
Laden Sie die neueste xDoctor RPM-Datei hoch in /home/admin Verzeichnis eines Nodes im Rack – Beispiel unten Befolgen Sie die gleichen Schritte wie beim Ändern des Dateinamens durch 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

Führen Sie den xDoctor-Upgradebefehl aus. Das Upgrade kann pro Rack oder pro VDC durchgeführt werden.

Rack-Upgrade-Befehl: Aktivieren Sie alle automatischen Reparaturen durch Eingabe von 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-Upgradebefehl: Aktivieren Sie alle automatischen Reparaturen durch Eingabe von A:

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

xDoctor ist nicht auf allen Nodes einheitlich:

Wenn ein Node neu installiert wird oder während der xDoctor-Updates offline war, hat er möglicherweise eine andere Version als der Rest des Clusters:

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']

Die xDoctor-Ausgabe warnt, dass sie nicht auf allen Nodes des Racks einheitlich ist:

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

Der Versuch, ein xDoctor-Upgrade durchzuführen, würde fehlschlagen, da xDoctor erkennt, dass die anderen Nodes die Version haben, die Sie zu installieren versuchen:

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

Wenn es Nodes mit der neuesten Version gibt, Sie aber dieselbe xDoctor-Version im Rack erneut anwenden möchten, verwenden Sie die Option für die xDoctor-Neuinstallation:

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

Stellen Sie fest, ob alle Nodes jetzt die gleiche xDoctor-Version haben:

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

Überprüfen Sie die xDoctor-Version erneut:

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

Stellen Sie fest, ob alle Nodes die gleiche xDoctor-Version haben:

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

Führen Sie die xDoctor-Integritätsprüfung aus:

Um eine xDoctor-Integritätsprüfung auszuführen, löschen Sie zuerst den Cache und führen Sie dann xDoctor aus:

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.

So führen Sie die xDoctor-Integritätsprüfung aus:

admin@node1:~> sudo xdoctor --hr

Die Spalte --hr Die Option versucht, dem ECS-Support den neuesten xDoctor-Integritätsprüfungsbericht zu senden, da die Verbindung möglicherweise blockiert ist.

xDoctor wird von einem einzelnen Node als primärem Node ausgeführt und ruft die xDoctor-Berichte der anderen Nodes auf diesem Node zusammen. Führen Sie daher xDoctor auf diesem Node aus. Standardmäßig ist dies der erste Node im Rack. Wenn der Node nicht auf das VDC reagiert, wird der nächste Node zum "primären Node", d. h. Node 2. Siehe "xDoctor-Aktivierung übersprungen" im obigen xDoctor-Upgrade, nur auf dem primären Node aktiv.

Am Ende der xDoctor-Ausführung erzeugt xDoctor einen Sitzungsbericht. Die Elemente WARNING, ERROR oder CRITICAL sind die Elemente, auf die in xDoctor-Berichten geprüft werden muss:

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

So überprüfen Sie den xDoctor-Bericht:

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

Beispiel:

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

Die Ergebnisse können zu RAP-Codes (Recommended Action Plan) führen. Diese sind nützlich, um nach verknüpften Wissensdatenbank-Artikeln zu suchen, die möglicherweise für den Warnmeldungscode relevant sein könnten.

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: Manuelles Upgrade – Verfahren

Summary: Führen Sie ein manuelles Upgrade von xDoctor über die Befehlszeile durch.

Instructions

Ermitteln Sie die installierte ECS/OBS- und xDoctor-Version:

Stellen Sie fest, ob alle Nodes die gleiche xDoctor-Version haben:

Manuelles xDoctor-Upgrade:

xDoctor ist nicht auf allen Nodes einheitlich:

Führen Sie die xDoctor-Integritätsprüfung aus:

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: Manuelles Upgrade – Verfahren

Summary: Führen Sie ein manuelles Upgrade von xDoctor über die Befehlszeile durch.

Detailed Article

Instructions

Affected Products

Instructions

Ermitteln Sie die installierte ECS/OBS- und xDoctor-Version:

Stellen Sie fest, ob alle Nodes die gleiche xDoctor-Version haben:

Manuelles xDoctor-Upgrade:

xDoctor ist nicht auf allen Nodes einheitlich:

Führen Sie die xDoctor-Integritätsprüfung aus:

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