4.1.4 AddHostStorageDomain

AddHostStorageDomainコマンドは,ホストストレージドメインを追加します。このコマンドは,ストレージシステムにホストグループを作成します。

重要
ホストストレージドメインを追加すると対象ポートのLUNセキュリティが自動で有効に設定されます。対象ポートのI/Oが停止していることを確認してください。

パラメーター

表4-4 AddHostStorageDomainコマンドのパラメーター

パラメーター名指定のレベル説明
serialnum必須ホストストレージドメインのストレージシステムのシリアル番号
model必須ホストストレージドメインのストレージシステムのモデル
port任意ホストストレージドメインのポート番号
portまたはportnameのどちらか一方を必ず指定してください。また,これらのパラメーターを同時には指定しないでください。同時に指定するとエラーとなります。
portname任意ホストストレージドメインのポート名
portまたはportnameのどちらか一方を必ず指定してください。また,これらのパラメーターを同時には指定しないでください。同時に指定するとエラーとなります。
domain任意ホストストレージドメインのドメインID
このパラメーターは10進数または16進数で指定できます。16進数で指定する場合は,プレフィックスとして0xを付けてください。
実行結果は10進数で表示されます。
指定できる値はストレージシステムによって異なります。
  • Virtual Storage Platform,Universal Storage Platform V/VM,Hitachi USP,HUS VM:1~254
  • SANRISE9900V:1~127
  • SANRISE9500V:1~127
  • HUS100,Hitachi AMS2000/AMS/WMS,Hitachi SMS(ホストグループ):1~127
  • HUS100,Hitachi AMS2000/AMS/WMS,Hitachi SMS(iSCSIターゲット):1~254
  • その他:1~511
hostmode※1任意ホストストレージドメインのホストモード
指定できる値については,「表4-5 パラメーターhostmodeに指定できる値」を参照してください。
このパラメーターを省略した場合,ホストモードおよびホスト接続モード2の簡易設定用パラメーター(platformmiddlewarealternatepathfailover,またはadditionalparameter)を指定していないときには,Standardが設定されます。
このパラメーターを省略した場合,簡易設定用パラメーターを指定しているときには,簡易設定用パラメーターに指定された値の組み合わせから推奨されるホストモードが設定されます。
hostmode2※1任意
(HUS100
Hitachi AMS2000/AMS/WMS
Hitachi SMS
SANRISE9500V)
ホスト接続モード2のリスト
複数指定する場合は,セミコロンで区切って指定します。
表4-6 パラメーターhostmode2に指定できる値」に一覧されている文字列のどれかを設定できます。
このパラメーターを省略した場合,ホストモードおよびホスト接続モード2の簡易設定用パラメーター(platformmiddlewarealternatepathfailover,またはadditionalparameter)を指定しているときには,簡易設定用パラメーターに指定された値の組み合わせから推奨されるホスト接続モード2が設定されます。
hostmodeoption任意
(Virtual Storage Platform
Universal Storage Platform V/VM
Hitachi USP
HUS VM)
ホストモードオプションのリスト
複数指定する場合は,セミコロンで区切って指定します。
指定できる値については,「表4-7 パラメーターhostmodeoptionに指定できる値」を参照してください。
name任意ホストストレージドメイン名
任意の名前を指定します。このパラメーターに指定した値は,ホストストレージドメインを識別するためにDevice Managerでだけ使われます。
指定できる文字数は1~64バイトです。
最初または最後のスペースは登録されません。
nickname任意ホストストレージドメインのニックネーム
ストレージシステムに作成されるホストグループまたはiSCSIターゲットに設定する名前を指定します。
省略した場合は,自動で設定されます。
Device Managerにホストを登録する方法としてHostScanコマンドを使用する場合,ホストストレージドメインを追加するときは,パラメーターnicknameにこのホストストレージドメインを利用するホストのホスト名を指定してください。HostScanコマンドについては,「4.4.9 HostScan」を参照してください。
使用できる文字は次のとおりです。
A~Z a~z 0~9 ! # $ % & ' ( )
+ - . = @ [ ] ^ _ ` { } ~ スペース
最初または最後の文字にスペースを使用できません。
HUS100,Hitachi AMS2000/AMS/WMS,Hitachi SMS,またはSANRISE9500Vの場合,バッククォート(`)は使用できません。
指定できる文字数は次のとおりです。
  • Virtual Storage Platform:1~64バイト
  • Universal Storage Platform V/VM:1~32バイト
  • Hitachi USP:
    マイクロコードのバージョンが50-04-01より前の場合:1~16バイト
    マイクロコードのバージョンが50-04-01以降の場合:1~32バイト
  • SANRISE9900V:1~8バイト
  • HUS VM:1~64バイト
  • HUS100:1~32バイト
  • Hitachi AMS2000:1~32バイト
  • Hitachi SMS:1~32バイト
  • Hitachi AMS/WMS:
    domaintype0の場合:1~16バイト
    domaintype1の場合:1~32バイト
  • SANRISE9500V:
    ファームウェアのバージョンがx6x9/Mより前の場合:
    1~8バイト
    ファームウェアのバージョンがx6x9/M以降の場合:
    1~16バイト
