ECS: OBS: 엑스닥터: 수동 업그레이드 절차

Summary: 명령줄에서 xDoctor를 수동으로 업그레이드합니다.

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는 ECS 및 OBS 시스템에 부정적인 영향을 미칠 수 있는 알려진 구성, 소프트웨어 및 하드웨어 문제를 식별하고 해결하는 데 도움을 주는 지원 및 진단 툴입니다. 주요 기능에는 다음이 포함됩니다.

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

Dell 기술 지원 부서에서는 모든 VDC 랙에 대해 최신 xDoctor 상태 점검을 수행할 것을 권장합니다. 각 버전과 마찬가지로 xDoctor는 향상된 상태 점검 및 자동 복구로 업데이트됩니다. 자동 힐러는 이후 xDoctor 버전에서 도입되었습니다.

설치된 ECS/OBS 및 xDoctor 버전을 확인합니다.

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

모든 노드의 xDoctor 버전이 동일한지 확인합니다.

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

수동 xDoctor 업그레이드:

위와 같이 ECS/OBS 버전에 따라 최신 버전의 xDoctor를 다운로드합니다. 참고: xDoctor 패키지를 다운로드할 때는 ECS 및 OBS의 코드 버전에 따라 다르므로 아래 파일 형식도 기록해 두십시오.
1. 최신 버전을 다운로드하려면 로그인해야 합니다.
  1. ECS(3.8 이하): xDoctor 패키지는 4.x로 시작합니다. (예: 4.8-105.0 - ECS 제품 지원 웹 페이지
  2. OBS(3.9 이상): xDoctor 패키지는 5.x 로 시작합니다(예: 5.1-105.0) - OBS 제품 지원 웹페이지
  3. 다운로드한 버전의 xDoctor 릴리스 노트에는 xDoctor를 업그레이드하기 위한 전용 섹션이 있습니다.
최신 xDoctor RPM 파일을 다음 위치로 업로드합니다. /home/admin 랙에 있는 노드의 디렉토리 - 아래 예에서는 ECS를 다룹니다. OBS와 동일한 단계를 수행하여 파일 이름을 변경합니다.)

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

xDoctor upgrade 명령을 실행합니다. 랙당 또는 VDC별로 업그레이드를 수행할 수 있습니다.

랙 업그레이드 명령 - 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 업그레이드 명령 - A를 입력하여 모든 자동 복구를 활성화합니다.

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

xDoctor가 모든 노드에서 균일하지 않습니다.

xDoctor 업데이트 중에 노드가 다시 설치되거나 오프라인 상태인 경우 클러스터의 나머지 부분과 다른 버전이 표시될 수 있습니다.

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는 랙의 모든 노드에서 균일하지 않다는 경고 출력을 표시합니다.

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가 다른 노드에 설치하려는 버전이 있음을 감지하므로 xDoctor 업그레이드 시도가 실패합니다.

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

최신 버전의 노드가 있지만 랙에 동일한 xDoctor 버전을 다시 적용하려면 xDoctor reinstall 옵션을 사용합니다.

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

이제 모든 노드의 xDoctor 버전이 동일한지 확인합니다.

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

xDoctor 버전을 다시 확인합니다.

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

모든 노드의 xDoctor 버전이 동일한지 확인합니다.

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

xDoctor 상태 점검을 실행합니다.

xDoctor 상태 점검을 실행하려면 먼저 캐시를 지운 다음 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 상태 점검을 실행하려면 다음을 수행합니다.

admin@node1:~> sudo xdoctor --hr

이 --hr 연결이 차단될 수 있으므로 옵션이 ECS 지원 팀에 최신 xDoctor 상태 점검 보고서를 보내려고 합니다.

xDoctor는 단일 노드에서 기본 노드로 실행되며 다른 노드의 xDoctor 보고를 함께 해당 노드로 가져옵니다. 따라서 해당 노드에서 xDoctor를 실행합니다. 기본값은 랙의 첫 번째 노드입니다. 노드가 VDC에 응답하지 않는 경우 다음 노드는 "주 노드" , 즉 노드 2가 됩니다. 위의 xDoctor 업그레이드에서 주 노드에서만 활성 상태인 "xDoctor Activation skipped" 를 참조하십시오.

xDoctor 실행이 끝나면 xDoctor에서 세션 보고서를 생성합니다. xDoctor 보고서에서 확인할 항목인 WARNING, ERROR 또는 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 보고서를 확인하려면 다음을 수행합니다.

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

예:

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

결과에 따라 RAP(Recommended Action Plan) 코드가 생성될 수 있습니다. 이는 알림 코드와 관련이 있을 수 있는 링크된 기술 자료 문서를 검색하는 데 유용합니다.

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: 엑스닥터: 수동 업그레이드 절차

Summary: 명령줄에서 xDoctor를 수동으로 업그레이드합니다.

Instructions

설치된 ECS/OBS 및 xDoctor 버전을 확인합니다.

모든 노드의 xDoctor 버전이 동일한지 확인합니다.

수동 xDoctor 업그레이드:

xDoctor가 모든 노드에서 균일하지 않습니다.

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: 엑스닥터: 수동 업그레이드 절차

Summary: 명령줄에서 xDoctor를 수동으로 업그레이드합니다.

Detailed Article

Instructions

Affected Products

Instructions

설치된 ECS/OBS 및 xDoctor 버전을 확인합니다.

모든 노드의 xDoctor 버전이 동일한지 확인합니다.

수동 xDoctor 업그레이드:

xDoctor가 모든 노드에서 균일하지 않습니다.

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