ECS: OBS: 엑스닥터: RAP099: xDoctor가 모든 노드에서 균일하지 않음

xDoctor는 ECS 및 OBS 시스템에 부정적인 영향을 미칠 수 있는 알려진 구성, 소프트웨어 및 하드웨어 문제를 식별하고 해결하도록 설계된 지원 및 진단 툴입니다. 주요 기능에는 다음이 포함됩니다.

• 문제 해결: 지원 팀과 고객이 ECS 및 OBS 문제의 근본 원인을 파악하도록 지원합니다.
• 사전 예방적 모니터링: 문제의 조기 징후 탐지
• 지원 계약: 일부 조치 및 해결 방법에는 Dell 지원 부서의 개입이 필요합니다.

xDoctor가 다음 오류를 보고합니다.

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

따라서 ECS 진단은 로컬 범위로 제한됩니다. 즉, 소수의 증상 감지기만 테스트할 수 있으며 모든 원격 측정 보고서를 수집하여 집으로 보낼 수 있는 것은 아닙니다.

xDoctor 버전이 균일하지 않은지 확인하려면 SSH 노드에 추가하여 아래와 같이 확인합니다.

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

위의 예에서 노드 3은 xDoctor 4.8-85.0을 실행하고 노드 1, 2, 4는 xDoctor 4.8-100.1을 실행합니다.

• 노드가 재설치되거나 xDoctor 업데이트 중에 오프라인 상태입니다.
• 노드가 교체되고 새 노드 xDoctor 버전이 다른 노드와 동일하지 않습니다.
• 이전 xDoctor 버전이 있는 새 노드로 용량 확장

이 경우 설치 기반의 토폴로지 보기가 불완전해지고 알려진 증상을 인식하지 못하게 되므로 이 문제를 해결하는 것이 좋습니다.

노드를 동기화하는 것이 해결책이지만, 가장 좋은 방법은 모든 노드에서 활성화된 모든 증상 감지기 및 자동 치유기의 xDoctor를 최신 버전으로 업그레이드하는 것입니다. 자동 힐러는 이후 xDoctor 버전에서 도입되었습니다.

참고: xDoctor 패키지를 다운로드할 때는 ECS 및 OBS의 코드 버전에 따라 다르므로 아래 파일 형식도 기록해 두십시오.

• ECS(3.8 이하): xDoctor 패키지는 4.x로 시작합니다. (예: 4.8-105.0) - ECS 제품 지원 웹 페이지(패키지를 다운로드하려면 로그인 필요)
• OBS(3.9 이상): xDoctor 패키지는 5.x 로 시작합니다(예: 5.1-105.0) - OBS 제품 지원 웹페이지(패키지를 다운로드하려면 로그인 필요)

xDoctor가 최신 버전으로 업그레이드되면 랙의 모든 노드에서 xDoctor 버전이 균일한지 확인합니다.

# sudo xdoctor -s
xDoctor Uniform on all nodes: 4.8-105.0.

위의 단계에서 도움이 필요한 경우 이 KB를 참조하여 Dell 기술 지원 부서에 문의하십시오.

다음은 해결 방법 섹션에 따라 제공되는 예입니다.

예 1 - xDoctor를 최신 버전으로
업그레이드 모든 노드에서 xDoctor가 균일하지 않다는 증상 확인 - 아래 노드 1-5는 xDoctor 4.8-102.0에 있고 노드 6-10은 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']

노드 1에서 최신 버전의 xDoctor를 /home/admin에서 다음을 확인합니다.

# 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

xDoctor를 최신 버전으로 업그레이드하고 모든 자동 힐러를 활성화하십시오.

# 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

이제 xDoctor가 모든 노드에서 균일한지 확인합니다.

# sudo xdoctor -s
xDoctor Uniform on all nodes: 4.8-105.0

예 2 - 모든 노드 xDoctor를 로컬 시스템의 마지막 버전과 동일하게 만듭니다.
xDoctor가 모든 노드에서 균일하지 않다는 증상을 확인합니다. 노드 1, 2, 4는 xDoctor 4.8-100.1에 있고 노드 3은 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']

노드 1(권장), 2 또는 4에서 xDoctor 4.8-100.1 패키지가 /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

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

이제 xDoctor가 모든 노드에서 균일한지 확인합니다.

sudo -i xdoctor -s
xDoctor Uniform on all nodes: 4.8-100.1