domaintype※2任意
(HUS100
Hitachi AMS2000/AMS/WMS
Hitachi SMS)
ホストストレージドメインのドメインタイプ
指定できる値は次のとおりです。
  • 0:ホストグループ
  • 1:iSCSIターゲット
省略した場合は,0が設定されます。
domainiscsiname※2任意
(HUS100
Hitachi AMS2000/AMS/WMS
Hitachi SMS)
ホストストレージドメイン(iSCSIターゲット)のiSCSIネーム
iSCSIネームは,iqn形式またはeui形式で指定してください。
使用できる文字は次のとおりです。
A~Z a~z 0~9 - . :
iSCSIネームの大文字と小文字は区別されません。
指定できる文字数は1~223バイトです。
省略した場合は,自動で設定されます。
platform※1任意
(HUS100
Hitachi AMS2000/AMS/WMS
Hitachi SMS
SANRISE9500V※3
ホストモードおよびホスト接続モード2の簡易設定オプション(プラットフォーム)
簡易設定用パラメーターに指定されたオプション値の組み合わせから,推奨されるホストモード(hostmode)およびホスト接続モード2(hostmode2)が設定されます。
このパラメーターに指定できるオプション値については,GUIを参照してください。
パラメーターhostmodeまたはhostmode2と同時に指定した場合,hostmodeまたはhostmode2で指定した値が設定されます。
middleware※1任意
(HUS100
Hitachi AMS2000
Hitachi SMS)
ホストモードおよびホスト接続モード2の簡易設定オプション(ミドルウェア)
簡易設定用パラメーターに指定されたオプション値の組み合わせから,推奨されるホストモード(hostmode)およびホスト接続モード2(hostmode2)が設定されます。
このパラメーターに指定できるオプション値については,GUIを参照してください。
パラメーターhostmodeまたはhostmode2と同時に指定した場合,hostmodeまたはhostmode2で指定した値が設定されます。
alternatepath※1任意
(Hitachi AMS/WMS
SANRISE9500V※3
ホストモードおよびホスト接続モード2の簡易設定オプション(交替パス)
簡易設定用パラメーターに指定されたオプション値の組み合わせから,推奨されるホストモード(hostmode)およびホスト接続モード2(hostmode2)が設定されます。
このパラメーターに指定できるオプション値については,GUIを参照してください。
パラメーターhostmodeまたはhostmode2と同時に指定した場合,hostmodeまたはhostmode2で指定した値が設定されます。
failover※1任意
(Hitachi AMS/WMS
SANRISE9500V※3
ホストモードおよびホスト接続モード2の簡易設定オプション(フェイルオーバー)
簡易設定用パラメーターに指定されたオプション値の組み合わせから,推奨されるホストモード(hostmode)およびホスト接続モード2(hostmode2)が設定されます。
このパラメーターに指定できるオプション値については,GUIを参照してください。
パラメーターhostmodeまたはhostmode2と同時に指定した場合,hostmodeまたはhostmode2で指定した値が設定されます。
additionalparameter※1任意
(Hitachi AMS/WMS
SANRISE9500V※3
ホストモードおよびホスト接続モード2の簡易設定オプション(追加パラメーター)
簡易設定用パラメーターに指定されたオプション値の組み合わせから,推奨されるホストモード(hostmode)およびホスト接続モード2(hostmode2)が設定されます。
このパラメーターに指定できるオプション値(数字)については,GUIを参照してください。
パラメーターhostmodeまたはhostmode2と同時に指定した場合,hostmodeまたはhostmode2で指定した値が設定されます。
複数指定する場合は,セミコロンで区切って指定します。
注※1
パラメーターhostmodehostmode2と簡易設定用パラメーター(platformmiddlewarealternatepathfailover,およびadditionalparameter)の関係には注意が必要です。
  • 簡易設定用パラメーターだけを指定した場合,簡易設定用パラメーターから推奨される値が設定されます。

図4-2 簡易設定用パラメーターだけを指定した場合の設定内容(AddHostStorageDomainコマンド)

[図]

  • パラメーターhostmodeおよびhostmode2と簡易設定用パラメーターを併用した場合,パラメーターhostmodeおよびhostmode2の指定値が設定されます。

図4-3 パラメーターhostmodeおよびhostmode2と簡易設定用パラメーターを併用した場合の設定内容(AddHostStorageDomainコマンド)

[図]

  • パラメーターhostmodeまたはhostmode2と簡易設定用パラメーターを併用した場合,パラメーターhostmodeまたはhostmode2の指定値と,簡易設定用パラメーターから推奨される値が設定されます。
    以下の図では,パラメーターhostmodeと簡易設定用パラメーターを併用した例を示します。

図4-4 パラメーターhostmodeと簡易設定用パラメーターを併用した場合の設定内容(AddHostStorageDomainコマンド)

[図]

注※2
パラメーターdomainiscsinameを指定する場合,パラメーターdomaintype1を指定してください。
注※3
SANRISE9500Vの場合,簡易設定用パラメーターでホストモードやホスト接続モード2を設定するには,バージョンx6x5以降のファームウェアが必要です。

パラメーターhostmodeに指定できる値を次の表に示します。

表4-5 パラメーターhostmodeに指定できる値

ストレージシステムhostmodeの値
Virtual Storage Platform
Universal Storage Platform V/VM
HUS VM
  • Standard
  • VMware
  • HP
  • OpenVMS
  • Tru64
  • Solaris
  • NetWare
  • Windows
  • AIX
  • VMware Extension
  • Windows Extension
  • UVM
Hitachi USP
  • Standard
  • Sequent
  • HP
  • Solaris
  • Netware
  • Windows
  • Windows Extension
  • Tru64
  • HI-UX(Hシリーズの場合,マイクロコードのバージョンが50-04-05-XX/XX以降)
  • AIX
  • OPEN-VMS
マイクロコードのバージョンに依存するもの:
50-03-0X-XX/XX以降
  • UVM
SANRISE9900V
  • Standard
  • Sequent
  • HP
  • Solaris
  • Netware
  • Windows
  • Tru64
  • HI-UX
  • AIX
  • OPEN-VMS
マイクロコードのバージョンに依存するもの:
21-05-00-XX/XX以降
  • Windows Extension
  • Solaris Extension
21-14-02-XX/XX以降
  • Standard Extension2
  • HP Extension2
  • Solaris Extension2
  • Windows Extension2
  • AIX Extension2
HUS100
Hitachi AMS2000/AMS/WMS
Hitachi SMS
SANRISE9500V
  • Standard
  • Open VMS
  • TRESPASS
  • Wolfpack

パラメーターhostmode2に指定できる値を次の表に示します。

表4-6 パラメーターhostmode2に指定できる値

ストレージシステムhostmode2の値
HUS100
  • Same Node Name Mode
  • Tru Cluster Mode
  • Port-ID Conversion Mode
  • PSUE Read Reject Mode
  • Mode Parameters Changed Notification Mode
  • CCHS Mode
  • HP-UX Mode
  • NACA Mode
  • Product Serial Response Mode
  • Unique Reserve Mode 1
  • Task Management Isolation Mode
  • NOP-In Suppress Mode
  • S-VOL Disable Advanced Mode
  • Discovery CHAP Mode
  • Unit Attention Change Mode
  • Unique Extended COPY Mode
  • Unique Write Same Mode
  • Report iSCSI Full Portal List Mode
  • DP Depletion Detail Reply Mode
  • Unique Compare Write Mode
ファームウェアのバージョンに依存するもの:
x935/A以降
  • Capacity Data Changed Notification Mode
  • HNAS Option Mode
x940/A以降
  • Unique Reserve Mode 2
  • Standard VAAI Command Mode
x945/A以降
  • Allocation Length Expand Mode
x945/D以降
  • UNMAP Short Length Mode
Hitachi AMS2000
Hitachi SMS
  • Same Node Name Mode
  • Tru Cluster Mode
  • Port-ID Conversion Mode
  • PSUE Read Reject Mode
  • Mode Parameters Changed Notification Mode
  • CCHS Mode
  • HP-UX Mode
  • NACA Mode
  • Product Serial Response Mode
  • Unique Reserve Mode 1
  • Task Management Isolation Mode
  • NOP-In Suppress Mode
  • S-VOL Disable Advanced Mode
ファームウェアのバージョンに依存するもの:
x860/A以降
  • Discovery CHAP Mode
x897/H以降
  • Unit Attention Change Mode
x890/A以降(Hitachi SMSを除く)
  • Unique Extended COPY Mode
  • Unique Write Same Mode
x893/E以降
  • Report iSCSI Full Portal List Mode
x897/A以降(Hitachi SMSを除く)
  • DP Depletion Detail Reply Mode
x8C4/F以降(Hitachi SMSを除く)
  • UNMAP Short Length Mode
Hitachi AMS/WMS
  • Same Node Name Mode
  • Tru Cluster Mode
  • ASL Report Mode(Active/Passive Group)
  • ASL Report Mode(Active/Passive)
  • ASL Report Mode(Active/Active)
  • Port-ID No Report Mode
  • Port-ID Conversion Mode
  • PSUE Read Reject Mode
  • UA (06/2A00) suppress Mode
  • CCHS Mode
  • HP-UX Mode
  • NACA Mode
  • Product Serial Response Mode
  • Unique Reserve Mode 1
  • Reset Propagation Mode
  • HISUP OFF Mode
ファームウェアのバージョンに依存するもの:
x712/A-x以降
  • SPC-2 Mode
x781/A以降
  • S-VOL Disable Advanced Mode
SANRISE9500V
  • ftServer Connection Mode 2
  • SRC Read Command Reject Mode
  • UA (06/2A00) suppress Mode
  • HISUP Mode
  • CCHS Mode
  • HP Connection Mode 2
  • Product ID DF400 Mode
  • NACA Mode
  • SUN Cluster Connection Mode
  • Persistent RSV Cluster Mode
  • Reset Target (Reset Bus Device) Mode
  • Reserve Mode
  • Reset Logical Unit Mode
  • Reset Logout of Third Party Process Mode
ファームウェアのバージョン:
x6x3/C以降
  • No_RSV_Conf Mode
x6x5以降
  • Tru Cluster Connection Mode
  • Path Switch Mode(Active/Passive Group)
  • Path Switch Mode(Active/Passive)
  • Path Switch Mode(Active/Active)
  • Port-ID No Report Mode
  • Port-ID Conversion Mode
x6x7以降
  • Same Node Name Mode
x6xA/R以降
  • SPC-2 Mode

パラメーターhostmodeoptionに指定できる値を次の表に示します。

説明の詳細については,ご使用のストレージシステムに対応するLUN管理製品のマニュアルを参照してください。

表4-7 パラメーターhostmodeoptionに指定できる値

hostmodeoptionの値説明Virtual Storage Platform/HUS VMUniversal Storage Platform V/VMHitachi USP
2VERITAS Database Edition/Advanced Cluster
VERITAS Database Edition/Advanced Cluster for Real Application Clusters,またはVERITAS Cluster Server 4.0以降(I/Oフェンシング機能)を使用している場合に指定します。
YYY
6TPRLO
次の条件をすべて満たす場合に指定します。
  • ホストモードのWindowsモード(モード0C)またはWindows Extensionモード(モード2C)を使用
  • Emulex社製のHBAを使用
  • ミニポートドライバーを使用
  • HBAのミニポートドライバーのパラメーターTPRLO2が設定されている
YYY
7Automatic recognition function of LUN
次の条件をすべて満たす場合に指定します。
  • ホストモードのStandard モード(モード00)または,Solarisモード(モード09)を使用
  • SUN StorEdge SAN Foundation Software Version 4.2以降を使用
  • SUN純正のHBAを使用している場合,デバイスの増減を自動認識させたいとき
YYY
12No display for ghost LUN
次の条件をすべて満たす場合に指定します。
  • ホストモードのHPモード(モード03)を使用
  • HP-UXホストの接続時にパスが定義されていないデバイスがデバイスファイルを作成するのを抑止したい場合
YYY
13SIM report at link failure
ポート間の接続失敗回数がしきい値を超えた場合,SIM通知を受けたいときに指定します。
YYY
14HP TruCluster with TrueCopy function
次の条件をすべて満たす場合に指定します。
  • ホストモードのTru64モード(モード07)を使用
  • TruClusterを使用して,TrueCopyの正ボリュームと副ボリュームのそれぞれにクラスタを設定したい場合
YYY
15HACMP
次の条件をすべて満たす場合に指定します。
  • ホストモードのAIXモード(モード0F)を使用
  • HACMP 4.5 4.5.13以降,HACMP 5.1 5.1.0.4以降またはHACMP 5.2以降を使用
YYY
19VMware
VMwareが動作しているホストをホストグループに登録するときに指定します。
NNY
22Veritas Cluster Server
次の条件をすべて満たす場合に指定します。
  • ホストモードのAIXモード(モード0F)を使用
  • VERITAS Cluster Serverを使用
YYY
23REC command support
REC(READ Exchange Concise)コマンドを動作させたいときに指定します。
YYY
242TB or Larger LUN Support
次の条件をすべて満たす場合に指定します。
  • ホストが2TBを超えるボリュームにアクセスする場合
  • ホストのOSが次のどれかである場合
    AIX 5L Version 5.2 TL08以降またはAIX 5L Version 5.3 TL04以降,
    Windows Server 2003 SP1,
    Red Hat Enterprise Linux AS 4 Update 1以降
上記以外のOSでは2TBを超えるボリュームにアクセスできません。
ボリュームの最大サイズはOSのファイルシステムに依存します。
この値はHitachi USPのマイクロコードのバージョンが50-08-0X-XX/XX以降の場合に有効です。
NNY
27iSCSI Delayed ACK improvement
iSCSI接続を使用するときに指定します。
NNY
33Set/Report Device Identifier enable
次の条件を満たすときに指定します。
  • ホストモードのHPモード(モード03)OpenVMSモード(モード05),Tru64モード(モード07)を使用
  • デバイスにニックネームを設定するコマンドを有効にする場合
YYN
39Change the nexus specified in the SCSI Target Reset
Target Resetを受け取った場合に,次の範囲をホストグループごとに制御したいときに指定します。
  • ジョブをリセットする範囲
  • UA(Unit Attention)が設定される範囲
YYN
40V-Vol expansion
次の条件を満たすときに指定します。
  • ホストモードのWindowsモード(モード0C)またはWindows Extensionモード(モード2C)を使用
  • HDPボリュームの容量を拡張したあと,拡張したHDPボリュームの容量を自動的に認識させる場合
YYN
41Prioritized device recognition command
デバイスを認識させるためのコマンドを優先させるときに指定します。
YYN
42Prevent "OHUB PCI retry"
IBM Z10 Linuxを使用するときに指定します。
YYN
43Queue Full Response
コマンドキューが満杯になった場合,ホストに「QueueFull」を応答させるときに指定します。
YYN
48HAM Svol Read Option
次の条件を満たすときに指定します。
  • Hitachi High Availability Managerを使用
  • S-VOLに対してしきい値以上のReadコマンドが発行されるアプリケーションなどが実行された場合,MCUからRCUへのフェイルオーバを発生させたくないとき
YYN
49BB Credit Set Up Option1
BB Credit仮想化によってTrue Copyの性能を向上させるときに指定します。
YNN
50BB Credit Set Up Option2
BB Credit仮想化によってTrue Copyの性能を向上させるときに指定します。
YNN
51Round Trip Set Up Option
Round TripによってTrue Copy性能を向上させるときに指定します。
YNN
52HAM and Cluster Software for SCSI-2 Reserve
Hitachi High Availability Managerが使用されている構成で,SCSI-2 Reserveを使うクラスタソフトウェアを使用する場合に指定します。
YNN
54Support Option for the EXTENDED COPY command
Virtual Storage Platform(マイクロコードのバージョン70-01-4X-XX/XX以降)およびHUS VMの場合,VMware ESXサーバを使用するときに指定します。
YYN
57HAM Response Change
Hitachi High Availability Managerが使用されている構成で,ホストモードのWindowsモード(モード0C),Windows Extensionモード(モード2C),VMwareモード(モード01),またはVMwares Extensionモード(モード21)を設定している場合に指定します。
YYN
60LUN0 Change Guard
HP-UX 11.31を使用する場合,およびLUN0の追加もしくは削除を抑止したい場合に指定します。
YYN
63Support option for vStorage APIs based on T10 standards
VMware ESXi 5.0に接続し,T10対応のVAAI機能を利用する場合に指定します。
YNN
65Round Trip Extended Set Up Option
TrueCopyのペアに接続してホストモードオプション51を使用している場合に,ホストのI/Oの応答時間を調整したいときに指定します。
例えば,最大数のプロセッサブレードを使用した構成を使用する場合,このオプションとホストモードオプション51を組み合わせて使用してください。
YNN
67Change of the ED_TOV value
OPEN Fibre Channel Portの構成が,次の条件を満たす場合に指定します。
  • トポロジーがFibre Channelダイレクト接続
  • Portの属性(種別)がTargetまたはRCU Target
YNN
68Support Page Reclamation for Linux
Linuxのホストに接続している環境から,Page Reclamation機能を利用する場合に指定します。
YNN
69Online LUSE expansion
ホストに対してLUSE ボリュームの容量拡張を通知する場合に指定します。
YNN
71Change the Unit Attention for Blocked Pool-VOLs
プールボリューム閉塞時のUA(Unit Attention)の応答を,NOT READYからMEDIUM ERRORに変更する場合に指定します。
YNN
72AIX GPFS Support
AIX ホストとの接続時,GPFS(General Parallel File System)を使用する場合に指定します。
YNN
73Support Option for WS2012
Windows Server 2012のホストに接続している環境から,Dynamic Provisioning機能を利用する場合に指定します。
Windows Server 2012 ODX(Offload Data Transfer)を使用する場合,ホストモードのWindowsモードまたはWindows Extensionモードを設定しているときに指定します
YNN
(凡例)
Y:指定できます。
N: 指定できません。
注※
HUS VMの場合は指定できません。

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

serialnumおよびmodel
GetStorageArrayコマンドの実行結果から取得してください。実行結果のarrayType値またはdisplayArrayType値をパラメーターmodelに指定してください。serialNumber値をパラメーターserialnumに指定してください。
portおよびdomain
GetStorageArray (subtarget=Port, portsubinfo=HostStorageDomain)コマンドの実行結果から取得してください。このコマンドを実行するときには,パラメーターmodelとパラメーターserialnumだけを指定し,パラメーターsubtargetPortportsubinfoパラメーターにHostStorageDomainを指定してください。実行結果では,portID値がPortに表示されます。このportID値をパラメーターportの値として指定してください。パラメーターdomainには,指定するポートのホストストレージドメインとして使用されていないドメインIDを使用してください。
portname
GetStorageArray (subtarget=Port)コマンドの実行結果から取得してください。実行結果では,displayNameAn instance of Portの下に表示されます。この値をportnameとして指定してください。
nickname
GetStorageArray (subtarget=Port)コマンドの実行結果から取得してください。GetStorageArrayコマンドを実行する時には,パラメーターmodelとパラメーターserialnumだけを指定し,パラメーターsubtargetPort,パラメーターportsubinfoにホストストレージドメインを指定してください。次にAn instance of HostStorageDomainとして実行結果に表示されているnicknameの値を指定してください。

コマンド実行例

HiCommandCLI AddHostStorageDomain -o "D:¥logs¥AddHostStorageDomain.log" "serialnum=10037" "model=USP_V" "port=3" "domain=15" "hostmodeoption=7;40"

コマンド実行結果

RESPONSE:
An instance of StorageArray
        .
        . (Attributes of StorageArray are omitted here)
        .
 List of 1 HostStorageDomain elements:
   An instance of HostStorageDomain
     objectID=HSDOMAIN.R600.10037.3.15
     portID=3
     portName=CL7-A
     domainID=15
     hostMode=Standard
     hostModeOption=7;40
     displayName=CL7-A-15
     domainType=0
     nickname=HCMD0030f