4.1.12 AddVirtualVolume

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でこのコマンドを使用する場合の条件を次に示します。

重要
Virtual Storage PlatformおよびHUS VMでこのコマンドを使用する場合,1つの仮想パリティグループの中に2つ以上のDPボリュームを作成できません。

Universal Storage Platform V/VMでこのコマンドを使用する場合の条件を次に示します。

重要
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プール)の条件を次に示します。

次に示す条件については,Dynamic Provisioningのマニュアルを参照してください。

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}]

HUS100の書式

HiCommandCLI [URL] AddVirtualVolume [オプション]
model=モデル serialnum=シリアル番号 [creationoption=force]
capacity=DPボリュームの容量 [numoflus=DPボリュームの数]
[devnum=論理ユニットのデバイス番号] [clprNumber=CLPR番号]
poolid=DPプールのプールID [capacitytype={KB|block}]

Hitachi AMS2000の書式

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-1nは数字)」形式で指定します。
パラメーターgroupoptionexistを指定する場合は,このパラメーターを指定する必要があります。
capacity必須DPボリュームの容量
容量の単位(KBまたはblock)は,パラメーターcapacitytypeで指定できます。
指定できる値は次のとおりです。
Virtual Storage PlatformおよびHUS VMの場合:
- 4800064424505600​(KB)
- 96000128849011200​(block)
Universal Storage Platform V/VMの場合:
マイクロコードのバージョンが60-03より前の場合:
- 480003221159680​(KB)
- 960006442319360​(block)
マイクロコードのバージョンが60-03以降の場合:
- 480004294967296​(KB)
- 960008589934592​(block)
HUS100の場合:
- 32768137438953472​(KB)
- 65536274877906944​(block)
Hitachi AMS2000の場合:
- 3276864424509440​(KB)
- 65536128849018880​(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番号
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が設定されます。
指定したCLPR番号がストレージシステムにない場合,エラーとなります。Virtual Storage PlatformおよびHUS VMの場合,ストレージシステムにあるCLPR番号は,GetStorageArray (subtargetの指定なし)コマンドの実行結果から取得できます。
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を指定してください。実行結果では,displayNameAn instance of ArrayGroupの下に表示されます。この値をarraygroupnameとして指定してください。
poolid
GetStorageArray (subtarget=Pool)コマンドの実行結果から取得してください。実行結果では,poolIDAn instance of Poolの下に表示されます。この値をpoolidとして指定してください。

コマンド実行例

この例では,ストレージシステム(シリアル番号:15065,モデル:USP_V)で,仮想パリティグループ(arraygroupnameX200-1)とその仮想パリティグループの中に2つ(numoflus2)のHDPボリュームを作成し,プールIDが0poolid0)のHDPプールと関連づけしています。また,同時にHDPボリュームの使用率のしきい値を10%(threshold10)に設定しています。

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=10

コマンド実行結果

RESPONSE:
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