ECS: OBS: xDoctor: Postup ručního upgradu

Summary: Proveďte ruční upgrade aplikace xDoctor z příkazového řádku.

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 je podpůrný a diagnostický nástroj, který identifikuje a pomáhá vyřešit známé problémy s konfigurací, softwarem a hardwarem, které mohou negativně ovlivnit systémy ECS a OBS. Mezi klíčové funkce patří:

Odstraňování problémů: Pomáhá týmům podpory a zákazníkům identifikovat hlavní příčiny problémů s úložištěm ECS.
Proaktivní monitorování: Detekuje první známky problémů
Zapojení podpory: Některé akce a řešení vyžadují zapojení podpory společnosti Dell.

Technická podpora společnosti Dell doporučuje provádět nejnovější kontrolu stavu aplikace xDoctor ve všech rackech VDC. Stejně jako u každé verze je i aplikace xDoctor aktualizována vylepšenými kontrolami stavu a automatickými léčiteli. Automatické léčitele byly představeny v pozdějších verzích aplikace xDoctor.

Zjistěte nainstalovanou verzi ECS/OBS a aplikace xDoctor:

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

Zjistěte, zda mají všechny uzly stejnou verzi aplikace xDoctor:

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

Ruční upgrade aplikace xDoctor:

Stáhněte si nejnovější verzi aplikace xDoctor v závislosti na výše uvedené verzi systému ECS/OBS. Upozorňujeme, že stahování balíčku xDoctor závisí na verzi kódu v systémech ECS a OBS – vezměte také na vědomí níže uvedené formáty souborů:
1. Ke stažení nejnovější verze je vyžadováno přihlášení:
  1. ECS (3.8 a nižší): Balíček xDoctor začíná verzí 4.x. (Příklad: 4.8-105.0 – Webová stránka podpory produktů ECS
  2. OBS (3.9 a vyšší): Balíček xDoctor začíná na 5.x (příklad: 5.1-105.0) - Webová stránka podpory produktu OBS
  3. Informace o vydání aplikace xDoctor pro staženou verzi obsahují vyhrazenou část věnovanou upgradu aplikace xDoctor.
Nahrajte nejnovější soubor aplikace xDoctor RPM do složky /home/admin adresář uzlu v racku - příklad pod obálkou ECS, postupujte stejně jako u OBS změnou názvu souboru):

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

Spusťte příkaz pro upgrade aplikace xDoctor. Upgrade lze provádět na každý rack nebo na úrovni VDC.

Příkaz pro upgrade racku – povolte všechny automatické léčitele zadáním příkazu 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

Příkaz pro aktualizaci VDC – povolte všechny automatické léčitele zadáním příkazu A:

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

Aplikace xDoctor není jednotná ve všech uzlech:

Pokud je uzel během aktualizací aplikace xDoctor přeinstalován nebo byl offline, může mít jinou verzi než zbytek clusteru:

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

Výstup aplikace xDoctor upozorňující na nejednotnost ve všech uzlech racku:

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

Pokus o upgrade aplikace xDoctor selže, jelikož aplikace xDoctor zjistí, že ostatní uzly mají verzi, kterou se pokoušíte nainstalovat:

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

Pokud jsou uzly na nejnovější verzi, ale chcete v racku znovu použít stejnou verzi aplikace xDoctor, použijte možnost přeinstalace aplikace 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

Zjistěte, zda všechny uzly mají nyní stejnou verzi aplikace xDoctor:

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

Znovu zkontrolujte verzi aplikace xDoctor:

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

Zjistěte, zda mají všechny uzly stejnou verzi aplikace xDoctor:

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

Spusťte kontrolu stavu aplikace xDoctor:

Chcete-li spustit kontrolu stavu aplikace xDoctor, nejprve vymažte mezipaměť a poté spusťte aplikaci 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.

Spuštění kontroly stavu aplikace xDoctor:

admin@node1:~> sudo xdoctor --hr

Skript --hr se pokusí odeslat podporu systému ECS o nejnovější zprávě o kontrole stavu aplikace xDoctor, protože připojení může být zablokováno.

Aplikace xDoctor běží z jednoho uzlu jako primárního uzlu a přenáší reporty aplikace xDoctor ostatních uzlů do tohoto uzlu. Proto na tomto uzlu spusťte aplikaci xDoctor, výchozí je první uzel v racku. Pokud uzel nereaguje na VDC, další uzel se stane "primárním uzlem", tj. uzlem 2. Viz část "Přeskočení aktivace aplikace xDoctor" ve výše uvedeném upgradu aplikace xDoctor, která je aktivní pouze na primárním uzlu.

Na konci spuštění aplikace xDoctor vygeneruje aplikace xDoctor zprávu o relaci. V reportech aplikace xDoctor je třeba zkontrolovat položky jako WARNING, ERROR nebo CRITICAL:

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

Chcete-li zkontrolovat zprávu aplikace xDoctor:

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

Příklad:

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

Výsledkem mohou být kódy doporučeného akčního plánu (RAP). Ty jsou užitečné při hledání propojených článků znalostní báze, které mohou být relevantní pro kód výstrahy.

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: Postup ručního upgradu

Summary: Proveďte ruční upgrade aplikace xDoctor z příkazového řádku.

Instructions

Zjistěte nainstalovanou verzi ECS/OBS a aplikace xDoctor:

Zjistěte, zda mají všechny uzly stejnou verzi aplikace xDoctor:

Ruční upgrade aplikace xDoctor:

Aplikace xDoctor není jednotná ve všech uzlech:

Spusťte kontrolu stavu aplikace xDoctor:

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: Postup ručního upgradu

Summary: Proveďte ruční upgrade aplikace xDoctor z příkazového řádku.

Detailed Article

Instructions

Affected Products

Instructions

Zjistěte nainstalovanou verzi ECS/OBS a aplikace xDoctor:

Zjistěte, zda mají všechny uzly stejnou verzi aplikace xDoctor:

Ruční upgrade aplikace xDoctor:

Aplikace xDoctor není jednotná ve všech uzlech:

Spusťte kontrolu stavu aplikace xDoctor:

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