4.1.26 FormatLU

LUをフォーマットします。

パラメーターwaitを省略,またはパラメーターwaitで「false」を指定した場合,LDEVが正しくフォーマットされたかどうかは,AddStorageArrayコマンドでストレージシステムをリフレッシュしたあと,GetStorageArray (subtarget=LDEV)コマンドを実行し,実行結果からstatusの値を確認します。「true」を指定した場合は,FormatLUコマンドの実行結果でstatusの値を確認します。

注意
このコマンドは,LUのデータを消去します。使用中のLUをフォーマットした場合,データの復元はできません。
重要
  • このコマンドは,Virtual Storage Platform,Universal Storage Platform V/VM,Hitachi USP,およびHUS VMでだけ使用できます。Hitachi USPの場合に必要なマイクロコードのバージョンは50-09-00-XX/XX以降です。
  • LDEVをフォーマットする際,LDEVの属性のstatusの値が「Blocked」であることを確認してください。statusの値が「Normal」の場合で,LDEVをフォーマットするときは,パラメーターforceで「true」を指定します。
  • 指定するLUSEボリュームに「Blocked」でないLDEVが含まれている場合,そのLUSEボリュームを削除してから,このコマンドを実行してください。
  • 対象のストレージシステム内で,LDEVがフォーマット中の場合,このコマンドを実行するとエラーになります。

パラメーター

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

パラメーター名指定のレベル説明
serialnum必須フォーマットするLUのストレージシステムのシリアル番号
model必須フォーマットするLUのストレージシステムのモデル
devnums必須フォーマットする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の場合:
10進数,またはコロンで区切った16進数「xx:yy」で指定します。xxはCU番号,yyはLDEV番号です。
複数指定する場合はコンマで区切ります。
実行結果は10進数で出力されます。
wait任意フォーマットの完了を待ってコマンドを終了するかどうかを指定します。
指定できる値は次のとおりです。
  • true:フォーマットの完了を待ってコマンドを終了する
  • false:フォーマットの完了を待たないでコマンドを終了する
省略した場合は,falseが設定されます。
このパラメーターでtrueを指定した場合,パラメーターquickformattrueを同時に指定できません。
force任意状態が「Normal」のLDEVをフォーマットするかどうかを指定します。
指定できる値は次のとおりです。
  • true:フォーマットする
  • false:フォーマットしない
省略した場合は,falseが設定されます。
quickformat任意
(Virtual Storage Platform
Universal Storage Platform V/VM
HUS VM)
LUをQuick Formatでフォーマットするかどうかを指定します。
指定できる値は次のとおりです。
  • true:Quick Format.でフォーマットする
  • false:Quick Formatでフォーマットしない
省略した場合は,falseが設定されます。
このパラメーターでtrueを指定した場合,パラメーターwaittrueを同時に指定できません。
Universal Storage Platform V/VMの場合,LUをQuick Formatでフォーマットするために必要なマイクロコードのバージョンは60-02-4X-XX/XX以降です。

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

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

コマンド実行例

HiCommandCLI -t FormatLU model=R600 serialnum=10007 devnums=00:04:97,00:04:98

コマンド実行結果

RESPONSE:
An instance of StorageArray
 .
 . (Attributes of StorageArray are omitted here)
 .
   An instance of LogicalUnit
     objectID=LU.R600.10007.1175
     devNum=1,175
     displayName=00:04:97
     emulation=OPEN-V
     devCount=1
     devType=
     capacityInKB=100,000
     numberOfLBAs=200,000
     path=false
     commandDevice=false
     commandDeviceEx=0
     commandDeviceSecurity=false
     commandDeviceAuth=false
     chassis=1
     arrayGroup=0
     arrayGroupName=1-1-1
     raidType=RAID5(3D+1P)
     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=-1
     consumedCapacityInKB=100,000
     dpPoolID=-1
     threshold=-1
     tcaPoolID=-1
     dpPoolVolControlFlag=-1
     managementAreaPoolID=-1
     List of 1 Ldev elements:
       An instance of LDEV
         objectID=LDEV.R600.10007.1175
         devNum=1,175
         displayName=00:04:97
         emulation=OPEN-V
         cylinders=0
         isComposite=0
         sizeInKB=100,000
         lba=200,000
         raidType=RAID5(3D+1P)
         substance=0
         volumeType=-1
         slotSizeInKB=256
         chassis=1
         arrayGroup=0
         arrayGroupName=1-1-1
         path=false
         onDemandDevice=false
         devType=
         isStandardLDEV=false
         guardMode=
         diskType=0
         slprNumber=0
         clprNumber=0
         cacheResidencyMode=0
         stripeSizeInKB=-1
         volumeKind=3
         status=Normal
         dpType=-1
         consumedSizeInKB=100,000
         mfTrueCopyVolumeType=Simplex
         mfShadowImageVolumeType=Simplex
         mfUniversalReplicatorVolumeType=Simplex
         mfUniversalReplicatorPoolID=-1
         dpPoolID=-1
         threshold=-1
         systemDisk=0
         encrypted=0
         tieringPolicy=-1
         resourcePartitionUnitID=-1
   An instance of LogicalUnit
     objectID=LU.R600.10007.1176
     devNum=1,176
     displayName=00:04:99
     emulation=OPEN-V
     devCount=1
     devType=
     capacityInKB=100,000
     numberOfLBAs=200,000
     path=false
     commandDevice=false
     commandDeviceEx=0
     commandDeviceSecurity=false
     commandDeviceAuth=false
     chassis=1
     arrayGroup=0
     arrayGroupName=1-1-1
     raidType=RAID5(3D+1P)
     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=-1
     consumedCapacityInKB=100,000
     dpPoolID=-1
     threshold=-1
     tcaPoolID=-1
     dpPoolVolControlFlag=-1
     managementAreaPoolID=-1
     List of 1 Ldev elements:
       An instance of LDEV
         objectID=LDEV.R600.10007.1176
         devNum=1,176
         displayName=00:04:98
         emulation=OPEN-V
         cylinders=0
         isComposite=0
         sizeInKB=100,000
         lba=200,000
         raidType=RAID5(3D+1P)
         substance=0
         volumeType=-1
         slotSizeInKB=256
         chassis=1
         arrayGroup=0
         arrayGroupName=1-1-1
         path=false
         onDemandDevice=false
         devType=
         isStandardLDEV=false
         guardMode=
         diskType=0
         slprNumber=0
         clprNumber=0
         cacheResidencyMode=0
         stripeSizeInKB=-1
         volumeKind=3
         status=Normal
         dpType=-1
         consumedSizeInKB=100,000
         mfTrueCopyVolumeType=Simplex
         mfShadowImageVolumeType=Simplex
         mfUniversalReplicatorVolumeType=Simplex
         mfUniversalReplicatorPoolID=-1
         dpPoolID=-1
         threshold=-1
         systemDisk=0
         encrypted=0
         tieringPolicy=-1
         resourcePartitionUnitID=-1