本ページの製品は2024年4月1日より、エフサステクノロジーズ株式会社に統合となり、順次、切り替えを実施してまいります。一部、富士通表記が混在することがありますので、ご了承ください。

SANtricity 11.9 Commands ( CA08871-194 ～ 196 )

ダウンロード可能なSMcliコマンドラインパラメーター

SANtricity OS 11.60以降のリリースでは、SANtricity System Managerから直接HTTP版のCLI（「Secure CLI」またはSMcliとも呼ばれます）をダウンロードしてインストールできます。

11.60以降のダウンロード可能なSMcliコマンドラインパラメーター

ダウンロード可能なSMcliバージョンは、ETERNUS AB6100、ETERNUS AB3100、ETERNUS HB5100/HB5200、ETERNUS AB5100、ETERNUS HB2100/HB2200/HB2300、ETERNUS AB2100およびETERNUS HB1100/HB1200の各コントローラーで使用できます。SANtricity System Manager内でSMcliをダウンロードするには、[設定]>[システム]および[アドオン]>[コマンドラインインターフェイス]を選択します。

CLIコマンドを実行する管理システムに、Java Runtime Environment（JRE）バージョン8以降がインストールされている必要があります。

以前のバージョンのSMcliと同様に、SANtricity System ManagerからダウンロードできるSMcliにも一意のパラメーターセットがあります。

多要素認証

SAML（Security Assertion Markup Language）が有効になっている場合、CLIで使用できるのはアクセストークンのみです。SAMLが有効になっていない場合は、ユーザー名 / パスワードまたはアクセストークンを使用できます。アクセストークンは、SANtricity System Managerで生成できます。

Table 1. アクセストークン、ユーザー名、およびパスワードのパラメーター
パラメーター	定義
`-t`	ストレージシステムでの認証に使用するアクセストークンを定義します。アクセストークンは、ユーザー名とパスワードの代わりに使用します。
`-T`（大文字）	この引数には、次の2つの引数のどちらかが必要です。 `access_token-file` - 認証に使用するアクセストークンを含むファイルを指定します。 `-(dash)` - stdinからアクセストークンを読み取ります。
`-u`	このパラメーターは、`username` 変数とともに使用します。このパラメーターは、アクセストークンを使用しない場合に必要です。
`-p`	コマンドを実行するストレージシステムのパスワードを定義します。以下の条件に該当する場合、パスワードは必要ありません。ストレージシステムにパスワードが設定されていない。実行するスクリプトファイル内にパスワードが指定されている。
`-P`（大文字）	この引数には、次の2つの引数のどちらかが必要です。 `password_file` - 認証に使用するパスワードを含むファイルを指定します。 `-`（1つのダッシュ） - `stdin`からパスワードを読み込みます。

HTTPSモードの一般的なコマンドラインパラメーター

ダウンロード可能なSMcliでサポートされるのはHTTPSモードのみです。HTTPSモードで一般的に使用されるコマンドラインパラメーターは次のとおりです。

パラメーター定義

host-name-or-IP-address

アウトオブバンド管理のストレージシステムのホスト名またはインターネットプロトコル（IP）アドレス（xxx.xxx.xxx.xxx）を指定します。

各コントローラー上のイーサネット接続からアウトオブバンドでストレージを管理している場合は、コントローラーのhost-name-or-IP-addressを指定する必要があります。

-k

この引数はオプションで、httpsクライアントをセキュアーでないモードで実行する場合に指定します。指定した場合、ストレージシステムの証明書は検証されません。この引数を省略した場合、デフォルトで適切な検証が実行されます。

ストレージシステム証明書の管理の詳細については、「格納済み証明書の管理コマンドラインパラメーター」を参照してください。

-e

構文チェックを実行せずにコマンドを実行します。

-L（大文字）

ダウンロード可能なSMcliの法的通知を表示します。

-n

