Hitachi Command Suite

Tiered Storage Manager Software
CLI リファレンスガイド

3020-3-W04-A0

目次

前書き

はじめに

対象読者

マニュアルの構成

マイクロソフト製品の表記について

このマニュアルで使用している記号

1. CLIの概要

1.1 CLIのコマンド一覧

1.2 CLIを使用したボリュームの操作

2. CLIを実行するまでの準備

2.1 CLIのセットアップ

2.1.1 WindowsでのCLIのセットアップ

2.1.2 Solaris，HP-UX，LinuxでのCLIのセットアップ

2.2 CLIのアンセットアップ

2.2.1 WindowsでのCLIのアンセットアップ

2.2.2 Solaris，HP-UX，LinuxでのCLIのアンセットアップ

2.3 セットアップ後の準備

2.3.1 htsmcli.propertiesファイルを設定する

2.3.2 HTSM_CLI_HOMEを設定する

2.3.3 プロパティファイルまたはパスワードファイルに指定するパスワードをコード化する

2.3.4 CLI/logsフォルダのアクセス権限を変更する

2.3.5 Javaの実行環境を設定する

2.3.6 SSL通信のための設定をする

2.3.7 メモリーサイズを割り当てる

2.3.8 管理クライアントで実行するCLIの言語種別を設定する

3. CLIコマンドを使用する

3.1 CLIコマンドとユーザー権限

3.2 CLIコマンドの実行と注意事項

3.3 CLIコマンドの記述形式

3.3.1 CLIコマンドの引数

3.3.2 すべてのCLIコマンドに共通するオプション

3.3.3 パラメーターの書式

3.4 CLIコマンドの戻り値と出力情報

3.5 CLIコマンドのヘルプ表示

4. CLIで使用できる検索条件

4.1 検索条件の種類と概要

4.2 検索条件式の構文

4.2.1 string-literalの記述形式

4.2.2 複数の要素を指定できるプロパティの記述規則

4.3 プロパティの概要

4.4 プロパティに指定できる値の範囲

5. CLIコマンドの詳細

5.1 コマンド共通の説明

5.2 ストレージドメインを管理するためのコマンド

5.2.1 GetStorageDomains

5.2.2 ModifyStorageDomain

5.2.3 Refresh

5.3 ストレージ階層を管理するためのコマンド

5.3.1 CreateStorageTier

5.3.2 DeleteStorageTier

5.3.3 GetStorageTiers

5.3.4 ModifyStorageTier

5.4 マイグレーショングループを管理するためのコマンド

5.4.1 CreateMigrationGroup

5.4.2 DeleteMigrationGroup

5.4.3 GetMigrationGroups

5.4.4 ModifyMigrationGroup

5.4.5 AddVolumeToMigrationGroup

5.4.6 RemoveVolumeFromMigrationGroup

5.5 タスクを作成するためのコマンド

5.5.1 CreateMigrationPlan

5.5.2 タスクの作成と実行

5.5.3 CreateMigrationTask

5.5.4 CreateLockingTask

5.5.5 CreateUnlockingTask

5.5.6 CreateShreddingTask

5.6 タスクを管理するためのコマンド

5.6.1 GetTasks

5.6.2 ModifyTask

5.6.3 ExecuteTask

5.6.4 CancelTask

5.6.5 StopTask

5.6.6 DeleteTasks

5.7 ドメインコントローラーから情報を取得するためのコマンド

5.7.1 GetVolumes

5.7.2 GetPools

5.7.3 GetFreeSpaces

5.8 タスクの状態

6. CLIのプロパティファイル

6.1 CLIのプロパティファイルの概要

6.2 htsmcli.propertiesファイルでのオプションやパラメーターの指定

6.2.1 htsmserver.locationプロパティ

6.2.2 option.usernameプロパティ

6.2.3 option.passwordプロパティ

6.2.4 option.password2プロパティ

6.2.5 option.outputプロパティ

6.2.6 option.secureプロパティ

6.2.7 parameter.パラメーター名プロパティ

6.3 htsmclienv.propertiesファイルでのトレースログに関する指定

6.3.1 logger.filePathプロパティ

6.3.2 logger.maxFileSizeプロパティ

6.3.3 logger.fileCountプロパティ

6.3.4 logger.tracelogLevelプロパティ

7. トラブルシューティング

7.1 CLIに固有なトラブルシューティング情報

付録A. 運用時の参考情報

A.1 Tiered Storage Managerの動作を保証できる値

A.2 パラメーター指定値に使用できる文字の種類と文字列長

A.3 マイグレーションに関する参考情報

付録B. このマニュアルの参考情報

B.1 関連マニュアル

B.2 このマニュアルでの表記

B.3 このマニュアルで使用している略語

B.4 KB（キロバイト）などの単位表記について

用語解説

索引

All Rights Reserved. Copyright© 2010, 2014, Hitachi, Ltd.

前書き

対象製品

Hitachi Tiered Storage Manager　7.6.1

Hitachi Tiered Storage Managerは，経済産業省が2003年度から3年間実施した「ビジネスグリッドコンピューティングプロジェクト」の技術開発の成果を含みます。

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HP-UXは，Hewlett-Packard Development Company, L.P.のオペレーティングシステムの名称です。

Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。

Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Novell，およびNetWareは，Novell, Inc.の米国およびその他の国における登録商標または商標です。

OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

This product includes software developed by IAIK of Graz University of Technology.

Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。

RSAおよびBSAFEは，米国EMC コーポレーションの米国およびその他の国における商標または登録商標です。

すべてのSPARC商標は，米国SPARC International, Inc. のライセンスを受けて使用している同社の米国およびその他の国における商標または登録商標です。SPARC商標がついた製品は，米国Sun Microsystems, Inc. が開発したアーキテクチャに基づくものです。

SUSEは日本におけるNovell, Inc.の商標です。

UNIXは，The Open Groupの米国ならびに他の国における登録商標です。

Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。

Hitachi Tiered Storage Managerには，Oracle Corporation またはその子会社，関連会社が著作権を有している部分が含まれています。

Hitachi Tiered Storage Managerには，UNIX System Laboratories,Inc.が著作権を有している部分が含まれています。

Hitachi Tiered Storage Managerは，米国EMC コーポレーションのRSA BSAFE®ソフトウェアを搭載しています。

This product includes software developed by Ben Laurie for use in the Apache-SSL HTTP server project.

Portions of this software were developed at the National Center for Supercomputing Applications (NCSA) at the University of Illinois at Urbana-Champaign.

This product includes software developed by the University of California, Berkeley and its contributors.

This software contains code derived from the RSA Data Security Inc. MD5 Message-Digest Algorithm, including various modifications by Spyglass Inc., Carnegie Mellon University, and Bell Communications Research, Inc (Bellcore).

Regular expression support is provided by the PCRE library package, which is open source software, written by Philip Hazel, and copyright by the University of Cambridge, England. The original software is available from ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/.

This product includes software developed by Ralf S. Engelschall <rse@engelschall.com> for use in the mod_ssl project (http://www.modssl.org/).

This product includes software developed by Daisuke Okajima and Kohsuke Kawaguchi (http://relaxngcc.sf.net/).

This product includes software developed by the Java Apache Project for use in the Apache JServ servlet engine project (http://java.apache.org/).

This product includes software developed by Andy Clark.

発行

2014年1月　3020-3-W04-A0

著作権

All Rights Reserved. Copyright© 2010, 2014, Hitachi, Ltd.

はじめに

このマニュアルは，Hitachi Tiered Storage Manager（以降，Tiered Storage Managerと略します）のCommand Line Interfaceの使い方について説明したものです。以降，このマニュアルではCommand Line InterfaceをCLIと表記します。

はじめにの構成

対象読者

マニュアルの構成

マイクロソフト製品の表記について

このマニュアルで使用している記号

対象読者

このマニュアルは，Tiered Storage Managerを使ってストレージシステムを運用および管理するストレージ管理者を対象としています。また，対象読者には次のような知識があることを前提としています。

SAN（Storage Area Network）に関する基本的な知識

Tiered Storage Managerで運用するストレージシステムに関する基本的な知識

Tiered Storage Managerの前提製品であるHitachi Device Managerを使ったシステムの運用・管理の知識

マニュアル「Hitachi Command Suite Software ユーザーズガイド」に記載されているマイグレーションに関する基本的な知識

Tiered Storage Manager CLIの前提OSの基本的な操作方法

マニュアルの構成

このマニュアルは，次に示す章と付録から構成されています。

第1章　CLIの概要

CLIコマンドの一覧，およびCLIでのボリューム操作の流れについて説明しています。

第2章　CLIを実行するまでの準備

CLIのセットアップの方法，およびセットアップ後に必要な環境設定などを説明しています。

第3章　CLIコマンドを使用する

CLIのユーザー権限，格納場所，記述形式，パラメーターの書式など，CLIコマンドを使用する前に必要な知識について説明しています。

第4章　CLIで使用できる検索条件

filterconditionパラメーター（またはnewfilterconditionパラメーター）に指定する，検索条件式について説明しています。

第5章　CLIコマンドの詳細

コマンドごとに，機能，指定できるオプション，指定できるパラメーター，コマンドの出力項目，およびコマンドの指定例について説明しています。

第6章　CLIのプロパティファイル

プロパティファイルを使用したオプション，パラメーターの指定について説明しています。また，CLIのトレースログに関するプロパティについて説明しています。

第7章　トラブルシューティング

CLIに問題が生じた場合の対策について説明しています。

付録A　運用時の参考情報

CLIでTiered Storage Managerを運用するために，参考にできる情報について説明しています。

付録B　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報について説明しています。

用語解説

このマニュアルで使用している用語について説明しています。

マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

表記
製品名

Windows
次の製品を区別する必要がない場合の表記です。

Microsoft® Windows® 7

Microsoft® Windows Server® 2003

Microsoft® Windows Server® 2003 R2

Microsoft® Windows Server® 2008

Microsoft® Windows Server® 2008 R2

Microsoft® Windows Server® 2012

Microsoft® Windows Vista®

Microsoft® Windows® XP

Windows 7
Microsoft® Windows® 7

Windows Server 2008
次の製品を区別する必要がない場合の表記です。

Microsoft® Windows Server® 2008

Microsoft® Windows Server® 2008 R2

Windows Server 2012
Microsoft® Windows Server® 2012

Windows Vista
Microsoft® Windows Vista®

このマニュアルで使用している記号

このマニュアルで使用している記号について説明します。

記号
意味と例

|
（ストローク）
複数の項目に対して，項目間の区切りを示します。

{ }
（波括弧）
コマンドの記述で使用している場合
この記号で囲まれている複数の項目の中から，必ず1つの項目を選択します。
（例）
「{A|B|C}」は，「A，B，Cの中から必ずどれか1つだけを選んで指定すること」を示します。

[ ]
（角括弧）
コマンドの記述で使用している場合
この記号で囲まれている複数の項目の中から，任意に1つの項目を選択します。必要でない場合，省略できます。
（例）
「[A]」は，「必要に応じてAを指定すること」を示します（必要でない場合，Aを省略できます）。
「[B|C]」は，「必要に応じてBまたはCを指定すること」を示します（必要でない場合，BもCも，ともに省略できます）。

操作の記述で使用している場合
キー名を示しています。
（例）
［Ctrl］+［C］
CtrlキーとCキーを同時に押すことを示します。

1. CLIの概要

この章では，CLIのコマンド一覧，およびボリューム操作の流れについて概要を説明します。

この章の構成

1.1 CLIのコマンド一覧

1.2 CLIを使用したボリュームの操作

1.1 CLIのコマンド一覧

CLIでは，コマンドラインからコマンドを操作して，ストレージドメイン情報を取得したり，ストレージ階層，マイグレーショングループを作成したり，ボリュームをマイグレーション，ロック，ロック解除，シュレッディングしたりできます。コマンドごとの機能概要を次の表に示します。

表1-1 CLIコマンドの機能概要

分類
コマンド名
機能概要

ストレージドメインの管理
GetStorageDomains
ストレージドメインの情報を取得します。

ModifyStorageDomain
ストレージドメインの属性を変更します。
次の属性を変更できます。

ストレージドメイン名

ストレージドメインの説明文

Refresh
ストレージドメインの情報を最新にします。リフレッシュの処理で，ストレージシステムの情報がDevice Managerから再取得され，Tiered Storage Managerのリポジトリーに登録されます。

ストレージ階層の管理
CreateStorageTier
ストレージ階層を作成します。

DeleteStorageTier
ストレージ階層を削除します。

GetStorageTiers
ストレージ階層の情報を取得します。

ModifyStorageTier
ストレージ階層の属性を変更します。次の属性を変更できます。

ストレージ階層名

ストレージ階層の検索条件

ストレージ階層の説明文

マイグレーショングループの管理
CreateMigrationGroup
マイグレーショングループを作成します。

DeleteMigrationGroup
マイグレーショングループを削除します。

GetMigrationGroups
マイグレーショングループの情報を取得します。

ModifyMigrationGroup
マイグレーショングループの属性を変更します。次の属性が変更できます。

マイグレーショングループ名

マイグレーション操作の対象とするかどうかを示す属性

マイグレーショングループの説明文

指定期間経過イベントを発生させるまでの日数

イベント通知先アドレス

指定期間経過イベント発生時の説明文

LDEV選択ルール（分散制御ルール，共存回避ルール）

AddVolumeToMigrationGroup
マイグレーショングループにボリュームを追加します。

RemoveVolumeFromMigrationGroup
マイグレーショングループからボリュームを削除します。

タスクの作成
CreateMigrationPlan
マイグレーションプランを作成します。

CreateMigrationTask
マイグレーションタスクを作成します。

CreateLockingTask
ボリュームをロックしてデータを書き込み禁止（Read only）または読み書き禁止（Protect）状態にする，ロッキングタスクを作成します。

CreateUnlockingTask
ボリュームのロックを解除する，アンロッキングタスクを作成します。

CreateShreddingTask
マイグレーショングループ内のデータを完全に消去する，シュレッディングタスクを作成します。

タスクの管理
GetTasks
タスクの情報を取得します。

ModifyTask
タスクの属性を変更します。次の属性を変更できます。

タスクの説明文

イベント通知先アドレス

ExecuteTask
Standby状態のタスクを実行します。

CancelTask
Standby状態のタスクを終了（キャンセル）状態にします。

StopTask
タスクを中止します。

DeleteTasks
終了状態のタスクを削除します。

ドメインコントローラーからの情報取得
GetVolumes
ストレージドメイン，ストレージ階層およびマイグレーショングループ内のボリューム情報を取得します。

GetPools
ストレージドメイン内のプール情報を取得します。

GetFreeSpaces
ストレージシステム内の空き容量の情報を取得します。

1.2 CLIを使用したボリュームの操作

CLIを使用したボリュームの操作の流れを次の図に示します。

図1-1 ボリュームの操作の流れ

タスクは，作成と同時に実行することもできます。

CLIでは，マイグレーショングループを指定したマイグレーションを実行できます。ボリュームを指定したマイグレーションを実行したい場合は，GUIを使用してください。

ロッキングタスク，アンロッキングタスク，およびシュレッディングタスクは，CLIでだけ作成できます。GUIでは作成できません。

CLIではGUIで作成したマイグレーションタスクは管理できません。

2. CLIを実行するまでの準備

この章では，CLIを実行するまでの手順を説明します。CLIのセットアップの方法，およびセットアップ後に必要な環境設定などを示します。

この章の構成

2.1 CLIのセットアップ

2.2 CLIのアンセットアップ

2.3 セットアップ後の準備

2.1 CLIのセットアップ

CLIは，管理サーバ，管理クライアントの両方で操作できます。ここでは，管理クライアントにCLIをセットアップする手順について説明します。

管理サーバでコマンドを実行する場合には，セットアップ不要です。管理サーバにTiered Storage Managerをインストールしたとき，CLIもセットアップされます。

この節の構成

2.1.1 WindowsでのCLIのセットアップ

2.1.2 Solaris，HP-UX，LinuxでのCLIのセットアップ

2.1.1 WindowsでのCLIのセットアップ

管理クライアントのOSがWindowsの場合に，CLIをセットアップする手順を説明します。

セットアップを開始する前に，次に示す要件を満たしているか確認してください。

JREがインストールされていること。

OSがインストールされているドライブに，100MB以上の空き容量があること。

Zip形式のファイルを解凍できる環境であること。

システムドライブに対して管理者権限を持つユーザーで，次のアクセスが許可されていること。
・ファイルの作成およびデータの書き込み
・フォルダの作成およびデータの追加

次に示す手順で，CLIをセットアップしてください。

管理者権限を持つユーザーで管理クライアントのマシンにログインする。

Tiered Storage Managerの管理サーバのマシンからCLIのセットアップファイルを，FTPまたは外部記録媒体を使って管理クライアントのマシンに転送する。
セットアップファイルの転送先は任意です。
CLIのセットアップファイルは，管理サーバ内の次のフォルダまたはディレクトリに格納されています。

管理サーバのOSがWindowsの場合

＜Tiered Storage Managerサーバのインストールフォルダ＞¥Dist¥

管理サーバのOSがSolarisまたはLinuxの場合

＜Tiered Storage Managerサーバのインストールディレクトリ＞/Dist/

セットアップファイル名を次に示します。
TSM＜Tiered Storage Managerのバージョン＞-＜修正版番号＞_J＜ビルド番号＞_WIN_CLI.zip

転送したセットアップファイルを，Windowsのシステムドライブの下に解凍する。
セットアップ用バッチファイル，アンセットアップ用バッチファイル，CLI実行用バッチファイル，プロパティファイルが解凍結果として展開されます。

セットアップ用バッチファイルsetup.batを，コマンドプロンプトから実行する。

 ＜システムドライブ＞¥TieredStorageManager¥＜Tiered Storage Managerのバージョン＞¥Setup¥setup.bat

トレース情報を採取するための共通ライブラリーが格納，設定されます。また，CLI実行用バッチファイルが編集されます。共通ライブラリーは次のフォルダに格納されます。
＜システムドライブ＞¥Program Files¥Hitachi¥HNTRLib2

重要

setup.batを実行する場合の注意事項を次に示します。

Windows Vista，Windows 7，Windows Server 2008，またはWindows Server 2012では，管理者権限でsetup.batを実行してください。コマンドプロンプトを右クリックして，「管理者として実行」を選択してから実行してください。実行ユーザーに管理者権限がない場合，エラーメッセージを表示してセットアップは中断されます。

setup.batを実行時，解凍先が正しいかどうかチェックされます。実行したsetup.batが，上記に示したパスに存在するsetup.batと異なる場合，エラーメッセージを表示してセットアップは中断されます。

2.1.2 Solaris，HP-UX，LinuxでのCLIのセットアップ

管理クライアントのOSがSolaris，HP-UX，またはLinuxの場合に，CLIをセットアップする手順を説明します。

セットアップを開始する前に，次に示す要件を満たしているか確認してください。

JREがインストールされていること。

/optが割り当てられているドライブに，100MB以上の空き容量があること。

次に示す手順で，CLIをセットアップしてください。

管理者権限を持つユーザー（root）で管理クライアントのマシンにログインする。

Tiered Storage Managerの管理サーバのマシンからCLIのセットアップファイルを，FTPまたは外部記録媒体を使って管理クライアントのマシンに転送する。
セットアップファイルの転送先は（/tmpなど）任意です。
CLIのセットアップファイルは，管理サーバ内の次のフォルダまたはディレクトリに格納されています。

管理サーバのOSがWindowsの場合

＜Tiered Storage Managerサーバのインストールフォルダ＞¥Dist¥

管理サーバのOSがSolarisまたはLinuxの場合

＜Tiered Storage Managerサーバのインストールディレクトリ＞/Dist/

管理クライアントのセットアップファイル名を次に示します。
TSM＜Tiered Storage Managerのバージョン＞-＜修正版番号＞_J＜ビルド番号＞_＜OS種別＞_CLI.tar.gz
＜OS種別＞に入る文字列と意味は次のとおりです。

SOL：Solaris（SPARC）用

AMD64：Solaris（x64）用

HP：HP-UX用

LNX：Linux（RHEL）用

LNXS：Linux（SLES）用

転送したセットアップファイルを，ディレクトリ/optの下に解凍する。
セットアップ用シェルスクリプト，アンセットアップ用シェルスクリプト，CLI実行用シェルスクリプト，プロパティファイルが解凍結果として展開されます。

セットアップ用シェルスクリプトsetup.shを実行する。

/opt/TieredStorageManager/＜Tiered Storage Managerのバージョン＞/Setup/setup.sh

トレース情報を採取するための共通ライブラリーが格納，設定されます。共通ライブラリーは次のディレクトリに格納されます。
/opt/Hitachi/HNTRLib2

重要

setup.shを実行時，次の項目がチェックされます。どちらにも一致しなかった場合，エラーメッセージを表示してセットアップは中断されます。

実行したsetup.shが，上記に示したパスに存在するsetup.shと同じファイルか（setup.shの解凍先が正しいか）

実行したsetup.shが，管理クライアントのOSに一致したセットアップファイルか

2.2 CLIのアンセットアップ

CLIをアンセットアップするには，アンセットアップ用のバッチファイルまたはシェルスクリプトを実行する必要があります。CLIをアンセットアップすると，CLI実行用のファイルが削除され，トレース情報を採取するための共通ライブラリーがアンインストールされます。

アンセットアップ用のバッチファイルまたはシェルスクリプトは，セットアップ用のバッチファイルまたはシェルスクリプトと同じディレクトリにあります。

この節の構成

2.2.1 WindowsでのCLIのアンセットアップ

2.2.2 Solaris，HP-UX，LinuxでのCLIのアンセットアップ

2.2.1 WindowsでのCLIのアンセットアップ

OSがWindowsの場合に，CLIをアンセットアップする手順を次に示します。

htsmcli.propertiesファイルをバックアップする。
今後，アンセットアップするマシンでCLIを使用しない場合は，バックアップは不要です。

次のフォルダについて，次の2つの点を確認する。
＜システムドライブ＞¥TieredStorageManager

batファイルを実行するときのカレントディレクトリが，このフォルダまたはこれより下にないこと。

このフォルダ以下のファイルがアクセスされていないこと。

この2つの条件が満たされない場合，アンセットアップが正常に終了しても，フォルダが削除されないことがあります。

アンセットアップ用バッチファイルunsetup.batを，コマンドプロンプトから実行する。

 ＜システムドライブ＞¥TieredStorageManager¥＜Tiered Storage Managerのバージョン＞¥Setup¥unsetup.bat

トレース情報を採取するための共通ライブラリーがアンインストールされ，セットアップ時にセットアップファイルの解凍によって展開されたファイルやフォルダが削除されます。

重要

Windows Vista，Windows 7，Windows Server 2008，またはWindows Server 2012では，管理者権限でunsetup.batを実行してください。コマンドプロンプトを右クリックして，「管理者として実行」を選択してから実行してください。

実行ユーザーに管理者権限がない場合，エラーを表示してアンセットアップは中断されます。管理者権限でunsetup.batを実行し直してください。

2.2.2 Solaris，HP-UX，LinuxでのCLIのアンセットアップ

OSがSolaris，HP-UX，またはLinuxの場合に，CLIをアンセットアップする手順を次に示します。

htsmcli.propertiesファイルをバックアップする。
今後，アンセットアップするマシンでCLIを使用しない場合は，バックアップは不要です。

アンセットアップ用シェルスクリプトunsetup.shを実行する。

/opt/TieredStorageManager/＜Tiered Storage Managerのバージョン＞/Setup/unsetup.sh

トレース情報を採取するための共通ライブラリーがアンインストールされ，セットアップ時にセットアップファイルの解凍によって展開されたファイルやディレクトリが削除されます。

2.3 セットアップ後の準備

CLIのセットアップが完了したあと，CLIコマンドを実行するために必要な準備について説明します。

この節の構成

2.3.1 htsmcli.propertiesファイルを設定する

2.3.2 HTSM_CLI_HOMEを設定する

2.3.3 プロパティファイルまたはパスワードファイルに指定するパスワードをコード化する

2.3.4 CLI/logsフォルダのアクセス権限を変更する

2.3.5 Javaの実行環境を設定する

2.3.6 SSL通信のための設定をする

2.3.7 メモリーサイズを割り当てる

2.3.8 管理クライアントで実行するCLIの言語種別を設定する

2.3.1 htsmcli.propertiesファイルを設定する

サーバのロケーション，ユーザー名，パスワード，およびSSL通信の有無は，CLIを実行するたびに入力する必要があります。この手間を省くために，htsmcli.propertiesファイルにサーバのロケーションや共通で使用するオプションを指定しておくと便利です。

CLIコマンドの引数，オプション，およびパラメーターの書式については，「3.3 CLIコマンドの記述形式」を参照してください。

htsmcli.propertiesファイルのデフォルトの格納場所については，「6.1 CLIのプロパティファイルの概要」を参照してください。htsmcli.propertiesファイルの設定例は，「6.2 htsmcli.propertiesファイルでのオプションやパラメーターの指定」を参照してください。

2.3.2 HTSM_CLI_HOMEを設定する

HTSM_CLI_HOMEは，htsmcli.propertiesファイルの所在をCLIに通知するための環境変数です。HTSM_CLI_HOMEを設定しておかないと，Tiered Storage Managerはhtsmcli.propertiesファイルを使用できません。htsmcli.propertiesファイルは，任意の位置に格納できます。

Windows環境の場合，次の点に注意してください。

パスを引用符（"）や単一引用符（'）で囲まないでください。
（不正な指定の例："C:¥TieredStorageManager¥＜Tiered Storage Managerのバージョン＞¥CLI"）

パスの終端に「¥」を指定しないでください。
（不正な指定の例： C:¥TieredStorageManager¥＜Tiered Storage Managerのバージョン＞¥CLI¥）

ドライブ直下を指定しないでください。
（不正な指定の例： C:¥）

2.3.3 プロパティファイルまたはパスワードファイルに指定するパスワードをコード化する

htsmcli.propertiesファイルまたはパスワードファイルにパスワードを指定しておくと，CLIを実行するときにパスワードの入力を省略できます。htsmcli.propertiesファイルまたはパスワードファイルには，平文でパスワードを指定することもできますが，セキュリティを高めるため， htsmaccountコマンドでパスワードをコード化することをお勧めします。

この項の構成

(1) パスワードをコード化する場合の環境設定

(2) htsmaccountコマンドの使用方法

(1) パスワードをコード化する場合の環境設定

パスワードをコード化する際の強度には，NORMALとHIGHがあります。NORMALの強度でパスワードをコード化する場合，環境設定は必要ありません。より安全性の高いコード化文字列を生成するためにコード化時の強度をHIGHに変更したい場合は，マニュアル「Hitachi Command Suite Software システム構成ガイド」を参照してください。

(2) htsmaccountコマンドの使用方法

パスワードをコード化して，htsmcli.propertiesファイルまたはパスワードファイルに出力するhtsmaccountコマンドについて説明します。htsmaccountコマンドの格納場所を次に示します。

管理クライアントの場合

OSがWindowsのとき

＜システムドライブ＞¥TieredStorageManager¥＜Tiered Storage Managerのバージョン＞¥CLI¥

OSがSolaris，HP-UX，またはLinuxのとき

/opt/TieredStorageManager/＜Tiered Storage Managerのバージョン＞/CLI/

管理サーバの場合

OSがWindowsのとき

＜Tiered Storage Managerサーバのインストールフォルダ＞¥CLI¥

OSがSolarisまたはLinuxのとき

＜Tiered Storage Managerサーバのインストールディレクトリ＞/CLI/

htsmaccountコマンドは，CLI（htsmcli）を実行するときのOSのログインユーザーアカウントで実行してください。htsmaccountコマンドを実行したユーザーアカウントとは別のユーザーアカウントでCLIを実行すると，エラーになるおそれがあります。

htsmaccountコマンドの書式を次に示します。

htsmaccount { -u ＜ユーザー名＞ [-f ＜パスワードファイルの絶対パス＞] ｜ help }

-u

CLIを実行するTiered Storage Managerのユーザー名を指定します。htsmcli.propertiesファイルのoption.usernameプロパティにユーザー名を設定済みの場合は，-uに同じユーザー名を指定してください。CLIを実行するユーザー名を変更する場合は，事前にhtsmcli.propertiesファイルのoption.usernameプロパティの設定を変更してください。また，すでにoption.password2プロパティにコード化されたパスワードが設定されている場合は，option.password2プロパティの値を削除してください。

-f

コード化したパスワードをファイルに出力する場合に指定します。ファイル名を絶対パスで指定します。-fオプションを指定した場合，htsmcli.propertiesファイルのoption.password2プロパティにはファイルへのパスが設定されます。-fオプションを省略した場合，htsmcli.propertiesファイルのoption.password2プロパティには，コード化されたパスワード文字列が設定されます。

help

htsmaccountコマンドのヘルプを表示します。

htsmaccountコマンドを実行すると，パスワードの入力を促すメッセージが表示されます。パスワードを2回入力すると，パスワードがコード化されてhtsmcli.propertiesファイルのoption.password2プロパティに自動的に設定されます。

htsmaccountコマンドの実行時に，htsmcli.propertiesファイルのoption.passwordプロパティまたはoption.password2プロパティがすでに設定されている場合，まず，設定済みのパスワードを入力してください。入力した文字列が設定済みのパスワードと一致した場合は，コード化したいパスワードの入力を促すメッセージが表示されます。パスワードがコード化されると，既存のプロパティは削除され，新しいoption.password2プロパティが設定されます。

コマンド実行後は，CLIのコマンド実行時にパスワードの指定を省略できます。htsmaccountコマンドを実行したら，CLIのセットアップ終了後に，実際にGetStorageDomainsコマンドを実行して，正しくパスワードが設定されていることを確認してください。

2.3.4 CLI/logsフォルダのアクセス権限を変更する

Windowsの場合，CLIを使用する前に，CLI/logsフォルダのアクセス権限を，CLIを利用するユーザーアカウントで読み書きできるように変更してください。

管理サーバでセットアップ済みのCLI/logsフォルダ
＜Tiered Storage Managerサーバのインストールフォルダ＞¥CLI¥logs

管理クライアントでセットアップしたCLI/logsフォルダ
＜システムドライブ＞¥TieredStorageManager¥＜Tiered Storage Managerのバージョン＞¥CLI¥logs

2.3.5 Javaの実行環境を設定する

コマンドを実行する前に，Javaの実行環境を設定します。

環境変数HTSM_CLI_JRE_PATHに，CLIを使用するのに必要なバージョンのjavaコマンドへのパスを設定してください。環境変数HTSM_CLI_JRE_PATHが指定されていない場合は，環境変数PATHに設定されているJREを使ってCLIを実行します。

Windowsの場合にはsetコマンドで環境変数を設定できます。Solaris，HP-UX，またはLinuxの場合には，OSの種類や使用しているシェルによって，setenvやexportなど使用するコマンドが異なります。

WindowsでHTSM_CLI_JRE_PATHを指定する例は，次のとおりです。

C:¥>SET HTSM_CLI_JRE_PATH=C:¥Program Files¥Java¥j2re1.4.2_06¥bin

Windowsで環境変数HTSM_CLI_JRE_PATHを設定するときは，次の点に注意してください。

パスを引用符（"）や単一引用符（'）で囲まないでください。
（不正な指定の例："C:¥Documents and Settings"）

パスの終端に「¥」を指定しないでください。
（不正な指定の例：C:¥Documents and Settings¥）

ドライブ直下を指定しないでください。
（不正な指定の例：C:¥）

アクセス権限のないフォルダを指定しないでください。

重要

ファイアウォールを越えてTiered Storage Managerサーバへ接続する場合は，CLIでjava.exeを使えるように，ファイアウォールを設定する必要があります。

2.3.6 SSL通信のための設定をする

Tiered Storage Managerサーバとの通信にSSL通信を使用する場合，Tiered Storage ManagerサーバおよびCLIを実行する管理クライアントでの環境設定が必要です。

セキュリティ通信のための設定方法については，マニュアル「Hitachi Command Suite Software システム構成ガイド」を参照してください。

環境設定を完了したあと，CLIコマンドの引数（サーバのロケーションおよびオプション）に，SSLで通信するための値を指定して実行してください。SSL通信に関するCLIコマンドの引数については，「3.3.1 CLIコマンドの引数」および「3.3.2 すべてのCLIコマンドに共通するオプション」を参照してください。

2.3.7 メモリーサイズを割り当てる

CLIコマンドを実行するために，メモリーサイズの最大値を適切に割り当てる必要があります。割り当てるメモリーサイズの最大値は，環境変数HTSM_CLI_MEM_SIZEで設定します。

メモリーサイズの最大値は150MB以上に設定してください。デフォルト値は「256M」と設定されており，256MBが確保されます。デフォルト値のまま運用することをお勧めします。

バイト単位表記で設定するため，キロバイトであれば「k」または「K」を，メガバイトであれば「m」または「M」を必ず付けてください。

HTSM_CLI_MEM_SIZEの設定値がCLIの実行に必要なメモリーサイズに満たない場合，CLIは次のエラーメッセージを表示して終了します。

A java.lang.OutOfMemoryError exception occurred in the main thread.
<<No stack trace is available>>

上記のエラーが発生した場合は，HTSM_CLI_MEM_SIZE の値を増やしてから実行し直してください。

2.3.8 管理クライアントで実行するCLIの言語種別を設定する

CLIの言語種別は，サーバ側のロケールに合わせておくことをお勧めします。

これは，管理クライアントマシンでCLIを実行する場合，Tiered Storage Managerサーバから受け取った情報はTiered Storage Managerサーバのロケールに依存するためです。CLIが出力するメッセージやトレースの出力情報はCLIを実行しているマシンのロケールに依存します。

管理サーバと同じマシンでCLIを実行する場合は，CLIとTiered Storage Managerサーバのロケールが同じため，出力情報の言語も同じです。

3. CLIコマンドを使用する

この章では，CLIコマンドを使用するために必要な予備知識について説明します。CLIコマンドのユーザー権限，格納場所，記述形式，パラメーターの書式などについて示します。

この章の構成

3.1 CLIコマンドとユーザー権限

3.2 CLIコマンドの実行と注意事項

3.3 CLIコマンドの記述形式

3.4 CLIコマンドの戻り値と出力情報

3.5 CLIコマンドのヘルプ表示

3.1 CLIコマンドとユーザー権限

CLIコマンドを実行する前に，コマンドを実行するユーザーに関する設定が必要です。設定はGUIで実施します。設定方法については，マニュアル「Hitachi Command Suite Software ユーザーズガイド」を参照してください。CLIを使用するためのユーザー設定の方法は，LegacyモードのGUIを使用する場合の設定方法と同じです。

コマンド実行ユーザーを登録後，ユーザーが属するユーザーグループに，リソースグループ「All Resources」に対するDevice Managerのロールを割り当ててください。また，CLIコマンドを実行するには，Tiered Storage Managerのユーザー権限を設定する必要があります。必要な権限はコマンドによって異なります。コマンドごとのユーザー権限を次の表に示します。

表3-1 CLIコマンドとユーザー権限の対応

コマンド名 | 権限
Admin | Modify | Execute | View
AddVolumeToMigrationGroup | × | ○ | × | ×
CancelTask | × | ○ | × | ×
CreateLockingTask | × | ○ | × | ×
CreateMigrationGroup | × | ○ | × | ×
CreateMigrationPlan | ○ | ○ | ○ | ○
CreateMigrationTask | × | ○ | × | ×
CreateShreddingTask | × | ○ | × | ×
CreateStorageTier | × | ○ | × | ×
CreateUnlockingTask | × | ○ | × | ×
DeleteMigrationGroup | × | ○ | × | ×
DeleteStorageTier | × | ○ | × | ×
DeleteTasks | × | ○ | × | ×
ExecuteTask | × | ○ | ○ | ×
GetFreeSpaces | ○ | ○ | ○ | ○
GetMigrationGroups | ○ | ○ | ○ | ○
GetPools | ○ | ○ | ○ | ○
GetStorageDomains | ○ | ○ | ○ | ○
GetStorageTiers | ○ | ○ | ○ | ○
GetTasks | ○ | ○ | ○ | ○
GetVolumes | ○ | ○ | ○ | ○
ModifyMigrationGroup | × | ○ | × | ×
ModifyStorageDomain | ○ | ○ | × | ×
ModifyStorageTier | × | ○ | × | ×
ModifyTask | × | ○ | × | ×
Refresh | ○ | ○ | × | ×
RemoveVolumeFromMigrationGroup | × | ○ | × | ×
StopTask | × | ○ | × | ×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

3.2 CLIコマンドの実行と注意事項

CLIは，Javaアプリケーションとして使用できますが，容易に操作するためバッチファイル（スクリプト）形式で実行できるようになっています。CLIコマンドを実行する場合，次のように入力してください。

管理サーバと同じマシンでコマンドを実行する場合

Windowsの場合

＜Tiered Storage Managerサーバのインストールフォルダ＞¥CLI¥htsmcli 引数

SolarisまたはLinuxの場合

＜Tiered Storage Managerサーバのインストールディレクトリ＞/CLI/htsmcli 引数

管理クライアントマシンでコマンドを実行する場合

Windowsの場合

＜システムドライブ＞¥TieredStorageManager¥＜Tiered Storage Managerのバージョン＞¥CLI¥htsmcli 引数

Solaris，HP-UX，またはLinuxの場合

# ./htsmcli 引数

コマンドラインに引数を指定しないでコマンドを実行すると，CLIのバージョンとヘルプの指定形式が表示されます。

重要

コマンドを実行するときの注意事項について説明します。

［Ctrl］ + ［C］を使用したり，ウィンドウを閉じたりすることでCLIコマンドを中断した場合，コマンドの実行結果が確認できなくなります。この場合，GetTasksなどのコマンドを実行してコマンドの実行結果を確認してください。また，必要に応じて，再度DeleteTasksなどのコマンドを実行してください。

Windowsでユーザーアカウント制御（UAC）機能を有効にしている場合は，管理者権限で起動したコマンドプロンプトからCLIを実行してください。 管理者権限で実行しないと，ログファイルおよび実行結果が指定先に出力されない場合があります。

3.3 CLIコマンドの記述形式

この節では，コマンドラインで記述するCLIコマンドの形式（コマンド構文）を説明します。

この節の構成

3.3.1 CLIコマンドの引数

3.3.2 すべてのCLIコマンドに共通するオプション

3.3.3 パラメーターの書式

3.3.1 CLIコマンドの引数

コマンドラインの一般的な書式は，次のとおりです。

htsmcli [サーバのロケーション] コマンド名 [オプション]... [パラメーター]

CLIには，次の4つの引数があります。

サーバのロケーション

コマンド名

オプション

パラメーター

この引数のなかで,次の引数はhtsmcli.propertiesファイルにあらかじめ設定できます。htsmcli.propertiesファイルに設定しておけば，コマンドラインで，これらの引数指定を省略できます。

サーバのロケーション

すべてのCLIコマンドに共通するオプション（「3.3.2 すべてのCLIコマンドに共通するオプション」参照）

パラメーター

htsmcli.propertiesファイルに設定できるCLIコマンドの引数の詳細については，「表6-2 htsmcli.propertiesファイルのプロパティとCLIコマンドの引数の対応」を参照してください。

htsmcli.propertiesファイルに設定された引数の値とコマンドラインで指定した値が異なる場合は，コマンドラインで指定した値が優先されます。

それぞれの引数について説明します。

この項の構成

(1) サーバのロケーション

(2) コマンド名

(3) オプション

(4) パラメーター

(1) サーバのロケーション

Tiered Storage Managerサーバのロケーションを，次の形式で指定してください。

rmi://＜ホスト名またはIPアドレス＞:＜ポート＞/HTSMServer

（例：rmi://myhost.mydomain:20352/HTSMServer）

ホスト名またはIPアドレス

Tiered Storage Managerサーバのホスト名またはIPアドレスを指定してください。省略すると，ローカルホストが指定されていると見なされます。

IPv6アドレスを指定する場合には，次に示すようにIPv6アドレスを[ ]で囲んでください。ただし，[ ]を付けた状態でIPv6アドレスの指定を省略すると，エラーとなります。

rmi://[＜IPv6アドレス＞]:＜ポート＞/HTSMServer

OSがSolaris，HP-UX，またはLinuxの場合，IPv6アドレスを指定するときには，プラットフォームに応じたエスケープ文字の使用が必要になることがあります。

ポート

Tiered Storage Managerサーバのポート番号を指定してください。

Tiered Storage ManagerサーバとSSL通信しない場合は，Tiered Storage Managerサーバのserver.rmi.portプロパティに設定されたポート番号（デフォルト：20352）を指定します。

Tiered Storage ManagerサーバとSSL通信する場合は，Tiered Storage Managerサーバのserver.rmi.security.portプロパティに設定されたポート番号（デフォルト：24500）を指定します。

省略した場合は，"20352"が指定されていると見なされます。

(2) コマンド名

GetStorageDomains, CreateMigrationTaskなど，Tiered Storage Managerサーバに処理を要求するためのコマンドの名称です。

コマンド名では，大文字と小文字は区別されません。

（例：getstoragedomainsとGETSTORAGEDOMAINSは同じです）

(3) オプション

オプションは一般的なUNIX方式で入力します。各オプションには1文字表現と単語表現があります。1文字の場合は，1個のハイフンが接頭部となり，単語表現の場合は，2個のハイフンが接頭部となります。

（例：1文字の場合は「-u」，単語の場合は「--username」）

オプションの指定順序は任意です。オプションでは，大文字と小文字が区別されます。

(4) パラメーター

要求の一部としてサーバに渡される情報です。必要なパラメーターは要求したコマンドによって異なります。各パラメーターは，「名前」と「値」の組み合わせで表現されます。

3.3.2 すべてのCLIコマンドに共通するオプション

オプションには，すべてのCLIコマンドで共通に使われるものと，一部のCLIコマンドだけに使われるものがあります。ここでは，すべてのCLIコマンドで共通に使われるオプションについて説明します。

オプションのあとに引数の指定が必要な場合，引数は，1つの文字列となるように指定してください。空白文字を含む場合には，次の例のように引用符で囲むなど，コマンドの実行環境の仕様に従ってください。

--output "C:¥My Documents¥redirect.txt"

すべてのコマンドに共通するオプションを次の表に示します。

表3-2 すべてのCLIコマンドに共通するオプション

オプション
オプションの引数
説明

-uまたは--username
ユーザー名
Tiered Storage Managerサーバへのログインで使用するユーザー名を指定します。
コマンドラインおよびhtsmcli.propertiesファイルのどちらにも指定がない場合は，エラーになります。

-pまたは--password
パスワード
または
@パスワードファイル名
ユーザー名に対応するパスワードを指定します。※1，※2

パスワードを直接指定するか，またはパスワードが書かれたファイルを指定します。

ファイル名を指定する場合，引数には「先頭に@を付けたファイル名」を指定します。指定したテキストファイルに書かれている1行目の文字列がパスワードであると見なされます。ファイル名は絶対パス，またはCLIコマンドが実行されるディレクトリからの相対パスで指定します。

パスワードを誤って，連続してログインに失敗すると，Tiered Storage Managerサーバは該当するユーザーアカウントをロックします。※3

-oまたは--output
標準出力のリダイレクトファイル名※4
標準出力のリダイレクト先ファイル名を指定します。

CLIコマンドの実行結果を，コンソールの代わりに指定したファイルに取得したい場合，そのファイル名を引数に指定します。

ファイル名は絶対パス，またはコマンドが実行されるディレクトリからの相対パスで指定します。

-sまたは--secure
引数なし
Tiered Storage ManagerサーバとCLI間で，SSL通信するときに指定します。

注※1

パスワードは，--passwordオプション（または，--passwordオプションに対応するhtsmcli.propertiesファイルのoption.passwordプロパティ）で平文で指定する方法と，htsmaccountコマンドでコード化した文字列を指定する方法があります。どちらかを指定してください。コード化した文字列でパスワードを指定する方法については，「2.3.3 プロパティファイルまたはパスワードファイルに指定するパスワードをコード化する」を参照してください。

注※2

ログインユーザーIDを指定して，ログインパスワードをオプションとプロパティどちらにも指定しないでコマンドを実行した場合，ログインパスワードの入力を促すメッセージが表示されます。

注※3

アカウントのロックを解除できるのは，User ManagementのAdmin権限を持つユーザーだけです。

注※4

標準出力のリダイレクト先ファイルを任意のumaskで作成したい場合には，--outputオプションではなく，シェルのリダイレクト機能を使用してください。ファイル名に使用できない文字をリダイレクトファイルなどのファイル名に指定すると，予期しない結果が起こるおそれがあります。例えば，Windowsでリダイレクト先または--outputオプションにコロン（:）を含むファイル名を指定すると，コロンの前までの文字列でファイル名が生成されますが，そのファイルには何も出力されません。

3.3.3 パラメーターの書式

パラメーターは，「名前=値」の形式で指定してください。例を次に示します。

controllerserialnumber = 14011

パラメーターの指定順序は任意です。「名前」では，大文字と小文字は区別されません。特に記載がない場合，「値」では，大文字と小文字が区別されます。

パラメーターは，1つの文字列となるように指定してください。空白文字を含む場合には，次の例のように引用符で囲んでください。

"filtercondition = capacity < '1024GB'"

重要

パラメーターを指定する場合の注意事項を次に示します。

OSが特殊な意味を持たせている記号（"<"，">"，"&"，"!"など）をコマンドの引数としてコマンドラインで使用する場合は注意してください。OSの特殊な意味に解釈されないように，それらの記号を含む文字列を引用符（"）や単一引用符（'）で囲んだり，エスケープ文字を使用したりしてください。

Windows Vistaの4バイト文字を使用した場合，動作は保証されません。

各パラメーターの説明，および指定できる値は，「5. CLIコマンドの詳細」を参照してください。

「5. CLIコマンドの詳細」に詳細な指定値が記載されていない場合は，「A.2 パラメーター指定値に使用できる文字の種類と文字列長」を参照して指定してください。大文字小文字の区別，および，空文字列が指定できるかどうかなどについても説明していますので，各コマンドのパラメーターに値を指定する場合には参考にしてください。

3.4 CLIコマンドの戻り値と出力情報

CLIは，そのプロセスの最後に戻り値を返します。

CLIの戻り値は，次の2とおりです。

戻り値が0または正の値の場合，CLIが正常に終了したことを示します。

戻り値が負の値の場合，CLIがそのプロセス中にエラーを検出したことを示します（パラメーターエラーなど）。

正常に終了した場合には，標準出力にコマンドの処理結果が出力されます。処理結果の例については，各コマンドの指定例を参照してください。正常終了の場合でも，標準エラー出力にメッセージが出力されることがあります。

エラーを検出した場合には，標準エラー出力にエラーメッセージが出力されます。エラーメッセージに従って対処してください。

タスクの実行結果の確認

タスクの実行結果は，CLIコマンドの戻り値だけでは確認できません。GetTasksコマンドを用いて実行したタスクの情報を取得し，結果を確認してください。

3.5 CLIコマンドのヘルプ表示

基本ヘルプ情報を表示する場合は，CLIを引数なしでhelpだけ指定して実行してください。

Windowsの場合

＜システムドライブ＞¥TieredStorageManager¥＜Tiered Storage Managerのバージョン＞¥CLI¥htsmcli help

Solaris，HP-UX，またはLinuxの場合

# ./htsmcli help

コマンドごとの詳細な形式を表示するには，helpに続けてGetVolumes，CreateMigrationTaskなどのコマンド名を指定してください。

Windowsの場合

＜システムドライブ＞¥TieredStorageManager¥＜Tiered Storage Managerのバージョン＞¥CLI¥htsmcli help コマンド名

Solaris，HP-UX，またはLinuxの場合

# ./htsmcli help コマンド名

指定したコマンドの指定形式やパラメーターなどの説明が表示されます。

4. CLIで使用できる検索条件

filterconditionパラメーター（またはnewfilterconditionパラメーター）に指定する，検索条件式の概要，構文，および検索条件式の中に指定するプロパティについて説明します。

この章の構成

4.1 検索条件の種類と概要

4.2 検索条件式の構文

4.3 プロパティの概要

4.4 プロパティに指定できる値の範囲

4.1 検索条件の種類と概要

CLIの一部のコマンドでは，filterconditionパラメーター（またはnewfilterconditionパラメーター）に，検索条件式を指定して，コマンドを実行する対象を絞り込んだり，検索結果を使用して，ストレージ階層を管理したりできます。

検索条件式は，プロパティの組み合わせで指定します。この章でいうプロパティとは，「4.2 検索条件式の構文」で記述している検索条件式中のcomparison-predicateを意味します。

検索条件式の種類を，次の表に示します。

表4-1 検索条件式の種類と概要

種類と構文の名称
説明および指定できるコマンド
指定できるプロパティ

ストレージ階層の検索条件式
（storage-tier-filter-condition）
ストレージ階層で管理するボリュームやプールを指定するための検索条件式
1つのストレージ階層でボリュームとプールの両方は管理できないため，ボリューム検索条件とプール検索条件を同時に指定することはできません。
指定できるコマンド：

CreateStorageTier

ModifyStorageTier

ストレージ階層が管理する対象によって，指定するプロパティが異なります。

検索対象がボリュームの場合，「表4-2 ボリューム検索条件式に指定できるプロパティの概要」および「表4-5 ボリューム検索条件式のプロパティに指定できる値の範囲」を参照してください。
ただし，ストレージ階層で管理するボリュームを指定するための検索条件としては，指定できないプロパティもあります。

検索対象がプールの場合，「表4-3 プール検索条件式に指定できるプロパティの概要」および「表4-6 プール検索条件式のプロパティに指定できる値の範囲」を参照してください。

ボリュームの検索条件式
（volume-filter-condition）
ストレージドメインやストレージ階層内のボリュームを検索するための検索条件式
指定できるコマンド：

CreateMigrationPlan

GetVolumes

「表4-2 ボリューム検索条件式に指定できるプロパティの概要」および「表4-5 ボリューム検索条件式のプロパティに指定できる値の範囲」を参照してください。

プールの検索条件式
（pool-filter-condition）
ストレージドメイン内のプールを検索するための検索条件式
指定できるコマンド：GetPools
「表4-3 プール検索条件式に指定できるプロパティの概要」および「表4-6 プール検索条件式のプロパティに指定できる値の範囲」を参照してください。

空き容量の検索条件式
（unused-capacity-filter-condition）
Device Managerに登録されているストレージシステム内の空き容量を検索するための検索条件式
指定できるコマンド：GetFreeSpaces
「表4-4 空き容量検索条件式に指定できるプロパティの概要」および「表4-7 空き容量検索条件式のプロパティに指定できる値の範囲」を参照してください。

4.2 検索条件式の構文

検索条件式の構文をBNFで次に示します。

storage-tier-filter-condition ::= and-search-condition
                              | or-search-condition
and-search-condition ::= comparison-predicate
                     | and-search-condition "AND" and-search-condition
                     | "(" and-search-condition ")"
or-search-condition ::= comparison-predicate
                     | or-search-condition "OR" or-search-condition
                     | "(" or-search-condition ")"

volume-filter-condition ::= term | volume-filter-condition "OR" volume-filter-condition
term ::= factor | term "AND" term
factor ::= test | "NOT" factor
test ::= comparison-predicate | "(" volume-filter-condition ")"

pool-filter-condition ::= pool-term | pool-filter-condition "OR" pool-filter-condition
pool-term ::= pool-factor | pool-term "AND" pool-term
pool-factor ::= pool-test | "NOT" pool-factor
pool-test ::= comparison-predicate | "(" pool-filter-condition ")"

unused-capacity-filter-condition ::= unused-capacity-term
      | unused-capacity-filter-condition "OR" unused-capacity-filter-condition
unused-capacity-term ::= unused-capacity-factor
                | unused-capacity-term "AND" unused-capacity-term
unused-capacity-factor ::= unused-capacity-test | "NOT" unused-capacity-factor
unused-capacity-test ::= comparison-predicate
                | "(" unused-capacity-filter-condition ")"

comparison-predicate ::= symbol comp-op literal
symbol ::= name
comp-op ::= "=" | "<>" | "<" | ">" | "<=" | ">=" | "startsWith"
           | "contains"| "endsWith"
literal ::= string-literal | numeric-literal
numeric-literal ::= digit { digit }
digit ::= "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9"

繰り返し指定について次に示します。

中括弧 { } は，0回以上の繰り返しを表します。

1つの検索条件式に最大30個のcomparison-predicateを記述できます。

重要

literalには，「値が不明」であることを指定できません。値が不明である場合も文字列の"Unknown"である場合も，どちらも"Unknown"と表示されることがあります。

comp-opの種類と意味を次に示します。

=：等しいことを示します。

<>：等しくないことを示します。

startsWith：指定文字列で始まる値を検索することを示します。

endsWith：指定文字列で終わる値を検索することを示します。

contains：指定文字列を含む値を検索することを示します。

この節の構成

4.2.1 string-literalの記述形式

4.2.2 複数の要素を指定できるプロパティの記述規則

4.2.1 string-literalの記述形式

string-literalは次の規則に従って記述してください。

string-literalが次に示す文字を含む場合は，string-literalを単一引用符（'）で囲んで指定してください。

空白文字

括弧（ ( ) ）

不等号（< >）

等号（=）

単一引用符（ '）

 例：RAIDLevel='RAID5(3D+1P)'

string-literalに単一引用符（'）が含まれる場合は，単一引用符に単一引用符を1つ加えてください。

例：subsystemNameがSTORAGESYSTEM'AAAの場合

subsystemName='STORAGESYSTEM''AAA'

string-literalが英数字以外の特殊文字で始まっている場合は，comp-opとの間に空白文字を入れて分離するか，またはstring-literalを単一引用符で囲んでください。

 例：DiskType= - または DiskType='-'

4.2.2 複数の要素を指定できるプロパティの記述規則

複数の要素をコンマ（，）で区切って指定できるプロパティで，各要素に指定できる文字に制限がない場合は，次の規則に従って入力してください。

なお，要素を1つだけ指定する場合も，次の規則に従って入力してください。

要素にコンマが含まれる場合

要素を単一引用符（'）で囲み，単一引用符で囲んだものに含まれる単一引用符ごとに，単一引用符を1つ加えてください。そして，値全体を単一引用符で囲んでください。次に例を示します。

要素「A,B」の変換手順

要素「A,B」を単一引用符で囲み「'A,B'」にします。

「'A,B'」の単一引用符ごとに単一引用符を1つ加えて「''A,B''」にします。

「''A,B''」を単一引用符で囲んで「'''A,B'''」にします。

要素に単一引用符が含まれる場合

要素に含まれる単一引用符に単一引用符を1つ加えてください。次に，各要素を単一引用符で囲み，単一引用符で囲んだものに含まれる単一引用符ごとに単一引用符を1つ加えてください。そして，値全体を単一引用符で囲んでください。次に例を示します。

要素「C'D」の変換手順

要素「C'D」の単一引用符に単一引用符を1つ加えて「C''D」にします。

「C''D」を単一引用符で囲み「'C''D'」にします。

「'C''D'」の単一引用符ごとに単一引用符を1つ加えて「''C''''D''」にします。

「''C''''D''」を単一引用符で囲んで「'''C''''D'''」にします。

コンマや単一引用符を含んだ複数要素で構成される場合

要素に含まれる単一引用符に単一引用符を1つ加えてください。次に，各要素を単一引用符で囲み，単一引用符で囲んだものに含まれる単一引用符ごとに単一引用符を1つ加えてください。各要素をコンマと空白文字で区切って組み合わせます。そして，各要素を組み合わせた値全体を単一引用符で囲んでください。次に例を示します。

要素「A,B」と要素「C'D」で構成される値の変換手順

要素「A,B」と要素「C'D」は，それぞれ「''A,B''」と「''C''''D''」にします。

各要素の組み合わせのため，「''A,B'', ''C''''D''」にします。

各要素を組み合わせた値を単一引用符で囲んで「'''A,B'', ''C''''D'''」にします。

4.3 プロパティの概要

検索条件式のプロパティの概要を，管理する対象別（ボリューム，プール，および空き容量）に示します。

表4-2 ボリューム検索条件式に指定できるプロパティの概要

プロパティ名
説明

ArrayGroupBusyRate※1
パリティグループの使用率

ArrayGroupMaxBusyRate※1
パリティグループの使用率の最大値

Capacity
ボリューム容量

CLPRNumber
CLPR番号

ConsumedCapacity
ボリュームの実使用量

ConsumedCapacityPercentage
ボリュームの実使用量の割合

ControllerArrayGroup
コントローラーパリティグループ名

ControllerDeviceNumber
コントローラー論理デバイス番号

CopyOnWriteSnapshot
{ XPSnapshot }
( SnapshotXP )
Copy-on-Write Snapshotのボリューム種別
このプロパティは，ストレージシステムがHUS VMのときには指定できません。

CVS※1
ボリュームがCVS属性かどうかを示す文字列

DiskCapacityInGB
ドライブ容量（単位はGB）

DiskRPM
ドライブ回転数

DiskType
ドライブ種別

DynamicProvisioning
{ XPThinProvisioning }
ボリューム種別

EmulationType
エミュレーションタイプ

Encryption
暗号化設定

FDChipType
フラッシュメモリーのチップタイプ（詳細種別）

Host
ホスト名

Label
ボリュームに設定されているラベル

PoolId
プール番号

PortHostStorageDomain※1
ポート/ホストストレージドメイン名
入力したポート/ホストストレージドメイン名とTiered Storage Managerに登録されているポート/ホストストレージドメイン名が比較されます。

PVolMigrationGroup※1
ボリュームがShadowImageのS-VOLである場合，対応するP-VOLが含まれているマイグレーショングループ名

PVolMUNumber※1
ボリュームがShadowImageのS-VOLである場合，対応するP-VOLのMU番号

RAIDLevel
RAIDレベル

ShadowImage
{ BusinessCopy }
( BusinessCopyXP )
ShadowImageのボリューム種別

SLPRNumber
SLPR番号

SubsystemDisplayModel
ストレージシステムの表示用モデル名

SubsystemModel※2
ストレージシステムのモデル名

SubsystemName
ストレージシステム名

SubsystemSerialNumber
ストレージシステムのシリアル番号

SubsystemVendor
ストレージシステムのベンダー名

SysplexidDevn※1
SYSPLEXID/DEVN

ThinImage
{ FastSnap }
Thin Imageのボリューム種別
このプロパティは，ストレージシステムがVirtual Storage PlatformおよびHUS VMのときに指定できます。

TrueCopyAsynchronous
{ ContinuousAccessAsynchronous }
( ContinuousAccessXPAsynchronous )
TrueCopy Asyncのボリューム種別
このプロパティは，ストレージシステムがVirtual Storage PlatformおよびHUS VMのときには指定できません。

TrueCopySynchronous
{ ContinuousAccessSynchronous}
( ContinuousAccessXPSynchronous )
TrueCopy Syncのボリューム種別

UniversalReplicator
{ ContinuousAccessJournal }
( ContinuousAccessXPJournal )
Universal Replicatorのボリューム種別

VOLSER※1
メインフレームホストの管理するメインフレームボリューム情報（ボリューム通し番号）

VolumeLockStatus
ボリュームのロック状態を示す文字列

VolumeStatus
ボリュームが使用中かどうかを示す文字列

（凡例）

{ }：ストレージシステムがVP9500，H24000，またはH20000のときに使用する文字列です。

( )：ストレージシステムがH12000またはH10000のときに使用する文字列です。

注※1

ストレージ階層の検索条件式（CreateStorageTierコマンドのfilterconditionパラメーター，および，ModifyStorageTierコマンドのnewfilterconditionパラメーター）には，指定できないプロパティです。

注※2

旧バージョンとの互換性を維持するためのプロパティです。新たに検索条件を指定するときは，SubsystemDisplayModelを使用してください。

表4-3 プール検索条件式に指定できるプロパティの概要

プロパティ名
説明

PoolFreeCapacity
プール空き容量

PoolId
プール番号

OverProvisioningLimit
仮想化超過限界しきい値

OverProvisioningPercent
仮想化超過率
仮想化超過率とは，DPプールの容量に対する，DPプールに関連づけられたDPボリューム容量の総和の比率を示します。

OverProvisioningWarning
仮想化超過警告しきい値

表4-4 空き容量検索条件式に指定できるプロパティの概要

プロパティ名 | 説明
ArrayGroup | パリティグループ名
Capacity | パリティグループ内の連続した空き容量
DiskCapacityInGB | ドライブ容量（単位はGB）
DiskRPM | ドライブ回転数
DiskType | ドライブ種別
EmulationType | パリティグループのエミュレーションタイプ
FDChipType | フラッシュメモリーのチップタイプ（詳細種別）
RAIDLevel | パリティグループのRAIDレベル
SubsystemName | ストレージシステム名
SubsystemVendor | ストレージシステムのベンダー名
TotalFreeCapacity | パリティグループの空き容量の総和

4.4 プロパティに指定できる値の範囲

検索条件式のプロパティに指定できる値の範囲について，管理する対象別（ボリューム，プール，および空き容量）に示します。

プロパティ名では，大文字，小文字による区別はされません。

指定できる文字列の長さは，UTF-8（1文字＝1～3バイト，ASCII文字は1文字＝1バイト）で換算した長さで示しています。

また，指定する文字列に空白文字が混在できる場合で，次の演算子を使用するとき，空白文字を指定する方法に制限があります。ただし，Labelについては，例外がありますので，詳細は「表4-5 ボリューム検索条件式のプロパティに指定できる値の範囲」のLabelを参照してください。

" = ", " <> "：先頭と末尾に空白文字を指定できません。

"startsWith"：先頭に空白文字を指定できません。末尾の空白文字は検索文字列の一部となります。

"contains"：先頭や末尾の空白文字も検索文字列の一部となります。

"endsWith"：末尾に空白文字を指定できません。先頭の空白文字は検索文字列の一部となります。

そのほかの空白文字，空文字列，または記号文字の指定に関する制限や，大文字小文字の区別については，「表4-8 検索条件式のプロパティに指定する文字の制限」を参照してください。

表4-5 ボリューム検索条件式のプロパティに指定できる値の範囲

プロパティ名
演算子
指定できる値または文字

ArrayGroupBusyRate※1
<, <=, =, <>, >, >=
0から100までの整数値

ArrayGroupMaxBusyRate※1
<, <=, =, <>, >, >=
0から100までの整数値

Capacity
<, <=, =, <>, >, >=
次に示す正の整数，または正の整数と単位を示す文字列の組み合わせで指定します（"256", "500KB", "10MB"など）。

単位に"Block"以外を指定した場合，または単位を省略した場合は，"KB"の単位に変換したときの値が，0から9,223,372,036,854,775,807までの整数

単位に"Block"を指定した場合は，0から9,223,372,036,854,775,807までの整数

指定できる単位は"KB", "MB", "GB", "TB", "Block"。単位を指定しないと，"KB"の値と見なされます。※2

CLPRNumber
=, <>
0から31までの整数値

ConsumedCapacity
<, <=, =, <>, >, >=
次に示す正の整数，または正の整数と単位を示す文字列の組み合わせで指定します（"256", "500KB", "10MB"など）。

"KB"の単位に変換したときの値が，0から281,474,976,710,653までの整数

指定できる単位は"KB", "MB", "GB", "TB"。単位を指定しないと，"KB"の値と見なされます。※2

ConsumedCapacityPercentage
<, <=, =, <>, >, >=
0から100までの整数値

ControllerArrayGroup
=, <>,
startsWith,
contains
Device Manager CLIのGetStorageArray(subtarget=ArrayGroup)でArrayGroupオブジェクトのdisplayName属性に表示される値を指定します。
指定できる文字は次のとおりです。
A～Z
a～z
0～9
" - "（ハイフン）
" _ "（アンダースコア）
" . "（ピリオド）
" @ "（アットマーク）
"　"（空白文字）
非ASCII文字
演算子が" = "または" <> "の場合は，ControllerArrayGroup名を" , "で区切って複数指定できます。" , "で区切られた要素の最大数は100です。
ControllerArrayGroup名ごとに75バイトまで指定できます。

ControllerDeviceNumber
=
次の形式で指定します。
[論理DKC番号:]CU番号:LDEV番号
0x100未満の16進数を" : "（コロン）で区切って指定してください。最上位に指定する値にかぎり，前ゼロを省略できます。
次に指定例を示します。

論理DKC番号を省略する場合："2:0a"または"02:0A"

論理DKC番号を指定する場合："0:02:0a"または"00:02:0A"

" , "区切りによる列挙指定，または" - "区切りによる範囲指定ができます。
" , "で区切られた要素の最大数は100です。
" - "区切りによる範囲指定は1要素だけ指定できます。

CopyOnWriteSnapshot
{ XPSnapshot }
( SnapshotXP )
=, <>
"Simplex"
"P-VOL"
"V-VOL"
"POOL"
このプロパティは，ストレージシステムがHUS VMのときには指定できません。

CVS※1
=
"Yes"
"No"

DiskCapacityInGB※3
<, <=, =, <>, >, >=
0から2,147,483,645までの整数値

DiskRPM
<, <=, =, <>, >, >=
0から2,147,483,645までの整数値

DiskType
=, <>
"FC"
"AT"
"BD"
"SAS"
"SAS(SED)"
"SSD"
"FMD"
"-"

DynamicProvisioning
{ XPThinProvisioning }
=, <>
"-"
"DP-VOL"
{ "THP-VOL" }
"DP-Pool-VOL"
{ "THP-Pool-VOL" }

EmulationType
=, <>
Device Manager CLIのGetStorageArray(subtarget=LogicalUnit)でLogicalUnitオブジェクトのemulation属性に表示される値を指定します。
75バイトまで指定できます。

Encryption
=
"Enabled"
"Disabled"
"-"

FDChipType
=, <>
"SLC"
"MLC"

Host
=, <>,
startsWith,
contains
256バイトまで指定できます。

Label
=, <>,
startsWith,
contains
64バイトまで指定できます。
演算子を使用する場合，先頭や末尾にも空白文字を指定できます。その場合，空白文字も検索文字列の一部となります。

PoolId
=, <>
PoolId番号を" , "で区切って複数指定できます。" , "で区切られた要素の最大数は100です。
1要素ごとに20バイトまで指定できます。

PortHostStorageDomain※1
=, <>,
startsWith,
contains,
endsWith
「<ポート名>/<ホストストレージドメイン名>」の形式で指定します。
149バイトまで指定できます。

PVolMigrationGroup※1
=, <>
指定できる文字は，次のとおりです。
A～Z
a～z
0～9
" - "（ハイフン）
" _ "（アンダースコア）
" . "（ピリオド）
" @ "（アットマーク）
"　"（空白文字）
非ASCII文字
75バイトまで指定できます。

PVolMUNumber※1
=, <>
0から2までの整数値

RAIDLevel
=, <>
Device Manager CLIのGetStorageArray(subtarget=LogicalUnit)でLogicalUnitオブジェクトのraidType属性に表示される値を指定します。
"RAIDx"，または"RAIDx(yD+zP)"の形式で指定します。
RAIDx：RAIDレベル
yD：データドライブの数
zP：パリティドライブの数
75バイトまで指定できます。

ShadowImage
{ BusinessCopy }
( BusinessCopyXP )
=, <>
"Simplex"
"P-VOL"
"S-VOL"
"SP-VOL"

SLPRNumber
=, <>
0から31までの整数値

SubsystemDisplayModel
=, <>
Device Manager CLIのGetStorageArrayでStorageArrayオブジェクトのdisplayArrayType属性に表示される値を指定します（arrayType属性ではありません）。
表示用モデル名が不明な場合は，プロダクト名を指定します。
384バイトまで指定できます。

SubsystemModel※4
=, <>
Device Manager CLIの GetStorageArrayでStorageArrayオブジェクトのarrayType属性に表示される値を指定します。
モデル名が不明な場合は，プロダクト名を指定してください。
384バイトまで指定できます。

SubsystemName
=, <>
Device Manager CLIのGetStorageArrayでStorageArrayオブジェクトのname属性に表示される値を指定します。
ストレージシステム名が不明な場合は，プロダクト名とシリアル番号を指定します。
384バイトまで指定できます。

SubsystemSerialNumber
=, <>,
startsWith,
contains
Device Manager CLIのGetStorageArrayでStorageArrayオブジェクトのserialNumber属性に表示される値を指定します。
150バイトまで指定できます。

SubsystemVendor
=, <>
Device Manager CLIのGetStorageArrayでVolumeConnectionオブジェクトのvendor属性に表示される値を指定します。
150バイトまで指定できます。

SysplexidDevn※1
=, <>,
startsWith,
contains
25バイトまで指定できます。

ThinImage
{ FastSnap }
=, <>
"Simplex"
"P-VOL"
"V-VOL"
"POOL"
このプロパティは，ストレージシステムがVirtual Storage PlatformおよびHUS VMのときに指定できます。

TrueCopyAsynchronous
{ ContinuousAccessAsynchronous }
( ContinuousAccessXPAsynchronous )
=, <>
"Simplex"
"P-VOL"
"S-VOL"
このプロパティは，ストレージシステムがVirtual Storage PlatformおよびHUS VMのときには指定できません。

TrueCopySynchronous
{ ContinuousAccessSynchronous }
( ContinuousAccessXPSynchronous )
=, <>
"Simplex"
"P-VOL"
"S-VOL"

UniversalReplicator
{ ContinuousAccessJournal }
( ContinuousAccessXPJournal )
=, <>
"Simplex"
"P-VOL"
"S-VOL"
"SP-VOL"
"JNL-VOL"

VOLSER※1
=, <>,
startsWith,
contains
75バイトまで指定できます。

VolumeLockStatus
=
"Locked"
"Unlocked"

VolumeStatus
=
"Used"
"Free"

（凡例）

{ }：ストレージシステムがVP9500，H24000，またはH20000のときに使用する文字列です。

( )：ストレージシステムがH12000またはH10000のときに使用する文字列です。

注※1

ストレージ階層の検索条件式（CreateStorageTierコマンドのfilterconditionパラメーター，および，ModifyStorageTierコマンドのnewfilterconditionパラメーター）には，指定できないプロパティです。

注※2

コマンドの出力情報では，値が整数で表せる，より上位の単位で表示できる場合，容量の単位が指定した単位と異なります。例えば，10,240KBは10MBと表示されます。

注※3

ドライブ容量は，Device ManagerからはKB単位の値を取得します。ただし，Tiered Storage Managerでは，KB単位の値をGB単位の値に変換したものを扱います。変換は，1,024×1,024の値で割り，小数以下を四捨五入して整数値に丸めます。

注※4

旧バージョンとの互換性を維持するためのプロパティです。新たに検索条件を指定するときは，SubsystemDisplayModelを使用してください。

表4-6 プール検索条件式のプロパティに指定できる値の範囲

プロパティ名
演算子
指定できる値または文字

PoolFreeCapacity
=, <>, >, >=, <, <=
次に示す正の整数，または正の整数と単位を示す文字列の組み合わせで指定します（"256", "500KB", "10MB"など）。

"KB"の単位に変換したときの値が，0から281,474,976,710,653までの正の整数

指定できる単位は"KB", "MB", "GB", "TB"。単位を指定しないと，"KB"の値と見なされます。※

PoolId
=, <>
PoolId番号を" , "で区切って複数指定できます。" , "で区切られた要素の最大数は100です。
1要素ごとに20バイトまで指定できます。

OverProvisioningLimit
=, <>, >, >=, <, <=
0から2,147,483,645までの正の整数

OverProvisioningPercent
=, <>, >, >=, <, <=
0から2,147,483,645までの正の整数

OverProvisioningWarning
=, <>, >, >=, <, <=
0から2,147,483,645までの正の整数

注※

コマンドの出力情報では，PoolFreeCapacityの単位がユーザーの指定した単位と異なる場合があります。それは，値が整数で表せる，より上位の単位で表示できる場合です。例えば，10,240KBは10MBと表示されます。

表4-7 空き容量検索条件式のプロパティに指定できる値の範囲

プロパティ名
演算子
指定できる値または文字

ArrayGroup
=, <>,
startsWith,
contains
Device Manager CLIのGetStorageArray(subtarget=ArrayGroup)でArrayGroupオブジェクトのdisplayName属性に表示される値を指定します。
演算子が" = "または" <> "の場合は，ArrayGroup名を" , "で区切って複数指定できます。" , "で区切られた要素の最大数は100です。
ArrayGroup名ごとに1,024バイトまで指定できます。

Capacity
=, <>, >, >=, <, <=
次に示す正の整数，または正の整数と単位を示す文字列の組み合わせで指定します（"256", "500KB", "10MB"など）。

"KB"の単位に変換したときの値が，0から9,223,372,036,854,775,807までの正の整数

指定できる単位は"KB", "MB", "GB", "TB"。単位を指定しないと，"KB"の値と見なされます。※1

DiskCapacityInGB※2
=, <>, >, >=, <, <=
0から2,147,483,645までの整数値

DiskRPM
=, <>, >, >=, <, <=
0から2,147,483,645までの整数値

DiskType
=, <>
"FC"
"AT"
"BD"
"SAS"
"SAS(SED)"
"SSD"
"FMD"
"-"

EmulationType
=, <>
Device Manager CLIのGetStorageArray(subtarget=LogicalUnit)でLogicalUnitオブジェクトのemulation属性に表示される値を指定します。
75バイトまで指定できます。

FDChipType
=, <>
"SLC"
"MLC"

RAIDLevel
=, <>
Device Manager CLIのGetStorageArray(subtarget=LogicalUnit)でLogicalUnitオブジェクトのraidType属性に表示される値を指定します。
"RAIDx"，または"RAIDx(yD+zP)"の形式で指定します。
RAIDx：RAIDレベル
yD：データドライブの数
zP：パリティドライブの数
75バイトまで指定できます。

SubsystemName
=, <>
Device Manager CLIのGetStorageArrayでStorageArrayオブジェクトのname属性に表示される値を指定します。
384バイトまで指定できます。

SubsystemVendor
=, <>
Device Manager CLIのGetStorageArrayでVolumeConnectionオブジェクトのvendor属性に表示される値を指定します。
150バイトまで指定できます。

TotalFreeCapacity
=, <>, >, >=, <, <=
次に示す正の整数，または正の整数と単位を示す文字列の組み合わせで指定します（"256", "500KB", "10MB"など）。

"KB"の単位に変換したときの値が，0から9,223,372,036,854,775,807までの正の整数

指定できる単位は"KB", "MB", "GB", "TB"。単位を指定しないと，"KB"の値と見なされます。※1

注※1

コマンドの出力情報では，値が整数で表せる，より上位の単位で表示できる場合，容量の単位が指定した単位と異なります。例えば，10,240KBは10MBと表示されます。

注※2

ドライブ容量は，Device ManagerからはKB単位の値を取得します。ただし，Tiered Storage Managerでは，KB単位の値をGB単位の値に変換したものを扱います。変換は，1,024×1,024の値で割り，小数以下を四捨五入して整数値に丸めます。

表4-8 検索条件式のプロパティに指定する文字の制限

プロパティ名
指定できない文字

ArrayGroup

空文字列は指定できません。

" , "で区切って複数指定する場合，ArrayGroup名の前後の空白文字は無視されます。

ArrayGroupBusyRate

" + "（プラス）記号は付けられません。

-0は0として扱われます。

ArrayGroupMaxBusyRate

Capacity

" + "（プラス）記号は付けられません。

-0は0として扱われます。

空白文字の混在はできません。

大文字，小文字による区別はされません。

CLPRNumber

" + "（プラス）記号は付けられません。

-0は0として扱われます。

ConsumedCapacity

" + "（プラス）記号は付けられません。

-0は0として扱われます。

空白文字の混在はできません。

大文字，小文字による区別はされません。

ConsumedCapacityPercentage

" + "（プラス）記号は付けられません。

-0は0として扱われます。

ControllerArrayGroup

空文字列は指定できません。

" , "で区切って複数指定する場合，ControllerArrayGroup名の前後の空白文字は無視されます。

ControllerDeviceNumber
文字列の前後の空白文字は無視されます。

CopyOnWriteSnapshot
{ XPSnapshot }
( SnapshotXP )

空白文字の混在はできません。

大文字，小文字による区別はされません。

このプロパティは，ストレージシステムがHUS VMのときには指定できません。

CVS

空白文字の混在はできません。

大文字，小文字による区別はされません。

DiskCapacityInGB

" + "（プラス）記号は付けられません。

-0は0として扱われます。

DiskRPM

DiskType

空白文字の混在はできません。

大文字，小文字による区別はされません。

DynamicProvisioning
{ XPThinProvisioning }

EmulationType

途中に含まれる空白文字では区別されません。

大文字，小文字による区別はされません。

Encryption

空白文字の混在はできません。

大文字，小文字による区別はされません。

FDChipType

Host
--

Label

OverProvisioningLimit

" + "（プラス）記号は付けられません。

-0は0として扱われます。

OverProvisioningPercent

OverProvisioningWarning

PoolFreeCapacity

" + "（プラス）記号は付けられません。

-0は0として扱われます。

空白文字の混在はできません。

大文字，小文字による区別はされません。

PoolId

各要素には，" , "以外の文字を指定してください。

要素間の空白文字は無視されます。

PortHostStorageDomain
--

PVolMigrationGroup
空文字列は指定できません。

PVolMUNumber

" + "（プラス）記号は付けられません。

-0は0として扱われます。

RAIDLevel

途中に含まれる空白文字では区別されません。

大文字，小文字による区別はされません。

ShadowImage
{ BusinessCopy }
( BusinessCopyXP )

空白文字の混在はできません。

大文字，小文字による区別はされません。

SLPRNumber

" + "（プラス）記号は付けられません。

-0は0として扱われます。

SubsystemDisplayModel

途中に含まれる空白文字では区別されません。

大文字，小文字による区別はされません。

SubsystemModel

SubsystemName
--

SubsystemSerialNumber

SubsystemVendor

途中に含まれる空白文字では区別されません。

大文字，小文字による区別はされません。

SysplexidDevn
--

ThinImage
{ FastSnap }

空白文字の混在はできません。

大文字，小文字による区別はされません。

このプロパティは，ストレージシステムがVirtual Storage PlatformおよびHUS VMのときに指定できます。

TotalFreeCapacity

" + "（プラス）記号は付けられません。

-0は0として扱われます。

空白文字の混在はできません。

大文字，小文字による区別はされません。

TrueCopyAsynchronous
{ ContinuousAccessAsynchronous }
( ContinuousAccessXPAsynchronous )

空白文字の混在はできません。

大文字，小文字による区別はされません。

このプロパティは，ストレージシステムがVirtual Storage PlatformおよびHUS VMのときには指定できません。

TrueCopySynchronous
{ ContinuousAccessSynchronous }
( ContinuousAccessXPSynchronous )

空白文字の混在はできません。

大文字，小文字による区別はされません。

UniversalReplicator
{ ContinuousAccessJournal }
( ContinuousAccessXPJournal )

VOLSER
--

VolumeLockStatus

空白文字の混在はできません。

大文字，小文字による区別はされません。

VolumeStatus

（凡例）

-- ：指定する文字に制限はありません。

{ }：ストレージシステムがVP9500，H24000，またはH20000のときに使用する文字列です。

( )：ストレージシステムがH12000またはH10000のときに使用する文字列です。

5. CLIコマンドの詳細

この章では，各CLIコマンドについて，機能，指定できるオプション，指定できるパラメーター，コマンドの出力項目を説明します。また，コマンドごとにコマンドの指定例とその結果を示します。

この章の構成

5.1 コマンド共通の説明

5.2 ストレージドメインを管理するためのコマンド

5.3 ストレージ階層を管理するためのコマンド

5.4 マイグレーショングループを管理するためのコマンド

5.5 タスクを作成するためのコマンド

5.6 タスクを管理するためのコマンド

5.7 ドメインコントローラーから情報を取得するためのコマンド

5.8 タスクの状態

5.1 コマンド共通の説明

各コマンドの説明は，記述形式，オプション，パラメーター，出力項目，指定例と実行結果の順に説明しています。

記述形式では，すべてのコマンドに共通のオプションは，「共通オプション」と簡略して記載しています。

コマンドの指定例では，すべてのコマンドに共通のオプションは省略しています。これらはhtsmcli.propertiesファイルで設定されているものとします。

すべてのコマンドに共通のオプションについては，「3.3.2 すべてのCLIコマンドに共通するオプション」を参照してください。

5.2 ストレージドメインを管理するためのコマンド

ストレージドメインを管理するためのコマンドについて説明します。

この節の構成

5.2.1 GetStorageDomains

5.2.2 ModifyStorageDomain

5.2.3 Refresh

5.2.1 GetStorageDomains

GetStorageDomainsコマンドは，Device Managerに追加されているストレージシステムに対応するストレージドメインの情報を取得します。

すべてのストレージドメインの情報，またはnameパラメーターで指定したストレージドメインの情報を取得できます。

リフレッシュが必要なストレージドメインに対してコマンドを実行した場合，標準エラー出力に警告メッセージが出力されます。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] GetStorageDomains
   [ 共通オプション ]
   [ { -d | --detail } ]
   [ name=ストレージドメイン名[ ,ストレージドメイン名 ]... ]

(2) オプション

-dまたは--detail

CLIコマンド実行後に，詳細情報を標準出力に表示したいときに指定します。

省略した場合，サマリー情報だけが表示されます。

(3) パラメーター

パラメーターの指定は，任意です。

表5-1 GetStorageDomainsコマンドのパラメーター

パラメーター名
説明

name
情報を取得したいストレージドメインの名称を指定します。
指定を省略すると，すべてのストレージドメインが対象になります。
複数のストレージドメイン名を指定する場合は，ストレージドメイン名をコンマで区切ってください。
ストレージドメイン名は，255個まで指定できます。ただし，コマンドラインの文字数の上限に依存します。

(4) 出力項目

重要

一部の出力項目では，リフレッシュの状態が「未実行」，「実行中」，または「終了（失敗）」のときに"Unknown"が表示されます。

表5-2 GetStorageDomainsコマンドの出力項目（StorageDomainインスタンス）

項目名
説明

name
ストレージドメイン名です。

totalCapacityInGB
ストレージドメイン内の実ボリュームの総容量（単位はGB）です。1GB未満は切り捨てて，整数で表示されます。

usedCapacityInGB
ストレージドメイン内の実ボリュームのうち，使用中ボリュームの容量（単位はGB）です。1GB未満は切り捨てて，整数で表示されます。

usedCapacityPercentage
totalCapacityInGBに対するusedCapacityInGBの割合（%）です。1%未満は切り上げて，整数で表示されます。

freeCapacityInGB
ストレージドメイン内の実ボリュームのうち，空きボリュームの容量（単位はGB）です。1GB未満は切り捨てて，整数で表示されます。

freeCapacityPercentage
totalCapacityInGBに対するfreeCapacityInGBの割合（%）です。1%未満は切り捨てて，整数で表示されます。

[numberOfSubsystems]
ストレージドメイン内のストレージシステムの数です。

numberOfStorageTiers
ストレージドメイン内のストレージ階層の数です。

numberOfMigrationGroups
ストレージドメイン内のマイグレーショングループの数です。

refreshStatus
リフレッシュの状態です。

NotInitialized： 未実行

Processing：実行中

Success： 終了（成功）

Failure：終了（失敗）

Incomplete：終了（不完全）

RefreshRequired：要リフレッシュ

[lastRefreshedTime]
前回リフレッシュが終了した日時です。リフレッシュが終了していない場合は空文字が表示されます。

[controllerSerialNumber]
ドメインコントローラーのシリアル番号です。

[controllerDisplayModel]
ドメインコントローラーの表示用モデル名です。

[controllerName]
ドメインコントローラー名です。

[logicalDKCNumber]
ドメインコントローラーの論理DKC番号です。

[description]
ストレージドメインの説明文です。

（凡例）

[ ]：-dまたは--detailオプションの指定があるときだけ出力されます。

表5-3 GetStorageDomainsコマンドの出力項目（ErrorInfoインスタンス）

項目名 | 説明
message | エラーメッセージです。

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

コマンド指定例：
ストレージドメインMegaTechUSP600-PrimaryとMegaTechUSP600-Secondaryの詳細情報を取得します。

htsmcli GetStorageDomains --detail name="MegaTechUSP600-Primary,MegaTechUSP600-Secondary"

実行結果：
MegaTechUSP600-PrimaryおよびMegaTechUSP600-Secondaryの詳細情報が出力されています。MegaTechUSP600-SecondaryのrefreshStatusがFailureであるため，MegaTechUSP600-Secondaryの情報の最後にList of 1 ErrorInfo elements:で始まるエラーの情報が表示されています。

RESPONSE:
List of 2 StorageDomain elements:
 An instance of StorageDomain(1 of 2)
   name=MegaTechUSP600-Primary
   totalCapacityInGB=8,552
   usedCapacityInGB=6,576
   usedCapacityPercentage=77
   freeCapacityInGB=1,975
   freeCapacityPercentage=23
   numberOfSubsystems=2
   numberOfStorageTiers=0
   numberOfMigrationGroups=0
   refreshStatus=Success
   lastRefreshedTime=2014/01/01 21:43:13
   controllerSerialNumber=14011
   controllerDisplayModel=USP
   controllerName=USP@10.208.151.151
   logicalDKCNumber=
   description=USP600-Primary
 An instance of StorageDomain(2 of 2)
   name=MegaTechUSP600-Secondary
   totalCapacityInGB=Unknown
   usedCapacityInGB=Unknown
   usedCapacityPercentage=Unknown
   freeCapacityInGB=Unknown
   freeCapacityPercentage=Unknown
   numberOfSubsystems=Unknown
   numberOfStorageTiers=3
   numberOfMigrationGroups=3
   refreshStatus=Failure
   lastRefreshedTime=
   controllerSerialNumber=59432
   controllerDisplayModel=USP
   controllerName=Unknown
   logicalDKCNumber=
   description=USP600-Secondary
   List of 1 ErrorInfo elements:
     An instance of ErrorInfo(1 of 1)
       message=KATS62010-E (以下，メッセージの内容が続きます。)

5.2.2 ModifyStorageDomain

ModifyStorageDomainコマンドは，ストレージドメインの情報（ストレージドメイン名，ストレージドメインの説明文）を変更します。

次の状態のストレージドメインについては，情報を変更できません。

終了状態（End）でないタスクがあるストレージドメイン

リフレッシュの状態が「未実行」，「実行中」，または「終了（失敗）」であるストレージドメイン

タスクの状態はGetTasksコマンドで確認してください。

リフレッシュが必要なストレージドメインに対してコマンドを実行した場合，標準エラー出力に警告メッセージが出力されます。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] ModifyStorageDomain
   [ 共通オプション ]
   [ { -d | --detail } ]
   name=ストレージドメイン名
   [ newname=ストレージドメイン名 ]
   [ newdescription=ストレージドメインの説明文 ]

(2) オプション

-dまたは--detail

CLIコマンド実行後に，詳細情報を標準出力に表示したいときに指定します。

省略した場合，標準出力には何も表示されません。

(3) パラメーター

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

パラメーター名
説明

name
ストレージドメイン情報を変更したいストレージドメインの名称を指定します。

[newname]
新しいストレージドメイン名を指定します。
Tiered Storage Manager内で一意になるように指定してください。
省略すると，ストレージドメイン名は変更されません。

[newdescription]
ストレージドメインの新しい説明文を指定します。
省略すると，ストレージドメインの説明文は変更されません。
空文字列を指定すると，以前に設定したストレージドメインの説明文は消去されます。

（凡例）

[ ]：指定は任意です。

(4) 出力項目

重要

一部の出力項目では，リフレッシュの状態が「未実行」，「実行中」，または「終了（失敗）」のときに"Unknown"が表示されます。

表5-5 ModifyStorageDomainコマンドの出力項目（StorageDomainインスタンス）

項目名 | 説明
name | ストレージドメイン名です。
controllerSerialNumber | ドメインコントローラーのシリアル番号です。
controllerDisplayModel | ドメインコントローラーの表示用モデル名です。
controllerName | ドメインコントローラー名です。
logicalDKCNumber | ドメインコントローラーの論理DKC番号です。
description | ストレージドメインの説明文です。

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

コマンド指定例：
ストレージドメインMegaTechUSP600-Primaryのストレージドメイン名をNewStorageDomainに変更します。

htsmcli ModifyStorageDomain --detail name="MegaTechUSP600-Primary" newname="NewStorageDomain"

実行結果：

RESPONSE:
An instance of StorageDomain(1 of 1)
 name=NewStorageDomain
 controllerSerialNumber=14011
 controllerDisplayModel=USP
 controllerName=USP@10.208.151.151
 logicalDKCNumber=
 description=USP600-Primary

5.2.3 Refresh

Refreshコマンドは，すべてのストレージドメイン，またはstoragedomainnameパラメーターで指定したストレージドメインのリフレッシュ処理（Device Managerから構成情報を再取得して，Tiered Storage Managerのリポジトリーに登録する処理）をします。

リフレッシュの処理は，Refreshコマンドの実行とは非同期に行われます。

リフレッシュ処理を実行したときにストレージアクセスでエラーになった場合，リフレッシュ処理は中止されます。状態はリフレッシュ処理を実行する前に戻ります。リフレッシュ処理が正常に完了したかどうかは，リフレッシュ後にストレージドメインの最終リフレッシュ日時（lastRefreshedTime）が更新されていることを確認してください。

リフレッシュの状態はGetStorageDomainsコマンドで確認してください。

この項の構成

(1) 記述形式

(2) パラメーター

(3) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] Refresh
   [ 共通オプション ]
   [ storagedomainname=ストレージドメイン名 ]

(2) パラメーター

パラメーターの指定は，任意です。

表5-6 Refreshコマンドのパラメーター

パラメーター名
説明

storagedomainname
ストレージドメイン名を指定します。
指定を省略すると，すべてのストレージドメインが対象になります。

(3) 出力項目

出力項目はありません。

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

コマンド指定例：
ストレージドメインMegaTechUSP600-Primaryに対してRefreshコマンドを発行して，Device Managerから構成情報を再取得し，Tiered Storage Managerリポジトリーへ登録します。

htsmcli Refresh storagedomainname="MegaTechUSP600-Primary"

実行結果：
このコマンドには，出力情報はありません。リフレッシュが完了したかどうか，GetStorageDomainsコマンドで確認してください。

5.3 ストレージ階層を管理するためのコマンド

ストレージ階層を管理するためのコマンドについて説明します。

この節の構成

5.3.1 CreateStorageTier

5.3.2 DeleteStorageTier

5.3.3 GetStorageTiers

5.3.4 ModifyStorageTier

5.3.1 CreateStorageTier

CreateStorageTierコマンドは，ストレージドメイン内にストレージ階層を作成します。ストレージ階層は，マイグレーションするときに移動先の候補となるボリュームの集合です。ストレージドメイン内のボリュームやプールを検索して，検索結果をそのままストレージ階層にします。

リフレッシュの状態が「実行中」または「終了（失敗）」であるストレージドメインの中には，ストレージ階層を作成できません。

リフレッシュが必要なストレージドメインに対してコマンドを実行した場合，標準エラー出力に警告メッセージが出力されます。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] CreateStorageTier
   [ 共通オプション ]
   [ { -d | --detail } ]
   storagedomainname=ストレージドメイン名
   name=ストレージ階層名
   [ resource={ Volume | Pool } ]
   filtercondition=検索条件
   [ description=ストレージ階層の説明文 ]
   [ cost=通常ボリュームのコスト
     chargefor={ Allocated | Utilized } ]
   [ { dpcost | thpcost }=DPボリュームのコスト
     { dpchargefor | thpchargefor }={ Allocated | Consumed | Utilized } ]

(2) オプション

-dまたは--detail

CLIコマンド実行後に，詳細情報を標準出力に表示したいときに指定します。

省略した場合，標準出力には何も表示されません。

(3) パラメーター

表5-7 CreateStorageTierコマンドのパラメーター

パラメーター名
説明

storagedomainname
ストレージドメイン名を指定します。

name
作成するストレージ階層の名称を指定します。
ストレージドメイン内で一意になるように指定してください。

[resource]
作成するストレージ階層の種別を指定します。指定しない場合は，filterconditionパラメーターで指定した条件に従います。

Volume：検索条件としてボリュームを指定

Pool：検索条件としてプールを指定

filtercondition
検索条件を指定します。
管理する対象によって，次のどちらかのプロパティを使用した検索条件式を指定してください。

ボリュームを管理対象とする場合，「表4-2 ボリューム検索条件式に指定できるプロパティの概要」および「表4-5 ボリューム検索条件式のプロパティに指定できる値の範囲」を参照してください。
ただし，ストレージ階層で管理するボリュームを指定するための検索条件としては，指定できないプロパティもあります。

プールを管理対象とする場合，「表4-3 プール検索条件式に指定できるプロパティの概要」および「表4-6 プール検索条件式のプロパティに指定できる値の範囲」を参照してください。

[description]
ストレージ階層の説明文を指定します。

[cost]
通常ボリュームのコストを次の形式で指定します。
通貨コード 金額 / 容量の単位 / 期間の単位

通貨コード ※
ISO4217に準拠した通貨コードを大文字のアルファベットで指定します。

金額
0から9,223,372,036,854,775,807までの整数で指定します。コンマやピリオドは使用できません。

容量の単位
MB，GB，またはTBを指定します。

期間の単位
MonthまたはYearを指定します。

ストレージ階層に，容量と期間ごとのコストや課金対象の情報を定義しておくと，コストを意識してストレージを運用できます。提供しているサービスやその課金体系に合わせて，自由にコストを設定してください。
このパラメーターは，ストレージ階層の検索条件がボリューム検索条件の場合に指定できます。
このパラメーターは，chargeforパラメーターと対で指定してください。

[chargefor]
通常ボリュームのコストの課金対象を指定します。

Allocated：ホストに割り当てられたボリューム容量

Utilized：ホストで使用されているボリューム容量

このパラメーターは，costパラメーターと対で指定してください。

[dpcost{ thpcost }]
DPボリュームのコストを指定します。
指定方法はcostパラメーターと同じです。
このパラメーターは，dpchargefor{ thpchargefor }パラメーターと対で指定してください。

[dpchargefor
{ thpchargefor }]
DPボリュームのコストの課金対象を指定します。

Allocated：ホストに割り当てられたDPボリューム容量

Consumed：消費済みのDPボリューム容量

Utilized：ホストで使用されているDPボリューム容量

このパラメーターは，dpcost{ thpcost }パラメーターと対で指定してください。

（凡例）

[ ]：指定は任意です。

{ }：ストレージシステムがVP9500，H24000，またはH20000のときに使用する文字列です。

注※

CLIでは，次の通貨コードを使用できます。

AED，AFN，ALL，AMD，ANG，AOA，ARS，AUD，AWG，AZN，BAM，BBD，BDT，BGN，BHD，BIF，BMD，BND，BOB，BOV，BRL，BSD，BTN，BWP，BYR，BZD，CAD，CDF，CHE，CHF，CHW，CLF，CLP，CNY，COP，COU，CRC，CUC，CUP，CVE，CZK，DJF，DKK，DOP，DZD，EEK，EGP，ERN，ETB，EUR，FJD，FKP，GBP，GEL，GHS，GIP，GMD，GNF，GTQ，GWP，GYD，HKD，HNL，HRK，HTG，HUF，IDR，ILS，INR，IQD，IRR，ISK，JMD，JOD，JPY，KES，KGS，KHR，KMF，KPW，KRW，KWD，KYD，KZT，LAK，LBP，LKR，LRD，LSL，LTL，LVL，LYD，MAD，MDL，MGA，MKD，MMK，MNT，MOP，MRO，MUR，MVR，MWK，MXN，MXV，MYR，MZN，NAD，NGN，NIO，NOK，NPR，NZD，OMR，PAB，PEN，PGK，PHP，PKR，PLN，PYG，QAR，RON，RSD，RUB，RWF，SAR，SBD，SCR，SDG，SEK，SGD，SHP，SLL，SOS，SRD，STD，SVC，SYP，SZL，THB，TJS，TMT，TND，TOP，TRY，TTD，TWD，TZS，UAH，UGX，USD，USN，USS，UYI，UYU，UZS，VEF，VND，VUV，WST，XAF，XAG，XAU，XBA，XBB，XBC，XBD，XCD，XDR，XFU，XOF，XPD，XPF，XPT，XTS，XXX，YER，ZAR，ZMK，ZWL

(4) 出力項目

表5-8 CreateStorageTierコマンドの出力項目（StorageDomainインスタンス）

項目名 | 説明
name | ストレージドメイン名です。

表5-9 CreateStorageTierコマンドの出力項目（StorageTierインスタンス）

項目名
説明

name
ストレージ階層名です。

filterCondition
ストレージ階層の検索条件です。

description
ストレージ階層の説明文です。

cost
通常ボリュームのコストが次の形式で表示されます。
通貨コード 金額 / 容量の単位 / 期間の単位
設定されていない場合は空文字が表示されます。

chargefor
通常ボリュームの課金対象です。

Allocated：ホストに割り当てられたボリューム容量

Utilized：ホストで使用されているボリューム容量

設定されていない場合は空文字が表示されます。

dpcost { thpcost }
DPボリュームのコストが次の形式で表示されます。
通貨コード 金額 / 容量の単位 / 期間の単位
設定されていない場合は空文字が表示されます。

dpchargefor
{ thpchargefor }
DPボリュームの課金対象です。

Allocated：ホストに割り当てられたDPボリューム容量

Consumed：消費済みのDPボリューム容量

Utilized：ホストで使用されているDPボリューム容量

設定されていない場合は空文字が表示されます。

（凡例）

{ }：ストレージシステムがVP9500，H24000，またはH20000のときに表示される文字列です。

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

コマンド指定例：
RAIDレベルがRAID5(3D+1P)のボリュームから成るストレージ階層を，ストレージドメインMegaTechUSP600-Primaryの中に作成します。ストレージ階層の名称をMegaTech-HighCostとします。

htsmcli CreateStorageTier --detail storagedomainname="MegaTechUSP600-Primary" name="MegaTech-HighCost" filtercondition="RAIDLevel='RAID5(3D+1P)' AND ControllerArrayGroup='1-10-1'"

実行結果：

RESPONSE:
An instance of StorageDomain(1 of 1)
 name=MegaTechUSP600-Primary
 List of 1 StorageTier elements:
   An instance of StorageTier(1 of 1)
     name=MegaTech-HighCost
     filterCondition=RAIDLevel = 'RAID5(3D+1P)' AND ControllerArrayGroup = '1-10-1'
     description=
     cost=
     chargefor=
     dpcost=
     dpchargefor=

5.3.2 DeleteStorageTier

DeleteStorageTierコマンドは，ストレージ階層を削除します。ストレージ階層内のボリューム有無に関わらず削除できます。

次の状態のストレージ階層は削除できません。

終了状態（End）でないタスクに指定されているストレージ階層

リフレッシュの状態が「実行中」または「終了（失敗）」であるストレージドメインの中にあるストレージ階層

タスクの状態はGetTasksコマンドで確認してください。

リフレッシュが必要なストレージドメインに対してコマンドを実行した場合，標準エラー出力に警告メッセージが出力されます。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] DeleteStorageTier
   [ 共通オプション ]
   [ { -d | --detail } ]
   storagedomainname=ストレージドメイン名
   name=ストレージ階層名

(2) オプション

-dまたは--detail

CLIコマンド実行後に，詳細情報を標準出力に表示したいときに指定します。

省略した場合，標準出力には何も表示されません。

(3) パラメーター

表5-10 DeleteStorageTierコマンドのパラメーター

パラメーター名 | 説明
storagedomainname | ストレージドメイン名を指定します。
name | 削除するストレージ階層の名称を指定します。

(4) 出力項目

DeleteStorageTierコマンドの出力項目は，CreateStorageTierコマンドの出力項目と同じです。CreateStorageTierコマンドの「(4) 出力項目」を参照してください。

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

コマンド指定例：
ストレージドメインMegaTechUSP600-Primaryの中にあるストレージ階層MegaTech-HighCostを削除します。

htsmcli DeleteStorageTier --detail storagedomainname="MegaTechUSP600-Primary" name="MegaTech-HighCost"

実行結果：

RESPONSE:
An instance of StorageDomain(1 of 1)
 name=MegaTechUSP600-Primary
 List of 1 StorageTier elements:
   An instance of StorageTier(1 of 1)
     name=MegaTech-HighCost
     filterCondition=RAIDLevel= 'RAID5(3D+1P)' AND Capacity < '1GB'
     description=
     cost=USD3000/TB/Year
     chargefor=Allocated
     dpcost=USD3/GB/Year
     dpchargefor=Consumed

5.3.3 GetStorageTiers

GetStorageTiersコマンドは，ストレージドメイン内にあるすべてのストレージ階層の情報，またはnameパラメーターで指定したストレージ階層の情報を取得します。

ストレージドメインのリフレッシュ状態が「実行中」または「終了（失敗）」である場合，ストレージ階層の情報を取得できません。

リフレッシュが必要なストレージドメインに対してコマンドを実行した場合，標準エラー出力に警告メッセージが出力されます。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] GetStorageTiers
   [ 共通オプション ]
   [ { -d | --detail } ]
   storagedomainname=ストレージドメイン名
   [ name=ストレージ階層名[ ,ストレージ階層名 ]... ]

(2) オプション

-dまたは--detail

CLIコマンド実行後に，詳細情報を標準出力に表示したいときに指定します。

省略した場合，サマリー情報だけが表示されます。

(3) パラメーター

表5-11 GetStorageTiersコマンドのパラメーター

パラメーター名
説明

storagedomainname
ストレージドメイン名を指定します。

[name]
ストレージ階層情報を取得したいストレージ階層の名称を指定します。指定を省略すると，ストレージドメイン内のすべてのストレージ階層が対象になります。
複数のストレージ階層名を指定する場合には，ストレージ階層名をコンマで区切ってください。
ストレージ階層名は，255個まで指定できます。ただし，コマンドラインの文字数の上限に依存します。

（凡例）

[ ]：指定は任意です。

(4) 出力項目

重要

一部の出力項目では，プール検索条件を使用して作成したストレージ階層の場合，出力する情報がないため" - "（ハイフン）が表示されます。

表5-12 GetStorageTiersコマンドの出力項目（StorageDomainインスタンス）

項目名 | 説明
name | ストレージドメイン名です。

表5-13 GetStorageTiersコマンドの出力項目（StorageTierインスタンス）

項目名
説明

name
ストレージ階層名です。

[filterCondition]
ストレージ階層の検索条件です。

[numberOfVolumes]
ストレージ階層内の実ボリュームの数です。

totalCapacityInGB
ストレージ階層内の実ボリュームの総容量（単位はGB）です。1GB未満は切り捨てて，整数で表示されます。

totalCapacityPercentageToStorageDomain
ストレージドメイン内の実ボリューム総容量に対するtotalCapacityInGBの割合（%）です。1%未満は切り上げて，整数で表示されます。

usedCapacityInGB
ストレージ階層内の実ボリュームのうち，使用中ボリュームの容量（単位はGB）です。1GB未満は切り捨てて，整数で表示されます。

usedCapacityPercentage
totalCapacityInGBに対するusedCapacityInGBの割合（%）です。1%未満は切り上げて，整数で表示されます。

freeCapacityInGB
ストレージ階層内の実ボリュームのうち，空きボリュームの容量（単位はGB）です。1GB未満は切り捨てて，整数で表示されます。

freeCapacityPercentage
totalCapacityInGBに対するfreeCapacityInGBの割合（%）です。1%未満は切り捨てて，整数で表示されます。

[numberOfManagedVolumes]
ストレージ階層内の論理ボリューム数です。ストレージ階層内の通常ボリュームおよび仮想ボリュームの数です。

totalManagedCapacityInGB
ストレージ階層内の通常ボリュームおよび仮想ボリュームの総容量（単位はGB）です。1GB未満は切り捨てて，整数で表示されます。

usedManagedCapacityInGB
ストレージ階層内の通常ボリュームおよび仮想ボリュームのうち，使用中ボリュームの総容量（単位はGB）です。1GB未満は切り捨てて，整数で表示されます。

usedManagedCapacityPercentage
totalManagedCapacityInGBに対するusedManagedCapacityInGBの割合（%）です。1%未満は切り上げて，整数で表示されます。

freeManagedCapacityInGB
ストレージ階層内の通常ボリュームおよび仮想ボリュームのうち，空きボリュームの総容量（単位はGB）です。1GB未満は切り捨てて，整数で表示されます。

freeManagedCapacityPercentage
totalManagedCapacityInGBに対するfreeManagedCapacityInGBの割合（%）です。1%未満は切り上げて，整数で表示されます。usedManagedCapacityPercentageが0の場合，freeManagedCapacityPercentageは100となります。

consumedCapacityInGB
ストレージ階層内の通常ボリュームおよび仮想ボリュームの実使用量の総和（単位はGB）です。1GB未満は切り捨てて，整数で表示されます。

[description]
ストレージ階層の説明文です。

cost
通常ボリュームのコストが次の形式で表示されます。
通貨コード 金額 / 容量の単位 / 期間の単位
設定されていない場合は空文字が表示されます。

chargefor
通常ボリュームの課金対象です。

Allocated：ホストに割り当てられたボリューム容量

Utilized：ホストで使用されているボリューム容量

設定されていない場合は空文字が表示されます。

dpcost
{ thpcost }
DPボリュームのコストが次の形式で表示されます。
通貨コード 金額 / 容量の単位 / 期間の単位
設定されていない場合は空文字が表示されます。

dpchargefor
{ thpchargefor }
DPボリュームの課金対象です。

Allocated：ホストに割り当てられたDPボリューム容量

Consumed：消費済みのDPボリューム容量

Utilized：ホストで使用されているDPボリューム容量

設定されていない場合は空文字が表示されます。

（凡例）

{ }：ストレージシステムがVP9500，H24000，またはH20000のときに表示される文字列です。

[ ]：-dまたは--detailオプションの指定があるときだけ出力されます。

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

コマンド指定例：
ストレージドメインMegaTechUSP600-Primaryの中にある2つのストレージ階層MegaTech-HighCostとStorageTier-1の詳細情報を取得します。

htsmcli GetStorageTiers --detail storagedomainname="MegaTechUSP600-Primary" name="MegaTech-HighCost,StorageTier-1"

実行結果：

RESPONSE:
An instance of StorageDomain(1 of 1)
 name=MegaTechUSP600-Primary
 List of 2 StorageTier elements:
   An instance of StorageTier(1 of 2)
     name=MegaTech-HighCost
     filterCondition=RAIDLevel = 'RAID5(3D+1P)' AND Capacity < '1GB'
     numberOfVolumes=91
     totalCapacityInGB=387
     totalCapacityPercentageToStorageDomain=5
     usedCapacityInGB=29
     usedCapacityPercentage=8
     freeCapacityInGB=358
     freeCapacityPercentage=92
     numberOfManagedVolumes=25
     totalManagedCapacityInGB=1,000
     usedManagedCapacityInGB=300
     usedManagedCapacityPercentage=30
     freeManagedCapacityInGB=700
     freeManagedCapacityPercentage=70
     consumedCapacityInGB=500
     description=
     cost=USD3000/TB/Year
     chargefor=Allocated
     dpcost=USD3/GB/Year
     dpchargefor=Consumed
   An instance of StorageTier(2 of 2)
     name=StorageTier-1
     filterCondition=RAIDLevel <> 'RAID5(3D+1P)'
     numberOfVolumes=2
     totalCapacityInGB=9
     totalCapacityPercentageToStorageDomain=1
     usedCapacityInGB=0
     usedCapacityPercentage=0
     freeCapacityInGB=9
     freeCapacityPercentage=100
     numberOfManagedVolumes=25
     totalManagedCapacityInGB=1,000
     usedManagedCapacityInGB=300
     usedManagedCapacityPercentage=30
     freeManagedCapacityInGB=700
     freeManagedCapacityPercentage=70
     consumedCapacityInGB=500
     description=
     cost=USD3000/TB/Year
     chargefor=Allocated
     dpcost=USD3/GB/Year
     dpchargefor=Consumed

5.3.4 ModifyStorageTier

ModifyStorageTierコマンドは，ストレージ階層の情報（ストレージ階層名，検索条件，ストレージ階層の説明文）を変更します。

次の状態であるストレージ階層の情報は変更できません。

終了状態（End）でないタスクに指定されているストレージ階層

リフレッシュの状態が「実行中」または「終了（失敗）」であるストレージドメインの中にあるストレージ階層

タスクの状態はGetTasksコマンドで確認してください。

リフレッシュが必要なストレージドメインに対してコマンドを実行した場合，標準エラー出力に警告メッセージが出力されます。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] ModifyStorageTier
   [ 共通オプション ]
   [ { -d | --detail } ]
   storagedomainname=ストレージドメイン名
   name=ストレージ階層名
   [ newname=ストレージ階層名 ]
   [ { newresource={ Volume | Pool }
       newfiltercondition=検索条件 | newfiltercondition=検索条件 } ]
   [ newdescription=ストレージ階層の説明文 ]
   [ newcost=通常ボリュームのコスト ]
   [ newchargefor={ Allocated | Utilized } ]
   [ { newdpcost | newthpcost }=DPボリュームのコスト ]
   [ { newdpchargefor | newthpchargefor }={ Allocated | Consumed | Utilized } ]

(2) オプション

-dまたは--detail

CLIコマンド実行後に，詳細情報を標準出力に表示したいときに指定します。

省略した場合，標準出力には何も表示されません。

(3) パラメーター

表5-14 ModifyStorageTierコマンドのパラメーター

パラメーター名
説明

storagedomainname
ストレージドメイン名を指定します。

name
ストレージ階層名を指定します。

[newname]
ストレージ階層の新しい名称を指定します。ストレージドメイン内で一意になるように指定してください。
省略時には，ストレージ階層名は変更されません。

[newresource]
ストレージ階層の種別を指定します。指定しない場合は，newfilterconditionパラメーターで指定した条件に従います。

Volume：検索条件としてボリュームを指定

Pool：検索条件としてプールを指定

[newfiltercondition]
検索条件を指定します。
管理する対象によって，次のどちらかのプロパティを使用した検索条件式を指定してください。

ボリュームを管理対象とする場合，「表4-2 ボリューム検索条件式に指定できるプロパティの概要」および「表4-5 ボリューム検索条件式のプロパティに指定できる値の範囲」を参照してください。
ただし，ストレージ階層で管理するボリュームを指定するための検索条件としては，指定できないプロパティもあります。

プールを管理対象とする場合，「表4-3 プール検索条件式に指定できるプロパティの概要」および「表4-6 プール検索条件式のプロパティに指定できる値の範囲」を参照してください。

省略時には，検索条件は変更されません。

[newdescription]
ストレージ階層の説明文を指定します。
省略時には，ストレージ階層の説明文は変更されません。
空文字列を指定すると，以前に設定したストレージ階層の説明文は消去されます。

[newcost]※1
通常ボリュームのコストを次の形式で指定します。
通貨コード 金額 / 容量の単位 / 期間の単位

通貨コード
ISO4217に準拠した通貨コードを大文字のアルファベットで指定します。指定できる値の詳細については，「表5-7 CreateStorageTierコマンドのパラメーター」に記載されているcostパラメーターの通貨コードを参照してください。

金額
0から9,223,372,036,854,775,807までの整数で指定します。コンマやピリオドは使用できません。

容量の単位
MB，GB，またはTBを指定します。

期間の単位
MonthまたはYearを指定します。

ストレージ階層に，容量と期間ごとのコストや課金対象の情報を定義しておくと，コストを意識してストレージを運用できます。提供しているサービスやその課金体系に合わせて，自由にコストを設定してください。
このパラメーターは，ストレージ階層の検索条件がボリューム検索条件の場合に指定できます。
このパラメーターには空文字列を指定できます。空文字列を指定すると，以前に設定した内容が消去されます。
空文字列を指定する場合，newchargeforパラメーターにも空文字列を指定してください。

[newchargefor]※1
通常ボリュームのコストの課金対象を指定します。

Allocated：ホストに割り当てられたボリューム容量

Utilized：ホストで使用されているボリューム容量

このパラメーターには空文字列を指定できます。空文字列を指定すると，以前に設定した内容が消去されます。
空文字列を指定する場合，newcostパラメーターにも空文字列を指定してください。

[newdpcost
{ newthpcost }]※2
DPボリュームのコストを指定します。
指定方法はnewcostパラメーターと同じです。
このパラメーターには空文字列を指定できます。空文字列を指定すると，以前に設定した内容が消去されます。
空文字列を指定する場合，newdpchargefor{ newthpchargefor }パラメーターにも空文字列を指定してください。

[newdpchargefor
{ newthpchargefor }]※2
DPボリュームのコストの課金対象を指定します。

Allocated：ホストに割り当てられたDPボリューム容量

Consumed：消費済みのDPボリューム容量

Utilized：ホストで使用されているDPボリューム容量

このパラメーターには空文字列を指定できます。空文字列を指定すると，以前に設定した内容が消去されます。
空文字列を指定する場合，newdpcost{ newthpcost }パラメーターにも空文字列を指定してください。

（凡例）

[ ]：指定は任意です。

{ }：ストレージシステムがVP9500，H24000，またはH20000のときに使用する文字列です。

注※1

ModifyStorageTierコマンド実行後に，通常ボリュームのコストと課金対象が両方設定されている状態，または両方設定されていない状態になるように組み合わせて指定してください。

注※2

ModifyStorageTierコマンド実行後に，DPボリュームのコストと課金対象が両方設定されている状態，または両方設定されていない状態になるように組み合わせて指定してください。

(4) 出力項目

ModifyStorageTierコマンドの出力項目は，CreateStorageTierコマンドの出力項目と同じです。CreateStorageTierコマンドの「(4) 出力項目」を参照してください。

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

コマンド指定例：
ストレージドメインMegaTechUSP600-Primaryの中にあるストレージ階層OurStorageTierの名称をNewStorageTierに変更します。

htsmcli ModifyStorageTier --detail storagedomainname="MegaTechUSP600-Primary" name="OurStorageTier" newname="NewStorageTier"

実行結果：

RESPONSE:
An instance of StorageDomain(1 of 1)
 name=MegaTechUSP600-Primary
 List of 1 StorageTier elements:
   An instance of StorageTier(1 of 1)
     name=NewStorageTier
     filterCondition=RAIDLevel <> 'RAID5(3D+1P)'
     description=
     cost=USD3000/TB/Year
     chargefor=Allocated
     dpcost=USD3/GB/Year
     dpchargefor=Consumed

5.4 マイグレーショングループを管理するためのコマンド

マイグレーショングループを管理するためのコマンドについて説明します。

この節の構成

5.4.1 CreateMigrationGroup

5.4.2 DeleteMigrationGroup

5.4.3 GetMigrationGroups

5.4.4 ModifyMigrationGroup

5.4.5 AddVolumeToMigrationGroup

5.4.6 RemoveVolumeFromMigrationGroup

5.4.1 CreateMigrationGroup

CreateMigrationGroupコマンドは，ストレージドメイン内にマイグレーショングループを作成します。

作成するマイグレーショングループには，canmigrateパラメーターで，マイグレーション操作の対象とするかどうかを示す属性を指定できます。この属性でマイグレーション不可と指定しておくと，誤操作によってマイグレーショングループに属するボリュームがマイグレーションされることを防げます。

また，マイグレーショングループごとにLDEV選択ルールを設定できます。特定のマイグレーショングループに属しているLDEVがあるパリティグループを，移動先のパリティグループとして選択したくない場合は，共存回避ルール（arraygroupavoidanceofmigrationgroupsパラメーター）を指定します。パリティグループの利用状況を考慮した上で移動先を選択する場合は，分散制御ルール（arraygroupselectionruleパラメーター）を指定します。

ストレージドメインのリフレッシュ状態が「実行中」または「終了（失敗）」である場合，マイグレーショングループを作成できません。

リフレッシュが必要なストレージドメインに対してコマンドを実行した場合，標準エラー出力に警告メッセージが出力されます。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] CreateMigrationGroup
   [ 共通オプション ]
   [ { -d | --detail } ]
   storagedomainname=ストレージドメイン名
   name=マイグレーショングループ名
   [ canmigrate={ Yes | No } ]
   [ notifytourl=イベント通知先アドレス ]
   [ reminddayslater=指定期間経過イベント発生までの日数 ]
   [ reminderdescription=指定期間経過イベント発生時の説明文 ]
   [ arraygroupselectionrule={ BalanceCapacity | MinimumCoverage
                             | MaximumCoverage } ]
   [ arraygroupavoidanceofmigrationgroups=マイグレーショングループ名 [ ,マイグレーショングループ名 ]... ]
   [ description=マイグレーショングループの説明文 ]

(2) オプション

-dまたは--detail

CLIコマンド実行後に，詳細情報を標準出力に表示したいときに指定します。

省略した場合，標準出力には何も表示されません。

(3) パラメーター

表5-15 CreateMigrationGroupコマンドのパラメーター

パラメーター名
説明

storagedomainname
ストレージドメイン名を指定します。

name
作成するマイグレーショングループの名称を指定します。ストレージドメイン内で一意になるように指定してください。

[canmigrate]
マイグレーションを可能にするかどうかを指定します。

Yes：マイグレーション可能（デフォルト）

No：マイグレーション不可

[notifytourl]
イベント発生時に，イベントを通知する先のアドレスです。
"mailto:"とメールアドレス文字列を合わせた値で指定します。

[reminddayslater]
指定期間経過イベントを発生させるまでの日数を1以上の整数で指定します。
1から21,900までの整数値を指定できます。

[reminderdescription]
指定期間経過イベント発生時の説明文です。

[arraygroupselectionrule]
マイグレーションプランを作成するときに使用される，分散制御ルールのパラメーターを指定します。

BalanceCapacity：容量平準化（デフォルト）

MinimumCoverage：分散最小化

MaximumCoverage：分散最大化

[arraygroupavoidanceofmigrationgroups]
マイグレーションプランを作成するときに使用される，共存回避ルールのパラメーターを指定します。同じパリティグループ内にLDEVを共存させたくないマイグレーショングループ名を指定できます。空文字列を指定すると，以前指定したマイグレーショングループ名は削除されます。省略時には，共存回避ルールは適用されません。

[description]
マイグレーショングループの説明文を指定します。

（凡例）

[ ]：指定は任意です。

(4) 出力項目

表5-16 CreateMigrationGroupコマンドの出力項目（StorageDomainインスタンス）

項目名 | 説明
name | ストレージドメイン名です。

表5-17 CreateMigrationGroupコマンドの出力項目（MigrationGroupインスタンス）

項目名 | 説明
name | マイグレーショングループ名です。
canMigrate | マイグレーションが可能かどうかを示します。
notifyToURL | イベント通知先のアドレスです。
remindAt | 指定期間経過イベントが発生する日時です。
reminderDescription | 指定期間経過イベント発生時の説明文です。
arrayGroupSelectionRule | 分散制御ルールです。
arrayGroupAvoidanceOfMigrationGroups | 共存回避ルールです。共存回避ルールが設定されていない場合は空文字が表示されます。
description | マイグレーショングループの説明文です。

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

コマンド指定例- 1：
ストレージドメインMegaTechUSP600-Primaryの中に，マイグレーショングループMG01を作成します。

htsmcli CreateMigrationGroup --detail storagedomainname="MegaTechUSP600-Primary" name="MG01" description="MigrationGroup01" arraygroupavoidanceofmigrationgroups="MG012,MG013"

実行結果- 1：

RESPONSE:
An instance of StorageDomain(1 of 1)
 name=MegaTechUSP600-Primary
 List of 1 MigrationGroup elements:
   An instance of MigrationGroup(1 of 1)
     name=MG01
     canMigrate=Yes
     notifyToURL=
     remindAt=
     reminderDescription=
     arrayGroupSelectionRule=BalanceCapacity
     arrayGroupAvoidanceOfMigrationGroups=MG012,MG013
     description=MigrationGroup01

コマンド指定例- 2：
ストレージドメインMegaTechUSP600-Primary内にマイグレーショングループMG01を作成し，20日後に指定期間経過イベントを発生させます。

htsmcli CreateMigrationGroup --detail storagedomainname="MegaTechUSP600-Primary" name="MG01" reminddayslater="20" notifytourl="mailto:test@example.com" reminderdescription="It is scheduled to move." description="MigrationGroup01" arraygroupselectionrule=MinimumCoverage arraygroupavoidanceofmigrationgroups="MG012,MG013"

実行結果- 2：

RESPONSE:
An instance of StorageDomain(1 of 1)
 name=MegaTechUSP600-Primary
 List of 1 MigrationGroup elements:
   An instance of MigrationGroup(1 of 1)
     name=MG01
     canMigrate=Yes
     notifyToURL=mailto:test@example.com
     remindAt=2014/01/22 19:40:05
     reminderDescription=It is scheduled to move.
     arrayGroupSelectionRule=MinimumCoverage
     arrayGroupAvoidanceOfMigrationGroups=MG012,MG013
     description=MigrationGroup01

5.4.2 DeleteMigrationGroup

DeleteMigrationGroupコマンドは，マイグレーショングループを削除します。マイグレーショングループ内のボリューム有無に関わらず削除できます。

次の状態のマイグレーショングループは削除できません。

終了状態（End）でないタスクに指定されているマイグレーショングループ

リフレッシュの状態が「実行中」または「終了（失敗）」であるストレージドメインの中のマイグレーショングループ

終了状態（End）でないシュレッディングタスクが完了したあとの移動先に指定されているマイグレーショングループ

終了状態（End）でないロッキングタスクが完了したあとの移動先に指定されているマイグレーショングループ

終了状態（End）でないアンロッキングタスクが完了したあとの移動先に指定されているマイグレーショングループ

タスクの状態はGetTasksコマンドで確認してください。

リフレッシュが必要なストレージドメインに対してコマンドを実行した場合，標準エラー出力に警告メッセージが出力されます。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] DeleteMigrationGroup
   [ 共通オプション ]
   [ { -d | --detail } ]
   storagedomainname=ストレージドメイン名
   name=マイグレーショングループ名

(2) オプション

-dまたは--detail

CLIコマンド実行後に，詳細情報を標準出力に表示したいときに指定します。

省略した場合，標準出力には何も表示されません。

(3) パラメーター

表5-18 DeleteMigrationGroupコマンドのパラメーター

パラメーター名 | 説明
storagedomainname | ストレージドメイン名を指定します。
name | 削除するマイグレーショングループの名称を指定します。

(4) 出力項目

DeleteMigrationGroupコマンドの出力項目は，CreateMigrationGroupコマンドの出力項目と同じです。CreateMigrationGroupコマンドの「(4) 出力項目」を参照してください。

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

コマンド指定例：
ストレージドメインMegaTechUSP600-PrimaryからマイグレーショングループMG01を削除します。

htsmcli DeleteMigrationGroup --detail storagedomainname="MegaTechUSP600-Primary" name="MG01"

実行結果：

RESPONSE:
An instance of StorageDomain(1 of 1)
 name=MegaTechUSP600-Primary
 List of 1 MigrationGroup elements:
   An instance of MigrationGroup(1 of 1)
     name=MG01
     canMigrate=Yes
     notifyToURL=
     remindAt=
     reminderDescription=
     arrayGroupSelectionRule=MinimumCoverage
     arrayGroupAvoidanceOfMigrationGroups=MG012,MG013
     description=MigrationGroup01

5.4.3 GetMigrationGroups

GetMigrationGroupsコマンドは，ストレージドメイン内にあるすべてのマイグレーショングループの情報，またはnameパラメーターで指定したマイグレーショングループの情報を取得します。

ストレージドメインのリフレッシュ状態が「実行中」または「終了（失敗）」である場合，マイグレーショングループの情報を取得できません。

リフレッシュが必要なストレージドメインに対してコマンドを実行した場合，標準エラー出力に警告メッセージが出力されます。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] GetMigrationGroups
   [ 共通オプション ]
   [ { -d | --detail } ]
   storagedomainname=ストレージドメイン名
   [ name=マイグレーショングループ名 [ ,マイグレーショングループ名 ]... ]

(2) オプション

-dまたは--detail

CLIコマンド実行後に，詳細情報を標準出力に表示したいときに指定します。

省略した場合，サマリー情報だけが表示されます。

(3) パラメーター

表5-19 GetMigrationGroupsコマンドのパラメーター

パラメーター名
説明

storagedomainname
ストレージドメイン名を指定します。

[name]
情報を取得したいマイグレーショングループの名称を指定します。
指定を省略すると，ストレージドメイン内のすべてのマイグレーショングループが対象になります。
複数のマイグレーショングループ名を指定する場合は，マイグレーショングループ名をコンマで区切ってください。
マイグレーショングループ名は255個まで指定できます。ただし，コマンドラインの文字数の上限に依存します。

（凡例）

[ ]：指定は任意です。

(4) 出力項目

表5-20 GetMigrationGroupsコマンドの出力項目（StorageDomainインスタンス）

項目名 | 説明
name | ストレージドメイン名です。

表5-21 GetMigrationGroupsコマンドの出力項目（MigrationGroupインスタンス）

項目名
説明

name
マイグレーショングループ名です。

targetStorageTierName
最後にマイグレーション先として指定したストレージ階層名です。以前にマイグレーションタスクを作成していない場合は空文字が表示されます。

canMigrate
マイグレーションが可能かどうかを示します。

[notifyToURL]
イベント通知先のアドレスです。

remindAt
指定期間経過イベントが発生する日時です。

[reminderDescription]
指定期間経過イベント発生時の説明文です。

[lastModifyUserGroup]
マイグレーショングループを作成または変更したユーザーのユーザーグループ名です。

[creationTime]
マイグレーショングループの作成日時です。

[lastModifyTime]
マイグレーショングループの情報を変更した日時です。

lastMigrationTime
targetStorageTierNameで示されるストレージ階層にマイグレーションが完了した日時です。以前にマイグレーションが完了していない場合や新しいマイグレーションタスクを作成した場合は空文字が表示されます。

migrationStatus
マイグレーションタスクの状態です。
以前にマイグレーションを実行していない場合は空文字が表示されます。
表示される値の詳細については，「5.8 タスクの状態」を参照してください。

taskType
タスクの種類です。
以前にタスクを作成していない場合は空文字が表示されます。

Migration：マイグレーションタスク

Locking：ロッキングタスク

Unlocking：アンロッキングタスク

Shredding：シュレッディングタスク

taskStatus
taskTypeで表示されるタスクの状態です。
以前にタスクを作成していない場合は空文字が表示されます。
表示される値の詳細については，「5.8 タスクの状態」を参照してください。

numberOfVolumes
マイグレーショングループ内の実ボリュームの数です。

totalCapacityInGB
マイグレーショングループ内の実ボリュームの総容量（単位はGB）です。1GB未満は切り捨てて，整数で表示されます。

numberOfManagedVolumes
マイグレーショングループ内の通常ボリュームおよび仮想ボリュームの数です。

totalManagedCapacityInGB
マイグレーショングループ内の通常ボリュームおよび仮想ボリュームの総容量（単位はGB）です。1GB未満は切り捨てて，整数で表示されます。

consumedCapacityInGB
マイグレーショングループ内の通常ボリュームおよび仮想ボリュームの実使用量の総和（単位はGB）です。1GB未満は切り捨てて，整数で表示されます。

[arrayGroupSelectionRule]
分散制御ルールです。

[arrayGroupAvoidanceOfMigrationGroups]
共存回避ルールです。共存回避ルールが設定されていない場合は空文字が表示されます。

[description]
マイグレーショングループの説明文です。

（凡例）

[ ]：-dまたは--detailオプションの指定があるときだけ出力されます。

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

コマンド指定例：
ストレージドメインMegaTechUSP600-Primaryの中にあるすべてのマイグレーショングループの詳細情報を取得します。

htsmcli GetMigrationGroups --detail storagedomainname="MegaTechUSP600-Primary"

実行結果：

RESPONSE:
An instance of StorageDomain(1 of 1)
 name=MegaTechUSP600-Primary
 List of 2 MigrationGroup elements:
   An instance of MigrationGroup(1 of 2)
     name=MG01
     targetStorageTierName=
     canMigrate=Yes
     notifyToURL=
     remindAt=
     reminderDescription=
     lastModifyUserGroup=Admin
     creationTime=2014/01/02 11:57:23
     lastModifyTime=2014/01/03 12:05:59
     lastMigrationTime=
     migrationStatus=
     taskType=
     taskStatus=
     numberOfVolumes=0
     totalCapacityInGB=0
     numberOfManagedVolumes=25
     totalManagedCapacityInGB=1,000
     consumedCapacityInGB=300
     arrayGroupSelectionRule=MinimumCoverage
     arrayGroupAvoidanceOfMigrationGroups=MG012,MG013
     description=MigrationGroup01
   An instance of MigrationGroup(2 of 2)
     name=MyGroup
     targetStorageTierName=
     canMigrate=Yes
     notifyToURL=mailto:test@example.com
     remindAt=2014/01/22 19:40:05
     reminderDescription=It is scheduled to move.
     lastModifyUserGroup=Admin
     creationTime=2014/01/02 12:06:41
     lastModifyTime=2014/01/03 12:06:41
     lastMigrationTime=
     migrationStatus=
     taskType=
     taskStatus=
     numberOfVolumes=0
     totalCapacityInGB=0
     numberOfManagedVolumes=25
     totalManagedCapacityInGB=1,000
     consumedCapacityInGB=300
     arrayGroupSelectionRule=BalanceCapacity
     arrayGroupAvoidanceOfMigrationGroups=
     description=MyMigrationGroup

5.4.4 ModifyMigrationGroup

ModifyMigrationGroupコマンドは，マイグレーショングループの情報を変更します。変更できる情報を次に示します。

マイグレーショングループ名

マイグレーション操作の対象とするかどうかを示す属性

マイグレーショングループの説明文

指定期間経過イベントを発生させるまでの日数

イベント通知先アドレス

分散制御ルール

共存回避ルール

指定期間経過イベント発生時の説明文

次の状態のマイグレーショングループでは，情報を変更できません。

終了状態（End）でないタスクに指定されているマイグレーショングループ

リフレッシュの状態が「実行中」または「終了（失敗）」であるストレージドメインの中のマイグレーショングループ

終了状態（End）でないシュレッディングタスク，ロッキングタスクまたはアンロッキングタスクが完了したあとの移動先に指定されているマイグレーショングループ

タスクの状態はGetTasksコマンドで確認してください。

リフレッシュが必要なストレージドメインに対してコマンドを実行した場合，標準エラー出力に警告メッセージが出力されます。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] ModifyMigrationGroup
   [ 共通オプション ]
   [ { -d | --detail } ]
   storagedomainname=ストレージドメイン名
   name=マイグレーショングループ名
   [ newname=マイグレーショングループ名 ]
   [ newcanmigrate={ Yes | No } ]
   [ newnotifytourl=イベント通知先アドレス ]
   [ newreminddayslater=指定期間経過イベント発生までの日数 ]
   [ newreminderdescription=イベント発生時の説明文 ]
   [ newarraygroupselectionrule={ BalanceCapacity | MinimumCoverage
                                | MaximumCoverage } ]
   [ newarraygroupavoidanceofmigrationgroups=マイグレーショングループ名 [ ,マイグレーショングループ名 ]... ]
   [ newdescription=マイグレーショングループの説明文 ]

(2) オプション

-dまたは--detail

CLIコマンド実行後に，詳細情報を標準出力に表示したいときに指定します。

省略した場合，標準出力には何も表示されません。

(3) パラメーター

表5-22 ModifyMigrationGroupコマンドのパラメーター

パラメーター名
説明

storagedomainname
ストレージドメイン名を指定します。

name
マイグレーショングループ名を指定します。

[newname]
新しいマイグレーショングループ名を指定します。ストレージドメイン内で一意になるように指定してください。省略時には，マイグレーショングループ名は変更されません。

[newcanmigrate]
マイグレーションを可能にするかどうかを指定します。

Yes：マイグレーション可能

No：マイグレーション不可

省略時にはマイグレーションの可否は変更されません。

[newreminddayslater]
指定期間経過イベントを発生させるまでの日数を1以上の整数で指定します。省略時には，指定期間経過イベントを発生させるまでの日数は変更されません。空文字列を指定すると，以前に指定した指定期間経過イベントを発生させるまでの日数は消去されます。

[newnotifytourl]
指定期間経過イベント発生時に，イベントを通知する先のアドレスを指定します。省略時には，イベント通知先のアドレスは変更されません。
アドレスは，"mailto:"とメールアドレス文字列を合わせた値で指定します。
空文字列を指定すると，以前に設定したイベント通知先のアドレスは消去されます。

[newreminderdescription]
指定期間経過イベント発生時の説明文です。省略時には，指定期間経過イベント発生時の説明文は変更されません。空文字列を指定すると，以前に設定した指定期間経過イベント発生時の説明文は消去されます。

[newarraygroupselectionrule]
CreateMigrationGroupで設定した，分散制御ルールのパラメーターを変更するときに指定します。

BalanceCapacity：容量平準化

MinimumCoverage：分散最小化

MaximumCoverage：分散最大化

省略時には，マイグレーションプランを作成するときに使用される分散制御ルールは変更されません。

[newarraygroupavoidanceofmigrationgroups]
CreateMigrationGroupで設定した，共存回避ルールのパラメーターを変更するときに指定します。同じパリティグループ内にLDEVを共存させたくないマイグレーショングループ名を指定できます。空文字列を指定すると，以前指定したマイグレーショングループ名は削除されます。省略時には，共存回避ルールは適用されません。

[newdescription]
マイグレーショングループの説明文を指定します。
省略時には，マイグレーショングループの説明文は変更されません。
空文字列を指定すると，以前に設定したマイグレーショングループの説明文は消去されます。

（凡例）

[ ]：指定は任意です。

(4) 出力項目

ModifyMigrationGroupコマンドの出力項目は，CreateMigrationGroupコマンドの出力項目と同じです。CreateMigrationGroupコマンドの「(4) 出力項目」を参照してください。

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

コマンド指定例：
ストレージドメインMegaTechUSP600-Primaryの中にあるマイグレーショングループMG01の名称，説明，および指定期間経過イベントを発生させるまでの日数を変更します。

htsmcli ModifyMigrationGroup --detail storagedomainname="MegaTechUSP600-Primary" name="MG01" newname="MG011" newreminddayslater="25" newdescription="MigrationGroup011"

実行結果：

RESPONSE:
An instance of StorageDomain(1 of 1)
 name=MegaTechUSP600-Primary
 List of 1 MigrationGroup elements:
   An instance of MigrationGroup(1 of 1)
     name=MG011
     canMigrate=Yes
     notifyToURL=mailto:test@example.com
     remindAt=2014/01/28 19:40:05
     reminderDescription=It is scheduled to move.
     arrayGroupSelectionRule=BalanceCapacity
     arrayGroupAvoidanceOfMigrationGroups=MG012,MG013
     description=MigrationGroup011

5.4.5 AddVolumeToMigrationGroup

AddVolumeToMigrationGroupコマンドは，指定したボリュームをマイグレーショングループに加えます。ボリュームは，ドメインコントローラーでのLDEVのデバイス番号（コントローラー論理デバイス番号）で指定します。

次の状態のマイグレーショングループには，ボリュームを加えることはできません。

終了状態（End）でないタスクに指定されているマイグレーショングループ

リフレッシュの状態が「実行中」または「終了（失敗）」であるストレージドメインの中のマイグレーショングループ

タスクの状態はGetTasksコマンドで確認してください。

リフレッシュが必要なストレージドメインに対してコマンドを実行した場合，標準エラー出力に警告メッセージが出力されます。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] AddVolumeToMigrationGroup
   [ 共通オプション ]
   [ { -d | --detail } ]
   storagedomainname=ストレージドメイン名
   name=マイグレーショングループ名
   controllerdevicenumber=コントローラー論理デバイス番号
   [ movefrommigrationgroup={ Yes | No } ]

(2) オプション

-dまたは--detail

CLIコマンド実行後に，詳細情報を標準出力に表示したいときに指定します。

省略した場合，標準出力には何も表示されません。

(3) パラメーター

表5-23 AddVolumeToMigrationGroupコマンドのパラメーター

パラメーター名
説明

storagedomainname
ストレージドメイン名を指定します。

name
マイグレーショングループ名を指定します。

controllerdevicenumber
コントローラー論理デバイス番号を，次の形式で指定します。
[論理DKC番号:]CU番号:LDEV番号
0x100未満の16進数を" : "（コロン）で区切って指定してください。最上位に指定する値にかぎり，前ゼロを省略できます。
次に指定例を示します。

論理DKC番号を省略する場合："2:0a"または"02:0A"

論理DKC番号を指定する場合："0:02:0a"または"00:02:0A"

[movefrommigrationgroup]
ほかのマイグレーショングループのボリュームを移動することを許可するかどうかを指定します。

Yes：ほかのマイグレーショングループのボリュームを移動することを許可します。

No：ほかのマイグレーショングループのボリュームを移動することを許可しません（デフォルト）。

（凡例）

[ ]：指定は任意です。

(4) 出力項目

重要

一部の出力項目では，次のどれかに該当する場合に"Unknown"が表示されます。

Device Managerを使用してストレージシステムの中のボリュームが削除されるなど，ストレージドメイン内のボリュームの情報を取得できない状態になった場合

外部接続されたストレージの情報を取得できない状態になった場合

外部接続されたストレージがSMI-S enabledストレージシステムの場合

表5-24 AddVolumeToMigrationGroupコマンドの出力項目（StorageDomainインスタンス）

項目名 | 説明
name | ストレージドメイン名です。

表5-25 AddVolumeToMigrationGroupコマンドの出力項目（MigrationGroupインスタンス）

項目名 | 説明
name | マイグレーショングループ名です。
canMigrate | マイグレーションが可能かどうかを示します。
notifyToURL | イベント通知先のアドレスです。
remindAt | 指定期間経過イベントが発生する日時です。
reminderDescription | 指定期間経過イベント発生時の説明文です。
arrayGroupSelectionRule | 分散制御ルールです。
arrayGroupAvoidanceOfMigrationGroups | 共存回避ルールです。共存回避ルールが設定されていない場合は空文字が表示されます。
description | マイグレーショングループの説明文です。

表5-26 AddVolumeToMigrationGroupコマンドの出力項目（Volumeインスタンス）

項目名
説明

controllerDeviceNumber
コントローラー論理デバイス番号です。
16進数と" : "（コロン）を組み合わせた値で表示されます。

emulationType
エミュレーションタイプです。

CVS
ボリュームがCVS属性かどうかを示します。

Yes：CVS属性です。

No：CVS属性ではありません。

capacityInKB
ボリュームの容量（単位はKB）です。

RAIDLevel
RAIDレベルです。

diskType
ドライブ種別です。

controllerArrayGroupName
ドメインコントローラーのLUのパリティグループ名です。

arrayGroupName
実際のデータを格納しているストレージシステムのLUのパリティグループ名です。

volumeStatus
ボリュームが使用中かどうかを示します。

Used：使用中です（マイグレーション先に使用できません）。

Free：未使用です（マイグレーション先に使用できます）。

volumeLockStatus
ボリュームがロックされているかどうかを示します。

Locked：ロックされています（マイグレーション先に使用できません）。

Unlocked：ロックされていません（マイグレーション先に使用できます）。

hostNames
ホスト名です。複数ある場合，コンマで区切って表示されます。

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

コマンド指定例：
ストレージドメインMegaTechUSP600-Primaryの中にあるマイグレーショングループMG011に，ボリュームを1つ追加します。追加するボリュームのコントローラー論理デバイス番号は3:A6とします。

htsmcli AddVolumeToMigrationGroup --detail storagedomainname="MegaTechUSP600-Primary" name="MG011" controllerdevicenumber="3:A6" movefrommigrationgroup=Yes

実行結果：

RESPONSE:
An instance of StorageDomain(1 of 1)
 name=MegaTechUSP600-Primary
 List of 1 MigrationGroup elements:
   An instance of MigrationGroup(1 of 1)
     name=MG011
     canMigrate=Yes
     notifyToURL=
     remindAt=
     reminderDescription=
     arrayGroupSelectionRule=MinimumCoverage
     arrayGroupAvoidanceOfMigrationGroups=MG012,MG013
     description=MigrationGroup011
     List of 1 Volume elements:
       An instance of Volume(1 of 1)
         controllerDeviceNumber=3:A6
         emulationType=OPEN-V
         CVS=Yes
         capacityInKB=10,240,320
         RAIDLevel=RAID5(3D+1P)
         diskType=Unknown
         controllerArrayGroupName=E9980-1
         arrayGroupName=1-9-1
         volumeStatus=Used
         volumeLockStatus=Unlocked
         hostNames=

5.4.6 RemoveVolumeFromMigrationGroup

RemoveVolumeFromMigrationGroupコマンドは，指定したボリュームをマイグレーショングループから取り除きます。ボリュームは，ドメインコントローラーでのLDEVのデバイス番号（コントローラー論理デバイス番号）で指定します。

次の状態のマイグレーショングループからは，ボリュームを取り除くことはできません。

終了状態（End）でないタスクに指定されているマイグレーショングループ

リフレッシュの状態が「実行中」または「終了（失敗）」であるストレージドメインの中のマイグレーショングループ

タスクの状態はGetTasksコマンドで確認してください。

リフレッシュが必要なストレージドメインに対してコマンドを実行した場合，標準エラー出力に警告メッセージが出力されます。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] RemoveVolumeFromMigrationGroup
   [ 共通オプション ]
   [ { -d | --detail } ]
   storagedomainname=ストレージドメイン名
   name=マイグレーショングループ名
   controllerdevicenumber=コントローラー論理デバイス番号

(2) オプション

-dまたは--detail

CLIコマンド実行後に，詳細情報を標準出力に表示したいときに指定します。

省略した場合，標準出力には何も表示されません。

(3) パラメーター

表5-27 RemoveVolumeFromMigrationGroupコマンドのパラメーター

パラメーター名
説明

storagedomainname
ストレージドメイン名を指定します。

name
マイグレーショングループ名を指定します。

controllerdevicenumber
コントローラー論理デバイス番号を，次の形式で指定します。
[論理DKC番号:]CU番号:LDEV番号
0x100未満の16進数を" : "（コロン）で区切って指定してください。最上位に指定する値にかぎり，前ゼロを省略できます。
次に指定例を示します。

論理DKC番号を省略する場合："2:0a"または"02:0A"

論理DKC番号を指定する場合："0:02:0a"または"00:02:0A"

(4) 出力項目

RemoveVolumeFromMigrationGroupコマンドの出力項目は，AddVolumeToMigrationGroupコマンドの出力項目と同じです。AddVolumeToMigrationGroupコマンドの「(4) 出力項目」を参照してください。

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

コマンド指定例：
ストレージドメインMegaTechUSP600-Primary内のマイグレーショングループMG011からボリュームを削除します。削除するボリュームのコントローラー論理デバイス番号は3:A7とします。

htsmcli RemoveVolumeFromMigrationGroup --detail storagedomainname="MegaTechUSP600-Primary" name="MG011" controllerdevicenumber="3:A7"

実行結果：

RESPONSE:
An instance of StorageDomain(1 of 1)
 name=MegaTechUSP600-Primary
 List of 1 MigrationGroup elements:
   An instance of MigrationGroup(1 of 1)
     name=MG011
     canMigrate=Yes
     notifyToURL=
     remindAt=
     reminderDescription=
     arrayGroupSelectionRule=MinimumCoverage
     arrayGroupAvoidanceOfMigrationGroups=MG012,MG013
     description=MigrationGroup011
     List of 1 Volume elements:
       An instance of Volume(1 of 1)
         controllerDeviceNumber=3:A7
         emulationType=OPEN-V
         CVS=Yes
         capacityInKB=10,240,320
         RAIDLevel=RAID5(3D+1P)
         diskType=Unknown
         controllerArrayGroupName=E9980-1
         arrayGroupName=1-9-1
         volumeStatus=Used
         volumeLockStatus=Unlocked
         hostNames=

5.5 タスクを作成するためのコマンド

タスクを作成するためのコマンドについて説明します。

この節の構成

5.5.1 CreateMigrationPlan

5.5.2 タスクの作成と実行

5.5.3 CreateMigrationTask

5.5.4 CreateLockingTask

5.5.5 CreateUnlockingTask

5.5.6 CreateShreddingTask

5.5.1 CreateMigrationPlan

移動元のLDEVと移動先のLDEVを1対1に対応づける作業には時間が掛かります。CreateMigrationPlanコマンドを使うと，移動元のLDEVに適したLDEVを，Tiered Storage Managerが自動的に選択します。移動元のLDEVと移動先のLDEVの組み合わせは，テキストデータの形で標準出力，または--outputオプションで指定したリダイレクトファイルに作成されます。CreateMigrationPlanコマンドで作成するこのテキストファイルを，「候補マイグレーションプラン」といいます。

マイグレーショングループの各ボリュームに対する移動先ボリュームの候補は，指定した移動先ストレージ階層から選ばれます。filterconditionパラメーターでボリュームの検索条件を指定すると，その条件に合う移動先ボリュームの候補が選ばれます。

移動先ボリュームの候補は，移動元ボリュームが属するSLPRの中から選ばれます。選ばれた移動先ボリュームの候補は，移動元ボリュームと対にして，候補マイグレーションプランに表示されます。

候補マイグレーションプランには，コメント行（第1カラムが#で始まる行）が生成され，移動先ボリュームの候補になるボリュームが複数個ある場合には，それらの候補もすべて表示されます。なお，第1候補以外のボリュームには，移動元ボリュームが属するSLPRだけでなく，そのほかのSLPRからも選ばれます。

すべての移動元ボリュームに対する移動先ボリュームの候補が選択できなくても，選択できた分だけを記述した候補マイグレーションプランが作成されます。その場合には，コマンドはエラー終了します。

マイグレーショングループにマイグレーション不可ボリュームが含まれている場合は，マイグレーション可能なボリュームだけがマイグレーションされます。ただし，マイグレーションできるボリュームが1つもない場合は，マイグレーションプランを作成したときにエラーになります。

マイグレーション不可ボリュームは，候補マイグレーションプラン内で，移動先ボリュームに移動元ボリューム自身が選択されます。

このコマンドによって，移動元ボリュームおよび移動先ボリュームへマイグレーションボリュームは予約されません。

終了状態（End）でないタスクに指定されているボリュームは，移動先ボリュームとして選択されません。そのボリュームへマイグレーションボリュームが予約されているためです。タスクの状態はGetTasksコマンドで確認してください。

リフレッシュの状態が「実行中」，「終了（失敗）」，または「要リフレッシュ」であるストレージドメインに対しては，候補マイグレーションプランを作成できません。

コメント行を含む候補マイグレーションプランの詳細は，「(3) 出力項目」を参照してください。

作成された候補マイグレーションプランの編集

作成された候補マイグレーションプランはそのままマイグレーションに使用できますが，テキストデータを編集して内容を変更することもできます。候補マイグレーションプランの記述形式は，次のとおりです。

各項目は，それぞれ，項目名，等号（=），値の順で記述してください。ただし，pairは項目名だけを記述してください。

項目名，等号（=），値の両端の空白文字は無視されます。

1行に1項目を記述してください。行の継続はできません。

項目名では，大文字と小文字は区別されません（例: storagedomainnameとSTORAGEDOMAINNAMEは同じ項目です）。

項目の値では，大文字と小文字は区別されます（例: groupName_1とGroupName_1は別の値です）。

最初の非空白文字がシャープ（#）である行はコメント行と見なされます。

各項目は次の順に記述してください。

表5-28 マイグレーションプランの項目

情報のレベル
項目名
説明

プラン全体の情報※1
plan-type
プラン種別です。

format-version
プランの書式バージョンです。異なる書式バージョンでの互換性のために指定します。

storageDomainName
ストレージドメイン名です。

migrationGroupName
マイグレーショングループ名です。

targetStorageTierName
移動先ストレージ階層名です。

permitCrossSLPRMigration
SLPR間のマイグレーションを許すかどうかを指定します。

Yes：SLPR間のマイグレーションを許す。

No：SLPR間のマイグレーションを許さない。

permitCrossCLPRMigration
CLPR間のマイグレーションを許すかどうかを指定します。

Yes：CLPR間のマイグレーションを許す。

No：CLPR間のマイグレーションを許さない。

マイグレーション対象ボリュームの対ごとの情報※2
pair
移動元ボリュームと移動先ボリュームの対の記述の始まりを示す区切り記号です。

sourceControllerDeviceNumber
移動元ボリュームです。※3

コントローラー論理デバイス番号を指定してください。

指定するマイグレーショングループに所属しているボリュームを指定してください。

targetControllerDeviceNumber ※4
移動先ボリュームです。※3

コントローラー論理デバイス番号を指定してください。

指定するストレージ階層に所属しているボリュームを指定してください。

移動先にプール検索条件を使用して作成したストレージ階層を指定する場合は，空文字列を指定してください。

sourceControllerDeviceNumberのボリュームをマイグレーションしないようにする場合は，"NotMigrate"を指定してください。

targetPoolId ※4
移動先DPプール番号です。指定は任意です。
DPボリュームを作成してマイグレーションする場合に，移動先プール番号を次の形式で指定してください。
DP x{ THP x }またはDPx{ THPx } （xは0～127）

（凡例）

{ }：ストレージシステムがVP9500，H24000，またはH20000のときに使用する文字列です。

注※1

各項目は，候補マイグレーションプランの最初に一度だけ記述してください。

注※2

指定するマイグレーショングループに所属するすべての移動元ボリューム分を記述してください。

注※3

移動元ボリュームまたは移動先ボリュームは，異なる組み合わせに重複して指定できません。

注※4

プール検索条件を使用して作成したストレージ階層を指定していて，かつsourceControllerDeviceNumberのボリュームをマイグレーションしないようにする場合は，targetControllerDeviceNumberに"NotMigrate"を指定し，targetPoolIdの行を削除してください。

この項の構成

(1) 記述形式

(2) パラメーター

(3) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] CreateMigrationPlan
   [ 共通オプション ]
   storagedomainname=ストレージドメイン名
   migrationgroupname=マイグレーショングループ名
   targetstoragetiername=ストレージ階層名
   [ filtercondition=検索条件 ]

(2) パラメーター

表5-29 CreateMigrationPlanコマンドのパラメーター

パラメーター名
説明

storagedomainname
ストレージドメイン名を指定します。

migrationgroupname
マイグレーショングループ名を指定します。

targetstoragetiername
マイグレーション先のストレージ階層名（移動先ストレージ階層名）を指定します。
プール検索条件を使用して作成したストレージ階層を指定して，移動先ストレージ階層をDPプールとする場合に満たさなければならない条件については，「A.3.2 DPプールを対象としたマイグレーションの条件」を参照してください。

[filtercondition]
ボリュームの検索条件を指定します。
指定できるプロパティについては，「表4-2 ボリューム検索条件式に指定できるプロパティの概要」および「表4-5 ボリューム検索条件式のプロパティに指定できる値の範囲」を参照してください。
省略時は，検索条件による絞り込みはされません。
パラメーターtargetstoragetiernameにプール検索条件を使用して作成したストレージ階層を指定した場合，filterconditionを指定することはできません。

（凡例）

[ ]：指定は任意です。

(3) 出力項目

表5-30 CreateMigrationPlanコマンドの出力項目（プラン全体の情報）

項目名
説明

plan-type
プラン種別

format-version
プランの書式バージョン
異なる書式バージョンでの互換性のために表示される情報です。

storageDomainName
ストレージドメイン名

migrationGroupName
マイグレーショングループ名

targetStorageTierName
移動先ストレージ階層名

permitCrossSLPRMigration
SLPR間のマイグレーションを許すかどうかが表示されます。

Yes：SLPR間のマイグレーションを許す。

No：SLPR間のマイグレーションを許さない。

候補マイグレーションプランがCreateMigrationPlanコマンドで作成されたときには，"No"が表示されます。

permitCrossCLPRMigration
CLPR間のマイグレーションを許すかどうかが表示されます。

Yes：CLPR間のマイグレーションを許す。

No：CLPR間のマイグレーションを許さない。

候補マイグレーションプランがCreateMigrationPlanコマンドで作成されたときには，"Yes"が表示されます。Noと設定しても，Yesと設定した場合と同様に実行されます。

[ arrayGroupSelectionRule ]
LDEV選択ルールのうち，分散制御ルールの情報が表示されます。

[ arrayGroupAvoidanceOfMigrationGroups ]
LDEV選択ルールのうち，共存回避ルールの情報が表示されます。

（凡例）

[ ]：コメント行を示します。

次に示す「表5-31 CreateMigrationPlanコマンドの出力項目（マイグレーションプロファイル情報）」の出力項目は，コメント行として，# Begin Profile Informationの行と# End Profile Informationの行の間に表示されます。

表5-31 CreateMigrationPlanコマンドの出力項目（マイグレーションプロファイル情報）

項目名
説明

configuration
エミュレーションタイプ，容量※1，CVS属性※2（configuration）を基にボリュームをグルーピングした値
コンマ＋半角空白文字で区切って表示されます。

numberOfNeededVolumes
ストレージ階層内で，configurationでグルーピングされたボリュームのうち，マイグレーションタスクの実行に必要なボリューム数

numberOfAvailableVolumes
ストレージ階層内で，configurationでグルーピングされたボリュームのうち，マイグレーションタスクの実行に利用できるボリューム数
括弧で括られた数字は，移動元ボリュームと同じ容量のボリューム数を示します。

numberOfDifference
numberOfAvailableVolumesからnumberOfNeededVolumesを引いた数
括弧で括られた数字は，numberOfAvailableVolumesで括弧内に表示された数からnumberOfNeededVolumesのボリューム数を引いた数です。

注※1

TB，GB，MB，またはKBの値に加えて，括弧付きでKBの値が表示されます。TBまたはGBの場合は，小数点以下2桁，MBまたはKBの場合は，すべて整数で値が表示されます。

注※2

エミュレーションタイプがOPEN-Vの場合は，CVS属性は表示されません。エミュレーションタイプがOPEN-V以外で，かつLDEVの種別がCVS属性の場合は，"CVS"が表示されます。エミュレーションタイプがOPEN-V以外で，かつLDEVの種別がCVS属性でない場合は，"nonCVS"が表示されます。

表5-32 CreateMigrationPlanコマンドの出力項目（マイグレーション対象ボリュームの対ごとの情報）

項目名
説明

pair
移動元ボリュームと移動先ボリュームの対の記述の始まりを示す区切り記号

[ LUSE ]
LUSE属性

[ LU ]
LUデバイス番号

[ emulationType ]
エミュレーションタイプ

[ CVS ]
ボリュームがCVS属性かどうかを示します。

Yes：CVS属性です。

No：CVS属性ではありません。

[ capacityInKB ]
ボリュームの容量（単位はKB）

[ LBA ]
Block数単位のボリュームの容量

[ SLPRNumber ]
SLPR番号

[ CLPRNumber ]
CLPR番号

[ cacheMode ]
キャッシュモード

[ IOSuppressionMode ]
IO抑止モード

sourceControllerDeviceNumber
移動元ボリュームのコントローラー論理デバイス番号
16進数と" : "（コロン）を組み合わせた値で表示されます。

targetControllerDeviceNumber
移動先ボリュームのコントローラー論理デバイス番号
16進数と" : "（コロン）を組み合わせた値で表示されます。選択できなかった場合，空文字が表示されます。
一部の移動先ボリュームが見つからなかった場合には，"NotMigrate"が表示されます。

targetPoolId
移動先DPプール番号
この項目は移動先がDPプールのとき（targetstoragetiernameパラメーターにプール検索条件を使用して作成したストレージ階層を指定したとき）に自動的に表示されます。
ボリューム検索条件を指定してマイグレーションプランを作成した場合，この行は表示されません。
移動元ボリュームがプールボリュームを移動先にできない場合や，移動先として指定できるプールボリュームがない場合には，空文字が出力されます。

（凡例）

[ ]：コメント行を示します。

次に示す「表5-33 CreateMigrationPlanコマンドの出力項目（移動先として候補となるボリュームの情報）」の出力項目は，コメント行として表示されます。表示される順序および出力項目は，Tiered Storage Managerサーバのバージョンによって異なる場合があります。

表5-33 CreateMigrationPlanコマンドの出力項目（移動先として候補となるボリュームの情報）

項目名
説明

# Target candidates for source LDEVの行
移動先ボリューム（候補ボリューム）となるボリュームと，対応する移動元ボリュームのコントローラー論理デバイス番号
# Target candidates for source LDEVの行※1にハイフンでつないで表示されます。
移動先ボリュームに対して移動元ボリュームに成り得るボリュームが，コンマ区切りで表示されます。

emulationType
エミュレーションタイプ

CVS
ボリュームがCVS属性かどうかを示します。

Yes：CVS属性です。

No：CVS属性ではありません。

capacityInKB
移動先ボリュームの容量（単位はKB）

LBA
Block数単位のボリュームの容量

subsystem
ストレージシステムのモデル名

SLPRNumber
SLPR番号

CLPRNumber
CLPR番号

arrayGroupName
LDEVのパリティグループ名

diskType
ドライブ種別

RAIDLevel
RAIDレベル
外部接続されたストレージがSMI-S enabledストレージシステムの場合は"Unknown"が表示されます。

cacheMode
キャッシュモード

IOSuppressionMode
IO抑止モード

dynamicProvisioning
{ xpThinProvisioning }
ボリューム種別

dynamicProvisioningの場合：
-：通常ボリューム
DP-VOL：DPボリューム
DP-Pool-VOL：DPプールボリューム

xpThinProvisioningの場合：
-：通常ボリューム
THP-VOL：THPボリューム
THP-Pool-VOL：THPプールボリューム

arrayGroupBusyRate
パリティグループの使用率（%）
小数点第2位まで表示されます。

arrayGroupMaxBusyRate
パリティグループの使用率（%）の最大値
小数点第2位まで表示されます。

targetControllerDeviceNumber
移動先ボリュームのコントローラー論理デバイス番号
移動先ボリュームの候補と成り得るボリュームが複数あった場合，ボリュームごとに複数の行が表示されます。移動先ボリュームの候補と成り得るボリュームには，移動元ボリュームよりも容量が大きい（再作成が必要な）ボリュームも含まれます。※2
第1候補となっているボリュームには，コントローラー論理デバイス番号に続いて，アスタリスク（*）と括弧付きで移動元ボリュームのコントローラー論理デバイス番号が表示されます。

（凡例）

{ }：ストレージシステムがVP9500，H24000，またはH20000のときに表示される文字列です。

注※1

# Target candidates for source LDEV行は，Tiered Storage Managerサーバの設定によって，表示される情報が2種類あります。1つは「移動元ボリュームと同じ容量の移動先ボリューム」を表し，もう1つは「移動元ボリュームよりも容量の大きい移動先ボリューム」を表します。この2種類は，どちらか1つまたは混在して表示される場合があります。混在して表示された場合は，次の順番で出力されます。

移動元ボリュームと同じ容量の移動先ボリューム

移動元ボリュームよりも容量の大きい移動先ボリューム

混在して表示された例は「コマンド指定例- 1」を参照してください。

注※2

移動元ボリュームより容量の大きいボリュームを，候補ボリュームとして表示させたくない場合は，server.propertiesファイルのキーserver.migrationPlan.candidateCapacityGroupDisplayMaxCountに0を指定します。

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

CreateMigrationPlanコマンドの出力結果として作成される候補マイグレーションプランの例を示します。

コマンド指定例- 1：
ストレージドメインTSM_VSP@10.208.115.233内で，マイグレーショングループMG011の各ボリュームをストレージ階層MegaTech-HighCostへマイグレーションする場合の候補マイグレーションプランを作成します。この例では，移動先ボリューム（候補ボリューム）に「移動元ボリュームと同じ容量の候補ボリューム」と「移動元ボリュームより大きい容量の候補ボリューム」が混在した場合を示します。

htsmcli CreateMigrationPlan storagedomainname="TSM_VSP@10.208.115.233" migrationgroupname="MG011" targetstoragetiername="MegaTech-HighCost"

実行結果- 1：

#Example plan for migration
plan-type=Migration
format-version=1.0
storageDomainName=TSM_VSP@10.208.115.233
 migrationGroupName=MG011
 targetStorageTierName=MegaTech-HighCost
 permitCrossSLPRMigration=No
 permitCrossCLPRMigration=Yes
# arrayGroupSelectionRule=BalanceCapacity
# arrayGroupAvoidanceOfMigrationGroups=

# Begin Profile Information
#   List of 2 Profile elements:
#     An instance of Profile(1 of 2)
#       configuration=OPEN-V, 1.00 GB(1,049,280 KB, 2,098,560 Blocks)
#       numberOfNeededVolumes=1
#       numberOfAvailableVolumes=14(10)
#       numberOfDifference=13(9)
#     An instance of Profile(2 of 2)
#       configuration=OPEN-V, 2.00 GB(2,097,600 KB, 4,195,200 Blocks)
#       numberOfNeededVolumes=1
#       numberOfAvailableVolumes=4(4)
#       numberOfDifference=3(3)
# End Profile Information

   pair
#     LUSE=No
#     LU=00:0A:10
#     emulationType=OPEN-V
#     CVS=Yes
#     capacityInKB=1,049,280
#     LBA=2,098,560
#     SLPRNumber=
#     CLPRNumber=0
#     cacheMode=Unknown
#     IOSuppressionMode=Unknown
     sourceControllerDeviceNumber=00:0A:10
     targetControllerDeviceNumber=00:04:3A

   pair
#     LUSE=No
#     LU=00:11:1F
#     emulationType=OPEN-V
#     CVS=Yes
#     capacityInKB=2,097,600
#     LBA=4,195,200
#     SLPRNumber=
#     CLPRNumber=0
#     cacheMode=Unknown
#     IOSuppressionMode=Unknown
     sourceControllerDeviceNumber=00:11:1F
     targetControllerDeviceNumber=00:05:1A

#   Target candidates for source LDEV - 00:0A:10
#     emulationType=OPEN-V
#     CVS=Yes
#     capacityInKB=1,049,280
#     LBA=2,098,560
#     subsystem=VSP@10.208.115.233
#     SLPRNumber=-1
#     CLPRNumber=0
#     arrayGroupName=1-2
#     diskType=SAS
#     RAIDLevel=RAID5(3D+1P)
#     cacheMode=Unknown
#     IOSuppressionMode=Unknown
#     dynamicProvisioning=-
#     arrayGroupBusyRate=
#     arrayGroupMaxBusyRate=
#     targetControllerDeviceNumber=00:04:3A * (00:0A:10)

#   Target candidates for source LDEV - 00:11:1F
#     emulationType=OPEN-V
#     CVS=Yes
#     capacityInKB=2,097,600
#     LBA=4,195,200
#     subsystem=VSP@10.208.115.233
#     SLPRNumber=-1
#     CLPRNumber=0
#     arrayGroupName=1-2
#     diskType=SAS
#     RAIDLevel=RAID5(3D+1P)
#     cacheMode=Unknown
#     IOSuppressionMode=Unknown
#     dynamicProvisioning=-
#     arrayGroupBusyRate=
#     arrayGroupMaxBusyRate=
#     targetControllerDeviceNumber=00:05:1A * (00:11:1F)
#     targetControllerDeviceNumber=00:05:1B

#   Target candidates for source LDEV - 00:0A:10
#     emulationType=OPEN-V
#     CVS=Yes
#     capacityInKB=2,097,600
#     LBA=4,195,200
#     subsystem=VSP@10.208.115.233
#     SLPRNumber=-1
#     CLPRNumber=0
#     arrayGroupName=1-2
#     diskType=SAS
#     RAIDLevel=RAID5(3D+1P)
#     cacheMode=Unknown
#     IOSuppressionMode=Unknown
#     dynamicProvisioning=-
#     arrayGroupBusyRate=
#     arrayGroupMaxBusyRate=
#     targetControllerDeviceNumber=00:05:1A * (00:11:1F)
#     targetControllerDeviceNumber=00:05:1B

コマンド指定例- 2：
ストレージドメインMegaTechUSP600-Primary内で，マイグレーショングループMG011の各ボリュームをストレージ階層MegaTech-HighCostへマイグレーションする場合の候補マイグレーションプランを作成します。この例では，一部の移動先ボリュームの容量が移動元ボリュームの容量より大きい場合を示します。

htsmcli CreateMigrationPlan storagedomainname="MegaTechUSP600-Primary" migrationgroupname="MG011" targetstoragetiername="MegaTech-HighCost"

実行結果- 2：

#Example plan for migration
plan-type=Migration
format-version=1.0
storageDomainName=MegaTechUSP600-Primary
 migrationGroupName=MG011
 targetStorageTierName=MegaTech-HighCost
 permitCrossSLPRMigration=No
 permitCrossCLPRMigration=Yes
# arrayGroupSelectionRule=BalanceCapacity
# arrayGroupAvoidanceOfMigrationGroups=

# Begin Profile Information
#   List of 2 Profile elements:
#     An instance of Profile(1 of 2)
#       configuration=OPEN-V, 1,000 MB(1,024,320 KB, 2,048,640 Blocks)
#       numberOfNeededVolumes=1
#       numberOfAvailableVolumes=4(0)
#       numberOfDifference=3(-1)
#     An instance of Profile(2 of 2)
#       configuration=OPEN-V, 9.76 GB(10,240,320 KB, 20,480,640 Blocks)
#       numberOfNeededVolumes=1
#       numberOfAvailableVolumes=4(4)
#       numberOfDifference=3(3)
# End Profile Information

   pair
#     LUSE=No
#     LU=00:00:0E
#     emulationType=OPEN-V
#     CVS=Yes
#     capacityInKB=1,024,320
#     LBA=2,048,640
#     SLPRNumber=0
#     CLPRNumber=0
#     cacheMode=Unknown
#     IOSuppressionMode=Unknown
     sourceControllerDeviceNumber=00:00:0E
     targetControllerDeviceNumber=00:0A:09

   pair
#     LUSE=No
#     LU=00:0A:00
#     emulationType=OPEN-V
#     CVS=Yes
#     capacityInKB=10,240,320
#     LBA=20,480,640
#     SLPRNumber=0
#     CLPRNumber=0
#     cacheMode=Unknown
#     IOSuppressionMode=Unknown
     sourceControllerDeviceNumber=00:0A:00
     targetControllerDeviceNumber=00:0A:02

#   Target candidates for source LDEV - 00:0A:00
#     emulationType=OPEN-V
#     CVS=Yes
#     capacityInKB=10,240,320
#     LBA=20,480,640
#     subsystem=USP_V@172.16.110.1
#     SLPRNumber=0
#     CLPRNumber=0
#     arrayGroupName=1-6-1
#     diskType=-
#     RAIDLevel=RAID5(3D+1P)
#     cacheMode=Unknown
#     IOSuppressionMode=Unknown
#     dynamicProvisioning=-
#     arrayGroupBusyRate=
#     arrayGroupMaxBusyRate=
#     targetControllerDeviceNumber=00:0A:02 * (00:0A:00)
#     targetControllerDeviceNumber=00:0A:09 * (00:00:0E)

#   Target candidates for source LDEV - 00:00:0E
#     emulationType=OPEN-V
#     CVS=Yes
#     capacityInKB=10,240,320
#     LBA=20,480,640
#     subsystem=USP_V@172.16.110.1
#     SLPRNumber=0
#     CLPRNumber=0
#     arrayGroupName=1-6-1
#     diskType=-
#     RAIDLevel=RAID5(3D+1P)
#     cacheMode=Unknown
#     IOSuppressionMode=Unknown
#     dynamicProvisioning=-
#     arrayGroupBusyRate=
#     arrayGroupMaxBusyRate=
#     targetControllerDeviceNumber=00:0A:02 * (00:0A:00)
#     targetControllerDeviceNumber=00:0A:09 * (00:00:0E)

KATS10624-W (以下，メッセージの内容が続きます。)

参考

「一部の移動先ボリュームが見つからなかった」および「一部の移動先ボリュームが移動元ボリュームより大きい」という2つの条件が同時に成立した場合は，それぞれの警告メッセージであるKATS10602-WメッセージとKATS10624-Wメッセージが2つとも出力されます。この場合，出力順序は「KATS10624-W」「KATS10602-W」です。

コマンド指定例- 3：
コマンド指定例- 2と同じ条件で候補マイグレーションプランを作成します。この例では，一部の移動先ボリュームの候補が見つからなかった場合を示します。

htsmcli CreateMigrationPlan storagedomainname="MegaTechUSP600-Primary" migrationgroupname="MG011" targetstoragetiername="MegaTech-HighCost"

実行結果- 3：

#Example plan for migration
plan-type=Migration
format-version=1.0
storageDomainName=MegaTechUSP600-Primary
 migrationGroupName=MG011
 targetStorageTierName=MegaTech-HighCost
 permitCrossSLPRMigration=No
 permitCrossCLPRMigration=Yes
# arrayGroupSelectionRule=MinimumCoverage
# arrayGroupAvoidanceOfMigrationGroups=MG012,MG013

# Begin Profile Information
#   List of 2 Profile elements:
#     An instance of Profile(1 of 2)
#       configuration=Open-V,4.97GB
#       numberOfNeededVolumes=2
#       numberOfAvailableVolumes=20(20)
#       numberOfDifference=18(18)
#     An instance of Profile(2 of 2)
#       configuration=Open-9, 9GB, CVS
#       numberOfNeededVolumes=5
#       numberOfAvailableVolumes=3(3)
#       numberOfDifference=-2(-2)
# End Profile Information

   pair
#     LUSE=No
#     LU=0:E7
#     emulationType=OPEN-9
#     CVS=No
#     capacityInKB=7,211,520
#     LBA=14,423,040
#     SLPRNumber=0
#     CLPRNumber=0
#     cacheMode=Disable
#     IOSuppressionMode=Disable
     sourceControllerDeviceNumber=0:E7
     targetControllerDeviceNumber=NotMigrate

   pair
#     LUSE=No
#     LU=3:A6
#     emulationType=OPEN-V
#     CVS=Yes
#     capacityInKB=10,240,320
#     LBA=20,480,640
#     SLPRNumber=0
#     CLPRNumber=0
#     cacheMode=Disable
#     IOSuppressionMode=Disable
     sourceControllerDeviceNumber=3:A6
     targetControllerDeviceNumber=2:80

   pair
#     LUSE=No
#     LU=3:A7
#     emulationType=OPEN-V
#     CVS=Yes
#     capacityInKB=10,240,320
#     LBA=20,480,640
#     SLPRNumber=0
#     CLPRNumber=0
#     cacheMode=Disable
#     IOSuppressionMode=Disable
     sourceControllerDeviceNumber=3:A7
     targetControllerDeviceNumber=2:84

#   Target candidates for source LDEV - 3:A7, 3:A6
#     emulationType=OPEN-V
#     CVS=Yes
#     capacityInKB=10,240,320
#     LBA=20,480,640
#     subsystem=USP#14011
#     SLPRNumber=0
#     CLPRNumber=0
#     arrayGroupName=1-10-1
#     diskType=FC
#     RAIDLevel=RAID5(3D+1P)
#     cacheMode=Disable
#     IOSuppressionMode=Disable
#     dynamicProvisioning=-
#     arrayGroupBusyRate=50.00
#     arrayGroupMaxBusyRate=60.73
#     targetControllerDeviceNumber=2:80 * (3:A6)
#     targetControllerDeviceNumber=2:84 * (3:A7)
#     targetControllerDeviceNumber=2:85
#     targetControllerDeviceNumber=2:86
#     targetControllerDeviceNumber=2:87
#     targetControllerDeviceNumber=2:89
#     targetControllerDeviceNumber=2:8A
#     targetControllerDeviceNumber=2:8C
#     targetControllerDeviceNumber=2:8F
#     targetControllerDeviceNumber=2:91
#     targetControllerDeviceNumber=2:92
#     targetControllerDeviceNumber=2:95
#     targetControllerDeviceNumber=2:99
#     targetControllerDeviceNumber=2:9E
#     targetControllerDeviceNumber=2:9F
#     targetControllerDeviceNumber=2:A0
#     targetControllerDeviceNumber=2:A3
#     targetControllerDeviceNumber=2:A4
#     targetControllerDeviceNumber=2:A5
#     targetControllerDeviceNumber=2:A6
#     targetControllerDeviceNumber=2:A7

KATS10602-W (以下，メッセージの内容が続きます。)

コマンド指定例- 4：
コマンド指定例- 2と同じ条件で候補マイグレーションプランを作成します。この例では，プール検索条件を使用して作成したストレージ階層が移動先ストレージ階層に設定されている場合を示します。

htsmcli CreateMigrationPlan storagedomainname="MegaTechUSP600-Primary" migrationgroupname="MG011" targetstoragetiername="MegaTech-HighCost"

実行結果- 4：

#Example plan for migration
plan-type=Migration
format-version=1.0
storageDomainName=MegaTechUSP600-Primary
 migrationGroupName=MG011
 targetStorageTierName=MegaTech-HighCost
 permitCrossSLPRMigration=No
 permitCrossCLPRMigration=Yes
# arrayGroupSelectionRule=MinimumCoverage
# arrayGroupAvoidanceOfMigrationGroups=MG012,MG013

# Begin Profile Information
#   List of 1 Profile elements:
#     An instance of Profile(1 of 2)
#       configuration=Open-V,4.97GB
#       numberOfNeededVolumes=2
#       numberOfAvailableVolumes=20(20)
#       numberOfDifference=18(18)
#     An instance of Profile(2 of 2)
#       configuration=Open-9, 9GB, CVS
#       numberOfNeededVolumes=5
#       numberOfAvailableVolumes=3(3)
#       numberOfDifference=-2(-2)
# End Profile Information

   pair
#     LUSE=No
#     LU=0:E7
#     emulationType=OPEN-9
#     CVS=No
#     capacityInKB=7,211,520
#     LBA=14,423,040
#     SLPRNumber=0
#     CLPRNumber=0
#     cacheMode=Disable
#     IOSuppressionMode=Disable
     sourceControllerDeviceNumber=0:E7
     targetControllerDeviceNumber=
     targetPoolId=DP 1

5.5.2 タスクの作成と実行

CLIで作成できるタスクと，作成するために使用するコマンドの組み合わせは，次の4種類です。

マイグレーションタスク（CreateMigrationTaskコマンド）

ロッキングタスク（CreateLockingTaskコマンド）

アンロッキングタスク（CreateUnlockingTaskコマンド）

シュレッディングタスク（CreateShreddingTaskコマンド）

ここでは，タスクの作成や実行について，共通する内容を説明します。

次のどれかに該当する場合，タスクを作成できません。

ストレージドメインのリフレッシュ状態が「実行中」または「終了（失敗）」である場合

ストレージドメインのリフレッシュが必要な場合

タスク作成時にmigrationgroupnameパラメーターに指定したマイグレーショングループが，終了状態（End）ではないタスクで，migrationgroupnameパラメーターまたはmovetomigrationgroupnameパラメーターに指定されている場合

上記以外にも，タスクの種類によって作成できない条件があります。その他の条件については，各タスク作成コマンドを参照してください。

作成されたタスクには，タスクIDが与えられます。

Tiered Storage Managerは，タスクを作成するとき，該当するタスクで処理対象となるボリュームの情報に不整合がないかどうかを確認します。このため，マイグレーショングループに含まれるボリューム数が多いと，タスクの作成に時間が掛かることがあります。

タスクの実行のしかたには，次の2とおりがあります。

タスク作成時に即時実行する（--executeオプション）

待機状態になっているタスクをExecuteTaskコマンドで実行する
タスクを作成時に即時実行しなかった場合は，タスクが待機（Standby）状態になっています。待機状態のタスクのタスクIDを指定して，ExecuteTaskコマンドを実行します。

タスクの実行とは，タスクの実行をTiered Storage Managerサーバに要求することです。実際のボリュームの操作は，コマンドとは非同期に行われます。

タスクを作成したあと，次の操作はできません。

ストレージドメインの変更

操作対象のマイグレーショングループの変更および削除

指定されたストレージ階層の変更および削除（マイグレーションタスクの場合）

移動先のマイグレーショングループの変更および削除（ロッキングタスク，アンロッキングタスク，および，シュレッディングタスクの場合）

タスクを作成したあと，実行要求の受け付けにTiered Storage Managerサーバが失敗した場合には，エラーメッセージ（KATS50213-E）が表示されます。その場合には，サーバ側の障害を解決したあとでExecuteTaskコマンドを使用してタスクを実行してください。

なお，実行したタスクが完了していない場合，同じマイグレーショングループに対して新しいタスクを作成できません。

5.5.3 CreateMigrationTask

CreateMigrationTaskコマンドは，指定したマイグレーションプランを使ってマイグレーションを実行するマイグレーションタスクを作成します。

次のどれかに該当する場合，マイグレーションタスクを作成できません。

移動元ボリュームまたは移動先ボリュームに，終了状態（End）ではないタスクに含まれるボリュームがあった場合，またはマイグレーションできないボリュームだけがあった場合

すべての移動先ボリュームに対してNotMigrateを指定したマイグレーションプランを使用して，マイグレーションタスクを作成した場合

「5.5.2 タスクの作成と実行」に示すタスクが作成できない条件のどれかに該当する場合

マイグレーションタスクを作成すると，移動先として選択されたボリュームはTiered Storage Manager以外から利用できないよう，マイグレーションが完了するまで予約状態になります。予約は，次の場合に解除されます。

マイグレーションが正常に終了して，マイグレーションタスクが終了状態になった場合

CancelTaskコマンドでマイグレーションタスクを終了（キャンセル）状態にした場合

マイグレーションタスクが失敗した場合

マイグレーションが正常に終了すると，移動元ボリュームのコントローラー論理デバイス番号と，移動先ボリュームのコントローラー論理デバイス番号が入れ替わります。ただし，ボリュームに設定されていたラベルは入れ替わりません。マイグレーションに合わせてボリュームのラベルを変更する場合は，マイグレーションタスクを実行したあとにしてください。また，マイグレーションタスクの実行が終わるまでは，移動先ボリュームにラベルを設定しないでください。

マイグレーションが正常終了したあとに，移動元ボリュームのデータを消去するかどうか（erasedataパラメーター），および移動先ボリュームのゼロデータを破棄するかどうか（zerodatadiscardパラメーター）を指定できます。ゼロデータを破棄すると，DPボリューム内の使用していないページを解放して，プールの空き容量を増やせます。

デフォルトでは，マイグレーション後，移動元ボリュームのデータは消去されません（server.migration.dataErase.defaultValueのデフォルト値はfalse（消去しない））。情報漏えいを防ぐため，erasedataパラメーターを使い，その場で移動元ボリュームのデータを消去することをお勧めします。

移動元ボリュームのデータを消去するよう指定する場合には，CreateMigrationTaskコマンドを実行する前に，お使いのストレージにデータ消去ソフトウェア（Volume Shredder）がインストールされているか確認してください。インストールされていないストレージで，データを消去するよう指定してCreateMigrationTaskコマンドを実行した場合，エラーメッセージ（KATS50315-E）が表示されます。データ消去ソフトウェアがインストールされていない場合は，移動元ボリュームのデータ消去を指定しないように，次のどれかの対処をしてから，CreateMigrationTaskコマンドを実行してください。

erasedataパラメーターにNoを指定する。

erasedataパラメーターを省略して，htsmcli.propertiesファイルにparameter.erasedata=Noを指定する（同時に，server.propertiesファイルにserver.migration.dataErase.defaultValue=trueと指定しても，htsmcli.propertiesファイルの指定が優先されます）。

erasedataパラメーターを省略して，htsmcli.propertiesファイルにparameter.erasedataを指定していない場合に，server.propertiesファイルにserver.migration.dataErase.defaultValue=falseを指定する。

また，Universal Storage Platform V/VMの場合，移動元がDPボリュームでデータ消去を指定したときには，Open Volume Managementをインストールしているかどうかによって削除対象が異なることがあります。詳細は，「A.3.2 DPプールを対象としたマイグレーションの条件」を参照してください。

注意

ボリュームを再作成するマイグレーションを実行している場合，処理の途中でエラーが発生したとき，または処理を途中でやめたとき，移動先ボリュームが削除された状態のままになることがあります。出力されたメッセージの内容を確認し，手動でボリュームを作成してください。

重要

移動先のストレージ階層の検索条件によっては，マイグレーションが成功しても移動元のボリュームが移動先のストレージ階層に含まれない場合があります。マイグレーションタスクを作成するときは，次の事柄を確認してください。

移動元のボリュームを移動する必要がある。

デフォルトで割り当てられた移動先ボリュームの属性が意図した属性である。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] CreateMigrationTask
   [ 共通オプション ]
   [ { -e | --execute } ]
   migrationplan=マイグレーションプランのファイル名
   [ erasedata={ Yes | No } ]
   [ zerodatadiscard={ Yes | No } ]
   [ notifytourl=イベント通知先アドレス ]
   [ description=タスクの説明文 ]

(2) オプション

-eまたは--execute

作成したマイグレーションタスクを即時実行したい場合に指定します。

省略するとマイグレーションタスクは待機状態になります。

(3) パラメーター

表5-34 CreateMigrationTaskコマンドのパラメーター

パラメーター名
説明

migrationplan
マイグレーションプランのファイルの名称を指定します。
絶対パス，またはコマンド実行ディレクトリからの相対パスで指定してください。

[erasedata]
マイグレーションが正常に終了したあとに移動元ボリュームのデータを消去するかどうかを指定します。

Yes：消去する

No：消去しない

デフォルトは，server.propertiesファイルのキーserver.migration.dataErase.defaultValueの値，およびhtsmcli.propertiesファイルのparameter.erasedataの値によって異なります。server.propertiesファイルでの指定より，htsmcli.propertiesファイルでの指定の方が優先されます。

[zerodatadiscard]
マイグレーションが正常に終了したあとに，移動先ボリュームのゼロデータを破棄するかどうかを指定します。

Yes：ゼロデータを破棄する（デフォルト）

No：ゼロデータを破棄しない

このパラメーターの指定を有効にするためには，次の条件を満たす必要があります。

移動先ボリュームが，DPボリュームまたはDPプールである。

Universal Storage Platform V/VMの場合，マイクロコードバージョンが60-07-0x-xx/xx以降である。

移動元ボリュームがTrueCopyまたはUniversal Replicatorのペアを構成するDPボリュームである。
Virtual Storage Platform（マイクロコードのバージョンが70-02-00-xx/xx以降），Universal Storage Platform V/VM，およびHUS VMの場合に実行できます。

移動元ボリュームがShadowImageのペアを構成するDPボリュームである。
Virtual Storage Platform（マイクロコードのバージョンが70-05-02-xx/xx以降）およびHUS VM（マイクロコードのバージョンが73-02-00-xx/xx以降）の場合で，ペアボリュームの状態がSplit （Device Manager CLIのGetStorageArray (subtarget=ReplicationInfo)でReplicationInfoオブジェクトのstatus属性に表示される値が16）のときに実行できます。

上記の条件が満たされなかった場合は，このパラメーターを"Yes"と指定してもゼロデータを破棄せず，メッセージも出力されません。

[notifytourl]
イベント発生時に，イベントを通知する先のアドレスです。
"mailto:"とメールアドレス文字列を合わせた値で指定します。

[description]
マイグレーションタスクの説明文を指定します。

（凡例）

[ ]：指定は任意です。

(4) 出力項目

表5-35 CreateMigrationTaskコマンドの出力項目（Taskインスタンス）

項目名
説明

ID
タスクIDです。
タスクIDの形式は，TK########です。ただし，########は時間+通番を36進数に変換した値です。

taskType
タスクの種類です。
Migration：マイグレーションタスク

status
タスクの状態です。
表示される値の詳細については，「5.8 タスクの状態」を参照してください。

timeEstimate
タスク実行に掛かる時間の見積もり値です。タスク作成時にerasedataパラメーターを指定して実行した場合，データ消去に掛かる時間も含みます。
"hhhh:mm:ss"の形式で表示されます。
見積もり値が10,000時間以上の場合は，"9999:59:59"が表示されます。

creationTime
タスクの作成日時です。

endTime
タスクの実行終了日時です。

ownerID
タスクを作成したユーザーのユーザーIDです。

storageDomainName
ストレージドメイン名です。

migrationGroupName
マイグレーショングループ名です。

previousTargetStorageTierName
前回のマイグレーションの移動先ストレージ階層名です。以前にマイグレーションを実行していない場合は空文字が表示されます。

targetStorageTierName
移動先ストレージ階層名です。

eraseData
マイグレーションが正常に終了したあとに移動元ボリュームのデータを消去するかどうかを示します。

zeroDataDiscard
マイグレーションが正常に終了したあとに，移動先ボリュームのゼロデータを破棄するかどうかを示します。
マイグレーションタスク作成時にゼロデータを破棄するよう指定しても，ゼロデータを破棄できる条件を満たしていなければ，"No"が表示されます。
ゼロデータを破棄するための条件については，「表5-34 CreateMigrationTaskコマンドのパラメーター」のzerodatadiscardパラメーターを参照してください。

notifyToURL
イベント通知先のアドレスです。

description
タスクの説明文です。

表5-36 CreateMigrationTaskコマンドの出力項目（MigrationInfoインスタンス）

項目名
説明

sourceControllerDeviceNumber
移動元ボリュームのコントローラー論理デバイス番号です。
16進数と" : "（コロン）を組み合わせた値で表示されます。

targetControllerDeviceNumber
移動先ボリュームのコントローラー論理デバイス番号です。
16進数と" : "（コロン）を組み合わせた値で表示されます。

timeEstimate
ボリュームごとのタスク実行に掛かる時間の見積もり値です。タスク作成時にerasedataパラメーターを指定して実行した場合，データ消去に掛かる時間も含みます。
"hhhh:mm:ss"の形式で表示されます。
見積もり値が10,000時間以上の場合は，"9999:59:59"が表示されます。

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

コマンド指定例：
マイグレーションプランを記述したテキストファイルD:¥tmp¥plan.txtを読み込んでマイグレーションするタスクを作成します。

htsmcli CreateMigrationTask migrationplan="D:¥¥tmp¥¥plan.txt" erasedata="No"

実行結果：

RESPONSE:
An instance of Task(1 of 1)
 ID=TK1f2lymqv
 taskType=Migration
 status=Standby
 timeEstimate=0:02:02
 creationTime=2014/01/25 16:53:11
 endTime=
 ownerID=user
 storageDomainName=MegaTechUSP600-Primary
 migrationGroupName=MG011
 previousTargetStorageTierName=
 targetStorageTierName=MegaTech-HighCost
 eraseData=No
 zeroDataDiscard=Yes
 notifyToURL=
 description=
 List of 2 MigrationInfo elements:
   An instance of MigrationInfo(1 of 2)
     sourceControllerDeviceNumber=3:A6
     targetControllerDeviceNumber=2:80
     timeEstimate=0:01:01
   An instance of MigrationInfo(2 of 2)
     sourceControllerDeviceNumber=3:A7
     targetControllerDeviceNumber=2:84
     timeEstimate=0:01:01

5.5.4 CreateLockingTask

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

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

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

メインフレームボリューム

iSCSIターゲットに接続しているポートからのパスが設定されているボリューム

システムディスクボリューム

NASのシステムボリュームまたはユーザーボリューム

コマンドデバイスとして使用されているボリューム

On-Demandボリューム

Dynamic Provisioningのプールボリューム

Volume Migrationの予約ボリューム

IO抑止モードが有効な外部接続ボリューム（Cross-system Copy用のボリューム）

VMAが設定されている，かつ閉塞しているボリューム

High Availability ManagerのペアボリュームまたはQuorumディスク

仮想IDを用いたデータ移行の移行元ボリューム

仮想IDを用いたデータ移行中のボリューム

仮想IDを用いたデータ移行に使用しているリソースグループに所属するボリューム

ShadowImageまたはTrueCopyのS-VOL

Universal ReplicatorのS-VOLまたはジャーナルボリューム

Copy-on-Write Snapshotのプールボリュームまたは仮想ボリューム

Thin Imageのプールボリュームまたは仮想ボリューム

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

migrationgroupnameパラメーターに指定したマイグレーショングループに，ロックできるボリュームが1つもなかった場合

タスク作成時にmovetomigrationgroupnameパラメーターに指定したマイグレーショングループが，終了状態（End）ではないタスクで，migrationgroupnameパラメーターに指定されている場合

「5.5.2 タスクの作成と実行」に示すタスクが作成できない条件のどれかに該当する場合

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

指定した期間が経過すると，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) コマンド指定例と実行結果

コマンド指定例- 1：
365日間，読み取り専用でボリュームをロックするためのロッキングタスクを作成します。

htsmcli CreateLockingTask storagedomainname=MegaTechUSP600-Primary migrationgroupname=MG011 guardmode=ReadOnly retentiondays=365
Are you sure you want to lock the migration group "MG011"? (Y/N) :

実行結果- 1：

RESPONSE:
An instance of Task(1 of 1)
 ID=TK1f2lymqv
 taskType=Locking
 status=Standby
 creationTime=2014/01/25 16:53:11
 endTime=
 ownerID=user
 storageDomainName=MegaTechUSP600-Primary
 migrationGroupName=MG011
 retentionDays=365
 retainedThrough=
 guardMode=Read only
 moveToMigrationGroupName=
 notifyToURL=mailto:test@example.com
 description=
 List of 2 LockingInfo elements:
   An instance of LockingInfo(1 of 2)
     controllerDeviceNumber=3:A6
   An instance of LockingInfo(2 of 2)
     controllerDeviceNumber=3:A7

コマンド指定例- 2：
読み取り専用でボリュームを無期限にロックするためのロッキングタスクを作成します。

htsmcli CreateLockingTask --force storagedomainname=MegaTechUSP600-Primary migrationgroupname=MG011 guardmode=ReadOnly retentiondays=-1

実行結果- 2：

RESPONSE:
An instance of Task(1 of 1)
 ID=TK1f2lymqv
 taskType=Locking
 status=Standby
 creationTime=2014/01/25 16:53:11
 endTime=
 ownerID=user
 storageDomainName=MegaTechUSP600-Primary
 migrationGroupName=MG011
 retentionDays=-1(Unlimited)
 retainedThrough=
 guardMode=Read only
 moveToMigrationGroupName=
 notifyToURL=mailto:test@example.com
 description=
 List of 2 LockingInfo elements:
   An instance of LockingInfo(1 of 2)
     controllerDeviceNumber=3:A6
   An instance of LockingInfo(2 of 2)
     controllerDeviceNumber=3:A7

5.5.5 CreateUnlockingTask

CreateUnlockingTaskコマンドは，ロック期間が切れたボリュームをロック解除するアンロッキングタスクを作成します。マイグレーショングループ単位でロック解除します。

マイグレーショングループ内に，ロック解除できないボリュームがあった場合は，ロック解除できるボリュームだけがロック解除されます。

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

migrationgroupnameパラメーターに指定したマイグレーショングループに，ロック解除できるボリュームが1つもなかった場合

タスク作成時にmovetomigrationgroupnameパラメーターに指定したマイグレーショングループが，終了状態（End）ではないタスクで，migrationgroupnameパラメーターに指定されている場合

「5.5.2 タスクの作成と実行」に示すタスクが作成できない条件のどれかに該当する場合

マイグレーショングループに，Data Retention Utilityの期限切れロックが掛かっているボリュームが含まれる場合，アンロッキングタスクの実行時にエラーになります。期限切れロックが掛かっているボリュームをアンロックする場合は，期限切れロックの設定を無効にしてください。

ボリュームのロック解除が完了したあと，ロック解除したボリュームをほかのマイグレーショングループに移動することもできます。ロック解除によって解放されたボリュームを，利用できるボリュームとして1か所にまとめておけます。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

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

(2) オプション

-eまたは--execute

作成したアンロッキングタスクを即時実行したい場合に指定します。

省略するとアンロッキングタスクは待機状態になります。

(3) パラメーター

表5-40 CreateUnlockingTaskコマンドのパラメーター

パラメーター名
説明

storagedomainname
ストレージドメイン名を指定します。

migrationgroupname
マイグレーショングループ名を指定します。

[movetomigrationgroupname]
アンロックの実行が完了したボリュームの移動先マイグレーショングループ名を指定します。

[notifytourl]
イベント発生時に，イベントを通知する先のアドレスを指定します。
"mailto:"とメールアドレス文字列を合わせた値で指定します。

[description]
タスクの説明文を指定します。

（凡例）

[ ]：指定は任意です。

(4) 出力項目

表5-41 CreateUnlockingTaskコマンドの出力項目（Taskインスタンス）

項目名
説明

ID
タスクIDです。
タスクIDの形式は，TK########です。ただし，########は時間+通番を36進数に変換した値です。

taskType
タスクの種類です。
Unlocking：アンロッキングタスク

status
タスクの状態です。
表示される値の詳細については，「5.8 タスクの状態」を参照してください。

creationTime
タスクの作成日時です。

endTime
タスクの実行終了日時です。

ownerID
タスクを作成したユーザーのユーザーIDです。

storageDomainName
ストレージドメイン名です。

migrationGroupName
マイグレーショングループ名です。

moveToMigrationGroupName
アンロックの実行が完了したボリュームの移動先マイグレーショングループ名です。

notifyToURL
イベント通知先のアドレスです。

description
タスクの説明文です。

表5-42 CreateUnlockingTaskコマンドの出力項目（UnlockingInfoインスタンス）

項目名
説明

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

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

コマンド指定例：
ボリュームをアンロックするアンロッキングタスクを作成します。

htsmcli CreateUnlockingTask storagedomainname=MegaTechUSP600-Primary migrationgroupname=MG011

実行結果：

RESPONSE:
An instance of Task(1 of 1)
 ID=TK1f2lymqv
 taskType=Unlocking
 status=Standby
 creationTime=2014/01/25 16:53:11
 endTime=
 ownerID=user
 storageDomainName=MegaTechUSP600-Primary
 migrationGroupName=MG011
 moveToMigrationGroupName=
 notifyToURL=mailto:test@example.com
 description=
 List of 2 UnlockingInfo elements:
   An instance of UnlockingInfo(1 of 2)
     controllerDeviceNumber=3:A6
   An instance of UnlockingInfo(2 of 2)
     controllerDeviceNumber=3:A7

5.5.6 CreateShreddingTask

CreateShreddingTaskコマンドは，マイグレーショングループ内のデータを完全に消去するシュレッディングタスクを作成します。マイグレーショングループ単位でシュレッディングします。

マイグレーションタスクでマイグレーション後にデータを消去するときは，ZERO-ONCE方式でデータが消去されます。DoD方式でデータを消去するには，シュレッディングタスクを作成してください。

マイグレーショングループ内に，ロックされたボリュームなどシュレッディングできないボリュームがあった場合は，シュレッディングできるボリュームのデータだけが消去されます。

Tiered Storage Managerでは，次のどれかに該当するボリュームはシュレッディングできません。

パスが設定されているボリューム

Data Retention Utilityの属性がRead/Write以外のボリューム

システムディスクボリューム

Dynamic Provisioningのプールボリューム

Dynamic Provisioningの仮想ボリュームで，かつプールに関連付けられていないボリューム

Volume Migrationの予約ボリュームまたはペアボリューム

High Availability ManagerのペアボリュームまたはQuorumディスク

TSEボリューム

仮想IDを用いたデータ移行の移行元ボリューム

仮想IDを用いたデータ移行中のボリューム

仮想IDを用いたデータ移行に使用しているリソースグループに所属するボリューム

ShadowImage※，TrueCopy※，Universal Replicator※，Copy-on-Write Snapshot，またはThin Imageのペアボリューム

Universal Replicator※のジャーナルボリューム

Copy-on-Write Snapshotのプールボリュームまたは仮想ボリューム

Thin Imageのプールボリュームまたは仮想ボリューム

注※

メインフレーム系プログラムも同様です。

次のどれかに該当する場合，シュレッディングタスクを作成できません。

migrationgroupnameパラメーターに指定したマイグレーショングループに，シュレッディングできるボリュームが1つもなかった場合

タスク作成時にmovetomigrationgroupnameパラメーターに指定したマイグレーショングループが，終了状態（End）ではないタスクで，migrationgroupnameパラメーターに指定されている場合

「5.5.2 タスクの作成と実行」に示すタスクが作成できない条件のどれかに該当する場合

シュレッディングタスクが完了したあと，データがシュレッディングされたボリュームをほかのマイグレーショングループに移動することもできます。シュレッディングによってデータが消去されたボリュームを，再利用できるボリュームとして1か所にまとめておけます。

対象ボリュームがDPボリューム，かつ移動先マイグレーショングループを指定しない場合，データ消去後にDPボリュームも削除されます。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] CreateShreddingTask
   [ 共通オプション ]
   [ { -f | --force } ]
   [ { -e | --execute } ]
   storagedomainname=ストレージドメイン名
   migrationgroupname=マイグレーショングループ名
   [ shreddingmethod={ ZERO-ONCE | DoD } ]
   [ movetomigrationgroupname=シュレッディング完了後の移動先マイグレーショングループ名 ]
   [ notifytourl=イベント通知先アドレス ]
   [ description=タスクの説明文 ]

(2) オプション

-fまたは--force

確認しないでシュレッディングタスクを作成してよい場合に指定します。

確認メッセージに応答してからシュレッディングタスクを作成する場合は，指定を省略します。

-eまたは--execute

作成したシュレッディングタスクを即時実行したい場合に指定します。

省略するとシュレッディングタスクは待機状態になります。

(3) パラメーター

表5-43 CreateShreddingTaskコマンドのパラメーター

パラメーター名
説明

storagedomainname
ストレージドメイン名を指定します。

migrationgroupname
マイグレーショングループ名を指定します。

[shreddingmethod]
シュレッディング方式を指定します。

ZERO-ONCE："0"データが1回だけ書き込まれます。（デフォルト）

DoD：DoD標準方式で書き込まれます。

[movetomigrationgroupname]
シュレッディングの実行が完了したボリュームの移動先マイグレーショングループ名を指定します。

[notifytourl]
イベント発生時に，イベントを通知する先のアドレスを指定します。
"mailto:"とメールアドレス文字列を合わせた値で指定します。

[description]
タスクの説明文を指定します。

（凡例）

[ ]：指定は任意です。

(4) 出力項目

表5-44 CreateShreddingTaskコマンドの出力項目（Taskインスタンス）

項目名
説明

ID
タスクIDです。
タスクIDの形式は，TK########です。ただし，########は時間+通番を36進数に変換した値です。

taskType
タスクの種類です。
Shredding：シュレッディング

status
タスクの状態です。
表示される値の詳細については，「5.8 タスクの状態」を参照してください。

timeEstimate
タスク実行に掛かる時間の見積もり値です。
"hhhh:mm:ss"の形式で表示されます。
見積もり値が10,000時間以上の場合は，"9999:59:59"が表示されます。

creationTime
タスクの作成日時です。

endTime
タスクの実行終了日時です。

ownerID
タスクを作成したユーザーのユーザーIDです。

storageDomainName
ストレージドメイン名です。

migrationGroupName
マイグレーショングループ名です。

shreddingmethod
シュレッディング方式です。

ZERO-ONCE："0"データが1回だけ書き込まれます。

DoD：DoD標準方式で書き込まれます。

moveToMigrationGroupName
シュレッディングの実行が完了したボリュームの移動先マイグレーショングループ名です。

notifyToURL
イベント通知先のアドレスです。

description
タスクの説明文です。

表5-45 CreateShreddingTaskコマンドの出力項目（ShreddingInfoインスタンス）

項目名
説明

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

timeEstimate
ボリュームごとのタスク実行に掛かる時間の見積もり値です。
"hhhh:mm:ss"の形式で表示されます。
見積もり値が10,000時間以上の場合は，"9999:59:59"が表示されます。

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

コマンド指定例：
マイグレーショングループMG011のボリュームをDoD標準方式でシュレッディング後，ボリュームをマイグレーショングループMG044に移動するシュレッディングタスクを作成します。

htsmcli CreateShreddingTask storagedomainname=MegaTechUSP600-Primary migrationgroupname=MG011 shreddingmethod=DoD movetomigrationgroupname=MG044
Are you sure you want to shred the data in the migration group "MG011"? (Y/N) :

実行結果：

RESPONSE:
An instance of Task(1 of 1)
 ID=TK1f2lymqv
 taskType=Shredding
 status=Standby
 timeEstimate=0:02:02
 creationTime=2014/01/25 16:53:11
 endTime=
 ownerID=user
 storageDomainName=MegaTechUSP600-Primary
 migrationGroupName=MG011
 shreddingMethod=DoD
 moveToMigrationGroupName=MG044
 notifyToURL=
 description=
 List of 2 ShreddingInfo elements:
   An instance of ShreddingInfo(1 of 2)
     controllerDeviceNumber=3:A6
     timeEstimate=0:01:01
   An instance of ShreddingInfo(2 of 2)
     controllerDeviceNumber=3:A7
     timeEstimate=0:01:01

5.6 タスクを管理するためのコマンド

タスクを管理するためのコマンドについて説明します。

CLIではGUIで作成したタスクは管理できません。

この節の構成

5.6.1 GetTasks

5.6.2 ModifyTask

5.6.3 ExecuteTask

5.6.4 CancelTask

5.6.5 StopTask

5.6.6 DeleteTasks

5.6.1 GetTasks

GetTasksコマンドは，idパラメーターで指定したタスクの情報，またはそのほかのパラメーターで指定する範囲のタスクの情報を取得します。

タスクの種類を示すtasktypeパラメーターで，対象のタスクの種類を指定することもできます。タスクの状態を示すstatusパラメーターで，対象のタスクの範囲を指定することもできます。作成日や終了日などのタスクに関連づけられた日付を用いて，取得するタスクの範囲を指定することもできます。以下の指定ができます。

指定した基準日以前に作成（または終了）したタスク

指定した基準日以降に作成（または終了）したタスク

指定した基準日当日に作成（または終了）したタスク

GetTasksコマンドは，複数種類のタスクの一覧を取得して，出力できます。そのため，タスクの種類によって出力項目が変わります。出力項目では，タスクごとに示しています。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目（マイグレーションタスク）

(5) 出力項目（ロッキングタスク）

(6) 出力項目（アンロッキングタスク）

(7) 出力項目（シュレッディングタスク）

(8) コマンド指定例と実行結果（タスクの種類ごとに表示される場合）

(9) コマンド指定例と実行結果（複数種類のタスクが同時に表示される場合）

(1) 記述形式

htsmcli [ サーバのロケーション] GetTasks
 [ 共通オプション ]
 [ { -d | --detail } ]
 [ { id=タスクID |
     [ { storagedomainname=ストレージドメイン名
         [ migrationgroupname=マイグレーショングループ名 ]
         [ targetstoragetiername=ストレージ階層名 ]
         | subsystemname=ストレージシステム名 } ]
     [ status=状態 [ ,状態 ]... ]
     [ [ datetype = { Creation | End } ]
       daystobase=基準日までの日数
         [ direction={ Before | After | Just } ] ]
     [ tasktype={ Migration | Shredding | Locking | Unlocking
                | VolumeCreation | ExternalMapping } ] } ]

(2) オプション

-dまたは--detail

CLIコマンド実行後に，詳細情報を標準出力に表示したいときに指定します。

省略した場合，サマリー情報だけが表示されます。

(3) パラメーター

パラメーターの指定は，任意です。

表5-46 GetTasksコマンドのパラメーター

パラメーター名
説明

id
タスクIDを指定します。
このパラメーターは，ほかのパラメーターと同時には指定できません。

storagedomainname
ストレージドメイン名を指定します。migrationgroupnameまたはtargetstoragetiernameを指定する場合には必ず指定してください。

migrationgroupname
マイグレーショングループ名を指定します。storagedomainnameと組み合わせて指定してください。

targetstoragetiername
移動先ストレージ階層名を指定します。storagedomainnameと組み合わせて指定してください。このパラメーターは，マイグレーションタスクの絞り込みだけに適用されます。

subsystemname
ストレージシステム名を指定します。
Device Manager CLIのGetStorageArrayでStorageArrayオブジェクトのname属性に表示される値を指定します。
ストレージシステム名が不明な場合は，プロダクト名とシリアル番号を指定します。
省略時はストレージシステムによる絞り込みはしません。

status
タスクの状態を指定します。
指定できる値の詳細については，「5.8 タスクの状態」を参照してください。
タスクの状態を複数個指定する場合には，コンマで区切ってください。

datetype
日付種別範囲指定で使用する，タスクに関連づけられた日付の種別（作成日，終了日）を指定します。

Creation：作成日（デフォルト）

End：終了日

daystobase
基準日とする日までの日数を，0または正の整数で指定します。タスクの取得範囲の基準日を，現在からの逆算日数（何日前か）で指定します。

direction
タスクの取得範囲を，基準日からの向きで指定します。

Before：基準日以前（基準日を含みます）

After：基準日以降（基準日を含みます）

Just：基準日当日（デフォルトです）

tasktype
タスクの種類を指定します。

Migration：マイグレーションタスク

Shredding：シュレッディングタスク

Locking：ロッキングタスク

Unlocking：アンロッキングタスク

VolumeCreation：ボリューム作成タスク（旧バージョンとの互換性を維持するための指定値です）

ExternalMapping：外部接続設定タスク（旧バージョンとの互換性を維持するための指定値です）

省略した場合，すべての種類のタスク情報を取得します。

(4) 出力項目（マイグレーションタスク）

重要

一部の出力項目では，次のどちらかに該当する場合に"-"または"Unknown"が表示されます。

プール検索条件を使用して作成したストレージ階層をマイグレーション移動先に選択した場合
ボリュームの作成が完了するまで"Unknown"が表示されます。

外部接続されたストレージがSMI-S enabledストレージシステムの場合
"-"または"Unknown"が表示されます。

表5-47 GetTasksコマンドの出力項目（マイグレーションタスク）（Taskインスタンス）

項目名
説明

ID
タスクIDです。
タスクIDの形式は，TK########です。ただし，########は時間+通番を36進数に変換した値です。

taskType
タスクの種類です。
Migration：マイグレーションタスク

status
タスクの状態です。
表示される値の詳細については，「5.8 タスクの状態」を参照してください。

timeEstimate
タスク実行に掛かる時間の見積もり値です。タスク作成時にerasedataパラメーターを指定して実行した場合は，データ消去に掛かる時間も含みます。
"hhhh:mm:ss"の形式で表示されます。
見積もり値が10,000時間以上の場合は，"9999:59:59"が表示されます。

creationTime
タスクの作成日時です。

executionRequestTime
タスクの実行要求日時です。

timeElapsed
タスク実行開始時点からの経過時間です。
"hhhh:mm:ss"の形式で表示されます。
経過時間が10,000時間以上の場合は，"9999:59:59"が表示されます。また，経過時間を取得できない場合は"n/a"が表示され，タスクが未実行の場合は何も表示されません。

endTime
タスクの実行終了日時です。

migrationStartedTime
マイグレーションの実行を開始した日時です。

[migrationCompletionTime]
マイグレーションの実行が完了した日時です。

migrationProgress
マイグレーションの進捗状況（%）を示します。1%未満は切り捨てて，整数で表示されます。

[estimatedMigrationCompletionTime]
マイグレーションが完了する見込みの日時です。

dataErasureStartedTime
データ消去の実行を開始した日時です。

[dataErasureCompletionTime]
データ消去の実行が完了した日時です。

dataErasureProgress
データ消去の進捗状況（%）を示します。1%未満は切り捨てて，整数で表示されます。

[estimatedDataErasureCompletionTime]
データの消去が完了する見込みの日時です。

zeroDataDiscardStartedTime
ゼロデータ破棄の実行を開始した日時です。

[zeroDataDiscardCompletionTime]
ゼロデータ破棄の実行が完了した日時です。

zeroDataDiscardProgress
ゼロデータ破棄の進捗状況（%）を示します。1%未満は切り捨てて，整数で表示されます。

[estimatedZeroDataDiscardCompletionTime]
ゼロデータ破棄が完了する見込みの日時です。

ownerID
タスクを作成したユーザーのユーザーIDです。

[ownerGroupID]
タスクを作成したユーザーのユーザーグループIDです。

storageDomainName
ストレージドメイン名です。

migrationGroupName
マイグレーショングループ名です。

[previousTargetStorageTierName]
前回のマイグレーションの移動先ストレージ階層名です。以前にマイグレーションを実行していない場合は空文字が表示されます。

targetStorageTierName
移動先ストレージ階層名です。

eraseData
マイグレーションが正常に終了したあとに移動元ボリュームのデータを消去するかどうかを示します。

zeroDataDiscard
マイグレーションが正常に終了したあとに，移動先ボリュームのゼロデータを破棄するかどうかを示します。
マイグレーションタスク作成時にゼロデータを破棄するよう指定しても，ゼロデータを破棄できる条件を満たしていなければ，"No"が表示されます。
ゼロデータを破棄するための条件については，「表5-34 CreateMigrationTaskコマンドのパラメーター」のzerodatadiscardパラメーターを参照してください。

totalCapacityInGB
マイグレーショングループ内でマイグレーション対象であるボリュームの総容量（単位はGB）です。1GB未満は切り捨てて，整数で表示されます。

notifyToURL
イベント通知先のアドレスです。

description
タスクの説明文です。

（凡例）

[ ]：-dまたは--detailオプションの指定があるときだけ出力されます。

次に示す「表5-48 GetTasksコマンドの出力項目（マイグレーションタスク）（ErrorInfoインスタンス）」および「表5-49 GetTasksコマンドの出力項目（マイグレーションタスク）（MigrationInfoインスタンス）」の出力項目は，-dまたは--detailオプションの指定があるときだけ出力されます。

表5-48 GetTasksコマンドの出力項目（マイグレーションタスク）（ErrorInfoインスタンス）

項目名 | 説明
message | エラーメッセージです。

表5-49 GetTasksコマンドの出力項目（マイグレーションタスク）（MigrationInfoインスタンス）

項目名
説明

sourceControllerDeviceNumber
移動元ボリュームのコントローラー論理デバイス番号です。
16進数と" : "（コロン）を組み合わせた値で表示されます。

sourceSubsystemSerialNumber
移動元ボリュームの実際のデータを格納しているストレージシステムのシリアル番号です。

sourceSubsystemDisplayModel
移動元ボリュームの実際のデータを格納しているストレージシステムの表示用モデル名です。
表示用モデル名が不明の場合は，プロダクト名が表示されます。

sourceSubsystemName
移動元ボリュームの実際のデータを格納しているストレージシステム名です。
ストレージシステム名称が不明の場合は，プロダクト名とシリアル番号が表示されます。

sourceSubsystemVendor
移動元ボリュームの実際のデータを格納しているストレージシステムのベンダー名です。

sourceSubsystemDeviceNumber
移動元ボリュームの実際のデータを格納しているストレージシステムのLUのデバイス番号です。
10進数，または，16進数と" : "（コロン）を組み合わせた値で表示されます。

sourceSubsystemDeviceID
移動元ボリュームの実際のデータを格納しているストレージシステムのLUのデバイスIDです。
日立ストレージシステムの場合は"-"が表示されます。

sourceSLPRNumber
移動元ボリュームのSLPR番号です。

sourceCLPRNumber
移動元ボリュームのCLPR番号です。

sourceRAIDLevel
移動元ボリュームのRAIDレベルです。

sourceDiskType
移動元ボリュームのドライブ種別です。

sourceControllerArrayGroupName
移動元ボリュームのコントローラーパリティグループ名です。

sourceArrayGroupName
移動元ボリュームのパリティグループ名です。

sourceArrayGroupBusyRate
移動元ボリュームのパリティグループの使用率（%）です。小数点第2位まで表示されます。
Tuning Managerから情報を取得できない状態になった場合に，空文字で表示されます。

sourceArrayGroupMaxBusyRate
移動元ボリュームのパリティグループの使用率（%）の最大値です。小数点第2位まで表示されます。
Tuning Managerから情報を取得できない状態になった場合に，空文字で表示されます。

targetControllerDeviceNumber
移動先ボリュームのコントローラー論理デバイス番号です。
16進数と" : "（コロン）を組み合わせた値で表示されます。

targetSubsystemSerialNumber
移動先ボリュームの実際のデータを格納しているストレージシステムのシリアル番号です。

targetSubsystemDisplayModel
移動先ボリュームの実際のデータを格納しているストレージシステムの表示用モデル名です。
表示用モデル名が不明の場合は，プロダクト名が表示されます。

targetSubsystemName
移動先ボリュームの実際のデータを格納しているストレージシステム名です。
ストレージシステム名が不明の場合は，プロダクト名とシリアル番号が表示されます。

targetSubsystemVendor
移動先ボリュームの実際のデータを格納しているストレージシステムのベンダー名です。

targetSubsystemDeviceNumber
移動先ボリュームの実際のデータを格納しているストレージシステムのLUのデバイス番号です。
10進数，または，16進数と" : "（コロン）を組み合わせた値で表示されます。

targetSubsystemDeviceID
移動先ボリュームの実際のデータを格納しているストレージシステムのLUのデバイスIDです。
日立ストレージシステムの場合は"-"が表示されます。

targetSLPRNumber
移動先ボリュームのSLPR番号です。

targetCLPRNumber
移動先ボリュームのCLPR番号です。

targetRAIDLevel
移動先ボリュームのRAIDレベルです。

targetDiskType
移動先ボリュームのドライブ種別です。

targetControllerArrayGroupName
移動先ボリュームのコントローラーパリティグループ名です。

targetArrayGroupName
移動先ボリュームのパリティグループ名です。

targetArrayGroupBusyRate
移動先ボリュームのパリティグループの使用率（%）です。小数点第2位まで表示されます。
Tuning Managerから情報を取得できない状態になった場合に，空文字で表示されます。

targetArrayGroupMaxBusyRate
移動先ボリュームのパリティグループの使用率（%）の最大値です。小数点第2位まで表示されます。
Tuning Managerから情報を取得できない状態になった場合に，空文字で表示されます。

emulationType
エミュレーションタイプです。

capacityInKB
ボリュームの容量です。単位はKBで数値だけ表示されます。

status
ボリュームごとのマイグレーション状態です。
表示される値の詳細については，「5.8 タスクの状態」を参照してください。

migrationProgress
ボリュームごとのマイグレーションの進捗状況（%）を示します。1%未満は切り捨てて，整数で表示されます。

timeElapsed
ボリュームごとのタスク実行開始時点からの経過時間です。
"hhhh:mm:ss"の形式で表示されます。
経過時間が10,000時間以上の場合は，"9999:59:59"が表示されます。また，経過時間を取得できない場合は"n/a"が表示され，タスクが未実行の場合は何も表示されません。

timeEstimate
ボリュームごとのタスク実行に掛かる時間の見積もり値です。タスク作成時にerasedataパラメーターを指定して実行した場合は，データ消去に掛かる時間も含みます。
"hhhh:mm:ss"の形式で表示されます。
見積もり値が10,000時間以上の場合は，"9999:59:59"が表示されます。

(5) 出力項目（ロッキングタスク）

重要

一部の出力項目では，外部接続されたストレージがSMI-S enabledストレージシステムの場合は"-"または"Unknown"が表示されます。

表5-50 GetTasksコマンドの出力項目（ロッキングタスク）（Taskインスタンス）

項目名
説明

ID
タスクIDです。
タスクIDの形式は，TK########です。ただし，########は時間+通番を36進数に変換した値です。

taskType
タスクの種類です。
Locking：ロッキングタスク

status
タスクの状態です。
表示される値の詳細については，「5.8 タスクの状態」を参照してください。

creationTime
タスクの作成日時です。

executionRequestTime
タスクの実行要求日時です。

startTime
タスクの実行開始日時です。

timeElapsed
タスク実行開始時点からの経過時間です。
"hhhh:mm:ss"の形式で表示されます。
経過時間が10,000時間以上の場合は，"9999:59:59"が表示されます。また，経過時間を取得できない場合は"n/a"が表示され，タスクが未実行の場合は何も表示されません。

endTime
タスクの実行終了日時です。

lockingProgress
ロッキングの進捗状況（%）を示します。1%未満は切り捨てて，整数で表示されます。

[estimatedLockingCompletionTime]
ロックが完了する見込みの日時です。

ownerID
タスクを作成したユーザーのユーザーIDです。

storageDomainName
ストレージドメイン名です。

migrationGroupName
マイグレーショングループ名です。

retentionDays
ロック期間（単位：日）です。ロック期間が無期限の場合は，"-1(Unlimited)"が表示されます。

retainedThrough
ロック期間が終了する日です。ロック期間が無期限の場合は，"Unlimited"が表示されます。

guardMode
ロッキングタスクの実行時に適用するロック方法です。

Read only：書き込み禁止

Protect：読み書き禁止

moveToMigrationGroupName
ロックの実行が完了したボリュームの移動先マイグレーショングループ名です。

notifyToURL
イベントを通知する先のアドレスです。

description
タスクの説明文です。

（凡例）

[ ]：-dまたは--detailオプションの指定があるときだけ出力されます。

次に示す「表5-51 GetTasksコマンドの出力項目（ロッキングタスク）（ErrorInfoインスタンス）」および「表5-52 GetTasksコマンドの出力項目（ロッキングタスク）（LockingInfoインスタンス）」の出力項目は，-dまたは--detailオプションの指定があるときだけ出力されます。

表5-51 GetTasksコマンドの出力項目（ロッキングタスク）（ErrorInfoインスタンス）

項目名 | 説明
message | エラーメッセージです。

表5-52 GetTasksコマンドの出力項目（ロッキングタスク）（LockingInfoインスタンス）

項目名
説明

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

subsystemSerialNumber
ボリュームの実際のデータを格納しているストレージシステムのシリアル番号です。

subsystemDisplayModel
ボリュームの実際のデータを格納しているストレージシステムの表示用モデル名です。表示用モデル名が不明の場合は，プロダクト名が表示されます。

subsystemName
ボリュームの実際のデータを格納しているストレージシステム名です。ストレージシステム名が不明の場合は，プロダクト名とシリアル番号が表示されます。

subsystemDeviceNumber
ボリュームの実際のデータを格納しているストレージシステムのLUの論理デバイス番号です。
10進数，または，16進数と" : "（コロン）を組み合わせた値で表示されます。

subsystemDeviceID
ボリュームの実際のデータを格納しているストレージシステムのLUの論理デバイスIDです。
日立ストレージシステムの場合は"-"が表示されます。

status
ボリュームごとのロック状態です。
表示される値の詳細については，「5.8 タスクの状態」を参照してください。

timeElapsed
ボリュームごとのタスク実行開始時点からの経過時間です。
"hhhh:mm:ss"の形式で表示されます。
経過時間が10,000時間以上の場合は，"9999:59:59"が表示されます。また，経過時間を取得できない場合は"n/a"が表示され，タスクが未実行の場合は何も表示されません。

(6) 出力項目（アンロッキングタスク）

重要

一部の出力項目では，外部接続されたストレージがSMI-S enabledストレージシステムの場合は"-"または"Unknown"が表示されます。

表5-53 GetTasksコマンドの出力項目（アンロッキングタスク）（Taskインスタンス）

項目名
説明

ID
タスクIDです。タスクIDの形式は，TK########です。ただし，########は時間+通番を36進数に変換した値です。

taskType
タスクの種類です。
Unlocking：アンロッキングタスク

status
タスクの状態です。
表示される値の詳細については，「5.8 タスクの状態」を参照してください。

creationTime
タスクの作成日時です。

executionRequestTime
タスクの実行要求日時です。

startTime
タスクの実行開始日時です。

timeElapsed
タスク実行開始時点からの経過時間です。
"hhhh:mm:ss"の形式で表示されます。
経過時間が10,000時間以上の場合は，"9999:59:59"が表示されます。また，経過時間を取得できない場合は"n/a"が表示され，タスクが未実行の場合は何も表示されません。

endTime
タスクの実行終了日時です。

unlockingProgress
アンロックの進捗状況（%）を示します。1%未満は切り捨てて，整数で表示されます。

[estimatedUnlockingCompletionTime]
アンロックが完了する見込みの日時です。

ownerID
タスクを作成したユーザーのユーザーIDです。

storageDomainName
ストレージドメイン名です。

migrationGroupName
マイグレーショングループ名です。

moveToMigrationGroupName
アンロックの実行が完了したボリュームの移動先マイグレーショングループ名です。

notifyToURL
イベントを通知する先のアドレスです。

description
タスクの説明文です。

（凡例）

[ ]：-dまたは--detailオプションの指定があるときだけ出力されます。

次に示す「表5-54 GetTasksコマンドの出力項目（アンロッキングタスク）（ErrorInfoインスタンス）」および「表5-55 GetTasksコマンドの出力項目（アンロッキングタスク）（UnlockingInfoインスタンス）」の出力項目は，-dまたは--detailオプションの指定があるときだけ出力されます。

表5-54 GetTasksコマンドの出力項目（アンロッキングタスク）（ErrorInfoインスタンス）

項目名 | 説明
message | エラーメッセージです。

表5-55 GetTasksコマンドの出力項目（アンロッキングタスク）（UnlockingInfoインスタンス）

項目名
説明

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

subsystemSerialNumber
ボリュームの実際のデータを格納しているストレージシステムのシリアル番号です。

subsystemDisplayModel
ボリュームの実際のデータを格納しているストレージシステムの表示用モデル名です。表示用モデル名が不明の場合は，プロダクト名が表示されます。

subsystemName
ボリュームの実際のデータを格納しているストレージシステム名です。ストレージシステム名が不明の場合は，プロダクト名とシリアル番号が表示されます。

subsystemDeviceNumber
ボリュームの実際のデータを格納しているストレージシステムのLUの論理デバイス番号です。
10進数，または，16進数と" : "（コロン）を組み合わせた値で表示されます。

subsystemDeviceID
ボリュームの実際のデータを格納しているストレージシステムのLUの論理デバイスIDです。
日立ストレージシステムの場合は"-"が表示されます。

status
ボリュームごとのアンロック状態です。
表示される値の詳細については，「5.8 タスクの状態」を参照してください。

timeElapsed
ボリュームごとのタスク実行開始時点からの経過時間です。
"hhhh:mm:ss"の形式で表示されます。
経過時間が10,000時間以上の場合は，"9999:59:59"が表示されます。また，経過時間を取得できない場合は"n/a"が表示され，タスクが未実行の場合は何も表示されません。

(7) 出力項目（シュレッディングタスク）

重要

一部の出力項目では，外部接続されたストレージがSMI-S enabledストレージシステムの場合は"-"または"Unknown"が表示されます。

表5-56 GetTasksコマンドの出力項目（シュレッディングタスク）（Taskインスタンス）

項目名
説明

ID
タスクIDです。
タスクIDの形式は，TK########です。ただし，########は時間+通番を36進数に変換した値です。

taskType
タスクの種類です。
Shredding：シュレッディングタスク

status
タスクの状態です。
表示される値の詳細については，「5.8 タスクの状態」を参照してください。

timeEstimate
タスク実行に掛かる時間の見積もり値です。
"hhhh:mm:ss"の形式で表示されます。
見積もり値が10,000時間以上の場合は，"9999:59:59"が表示されます。

creationTime
タスクの作成日時です。

executionRequestTime
タスクの実行要求日時です。

startTime
タスクの実行開始日時です。

timeElapsed
タスク実行開始時点からの経過時間です。
"hhhh:mm:ss"の形式で表示されます。
経過時間が10,000時間以上の場合は，"9999:59:59"が表示されます。また，経過時間を取得できない場合は"n/a"が表示され，タスクが未実行の場合は何も表示されません。

endTime
タスクの実行終了日時です。

shreddingProgress
シュレッディングの進捗状況（%）を示します。1%未満は切り捨てて，整数で表示されます。

[estimatedShreddingCompletionTime]
シュレッディングが完了する見込みの日時です。

ownerID
タスクを作成したユーザーのユーザーIDです。

storageDomainName
ストレージドメイン名です。

migrationGroupName
マイグレーショングループ名です。

shreddingMethod
シュレッディング方式です。

ZERO-ONCE："0"データが1回だけ書き込まれます。

DoD：DoD標準方式で書き込まれます。

moveToMigrationGroupName
シュレッディングの実行が完了したボリュームの移動先マイグレーショングループ名です。

totalShreddingCapacityInGB
マイグレーショングループ内でシュレッディング対象であるボリュームの総容量（単位はGB）です。1GB未満は切り捨てて，整数で表示されます。

notifyToURL
イベント通知先のアドレスです。

description
タスクの説明文です。

（凡例）

[ ]：-dまたは--detailオプションの指定があるときだけ出力されます。

次に示す「表5-57 GetTasksコマンドの出力項目（シュレッディングタスク）（ErrorInfoインスタンス）」および「表5-58 GetTasksコマンドの出力項目（シュレッディングタスク）（ShreddingInfoインスタンス）」の出力項目は，-dまたは--detailオプションの指定があるときだけ出力されます。

表5-57 GetTasksコマンドの出力項目（シュレッディングタスク）（ErrorInfoインスタンス）

項目名 | 説明
message | エラーメッセージです。

表5-58 GetTasksコマンドの出力項目（シュレッディングタスク）（ShreddingInfoインスタンス）

項目名
説明

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

subsystemSerialNumber
ボリュームの実際のデータを格納しているストレージシステムのシリアル番号です。

subsystemDisplayModel
ボリュームの実際のデータを格納しているストレージシステムの表示用モデル名です。表示用モデル名が不明の場合は，プロダクト名が表示されます。

subsystemName
ボリュームの実際のデータを格納しているストレージシステム名です。ストレージシステム名が不明の場合は，プロダクト名とシリアル番号が表示されます。

subsystemDeviceNumber
ボリュームの実際のデータを格納しているストレージシステムのLUの論理デバイス番号です。
10進数，または，16進数と" : "（コロン）を組み合わせた値で表示されます。

subsystemDeviceID
ボリュームの実際のデータを格納しているストレージシステムのLUの論理デバイスIDです。
日立ストレージシステムの場合は"-"が表示されます。

capacityInKB
ボリュームの容量です。単位はKBで数値だけ表示されます。

status
ボリュームごとのシュレッディング状態です。
表示される値の詳細については，「5.8 タスクの状態」を参照してください。

timeElapsed
ボリュームごとのタスク実行開始時点からの経過時間です。
"hhhh:mm:ss"の形式で表示されます。
経過時間が10,000時間以上の場合は，"9999:59:59"が表示されます。また，経過時間を取得できない場合は"n/a"が表示され，タスクが未実行の場合は何も表示されません。

timeEstimate
ボリュームごとのタスク実行に掛かる時間の見積もり値です。
"hhhh:mm:ss"の形式で表示されます。
見積もり値が10,000時間以上の場合は，"9999:59:59"が表示されます。

(8) コマンド指定例と実行結果（タスクの種類ごとに表示される場合）

コマンド指定例- 1：
コマンド入力日の5日前を基準に，それ以降に作成した，状態が待機中のマイグレーションタスクの詳細情報をストレージドメインMegaTechUSP600-Primaryから取得します。

htsmcli GetTasks --detail storagedomainname="MegaTechUSP600-Primary" status="Standby" datetype="Creation" daystobase="5" direction="After"

実行結果- 1：

RESPONSE:
List of 1 Task elements:
 An instance of Task(1 of 1)
   ID=TK1f2lymqv
   taskType=Migration
   status=Standby
   timeEstimate=0:02:04
   creationTime=2014/01/25 16:53:11
   executionRequestTime=
   timeElapsed=
   endTime=
   migrationStartedTime=
   migrationCompletionTime=
   migrationProgress=0
   estimatedMigrationCompletionTime=
   dataErasureStartedTime=
   dataErasureCompletionTime=
   dataErasureProgress=0
   estimatedDataErasureCompletionTime=
   zeroDataDiscardStartedTime=
   zeroDataDiscardCompletionTime=
   zeroDataDiscardProgress=0
   estimatedZeroDataDiscardCompletionTime=
   ownerID=user
   ownerGroupID=Admin
   storageDomainName=MegaTechUSP600-Primary
   migrationGroupName=MG011
   previousTargetStorageTierName=
   targetStorageTierName=MegaTech-HighCost
   eraseData=No
   zeroDataDiscard=No
   totalCapacityInGB=19
   notifyToURL=mailto:test@example.com
   description=
   List of 2 MigrationInfo elements:
     An instance of MigrationInfo(1 of 2)
       sourceControllerDeviceNumber=3:A6
       sourceSubsystemSerialNumber=14011
       sourceSubsystemDisplayModel=USP
       sourceSubsystemName=USP@10.208.151.151
       sourceSubsystemVendor=HITACHI
       sourceSubsystemDeviceNumber=3:A6
       sourceSubsystemDeviceID=-
       sourceSLPRNumber=0
       sourceCLPRNumber=0
       sourceRAIDLevel=RAID5(3D+1P)
       sourceDiskType=Unknown
       sourceControllerArrayGroupName=E9960-1
       sourceArrayGroupName=1-9-1
       sourceArrayGroupBusyRate=34.56
       sourceArrayGroupMaxBusyRate=56.75
       targetControllerDeviceNumber=2:80
       targetSubsystemSerialNumber=14011
       targetSubsystemDisplayModel=USP
       targetSubsystemName=USP@10.208.151.151
       targetSubsystemVendor=HITACHI
       targetSubsystemDeviceNumber=2:80
       targetSubsystemDeviceID=-
       targetSLPRNumber=0
       targetCLPRNumber=0
       targetRAIDLevel=RAID5(3D+1P)
       targetDiskType=Unknown
       targetControllerArrayGroupName=E9960-11
       targetArrayGroupName=1-10-1
       targetArrayGroupBusyRate=34.56
       targetArrayGroupMaxBusyRate=56.75
       emulationType=OPEN-V
       capacityInKB=10,240,320
       status=Standby
       migrationProgress=0
       timeElapsed=
       timeEstimate=0:01:02
     An instance of MigrationInfo(2 of 2)
       sourceControllerDeviceNumber=3:A7
       sourceSubsystemSerialNumber=14011
       sourceSubsystemDisplayModel=USP
       sourceSubsystemName=USP@10.208.151.151
       sourceSubsystemVendor=HITACHI
       sourceSubsystemDeviceNumber=3:A7
       sourceSubsystemDeviceID=-
       sourceSLPRNumber=0
       sourceCLPRNumber=0
       sourceRAIDLevel=RAID5(3D+1P)
       sourceDiskType=Unknown
       sourceControllerArrayGroupName=E9980-1
       sourceArrayGroupName=1-9-1
       sourceArrayGroupBusyRate=34.56
       sourceArrayGroupMaxBusyRate=56.75
       targetControllerDeviceNumber=2:84
       targetSubsystemSerialNumber=14011
       targetSubsystemDisplayModel=USP
       targetSubsystemName=USP@10.208.151.151
       targetSubsystemVendor=HITACHI
       targetSubsystemDeviceNumber=2:84
       targetSubsystemDeviceID=-
       targetSLPRNumber=0
       targetCLPRNumber=0
       targetRAIDLevel=RAID5(3D+1P)
       targetDiskType=Unknown
       targetControllerArrayGroupName=E9980-11
       targetArrayGroupName=1-10-1
       targetArrayGroupBusyRate=34.56
       targetArrayGroupMaxBusyRate=56.75
       emulationType=OPEN-V
       capacityInKB=10,240,320
       status=Standby
       migrationProgress=0
       timeElapsed=
       timeEstimate=0:01:02

コマンド指定例- 2：
コマンド入力日の5日前を基準に，それ以降に作成した，状態が待機中のロッキングタスクの詳細情報をストレージドメインMegaTechUSP600-Primaryから取得します。

htsmcli GetTasks --detail storagedomainname="MegaTechUSP600-Primary" status="Standby" datetype="Creation" daystobase="5" direction="After"

実行結果- 2：

RESPONSE:
List of 1 Task elements:
 An instance of Task(1 of 1)
   ID=TK1f2lymqv
   taskType=Locking
   status=Standby
   creationTime=2014/01/25 16:53:11
   executionRequestTime=
   startTime=
   timeElapsed=
   endTime=
   lockingProgress=0
   estimatedLockingCompletionTime=
   ownerID=user
   storageDomainName=MegaTechUSP600-Primary
   migrationGroupName=MG011
   retentionDays=365
   retainedThrough=
   guardMode=Read only
   moveToMigrationGroupName=
   notifyToURL=mailto:test@example.com
   description=
   List of 2 LockingInfo elements:
     An instance of LockingInfo(1 of 2)
       controllerDeviceNumber=3:A6
       subsystemSerialNumber=14011
       subsystemDisplayModel=USP
       subsystemName=USP@10.208.151.151
       subsystemDeviceNumber=3:A6
       subsystemDeviceID=-
       status=Standby
       timeElapsed=
     An instance of LockingInfo(2 of 2)
       controllerDeviceNumber=3:A7
       subsystemSerialNumber=14011
       subsystemDisplayModel=USP
       subsystemName=USP@10.208.151.151
       subsystemDeviceNumber=3:A7
       subsystemDeviceID=-
       status=Standby
       timeElapsed=

コマンド指定例- 3：
コマンド入力日の5日前を基準に，それ以降に作成した，状態が待機中のアンロッキングタスクの詳細情報をストレージドメインMegaTechUSP600-Primaryから取得します。

htsmcli GetTasks --detail storagedomainname="MegaTechUSP600-Primary" status="Standby" datetype="Creation" daystobase="5" direction="After"

実行結果- 3：

RESPONSE:
List of 1 Task elements:
 An instance of Task(1 of 1)
   ID=TK1f2lymqv
   taskType=Unlocking
   status=Standby
   creationTime=2014/01/25 16:53:11
   executionRequestTime=
   startTime=
   timeElapsed=
   endTime=
   unlockingProgress=0
   estimatedUnlockingCompletionTime=
   ownerID=user
   storageDomainName=MegaTechUSP600-Primary
   migrationGroupName=MG011
   moveToMigrationGroupName=
   notifyToURL=mailto:test@example.com
   description=
   List of 2 UnlockingInfo elements:
     An instance of UnlockingInfo(1 of 2)
       controllerDeviceNumber=3:A6
       subsystemSerialNumber=14011
       subsystemDisplayModel=USP
       subsystemName=USP@10.208.151.151
       subsystemDeviceNumber=3:A6
       subsystemDeviceID=-
       status=Standby
       timeElapsed=
     An instance of UnlockingInfo(2 of 2)
       controllerDeviceNumber=3:A7
       subsystemSerialNumber=14011
       subsystemDisplayModel=USP
       subsystemName=USP@10.208.151.151
       subsystemDeviceNumber=3:A7
       subsystemDeviceID=-
       status=Standby
       timeElapsed=

コマンド指定例- 4：
コマンド入力日の5日前を基準に，それ以降に作成した，状態が待機中のシュレッディングタスクの詳細情報をストレージドメインMegaTechUSP600-Primaryから取得します。

htsmcli GetTasks --detail storagedomainname="MegaTechUSP600-Primary" status="Standby" datetype="Creation" daystobase="5" direction="After"

実行結果- 4：

RESPONSE:
List of 1 Task elements:
 An instance of Task(1 of 1)
   ID=TK1f2lymqv
   taskType=Shredding
   status=Standby
   timeEstimate=0:02:02
   creationTime=2014/01/25 16:53:11
   executionRequestTime=
   startTime=
   timeElapsed=
   endTime=
   shreddingProgress=0
   estimatedShreddingCompletionTime=
   ownerID=user
   storageDomainName=MegaTechUSP600-Primary
   migrationGroupName=MG011
   shreddingMethod=ZERO-ONCE
   moveToMigrationGroupName=MG044
   totalShreddingCapacityInGB=19
   notifyToURL=mailto:test@example.com
   description=
   List of 2 ShreddingInfo elements:
     An instance of ShreddingInfo(1 of 2)
       controllerDeviceNumber=3:A6
       subsystemSerialNumber=14011
       subsystemDisplayModel=USP
       subsystemName=USP@10.208.151.151
       subsystemDeviceNumber=3:A6
       subsystemDeviceID=-
       capacityInKB=10,240,320
       status=Standby
       timeElapsed=
       timeEstimate=0:01:01
     An instance of ShreddingInfo(2 of 2)
       controllerDeviceNumber=3:A7
       subsystemSerialNumber=14011
       subsystemDisplayModel=USP
       subsystemName=USP@10.208.151.151
       subsystemDeviceNumber=3:A7
       subsystemDeviceID=-
       capacityInKB=10,240,320
       status=Standby
       timeElapsed=
       timeEstimate=0:01:01

(9) コマンド指定例と実行結果（複数種類のタスクが同時に表示される場合）

コマンド指定例：
コマンド入力日の5日前を基準に，それ以降に作成した，状態が待機中で複数種類のタスクの詳細情報をストレージドメインMegaTechUSP600-Primaryから取得します。

htsmcli GetTasks --detail storagedomainname="MegaTechUSP600-Primary" status="Standby" datetype="Creation" daystobase="5" direction="After"

実行結果：

RESPONSE:
List of 3 Task elements:
 An instance of Task(1 of 3)
   ID=TK1f2lymqv
   taskType=Migration
   status=Standby
   timeEstimate=0:02:04
   creationTime=2014/01/25 16:53:11
   executionRequestTime=
   timeElapsed=
   endTime=
   migrationStartedTime=
   migrationCompletionTime=
   migrationProgress=0
   estimatedMigrationCompletionTime=
   dataErasureStartedTime=
   dataErasureCompletionTime=
   dataErasureProgress=0
   estimatedDataErasureCompletionTime=
   zeroDataDiscardStartedTime=
   zeroDataDiscardCompletionTime=
   zeroDataDiscardProgress=0
   estimatedZeroDataDiscardCompletionTime=
   ownerID=user
   ownerGroupID=Admin
   storageDomainName=MegaTechUSP600-Primary
   migrationGroupName=MG011
   previousTargetStorageTierName=
   targetStorageTierName=MegaTech-HighCost
   eraseData=No
   zeroDataDiscard=No
   totalCapacityInGB=19
   notifyToURL=mailto:test@example.com
   description=
   List of 2 MigrationInfo elements:
     An instance of MigrationInfo(1 of 2)
       sourceControllerDeviceNumber=3:A6
       sourceSubsystemSerialNumber=14011
       sourceSubsystemDisplayModel=USP
       sourceSubsystemName=USP@10.208.151.151
       sourceSubsystemVendor=HITACHI
       sourceSubsystemDeviceNumber=3:A6
       sourceSubsystemDeviceID=-
       sourceSLPRNumber=0
       sourceCLPRNumber=0
       sourceRAIDLevel=RAID5(3D+1P)
       sourceDiskType=Unknown
       sourceControllerArrayGroupName=E9960-1
       sourceArrayGroupName=1-9-1
       sourceArrayGroupBusyRate=34.56
       sourceArrayGroupMaxBusyRate=56.75
       targetControllerDeviceNumber=2:80
       targetSubsystemSerialNumber=14011
       targetSubsystemDisplayModel=USP
       targetSubsystemName=USP@10.208.151.151
       targetSubsystemVendor=HITACHI
       targetSubsystemDeviceNumber=2:80
       targetSubsystemDeviceID=-
       targetSLPRNumber=0
       targetCLPRNumber=0
       targetRAIDLevel=RAID5(3D+1P)
       targetDiskType=Unknown
       targetControllerArrayGroupName=E9960-11
       targetArrayGroupName=1-10-1
       targetArrayGroupBusyRate=34.56
       targetArrayGroupMaxBusyRate=56.75
       emulationType=OPEN-V
       capacityInKB=10,240,320
       status=Standby
       migrationProgress=0
       timeElapsed=
       timeEstimate=0:01:02
     An instance of MigrationInfo(2 of 2)
       sourceControllerDeviceNumber=3:A7
       sourceSubsystemSerialNumber=14011
       sourceSubsystemDisplayModel=USP
       sourceSubsystemName=USP@10.208.151.151
       sourceSubsystemVendor=HITACHI
       sourceSubsystemDeviceNumber=3:A7
       sourceSubsystemDeviceID=-
       sourceSLPRNumber=0
       sourceCLPRNumber=0
       sourceRAIDLevel=RAID5(3D+1P)
       sourceDiskType=Unknown
       sourceControllerArrayGroupName=E9980-1
       sourceArrayGroupName=1-9-1
       sourceArrayGroupBusyRate=34.56
       sourceArrayGroupMaxBusyRate=56.75
       targetControllerDeviceNumber=2:84
       targetSubsystemSerialNumber=14011
       targetSubsystemDisplayModel=USP
       targetSubsystemName=USP@10.208.151.151
       targetSubsystemVendor=HITACHI
       targetSubsystemDeviceNumber=2:84
       targetSubsystemDeviceID=-
       targetSLPRNumber=0
       targetCLPRNumber=0
       targetRAIDLevel=RAID5(3D+1P)
       targetDiskType=Unknown
       targetControllerArrayGroupName=E9980-11
       targetArrayGroupName=1-10-1
       targetArrayGroupBusyRate=34.56
       targetArrayGroupMaxBusyRate=56.75
       emulationType=OPEN-V
       capacityInKB=10,240,320
       status=Standby
       migrationProgress=0
       timeElapsed=
       timeEstimate=0:01:02
 An instance of Task(2 of 3)
   ID=TK1f2lymqv
   taskType=Shredding
   status=Standby
   timeEstimate=0:02:02
   creationTime=2014/01/25 16:53:11
   executionRequestTime=
   startTime=
   timeElapsed=
   endTime=
   shreddingProgress=0
   estimatedShreddingCompletionTime=
   ownerID=user
   storageDomainName=MegaTechUSP600-Primary
   migrationGroupName=MG011
   shreddingMethod=ZERO-ONCE
   moveToMigrationGroupName=MG044
   totalShreddingCapacityInGB=19
   notifyToURL=mailto:test@example.com
   description=
   List of 2 ShreddingInfo elements:
     An instance of ShreddingInfo(1 of 2)
       controllerDeviceNumber=3:A6
       subsystemSerialNumber=14011
       subsystemDisplayModel=USP
       subsystemName=USP@10.208.151.151
       subsystemDeviceNumber=3:A6
       subsystemDeviceID=-
       capacityInKB=10,240,320
       status=Standby
       timeElapsed=
       timeEstimate=0:01:01
     An instance of ShreddingInfo(2 of 2)
       controllerDeviceNumber=3:A7
       subsystemSerialNumber=14011
       subsystemDisplayModel=USP
       subsystemName=USP@10.208.151.151
       subsystemDeviceNumber=3:A7
       subsystemDeviceID=-
       capacityInKB=10,240,320
       status=Standby
       timeElapsed=
       timeEstimate=0:01:01
 An instance of Task(3 of 3)
   ID=TK1f2lymqv
   taskType=Unlocking
   status=Standby
   creationTime=2014/01/25 16:53:11
   executionRequestTime=
   startTime=
   timeElapsed=
   endTime=
   unlockingProgress=0
   estimatedUnlockingCompletionTime=
   ownerID=user
   storageDomainName=MegaTechUSP600-Primary
   migrationGroupName=MG011
   moveToMigrationGroupName=
   notifyToURL=mailto:test@example.com
   description=
   List of 2 UnlockingInfo elements:
     An instance of UnlockingInfo(1 of 2)
       controllerDeviceNumber=3:A6
       subsystemSerialNumber=14011
       subsystemDisplayModel=USP
       subsystemName=USP@10.208.151.151
       subsystemDeviceNumber=3:A6
       subsystemDeviceID=-
       status=Standby
       timeElapsed=
     An instance of UnlockingInfo(2 of 2)
       controllerDeviceNumber=3:A7
       subsystemSerialNumber=14011
       subsystemDisplayModel=USP
       subsystemName=USP@10.208.151.151
       subsystemDeviceNumber=3:A7
       subsystemDeviceID=-
       status=Standby
       timeElapsed=

5.6.2 ModifyTask

ModifyTaskコマンドは，タスクの情報（タスクの説明文およびイベント通知先のアドレス）を変更します。

次の状態のタスクは情報を変更できません。

終了状態（End）であるタスク

リフレッシュの状態が「実行中」または「終了（失敗）」であるストレージドメインの中にあるタスク

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] ModifyTask
   [ 共通オプション ]
   [ { -d | --detail } ]
   id=タスクID
   [ newnotifytourl=イベント通知先アドレス ]
   [ newdescription=タスクの説明文 ]

(2) オプション

-dまたは--detail

CLIコマンド実行後に，詳細情報を標準出力に表示したいときに指定します。

省略した場合，標準出力には何も表示されません。

(3) パラメーター

表5-59 ModifyTaskコマンドのパラメーター

パラメーター名
説明

id
タスクIDを指定します。
タスクIDは，GetTasksコマンドなどで，タスクの情報が出力される時にID属性として表示されます。

[newnotifytourl]
イベント発生時に，イベントを通知する先のアドレスを指定します。省略時には，イベント通知先のアドレスは変更されません。
アドレスは，"mailto:"とメールアドレス文字列を合わせた値で指定します。
空文字列を指定すると，以前に設定したイベント通知先のアドレスの内容は消去されます。

[newdescription]
タスクの説明文を指定します。省略時には，タスクの説明文は変更されません。空文字列を指定すると，以前に設定したタスクの説明文は消去されます。

（凡例）

[ ]：指定は任意です。

(4) 出力項目

ModifyTaskコマンドは，複数種類のタスクのプロパティを変更できます。そのため，タスクの種類によって出力項目が変わります。

出力項目はタスク作成時と同じです。

マイグレーションタスク：CreateMigrationTaskコマンドの「(4) 出力項目」を参照してください。

ロッキングタスク：CreateLockingTaskコマンドの「(4) 出力項目」を参照してください。

アンロッキングタスク：CreateUnlockingTaskコマンドの「(4) 出力項目」を参照してください。

シュレッディングタスク：CreateShreddingTaskコマンドの「(4) 出力項目」を参照してください。

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

コマンド指定例：
タスクIDがTK1f2lymqvのマイグレーションタスクの説明文を変更します。

htsmcli ModifyTask --detail id="TK1f2lymqv" newdescription="This property was changed."

実行結果：

RESPONSE:
An instance of Task(1 of 1)
 ID=TK1f2lymqv
 taskType=Migration
 status=Standby
 timeEstimate=0:02:02
 creationTime=2014/01/25 16:53:11
 endTime=
 ownerID=user
 storageDomainName=MegaTechUSP600-Primary
 migrationGroupName=MG011
 previousTargetStorageTierName=
 targetStorageTierName=MegaTech-HighCost
 eraseData=No
 zeroDataDiscard=No
 notifyToURL=mailto:test@example.com
 description=This property was changed.
 List of 2 MigrationInfo elements:
   An instance of MigrationInfo(1 of 2)
     sourceControllerDeviceNumber=3:A6
     targetControllerDeviceNumber=2:80
     timeEstimate=0:01:01
   An instance of MigrationInfo(2 of 2)
     sourceControllerDeviceNumber=3:A7
     targetControllerDeviceNumber=2:84
     timeEstimate=0:01:01

5.6.3 ExecuteTask

ExecuteTaskコマンドは，指定した待機中（Standby状態）のタスクの実行をTiered Storage Managerサーバに要求します。タスクの実行は，このコマンドとは非同期に行われます。

次のタスクは実行を要求できません。

ボリューム作成タスク

外部接続設定タスク

リフレッシュの状態が「実行中」または「終了（失敗）」であるストレージドメインの中にあるタスク

タスクの状態はGetTasksコマンドで確認してください。

注意

ボリュームを再作成するマイグレーションを実行している場合，処理の途中でエラーが発生したとき，移動先ボリュームが削除された状態のままになることがあります。出力されたメッセージの内容を確認し，手動でボリュームを作成してください。

この項の構成

(1) 記述形式

(2) パラメーター

(3) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] ExecuteTask
   [ 共通オプション ]
   id=タスクID

(2) パラメーター

表5-60 ExecuteTaskコマンドのパラメーター

パラメーター名
説明

id
タスクIDを指定します。
タスクIDは，GetTasksコマンドなどで，タスクの情報が出力される時にID属性として表示されます。

(3) 出力項目

出力項目はありません。

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

コマンド指定例：
タスクIDがTK1ev677guのタスクを実行します。

htsmcli ExecuteTask id=TK1ev677gu

実行結果：
このコマンドには，出力情報はありません。

5.6.4 CancelTask

CancelTaskコマンドは，指定した待機中（Standby状態）のタスクをキャンセルします。キャンセルに成功した場合には，タスクの状態は，待機中（Standby）から「終了（キャンセル）」（Cancel）に変わります。このコマンドの実行によって，ボリュームのマイグレーションボリューム予約は解除されます。

次のタスクはキャンセルできません。

動作中（Active）のタスク

終了状態（End）のタスク

リフレッシュの状態が「実行中」または「終了（失敗）」であるストレージドメインの中にあるタスク

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] CancelTask
   [ 共通オプション ]
   [ --emergency ]
   id=タスクID

(2) オプション

--emergency

このオプションを指定すると，リフレッシュに失敗したストレージドメイン内の待機状態（Standby）のタスクに対して，強制的にタスクとボリュームタスクを終了します。

省略した場合，タスクおよびボリュームタスクは強制的に終了されません。

重要

Device Managerやストレージシステムが正常な状態のときに，--emergencyオプションを指定すると，タスクのボリュームが予約されたままになるなど，Tiered Storage Managerの管理情報とDevice Managerやストレージシステムの情報が不一致となります。このオプションを実行したあとは，次のどちらかの操作をしてください。

対象のストレージシステムがある場合
Device Managerでストレージシステムのリフレッシュを実行してください。

対象のストレージシステムがない場合
Device Managerからストレージシステムを削除してください。

(3) パラメーター

表5-61 CancelTaskコマンドのパラメーター

パラメーター名
説明

id
タスクIDを指定します。
タスクIDは，GetTasksコマンドなどで，タスクの情報が出力される時にID属性として表示されます。

(4) 出力項目

出力項目はありません。

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

コマンド指定例：
タスクIDがTK1ev677guのタスクをキャンセルします。

htsmcli CancelTask id=TK1ev677gu

実行結果：
このコマンドには，出力情報はありません。

5.6.5 StopTask

StopTaskコマンドは，指定したタスクの中止をTiered Storage Managerサーバに要求します。また，マイグレーションタスクによるマイグレーションボリューム予約を解除します。次の状態のタスクを中止できます。

動作中（Active）のタスク
ただし，次のどれかの場合は，中止できません。

シュレッディングタスク実行中（Active.Executing）の場合

ゼロデータ破棄を実行中（Active.ZeroDataDiscarding）の場合

ゼロデータ破棄を指定していないマイグレーションタスクで，データ消去を実行中（Active.DataErasing）の場合

中止中（Stopping）のタスク
マイグレーションタスクで，immediateパラメーターに"Yes"を指定した場合に限り，中止できます。

タスクの中止は，このコマンドとは非同期に行われます。

ユーザーの指定したimmediateパラメーターに従い，次のどちらかの方法でタスクは中止されます。

タスクの中止を要求したときに処理が実行されているボリュームがあった場合，その処理が終了したあと，タスクは中止される（immediateパラメーターに"No"と指定した場合，または，immediateパラメーター指定を省略した場合）。

タスクは即時に中止される。タスクの中止を要求したときに処理が実行されているボリュームがあった場合，その処理は中断される（immediateパラメーターに"Yes"と指定した場合）。

どちらの方法でも，タスクの中止を要求したときにストレージシステムの中でまだ処理が実行されていなかったボリュームには，処理は実行されません。処理が実行されなかったボリュームは，タスクが中止された時点ではタスク実行前と同じ状態のままです。

タスクの状態は，GetTasksコマンドで確認してください。

ストレージドメインのリフレッシュ状態が「実行中」または「終了（失敗）」である場合，タスクを中止できません。

注意

ボリュームを再作成するマイグレーションを実行している場合，処理を途中でやめたとき，移動先ボリュームが削除された状態のままになることがあります。出力されたメッセージの内容を確認し，手動でボリュームを作成してください。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] StopTask
   [ 共通オプション ]
   [ --emergency ]
   id=タスクID
   [ immediate={ Yes | No } ]

(2) オプション

--emergency

このオプションを指定すると，リフレッシュに失敗したストレージドメイン内のタスクに対して，強制的にタスクとボリュームタスクを終了します。

省略した場合，タスクおよびボリュームタスクは強制的に終了されません。

重要

Device Managerやストレージシステムが正常な状態のときに，--emergencyオプションを指定すると，タスクのボリュームが予約されたままになるなど，Tiered Storage Managerの管理情報とDevice Managerやストレージシステムの情報が不一致となります。このオプションを実行したあとは，次のどちらかの操作をしてください。

対象のストレージシステムがある場合
Device Managerでストレージシステムのリフレッシュを実行してください。

対象のストレージシステムがない場合
Device Managerからストレージシステムを削除してください。

(3) パラメーター

表5-62 StopTaskコマンドのパラメーター

パラメーター名
説明

id
タスクIDを指定します。
タスクIDは，GetTasksコマンドなどで，タスクの情報が出力される時にID属性として表示されます。

[immediate]
ストレージシステムで実行中のマイグレーションタスクを即時に中止するかどうかを指定します。

Yes：実行中のマイグレーションタスクを即時に中止します。※

No：マイグレーションの処理が実行されているボリュームがあった場合，その処理が終了したあと，タスクを中止します（デフォルト）。

中止中のタスクを対象に"Yes"を指定した場合，タスク中止要求は受け付けられますが，即時中止中のタスクを対象に"Yes"を指定した場合は，タスク中止要求は受け付けられません。

（凡例）

[ ]：指定は任意です。

注※

ストレージシステムで実行中のマイグレーションタスクを中止する場合，中止の要求はボリューム単位に行われます。1ボリューム当たりの中止要求に対する応答に時間が掛かることがあるため，タスクの中止が完了状態となるまでに多くの時間が必要になる場合があります。

例えば，中止を要求するボリュームが5個あった場合，すべてのボリュームに対する中止要求が完了するまでに，1ボリュームの中止要求応答時間×5の時間が掛かります。

(4) 出力項目

出力項目はありません。

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

コマンド指定例：
タスクIDがTK1ev677guのタスクを中止します。

htsmcli StopTask id=TK1ev677gu

実行結果：
このコマンドには，出力情報はありません。

5.6.6 DeleteTasks

DeleteTasksコマンドは，idパラメーターで指定する終了（End）状態のタスクを削除します。

タスクの状態を示すstatusパラメーターで，対象のタスクの範囲を指定できます。タスクの種類を指定することもできます。

作成日や終了日などのタスクに関連づけられた日付を用いて，削除するタスクの範囲を指定できます。次の指定ができます。

指定した基準日以前に作成（または終了）したタスク

指定した基準日以降に作成（または終了）したタスク

指定した基準日当日に作成（または終了）したタスク

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] DeleteTasks
   [ 共通オプション ]
   [ { -f | --force } ]
   [ { id=タスクID |
       [ { storagedomainname=ストレージドメイン名
           [ migrationgroupname=マイグレーショングループ名 ]
           [ targetstoragetiername=ストレージ階層名 ]
           | subsystemname=ストレージシステム名 } ]
       [ status=状態 [ ,状態 ]... ]
       [ [ datetype = { Creation | End } ]
        daystobase=基準日までの日数
           [ direction={ Before | After | Just } ] ]
           [ tasktype={ Migration | Shredding | Locking | Unlocking
                      | VolumeCreation | ExternalMapping } ] } ]

(2) オプション

-fまたは--force

確認しないで削除してよい場合に指定します。

確認メッセージに応答してからタスクを削除する場合は，指定を省略します。

(3) パラメーター

パラメーターの指定は，任意です。

表5-63 DeleteTasksコマンドのパラメーター

パラメーター名
説明

id
タスクIDを指定します。
タスクIDは，GetTasksコマンドなどで，タスクの情報が出力される時にID属性として表示されます。
このパラメーターは，ほかのパラメーターと同時には指定できません。

storagedomainname
ストレージドメイン名を指定します。migrationgroupnameまたはtargetstoragetiernameを指定する場合には必ず指定してください。

migrationgroupname
マイグレーショングループ名を指定します。storagedomainnameと組み合わせて指定してください。

targetstoragetiername
移動先ストレージ階層名を指定します。storagedomainnameと組み合わせて指定してください。
マイグレーションタスクの絞り込みだけに使用できます。

subsystemname
ストレージシステム名を指定します。
Device Manager CLIのGetStorageArrayでStorageArrayオブジェクトのname属性に表示される値を指定します。
ストレージシステム名が不明な場合は，プロダクト名とシリアル番号を指定します。
省略時はストレージシステムによる絞り込みはしません。

status
タスクの状態を指定します。
指定できる値の詳細については，「5.8 タスクの状態」を参照してください。
タスクの状態を複数個指定する場合には，コンマで区切ってください。

datetype
日付種別範囲指定で使用する，タスクに関連づけられた日付の種別（作成日，終了日）を指定します。

Creation：作成日（デフォルト）

End：終了日

daystobase
基準日とする日までの日数を，0または正の整数で指定します。タスクの取得範囲の基準日を，現在からの逆算日数（何日前か）で指定します。

direction
タスクの取得範囲を，基準日からの向きで指定します。

Before：基準日以前（基準日を含みます）

After：基準日以降（基準日を含みます）

Just：基準日当日（デフォルトです）

tasktype
タスクの種類を指定します。

Migration：マイグレーションタスク

Shredding：シュレッディングタスク

Locking：ロッキングタスク

Unlocking：アンロッキングタスク

VolumeCreation：ボリューム作成タスク（旧バージョンとの互換性を維持するための指定値です）

ExternalMapping：外部接続設定タスク（旧バージョンとの互換性を維持するための指定値です）

省略時は，タスクの種類を絞り込みません。

(4) 出力項目

DeleteTasksコマンドは，複数種類のタスクを削除できます。そのため，タスクの種類によって出力項目が変わります。

出力項目はタスク作成時と同じです。

マイグレーションタスク：CreateMigrationTaskコマンドの「(4) 出力項目」を参照してください。

ロッキングタスク：CreateLockingTaskコマンドの「(4) 出力項目」を参照してください。

アンロッキングタスク：CreateUnlockingTaskコマンドの「(4) 出力項目」を参照してください。

シュレッディングタスク：CreateShreddingTaskコマンドの「(4) 出力項目」を参照してください。

指定したタスクの範囲に該当するタスクがない場合には，何も出力されません。

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

コマンド指定例：
ストレージドメインMegaTechUSP600-Primaryのタスクのうち，キャンセルしたマイグレーションタスクを削除します。

htsmcli DeleteTasks storagedomainname="MegaTechUSP600-Primary" status="Cancel" tasktype="Migration"

実行結果：

CONFIRMATION:
An instance of Task(1 of 1)
 ID=TK1f2lymqv
 taskType=Migration
 status=Cancel
 timeEstimate=0:02:02
 creationTime=2014/01/25 16:53:11
 endTime=2014/01/28 16:53:45
 ownerID=user
 storageDomainName=MegaTechUSP600-Primary
 migrationGroupName=MG011
 previousTargetStorageTierName=
 targetStorageTierName=MegaTech-HighCost
 eraseData=No
 zeroDataDiscard=No
 notifyToURL=mailto:test@example.com
 description=
 List of 2 MigrationInfo elements:
   An instance of MigrationInfo(1 of 2)
     sourceControllerDeviceNumber=3:A6
     targetControllerDeviceNumber=2:80
     timeEstimate=0:01:01
   An instance of MigrationInfo(2 of 2)
     sourceControllerDeviceNumber=3:A7
     targetControllerDeviceNumber=2:84
     timeEstimate=0:01:01
Are you sure you want to delete this task? (Y/N) :

5.7 ドメインコントローラーから情報を取得するためのコマンド

ドメインコントローラーから情報を取得するためのコマンドについて説明します。

この節の構成

5.7.1 GetVolumes

5.7.2 GetPools

5.7.3 GetFreeSpaces

5.7.1 GetVolumes

GetVolumesコマンドは，ストレージドメイン内のドメインコントローラーの中にあるボリューム（LU）の一覧を取得します。

ストレージ階層やマイグレーショングループを指定すれば，ボリューム一覧を取得する範囲を限定できます。ストレージ階層またはマイグレーショングループの指定とボリュームの検索条件の指定を組み合わせると，さらに対象範囲を限定できます。

ストレージドメインのリフレッシュ状態が「実行中」または「終了（失敗）」である場合，ボリュームの情報を取得できません。

リフレッシュが必要なストレージドメインに対してコマンドを実行した場合，標準エラー出力に警告メッセージが出力されます。

重要

GetVolumesコマンドを実行すると，ボリュームの情報は分割して取得，表示されます。GetVolumesコマンドの実行中にほかのユーザーがボリュームを操作した場合，操作する前のボリューム情報と操作したあとのボリューム情報が混在して表示されることがあります。

この項の構成

(1) 記述形式

(2) オプション

(3) パラメーター

(4) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] GetVolumes
   [ 共通オプション ]
   [ { -d | --detail } ]
   storagedomainname=ストレージドメイン名
   [ { storagetiername=ストレージ階層名 | migrationgroupname=マイグレーショングループ名 } ]
   [ filtercondition=検索条件 ]

(2) オプション

-dまたは--detail

CLIコマンド実行後に，詳細情報を標準出力に表示したいときに指定します。

省略した場合，サマリー情報だけが表示されます。

(3) パラメーター

表5-64 GetVolumesコマンドのパラメーター

パラメーター名
説明

storagedomainname
ストレージドメイン名を指定します。

[storagetiername]
ストレージ階層名を指定します。
migrationgroupnameと同時には指定できません。

[migrationgroupname]
マイグレーショングループ名を指定します。
storagetiernameと同時には指定できません。

[filtercondition]
検索条件を指定します。
指定できるプロパティについては，「表4-2 ボリューム検索条件式に指定できるプロパティの概要」および「表4-5 ボリューム検索条件式のプロパティに指定できる値の範囲」を参照してください。
省略時には，検索条件による絞り込みはされません。

（凡例）

[ ]：指定は任意です。

(4) 出力項目

重要

一部の出力項目では，次のどれかに該当する場合に"-"または"Unknown"が表示されます。

Device Managerを使用してストレージシステムの中のボリュームが削除されるなど，ストレージドメイン内のボリュームの情報を取得できない状態になった場合

外部接続されたストレージの情報を取得できない状態になった場合

外部接続されたストレージがSMI-S enabledストレージシステムの場合

表5-65 GetVolumesコマンドの出力項目（StorageDomainインスタンス）

項目名 | 説明
name | ストレージドメイン名です。

表5-66 GetVolumesコマンドの出力項目（LogicalUnitインスタンス）

項目名
説明

controllerDeviceNumber
コントローラー論理デバイス番号（LUSEボリュームの場合は代表LDEVの論理デバイス番号）です。
16進数と" : "（コロン）を組み合わせた値で表示されます。

label
ボリュームに設定されているラベルです。
ラベルが設定されていない場合は，空文字が表示されます。

[subsystemSerialNumber]
実際のデータを格納しているストレージシステムのシリアル番号です。

[subsystemDisplayModel]
実際のデータを格納しているストレージシステムの表示用モデル名です。
表示用モデル名が不明の場合は，プロダクト名が表示されます。

[subsystemName]
実際のデータを格納しているストレージシステム名です。
ストレージシステム名が不明の場合は，プロダクト名とシリアル番号が表示されます。

subsystemVendor
実際のデータを格納しているストレージシステムのベンダー名です。

migrationGroupName
所属するマイグレーショングループの名称です。

emulationType
エミュレーションタイプです。

[CVS]
ボリュームがCVS属性かどうかを示します。

Yes：CVS属性です。

No：CVS属性ではありません。

capacityInKB
ボリュームの容量（単位はKB）です。
ボリューム種別が，通常ボリュームまたはプールボリュームの場合は実ボリュームの容量，仮想ボリュームの場合は仮想容量が表示されます。

consumedCapacityInKB
実使用量（単位はKB）です。
ボリューム種別が，通常ボリュームの場合は通常ボリュームの容量，仮想ボリュームの場合は仮想ボリュームの実使用量，プールボリュームの場合は空文字が表示されます。

consumedCapacityPercentage
capacityInKBに対するconsumedCapacityInKBの割合（%）です。ボリューム種別が，プールボリュームの場合は空文字が表示されます。

RAIDLevel
RAIDレベルです。

diskType
ドライブ種別です。

[fdChipType]
フラッシュメモリーのチップタイプ（詳細種別）です。

[diskRPM]
毎分ごとのドライブ回転数です。
DiskTypeにSSDまたはFMDを指定した場合は"-"が表示されます。

[encryption]
パリティグループが暗号化されているかどうかを示します。

Enabled：パリティグループが暗号化されています。

Disabled：パリティグループが暗号化されていません。

-：DPボリューム，V-VOL，LUSEボリュームの場合，または暗号化機能がサポートされていません。

[diskCapacityInGB]
ドライブ容量（単位はGB）です。

[arrayGroupNumber]
実際のデータを格納しているストレージシステムのLUのパリティグループ番号です。
HUS100またはHitachi AMS2000のDPボリュームが外部接続されている場合は"-"が表示されます。

controllerArrayGroupName
ドメインコントローラーのLUのパリティグループ名です。

arrayGroupName
実際のデータを格納しているストレージシステムのLUのパリティグループ名です。
HUS100またはHitachi AMS2000のDPボリュームが外部接続されている場合は空文字が表示されます。

arrayGroupBusyRate
パリティグループの使用率（%）です。小数点第2位まで出力されます。
Tuning Managerから情報を取得できない状態になった場合に，空文字で表示されます。

arrayGroupMaxBusyRate
パリティグループの使用率（%）の最大値です。小数点第2位まで出力されます。
Tuning Managerから情報を取得できない状態になった場合に，空文字で表示されます。

[プログラムプロダクト名]※1，※2
（shadowImage，trueCopySynchronous，trueCopyAsynchronous，universalReplicator，copyOnWriteSnapshot，thinImageなど）
プログラムプロダクトのボリューム種別です。
LUの属性として表示する必要のあるプログラムプロダクト名だけが出力されます。
ストレージシステムがVirtual Storage Platformの場合，次の条件に該当するときにはcopyOnWriteSnapshotとthinImageに同じ値が表示されます。

Copy-on-Write SnapshotまたはThin Imageのペアを構成する前のV-VOLのとき

Copy-on-Write SnapshotまたはThin Imageのプールボリュームのとき

ボリューム種別名 ※1
（ dynamicProvisioning
{ xpThinProvisioning }
）
ボリューム種別です。

dynamicProvisioningの場合：
-：通常ボリューム
DP-VOL：DPボリューム
DP-Pool-VOL：DPプールボリューム

xpThinProvisioningの場合：
-：通常ボリューム
THP-VOL：THPボリューム
THP-Pool-VOL：THPプールボリューム

[PoolId]
DPプール番号です。

DP x{ THP x }：プールに関連づけられているDPボリュームまたはプールボリュームの場合
(x：0～127)

Unassigned：プールに関連づけられていないDPボリュームの場合

上記以外の場合，空文字が表示されます。

[PVolMigrationGroupName]
ボリュームがShadowImageのS-VOLである場合，対応するP-VOLが含まれているマイグレーショングループ名です。

[PVolDeviceNumber]
ボリュームがShadowImageのS-VOLである場合，対応するP-VOLのコントローラー論理デバイス番号です。
16進数と" : "（コロン）を組み合わせた値で表示されます。

[PVolMUNumber]
ボリュームがShadowImageのS-VOLである場合，対応するP-VOLのMU番号です。

volumeStatus
ボリュームが使用中かどうかを示します。

Used：使用中です（マイグレーション先に使用できません）。

Free：未使用です（マイグレーション先に使用できます）。

volumeLockStatus
ボリュームがロックされているかどうかを示します。

Locked：ロックされています。

Unlocked：ロックされていません。

[path]
パスが設定されているかどうかを示します。

Yes：パスが設定されています。

No：パスが設定されていません。

hostNames
ホスト名です。複数ある場合，コンマで区切って表示されます。

[logicalGroup]
常に空文字が表示されます。

[port/HostStorageDomain]
ホストストレージドメイン名です。複数ある場合，コンマで区切って表示されます。

[SYSPLEXID/DEVN]
SYSPLEXID/DEVNです。複数ある場合，コンマで区切って表示されます。

[VOLSER]
メインフレームホストの管理する，メインフレームボリューム情報（ボリューム通し番号）です。

canMigrate
マイグレーション可能かどうかを示します。

Yes：マイグレーション可能です。

No：マイグレーション不可です。

[reason]
マイグレーション不可理由が表示されます。表示される文字列と説明は，「A.3.1 マイグレーションできない理由」を参照してください。
出力順序は，Tiered Storage ManagerサーバとCLIのバージョンによって異なる場合があります。

（凡例）

[ ]：-dまたは--detailオプションの指定があるときだけ出力されます。

{ }：ストレージシステムがVP9500，H24000，またはH20000のときに表示される文字列です。

注※1

ストレージのベンダーとシリーズによって項目名が変わります。表示される項目名は，次のとおりです。

表5-67 ストレージベンダーとシリーズによって変わる項目名の表示

項目名 | Virtual Storage Platform，Universal Storage Platform V/VM，HUS VM | Hitachi USP | VP9500，H24000，H20000 | H12000，H10000
プログラムプロダクト名 | shadowImage | businessCopy | businessCopyXP
trueCopySynchronous | continuousAccessSynchronous | continuousAccessXPSynchronous
trueCopyAsynchronous | continuousAccessAsynchronous | continuousAccessXPAsynchronous
universalReplicator | continuousAccessJournal | continuousAccessXPJournal
copyOnWriteSnapshot | xpSnapshot | snapshotXP
thinImage | fastSnap
ボリューム種別名 | dynamicProvisioning | 該当なし | xpThinProvisioning | 該当なし

注※2

バージョン7.4.0より前のCLIでは，ストレージドメインに対応するストレージシステムがVirtual Storage PlatformおよびHUS VMの場合にThin Imageのボリューム種別をCopy-on-Write Snapshotの値として表示します。

ストレージシステムがVirtual Storage Platformの場合，Thin Imageのボリューム種別をCopy-on-Write Snapshotのボリューム種別にまとめて表示します。copyOnWriteSnapshotに表示される値を次に示します。

Copy-on-Write SnapshotおよびThin Imageのボリューム種別がSimplexのとき
Simplexが表示されます。

Copy-on-Write Snapshotのボリューム種別がSimplexで，Thin Imageのボリューム種別がSimplex以外のとき
Thin Imageのボリューム種別（Simplex以外）が表示されます。

Copy-on-Write Snapshotのボリューム種別がSimplex以外のとき
Copy-on-Write Snapshotのボリューム種別（Simplex以外）が表示されます。

次に示す出力項目は，-dまたは--detailオプションの指定があるときだけ出力されます。複数のLDEV情報がある場合は，繰り返して表示されます。

表5-68 GetVolumesコマンドの出力項目（LDEVインスタンス）

項目名
説明

controllerDeviceNumber
コントローラー論理デバイス番号です。
16進数と" : "（コロン）を組み合わせた値で表示されます。

controllerSerialNumber
ドメインコントローラーのシリアル番号です。

controllerDisplayModel
ドメインコントローラーの表示用モデル名です。

controllerName
ドメインコントローラー名です。

emulationType
エミュレーションタイプです。

CVS
ボリュームがCVS属性かどうかを示します。

Yes：CVS属性です。

No：CVS属性ではありません。

capacityInKB
LDEVの容量（単位はKB）です。
ボリューム種別が，通常ボリュームまたはプールボリュームの場合は実ボリュームの容量，仮想ボリュームの場合は仮想容量が表示されます。

consumedCapacityInKB
実使用量（単位はKB）です。
ボリューム種別が，通常ボリュームの場合は通常ボリュームの容量，仮想ボリュームの場合は仮想ボリュームの実使用量，プールボリュームの場合は空文字が表示されます。

consumedCapacityPercentage
capacityInKBに対するconsumedCapacityInKBの割合（%）です。ボリューム種別が，プールボリュームの場合は空文字が表示されます。

cylinders
シリンダ数です。

LBA
Block数単位のボリュームの容量です。

SLPRNumber
SLPR番号です。

CLPRNumber
CLPR番号です。

RAIDLevel
RAIDレベルです。

diskType
ドライブ種別です。

diskModelName
ドライブモデル名です。

fdChipType
フラッシュメモリーのチップタイプ（詳細種別）です。

diskRPM
ドライブ回転数です。
DiskTypeにSSDまたはFMDを指定した場合は"-"が表示されます。

encryption
パリティグループが暗号化されているかどうかを示します。

Enabled：パリティグループが暗号化されています。

Disabled：パリティグループが暗号化されていません。

-：DPボリューム，V-VOL，LUSEボリュームの場合，または暗号化機能がサポートされていません。

diskCapacityInGB
ドライブ容量（単位はGB）です。

guardMode
LDEVに適用されているガード属性です。Data Retention Utilityのガード属性が表示されます。ガード属性には次の6種類があり，複数の属性を持つ場合は" ; "で区切って表示されます。属性が"Read/Write"のときは，空文字が表示されます。

Read/Write

Read only

Protect

Invisible

Zero Read Capacity

S-VOL disable

retainedThrough
ロック期間が終了する日です。無期限の場合は"Unlimited"が表示されます。

guardDate
ロックした日です。Tiered Storage Managerでロックした場合だけ表示されます。Tiered Storage Manager以外でロックした場合は表示されません。

controllerArrayGroupNumber
LDEVのパリティグループ番号です。

controllerArrayGroupName
LDEVのパリティグループ名です。

cacheMode
キャッシュモードです。

Enable：キャッシュモードがONです。

Disable：キャッシュモードがOFFです。

IOSuppressionMode
IO抑止モードです。

Enable：IO抑止モードがONです。

Disable：IO抑止モードがOFFです。

subsystemDeviceNumber
実際のデータを格納しているストレージシステムのLUのデバイス番号です。
10進数，または，16進数と" : "（コロン）を組み合わせた値で表示されます。

subsystemDeviceID
実際のデータを格納しているストレージシステムのLUのデバイスIDです。
日立ストレージシステムの場合は"-"が表示されます。

subsystemSerialNumber
実際のデータを格納しているストレージシステムのシリアル番号です。

subsystemDisplayModel
実際のデータを格納しているストレージシステムの表示用モデル名です。
表示用モデル名が不明の場合は，プロダクト名が表示されます。

subsystemName
実際のデータを格納しているストレージシステム名です。
ストレージシステム名が不明の場合は，プロダクト名とシリアル番号が表示されます。

subsystemVendor
実際のデータを格納しているストレージシステムのベンダー名です。

arrayGroupNumber
実際のデータを格納しているストレージシステムのLUのパリティグループ番号です。
HUS100またはHitachi AMS2000のDPボリュームが外部接続されている場合は"-"が表示されます。

arrayGroupName
実際のデータを格納しているストレージシステムのLUのパリティグループ名です。
HUS100またはHitachi AMS2000のDPボリュームが外部接続されている場合は空文字が表示されます。

arrayGroupBusyRate
パリティグループの使用率（%）です。小数点第2位まで表示されます。
Tuning Managerから情報を取得できない状態になった場合に，空文字で表示されます。

arrayGroupMaxBusyRate
パリティグループの使用率（%）の最大値です。小数点第2位まで表示されます。
Tuning Managerから情報を取得できない状態になった場合に，空文字で表示されます。

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

コマンド指定例：
ストレージドメインTSM_VSP@10.208.115.233のストレージ階層StorageTier-1に属しているボリュームの詳細情報を取得します。

htsmcli GetVolumes --detail storagedomainname="TSM_VSP@10.208.115.233" storagetiername="StorageTier-1"

実行結果：

RESPONSE:
An instance of StorageDomain(1 of 1)
 name=TSM_VSP@10.208.115.233
 List of 2 LogicalUnit elements:
   An instance of LogicalUnit(1 of 2)
     controllerDeviceNumber=00:00:40
     label=
     subsystemSerialNumber=53038
     subsystemDisplayModel=VSP
     subsystemName=VSP@10.208.115.233
     subsystemVendor=Hitachi
     migrationGroupName=
     emulationType=OPEN-V
     CVS=Yes
     capacityInKB=2,097,152
     consumedCapacityInKB=2,097,152
     consumedCapacityPercentage=100
     RAIDLevel=RAID5(3D+1P)
     diskType=SAS
     fdChipType=-
     diskRPM=10,000
     encryption=Disabled
     diskCapacityInGB=269
     arrayGroupNumber=16
     controllerArrayGroupName=1-2
     arrayGroupName=1-2
     arrayGroupBusyRate=
     arrayGroupMaxBusyRate=
     shadowImage=Simplex
     trueCopySynchronous=Simplex
     trueCopyAsynchronous=Simplex
     universalReplicator=Simplex
     copyOnWriteSnapshot=Simplex
     thinImage=Simplex
     dynamicProvisioning=-
     poolId=
     PVolMigrationGroupName=
     PVolDeviceNumber=
     PVolMUNumber=
     volumeStatus=Free
     volumeLockStatus=Unlocked
     path=No
     hostNames=
     logicalGroup=
     port/HostStorageDomain=
     SYSPLEXID/DEVN=
     VOLSER=
     canMigrate=Yes
     List of 0 reason(s) for volume migration exclusion:
     List of 1 LDEV elements:
       An instance of LDEV(1 of 1)
         controllerDeviceNumber=00:00:40
         controllerSerialNumber=53038
         controllerDisplayModel=VSP
         controllerName=VSP@10.208.115.233
         emulationType=OPEN-V
         CVS=Yes
         capacityInKB=2,097,152
         consumedCapacityInKB=2,097,152
         consumedCapacityPercentage=100
         cylinders=
         LBA=4,194,304
         SLPRNumber=
         CLPRNumber=0
         RAIDLevel=RAID5(3D+1P)
         diskType=SAS
         diskModelName=DKS5B-J300SS
         fdChipType=-
         diskRPM=10,000
         encryption=Disabled
         diskCapacityInGB=269
         guardMode=
         retainedThrough=
         guardDate=
         controllerArrayGroupNumber=16
         controllerArrayGroupName=1-2
         cacheMode=Unknown
         IOSuppressionMode=Unknown
         subsystemDeviceNumber=00:00:40
         subsystemDeviceID=-
         subsystemSerialNumber=53038
         subsystemDisplayModel=VSP
         subsystemName=VSP@10.208.115.233
         subsystemVendor=Hitachi
         arrayGroupNumber=16
         arrayGroupName=1-2
         arrayGroupBusyRate=
         arrayGroupMaxBusyRate=
   An instance of LogicalUnit(2 of 2)
     controllerDeviceNumber=00:04:FF
     label=
     subsystemSerialNumber=53038
     subsystemDisplayModel=VSP
     subsystemName=VSP@10.208.115.233
     subsystemVendor=Hitachi
     migrationGroupName=
     emulationType=OPEN-V
     CVS=Yes
     capacityInKB=2,098,560
     consumedCapacityInKB=2,098,560
     consumedCapacityPercentage=100
     RAIDLevel=RAID5(3D+1P)
     diskType=SAS
     fdChipType=-
     diskRPM=10,000
     encryption=-
     diskCapacityInGB=269
     arrayGroupNumber=16
     controllerArrayGroupName=1-2
     arrayGroupName=1-2
     arrayGroupBusyRate=
     arrayGroupMaxBusyRate=
     shadowImage=Simplex
     trueCopySynchronous=Simplex
     trueCopyAsynchronous=Simplex
     universalReplicator=S-VOL
     copyOnWriteSnapshot=Simplex
     thinImage=Simplex
     dynamicProvisioning=-
     poolId=
     PVolMigrationGroupName=
     PVolDeviceNumber=
     PVolMUNumber=
     volumeStatus=Used
     volumeLockStatus=Unlocked
     path=Yes
     hostNames=Unknown
     logicalGroup=
     port/HostStorageDomain=CL3-A/HCMDS0100
     SYSPLEXID/DEVN=
     VOLSER=
     canMigrate=No
     List of 3 reason(s) for volume migration exclusion:
       reason(1 of 3)=LUSE (target)
       reason(2 of 3)=Path (target)
       reason(3 of 3)=Universal Replicator Status
     List of 2 LDEV elements:
       An instance of LDEV(1 of 2)
         controllerDeviceNumber=00:04:FF
         controllerSerialNumber=53038
         controllerDisplayModel=VSP
         controllerName=VSP@10.208.115.233
         emulationType=OPEN-V
         CVS=Yes
         capacityInKB=1,049,280
         consumedCapacityInKB=1,049,280
         consumedCapacityPercentage=100
         cylinders=
         LBA=2,098,560
         SLPRNumber=
         CLPRNumber=0
         RAIDLevel=RAID5(3D+1P)
         diskType=SAS
         diskModelName=DKS5B-J300SS
         fdChipType=-
         diskRPM=10,000
         encryption=Disabled
         diskCapacityInGB=269
         guardMode=
         retainedThrough=
         guardDate=
         controllerArrayGroupNumber=16
         controllerArrayGroupName=1-2
         cacheMode=Unknown
         IOSuppressionMode=Unknown
         subsystemDeviceNumber=00:04:FF
         subsystemDeviceID=-
         subsystemSerialNumber=53038
         subsystemDisplayModel=VSP
         subsystemName=VSP@10.208.115.233
         subsystemVendor=Hitachi
         arrayGroupNumber=16
         arrayGroupName=1-2
         arrayGroupBusyRate=
         arrayGroupMaxBusyRate=
       An instance of LDEV(2 of 2)
         controllerDeviceNumber=00:05:FF
         controllerSerialNumber=53038
         controllerDisplayModel=VSP
         controllerName=VSP@10.208.115.233
         emulationType=OPEN-V
         CVS=Yes
         capacityInKB=1,049,280
         consumedCapacityInKB=1,049,280
         consumedCapacityPercentage=100
         cylinders=
         LBA=2,098,560
         SLPRNumber=
         CLPRNumber=0
         RAIDLevel=RAID5(3D+1P)
         diskType=SAS
         diskModelName=DKS5B-J300SS
         fdChipType=-
         diskRPM=10,000
         encryption=Disabled
         diskCapacityInGB=269
         guardMode=
         retainedThrough=
         guardDate=
         controllerArrayGroupNumber=16
         controllerArrayGroupName=1-2
         cacheMode=Unknown
         IOSuppressionMode=Unknown
         subsystemDeviceNumber=00:05:FF
         subsystemDeviceID=-
         subsystemSerialNumber=53038
         subsystemDisplayModel=VSP
         subsystemName=VSP@10.208.115.233
         subsystemVendor=Hitachi
         arrayGroupNumber=16
         arrayGroupName=1-2
         arrayGroupBusyRate=
         arrayGroupMaxBusyRate=

5.7.2 GetPools

GetPoolsコマンドは，ストレージドメイン内のDPプール情報の一覧を取得します。

リフレッシュが必要なストレージドメインに対してコマンドを実行した場合，標準エラー出力に警告メッセージが出力されます。

この項の構成

(1) 記述形式

(2) パラメーター

(3) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] GetPools
   [ 共通オプション ]
   storagedomainname=ストレージドメイン名
   [ storagetiername=ストレージ階層名 ]
   [ filtercondition=検索条件 ]

(2) パラメーター

表5-69 GetPoolsコマンドのパラメーター

パラメーター名
説明

storagedomainname
ストレージドメイン名を指定します。

[storagetiername]
ストレージ階層名を指定します。
省略時は，ストレージ階層による絞り込みはされません。

[filtercondition]
検索条件を指定します。
指定できるプロパティについては，「表4-3 プール検索条件式に指定できるプロパティの概要」および「表4-6 プール検索条件式のプロパティに指定できる値の範囲」を参照してください。
省略時は，検索条件による絞り込みはされません。

（凡例）

[ ]：指定は任意です。

(3) 出力項目

表5-70 GetPoolsコマンドの出力項目（StorageDomainインスタンス）

項目名 | 説明
name | ストレージドメイン名です。

表5-71 GetPoolsコマンドの出力項目（Poolインスタンス）

項目名
説明

poolId
プール番号です。

status
プールの状態です。

Normal：正常：プールのしきい値に達していません。

OverThreshold：警告：プールのしきい値（threshold1またはthreshold2）を超えています。

Blocked：閉塞：プールが満杯または障害が起きています。

numberOfDpVolumes
{ numberOfThpVolumes }
総DPボリューム数です。
出力項目名はストレージのベンダーとシリーズによって変わります。

capacityInKB
プールの全容量（単位はKB）です。

freeCapacityInKB
プールの空き容量（単位はKB）です。

usageRate
使用率（%）です。

threshold1
プールのしきい値1（単位は%）です。

threshold2
プールのしきい値2（単位は%）です。

overProvisioningPercent
仮想化超過率（単位は%）です。
仮想化超過率とは，DPプールの容量に対する，DPプールに関連づけられたDPボリューム容量の総和の比率を示します。
仮想化超過率が不明の場合，"Unknown"が表示されます。

overProvisioningWarning
仮想化超過警告しきい値（単位は%）です。
しきい値が設定されていない場合，空文字が表示されます。

overProvisioningLimit
仮想化超過限界しきい値（単位は%）です。
しきい値が設定されていない場合，空文字が表示されます。

CLPRNumber
CLPR番号です。

（凡例）

{ }：ストレージシステムがVP9500，H24000，またはH20000のときに表示される文字列です。

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

コマンド指定例：
ストレージドメインMegaTechUSP600-Primary内のプール情報を取得します。

htsmcli GetPools storagedomainname="MegaTechUSP600-Primary"

実行結果：

RESPONSE:
An instance of StorageDomain(1 of 1)
 name=MegaTechUSP600-Primary
 List of 2 Pool elements:
   An instance of Pool(1 of 2)
     poolId=DP 1
     status=Normal
     numberOfDpVolumes=5
     capacityInKB=20,640
     freeCapacityInKB=10,530
     usageRate=59
     threshold1=75
     threshold2=80
     overProvisioningPercent=90
     overProvisioningWarning=
     overProvisioningLimit=110
     CLPRNumber=1
   An instance of Pool(2 of 2)
     poolId=DP 2
     status=Normal
     numberOfDpVolumes=10
     capacityInKB=20,640
     freeCapacityInKB=10,530
     usageRate=59
     threshold1=75
     threshold2=80
     overProvisioningPercent=99
     overProvisioningWarning=
     overProvisioningLimit=110
     CLPRNumber=1

5.7.3 GetFreeSpaces

GetFreeSpacesコマンドは，Device Managerに登録したストレージシステム内の空き容量の情報を取得します。

この項の構成

(1) 記述形式

(2) パラメーター

(3) 出力項目

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

(1) 記述形式

htsmcli [ サーバのロケーション] GetFreeSpaces
   [ 共通オプション ]
   subsystemname=ストレージシステム名
   [ filtercondition=検索条件 ]

(2) パラメーター

表5-72 GetFreeSpacesコマンドのパラメーター

パラメーター名
説明

subsystemname
ストレージシステム名を指定します。
Device Manager CLIのGetStorageArrayでStorageArrayオブジェクトのname属性に表示される値を指定します。
ストレージシステム名が不明な場合は，プロダクト名とシリアル番号を指定します。

[filtercondition]
検索条件を指定します。
指定できるプロパティについては，「表4-4 空き容量検索条件式に指定できるプロパティの概要」および「表4-7 空き容量検索条件式のプロパティに指定できる値の範囲」を参照してください。
省略時には，検索条件による絞り込みはされません。

（凡例）

[ ]：指定は任意です。

(3) 出力項目

重要

一部の出力項目では，次のどちらかに該当する場合に"-"または"Unknown"が表示されます。

パリティグループの情報を取得できない場合

外部接続されたストレージがSMI-S enabledストレージシステムの場合

表5-73 GetFreeSpacesコマンドの出力項目（Subsystemインスタンス）

項目名 | 説明
name | ストレージシステム名です。
serialNumber | ストレージシステムのシリアル番号です。

表5-74 GetFreeSpacesコマンドの出力項目（FreeSpaceインスタンス）

項目名
説明

arrayGroupName
空き容量が属するパリティグループ名です。

freeSpaceNumber
空き容量番号です。

capacityInKB
パリティグループの空き容量（単位はKB）です。

totalFreeCapacityInKB
パリティグループの総空き容量（単位はKB）です。

emulationType
空き容量が属するパリティグループのエミュレーションタイプです。

RAIDLevel
空き容量が属するパリティグループのRAIDレベルです。

subsystemVendor
空き容量が属するストレージシステムのベンダー名です。

diskType
空き容量が属するパリティグループのドライブ種別です。

fdChipType
空き容量が属するパリティグループのフラッシュメモリーのチップタイプ（詳細種別）です。

diskRPM
空き容量が属するパリティグループのドライブ回転数です。
回転数が取得できない場合は，空文字が表示されます。

diskCapacityInGB
空き容量が属するパリティグループのドライブ容量（単位はGB）です。

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

コマンド指定例- 1：
ストレージシステムUSP@10.208.151.151内の空き容量の情報を取得します。

htsmcli GetFreeSpaces subsystemname="USP@10.208.151.151"

実行結果- 1：

RESPONSE:
List of 1 Subsystem elements:
 An instance of Subsystem(1 of 1)
   name=USP@10.208.151.151
   serialNumber=12345
   List of 2 FreeSpace elements:
     An instance of FreeSpace(1 of 2)
       arrayGroupName=1-1-1
       freeSpaceNumber=1
       capacityInKB=22,528
       totalFreeCapacityInKB=741,416,632
       emulationType=OPEN-V
       RAIDLevel=RAID5(3D+1P)
       subsystemVendor=HITACHI
       diskType=-
       fdChipType=-
       diskRPM=10,000
       diskCapacityInGB=268
     An instance of FreeSpace(2 of 2)
       arrayGroupName=1-1-1
       freeSpaceNumber=507
       capacityInKB=22,528
       totalFreeCapacityInKB=741,416,632
       emulationType=OPEN-V
       RAIDLevel=RAID5(3D+1P)
       subsystemVendor=HITACHI
       diskType=-
       fdChipType=-
       diskRPM=10,000
       diskCapacityInGB=268

コマンド指定例- 2：
ストレージシステム名がUSP#14000である2台のストレージシステムの空き容量の情報を取得します。

htsmcli GetFreeSpaces subsystemname="USP#14000"

実行結果- 2：

RESPONSE:
List of 2 Subsystem elements:
 An instance of Subsystem(1 of 2)
   name=USP#14000
   serialNumber=12345
   List of 2 FreeSpace elements:
     An instance of FreeSpace(1 of 2)
       arrayGroupName=1-1-1
       freeSpaceNumber=1
       capacityInKB=22,528
       totalFreeCapacityInKB=741,416,632
       emulationType=OPEN-V
       RAIDLevel=RAID5(3D+1P)
       subsystemVendor=HITACHI
       diskType=-
       fdChipType=-
       diskRPM=10,000
       diskCapacityInGB=268
     An instance of FreeSpace(2 of 2)
       arrayGroupName=1-1-1
       freeSpaceNumber=507
       capacityInKB=22,528
       totalFreeCapacityInKB=741,416,632
       emulationType=OPEN-V
       RAIDLevel=RAID5(3D+1P)
       subsystemVendor=HITACHI
       diskType=-
       fdChipType=-
       diskRPM=10,000
       diskCapacityInGB=268
 An instance of Subsystem(2 of 2)
   name=USP#14000
   serialNumber=23456
   List of 2 FreeSpace elements:
     An instance of FreeSpace(1 of 2)
       arrayGroupName=1-1-1
       freeSpaceNumber=1
       capacityInKB=22,528
       totalFreeCapacityInKB=741,416,632
       emulationType=OPEN-V
       RAIDLevel=RAID5(3D+1P)
       subsystemVendor=HITACHI
       diskType=-
       fdChipType=-
       diskRPM=10,000
       diskCapacityInGB=268
     An instance of FreeSpace(2 of 2)
       arrayGroupName=1-1-1
       freeSpaceNumber=507
       capacityInKB=22,528
       totalFreeCapacityInKB=741,416,632
       emulationType=OPEN-V
       RAIDLevel=RAID5(3D+1P)
       subsystemVendor=HITACHI
       diskType=-
       fdChipType=-
       diskRPM=10,000
       diskCapacityInGB=268

コマンド指定例- 3：
ストレージシステム名がUSP#14001である2台のストレージシステムのうち，1台のストレージシステムに空き容量がない場合の空き容量の情報を取得します。

htsmcli GetFreeSpaces subsystemname="USP#14001"

実行結果- 3：

RESPONSE:
List of 2 Subsystem elements:
 An instance of Subsystem(1 of 2)
   name=USP#14001
   serialNumber=12345
   List of 2 FreeSpace elements:
     An instance of FreeSpace(1 of 2)
       arrayGroupName=1-1-1
       freeSpaceNumber=1
       capacityInKB=22,528
       totalFreeCapacityInKB=741,416,632
       emulationType=OPEN-V
       RAIDLevel=RAID5(3D+1P)
       subsystemVendor=HITACHI
       diskType=-
       fdChipType=-
       diskRPM=10,000
       diskCapacityInGB=268
     An instance of FreeSpace(2 of 2)
       arrayGroupName=1-1-1
       freeSpaceNumber=507
       capacityInKB=22,528
       totalFreeCapacityInKB=741,416,632
       emulationType=OPEN-V
       RAIDLevel=RAID5(3D+1P)
       subsystemVendor=HITACHI
       diskType=-
       fdChipType=-
       diskRPM=10,000
       diskCapacityInGB=268
 An instance of Subsystem(2 of 2)
   name=USP#14001
   serialNumber=23456
   List of 0 FreeSpace elements:

5.8 タスクの状態

一部のコマンドでは，タスクの状態をパラメーターに指定することで，コマンドの実行対象を制御できます。また，コマンドの出力項目にもこれらの状態が表示されます。

CLIコマンドで使用するタスクの状態を次の表に示します。

なお，次の表に示すタスクの状態のうち，ボリューム作成タスクと外部接続設定タスクに関する値は，旧バージョンとの互換性を維持するためのものです。

表5-75 タスクの状態（パラメーター指定値および出力項目）

タスクの状態
説明
パラメーター
出力項目

GetTasks
DeleteTasks

Active
動作中
すべてのActive状態を同時に指定したのと同義。
○
×
×

Active.CreatingVolume
ボリューム作成中
×
×
○

Active.DataErasing
データ消去実行中
○※
×
○

Active.DeletingVolume
ボリューム削除中
×
×
○

Active.DeletingVolumePre-create
作成前ボリューム削除中
×
×
○

Active.Executing
タスク実行中
○※
×
○

Active.ExternalMapping
外部接続設定処理中
○※
×
○

Active.Migrating
マイグレーション実行中
○※
×
○

Active.PathCreation
パス作成処理中
○※
×
○

Active.Re-creatingVolume
ボリューム再作成中
×
×
○

Active.VolumeCreation
ボリューム作成処理中
○※
×
○

Active.Waiting
タスク実行待ち
○※
×
○

Active.WaitingCreateVolume
ボリューム作成待ち
×
×
○

Active.WaitingDataErasure
データ消去実行待ち
○※
×
○

Active.WaitingDeleteVolume
ボリューム削除待ち
×
×
○

Active.WaitingDeleteVolumePre-create
作成前ボリューム削除待ち
×
×
○

Active.WaitingExternalMapping
外部接続設定待ち
○※
×
○

Active.WaitingMigration
マイグレーション実行待ち
○※
×
○

Active.WaitingPathCreation
パス作成待ち
○※
×
○

Active.WaitingRe-createVolume
ボリューム再作成待ち
×
×
○

Active.WaitingVolumeCreation
ボリューム作成待ち
○※
×
○

Active.WaitingZeroDataDiscard
ゼロデータ破棄待ち
○※
×
○

Active.ZeroDataDiscarding
ゼロデータ破棄実行中
○※
×
○

Cancel
終了（キャンセル）
○
○
○

End
終了
Success，Failure，Cancel，およびStopの同時指定と同義。
○
○
×

Failure
終了（失敗）
パラメーターに指定する場合，すべてのFailure状態を同時に指定したのと同義。
○
○
○

Failure.CreateVolumeFailure
終了（ボリューム作成失敗）
×
×
○

Failure.DataErasureFailure
終了（データ消去失敗）
○※
○※
○

Failure.DeleteVolumeFailure
終了（ボリューム削除失敗）
×
×
○

Failure.ExternalMappingFailure
終了（外部接続設定失敗）
○※
○※
○

Failure.MigrationFailure
終了（マイグレーション失敗）
○※
○※
○

Failure.PathCreationFailure
終了（パス作成失敗）
○※
○※
○

Failure.VolumeCreationFailure
終了（ボリューム作成失敗）
○※
○※
○

Failure.ZeroDataDiscardFailure
終了（ゼロデータ破棄失敗）
○※
○※
○

NotEnd
未終了
StandbyおよびActiveの同時指定と同義。
○
×
×

OutOfExecution
タスク実行対象外
×
×
○

Standby
待機中
○
×
○

Stop
終了（中止）
パラメーターに指定する場合，すべてのStop状態を同時に指定したのと同義。
○
○
○

Stop.DataErasureStop
データ消去中止
○※
○※
○

Stop.ExternalMappingStop
外部接続設定中止
○※
○※
○

Stop.MigrationStop
マイグレーション中止
○※
○※
○

Stop.PathCreationStop
パス作成中止
○※
○※
○

Stop.ZeroDataDiscardStop
ゼロデータ破棄中止
○※
○※
○

Stopping
中止中
○
×
○

Stopping.Immediate
即時中止中
×
×
○

Stopping.StoppingExternalMapping
外部接続設定中止中
×
×
○

Stopping.StoppingPathCreation
パス作成中止中
×
×
○

Success
終了（成功）
○
○
○

Unknown
不明
×
×
○

（凡例）

○：指定できる値，または表示される可能性のある値です。

×：指定できない値，または表示されることがない値です。

注※

"Active."，"Failure."または"Stop."を省略して，下位の状態だけでも指定できます。

6. CLIのプロパティファイル

この章では，CLIのプロパティファイルを使用したオプション，パラメーターの指定について説明します。CLIのトレースログに関するプロパティについても説明します。

この章の構成

6.1 CLIのプロパティファイルの概要

6.2 htsmcli.propertiesファイルでのオプションやパラメーターの指定

6.3 htsmclienv.propertiesファイルでのトレースログに関する指定

6.1 CLIのプロパティファイルの概要

CLI には，次に示すように2種類のプロパティファイルがあります。

CLIのオプションやパラメーターに関するプロパティ
htsmcli.properties

CLIのトレースログに関するプロパティ
htsmclienv.properties

htsmcli.propertiesファイルおよびhtsmclienv.propertiesファイルのデフォルトの格納場所を次に示します。

管理クライアントの場合

OSがWindowsのとき

＜システムドライブ＞¥TieredStorageManager¥＜Tiered Storage Managerのバージョン＞¥CLI¥

OSがSolaris，HP-UX，またはLinuxのとき

/opt/TieredStorageManager/＜Tiered Storage Managerのバージョン＞/CLI/

管理サーバの場合

OSがWindowsのとき

＜Tiered Storage Managerサーバのインストールフォルダ＞¥CLI¥

OSがSolarisまたはLinuxのとき

＜Tiered Storage Managerサーバのインストールディレクトリ＞/CLI/

htsmcli.propertiesファイルは，サンプルのプロパティファイルであり，プロパティの設定例がコメント行として記載されています。このサンプルを基に，使用するプロパティを設定してください。作成したhtsmcli.propertiesファイルは，任意のディレクトリに格納できます。htsmcli.propertiesファイルを格納したディレクトリは，環境変数HTSM_CLI_HOMEに設定する必要があります。

重要

HTSM_CLI_HOMEは，使用するhtsmcli.propertiesファイルの所在をCLIに通知するための環境変数です。htsmcli.propertiesファイルを格納したディレクトリをHTSM_CLI_HOMEに設定しておかないと，Tiered Storage Managerによってhtsmcli.propertiesファイルは使用されません。

htsmclienv.propertiesファイルには，各プロパティのデフォルト値が設定されています。htsmclienv.propertiesファイルは，格納場所を変更できません。

これらのファイルはJavaプロパティファイル形式になっています。プロパティは，テキストエディターを使って更新できます。各プロパティは，foo.bar=12345のように，イコール記号で区切られた名前と値の対で指定します。個々のプロパティは，OSによって定義される行末記号で区切られています。

CLIのプロパティファイル内では，行頭に"#" 文字を付けることで，その行は注釈と見なされます。リテラル（文字列または数値）には引用符は不要です。

Javaプロパティファイルでは，¥（backslash）記号はエスケープ文字を表す予約文字です。¥記号の直後の文字が通常の文字でなく，タブ，ラインフィードなどの制御文字であることを示すために使われます。

Windowsプラットフォームでは，一般に絶対パス名は文字¥を含むので，その文字¥の前にエスケープ文字¥を付けなければなりません。例えば，ファイルのパス名c:¥TieredStorageManager¥docroot¥foo.barは，c:¥¥TieredStorageManager¥¥docroot¥¥foo.barと入力する必要があります。プロパティの指定では，そのほかの文字には一般にエスケープ文字¥を付ける必要はありません。

CLIのプロパティの一覧を，次の表に示します。

表6-1 CLIのプロパティ一覧

ファイル名と分類
プロパティ
参照先

htsmcli.properties
（CLIのオプションやパラメーターに関するプロパティ）
htsmserver.location
「6.2.1 htsmserver.locationプロパティ」

option.username
「6.2.2 option.usernameプロパティ」

option.password
「6.2.3 option.passwordプロパティ」

option.password2
「6.2.4 option.password2プロパティ」

option.output
「6.2.5 option.outputプロパティ」

option.secure
「6.2.6 option.secureプロパティ」

parameter.パラメーター名
「6.2.7 parameter.パラメーター名プロパティ」

htsmclienv.properties
（CLIのトレースログに関するプロパティ）
logger.filePath
「6.3.1 logger.filePathプロパティ」

logger.maxFileSize
「6.3.2 logger.maxFileSizeプロパティ」

logger.fileCount
「6.3.3 logger.fileCountプロパティ」

logger.tracelogLevel
「6.3.4 logger.tracelogLevelプロパティ」

6.2 htsmcli.propertiesファイルでのオプションやパラメーターの指定

htsmcli.propertiesファイルのプロパティで，CLIコマンドを実行するときに使用するTiered Storage Managerサーバのロケーション，オプション，およびパラメーターを設定しておけます。次の表にhtsmcli.propertiesファイルのプロパティとCLIコマンドの引数の対応を示します。

表6-2 htsmcli.propertiesファイルのプロパティとCLIコマンドの引数の対応

プロパティ | CLIコマンドの引数
htsmserver.location | Tiered Storage Managerサーバのロケーション
option.username | --usernameオプション
option.password | --passwordオプション
option.password2 | 対応する引数なし
option.output | --outputオプション
option.secure | --secureオプション
parameter.パラメーター名 | 「名前」と「値」の組み合わせで指定するパラメーター

重要

htsmcli.propertiesファイルにプロパティの値を記述するとき使用できる文字で，印字できる文字は，ASCII文字およびASCII文字として認識される¥u0020～¥u007Eだけです。

htsmcli.propertiesファイルでTiered Storage Managerサーバのロケーションとオプションに値を設定する例を，次の表に示します。

表6-3 htsmcli.propertiesファイルでのプロパティの値の設定例

プロパティ | 値
htsmserver.location | rmi://myhost.mydomain:24500/HTSMServer
option.username | user01
option.password | @C:¥¥TieredStorageManager¥¥＜Tiered Storage Managerのバージョン＞¥¥CLI¥¥pass.txt
option.secure | true

これらのプロパティと値の記述例を次に示します。

htsmserver.location=rmi://myhost.mydomain:24500/HTSMServer

option.username=user01

#option.password=user01_pass
#option.password=@/home/user01/htsmclipassword

option.password=@C:¥¥TieredStorageManager¥¥＜Tiered Storage Managerのバージョン＞¥¥CLI¥¥pass.txt

option.secure=true

この節の構成

6.2.1 htsmserver.locationプロパティ

6.2.2 option.usernameプロパティ

6.2.3 option.passwordプロパティ

6.2.4 option.password2プロパティ

6.2.5 option.outputプロパティ

6.2.6 option.secureプロパティ

6.2.7 parameter.パラメーター名プロパティ

6.2.1 htsmserver.locationプロパティ

Tiered Storage Managerサーバのロケーションを設定できます。

Tiered Storage Managerサーバのロケーションの記述のしかたについては，「3.3 CLIコマンドの記述形式」を参照してください。

6.2.2 option.usernameプロパティ

Tiered Storage Managerサーバへのログイン名を設定できます。

このプロパティの値の記述のしかたについては「3.3.2 すべてのCLIコマンドに共通するオプション」の--usernameオプションの説明を参照してください。

6.2.3 option.passwordプロパティ

option.usernameプロパティに指定したユーザー名に対応するパスワードを設定できます。

このプロパティの値の記述のしかたについては「3.3.2 すべてのCLIコマンドに共通するオプション」の--passwordオプションの説明を参照してください。

パスワードを指定するには，option.passwordプロパティに平文で指定する方法と，option.password2プロパティにコード化した文字列を指定する方法があります。セキュリティを高めるため，コード化した文字列を指定することをお勧めします。パスワードをコード化する方法については，「2.3.3 プロパティファイルまたはパスワードファイルに指定するパスワードをコード化する」を参照してください。

6.2.4 option.password2プロパティ

htsmaccountコマンドを使用して，option.usernameプロパティに指定したユーザー名に対応する，コード化されたパスワードを設定できます。

パスワードをコード化する方法については，「2.3.3 プロパティファイルまたはパスワードファイルに指定するパスワードをコード化する」を参照してください。

コード化されたパスワードを記述したテキストファイルへのパスは，絶対パスまたはCLIのインストールディレクトリからの相対パスで指定できます。

プロパティファイル内に，option.passwordプロパティとoption.password2プロパティの両方が記述されている場合，option.password2プロパティが優先されます。

6.2.5 option.outputプロパティ

標準出力のリダイレクトファイルのファイル名を設定できます。

このプロパティの値の記述のしかたについては「3.3.2 すべてのCLIコマンドに共通するオプション」の--outputオプションの説明を参照してください。

6.2.6 option.secureプロパティ

Tiered Storage ManagerサーバとCLI間で，SSL通信を使用するかどうかを設定できます。

このプロパティは，CLIをインストールしたあとのデフォルトのプロパティファイルには記載されません。

SSL通信を使用する場合は，trueを指定してください。

Tiered Storage Managerサーバとの通信にSSL通信を使用する場合，Tiered Storage ManagerサーバおよびCLIを実行する管理クライアントでの環境設定が必要です。

設定方法については，マニュアル「Hitachi Command Suite Software システム構成ガイド」を参照してください。

6.2.7 parameter.パラメーター名プロパティ

コマンドのパラメーターの値を設定できます。ここで指定した値は，すべてのコマンドに適用されます。

各コマンドの，パラメーターの値の記述のしかたについては「3.3.3 パラメーターの書式」および各コマンドの詳細の項を参照してください。

6.3 htsmclienv.propertiesファイルでのトレースログに関する指定

htsmclienv.propertiesファイルのプロパティで，CLIのログ出力機能に関する各種の値を設定できます。

重要

htsmclienv.propertiesファイルに指定する文字についての注意事項を次に示します。

プロパティの値を記述するとき使用できる文字で，印字できる文字は，ASCII文字およびASCII文字として認識される¥u0020～¥u007Eだけです。

プロパティ名では，大文字と小文字は区別されます。

htsmclienv.propertiesファイルでCLIのログ出力を設定する例を，次の表に示します。

表6-4 htsmclienv.propertiesファイルでのプロパティの値の設定例

プロパティ
値

logger.tracelogLevel
20

logger.fileCount
5

logger.maxFileSize
3MB

logger.filePath
(絶対パス)
C:¥¥TieredStorageManager¥¥＜Tiered Storage Managerのバージョン＞¥¥CLI¥¥logs¥¥HTSMCLITrace
(相対パス)
logs¥¥HTSMCLITrace

これらのプロパティと値の記述例を次に示します。

logger.tracelogLevel=20

logger.fileCount=5

logger.maxFileSize=3MB

logger.filePath=C:¥¥TieredStorageManager¥¥＜Tiered Storage Managerのバージョン＞¥¥CLI¥¥logs¥¥HTSMCLITrace

参考

Solaris，HP-UX，またはLinuxで出力されるCLIトレースログファイルは，"-rw-rw-rw-"のアクセス権で出力されます。これは，スクリプトhtsmcliがumask 0で動作しているためです。

この節の構成

6.3.1 logger.filePathプロパティ

6.3.2 logger.maxFileSizeプロパティ

6.3.3 logger.fileCountプロパティ

6.3.4 logger.tracelogLevelプロパティ

6.3.1 logger.filePathプロパティ

トレースログの出力先ファイルのファイル名を設定できます。絶対パスまたはCLIのインストールディレクトリからの相対パスで指定します。指定したファイル名には，自動的に"n.log"が付けられます。ここで，nは1以上の整数であり，ログ番号を表します。

重要

指定するディレクトリ名やファイル名には，次に示す文字や名称は使用しないでください。

ディレクトリ名，ファイル名に使用できる文字としてOSが許可していない文字

OSが予約している名称

デフォルト値：

OSがWindowsの場合

<htsmCLI.jarファイルが格納されているフォルダ>¥logs¥HTSMCLITrace

OSがSolaris，HP-UX，またはLinuxの場合

<htsmCLI.jarファイルが格納されているディレクトリ>/logs/HTSMCLITrace

6.3.2 logger.maxFileSizeプロパティ

トレースログファイルの最大サイズを設定できます。キロバイト単位の場合はKB，メガバイト単位の場合はMBを指定しないと，設定した値はバイト単位であると見なされます。なお，このプロパティではKBは1,024バイト，MBは1,024KBと解釈されます。

指定できる値の範囲は，32,768バイトから2,147,483,647バイトまで（2GB未満）です。

デフォルト値：1MB

6.3.3 logger.fileCountプロパティ

CLIのログ出力機能によって出力されるトレースログファイルの最大数を設定できます。

トレースログファイルは「6.3.2 logger.maxFileSizeプロパティ」で指定されたサイズで作成され，ログ番号を付けたファイル名（例えば，HTSMCLITrace1.log，HTSMCLITrace2.log）が付けられます。ログファイルはログ番号の順に使用され，トレース情報が書き込まれます。最後のファイルがいっぱいになったら，先頭のファイルに上書きされます。

指定できる値の範囲は，2から16までです。

デフォルト値：10

6.3.4 logger.tracelogLevelプロパティ

トレースログの出力レベルのしきい値を設定できます。

CLIでは，エラー，警告，情報などのメッセージ種別に関わらず，ログ出力メッセージの内容に応じた出力レベル0，10，20，30が設定されています。このプロパティに設定した値以下の出力レベルのメッセージだけがトレースログに出力されます。

このプロパティが受け付ける値は0から30までですが，デフォルトの出力レベル20を推奨します。

デフォルト値：20

7. トラブルシューティング

この章では，CLIに問題が生じた場合の対策について説明します。

この章の構成

7.1 CLIに固有なトラブルシューティング情報

7.1 CLIに固有なトラブルシューティング情報

CLIに問題が生じた場合は，次の操作をしてください。

問題の原因が，PCまたはLANのハードウェアまたはソフトウェアではないことを確認し，PCを再起動します。

問題がTiered Storage Managerサーバで発生していないことを確認します。

CLIに固有のトラブルシューティングの詳細については，次の表を参照してください。

表7-1 CLIに固有なトラブルシューティング情報

現象
原因
推奨する対策方法

Tiered Storage Managerにログインできません。
Tiered Storage Managerサーバが見つかりません。
コマンドラインまたはプロパティで指定した，サーバのロケーションを見直し，その中のポート番号またはホストアドレスに誤りがないか確認します。

ユーザー名またはパスワードが誤っています。
コマンドラインまたはプロパティで指定した，ユーザー名またはパスワードの誤りを訂正します。

ユーザーアカウントがロックされています。
ユーザーアカウントのロックを手動で解除します。

Tiered Storage Managerの権限がありません。
ユーザー管理権限のあるユーザーでログインして，該当するユーザーにTiered Storage Managerの権限を与えます。

htsmclienv.propertiesファイルに設定したとおりに実行されません。
プロパティファイルの設定不良のため，動作できません。
出力されたエラーメッセージの「対処」に従って，プロパティファイルの設定内容を修正します。

htsmcli.propertiesファイルに設定したとおりに実行されません。
コマンドラインで直接，パラメーターを指定しています。
プロパティファイルに設定した値よりも，コマンドラインで直接指定した値の方が優先されます。コマンドラインでの指定を省略すれば，プロパティファイルに設定したとおりに実行されます。

プロパティファイルの設定不良のため，動作できません。
出力されたエラーメッセージの「対処」に従って，プロパティファイルの設定内容を修正します。

環境変数HTSM_CLI_HOMEが設定されていません。
htsmcli.propertiesファイルのあるディレクトリを環境変数HTSM_CLI_HOMEに設定します。

指定したコマンドが見つからないエラーとなりました。
java.exe（またはjava）へのパスが誤って設定されているか，指定されていません。
javaコマンドへのパスを環境変数HTSM_CLI_JRE_PATHに設定します。HTSM_CLI_JRE_PATHが指定されていない場合は，次のように設定します。

Windowsの場合：環境変数PATHにjava.exeの格納フォルダを追加します。

Solaris，HP-UX，またはLinuxの場合：環境変数PATHにjavaの格納ディレクトリを追加します。

タスクの作成日時などの，表示される時刻が，管理クライアントのCLIでの表示と，GUIでの表示，または管理サーバで実行したCLIでの表示とで異なります。
時刻の設定が，管理クライアントと管理サーバで一致していません。
Windowsの場合，日付と時刻のプロパティおよび環境変数TZの設定値を管理サーバの設定値に合わせます。
Solaris，HP-UX，またはLinuxの場合，環境変数TZの設定値を管理サーバの設定値に合わせます。

マイグレーション後，シュレッディングできません。
外部ストレージシステム側に，Storage Navigatorを使用してロックされたボリュームがあります。
外部ストレージシステム側でボリュームロックを解除してから，シュレッディングします。

マイグレーションタスクを実行してもマイグレーションできません。
外部ストレージシステム側に，Storage Navigatorを使用してロックされたボリュームがあります。
外部ストレージシステム側でボリュームロックを解除してから，マイグレーションします。

指定期間経過イベントが発生してもメール通知されません。
次の原因が考えられます。

SMTPサーバに接続されていない。

SMTP認証に失敗した。

メールアドレスに誤りがある。

メールアドレスに誤りがないか確認してください。メールアドレスが正しい場合は，SMTPサーバに接続されているか確認します。または，SMTP認証ユーザー情報を正しく設定します。

サマータイムの環境で，コマンドの実行結果に表示されるオペレーションの開始時刻と終了時刻が，サマータイム変更後の時間になりません。
マイグレーションタスク管理が保持する開始時刻と終了時刻は，管理サーバの時刻です。クライアントPCと管理サーバの時刻設定が合っていません。
クライアントPCの時刻設定をサーバのタイムゾーンに合わせます。

ロケールを日本語に設定しているのに，一部のエラーメッセージが英語で表記されます。
CLIのバージョンが，接続しているTiered Storage Managerサーバのバージョンより古くなっています。異なるバージョン間で新しく追加されたメッセージは，ロケールに関係なく英語で表示されます。
Tiered Storage Managerサーバと同じバージョンのCLIをインストールします。

-sまたは--secureを指定しているのに，SSL通信できません。
電子証明書ファイルへのパスが誤って設定されているか，指定されていません。
電子証明書ファイルのあるディレクトリとファイル名称を，環境変数HTSM_CLI_CERTS_PATHに設定します。※

Tiered Storage ManagerサーバとCLIのセキュリティレベルが，一致していません。
Tiered Storage Managerサーバのセキュリティレベルが変わった場合，再度，CLIでSSL通信用に設定する必要があります。※

指定した電子証明書ファイルの内容が不正です。
電子証明書ファイルは，Tiered Storage Managerサーバからダウンロードしたものを使用してください。※

SSLで通信するためのポートの設定に誤りがあります。
CLIコマンドで指定したポート番号が，Tiered Storage Managerサーバのserver.propertiesファイルで指定されたserver.rmi.security.portの値と一致しているか確認します。※

指定した電子証明書ファイルを読み込めません。
電子証明書ファイルにアクセス権限があるか確認します。

注※

セキュリティ通信のための設定方法については，マニュアル「Hitachi Command Suite Software システム構成ガイド」を参照してください。

付録A. 運用時の参考情報

CLIでTiered Storage Managerを運用するために，参考にできる情報について説明します。

この付録の構成

A.1 Tiered Storage Managerの動作を保証できる値

A.2 パラメーター指定値に使用できる文字の種類と文字列長

A.3 マイグレーションに関する参考情報

A.1 Tiered Storage Managerの動作を保証できる値

Tiered Storage Managerの動作が保証されるように，次の値の範囲内で，環境設定および運用することをお勧めします。

表A-1 Tiered Storage Managerの動作を保証できる値

分類 | 項目 | 保証できる値
Tuning Managerサーバ | Tiered Storage Managerと連携するTuning Managerサーバの数 | 3※1
ストレージ階層 | ストレージドメイン内のストレージ階層の数 | 100
マイグレーショングループ | ストレージドメイン内のマイグレーショングループの数 | 5,000
ボリューム | マイグレーショングループ内のボリュームの数 | 300
ストレージ階層内のボリュームの数 | 65,280※1
ストレージ階層内の未使用ボリュームの数 | 1,300※1
タスク | Tiered Storage Managerに登録されている未終了状態のタスクの数 | 100
Tiered Storage Managerに登録されているタスクの数 | 5,000
Tiered Storage Managerに登録されている全タスクに含まれるボリュームの合計（ソースボリュームとターゲットボリュームをそれぞれ1個と数える） | 30,000
サーバの実行多重度 | Tiered Storage Managerサーバへ同時にアクセスするユーザーの数 | 5※2
検索条件 | 1つの検索条件式の中での，ANDやORで結合できる条件要素の数 | 30※2
LDEVやパリティグループで検索する場合に，同時に指定できる要素の数（ControllerDeviceNumberやControllerArrayGroupでの要素の列挙数） | 100※2

注※1

最大値を示しています。これ以上は指定できません。

注※2

最大値を示しています。この最大値を超えた場合にはエラーとなります。

上記に示した値を超えた環境でTiered Storage Managerを運用すると，次の事象が発生するおそれがあります。

Tiered Storage Manager操作時の応答に著しく時間が掛かる。

Tiered Storage Managerサーバプロセス，GUIプロセス，CLIプロセス，Webブラウザなどのメモリー使用量が大幅に増加するため，メモリー不足になる。

応答に著しく時間が掛かるときにほかの操作をすると，エラーになる（KATS41055-E，KATS61005-Eなど）。

A.2 パラメーター指定値に使用できる文字の種類と文字列長

CLIコマンドのパラメーターに値を指定する場合，パラメーターによっては，使用できる文字の種類や文字列の長さに制限があります。また，空白文字および空文字列が指定できるかどうか，および，大文字小文字の区別にも違いがあるので，次の表を参照して，パラメーターに値を指定してください。

指定できる文字列の長さは，UTF-8（1文字＝1～3バイト，ASCII文字は1文字＝1バイト）で換算した長さで示しています。

表A-2 パラメーター指定値に使用できる文字の種類と文字列長

パラメーター
使用できる文字の種類と指定できる長さ

arraygroupavoidanceofmigrationgroups
newarraygroupavoidanceofmigrationgroups
75バイトまで指定できます。

使用できる文字の種類に制限があります。※

先頭と末尾に空白文字は指定できません。

空文字列は指定できません。

arraygroupselectionrule
newarraygroupselectionrule

大文字，小文字による区別はされません。

空白文字の混在はできません。

canmigrate
newcanmigrate

chargefor
newchargefor

controllerdevicenumber

controllerdisplaymodel
75バイトまで指定できます。
先頭と末尾に空白文字は指定できません。

controllername
256バイトまで指定できます。
先頭と末尾に空白文字は指定できません。

controllerserialnumber
75バイトまで指定できます。

使用できる文字の種類に制限があります。※

先頭と末尾に空白文字は指定できません。

空文字列は指定できません。

cost
newcost
先頭，末尾，および要素間の空白文字は無視されます。

cost - 金額
newcost - 金額
コンマやピリオドは使用できません。

cost - 容量の単位
newcost - 容量の単位
大文字，小文字による区別はされません。

cost - 期間の単位
newcost - 期間の単位

datetype

大文字，小文字による区別はされません。

空白文字の混在はできません。

daystobase

" + "（プラス）記号は付けられません。

-0は0として扱われます。

description
newdescription
500バイトまで指定できます。

direction

大文字，小文字による区別はされません。

空白文字の混在はできません。

dpchargefor { thpchargefor }
newdpchargefor { newthpchargefor }

dpcost { thpcost }
newdpcost { newthpcost }
先頭，末尾，および要素間の空白文字は無視されます。

dpcost { thpcost } - 金額
newdpcost { newthpcost } - 金額
コンマやピリオドは使用できません。

dpcost { thpcost } - 容量の単位
newdpcost { newthpcost } - 容量の単位
大文字，小文字による区別はされません。

dpcost { thpcost } - 期間の単位
newdpcost { newthpcost } - 期間の単位

erasedata

大文字，小文字による区別はされません。

空白文字の混在はできません。

filtercondition
newfiltercondition
4,096バイトまで指定できます。
「表4-5 ボリューム検索条件式のプロパティに指定できる値の範囲」，「表4-6 プール検索条件式のプロパティに指定できる値の範囲」，「表4-7 空き容量検索条件式のプロパティに指定できる値の範囲」，および「表4-8 検索条件式のプロパティに指定する文字の制限」を参照してください。

guardmode

大文字，小文字による区別はされません。

空白文字の混在はできません。

id
75バイトまで指定できます。

使用できる文字の種類に制限があります。※

先頭と末尾に空白文字は指定できません。

空文字列は指定できません。

immediate

大文字，小文字による区別はされません。

空白文字の混在はできません。

migrationgroupname
75バイトまで指定できます。

使用できる文字の種類に制限があります。※

先頭と末尾に空白文字は指定できません。

空文字列は指定できません。

migrationplan
使用できるファイルパスの文字や長さは，CLIを実行するOSに依存します。

movefrommigrationgroup

大文字，小文字による区別はされません。

空白文字の混在はできません。

movetomigrationgroupname
75バイトまで指定できます。

使用できる文字の種類に制限があります。※

先頭と末尾に空白文字は指定できません。

空文字列は指定できません。

name
newname
ストレージドメイン名を指定する場合です。
280バイトまで指定できます。

先頭と末尾に空白文字は指定できません。

空文字列は指定できません。

name
newname
次の名称を指定する場合です。

ストレージ階層名

マイグレーショングループ名

75バイトまで指定できます。

使用できる文字の種類に制限があります。※

先頭と末尾に空白文字は指定できません。

空文字列は指定できません。

notifytourl
newnotifytourl
メールアドレス文字列は，1バイト以上255バイトまで指定できます。
メールアドレスには，次の文字を指定できます。
A～Z
a～z
0～9
" - "（ハイフン）
" _ "（アンダースコア）
" . "（ピリオド）
"@"（アットマーク）

reminddayslater
newreminddayslater
" + "（プラス）記号は付けられません。

reminderdescription
newreminderdescription
500バイトまで指定できます。

resource
newresource

大文字，小文字による区別はされません。

空白文字の混在はできません。

retentiondays

" + "（プラス）記号は付けられません。

-0は0として扱われます。

shreddingmethod

大文字，小文字による区別はされません。

空白文字の混在はできません。

status

storagedomainname
280バイトまで指定できます。

先頭と末尾に空白文字は指定できません。

空文字列は指定できません。

storagetiername
75バイトまで指定できます。

使用できる文字の種類に制限があります。※

先頭と末尾に空白文字は指定できません。

空文字列は指定できません。

targetstoragetiername

subsystemname
384バイトまで指定できます。
先頭と末尾に空白文字は指定できません。

tasktype

大文字，小文字による区別はされません。

空白文字の混在はできません。

zerodatadiscard

（凡例）

{ }：ストレージシステムがVP9500，H24000，またはH20000のときに使用する文字列です。

注※

次の文字を使用できます。

A～Z

a～z

0～9

" - "（ハイフン）

" _ "（アンダースコア）

" . "（ピリオド）

"@"（アットマーク）

"　"（空白文字）

非ASCII文字

A.3 マイグレーションに関する参考情報

ここでは，GetVolumesコマンドを実行した時に表示されるマイグレーションできない理由を説明します。また，移動先にDPプールを，移動元にLUSEボリュームを指定してマイグレーションする場合に満たさなければならない条件について説明します。

この節の構成

A.3.1 マイグレーションできない理由

A.3.2 DPプールを対象としたマイグレーションの条件

A.3.3 LUSEボリュームを対象としたマイグレーションの条件

A.3.1 マイグレーションできない理由

GetVolumesコマンドの出力項目reason（マイグレーション不可理由）の右辺に表示される文字列と，マイグレーションできない理由としてのボリュームの状態を示します。

表示文字列の末尾に"(target)"が付いているか，付いていないかによって，ボリュームの状態が異なります。

"(target)"が付いていない：指定したボリュームは移動元にも移動先にもできないボリュームである。マイグレーションできない詳細な理由は，「表A-3 移動元にも移動先にもできないボリューム」を参照してください。

"(target)"が付いている：指定したボリュームは，移動元にはできるが，移動先にはできないボリュームである。マイグレーションできない詳細な理由は，「表A-4 移動元にはできるが移動先にはできないボリューム」を参照してください。

ただし，メインフレームシステム用のオプションプログラムによって設定されたボリュームのマイグレーション不可理由は表示されません。

表A-3 移動元にも移動先にもできないボリューム

表示される文字列
指定ボリュームの状態

Cache Residency Manager
< Cache LUN XP >
Cache Residency ManagerまたはCache Residency Manager for Mainframeが設定されています。

Command Device
Command Deviceとして使用されています。

Copy-On-Write Snapshot Status
{ XP Snapshot Status }
< Snapshot XP Status >
次のどれかに該当します。

Copy-on-Write SnapshotのペアのP-VOLであり，状態がPAIR，世代数が64である。

Copy-on-Write SnapshotのペアのP-VOLであり，状態がPAIRではない。

Copy-on-Write SnapshotのペアのV-VOLである。

Copy-on-Write SnapshotのペアのPOOLである。

Data migration that uses virtual IDs
仮想IDを用いたデータ移行に使用しているリソースグループに所属するボリュームです。

Dynamic Provisioning [Pool Volume]
{ XP Thin Provisioning [Pool Volume] }
Dynamic Provisioningのプールボリュームです。

Dynamic Provisioning [Unassigned]
{ XP Thin Provisioning [Unassigned] }
Dynamic Provisioningの仮想ボリュームで，かつプールに関連づけられていません。

Externally Locked
外部ストレージシステム接続機能を使用していて，かつ外部ストレージシステムがData Retention Utilityでロックされています（Read/Writeでない）。

In-progress data migration that uses virtual IDs
仮想IDを用いたデータ移行中のボリュームです。

Migration Reserved
マイグレーションの移動先としてすでに予約されています。
Performance Monitorでマイグレーションした対象ボリュームを含みます。

Not Acquired Volume Information
ボリュームの情報を取得できません。

Reserved
すでにDevice Managerで予約されています。

ShadowImage Configuration [Leaf]
{ Business Copy Configuration [Leaf] }
< Business Copy XP Configuration [Leaf] >
ShadowImage またはShadowImage for MainframeのS-VOLであり，SP-VOLとペアを構成しています。

ShadowImage Configuration [Node]
{ Business Copy Configuration [Node] }
< Business Copy XP Configuration [Node] >
ShadowImageまたはShadowImage for MainframeのSP-VOLであり，2つのS-VOLとペアを構成しています。

ShadowImage Configuration [Root]
{ Business Copy Configuration [Root] }
< Business Copy XP Configuration [Root] >
ShadowImageまたはShadowImage for MainframeのP-VOLであり，3つのS-VOLとペアを構成しています。

System Disk
システムドライブです。

Thin Image
{ Fast Snap }
Thin Imageで使用しているボリュームです。

TrueCopy Asynchronous Status
{ Continuous Access Asynchronous Status }
< Continuous Access XP Asynchronous Status >
次のどれかに該当します。

TrueCopy Asyncのペアを構成していて，状態がPSUSでもPSUEでもない。

TrueCopy Asynchronous for Mainframeのペアを構成していて，状態がsuspendedではない。

TrueCopy Synchronous Status
{ Continuous Access Synchronous Status }
< Continuous Access XP Synchronous Status >
次のどれかに該当します。

TrueCopy Syncのペアを構成していて，状態がPSUS，PSUE，およびPAIRのどれでもない。

TrueCopy for Mainframeのペアを構成していて，状態がsuspendedではない。

Hitachi USPで，TrueCopy Syncのペアを構成していて，状態がPAIRである。

Hitachi USPで，TrueCopy for Mainframeのペアを構成していて，状態がDuplexである。

Universal Replicator Status
{ Continuous Access Journal Status }
< Continuous Access XP Journal Status >
次のどれかに該当します。

Universal Replicatorのペアを構成していて，状態がCOPYまたはPAIRである。

Universal Replicator for Mainframeのペアを構成していて，状態がPending duplexまたはDuplexである。

Universal Replicatorのジャーナルボリュームである。

Universal Replicator for Mainframeのジャーナルボリュームである。

（凡例）

{ }：ストレージシステムがVP9500，H24000，またはH20000のときに表示される文字列です。

< >：ストレージシステムがH12000またはH10000のときに表示される文字列です。

表A-4 移動元にはできるが移動先にはできないボリューム

表示される文字列
指定ボリュームの状態

Copy-On-Write Snapshot (target)
{ XP Snapshot (target) }
< Snapshot XP (target) >
次の条件をすべて満たしています。

Copy-on-Write SnapshotのペアのP-VOLである。

状態がPAIRである。

世代数が63以下である。

Locked (target)
Data Retention Utilityでロックされています（Read/Writeでない）。

LUSE (target)
LUSEを構成しています。

Migration Group (target)
ほかのマイグレーショングループに含まれています。

NAS (target)
NASのシステムボリュームです。

Path (target)
パスが設定されています。

ShadowImage (target)
{ Business Copy (target) }
< Business Copy XP (target) >
ShadowImageまたはShadowImage for Mainframeのペアを構成しています。
「表A-3 移動元にも移動先にもできないボリューム」の"ShadowImage Configuration" { "Business Copy Configuration" } < "Business Copy XP Configuration" >で始まる表示文字列に対応する，ボリュームのどの状態にも該当しない場合に表示されます。

TrueCopy Asynchronous (target)
{ Continuous Access Asynchronous (target) }
< Continuous Access XP Asynchronous (target) >
次のどちらかに該当します。

TrueCopy Asyncのペアを構成していて，状態がPSUSまたはPSUEである。

TrueCopy Asynchronous for Mainframeのペアを構成していて，状態がsuspendedである。

TrueCopy Synchronous (target)
{ Continuous Access Synchronous (target) }
< Continuous Access XP Synchronous (target) >
次のどれかに該当します。

TrueCopy Syncのペアを構成していて，状態がPSUSまたはPSUEである。

TrueCopy for Mainframeのペアを構成していて，状態がsuspendedである。

Virtual Storage Platform，Universal Storage Platform V/VM，またはHUS VMで，TrueCopy Syncのペアを構成していて，状態がPAIRである。

Virtual Storage PlatformまたはUniversal Storage Platform V/VMで，TrueCopy for Mainframeのペアを構成していて，状態がDuplexである。

Universal Replicator (target)
{ Continuous Access Journal (target) }
< Continuous Access XP Journal (target) >
次のどちらかに該当します。

Universal Replicatorのペアを構成しているボリュームで，状態がCOPYでもPAIRでもない。

Universal Replicator for Mainframeのペアを構成しているボリュームで，状態がPending duplexでもDuplexでもない。

VOLSER (target)
VOLSERが設定されています。

（凡例）

{ }：ストレージシステムがVP9500，H24000，またはH20000のときに表示される文字列です。

< >：ストレージシステムがH12000またはH10000のときに表示される文字列です。

A.3.2 DPプールを対象としたマイグレーションの条件

Tiered Storage Managerでは，DPプールを指定してマイグレーションできます。プール検索条件を指定したストレージ階層を作成しておいてください。移動先にDPプールを指定した場合，Tiered Storage Managerは，DPプール内にDPボリュームを自動的に作成してマイグレーションします。このとき，移動先プール番号が自動的に割り当てられます。

移動先にDPプールを指定する場合は，次の条件を満たす必要があります。

移動先プールの状態が閉塞以外であること。

移動先プールに移動元ボリューム以上の空き容量があること。

移動先プールの使用率が，しきい値1としきい値2のうち，高い方のしきい値を超えていないこと。マイグレーション実行後も超えないこと。

移動先プール内のDPボリューム数が上限値（Virtual Storage Platform：63,232個，Universal Storage Platform V/VM：8,192個，HUS VM：14,080個）未満であること。

移動先プールの最大仮想化超過率が，仮想化超過警告しきい値および仮想化超過限界しきい値を超えていないこと。マイグレーション実行後も超えないこと。

移動元がDPボリュームのときは，次の条件も満たす必要があります。

移動元と移動先のDPプールが異なること。

また，移動元がDPボリュームで，マイグレーション後のデータ消去を指定した場合は，移動元ボリュームからデータが消去されたあとにDPボリュームや仮想パリティグループが削除されます。ただし，Universal Storage Platform V/VMの場合，仮想パリティグループ内のボリューム数が複数のときには，削除されるかどうかはOpen Volume Managementをインストールしているかどうかによって異なります。

Open Volume Managementをインストールしている場合：最後のDPボリュームが削除されるとき，仮想パリティグループも削除されます。

Open Volume Managementをインストールしていない場合：削除できない旨のエラーメッセージ（KATS50388-E）が出力されます。

A.3.3 LUSEボリュームを対象としたマイグレーションの条件

Tiered Storage Managerでは，LUSEボリュームを移動元に指定してマイグレーションできます。LUSEボリュームを移動元に指定した場合，次の条件を満たす必要があります。

移動先ボリュームのすべてが，内部ボリュームまたは外部ボリュームで統一されていること。

移動先ボリュームのI/O抑止モード，キャッシュモードおよびCLPRがすべて同じであること。

移動先ボリュームがDPボリュームでないこと。

また，移動元と移動先のペアを自動で作成するために，次の条件を満たしておくことをお勧めします。

移動先ボリュームが外部ボリュームのとき，すべてのボリュームが同じ外部ストレージシステム内にあること。

移動先ボリュームのすべてのRAIDレベル，ドライブタイプ，およびSLPRが同じであること。

付録B. このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報を示します。

この付録の構成

B.1 関連マニュアル

B.2 このマニュアルでの表記

B.3 このマニュアルで使用している略語

B.4 KB（キロバイト）などの単位表記について

B.1 関連マニュアル

このマニュアルの関連マニュアルを次に示します。必要に応じてお読みください。

Hitachi Command Suite Software ユーザーズガイド（3020-3-W02）

Hitachi Command Suite Software CLI リファレンスガイド（3020-3-W03）

Hitachi Command Suite Software メッセージガイド（3020-3-W05）

Hitachi Command Suite Software インストールガイド（3020-3-W07）

Hitachi Command Suite Software システム構成ガイド（3020-3-W08）

Hitachi Command Suite Software Mainframe Agent ユーザーズガイド（3020-3-W09）

B.2 このマニュアルでの表記

このマニュアルでは，製品名を次のように表記しています。

表記
製品名

Copy-on-Write Snapshot
次の製品を区別する必要がない場合の表記です。

Copy-on-Write Snapshot

Snapshot

Snapshot XP

Device Manager
Hitachi Device Manager

Dynamic Provisioning
次の製品を区別する必要がない場合の表記です。

Hitachi Dynamic Provisioning Software

Thin Provisioning Software

XP Thin Provisioning Software

Hitachi Dynamic Tiering Software

Smart Tiers Software

H10000
Hitachi Universal Storage Platform H10000

H12000
Hitachi Universal Storage Platform H12000

H20000
Hitachi Universal Storage Platform H20000

H24000
Hitachi Universal Storage Platform H24000

Hitachi AMS2000
次の製品を区別する必要がない場合の表記です。

Hitachi Adaptable Modular Storage 2000シリーズ

エントリークラスディスクアレイ装置 BR1600シリーズ

Hitachi Dynamic Provisioning
次の製品を区別する必要がない場合の表記です。

Hitachi Dynamic Provisioning Software

Thin Provisioning Software

XP Thin Provisioning Software

Hitachi Dynamic Tiering
次の製品を区別する必要がない場合の表記です。

Hitachi Dynamic Tiering Software

Smart Tiers Software

Hitachi USP
次の製品を区別する必要がない場合の表記です。

Hitachi Universal Storage Platform

Hitachi Network Storage Controller

Hitachi Universal Storage Platform H12000

Hitachi Universal Storage Platform H10000

HUS100
次の製品を区別する必要がない場合の表記です。

Hitachi Unified Storage 150

Hitachi Unified Storage 130

Hitachi Unified Storage 110

エントリークラスディスクアレイ装置 BR1650シリーズ

HUS VM
Hitachi Unified Storage VM

Linux
次の製品を区別する必要がない場合の表記です。

Linux（RHEL）

Linux（SLES）

Linux（RHEL）
Red Hat Enterprise Linux®

Linux（SLES）
SUSE Linux® Enterprise Server

ShadowImage
次の製品を区別する必要がない場合の表記です。

ShadowImage

Hitachi ShadowImage

Hitachi Multi-RAID Coupling Feature

Business Copy

Business Copy XP

MRCF-Lite制御機能

Solaris
次の製品を区別する必要がない場合の表記です。

Solaris（SPARC）

Solaris（x64）

Storage Navigator
次の製品を区別する必要がない場合の表記です。

Storage Navigator

Remote Console - Storage Navigator

Thin Image
次の製品を区別する必要がない場合の表記です。

Hitachi Thin Image

Fast Snap

Thin Provisioning
次の製品を区別する必要がない場合の表記です。

Thin Provisioning Software

XP Thin Provisioning Software

Tiered Storage Manager
Hitachi Tiered Storage Manager

TrueCopy
次の製品を区別する必要がない場合の表記です。

TrueCopy Async

TrueCopy Extended Distance

TrueCopy Sync

TrueCopy Async
次の製品を区別する必要がない場合の表記です。

TrueCopy Asynchronous

Continuous Access XP Asynchronous

Continuous Access XP Extension

TrueCopy Sync
次の製品を区別する必要がない場合の表記です。

Hitachi TrueCopy

Hitachi TrueCopy Basic

Hitachi Remote Copy

TrueCopy

日立同期リモートコピー(SRC: Synchronous Remote Copy)

Continuous Access Synchronous

Continuous Access XP Synchronous

Tuning Manager
Hitachi Tuning Manager

Universal Replicator
次の製品を区別する必要がない場合の表記です。

Universal Replicator

Continuous Access Journal

Universal Storage Platform V
次の製品を区別する必要がない場合の表記です。

Hitachi Universal Storage Platform V

Hitachi Universal Storage Platform H24000

Universal Storage Platform VM
次の製品を区別する必要がない場合の表記です。

Hitachi Universal Storage Platform VM

Hitachi Universal Storage Platform H20000

Universal Storage Platform V/VM
次の製品を区別する必要がない場合の表記です。

Hitachi Universal Storage Platform V

Hitachi Universal Storage Platform VM

Hitachi Universal Storage Platform H24000

Hitachi Universal Storage Platform H20000

Virtual Storage Platform
次の製品を区別する必要がない場合の表記です。

Hitachi Virtual Storage Platform

Hitachi Virtual Storage Platform VP9500

VP9500
Hitachi Virtual Storage Platform VP9500

B.3 このマニュアルで使用している略語

このマニュアルで使用する英略語を次に示します。

英略語 | 英字での表記
BNF | Bachus-Naur Form
CLI | command line interface
CLPR | Cache Logical Partition
CU | control unit
CVS | custom volume size
DEVN | device number
DP | Dynamic Provisioning
FC | Fibre Channel
FMD | Flash Module Drive
GUI | graphical user interface
HTTP | Hypertext Transfer Protocol
ID | identifier
IP | Internet Protocol
IPv6 | Internet Protocol version 6
ISO | International Organization for Standardization
JRE | Java Runtime Environment
LBA | logical block addressing
LDEV | logical device
LU | logical unit
LUN | logical unit number
LUSE | logical unit size expansion
MLC | multiple level cell
OS | operating system
P-VOL | primary volume
RAID | Redundant Array of Independent Disks
RMI | Remote Method Invocation
S-VOL | secondary volume
SAN | storage area network
SLC | single level cell
SLPR | Storage Logical Partition
SMI-S | Storage Management Initiative - Specification
SSD | solid-state drive
SSL | Secure Sockets Layer
THP | Thin Provisioning
UAC | User Account Control
URL | Uniform Resource Locator
V-VOL | virtual volume
VMA | Volume management area
VOLSER | Volume serial number
WWN | World Wide Name

B.4 KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

用語解説

このマニュアルで使用している用語について説明します。

（英字）

DPプール

DPプールボリューム（実ボリューム）を登録する領域です。ホストからDPボリューム（仮想ボリューム）へ書き込みがあった際に，そのデータをDPプールボリュームへ格納します。

DPプールボリューム

DPプールを構成する実ボリュームです。

DPボリューム

DPプールから作成した（DPプールと関連づけた）仮想ボリュームです。

FMD（Flash Module Drive）

フラッシュメモリーを用いた日立製のドライブ装置です。

Hitachi Dynamic Provisioning

ホストに対して仮想的なボリュームを割り当て，データの書き込み要求に応じて必要な物理容量を使用する機能です。

Hitachi Dynamic Tiering

Hitachi Dynamic Provisioningの機能に加え，I/O負荷に応じてデータを再配置する機能です。I/O負荷の高いデータ領域を高速なハードウェア階層へ，I/O負荷の低いデータ領域を低速なハードウェア階層へ配置します。

LDEV（Logical Device）

複数の物理ドライブを組み合わせて構成された，論理的なボリュームの単位です。

LDEV選択ルール

移動先を選択する際に適用するルールです。マイグレーショングループごとに設定できます。

次のルールがあります。

・共存回避ルール

・分散制御ルール

LU（Logical Unit）

ストレージシステム上の論理ユニットです。

LUSE（Logical Unit Size Expansion）

LUを統合してボリューム容量を大きくする機能です。

SMI-S enabledストレージシステム

SMI-Sプロバイダーに管理されているストレージシステムです。

（か）

仮想ボリューム

ストレージの機能で使われる，仮想のボリュームです。このマニュアルでは，次の2つを意味します。

・Copy-on-Write SnapshotまたはThin ImageのV-VOL

・DPボリューム

（き）

共存回避ルール

特定のマイグレーショングループに属しているLDEV があるパリティグループを，移動先のパリティグループとして選択 しないというルールです。

（し）

実ボリューム

物理容量を持つストレージシステムのボリュームです。このマニュアルでは，仮想ボリュームではないボリュームを意味します。

シリアル番号

ストレージシステムに割り当てられた装置識別番号です。

（す）

ストレージ階層

移動先の候補となるボリュームをグループ化したものです。CLIでは移動元としてマイグレーショングループを，移動先としてストレージ階層を指定してマイグレーションします。ストレージ階層に含めるボリュームやDP プールは，利用目的，性能，信頼性などの観点で指定できます。

（せ）

ゼロデータ破棄

DPボリュームまたはDPプールへのマイグレーションを実行したあとに，移動先DPボリューム内のゼロデータ（ホストからアクセスしていない未使用の領域）を破棄し，解放することです。未使用の領域を解放することで，DPプールの領域の消費を防げます。

Device Managerのゼロページ破棄と同様です。

（つ）

通常ボリューム

Tiered Storage Managerでは，仮想ボリュームおよびプールボリューム以外のボリュームを意味します。

（は）

パリティグループ

ストレージシステム内でRAIDを構成する物理ドライブの集まりです。

（ふ）

プール

仮想ボリュームの記憶領域です。

プールボリューム

プールを構成する実ボリュームです。

プロパティファイル

サーバ運用に必要な情報，またはCLI実行時のデフォルトオプションなどを設定するファイルです。Tiered Storage Managerサーバのプロパティファイルには，次の6つがあります。

・server.propertiesファイル

・client.propertiesファイル

・database.propertiesファイル

・devicemanager.propertiesファイル

・logger.propertiesファイル

・tuningmanager.propertiesファイル

CLIのプロパティファイルには，次の2つがあります。

・htsmcli.propertiesファイル

・htsmclienv.propertiesファイル

分散制御ルール

パリティグループの利用状況を考慮した上で移動先を選択する場合に指定するルールです。次の3つがあります。

・容量平準化：移動先として選択できるパリティグループの残容量が等しくなるように，移動先ボリューム が選定されます。

・分散最大化：できるだけ多くのパリティグループから移動先ボリュームが選定されます。

・分散最小化：できるだけ少ないパリティグループから移動先ボリュームが選定されます。

（ほ）

ホストグループ

指定されたボリュームへのI/Oを許可されたWWNのHBAを持つホストのグループです。ボリュームは，複数指定でき，ストレージのLUN Managerで管理されます。

ホストストレージドメイン

ホストグループです。このマニュアルでは，「ホストストレージドメイン」を「ホストグループ」と読み替えてください。

（ま）

マイグレーション

ストレージシステムに格納しているデータを再配置することです。アプリケーションに影響を与えることなく，データを現在の格納場所からほかの格納場所へ移動します。CLIでは移動元としてマイグレーショングループを，移動先としてストレージ階層を指定してマイグレーションします。

マイグレーショングループ

同時にマイグレーションするボリュームをグループ化したものです。CLIでは移動元としてマイグレーショングループを，移動先としてストレージ階層を指定してマイグレーションします。また，ロッキングタスク，アンロッキングタスク，シュレッディングタスクもマイグレーショングループ単位に作成します。

（ろ）

論理DKC

Virtual Storage Platform，Universal Storage Platform V/VM，またはHUS VMで，ボリュームを64K LDEV単位で管理する場合のボリュームの管理名称です。

論理DKCシリアル番号

論理DKCに割り当てられた論理的な装置識別番号です。論理DKC番号＋シリアル番号で表示されます。

論理DKC番号

論理DKCを識別するために割り当てられる番号です。

索引

[記号]
[A][C][D][E][F][G][H][J][L][M][N][O][P][R][S][T][U][W]
[あ][え][お][か][き][け][こ][さ][し][す][せ][そ][た][つ][て][と][は][ふ][へ][ほ][ま][も][ゆ][り][ろ]

(記号)

--emergencyオプション

--emergencyオプション

--executeオプション

--executeオプション

--executeオプション

--executeオプション

--forceオプション

--forceオプション

--forceオプション

--outputオプション

--passwordオプション

--passwordオプション

ログインに失敗した場合

--secureオプション

--usernameオプション

(A)

AddVolumeToMigrationGroup

(C)

CancelTask

CLI/logsフォルダ

アクセス権限

CLIコマンド

一覧

実行

書式

引数

CLIコマンドの引数

CLIコマンドの引数

オプション

コマンド名

サーバのロケーション

パラメーター

CreateLockingTask

CreateMigrationGroup

CreateMigrationPlan

CreateMigrationTask

CreateShreddingTask

CreateStorageTier

CreateUnlockingTask

(D)

DeleteMigrationGroup

DeleteStorageTier

DeleteTasks

DPプール〔用語解説〕

DPプール情報の一覧を取得

DPプールボリューム〔用語解説〕

DPボリューム〔用語解説〕

(E)

ExecuteTask

(F)

FMD〔用語解説〕

(G)

GetFreeSpaces

GetMigrationGroups

GetPools

GetStorageDomains

GetStorageTiers

GetTasks

GetVolumes

GetVolumes

マイグレーションできない理由

(H)

Hitachi Dynamic Provisioning〔用語解説〕

Hitachi Dynamic Tiering〔用語解説〕

HTSM_CLI_HOME

HTSM_CLI_HOME

HTSM_CLI_HOME

HTSM_CLI_JRE_PATH

HTSM_CLI_MEM_SIZE

htsmaccountコマンド

htsmcli.propertiesファイル

htsmclienv.propertiesファイル

htsmserver.locationプロパティ

(J)

Java

実行環境

(L)

LDEV〔用語解説〕

LDEV選択ルール〔用語解説〕

logger.fileCountプロパティ

logger.filePathプロパティ

logger.maxFileSizeプロパティ

logger.tracelogLevelプロパティ

LUSE〔用語解説〕

LU〔用語解説〕

(M)

ModifyMigrationGroup

ModifyStorageDomain

ModifyStorageTier

ModifyTask

(N)

newfiltercondition

(O)

option.outputプロパティ

option.password2プロパティ

option.passwordプロパティ

option.secureプロパティ

option.usernameプロパティ

(P)

parameter.パラメーター名プロパティ

(R)

Refresh

Refresh

リフレッシュの確認

RemoveVolumeFromMigrationGroup

(S)

SMI-S enabledストレージシステム〔用語解説〕

SMTP

SSL通信

ポート

StopTask

(T)

TZ

(U)

umask

umask

umask

HP-UX

Linux

Solaris

(W)

Windows 7

setup.bat

unsetup.bat

Windows Server 2008

setup.bat

unsetup.bat

Windows Server 2012

setup.bat

unsetup.bat

Windows Vista

4バイト文字

setup.bat

unsetup.bat

(あ)

アンセットアップ

アンセットアップ

HP-UX

Linux

Solaris

Windows

シェルスクリプト

バッチファイル

アンロッキングタスク

作成

即時実行

(え)

エラーメッセージの英語表記

(お)

オプション

共通オプション

(か)

仮想化超過警告しきい値

仮想化超過限界しきい値

仮想化超過率

仮想ボリューム〔用語解説〕

環境

Java

環境変数

htsmcli.propertiesファイル

PATH

TZ

メモリーサイズ

(き)

共存回避ルール〔用語解説〕

(け)

検索条件式

検索条件式

BNF

filterconditionパラメーター

newfilterconditionパラメーター

空き容量検索条件式に指定できるプロパティの概要

空き容量検索条件式のプロパティに指定できる値の範囲

プール検索条件式に指定できるプロパティの概要

プール検索条件式のプロパティに指定できる値の範囲

プロパティに指定する文字の制限

プロパティに指定できる値

プロパティの概要

ボリューム検索条件式に指定できるプロパティの概要

ボリューム検索条件式のプロパティに指定できる値の範囲

(こ)

候補マイグレーションプラン

記述形式

作成

コスト

期間の単位

期間の単位

金額

金額

形式

通貨コード

通貨コード

容量の単位

容量の単位

コントローラー論理デバイス番号

(さ)

サマータイム

(し)

しきい値

仮想化超過警告しきい値

仮想化超過限界しきい値

プールのしきい値1

プールのしきい値2

時刻の設定

実ボリューム〔用語解説〕

出力レベルのしきい値

シュレッディングタスク

作成

即時実行

シリアル番号〔用語解説〕

(す)

ストレージ階層

削除

作成

情報を取得

情報を変更

ストレージ階層〔用語解説〕

ストレージ階層を管理するためのコマンド

ストレージドメイン

情報を取得

情報を変更

ストレージドメインを管理するためのコマンド

(せ)

セットアップ

セットアップ

Solaris, HP-UX, Linux

Windows

セットアップファイル

要件（Solaris，HP-UX，Linux）

要件（Windows）

ゼロデータ破棄

ゼロデータ破棄〔用語解説〕

ゼロページ破棄

(そ)

即時実行

--executeオプション

アンロッキングタスク

シュレッディングタスク

マイグレーションタスク

ロッキングタスク

(た)

タスク

キャンセル

削除

作成

実行

実行

情報を取得

情報を変更

中止

タスクID

タスクを管理するためのコマンド

タスクを作成するためのコマンド

(つ)

通貨コード

通常ボリューム〔用語解説〕

(て)

データの消去

情報漏えい

(と)

ドメインコントローラーから情報を取得するためのコマンド

トラブルシューティング情報

トレースログファイル

(は)

パスワードをコード化する

パラメーター

パラメーター

指定できる文字の種類

指定できる文字列長

パリティグループ〔用語解説〕

(ふ)

プール〔用語解説〕

プールのしきい値1

プールのしきい値2

プールボリューム〔用語解説〕

プログラムプロダクト名

プロパティファイル

htsmcli.properties

htsmclienv.properties

プロパティファイル〔用語解説〕

分散制御ルール〔用語解説〕

(へ)

ヘルプ

CLI

(ほ)

ホストグループ〔用語解説〕

ホストストレージドメイン〔用語解説〕

ボリューム

シュレッディング

ロック

ロック解除

ボリューム（LU）の一覧を取得

(ま)

マイグレーション〔用語解説〕

マイグレーショングループ

削除

作成

情報を取得

情報を変更

ボリュームを加える

ボリュームを取り除く

マイグレーショングループ〔用語解説〕

マイグレーショングループを管理するためのコマンド

マイグレーションタスク

作成

作成時の注意事項

即時実行

マイグレーションボリューム予約

(も)

戻り値

(ゆ)

ユーザーアカウント制御機能

(り)

リフレッシュ処理

リポジトリー

Tiered Storage Managerのリポジトリーに登録する

(ろ)

ログ出力機能

ロケール

ロッキングタスク

作成

即時実行

論理DKC〔用語解説〕

論理DKCシリアル番号〔用語解説〕

論理DKC番号〔用語解説〕