ECS: OBS: xTohtori: Manuaalinen päivitys

Summary: Päivitä xDoctor manuaalisesti komentoriviltä.

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.

Instructions

xDoctor on tuki- ja diagnostiikkatyökalu, joka tunnistaa ja auttaa ratkaisemaan tunnettuja määritys-, ohjelmisto- ja laitteisto-ongelmia, jotka voivat vaikuttaa kielteisesti ECS- ja OBS-järjestelmiin. Tärkeimpiä ominaisuuksia ovat:

  • Vianmääritys: Auttaa tukitiimejä ja asiakkaita tunnistamaan ECS-ongelmien perimmäiset syyt.
  • Ennakoiva valvonta: Havaitsee ongelmien varhaiset merkit
  • Tuen sitoutuminen: Jotkin toimet ja ratkaisut edellyttävät Dellin tukea.

Dellin tekninen tuki suosittelee, että uusimmat xDoctor-kuntotarkistukset tehdään kaikille VDC-kehikoille. Kuten jokainen versio, xDoctor päivitetään parannetuilla terveystarkastuksilla ja automaattisilla parantajilla. Autoparantajat otettiin käyttöön myöhemmissä xDoctor-versioissa.  

Asennetun ECS/OBS- ja xDoctor-version selvittäminen:

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


Selvitä, onko kaikilla solmuilla sama xDoctor-versio:

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


Manuaalinen xDoctor-päivitys:

  1. Lataa xDoctorin uusin versio ECS/OBS-version mukaan yllä kuvatulla tavalla. Huomautus: kun lataat xDoctor-pakettia, tämä riippuu ECS:n ja OBS:n koodiversiosta - huomioi myös alla olevat tiedostomuodot:
    1. Uusimman version lataaminen edellyttää kirjautumista:
      1. ECS (3.8 ja vanhemmat): xDoctor-paketti alkaa numerolla 4.x. (Esimerkki: 4.8-105.0 - ECS-tuotetuen verkkosivu
      2. OBS (3.9 ja uudemmat): xDoctor-paketin alussa on 5.x (esimerkki: 5.1-105.0) - OBS-tuotetuen verkkosivu
      3. Ladatun version xDoctor-julkaisutiedoissa on oma osio xDoctorin päivittämiseksi.
  2. Lataa uusin xDoctor RPM -tiedosto kansioon /home/admin kehikon solmun hakemisto - esimerkki alla kattaa ECS:n, noudata samoja vaiheita kuin OBS:n vaihtaessa tiedostonimeä):
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
  1. Suorita xDoctor-päivityskomento. Päivitys voidaan tehdä kehikko- tai VDC-kohtaisesti.
Rack upgrade -komento - ota kaikki automaattiset parantajat käyttöön kirjoittamalla 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 upgrade -komento - ota kaikki automaattiset parantajat käyttöön kirjoittamalla A:
# sudo xdoctor --upgrade --vdc-upgrade --local=/home/admin/xDoctor4ECS-4.8.105.0.noarch.rpm
 

xDoctor ei ole yhtenäinen kaikissa solmuissa:

Jos solmu asennetaan uudelleen tai se oli offline-tilassa xDoctor-päivitysten aikana, sen versio saattaa poiketa klusterin muusta versiosta:
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-lähtö, joka varoittaa, että se ei ole yhtenäinen kaikissa kehikon solmuissa:
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
xDoctor-päivityksen yrittäminen epäonnistuu, koska xDoctor havaitsee, että muissa solmuissa on versio, jota yrität asentaa:
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 ...
Jos uusimmassa versiossa on solmuja, mutta haluat käyttää samaa xDoctor-versiota uudelleen kehikossa, käytä xDoctor-uudelleenasennusvaihtoehtoa: 
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 
Määritä, onko kaikilla solmuilla nyt sama xDoctor-versio:
admin@node1:~> sudo xdoctor -s
xDoctor Uniform on all nodes: 4.8-105.0.
Tarkista xDoctor-versio uudelleen:
admin@node1:~> sudo xdoctor -x
........
ECS Version: 3.8.1.6
-----------------------
xDoctor Version: 4.8-105.0
-----------------------
Selvitä, onko kaikilla solmuilla sama xDoctor-versio:
admin@node1:~> sudo xdoctor -s
xDoctor Uniform on all nodes: 4.8-105.0
 

Suorita xDoctor Health Check:

Suorita xDoctor-terveystarkastus tyhjentämällä ensin välimuisti ja suorittamalla sitten 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.
xDoctor-terveystarkastuksen suorittaminen:
admin@node1:~> sudo xdoctor --hr
pikanäppäimellä --hr -vaihtoehto yrittää lähettää ECS-tuelle uusimman xDoctor-kuntotarkistusraportin, koska yhteys voi olla tukossa.

xDoctor toimii yhdestä solmusta ensisijaisena ja vetää muiden solmujen xDoctor-raportit yhteen kyseiseen solmuun. Suorita siis kyseisessä solmussa xDoctor, oletus on kehikon ensimmäinen solmu. Jos solmu ei vastaa VDC:hen, seuraavasta solmusta tulee ensisijainen solmu eli solmu 2. Katso "xDoctor-aktivointi ohitettu" yllä olevassa xDoctor-päivityksessä, aktiivinen vain ensisijaisessa solmussa.

xDoctor-suorituksen lopussa xDoctor luo istuntoraportin, ja xDoctor-raporteissa on tarkistettava WARNING, ERROR tai 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
xDoctor-raportin tarkistaminen:
sudo xdoctor --report --archive=2022-xxxxxxxxxxxxx -WEC
Esimerkki:
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
Tuloksista voidaan saada Recommended Action Plan (RAP) -koodeja. Nämä ovat hyödyllisiä etsittäessä linkitettyjä tietoartikkeleita, jotka voivat mahdollisesti liittyä varoituskoodiin.

Affected Products

ECS Appliance

Products

ECS Appliance, ECS Appliance Hardware Gen1 U-Series, ECS Appliance Software with Encryption, ECS Appliance Software without Encryption
Article Properties
Article Number: 000021704
Article Type: How To
Last Modified: 07 نوفمبر 2025
Version:  14
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.