5.5.4 CreateLockingTask

CreateLockingTaskコマンドは,ボリュームをロックしてデータを書き込み禁止(Read only)または読み書き禁止(Protect)状態にするロッキングタスクを作成します。マイグレーショングループ単位でボリュームをロックします。

マイグレーショングループ内に,ロック済みのボリュームなどロックできないボリュームがある場合は,ロックできるボリュームだけがロックされます。

Tiered Storage Managerでは,次のどれかに該当するボリュームはロックできません。

次のどれかに該当する場合,ロッキングタスクを作成できません。

ボリュームのロックが完了したあと,ロックしたボリュームをほかのマイグレーショングループに移動することもできます。

指定した期間が経過すると,Tiered Storage Manager はイベント通知を送信します(ロックは自動的に解除されません)。指定した期間が経過した場合には,ロック期間を延長するか,ボリュームをアンロックしてください。

ロック中のボリュームにロッキングタスクを実行した場合,次のように動作します。

Tiered Storage Managerではなく,StorageNavigatorなどからロックを掛けたためにロック期間が設定されていないボリュームに対して,Tiered Storage Managerで再ロックした場合,ロック期間を再設定できます。

この項の構成
(1) 記述形式
(2) オプション
(3) パラメーター
(4) 出力項目
(5) コマンド指定例と実行結果

(1) 記述形式

htsmcli [ サーバのロケーション] CreateLockingTask
   [ 共通オプション ]
   [ { -f | --force } ]
   [ { -e | --execute } ]
   storagedomainname=ストレージドメイン名
   migrationgroupname=マイグレーショングループ名
   [ guardmode={ ReadOnly | Protect } ]
   [ retentiondays=ロック期間 ]
   [ movetomigrationgroupname=ロック完了後移動先マイグレーショングループ名 ]
   [ notifytourl=イベント通知先アドレス ]
   [ description=タスクの説明文 ]

(2) オプション

-fまたは--force
確認しないでロッキングタスクを作成してよい場合に指定します。
確認メッセージに応答してからロッキングタスクを作成する場合は,指定を省略します。
-eまたは--execute
作成したロッキングタスクを即時実行したい場合に指定します。
省略するとロッキングタスクは待機状態になります。

(3) パラメーター

表5-37 CreateLockingTaskコマンドのパラメーター

パラメーター名説明
storagedomainnameストレージドメイン名を指定します。
migrationgroupnameマイグレーショングループ名を指定します。
[guardmode]ロッキングタスクの実行時に適用するロック方法を指定します。Data Retention Utilityのガード属性のうち,下記のどちらかの属性を指定できます。
  • ReadOnly:書き込み禁止(デフォルト)
  • Protect:読み書き禁止
[retentiondays]ロック解除できるまでの日数(ロック期間)を指定します。デフォルトは0です。
-1から21,900までの整数値を指定できます。
-1を指定すると無期限となります。ロック期間を無期限に設定した場合,ロックは永久に解除できません。
[movetomigrationgroupname]ロックの実行が完了したボリュームの移動先マイグレーショングループ名を指定します。
[notifytourl]イベント発生時に,イベントを通知する先のアドレスを指定します。
"mailto:"とメールアドレス文字列を合わせた値で指定します。
[description]タスクの説明文を指定します。
(凡例)
[ ]:指定は任意です。

(4) 出力項目

表5-38 CreateLockingTaskコマンドの出力項目(Taskインスタンス)

項目名説明
IDタスクIDです。
タスクIDの形式は,TK########です。ただし,########は時間+通番を36進数に変換した値です。
taskTypeタスクの種類です。
Locking:ロッキングタスク
statusタスクの状態です。
表示される値の詳細については,「5.8 タスクの状態」を参照してください。
creationTimeタスクの作成日時です。
endTimeタスクの実行終了日時です。
ownerIDタスクを作成したユーザーのユーザーIDです。
storageDomainNameストレージドメイン名です。
migrationGroupNameマイグレーショングループ名です。
retentionDaysロック期間(単位:日)です。ロック期間が無期限の場合は,"-1(Unlimited)"が表示されます。
retainedThroughロック期間が終了する日です。ロック期間が無期限の場合は,"Unlimited"が表示されます。
guardModeロッキングタスクの実行時に適用するロック方法です。
  • Read only:書き込み禁止
  • Protect:読み書き禁止
moveToMigrationGroupNameロックの実行が完了したボリュームの移動先マイグレーショングループ名です。
notifyToURLイベント通知先のアドレスです。
descriptionタスクの説明文です。

表5-39 CreateLockingTaskコマンドの出力項目(LockingInfoインスタンス)

項目名説明
controllerDeviceNumberボリュームのコントローラー論理デバイス番号です。
16進数と" : "(コロン)を組み合わせた値で表示されます。

(5) コマンド指定例と実行結果