Hitachi Command Suite Software CLI リファレンスガイド
AddVirtualVolumeコマンドは,対象となるストレージシステムにDPボリュームを作成します。また,対象となるDPプールとDPボリュームを関連づけます。
- 重要
- このコマンドは,Virtual Storage Platform,Universal Storage Platform V/VM,HUS VM,HUS100,およびHitachi AMS2000でだけ使用できます。
パラメーターpoolidでDPプールのプールIDを指定した場合,作成したDPボリュームをそのDPプールに関連づけます。
Virtual Storage Platform,Universal Storage Platform V/VM,およびHUS VMの場合,AddVirtualVolumeコマンドは,仮想パリティグループを作成し,DPボリュームを作成します。また,Universal Storage Platform V/VMの場合,既存の仮想パリティグループの中にHDPボリュームを作成することもできます。
Virtual Storage PlatformおよびUniversal Storage Platform V/VMの場合,作成するDPボリュームのdevNumにSSIDが割り当てられていないとき,SSIDは自動的に割り当てられます。SSIDについてはストレージシステムのマニュアルを参照してください。
Virtual Storage PlatformおよびHUS VMでこのコマンドを使用する場合の条件を次に示します。
- DPプールを指定するときは,DPプールの状態がBlockedでないこと
- DPプールを指定するときは,仮想化超過率が仮想化超過限界しきい値より小さいこと
- 重要
- Virtual Storage PlatformおよびHUS VMでこのコマンドを使用する場合,1つの仮想パリティグループの中に2つ以上のDPボリュームを作成できません。
Universal Storage Platform V/VMでこのコマンドを使用する場合の条件を次に示します。
- エミュレーションタイプがOPEN-Vであること
- 仮想パリティグループの空き容量が,作成するHDPボリュームの容量より大きいこと
- 既存の仮想パリティグループの中にHDPボリュームを作成する場合,HDPプールを指定するときは,仮想パリティグループとHDPプールのCLPR番号が同じであること
- HDPプールを指定するときは,HDPプールの状態がBlockedでないこと
- HDPプールを指定するときは,仮想化超過率が仮想化超過限界しきい値より小さいこと
- 重要
- Universal Storage Platform V/VMでこのコマンドを使用する場合の注意事項を次に示します。
- 1つの仮想パリティグループの中に2つ以上のHDPボリュームを作成することはお勧めしません。また,マイクロコードのバージョンが60-04-XX-XX/XX以降で,システムオプション726がONに設定されている場合は,1つの仮想パリティグループの中に2つ以上のHDPボリュームを作成できません。
- HDPボリュームの管理領域を作成するため,仮想パリティグループの空き容量と同じ容量でHDPボリュームを作成することはできません。
- 既存の仮想パリティグループの中にHDPボリュームを作成する場合,ストレージシステムにOpen Volume Managementをインストールする必要があります。
- 仮想化超過率に関するしきい値(仮想化超過警告しきい値および仮想化超過限界しきい値)が設定されている場合,このコマンドを実行する際には,Device Managerサーバのデータベースの整合性が取れていることを確認してください。仮想化超過率に関するしきい値はDevice Managerサーバで管理する固有のしきい値です。Device Managerが取得している仮想化超過率の情報と,実際の仮想化超過率が不一致の場合,仮想化超過警告しきい値および仮想化超過限界しきい値による判定結果が正しくないおそれがあります。
HUS100およびHitachi AMS2000の場合に指定するDPプール(Hitachi AMS2000の場合はHDPプール)の条件を次に示します。
- DPプールの状態がBlockedでないこと。
- creationoptionパラメーターを指定しない場合,またはファームウェアのバージョンがx893/Aより前のHitachi AMS2000の場合は,DPプールの使用率がDPプールの容量不足を警告するためのしきい値(threshold2)より小さいこと。
DPプールの容量不足を警告するためのしきい値(threshold2)については,「4.1.8 AddPool」を参照してください。次に示す条件については,Dynamic Provisioningのマニュアルを参照してください。
- DPボリュームの最小容量および最大容量
- 1つの仮想パリティグループの中に作成できるDPボリュームの数
- 1つのDPプールに関連づけできるDPボリュームの数
- 1つのDKCに作成できる仮想パリティグループの数
Virtual Storage PlatformおよびHUS VMの書式
HiCommandCLI [URL] AddVirtualVolume [オプション] model=モデル serialnum=シリアル番号 capacity=DPボリュームの容量 [numoflus=DPボリュームの数] [devnum=論理ユニットのデバイス番号] poolid=DPプールのプールID [capacitytype={KB|block}] [clprNumber=CLPR番号]Universal Storage Platform V/VMの書式
仮想パリティグループを作成し,その中にHDPボリュームを作成する場合:
HiCommandCLI [URL] AddVirtualVolume [オプション] model=モデル serialnum=シリアル番号 arraygroupname=仮想パリティグループ名 capacity=HDPボリュームの容量 [numoflus=HDPボリュームの数] [devnum=論理ユニットのデバイス番号] [clprNumber=CLPR番号] [poolid=HDPプールのプールID [threshold=HDPボリュームの使用率のしきい値]] [capacitytype={KB|block}]HDPボリュームの数と同じ数の仮想パリティグループを作成し,その中に同じ条件でHDPボリュームを作成する場合:
HiCommandCLI [URL] AddVirtualVolume [オプション] model=モデル serialnum=シリアル番号 capacity=HDPボリュームの容量 [numoflus=HDPボリュームの数] [devnum=論理ユニットのデバイス番号] [clprNumber=CLPR番号] [poolid=HDPプールのプールID [threshold=HDPボリュームの使用率のしきい値]] [capacitytype={KB|block}]既存の仮想パリティグループの中にHDPボリュームを作成する場合:
HiCommandCLI [URL] AddVirtualVolume [オプション] model=モデル serialnum=シリアル番号 groupoption=exist arraygroupname=仮想パリティグループ名 capacity=HDPボリュームの容量 [numoflus=HDPボリュームの数] [devnum=論理ユニットのデバイス番号] [poolid=HDPプールのプールID [threshold=HDPボリュームの使用率のしきい値]] [capacitytype={KB|block}]HiCommandCLI [URL] AddVirtualVolume [オプション] model=モデル serialnum=シリアル番号 [creationoption=force] capacity=DPボリュームの容量 [numoflus=DPボリュームの数] [devnum=論理ユニットのデバイス番号] [clprNumber=CLPR番号] poolid=DPプールのプールID [capacitytype={KB|block}]HiCommandCLI [URL] AddVirtualVolume [オプション] model=モデル serialnum=シリアル番号 [creationoption=force] capacity=HDPボリュームの容量 [numoflus=HDPボリュームの数] [devnum=論理ユニットのデバイス番号] [clprNumber=CLPR番号] poolid=HDPプールのプールID [capacitytype={KB|block}]表4-15 AddVirtualVolumeコマンドのパラメーター
パラメーター名 指定のレベル 説明 serialnum 必須 ストレージシステムのシリアル番号 model 必須 ストレージシステムのモデル creationoption 任意
(HUS100
Hitachi AMS2000)DPプールの使用率がDPプールの容量不足を警告するためのしきい値(threshold2)以上の場合も,DPボリュームを作成するかどうかを指定します。
DPボリュームを作成する場合は,forceを指定します(大文字と小文字は区別されません)。
Hitachi AMS2000の場合,ファームウェアのバージョンがx893/A-x以降のときに指定できます。それより前のバージョンでは指定しないでください。指定するとエラーが発生します。groupoption 任意
(Universal Storage Platform V/VM)既存の仮想パリティグループの中にHDPボリュームを作成するかどうかを指定します。
既存の仮想パリティグループの中に作成する場合は,existを指定します。
このパラメーターを指定する場合,パラメーターarraygroupnameを指定する必要があります。arraygroupname 任意
(Universal Storage Platform V/VM)仮想パリティグループ名
仮想パリティグループ名は,「Xn-1(nは数字)」形式で指定します。
パラメーターgroupoptionにexistを指定する場合は,このパラメーターを指定する必要があります。capacity 必須 DPボリュームの容量
容量の単位(KBまたはblock)は,パラメーターcapacitytypeで指定できます。
指定できる値は次のとおりです。
- Virtual Storage PlatformおよびHUS VMの場合:
- - 48000~64424505600(KB)
- - 96000~128849011200(block)
- Universal Storage Platform V/VMの場合:
- マイクロコードのバージョンが60-03より前の場合:
- - 48000~3221159680(KB)
- - 96000~6442319360(block)
- マイクロコードのバージョンが60-03以降の場合:
- - 48000~4294967296(KB)
- - 96000~8589934592(block)
- HUS100の場合:
- - 32768~137438953472(KB)
- - 65536~274877906944(block)
- Hitachi AMS2000の場合:
- - 32768~64424509440(KB)
- - 65536~128849018880(block)
numoflus 任意 DPボリュームの数
作成するDPボリュームの数を指定します。
省略した場合は,1が設定されます。devnum 任意 論理ユニットのデバイス番号 このパラメーターを省略した場合は,自動で設定されます。
- 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と見なされます。
- HUS100およびHitachi AMS2000の場合:
- 10進数で指定します。
clprNumber 任意 CLPR番号 指定したCLPR番号がストレージシステムにない場合,エラーとなります。Virtual Storage PlatformおよびHUS VMの場合,ストレージシステムにあるCLPR番号は,GetStorageArray (subtargetの指定なし)コマンドの実行結果から取得できます。
- Virtual Storage PlatformおよびHUS VMの場合:
- このパラメーターを省略した場合,次の値が設定されます。
- DPプールを構成するDPプールボリュームのCLPR番号がすべて同じ場合,DPプールボリュームのCLPR番号が設定されます。
- DPプールを構成するDPプールボリュームのCLPR番号が混在している場合,0が設定されます。
- Universal Storage Platform V/VMの場合:
- パラメーターpoolidとこのパラメーターの組み合わせによって,次のとおりCLPR番号が設定されます。
- パラメーターpoolidを省略して,パラメーターclprNumberを指定した場合,パラメーターclprNumberで指定したCLPR番号が設定されます。
- パラメーターpoolidを指定した場合,パラメーターclprNumberは無視され,パラメーターpoolidで特定されたHDPプールのCLPR番号が設定されます。
- パラメーターpoolidおよびパラメーターclprNumberを両方省略した場合,0が設定されます。
- HUS100およびHitachi AMS2000の場合:
- このパラメーターを省略した場合,0が設定されます。
poolid 任意 DPプールのプールID
作成したDPボリュームを関連づけるDPプールのプールIDを指定します。
Virtual Storage Platform,HUS VM,HUS100,およびHitachi AMS2000の場合は必ず指定してください。threshold 任意
(Universal Storage Platform V/VM)HDPボリュームの使用率のしきい値(%)
5以上300以下の5の倍数の整数を指定します。
省略した場合は,5が設定されます。
パラメーターpoolidを省略した場合,このパラメーターへの指定は無効です。capacitytype 任意 パラメーターcapacityで指定する値の単位
指定できる値は,KBまたはblockです。
省略した場合,KBが設定されます。
- serialnumおよびmodel
- GetStorageArrayコマンドの実行結果から取得してください。実行結果のarrayType値またはdisplayArrayType値をパラメーターmodelに指定してください。serialNumber値をパラメーターserialnumに指定してください。
- arraygroupname
- GetStorageArray (subtarget=ArrayGroup)コマンドの実行結果から取得してください。このコマンドを実行するときには,パラメーターmodelとパラメーターserialnumだけを指定し,パラメーターsubtargetにはArrayGroupを指定してください。実行結果では,displayNameがAn instance of ArrayGroupの下に表示されます。この値をarraygroupnameとして指定してください。
- poolid
- GetStorageArray (subtarget=Pool)コマンドの実行結果から取得してください。実行結果では,poolIDがAn instance of Poolの下に表示されます。この値をpoolidとして指定してください。
この例では,ストレージシステム(シリアル番号:15065,モデル:USP_V)で,仮想パリティグループ(arraygroupname:X200-1)とその仮想パリティグループの中に2つ(numoflus:2)のHDPボリュームを作成し,プールIDが0(poolid:0)のHDPプールと関連づけしています。また,同時にHDPボリュームの使用率のしきい値を10%(threshold:10)に設定しています。
HiCommandCLI AddVirtualVolume -o "D:\logs\AddVirtualVolume.log" model=USP_V serialnum=15065 arraygroupname=X200-1 capacity=209715200 numoflus=2 devnum=00:30:00 poolid=0 threshold=10RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 ArrayGroup elements: An instance of ArrayGroup objectID=ARRAYGROUP.R600.15065.16485.199 chassis=16,485 number=199 displayName=X200-1 raidType=- emulation=OPEN-V diskType= diskSize=-1 diskSizeInKB=-1 formFactor=-1 controllerID=-1 totalCapacity=419,430,400 allocatedCapacity=0 freeCapacity=419,430,400 hiHsmCapacity=0 onDemandCapacity=0 totalFreeSpace=2,801,729,280 largestFreeSpace=2,801,729,280 substance=0 slprNumber=0 clprNumber=0 cuInfo= openTotalCapacity=419,430,400 openAllocatedCapacity=0 openFreeCapacity=419,430,400 openHiHsmCapacity=0 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imHiHsmCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=0 mfHiHsmCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocatedActualCapacity=0 openUnallocatedCapacity=419,430,400 openUnallocatedActualCapacity=0 openReservedCapacity=0 openReservedActualCapacity=0 type=3 volumeType=-1 encrypted=0 protectionLevel=-1 dpPoolID=-1 List of 2 Lu elements: An instance of LogicalUnit objectID=LU.R600.15065.12288 devNum=12,288 displayName=00:30:00 emulation=OPEN-V devCount=1 devType= capacityInKB=209,715,200 numberOfLBAs=419,430,400 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 raidType=Unknown currentPortController=-1 defaultPortController=-1 isComposite=0 trueCopyVolumeType=Simplex shadowImageVolumeType=Simplex quickShadowVolumeType=Simplex universalReplicatorVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false quickShadowPoolID=-1 universalReplicatorPoolID=-1 dpType=0 consumedCapacityInKB=0 dpPoolID=0 threshold=10 tcaPoolID=-1 dpPoolVolControlFlag=-1 managementAreaPoolID=-1 List of 1 Ldev elements: An instance of LDEV objectID=LDEV.R600.15065.12288 devNum=12,288 displayName=00:30:00 emulation=OPEN-V cylinders=0 isComposite=0 sizeInKB=209,715,200 lba=419,430,400 raidType=- substance=0 volumeType=-1 slotSizeInKB=48 chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 path=false onDemandDevice=false devType= isStandardLDEV=true diskType=-1 slprNumber=-1 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal dpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 dpPoolID=0 threshold=10 systemDisk=0 encrypted=0 tieringPolicy=-1 resourcePartitionUnitID=-1 An instance of LogicalUnit objectID=LU.R600.15065.12289 devNum=12,289 displayName=00:30:01 emulation=OPEN-V devCount=1 devType= capacityInKB=209,715,200 numberOfLBAs=419,430,400 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 raidType=Unknown currentPortController=-1 defaultPortController=-1 isComposite=0 trueCopyVolumeType=Simplex shadowImageVolumeType=Simplex quickShadowVolumeType=Simplex universalReplicatorVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false quickShadowPoolID=-1 universalReplicatorPoolID=-1 dpType=0 consumedCapacityInKB=0 dpPoolID=0 threshold=10 tcaPoolID=-1 dpPoolVolControlFlag=-1 managementAreaPoolID=-1 List of 1 Ldev elements: An instance of LDEV objectID=LDEV.R600.15065.12289 devNum=12,289 displayName=00:30:01 emulation=OPEN-V cylinders=0 isComposite=0 sizeInKB=209,715,200 lba=419,430,400 raidType=- substance=0 volumeType=-1 slotSizeInKB=48 chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 path=false onDemandDevice=false devType= isStandardLDEV=true diskType=-1 slprNumber=-1 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal dpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 dpPoolID=0 threshold=10 systemDisk=0 encrypted=0 tieringPolicy=-1 resourcePartitionUnitID=-1 List of 1 FreeSpace elements: An instance of FreeSpace objectID=FREESPACE.R600.15065.16485.199.0 sizeInKB=2,801,729,280 cylinders=0 fsControlIndex=0
All Rights Reserved. Copyright© 2010, 2014, Hitachi, Ltd.