[アドバイザリ]
VMware ESXi7.0環境においてSPH6.80収録のSmart Storage Administrator CLIが更新されない現象について

概要

VMware ESXi7.0環境において、SPH6.80でSmart Update Manager(SUM)を使用してリモートノードの更新を実施した際に、Smart Storage Administrator CLI(SSA CLI)のアップデートが失敗する現象が発生する場合があります。この現象の対策方法を以下に示します。この現象の対策方法を以下に示します。

発生頻度

高

現象および影響範囲

VMware ESXi7.0環境において、SPH6.80でSUMを使用してリモートノードの更新を実施した際に、SSA CLIのアップデートが失敗する現象が発生します。

インストールログ[View Log]を参照するとSSA CLIにてアップデートエラーが表示されます。

対策方法を参照し、SSA CLIをアンインストール後にインストールを実施してください。

回避策

回避策はありません。

対策方法

以下手順を参照し、SSA CLIをアンインストール後にインストールを実施してください。

1. 「SSA CLIアンインストール方法」を参照し、SSA CLIをアンインストールします。
2. 「SPH適用でのSSA CLIインストール方法」または「SSA CLIコンポーネントでのインストール方法」を参照し、SSA CLIをインストールしてください。

SSA CLIアンインストール方法

1. システム装置(ホスト) の起動画面で「F2」キーを押すとLogin 画面が表示されるので、rootユーザーでログインします。
2. 「System Customization」画面が表示されるので、「Troubleshooting Options」を選択して、「Enter」キーを押下します。
3. ESXi Shell を“Enable”に変更します。
4. ｢Alt」+「F1」キーを押下し、Hypervisorのコンソールを開きます。
5. rootユーザーでログインします。
6. 次のコマンドを実行し、ホストをメンテナンスモードに切り替えます。
   esxcli system maintenanceMode set --enable=true
7. ホストがメンテナンスモードになっていることを確認するためには次のコマンドを実行します。
   esxcli system maintenanceMode get
   メンテナンスモード中の場合、下記メッセージが出力されます
   Enabled
8. 次のコマンドを実行しSSA CLIアンインストールします。
   esxcli software vib remove -n hpessacli -f
   画面表示例:

   

   VIBs Removedにhpessacliが表示されていることを確認し、システム装置を再起動を実施します。
9. システム装置起動後、rootユーザーでログインします。
10. ユーティリティを更新したホストのメンテナンスモードを解除します。
    esxcli system maintenanceMode set --enable=false
11. 次のコマンドで、ホストのメンテナンスモードが終了したことを確認します：
    esxcli system maintenanceMode get
    メンテナンスモードでない場合、次のメッセージが出力されます
    Disabled
12. 以上でSSA CLIのアンインストールは終了です。

SPH適用でのSSA CLIインストール方法

1. SPHでSmart Update Manager(SUM)を実行してください。
2. SSA CLIを選択し、インストールしてください。
3. SSA CLIのインストール結果を確認し、正常にインストールできている事を確認してください。
   画面表示例:

   

SSA CLIコンポーネントでのインストール方法
SPHから該当コンポーネントを取り出し、ESXi上で個別にインストールを実施してください。

1. SPHに格納されているcontents.htmlをブラウザで開いてください。
2. 「Smart Storage Administrator」キーワードで検索し、SSA CLIコンポーネントファイル名を確認してください。
   対象コンポーネント：Smart Storage Administrator (SSA) CLI Smart Component for ESXi 7.0 for Gen10/Gen10 Plus/Gen11 Controllers (cp055515.zip)
3. SPHから取り出したcp055515.zipを解凍し、アップデート用コンポーネントを取り出してください。
4. 「ssacli2-component_6.15.11.0-7.0.0_20754029.zip」 アップデート用コンポーネントをESXiのデータストア(例: /vmfs/volumes/datastore1/)に転送してください。
5. ESXiにrootログインし、次のコマンドを実行しホストをメンテナンスモードに切り替えます。
   esxcli system maintenanceMode set --enable=true
6. ホストがメンテナンスモードになっていることを確認するためには次のコマンドを実行します。
   esxcli system maintenanceMode get
   メンテナンスモード中の場合、下記メッセージが出力されます
   Enabled
7. 下記コマンドにてユーティリティをアップデートしてください。
   esxcli software component apply -d (解凍したインストールパッケージをフルパスで指定）
   ※ファイルのパスはフルパスで記載してください。フルパスで記載しないと、ファイルが認識されず、ユーティリティのアップデートができません。
   例えば、/vmfs/volumes/datastore1/にファイルを格納した場合は以下のようになります。
   esxcli software component apply -d /vmfs/volumes/datastore1/ssacli2-component_6.15.11.0-7.0.0_20754029.zip
8. アップデートが完了すると下記メッセージが表示されます。
   The update completed successfully,but the system needs to be rebooted for the changes to be effective.
9. アップデートが完了したら、システム装置を再起動してください。
10. システム装置の再起動後、下記コマンドを実行し、ユーティリティが適切なバージョンとなっていることを確認してください。
    esxcli software vib list | grep ssacli
    下記メッセージが表示されます。
    ssacli2 6.15.11.0-7.0.0.xxxxxxx
11. ユーティリティを更新したホストのメンテナンスモードを解除します。
    esxcli system maintenanceMode set --enable=false
12. 次のコマンドで、ホストのメンテナンスモードが終了したことを確認します：
    esxcli system maintenanceMode get
    メンテナンスモードでない場合、次のメッセージが出力されます
    Disabled
13. 以上でアップデート作業は完了です。

対象製品

発生条件

対象製品および対象OSに示す環境において、SPH6.80でSUMを使用したSSA CLIのアップグレードを実施する場合に発生します。

対象バージョン

Smart Storage Administrator CLI(SSA CLI)
対象コンポーネント：hpessacli-component
対象バージョン：4.21.7.0-7.0.0以降

バージョン確認方法

以下に示す手順にてユーティリティのバージョンを確認します。
　１．ESXiにrootログインし、下記コマンドを実行します。
　　　esxcli software vib list | grep ssacli
　２．ユーティリティが表示されます。ユーティリティのバージョンを確認してください。
　　　[表示例]
　　　hpessacli　4.21.7.0-7.0.0.xxxxxxx
　　　※ユーティリティ表示が[ssacli2]の場合、本アドバイザリは対象外となります。
　　　[表示例]
　　　ssacli2　6.10.21.0-7.0.0.xxxxxxx

対象OS

VMware ESXi 7.0 Update 2
VMware ESXi 7.0 Update 1

更新情報

2023年5月26日（公開）

*

本ページで記載している内容を予告なく変更することがありますので、あらかじめご了承ください。

文書番号

ADV-2023-0041