ECS : OBS : xDoctor : RAP099 : xDoctor n’est pas uniforme sur tous les nœuds
Summary: Cet article de la base de connaissances explique pourquoi XDR_OBS_099 est signalé car xDoctor n’est pas uniforme sur tous les nœuds.
Symptoms
xDoctor est un outil de diagnostic et de support conçu pour identifier et 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 et OBS.
- 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.
xDoctor signale l’erreur suivante :
------------------------------------------------------
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-85.0': ['169.254.1.3'], '4.8-100.1': ['169.254.1.4', '169.254.1.2', '169.254.1.1']}
RAP = RAP099
Solution = KB 91703
Timestamp = 2025-10-09_120102
PSNT = CKM00000000000 @ 4.8-100.1
Par conséquent, le diagnostic du SEC est limité au périmètre local. Cela signifie que seul un petit ensemble de détecteurs de symptômes peut être testé et que tous les rapports de télémétrie ne peuvent pas être collectés et envoyés à domicile.
Pour confirmer que la version de xDoctor n’est pas uniforme, SSH à un nœud pour vérifier comme indiqué ci-dessous :
# sudo xdoctor -s xDoctor not uniform across all nodes ... Trying xDoctor Resync ... Resync failed: No xDoctor package found for re-installation [4.8-85.0] -> ['169.254.1.3'] [4.8-100.1] -> ['169.254.1.4', '169.254.1.2', '169.254.1.1']
Dans l’exemple ci-dessus, le nœud 3 exécute xDoctor 4.8-85.0 tandis que les nœuds 1, 2 et 4 exécutent xDoctor 4.8-100.1.
Cause
- Un nœud est réinstallé ou était hors ligne lors des mises à jour de xDoctor.
- Un nœud est remplacé et la nouvelle version de xDoctor n’est pas uniforme avec les autres nœuds.
- Extension de la capacité avec de nouveaux nœuds dotés d’une version antérieure de xDoctor
Resolution
Il est vivement recommandé de remédier à ce problème, car cela conduit à des vues topologiques incomplètes de la base installée et à l’ignorance des symptômes connus.
Bien que la synchronisation du nœud soit la solution, la meilleure recommandation est de mettre à niveau xDoctor sur tous les nœuds vers la dernière version pour tous les détecteurs de symptômes et les auto-guérisseurs activés. Les guérisseurs automatiques ont été introduits dans les versions ultérieures de xDoctor.
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 :
- 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 (une connexion est requise pour télécharger le package)
- OBS (3.9 et versions ultérieures) : le package xDoctor commence par la version 5.x (Exemple : 5.1-105.0) - Page Web d’assistance produit OBS (une connexion est requise pour télécharger le package)
|
Pour mettre à niveau xDoctor vers la dernière version, suivez les étapes décrites dans la base de connaissances ECS : OBS : xDoctor : Procédure de mise à niveau manuelle :
Reportez-vous à l’exemple 1 dans la section Informations supplémentaires pour mettre à niveau xDoctor vers la dernière version. |
|
Si la mise à jour de xDoctor vers la dernière version est limitée, nous pouvons synchroniser la dernière version sur le système local. Suivez les étapes décrites dans la base de connaissances ECS : OBS : xDoctor : Procédure de mise à niveau manuelle :
Reportez-vous à l’exemple 2 dans la section Informations supplémentaires pour uniformiser tous les nœuds xDoctor à la dernière version. |
Une fois xDoctor mis à niveau vers la dernière version, vérifiez que la version de xDoctor est uniforme sur tous les nœuds du rack :
# sudo xdoctor -s xDoctor Uniform on all nodes: 4.8-105.0.
Si vous avez besoin d’aide pour effectuer les étapes ci-dessus, contactez le support technique Dell en indiquant cet article de la base de connaissances.
Additional Information
Vous trouverez ci-dessous des exemples fournis conformément à la section de résolution :
Exemple 1 : mise à niveau de xDoctor vers la dernière version
Confirmez le symptôme indiquant que xDoctor n’est pas uniforme sur tous les nœuds - les nœuds ci-dessous 1 à 5 sont sur xDoctor 4.8-102.0 tandis que les nœuds 6 à 10 sont sur 4.8-95.0 :
# sudo xdoctor -s xDoctor not uniform across all nodes ... Trying xDoctor Resync ... Resync failed: No xDoctor package found for re-installation [4.8-102.0] -> ['169.254.2.1', '169.254.2.2', '169.254.2.3', '169.254.2.4', '169.254.2.5'] [4.8-95.0] -> ['169.254.2.10', '169.254.2.11', '169.254.2.8', '169.254.2.9', '169.254.2.6', '169.254.2.7']
Une fois la dernière version de xDoctor téléchargée sur le nœud 1 vers /home/admin, confirmez qu’il existe :
# ls -l /home/admin | grep xDoctor -rw-r--r-- 1 admin users 43793804 Apr 14 08:21 xDoctor4ECS-4.8-102.0.noarch.rpm -rw-r--r-- 1 root root 121382804 Oct 9 11:34 xDoctor4ECS-4.8-105.0.noarch.rpm
Mettez à niveau xDoctor vers la dernière version et activez tous les auto-guérisseurs :
# 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-102.0 - INFO : User selected to enable all Auto Healers ...
2025-10-09 11:36:15,663: xDoctor_4.8-102.0 - INFO : Local Upgrade (/home/admin/xDoctor4ECS-4.8-105.0.noarch.rpm)
2025-10-09 11:36:15,696: xDoctor_4.8-102.0 - INFO : Current Installed xDoctor version is 4.8-102.0
2025-10-09 11:36:15,712: xDoctor_4.8-102.0 - INFO : Requested package version is 4.8-105.0
2025-10-09 11:36:15,713: xDoctor_4.8-102.0 - INFO : Updating xDoctor RPM Package (RPM)
2025-10-09 11:36:15,935: xDoctor_4.8-102.0 - INFO : - Distribute package
2025-10-09 11:36:17,402: xDoctor_4.8-102.0 - INFO : - Install new rpm package
2025-10-09 11:36:33,562: xDoctor_4.8-102.0 - INFO : Enabling Auto Healer: pmon_crontab_check ...
2025-10-09 11:36:33,563: xDoctor_4.8-102.0 - INFO : Enabling Auto Healer: pmon_swapiness_check ...
2025-10-09 11:36:33,563: xDoctor_4.8-102.0 - INFO : Enabling Auto Healer: rsyslogd_check ...
2025-10-09 11:36:33,563: xDoctor_4.8-102.0 - INFO : Enabling Auto Healer: task_md_cleanup_status ...
2025-10-09 11:36:33,563: xDoctor_4.8-102.0 - INFO : Enabling Auto Healer: ntpd_not_running ...
2025-10-09 11:36:33,563: xDoctor_4.8-102.0 - INFO : Enabling Auto Healer: cron_not_running ...
2025-10-09 11:36:33,563: xDoctor_4.8-102.0 - INFO : Enabling Auto Healer: machines_file_error ...
2025-10-09 11:36:33,563: xDoctor_4.8-102.0 - INFO : Enabling Auto Healer: non_uniform_psnt ...
2025-10-09 11:36:33,563: xDoctor_4.8-102.0 - INFO : Enabling Auto Healer: racadm_stale_pid ...
2025-10-09 11:36:33,563: xDoctor_4.8-102.0 - INFO : Enabling Auto Healer: obj_control_svc_check ...
2025-10-09 11:36:33,828: xDoctor_4.8-102.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-102.0 - INFO : xDoctor successfully updated to version 4.8-105.0
Confirmez que xDoctor est désormais uniforme sur tous les nœuds :
# sudo xdoctor -s xDoctor Uniform on all nodes: 4.8-105.0
Exemple 2 : rendre tous les nœuds xDoctor uniformes à la dernière version sur le système local.
Confirmez le symptôme indiquant que xDoctor n’est pas uniforme sur tous les nœuds. Les nœuds 1, 2 et 4 ci-dessous sont sur xDoctor 4.8-100.1, tandis que les nœuds 3 sont sur la version 4.8-85.0 :
# sudo xdoctor -s xDoctor not uniform across all nodes ... Trying xDoctor Resync ... Resync failed: No xDoctor package found for re-installation [4.8-85.0] -> ['169.254.1.3'] [4.8-100.1] -> ['169.254.1.4', '169.254.1.2', '169.254.1.1']
Sur les nœuds 1 (de préférence), 2 ou 4, vérifiez que le package xDoctor 4.8-100.1 existe sur /home/admin:
# ls -l /home/admin | grep xDoctor -rw-r--r-- 1 admin users 43793804 Mar 4 08:21 xDoctor4ECS-4.8-99.0.noarch.rpm -rw-r--r-- 1 root root 121382804 Sep 2 11:34 xDoctor4ECS-4.8-100.1.noarch.rpm
Réinstallez le package xDoctor :
sudo xdoctor --upgrade --local=/home/admin/xDoctor4ECS-4.8-100.1.noarch.rpm --reinstall 2025-10-09 12:24:19,996: xDoctor_4.8-100.1 - INFO : Local Upgrade (/home/admin/xDoctor4ECS-4.8-100.1.noarch.rpm) 2025-10-09 12:24:20,029: xDoctor_4.8-100.1 - INFO : Current Installed xDoctor version is 4.8-100.1 2025-10-09 12:24:20,046: xDoctor_4.8-100.1 - INFO : Requested package version is 4.8-100.1 2025-10-09 12:24:20,046: xDoctor_4.8-100.1 - WARNING : (Re)installing requested xDoctor package ... 2025-10-09 12:24:20,046: xDoctor_4.8-100.1 - INFO : Updating xDoctor RPM Package (RPM) 2025-10-09 12:24:20,176: xDoctor_4.8-100.1 - INFO : - Distribute package 2025-10-09 12:24:21,745: xDoctor_4.8-100.1 - INFO : - Install new rpm package 2025-10-09 12:24:37,095: xDoctor_4.8-100.1 - INFO : xDoctor successfully updated to version 4.8-100.1
Confirmez que xDoctor est désormais uniforme sur tous les nœuds :
sudo -i xdoctor -s xDoctor Uniform on all nodes: 4.8-100.1