4.1.43 GetStorageArray (subtarget=Path)

GetStorageArray (subtarget=Path)コマンドは,パスに関する情報を取得します。

パラメーター

表4-46 GetStorageArray (subtarget=Path)コマンドのパラメーター

パラメーター名指定のレベル説明
subtarget必須Pathを指定します。
serialnum任意ストレージシステムのシリアル番号
省略した場合,すべてのストレージシステムが対象となります。
model任意ストレージシステムのモデル
省略した場合,すべてのストレージシステムが対象となります。
objectid任意パスのオブジェクトID
特定のパスの情報を取得する場合に指定します。このパラメーターを指定する場合,パラメーターmodelおよびserialnumも必ず指定します。modelおよびserialnumを指定し,objectidを指定しない場合,指定されたストレージシステムのパスに関する情報を取得します。
pathsubinfo任意パスに関する情報
指定できる値は,HostInfoISCSIName,およびWWNです。複数の値を指定する場合はコンマで区切ります。
startElementNumFilter任意情報を取得するパスの最初の並び番号
特定のストレージシステムでの一部のパスに関する情報を取得する場合に指定します。
パスの情報を次の順序で並べ,0から始まる並び番号を付けたとき,取得するパスの並びの中で最初の番号を指定します。
パスの並び替え順序:
  1. ポートIDの昇順
  2. ドメインIDの昇順
  3. デバイス番号の昇順
このパラメーターを指定する場合,パラメーターnumOfElementsFiltermodel,およびserialnumも必ず指定します。
numOfElementsFilter任意情報を取得するパスの個数
特定のストレージシステムでの一部のパスに関する情報を取得する場合に指定します。情報を取得するパスの個数を指定します。このパラメーターを指定する場合,パラメーターstartElementNumFiltermodel,およびserialnumも必ず指定します。
指定値の推奨の最大値は16384です。
portname任意ストレージシステムのポート名
特定のパスの情報を取得する場合に指定します。このパラメーターを指定する場合,パラメーターmodelserialnumdomainnicknameまたはdomain,およびdevnumも必ず指定します。
portパラメーターと同時には指定しないでください。同時に指定するとエラーとなります。
port任意ストレージシステムのポートID
特定のパスの情報を取得する場合に指定します。このパラメーターを指定する場合,パラメーターmodelserialnumdomainnicknameまたはdomain,およびdevnumも必ず指定します。
portnameパラメーターと同時には指定しないでください。同時に指定するとエラーとなります。
domainnickname任意ホストストレージドメインのニックネーム
特定のパスの情報を取得する場合に指定します。このパラメーターを指定する場合,パラメーターmodelserialnumportnameまたはport,およびdevnumも必ず指定します。
domainパラメーターと同時には指定しないでください。同時に指定するとエラーとなります。
domain任意ホストストレージドメインのドメインID
特定のパスの情報を取得する場合に指定します。指定できる値は10進数または16進数です。このパラメーターを指定する場合,パラメーターmodelserialnumportnameまたはport,およびdevnumも必ず指定します。
domainnicknameパラメーターと同時には指定しないでください。同時に指定するとエラーとなります。
devnum任意LUのデバイス番号
特定のパスの情報を取得する場合に指定します。
Virtual Storage Platform,Universal Storage Platform V/VM,およびHUS VMの場合:
10進数,またはコロンで区切った16進数「ww:xx:yy」で指定します。wwはLDKC番号,xxはCU番号,yyはLDEV番号です。ここで,wwは省略できます。wwを省略した場合,LDKC番号は0と見なされます。
Hitachi USPおよびSANRISE9900Vの場合:
10進数,またはコロンで区切った16進数「xx:yy」で指定します。xxはCU番号,yyはLDEV番号です。
そのほかのストレージシステムの場合:
10進数で指定します。
このパラメーターを指定する場合,パラメーターmodelserialnumportnameまたはport,およびdomainnicknameまたはdomainも必ず指定します。

事前に取得するパラメーター値

serialnumおよびmodel
GetStorageArrayコマンドの実行結果から取得してください。実行結果のarrayType値またはdisplayArrayType値をパラメーターmodelに指定してください。serialNumber値をパラメーターserialnumに指定してください。
objectid
GetStorageArray (subtarget=Path)コマンドの実行結果から取得してください。このコマンドを実行するときには,パラメーターmodelとパラメーターserialnumだけを指定し,パラメーターsubtargetにはPathを指定してください。実行結果では,必要なobjectID値がAn instance of Pathの下に表示されます。このobjectID値をパラメーターobjectidの値として指定してください。

コマンド実行例1(objectidパラメーターを指定しない場合)

この例では,ストレージシステム(シリアル番号:10001,モデル:HDS9980V)へのパスに関する情報を,GetStorageArray (subtarget=Path)コマンドで取得します。この情報には,パスのWWNおよびホストに関する情報が含まれます。

HiCommandCLI GetStorageArray -o "D:¥logs¥GetStorageArray_Path.log" subtarget=Path model=HDS9980V serialnum=10001 pathsubinfo=WWN,HostInfo

コマンド実行結果1

RESPONSE:
An instance of StorageArray
 .
 . (Attributes of StorageArray are omitted here)
 .
 List of 554 Path elements:
   An instance of Path
     objectID=PATH.HDS9980V.10001.0.0.0
     devNum=0
     displayDevNum=00:00
     portID=0
     portName=CL1-A
     domainID=0
     scsiID=15
     LUN=0
     wwnSecurityValidity=true
       .
       . (repeated for other Path instances)
       .
   An instance of Path
     objectID=PATH.HDS9980V.10001.7.0.99
     devNum=99
     displayDevNum=00:63
     portID=7
     portName=CL1-H
     domainID=0
     scsiID=15
     LUN=99
     wwnSecurityValidity=true
     List of 256 WWN elements:
       An instance of WWN
         WWN=88.77.77.77.77.77.00.01
         nickname=Jane
       An instance of WWN
         WWN=88.77.77.77.77.77.00.02
         nickname=Jone
.
. (repeated for other WWN instances)
.

コマンド実行例2(objectidパラメーターを指定した場合)

この例では,ストレージシステム(シリアル番号:10001,モデル:HDS9980V)に設定されているパス(オブジェクトID:PATH.HDS9980V.10001.7.0.99)に関する情報を,GetStorageArray (subtarget=Path)コマンドで取得します。この情報には,パスのWWNおよびホストに関する情報が含まれます。

HiCommandCLI GetStorageArray -o "D:¥logs¥GetStorageArray_Path.log" subtarget=Path model=HDS9980V serialnum=10001 objectid=PATH.HDS9980V.10001.7.0.99 pathsubinfo=WWN,HostInfo

コマンド実行結果2

RESPONSE:
An instance of StorageArray
 .
 . (Attributes of StorageArray are omitted here)
 .
 List of 1 Path elements:
   An instance of Path
     objectID=PATH.HDS9980V.10001.7.0.99
     devNum=99
     displayDevNum=00:63
     portID=7
     portName=CL1-H
     domainID=0
     scsiID=15
     LUN=99
     wwnSecurityValidity=true
     List of 2 WWN elements:
       An instance of WWN
         WWN=88.77.77.77.77.77.00.01
         nickname=Jane
       An instance of WWN
         WWN=88.77.77.77.77.77.00.02
         nickname=Jone