ECS：OBS:xDoctor: 手動アップグレード手順

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製品サポートWebページ
  2. OBS(3.9以降):xDoctorパッケージが 5.x で開始(例: 5.1-105.0) - OBS製品サポートWebページ
  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は、インストールしようとしているバージョンが他のノードにあることを検出すると失敗します。

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の再インストールオプションを使用します。

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アクティベーションがスキップされました。 プライマリーノードでのみアクティブです」を参照してください。

xDoctorの実行の最後に、xDoctorはセッションレポートを生成します。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

xDoctorレポートを確認するには、次の手順を実行します。

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

Example:

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)コードが生成される場合があります。これらは、アラートコードに関連する可能性のあるリンクされたナレッジベース記事を検索するのに役立ちます。

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:xDoctor: 手動アップグレード手順

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:xDoctor: 手動アップグレード手順

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

Summary: コマンドラインからxDoctorを手動でアップグレードします。

xDoctorヘルスチェックを実行します。