addvdiskcopy コマンドは、コピーを既存の VDisk に追加し、それによって、ミラーリングされていない VDisk をミラーリングされる VDisk に変更します。
注: 最初の構文図は、順次モードまたはストライプ・モードの仮想ディスクの追加を表しています。
2 番目の構文図は、イメージ・モード仮想ディスクの追加を表しています。
構文
>>- svctask --addvdiskcopy--------------------------------------> >-- -mdiskgrp --+-mdisk_group_id_list---+-----------------------> '-mdisk_group_name_list-' >--+-----------------------+------------------------------------> | .-striped-. | '- -vtype --+---------+-' '-seq-----' >--+-------------------------------+----------------------------> '- -mdisk --+-mdisk_id_list---+-' '-mdisk_name_list-' >--+----------------------------------------------------------------------------------------------------------------------------+--> '- -rsize --+-disk_size-------------+--+--------------------------------------+--+---------------+--+----------------------+-' +-disk_size_percentage%-+ '- -warning -+-disk_size-------------+-' '- -autoexpand -' | .-32--. | '-auto------------------' '-disk_size_percentage%-' '- -grainsize -+-64--+-' +-128-+ '-256-' >--+-----------+--+---------------+--+-------------------+------> '- -fmtdisk-' '- -createsync -' '- -syncrate --rate-' >--+-----------------+--+- vdisk_name -+----------------------->< | .-mb-. | '- vdisk_id ---' '- -unit --+-b--+-' +-kb-+ +-gb-+ +-tb-+ '-pb-'
パラメーター
- -mdiskgrp mdisk_group_id_list | mdisk_group_name_list
- (必須) 仮想ディスクのコピーを作成するときに使用する管理対象ディスク・グループを指定します。追加しようとするコピーごとにグループを指定する必要があります。
- -vtype seq | striped | image
- (オプション) コピーのバーチャリゼーション・タイプとして順次、ストライプ、またはイメージのいずれかを指定します。これは、VDisk 上の他のコピーのバーチャリゼーション・タイプと異なるタイプでもかまいません。デフォルトのバーチャリゼーション・タイプはストライプ (striped) です。
- -mdisk mdisk_id_list | mdisk_name_list
- (オプション) 1 つ以上の管理対象ディスク (MDisk) を指定します。 順次モードおよびイメージ・モードのコピーについては、十分なフリー・エクステントのある単一 MDisk を指定する必要があります。イメージ・モード・コピーの場合、MDisk は非管理対象モードでなければなりません。 順次モード・コピーの場合、MDisk は管理対象モードでなければなりません。
- -syncrate rate
- (オプション) コピー同期速度を指定します。値ゼロ (0) を指定すると、同期化は回避されます。 デフォルト値は 50 です。サポートされる -syncrate 値および対応する速度については、表 1 を参照してください。
- -createsync
- (オプション) 新しい VDisk コピーと 1 次コピーとの同期化を抑止します。1 次コピーに障害があり、同期化されていない 2 次コピーがデータを提供する状態になっている場合に、このパラメーターを使用すると、データ破損が生じるおそれがあります。 1 次コピーに障害があり、あるデータが 1 次コピーから読み取られた後に、別のデータが 2 次コピーから読み取られた場合に、このパラメーターを使用すると、未書き込み領域で、読み取り固定が失われる可能性があります。 データ損失または読み取り固定の消失を避けるためには、このパラメーターを使用する対象は、フォーマット済みで未書き込みの、-fmtdisk パラメーターを指定した 1 次コピーに限定してください。
- -fmtdisk
- (オプション) 順次モードまたはストライプ・モードのコピーをフォーマットします。-createsync パラメーターも指定する必要があります。このパラメーターは、フォーマット済みコピーが 1 次コピーと同等であることを示すラベルを付けます。-fmtdisk パラメーターは、新しい VDisk コピーのフォーマットが完了するまで、VDisk をオフラインにします。 フォーマットの進行状況の照会には、lsvdiskprogress コマンドを使用してください。
- -rsize disk_size | disk_size_percentage% | auto
- (オプション) コピーのスペース効率を良くし、コピーの実サイズを指定します。disk_size | disk_size_percentage 値は、整数または整数とその直後に続くパーセント文字 (%) を使用して指定します。disk_size のデフォルト単位はメガバイト (MB) です。別の単位を指定するには、-unit パラメーターを使用します。 auto オプションは、MDisk のサイズ全体を使用する VDisk コピーを作成します。-rsize auto オプションを指定する場合は、-vtype image オプションも指定する必要があります。
- -warning disk_size | disk_size_percentage%
- (オプション) -rsize パラメーターも指定する必要があります。スペース効率のよいコピー上で使用されるディスク容量が、指定されたしきい値を初めて超えた時に、警告が生成されます。disk_size には整数を指定するか (-unit パラメーターが無指定の場合は、デフォルトでメガバイト (MB) 値を表します)、仮想ディスク・サイズのパーセンテージを示す disk_size% を指定することができます。-autoexpand が有効であると、-warning のデフォルト値は仮想ディスク容量の 80% になります。-autoexpand が有効でない場合は、警告に対するデフォルト値は実容量の 80% になります。警告を無効にするには、0 を指定します。
- -autoexpand
- (オプション) -rsize パラメーターも指定する必要があります。スペース効率のよいコピーが、実容量を自動的に拡張することを指定します。これを行うには、その管理対象ディスク・グループから新規エクステントを割り振ります。 -autoexpand パラメーターを指定する場合、-rsize パラメーターには、コピーによって予約される容量を指定します。これは、コピーの管理対象ディスク・グループがスペースを使用し尽したときに、まず、この予約済みスペースを消費できるようにして、コピーがオフラインになることを防ぎます。
- -grainsize 32 | 64 | 128 | 256
- (オプション) -rsize パラメーターも指定する必要があります。スペース効率のよい VDisk のグレーン・サイズ (KB) を設定します。 デフォルトは 32 KB です。
- -unit b | kb | mb | gb | tb | pb
- (オプション) -rsize および -warning パラメーターのデータ単位も指定します。
- -import
- (オプション) スペース効率のよいボリュームを含むイメージ・モード・ディスクをクラスターにインポートします。-rsize および -vtype image パラメーターも指定する必要があります。
- vdisk_name | vdisk_id
- (必須) VDisk コピーの追加先の仮想ディスクを ID または名前のいずれかで指定します。
説明
addvdiskcopy コマンドは、コピーを既存の VDisk に追加し、それによって、ミラーリングされていない VDisk をミラーリングされる VDisk に変更します。-mdiskgrp パラメーターを使用して、コピー用のストレージを提供する管理対象ディスク・グループを指定します。svcinfo lsmdiskgrp コマンドは、使用可能な管理対象ディスク・グループおよび各グループ内の使用可能なストレージの量をリストします。
バーチャリゼーション・タイプは次のように定義されます。
- 順次 (seq)
- このポリシーは、-mdisk パラメーターと、その引数としての単一管理対象ディスクを必要とします。MDisk は、管理対象モードでなければなりません。
このポリシーは、指定された管理対象ディスクからエクステントを使用して、仮想ディスクを作成します (管理対象ディスクに十分なフリー・エクステントがあることが前提)。
- ストライプ (striped)
- これはデフォルト・ポリシーです。-vtype パラメーターが指定されていない場合、このポリシーがデフォルト書式で使用されます。つまり、管理対象ディスク・グループ内のすべての管理対象ディスクが、仮想ディスクの作成に使用されます。ストライピングは、エクステント・レベルで行われ、グループ内のそれぞれの管理対象ディスクから 1 エクステントずつ使用されます。例えば、10 管理対象ディスクが存在する管理対象ディスク・グループは、それぞれの管理対象ディスクの 1 つのエクステントを使用し、次に最初の管理対象の 11 番目のエクステントを使用し ... と続きます。
-mdisk パラメーターも指定されている場合、ストライプ・セットとして使用する管理対象ディスクのリストを提供できます。 指定できるのは、同じ管理対象ディスク・グループに属する 2 つ以上の管理対象ディスクです。 ストライプ・セットで、同じ循環アルゴリズムが使用されます。 ただし、リストで、単一の管理対象ディスクを複数回指定できます。 例えば、-m 0:1:2:1 と入力した場合、管理対象ディスク 0、1、2、1、0、1、2 以下同様の順序でエクステントが使用されます。 -mdisk パラメーターに指定する MDisk はすべて、管理対象モードでなければなりません。
- イメージ (image)
- このポリシーを使用すると、管理対象ディスクに既にデータが存在するときに、場合によっては事前に仮想化されたサブシステムから、イメージ・モード仮想ディスクを作成できます。イメージ・モード仮想ディスクが作成されると、作成元の管理対象ディスク (以前は非管理) に直接対応します。したがって、仮想ディスク論理ブロック・アドレス (LBA) x は、管理対象ディスク LBA x に等しくなります。このコマンドを使用して、非仮想化ディスクをクラスターの制御下に置くことができます。クラスターの制御下に置いた後で、単一管理対象ディスクから仮想ディスクをマイグレーションすることができます。マイグレーションされると、仮想ディスクはイメージ・モード仮想ディスクではなくなります。
イメージ・モード VDisk は、他のタイプの VDisk (ストライプや順次など) が既に存在する MDisk グループに追加できます。
注: イメージ・モード・コピーは、少なくとも、追加先になっている VDisk と同じ大きさでなければなりませんが、VDisk のサイズを超える容量部分にはアクセスできません。
表 1 に、rate 値と 1 秒当たりにコピーされるデータの関係を示します。
呼び出し例
svctask addvdiskcopy -mdiskgrp 0 vdisk8
結果出力
Vdisk [8] copy [1] successfully created