ECS: OBS: xDoctor: Procedura ręcznego uaktualniania

Summary: Ręcznie zaktualizuj xDoctor z wiersza polecenia.

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 to narzędzie diagnostyczne i wspomagające, które identyfikuje i pomaga rozwiązać znane problemy z konfiguracją, oprogramowaniem i sprzętem, które mogą mieć negatywny wpływ na systemy ECS i OBS. Kluczowe funkcje obejmują:

Rozwiązywanie problemów: Pomaga zespołom pomocy technicznej i klientom zidentyfikować główne przyczyny problemów z ECS.
Proaktywny monitoring: Wykrywa wczesne oznaki problemów
Zaangażowanie w pomoc techniczną: Niektóre działania i rozwiązania wymagają interwencji działu pomocy technicznej firmy Dell.

Dział pomocy technicznej firmy Dell zaleca przeprowadzenie najnowszej kontroli poprawności działania xDoctor we wszystkich szafach VDC. Podobnie jak w przypadku każdej wersji, xDoctor jest aktualizowany o ulepszone testy stanu zdrowia i automatyczne uzdrowienia. Automatyczne uzdrowienie zostało wprowadzone w późniejszych wersjach xDoctor.

Określ zainstalowaną wersję ECS/OBS i xDoctor:

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

Określ, czy wszystkie węzły mają tę samą wersję xDoctor:

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

Ręczna aktualizacja xDoctor:

Pobierz najnowszą wersję xDoctor w zależności od wersji ECS/OBS jak wyżej. Uwaga podczas pobierania pakietu xDoctor zależy to od wersji kodu w ECS i OBS - zwróć również uwagę na poniższe formaty plików:
1. Aby pobrać najnowszą wersję, wymagane jest zalogowanie:
  1. ECS (3.8 i niżej): pakiet xDoctor zaczyna się od 4.x. (Przykład: 4.8-105.0 — witryna pomocy technicznej dla produktu ECS
  2. OBS (3.9 i nowsze): pakiet xDoctor zaczyna się od 5.x (przykład: 5.1-105.0) - strona pomocy technicznej dla produktów OBS
  3. Informacje dotyczące wydania xDoctor dla pobranej wersji zawierają dedykowaną sekcję do aktualizacji xDoctor.
Prześlij najnowszy plik xDoctor RPM do /home/admin katalog węzła w szafie serwerowej — przykład poniżej dotyczy ECS, wykonaj te same czynności, co w przypadku OBS zmieniając nazwę pliku):

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

Uruchom polecenie aktualizacji xDoctor. Uaktualnienie może być przeprowadzone na szafę serwerową lub na podstawie VDC.

Polecenie aktualizacji szafy serwerowej — włącz wszystkie automatyczne naprawy, wpisując 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

Polecenie uaktualnienia VDC — włącz wszystkie automatyczne naprawy, wpisując A:

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

xDoctor nie jest jednakowy we wszystkich węzłach:

Jeśli węzeł zostanie ponownie zainstalowany lub był w trybie offline podczas aktualizacji xDoctor, może skończyć z inną wersją niż reszta klastra:

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

Dane wyjściowe xDoctor alarmujące, że nie są jednakowe we wszystkich węzłach szafy serwerowej:

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

Próba uaktualnienia xDoctor zakończy się niepowodzeniem, ponieważ xDoctor wykryje, że inne węzły mają wersję, którą próbujesz zainstalować:

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

Jeśli w najnowszej wersji znajdują się węzły, ale chcesz ponownie zastosować tę samą wersję xDoctor w szafie serwerowej, użyj opcji ponownej instalacji 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

Określ, czy wszystkie węzły mają teraz tę samą wersję xDoctor:

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

Sprawdź ponownie wersję xDoctor:

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

Określ, czy wszystkie węzły mają tę samą wersję xDoctor:

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

Uruchom kontrolę poprawności działania xDoctor:

Aby uruchomić kontrolę poprawności działania xDoctor, najpierw wyczyść pamięć podręczną, a następnie uruchom polecenie 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.

Aby uruchomić kontrolę poprawności działania xDoctor:

admin@node1:~> sudo xdoctor --hr

Polecenie --hr próbuje wysłać ECS support najnowszy raport kontroli poprawności działania xDoctor, ponieważ połączenie może być zablokowane.

xDoctor działa z jednego węzła jako podstawowego i pobiera raporty xDoctor innych węzłów do tego węzła. W związku z tym należy uruchomić program xDoctor na tym węźle. Domyślnie jest to pierwszy węzeł w szafie serwerowej. Jeśli węzeł nie reaguje na VDC, następny węzeł staje się "węzłem podstawowym" , czyli węzłem 2. Zobacz "xDoctor Activation skipped" w powyższej aktualizacji xDoctor, aktywnej tylko w głównym węźle.

Na koniec uruchomienia xDoctor generuje raport sesji, WARNING, ERROR lub CRITICAL to pozycje, które należy sprawdzić w raportach xDoctor:

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

Aby sprawdzić raport xDoctor:

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

Przykład:

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

W wyniku tych działań mogą powstać kody zalecanych planów działania (RAP). Są one przydatne do wyszukiwania połączonych artykułów merytorycznych, które mogą być istotne dla kodu alertu.

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: Procedura ręcznego uaktualniania

Summary: Ręcznie zaktualizuj xDoctor z wiersza polecenia.

Instructions

Określ zainstalowaną wersję ECS/OBS i xDoctor:

Określ, czy wszystkie węzły mają tę samą wersję xDoctor:

Ręczna aktualizacja xDoctor:

xDoctor nie jest jednakowy we wszystkich węzłach:

Uruchom kontrolę poprawności działania 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: Procedura ręcznego uaktualniania

Summary: Ręcznie zaktualizuj xDoctor z wiersza polecenia.

Detailed Article

Instructions

Affected Products

Instructions

Określ zainstalowaną wersję ECS/OBS i xDoctor:

Określ, czy wszystkie węzły mają tę samą wersję xDoctor:

Ręczna aktualizacja xDoctor:

xDoctor nie jest jednakowy we wszystkich węzłach:

Uruchom kontrolę poprawności działania 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