ECS : OBS : xDoctor : Procédure de mise à niveau manuelle

Summary: Mettez à niveau manuellement xDoctor à partir de la ligne de commande.

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 est un outil de diagnostic et de support qui identifie et permet de résoudre les problèmes de configuration, logiciels et matériels connus susceptibles d’avoir un impact négatif sur les systèmes ECS et OBS. Les principales caractéristiques sont les suivantes :

  • Dépannage : Aide les équipes de support et les clients à identifier les causes premières des problèmes ECS.
  • Surveillance proactive : Détecte les signes avant-coureurs de problèmes
  • Engagement du support : Certaines actions et résolutions nécessitent l’intervention du support Dell.

Le support technique Dell recommande d’effectuer le dernier bilan de santé xDoctor sur tous les racks VDC. Comme pour chaque version, xDoctor est mis à jour avec des bilans de santé améliorés et des guérisseurs automatiques. Les guérisseurs automatiques ont été introduits dans les versions ultérieures de xDoctor.  

Déterminez la version d’ECS/OBS et de xDoctor installée :

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


Déterminez si tous les nœuds ont la même version de xDoctor :

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


Mise à niveau manuelle de xDoctor :

  1. Téléchargez la dernière version de xDoctor en fonction de la version d’ECS/OBS, comme indiqué ci-dessus. Remarque : lors du téléchargement du package xDoctor, cela dépend de votre version du code dans ECS et OBS. Notez également les formats de fichiers ci-dessous :
    1. Pour télécharger la dernière version, vous devez vous connecter :
      1. ECS (3.8 et versions antérieures) : le package xDoctor commence par la version 4.x. (Exemple : 4.8-105.0 - Page Web de support produit ECS
      2. OBS (3.9 et versions ultérieures) : le package xDoctor commence par la version 5.x (Exemple : 5.1-105.0) - Page Web du support produit OBS
      3. Les notes de mise à jour de xDoctor pour la version téléchargée comportent une section dédiée à la mise à niveau de xDoctor.
  2. Téléchargez le dernier fichier RPM xDoctor dans /home/admin répertoire d’un nœud sur le rack - l’exemple ci-dessous couvre ECS, suivez les mêmes étapes qu’avec OBS modification du nom de fichier) :
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. Exécutez la commande xDoctor upgrade. La mise à niveau peut être effectuée par rack ou par VDC.
Commande de mise à niveau du rack : activez tous les auto-guérisseurs en saisissant 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
Commande de mise à niveau VDC : activez tous les auto-guérisseurs en saisissant A: 
# sudo xdoctor --upgrade --vdc-upgrade --local=/home/admin/xDoctor4ECS-4.8.105.0.noarch.rpm
 

xDoctor n’est pas uniforme sur tous les nœuds :

Si un nœud est réinstallé ou était hors ligne lors des mises à jour de xDoctor, il se peut qu’il se retrouve avec une version différente de celle du reste du cluster : 
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']
La sortie xDoctor signale qu’elle n’est pas uniforme sur tous les nœuds du rack : 
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
La tentative de mise à niveau de xDoctor échoue, car xDoctor détecte que les autres nœuds disposent de la version que vous tentez d’installer : 
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 ...
S’il existe des nœuds sur la dernière version, mais que vous souhaitez réappliquer la même version de xDoctor sur le rack, utilisez l’option de réinstallation de 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
Déterminez si tous les nœuds ont désormais la même version de xDoctor : 
admin@node1:~> sudo xdoctor -s
xDoctor Uniform on all nodes: 4.8-105.0.
Vérifiez à nouveau la version de xDoctor : 
admin@node1:~> sudo xdoctor -x
........
ECS Version: 3.8.1.6
-----------------------
xDoctor Version: 4.8-105.0
-----------------------
Déterminez si tous les nœuds ont la même version de xDoctor : 
admin@node1:~> sudo xdoctor -s
xDoctor Uniform on all nodes: 4.8-105.0
 

Exécutez xDoctor Health Check :

Pour exécuter un bilan de santé xDoctor, effacez d’abord le cache, puis exécutez 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.
Pour exécuter le bilan de santé xDoctor : 
admin@node1:~> sudo xdoctor --hr
La commande --hr L’option tente d’envoyer au support ECS le dernier rapport de bilan de santé xDoctor, car la connexion risque d’être bloquée.

xDoctor s’exécute à partir d’un seul nœud en tant que nœud principal et rassemble les rapports xDoctor des autres nœuds sur ce nœud. Par conséquent, exécutez xDoctor sur ce nœud. La valeur par défaut est le premier nœud sur le rack. Si le nœud ne répond pas au VDC, le nœud suivant devient le « nœud principal », autrement dit, le nœud 2. Reportez-vous à la section « xDoctor Activation skipped » dans la mise à niveau de xDoctor ci-dessus, uniquement active sur le nœud principal.

À la fin de l’exécution de xDoctor, xDoctor génère un rapport de session. Les éléments WARNING, ERROR ou CRITICAL sont les éléments à vérifier dans les rapports 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
Pour vérifier le rapport xDoctor : 
sudo xdoctor --report --archive=2022-xxxxxxxxxxxxx -WEC
Exemple : 
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
Les résultats peuvent produire des codes de plan d’action recommandé (RAP). Ils sont utiles pour rechercher des articles de la base de connaissances liés qui peuvent éventuellement être pertinents pour le code d’alerte.

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.