スクリプトコマンドを実行する、ローカルに格納されたラベルを指定します。host-name-or-IP-addressを使用する場合、このパラメーターは省略可能です。host-name-or-IP-addressを使用しない場合、ローカルに格納されたラベルは必須です。

ローカルに格納されたラベルを使用してストレージシステムを管理する方法の詳細については、「格納済みシステムの管理コマンドラインパラメーター」を参照してください。

-o

スクリプトコマンドの実行で生成されるすべての出力テキストの保存先ファイル名を指定します。-oパラメーターは以下のパラメーターとともに使用します。

-c
-f

出力ファイルを指定しない場合、出力テキストは標準出力（stdout）に出力されます。このパラメーターが設定されているかに関係なく、スクリプトコマンド以外のコマンドからの出力はすべて`stdout`に送信されます。

-S（大文字）

スクリプトコマンドの実行時に表示される、進捗状況を示す情報メッセージが表示されないようにします（このモードはサイレントモードとも呼ばれます）。このパラメーターを使用すると、以下のメッセージが表示されなくなります。

Performing syntax check
Syntax check complete
Executing script
Script execution complete
SMcli completed successfully

-version

ダウンロード可能なSMcliバージョンを表示します。

-?

CLIコマンドの使用方法を表示します。

格納されているシステムの管理

次のコマンドラインパラメーターを使用すると、ローカルに格納たラベルを使用して、格納されているシステムを管理できます。

ローカルに格納されたラベルは、SANtricity System Managerに表示される実際のストレージシステム名と一致しない場合があります。

パラメーター定義

SMcli storageArrayLabel show all

ローカルに格納されたすべてのラベルとその関連アドレスを表示します。

SMcli storageArrayLabel show label <LABEL>

ローカルに格納された<LABEL>という名前のラベルに関連付けられているアドレスを表示します。

SMcli storageArrayLabel delete all

ローカルに格納されたラベルをすべて削除します。

SMcli storageArrayLabel delete label <LABEL>

ローカルに格納された<LABEL>という名前のラベルを削除します。

SMcli <host-name-or-IP-address> [host-name-or-IP-address] storageArrayLabel add label <LABEL>

指定したアドレスを含む、ローカルに格納された<LABEL>という名前のラベルを追加します。
更新は直接実行することはできません。更新するには、ラベルを削除してから再度追加します。

SMcliは、ローカルに格納されたラベルを追加するときにストレージシステムにアクセスしません。

格納済み証明書の管理コマンドラインパラメーター

パラメーター

定義

SMcli localCertificate show all

ローカルに保存されているすべての信頼できる証明書を表示します

SMcli localCertificate show alias <ALIAS>

エイリアス <ALIAS> でローカルに保存されている信頼された証明書を表示します

SMcli localCertificate delete all

ローカルに保存されている信頼された証明書をすべて削除します

SMcli localCertificate delete alias <ALIAS>

エイリアス <ALIAS> でローカルに保存されている信頼された証明書を削除します

SMcli localCertificate trust file <CERT_FILE> alias <ALIAS>

エイリアス<ALIAS>を使用して、信頼できる証明書を保存します。
証明書は、別の処理（Webブラウザーを使用するなど）でコントローラーからダウンロードされます。

SMcli <host-name-or-IP-address> [host-name-or-IP-address] localCertificate trust

各アドレスに接続し、返された証明書を信頼された証明書ストアに保存します。
指定したホスト名またはIPアドレスは、この方法で保存された各証明書のエイリアスとして使用されます。
ユーザーは、このコマンドを実行する前に、コントローラー上の証明書が信頼できるものであることを確認する必要があります。
最大限のセキュリティを確保するためには、ファイルを取得するtrustコマンドを使用して、ユーザーが検証してからこのコマンドを実行するまでの間に証明書が変更されていないことを確認する必要があります。

デバイスの識別

次のコマンドラインパラメーターを使用すると、ホストが認識できるすべての該当するデバイスの情報を表示できます。

