chvdisk コマンドは、ディスク名、入出力グループ、入出力支配率、または装置番号などの仮想ディスクのプロパティーを変更します。
構文
>>- svctask -- -- chvdisk -- --+-------------------------+------> '- -name -- new_name_arg -' >--+---------------------------------------------+--------------> +- -iogrp --+- io_group_id ---+--+----------+-+ | '- io_group_name -' '- -force -' | '- -cache --+-readwrite-+--+----------+-------' '-none------' '- -force -' >--+--------------------------+--+--------------------------+---> '- -node --+- node_id ---+-' '- -rate -- throttle_rate -' '- node_name -' >--+-----------+--+-------------------------+-- ----------------> '- -unitmb -' '- -udid -- vdisk_udid -' >--+--------------------------------------------------+---------> '- -warning --disk_size |--disk_size_percentage--%-' >--+-------------------+--+-------------------------+-----------> '- -unit --+- b --+-' '- -autoexpand --on | off-' +- kb -+ +- mb -+ +- gb -+ +- tb -+ '- pb -' >--+--------------+--+----------------------+-------------------> '- -copy-- id -' '- -primary-- copy_id -' >--+------------------------------+--+- vdisk_name -+---------->< '- -syncrate-- percentage_arg -' '- vdisk_id ---'
パラメーター
- -name new_name_arg
- (オプション) 仮想ディスクに割り当てる新規名を指定します。 このパラメーターは、-iogrp、-rate、-node、または -udid パラメーターと一緒には使用できません。-iogrp、-rate、または -udid パラメーターを指定しない場合、このパラメーターは必須です。
- -iogrp io_group_id | io_group_name
- (オプション) 仮想ディスクの移動先となる新規入出力グループを、入出力グループ ID または入出力グループ名で指定します。
-node パラメーターと -iogrp パラメーターを一緒に使用して、指定した VDisk の優先ノードを指定することができます。注:
- VDisk がいずれかのホストにマッピングされている場合、それらのすべてのホストが新規入出力グループに関連付けられていない限りは、VDisk をその入出力グループに移動することはできません。
- ターゲット入出力グループ内のミラーリングされた VDisk に対してビットマップを割り振るためのスペースが不足している場合、このパラメーターは失敗する可能性があります。
- どのコピーも同期化されていない場合、このパラメーターは失敗することがあります。-force パラメーターを使用して、強制的に移動させることができますが、これは、VDisk の再同期を行います。
- VDisk がオフラインの場合は、いずれかの recovervdisk コマンドを使用して VDisk をリカバリーし、オンラインに戻します。SAN ボリューム・コントローラー・バージョン 4.3.1 からは、リカバリー入出力グループを使用する必要はありません。
- -cache readwrite | none
- (オプション) VDisk のキャッシング・オプションを指定します。VDisk のキャッシュを使用可能にする場合は readwrite、VDisk のキャッシュを使用不可にする場合は none が有効なエントリーです。
- -force
- (オプション) force パラメーターは、VDisk の入出力グループまたはキャッシュ・モードを変更するためにのみ使用できます。
force パラメーターを iogrp パラメーターと一緒に使用して、強制的に VDisk を入出力グループから削除します。
force パラメーターを cache パラメーターと一緒に使用して、入出力グループがオフラインの場合でも VDisk のキャッシュ・モードをシステムが変更することを指定します。
このオプションは、キャッシュ・フラッシュのメカニズムを指定変更します。重要:
- force パラメーターが VDisk のキャッシュ・モードあるいは入出力グループの変更に使用された場合は、キャッシュの内容は廃棄され、キャッシュ・データの消失によって VDisk の内容は破損します。 これは、クラスターがすべての書き込みデータをキャッシュからデステージできるかどうかによって発生する可能性があります。 force パラメーターは注意して使用する必要があります。
- force パラメーターを使用して、非同期コピーがある VDisk を移動する場合は、完全再同期が必要です。
- -rate throttle_rate [-unitmb]
- (オプション) VDisk の入出力支配率を指定します。これは、受け入れられる入出力の量を制限します。デフォルトの throttle_rate の単位は入出力数です。throttle_rate の単位を 1 秒当たりメガバイト数 (MBps) に変更するには、-unitmb パラメーターを指定します。 仮想ディスクの支配率は入出力数か MBps で指定できますが、両方を使用することはできません。ただし、一部の仮想ディスクについては入出力数で率を設定し、その他の仮想ディスクについては MBps で設定することができます。
このパラメーターは、-name、-iogrp、-node、または -udid パラメーターと一緒には使用できません。
- -udid vdisk_udid
- (オプション) ディスクの装置番号 (udid) を指定します。vdisk_udid は、OpenVMS ホストをサポートするために必要な ID で、他のシステムではこのパラメーターは使用しません。有効なオプションは、10 進数の 0 から 32 767、または 16 進数の 0 から 0x7FFF です。16 進数の場合、必ず 0x を前に付ける必要があります (例: 0x1234)。-udid パラメーターを使用しない場合、デフォルトの udid は 0 です。
このパラメーターは、-name、-iogrp、-node、または-rate パラメーターと一緒には使用できません。
- -warning disk_size | disk_size_percentage%
- (オプション) スペース効率のよいコピー内の使用済みディスク容量が、指定されたしきい値を初めて超えた時に、警告が出されます。disk_size には整数を指定するか (-unit パラメーターを指定しない場合は、デフォルトで MB 値を表します)、仮想ディスク・サイズのパーセンテージを示す disk_size% を指定することができます。警告を無効にするには、0 または 0% を指定します。
- -unit b | kb | mb | gb | tb | pb
- (オプション) -warning disk_size パラメーターに対して使用するデータ単位を指定します。
- -autoexpand on | off
- (オプション) スペース効率のよい VDisk コピーが、その管理対象ディスク・グループから新規エクステントを割り振ることによって、実容量を自動的に拡張するかどうかを指定します。 このパラメーターを使用する対象は、スペース効率のよい VDisk である必要があります。
- -copy id
- (オプション) 変更を適用するコピーを指定します。このパラメーターは、-autoexpand または -warning パラメーターと一緒に指定する必要があります。 指定された VDisk がミラーリングされており、スペース効率のよい VDisk コピーが 1 つしかない場合は、-copy パラメーターが必要です。 両方のコピーが「スペース効率がよい」場合で、かつ、-copy パラメーターが無指定の場合、指定した -autoexpand または -warning パラメーターが両方のコピーに対して設定されます。
- -primary copy_id
- (オプション) 1 次コピーを指定します。1 次コピーの変更が有効なのは、新規 1 次コピーがオンライン状態で、同期化されている場合に限定されます。新規 1 次コピーがオンラインで、同期化されている場合に、このコマンドを発行すると、即時に変更が有効になります。
- -syncrate percentage
- (オプション) コピーの同期速度をピーク時の同期速度のパーセンテージで指定します。値ゼロ (0) を指定すると、同期化は回避されます。
- -node node_id | node_name
- (オプション) 指定した VDisk の優先ノードを指定します。このパラメーターを使用するときは、-iogrp パラメーターも指定する必要があります。 このパラメーターは、-name、-rate、または -udid パラメーターと一緒には使用できません。
- vdisk_name | vdisk_id
- (必須) 変更する仮想ディスクを ID または名前で指定します。
説明
chvdisk コマンドは、仮想ディスク (VDisk) の単一プロパティーを変更します。例えば、VDisk の名前と入出力グループを変更する場合は、このコマンドを 2 回発行する必要があります。
新規の名前またはラベルを指定できます。変更後すぐに、その新規名を使用して仮想ディスクを参照できます。 VDisk の優先ノードを指定するには、-node node_id | node_name パラメーターを使用します。
この仮想ディスクを関連付ける入出力グループを変更できます。 ただし、入出力グループを変更する場合は、最初に現行の入出力グループ内のノードのキャッシュをフラッシュして、すべてのデータをディスクに書き込む必要があります。 この操作を行う前に、ホスト・レベルでの入出力操作が中断していることを確認してください。
- どのような場合でも、オフラインの入出力グループには VDisk を移動しないでください。 データ損失を回避するため、VDisk を移動する前に入出力グループがオンラインであることを確認する必要があります。
- オフラインの VDisk をリカバリー入出力グループに移動してはなりません。SAN ボリューム・コントローラー・バージョン 4.3.1 からは、リカバリー入出力グループを使用する必要はありません。その代わりに、いずれかの recovervdisk コマンドを使用して VDisk をリカバリーし、オンラインに戻します。
この仮想ディスクに関して受け入れる入出力トランザクションの量に限度を設定することができます。 この量は、1 秒当たりの入出力数、または MB/秒で設定できます。デフォルトでは、仮想ディスクの作成時に入出力制御率は設定されません。
仮想ディスクが作成されたとき、適用されるスロットルはありません。 -rate パラメーターを指定すると、これを変更できます。 仮想ディスクを非スロットル状態に戻すには、-rate パラメーターで 0 (ゼロ) を指定します。
VDisk を新しい入出力グループにマイグレーションして、クラスター内のノード全体に手動でワークロードのバランスを取ることができます。 ただし、1 対のノードのワークロードが過剰になり、もう一方の対のワークロードが過小になることがあります。 以下の手順で、単一の VDisk を新しい入出力グループにマイグレーションしてください。 他の VDisk についても、必要に応じて同じ手順を繰り返します。
VDisk を新規入出力グループにマイグレーションする場合は、その VDisk の入出力操作をすべて静止してください。 この VDisk を使用するホストを判別します。 この VDisk を使用するすべての FlashCopy® マッピング、またはメトロ・ミラー関係あるいはグローバル・ミラー関係を停止し、削除します。 VDisk が関係またはマッピングの一部であるかどうかを確認するには、svcinfo lsvdisk vdiskname | id コマンドを発行します。ここで、vdiskname | id は VDisk の名前または ID です。
svctask chvdisk -iogrp newiogrpname|id vdiskname|id
手順に従って、新しい vpath を発見し、各 vpath が正しいパス数を示していることを確認します。 ホストのオペレーティング・システムに関連して、SDD を動的に再構成する方法については、「マルチパス・サブシステム・デバイス・ドライバー (SDD)」資料を参照してください。呼び出し例
svctask chvdisk -rate 2040 -unitmb 6
結果出力
No feedback