SANtricity 11.81リリース以降では、これまでSMdevicesツールで使用できた機能がSMcli identifyDevicesパラメーターに置き換えられました。

Table 4. デバイスの識別コマンドラインパラメーター
パラメーター	定義
`identifyDevices`	ストレージシステムに関連付けられているすべてのSCSIネイティブブロックデバイスを検索します。検出された各デバイスについて、ネイティブOS固有のデバイス名、関連付けられているストレージシステム、ボリューム名、LUN情報など、さまざまな情報が報告されます。

例

LinuxおよびWindowsオペレーティングシステムでの-identifyDevicesパラメーターの例については、以下を参照してください。

Linux

ICTAE11S05H01:~/osean/SMcli-01.81.00.10004/bin # ./SMcli -identifyDevices
  <n/a> (/dev/sg2) [storage system ictae11s05a01, Volume 1, LUN 0, Volume ID <600a098000bbd04f00001c7365426b58>, Alternate Path (Controller-A): Non owning controller - Active/Non-optimized, Preferred Path Auto Changeable: Yes, Implicit Failback: Yes]
  /dev/sdb (/dev/sg3) [storage system ictae11s05a01, Volume Access, LUN 7, Volume ID <600a098000bbcdd3000002005a731d29>]
  <n/a> (/dev/sg4) [storage system ictae11s05a01, Volume 1, LUN 0, Volume ID <600a098000bbd04f00001c7365426b58>, Preferred Path (Controller-B): Owning controller - Active/Optimized, Preferred Path Auto Changeable: Yes, Implicit Failback: Yes]
  /dev/sdc (/dev/sg5) [storage system ictae11s05a01, Volume Access, LUN 7, Volume ID <600a098000bbcdd3000002005a731d29>]
SMcli completed successfully.

Windows

PS C:\Users\Administrator\Downloads\SMcli-01.81.00.0017\bin> .\SMcli -identifyDevices
  \\.\PHYSICALDRIVE1 [storage system ICTAG22S08A01, Volume Vol1, LUN 1, Volume ID <600a0980006cee060000592e6564fa6a>, Preferred Path (Controller-B): Owning controller - Active/Optimized, Preferred Path Auto Changeable: Yes, Implicit Failback: Yes]
  \\.\PHYSICALDRIVE2 [storage system ICTAG22S08A01, Volume Vol2, LUN 2, Volume ID <600a0980006ce727000001096564f9f5>, Preferred Path (Controller-A): Owning controller - Active/Optimized, Preferred Path Auto Changeable: Yes, Implicit Failback: Yes]
  \\.\PHYSICALDRIVE3 [storage system ICTAG22S08A01, Volume Vol3, LUN 3, Volume ID <600a0980006cee06000059326564fa76>, Preferred Path (Controller-B): Owning controller - Active/Optimized, Preferred Path Auto Changeable: Yes, Implicit Failback: Yes]
  \\.\PHYSICALDRIVE4 [storage system ICTAG22S08A01, Volume Vol4, LUN 4, Volume ID <600a0980006ce7270000010a6564fa01>, Preferred Path (Controller-A): Owning controller - Active/Optimized, Preferred Path Auto Changeable: Yes, Implicit Failback: Yes]
SMcli completed successfully.

その他の注意事項

SCSIベースのホストインターフェイスを備えるx86-64プラットフォームを実行するLinuxおよびWindowsオペレーティングシステムでのみ互換性があります。
- NVMeベースのホストインターフェイスはサポートされません。
identifyDevicesパラメーターを指定しても、OSレベルでの再スキャンは実行されません。OSによって認識されている既存のデバイスを反復します。
identifyDevicesコマンドを実行するための十分なユーザー権限が必要です。
- これには、OSネイティブのブロックデバイスからの読み取りとSCSI Inquiryコマンドの実行が含まれます。