Diskraid は、独立した (または安価な) ディスクの冗長アレイ (RAID) ストレージ サブシステムを構成および管理できるコマンド ライン ツールです。
RAID は通常、フォールト トレラント ディスク システムを標準化および分類するためにサーバーで使用されます。 RAID レベルは、パフォーマンス、信頼性、コストのさまざまな組み合わせを提供します。 一部のサーバーでは、レベル 0 (ストライピング)、レベル 1 (ミラーリング)、レベル 5 (パリティを使用したストライピング) の 3 つの RAID レベルが提供されます。
ハードウェア RAID サブシステムは、論理ユニット番号 (LUN) を使用して、物理的にアドレス指定可能な記憶域ユニットを区別します。 LUN オブジェクトには少なくとも 1 つのプレックスが必要であり、任意の数の追加のプレックスを持つことができます。 各プレックスには、LUN オブジェクト上のデータのコピーが含まれています。 LUN オブジェクトに対してプレックスを追加したり、LUN オブジェクトから削除したりすることができます。
ほとんどの Diskraid コマンドは、特定のホスト バス アダプター (HBA) ポート、イニシエーター アダプター、イニシエーター ポータル、プロバイダー、サブシステム、コントローラー、ポート、ドライブ、LUN、ターゲット ポータル、ターゲット ポータル グループで動作します。 SELECT[選択]コマンドを使用して、オブジェクトを選択します。 選択したオブジェクトにはフォーカスがあると言われます。 フォーカスを使用すると、同じサブシステム内に複数の LUN を作成するなど、一般的な構成タスクが簡略化されます。
Note
Diskraid コマンド ライン ツールは、仮想ディスク サービス (VDS) をサポートするストレージ サブシステムでのみ機能します。
Diskraid commands
Diskraid ツール内から次のコマンドを使用できます。
add
現在選択されている LUN に既存の LUN を追加するか、現在選択されている iSCSI ターゲット ポータル グループに iSCSI ターゲット ポータルを追加します。
Syntax
add plex lun=n [noerr]
add tpgroup tportal=n [noerr]
Parameters
| Parameter | Description |
|---|---|
プレックスLUN=<n> |
現在選択されている LUN にプレックスとして追加する LUN 番号を指定します。 注意: プレックスとして追加されている LUN 上のすべてのデータは削除されます。 |
tpgroup tportal=<n> |
現在選択されている iSCSI ターゲット ポータル グループに追加する iSCSI ターゲット ポータル番号を指定します。 |
| noerr | スクリプトの場合のみ。 エラーが発生した場合、Diskraid はエラーが発生しなかったかのようにコマンドを処理し続けます。 |
associate
現在選択されている LUN に対して、指定したコントローラー ポートの一覧をアクティブとして設定するか (他のコントローラー ポートは非アクティブになります)、現在選択されている LUN の既存のアクティブなコントローラー ポートの一覧に指定したコントローラー ポートを追加するか、現在選択されている LUN の指定した iSCSI ターゲットを関連付けます。
Syntax
associate controllers [add] <n>[,<n> [,…]]
associate ports [add] <n-m>[,<n-m>[,…]]
associate targets [add] <n>[,<n> [,…]]
Parameters
| Parameter | Description |
|---|---|
| コントローラ | 現在選択されている LUN に関連付けられているコントローラーの一覧を追加または置換します。 VDS 1.0 プロバイダーでのみ使用します。 |
| ports | 現在選択されている LUN に関連付けられているコントローラー ポートの一覧を追加または置換します。 VDS 1.1 プロバイダーでのみ使用します。 |
| targets | 現在選択されている LUN に関連付けられている iSCSI ターゲットの一覧を追加または置換します。 VDS 1.1 プロバイダーでのみ使用します。 |
| add |
VDS 1.0 プロバイダーを使用している場合: LUN に関連付けられているコントローラーの既存のリストに指定したコントローラーを追加します。 このパラメーターを指定しない場合、コントローラーのリストは、この LUN に関連付けられているコントローラーの既存のリストを置き換えます。 VDS 1.1 プロバイダーを使用している場合: LUN に関連付けられているコントローラー ポートの既存の一覧に、指定したコントローラー ポートを追加します。 このパラメーターが指定されていない場合、コントローラー ポートの一覧は、この LUN に関連付けられているコントローラー ポートの既存の一覧に置き換えられます。 |
<n>[,<n> [, ...]] |
controllersまたはtargetsパラメータと一緒に使用します。 アクティブまたは関連付けるコントローラーまたは iSCSI ターゲットの数を指定します。 |
<n-m>[,<n-m>[,…]] |
ports パラメーターとともに使用します。 コントローラ番号(n)とポート番号(m)のペアを使用してアクティブに設定するコントローラポートを指定します。 |
Example
VDS 1.1 プロバイダーを使用する LUN にポートを関連付けて追加するには:
DISKRAID> SEL LUN 5
LUN 5 is now the selected LUN.
DISKRAID> ASSOCIATE PORTS 0-0,0-1
Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 0, Ctlr 0 Port 1)
DISKRAID> ASSOCIATE PORTS ADD 1-1
Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 0, Ctlr 0 Port 1, Ctlr 1 Port 1)
automagic
LUN の構成方法に関するヒントをプロバイダーに提供するフラグを設定またはクリアします。 パラメータなしで使用すると、 自動操作 はフラグのリストを表示します。
Syntax
automagic {set | clear | apply} all <flag=value> [<flag=value> [...]]
Parameters
| Parameter | Description |
|---|---|
| set | 指定したフラグを指定した値に設定します。 |
| クリア | 指定したフラグをクリアします。 all キーワードは、すべての自動魔法フラグをクリアします。 |
| 適用する | 選択した LUN に現在のフラグを適用します。 |
<flag> |
フラグは、次のような 3 文字の頭字語で識別されます。
|
中断
現在選択されている LUN からプレックスを削除します。 含まれているプレックスとデータは保持されず、ドライブ・エクステントが再利用される可能性があります。
Caution
このコマンドを使用する前に、まずミラー化された LUN を選択する必要があります。 プレックス上のすべてのデータが削除されます。 元の LUN に含まれるすべてのデータが一貫性を持つとは限りません。
Syntax
break plex=<plex_number> [noerr]
Parameters
| Parameter | Description |
|---|---|
| plex | 削除するプレックスの数を指定します。 plex とそれに含まれるデータは保持されず、このプレックスで使用されるリソースは再利用されます。 LUN に含まれるデータの整合性は保証されません。 このプレックスを保持する場合は、ボリューム シャドウ コピー サービス (VSS) を使用します。 |
| noerr | スクリプトの場合のみ。 エラーが発生した場合、Diskraid はエラーが発生しなかったかのようにコマンドを処理し続けます。 |
chap
iSCSI イニシエーターと iSCSI ターゲットが相互に通信できるように、チャレンジ ハンドシェイク認証プロトコル (CHAP) 共有シークレットを設定します。
Syntax
chap initiator set secret=[<secret>] [target=<target>]
chap initiator remember secret=[<secret>] target=<target>
chap target set secret=[<secret>] [initiator=<initiatorname>]
chap target remember secret=[<secret>] initiator=<initiatorname>
Parameters
| Parameter | Description |
|---|---|
| initiator set | イニシエーターがターゲットを認証するときに相互 CHAP 認証に使用されるローカル iSCSI イニシエーター サービスの共有シークレットを設定します。 |
| initiator remember | iSCSI ターゲットの CHAP シークレットをローカル iSCSI イニシエーター サービスに通信して、イニシエーター サービスが CHAP 認証中にターゲットに対して自身を認証するためにシークレットを使用できるようにします。 |
| target set | ターゲットがイニシエーターを認証するときに CHAP 認証に使用されている、現在選択されている iSCSI ターゲットの共有シークレットを設定します。 |
| target remember | iSCSI イニシエーターの CHAP シークレットを現在のフォーカス内の iSCSI ターゲットに通信して、ターゲットが相互 CHAP 認証中にイニシエーターに対して自身を認証するためにシークレットを使用できるようにします。 |
| シークレット | 使用するシークレットを指定します。 空の場合、シークレットはクリアされます。 |
| ターゲット | シークレットに関連付ける現在選択されているサブシステム内のターゲットを指定します。 これは、イニシエーターにシークレットを設定するときに省略可能で、シークレットを残しておくと、シークレットがまだ関連付けられていないすべてのターゲットに使用されることを示します。 |
| initiatorname | シークレットに関連付けるイニシエーター iSCSI 名を指定します。 これは、ターゲットにシークレットを設定するときに省略可能であり、シークレットを残しておくと、シークレットがまだ関連付けられていないすべてのイニシエーターに使用されることを示します。 |
作成する
現在選択されているサブシステムに新しい LUN または iSCSI ターゲットを作成するか、現在選択されているターゲットにターゲット ポータル グループを作成します。 実際のバインディングは、 Diskraid list コマンドを使用して表示できます。
Syntax
create lun simple [size=<n>] [drives=<n>] [noerr]
create lun stripe [size=<n>] [drives=<n, n> [,...]] [stripesize=<n>] [noerr]
create lun raid [size=<n>] [drives=<n, n> [,...]] [stripesize=<n>] [noerr]
create lun mirror [size=<n>] [drives=<n, n> [,...]] [stripesize=<n>] [noerr]
create lun automagic size=<n> [noerr]
create target name=<name> [iscsiname=<iscsiname>] [noerr]
create tpgroup [noerr]
Parameters
| Parameter | Description |
|---|---|
| simple | 単純な LUN を作成します。 |
| stripe | ストライプ LUN を作成します。 |
| raid | パリティを持つストライプ LUN を作成します。 |
| mirror | ミラー化された LUN を作成します。 |
| automagic | 現在有効な オートマジック ・ヒントを使用してLUNを作成します。 詳細については、この記事の automagic サブコマンドを参照してください。 |
| size= | LUN の合計サイズをメガバイト単位で指定します。
size= または drives= パラメーターを指定する必要があります。 これらは一緒に使用することもできます。
size= パラメーターが指定されていない場合、作成される LUN は、指定されたすべてのドライブで許可される最大サイズになります。 プロバイダーは通常、少なくとも要求されたサイズと同じ大きさの LUN を作成しますが、場合によってはプロバイダーが次の最大サイズに切り上げる必要がある場合があります。 たとえば、サイズが .99 GB として指定されていて、プロバイダーが GB ディスク エクステントのみを割り当てることができる場合、結果の LUN は 1 GB になります。 他の単位を使用してサイズを指定するには、サイズの直後に次の認識されるサフィックスのいずれかを使用します。
|
| drives= | LUNの作成に使用するドライブの drive_number を指定します。 size= または drives= パラメーターを指定する必要があります。 これらは一緒に使用することもできます。 size= パラメータが指定されていない場合、作成される LUN は、指定されたすべてのドライブで許容される最大サイズになります。 size= パラメーターを指定すると、プロバイダーは指定されたドライブ リストからドライブを選択して LUN を作成します。 プロバイダーは、可能な限り指定された順序でドライブの使用を試みます。 |
| stripesize= |
ストライプまたはraid LUNのサイズをメガバイト単位で指定します。 LUN の作成後にストライプサイズを変更することはできません。 他の単位を使用してサイズを指定するには、サイズの直後に次の認識されるサフィックスのいずれかを使用します。
|
| ターゲット | 現在選択されているサブシステムに新しい iSCSI ターゲットを作成します。 |
| name | ターゲットのフレンドリ名を指定します。 |
| iscsiname | ターゲットの iSCSI 名を指定し、プロバイダーに名前を生成させるために省略できます。 |
| tpgroup | 現在選択されているターゲットに新しい iSCSI ターゲット ポータル グループを作成します。 |
| noerr | スクリプトの場合のみ。 エラーが発生した場合、Diskraid はエラーが発生しなかったかのようにコマンドを処理し続けます。 |
削除する
現在選択されている LUN、iSCSI ターゲット (iSCSI ターゲットに関連付けられている LUN がない限り) または iSCSI ターゲット ポータル グループを削除します。
Syntax
delete lun [uninstall] [noerr]
delete target [noerr]
delete tpgroup [noerr]
Parameters
| Parameter | Description |
|---|---|
| lun | 現在選択されている LUN とその上のすべてのデータを削除します。 |
| アンインストール | LUN が削除される前に、LUN に関連付けられているローカル システム上のディスクをクリーンアップすることを指定します。 |
| ターゲット | ターゲットに LUN が関連付けられていない場合は、現在選択されている iSCSI ターゲットを削除します。 |
| tpgroup | 現在選択されている iSCSI ターゲット ポータル グループを削除します。 |
| noerr | スクリプトの場合のみ。 エラーが発生した場合、Diskraid はエラーが発生しなかったかのようにコマンドを処理し続けます。 |
detail
指定した型の現在選択されているオブジェクトに関する詳細情報を表示します。
Syntax
detail {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup} [verbose]
Parameters
| Parameter | Description |
|---|---|
| hbaport | 現在選択されているホスト バス アダプター (HBA) ポートに関する詳細情報を一覧表示します。 |
| iadapter | 現在選択されている iSCSI イニシエーター アダプターに関する詳細情報を一覧表示します。 |
| iportal | 現在選択されている iSCSI イニシエーター ポータルに関する詳細情報を一覧表示します。 |
| プロバイダ | 現在選択されているプロバイダーに関する詳細情報を一覧表示します。 |
| サブシステム | 現在選択されているサブシステムに関する詳細情報を一覧表示します。 |
| コントローラ | 現在選択されているコントローラーに関する詳細情報を一覧表示します。 |
| ポート | 現在選択されているコントローラー ポートに関する詳細情報を一覧表示します。 |
| drive | 現在選択されているドライブに関する詳細情報 (占有 LUN を含む) を一覧表示します。 |
| lun | 現在選択されている LUN に関する詳細情報 (貢献するドライブを含む) を一覧表示します。 出力は、LUN がファイバー チャネルサブシステムと iSCSI サブシステムのどちらに含まれているかによって若干異なります。 マスクされていないホストの一覧にアスタリスクのみが含まれている場合は、LUN がすべてのホストにマスク解除されていることを意味します。 |
| tportal | 現在選択されている iSCSI ターゲット ポータルに関する詳細情報を一覧表示します。 |
| ターゲット | 現在選択されている iSCSI ターゲットに関する詳細情報を一覧表示します。 |
| tpgroup | 現在選択されている iSCSI ターゲット ポータル グループに関する詳細情報を一覧表示します。 |
| 詳細 | LUN パラメーターでのみ使用します。 そのプレックスを含む追加情報を一覧表示します。 |
dissociate
現在選択されている LUN に対して、指定したコントローラー ポートの一覧を非アクティブとして設定するか (他のコントローラー ポートは影響を受けず)、現在選択されている LUN の iSCSI ターゲットの指定されたリストの関連付けを解除します。
Syntax
dissociate controllers <n> [,<n> [,...]]
dissociate ports <n-m>[,<n-m>[,…]]
dissociate targets <n> [,<n> [,…]]
Parameter
| Parameter | Description |
|---|---|
| controllers | 現在選択されている LUN に関連付けられているコントローラーの一覧からコントローラーを削除します。 VDS 1.0 プロバイダーでのみ使用します。 |
| ports | 現在選択されている LUN に関連付けられているコントローラー ポートの一覧からコントローラー ポートを削除します。 VDS 1.1 プロバイダーでのみ使用します。 |
| targets | 現在選択されている LUN に関連付けられている iSCSI ターゲットの一覧からターゲットを削除します。 VDS 1.1 プロバイダーでのみ使用します。 |
<n> [,<n> [,…]] |
controllers または targets パラメータで使用します。 非アクティブまたは関連付け解除として設定するコントローラーまたは iSCSI ターゲットの数を指定します。 |
<n-m>[,<n-m>[,…]] |
ports パラメータで使用します。 コントローラ番号(n)とポート番号(m)のペアを使用して、非アクティブとして設定するコントローラポートを指定します。 |
Example
DISKRAID> SEL LUN 5
LUN 5 is now the selected LUN.
DISKRAID> ASSOCIATE PORTS 0-0,0-1
Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 0, Ctlr 0 Port 1)
DISKRAID> ASSOCIATE PORTS ADD 1-1
Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 0, Ctlr 0 Port 1, Ctlr 1 Port 1)
DISKRAID> DISSOCIATE PORTS 0-0,1-1
Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 1)
終了する
Exits Diskraid.
Syntax
exit
extend
LUN の末尾にセクターを追加して、現在選択されている LUN を拡張します。 すべてのプロバイダーが LUN の拡張をサポートしているわけではありません。 LUN に含まれるボリュームまたはファイル システムを拡張しません。 LUNを拡張した後、 DiskPart extend コマンドを使用して、関連するディスク上の構造を拡張する必要があります。
Syntax
extend lun [size=<LUN_size>] [drives=<drive_number>, [<drive_number>, ...]] [noerr]
Parameters
| Parameter | Description |
|---|---|
| size | LUN を拡張するサイズをメガバイト単位で指定します。
size または <drive> パラメーターを指定する必要があります。 これらは一緒に使用することもできます。
size= パラメーターが指定されていない場合、LUN は、指定されたすべてのドライブで許容される最大サイズだけ拡張されます。
size= パラメーターを指定すると、プロバイダーは drive= パラメーターで指定されたリストからドライブを選択して LUN を作成します。 他の単位を使用してサイズを指定するには、サイズの直後に次の認識されるサフィックスのいずれかを使用します。
|
| drives= | LUN の作成時に使用するドライブの <drive_number> を指定します。
size または <drive> パラメーターを指定する必要があります。 これらは一緒に使用することもできます。
size= パラメータが指定されていない場合、作成される LUN は、指定されたすべてのドライブで許容される最大サイズになります。 プロバイダーは、可能な限り指定された順序でドライブを使用します。 |
| noerr | スクリプトの場合のみ。 エラーが発生した場合、Diskraid はエラーが発生しなかったかのようにコマンドを処理し続けます。 |
flushcache
現在選択されているコントローラーのキャッシュをクリアします。
Syntax
flushcache controller
help
すべての Diskraid コマンドの一覧を表示します。
Syntax
help
importtarget
現在選択されているサブシステムに設定されている現在のボリューム シャドウ コピー サービス (VSS) インポート ターゲットを取得または設定します。
Syntax
importtarget subsystem [set target]
Parameter
| Parameter | Description |
|---|---|
| set target | 指定した場合、現在選択されているターゲットを、現在選択されているサブシステムの VSS インポート ターゲットに設定します。 指定しない場合、コマンドは、現在選択されているサブシステムに設定されている現在の VSS インポート ターゲットを取得します。 |
イニシエータ
ローカル iSCSI イニシエーターに関する情報を取得します。
Syntax
initiator
invalidatecache
現在選択されているコントローラーのキャッシュを無効にします。
Syntax
invalidatecache controller
lbpolicy
現在選択されている LUN の負荷分散ポリシーを設定します。
Syntax
lbpolicy set lun type=<type> [paths=<path>-{primary | <weight>}[,<path>-{primary | <weight>}[,…]]]
lbpolicy set lun paths=<path>-{primary | <weight>}[,<path>-{primary | <weight>}[,…]]
Parameters
| Parameter | Description |
|---|---|
| 型 | 負荷分散ポリシーを指定します。 タイプが指定されていない場合は、 パス パラメータを指定する必要があります。 Type は次のいずれかになります。
|
| パス | パスが プライマリ であるか、特定の <weight>があるかを指定します。 指定されていないパスはすべて、バックアップとして暗黙的に設定されます。 表示されるパスは、現在選択されている LUN のパスのいずれかである必要があります。 |
list
指定した型のオブジェクトの一覧を表示します。
Syntax
list {hbaports | iadapters | iportals | providers | subsystems | controllers | ports | drives | LUNs | tportals | targets | tpgroups}
Parameters
| Parameter | Description |
|---|---|
| hbaports | VDS に認識されているすべての HBA ポートに関する概要情報を一覧表示します。 現在選択されている HBA ポートは、アスタリスク (*) でマークされます。 |
| iadapters | VDS に認識されているすべての iSCSI イニシエーター アダプターに関する概要情報を一覧表示します。 現在選択されているイニシエーター アダプターは、アスタリスク (*) でマークされます。 |
| iportals | 現在選択されているイニシエーター アダプター内のすべての iSCSI イニシエーター ポータルに関する概要情報を一覧表示します。 現在選択されているイニシエーター ポータルには、アスタリスク (*) が付いています。 |
| providers | VDS に認識されている各プロバイダーに関する概要情報を一覧表示します。 現在選択されているプロバイダーは、アスタリスク (*) でマークされます。 |
| subsystems | システム内の各サブシステムに関する概要情報を一覧表示します。 現在選択されているサブシステムは、アスタリスク (*) でマークされます。 |
| controllers | 現在選択されているサブシステム内の各コントローラーに関する概要情報を一覧表示します。 現在選択されているコントローラーは、アスタリスク (*) でマークされます。 |
| ports | 現在選択されているコントローラーの各コントローラー ポートに関する概要情報を一覧表示します。 現在選択されているポートはアスタリスク (*) でマークされます。 |
| drives | 現在選択されているサブシステム内の各ドライブに関する概要情報を一覧表示します。 現在選択されているドライブにはアスタリスク (*) が付いています。 |
| luns | 現在選択されているサブシステムの各 LUN に関する概要情報を一覧表示します。 現在選択されている LUN はアスタリスク (*) でマークされます。 |
| tportals | 現在選択されているサブシステム内のすべての iSCSI ターゲット ポータルに関する概要情報を一覧表示します。 現在選択されているターゲット ポータルにはアスタリスク (*) が付いています。 |
| targets | 現在選択されているサブシステム内のすべての iSCSI ターゲットに関する概要情報を一覧表示します。 現在選択されているターゲットはアスタリスク (*) でマークされます。 |
| tpgroups | 現在選択されているターゲット内のすべての iSCSI ターゲット ポータル グループに関する概要情報を一覧表示します。 現在選択されているポータル グループにはアスタリスク (*) が付いています。 |
login
指定した iSCSI イニシエーター アダプターを、現在選択されている iSCSI ターゲットに記録します。
Syntax
login target iadapter=<iadapter> [type={manual | persistent | boot}] [chap={none | oneway | mutual}] [iportal=<iportal>] [tportal=<tportal>] [<flag> [<flag> […]]]
Parameters
| Parameter | Description |
|---|---|
| 型 | 実行するログインのタイプ( 手動 または 永続的)を指定します。 指定しない場合は、手動ログインが実行されます。 |
| manual | Login manually. 将来の開発を意図したブ ート オプションもあり、現在は使用されていません。 |
| persistent | コンピューターの再起動時に同じログインを自動的に使用します。 |
| chap | 使用する CHAP 認証のタイプ ( none、 oneway CHAP、または 相互 CHAP) を指定します。指定しない場合、認証は使用されません。 |
| tportal | 現在選択されているサブシステムで、ログインに使用するオプションのターゲット ポータルを指定します。 |
| iportal | 指定したイニシエーター アダプターで、ログインに使用するオプションのイニシエーター ポータルを指定します。 |
<flag> |
3 文字の頭字語で識別されます。
|
logout
現在選択されている iSCSI ターゲットから、指定した iSCSI イニシエーター アダプターをログに記録します。
Syntax
logout target iadapter= <iadapter>
Parameters
| Parameter | Description |
|---|---|
| iadapter | ログアウトするログイン セッションを含むイニシエーター アダプターを指定します。 |
メンテナンス
指定した型の現在選択されているオブジェクトに対してメンテナンス操作を実行します。
Syntax
maintenance <object operation> [count=<iteration>]
Parameters
| Parameter | Description |
|---|---|
<object> |
操作を実行するオブジェクトの種類を指定します。 オブジェクト・タイプは、サブシステム、コントローラ、ポート、ドライブ、または LUN です。 |
<operation> |
実行するメンテナンス操作を指定します。 操作タイプは、スピンアップ、スピンダウン、点滅、ビープ音、またはpingです。 操作を指定する必要があります。 |
| count= | 操作を繰り返す回数を指定します。 これは通常、 点滅、 ビープ音、または ping とともに使用されます。 |
name
現在選択されているサブシステム、LUN、または iSCSI ターゲットのフレンドリ名を、指定した名前に設定します。
Syntax
name {subsystem | lun | target} [<name>]
Parameter
| Parameter | Description |
|---|---|
<name> |
サブシステム、LUN、またはターゲットの名前を指定します。 名前の長さは 64 文字未満にする必要があります。 名前が指定されていない場合は、既存の名前 (存在する場合) が削除されます。 |
オフライン
指定したタイプの現在選択されているオブジェクトの状態を オフラインに設定します。
Syntax
offline <object>
Parameter
| Parameter | Description |
|---|---|
<object> |
この操作を実行するオブジェクトの種類を指定します。 タイプは、 サブシステム、 コントローラー、 ドライブ、 LUN、または tportal です。 |
オンライン
指定したタイプの選択したオブジェクトの状態を オンラインに設定します。 オブジェクトが hbaportの場合、現在選択されているHBAポートへのパスのステータスが オンラインに変更されます。
Syntax
online <object>
Parameter
| Parameter | Description |
|---|---|
<object> |
この操作を実行するオブジェクトの種類を指定します。 タイプは、 hbaport、 サブシステム、 コントローラー、 ドライブ、 LUN、または tportal です。 |
recover
現在選択されているフォールト トレラント LUN を修復するために必要な操作 (再同期やホット スペーリングなど) を実行します。 たとえば、RECOVER を使用すると、障害が発生したディスクまたはその他のディスク・エクステントの再割り当てがある RAID セットにホット・スペアがバインドされる可能性があります。
Syntax
recover <lun>
reenumerate
指定した型のオブジェクトを再び書き込みます。 拡張 LUN コマンドを使用する場合は、reenumerate コマンドを使用する前に、refresh コマンドを使用してディスク サイズを更新する必要があります。
Syntax
reenumerate {subsystems | drives}
Parameters
| Parameter | Description |
|---|---|
| subsystems | プロバイダーにクエリを実行して、現在選択されているプロバイダーに追加された新しいサブシステムを検出します。 |
| drives | 内部 I/O バスを照会して、現在選択されているサブシステムに追加された新しいドライブを検出します。 |
更新する
現在選択されているプロバイダーの内部データを更新します。
Syntax
refresh provider
rem
スクリプトにコメントを付けるために使用されます。
Syntax
Rem <comment>
削除
現在選択されているターゲット ポータル グループから、指定した iSCSI ターゲット ポータルを削除します。
Syntax
remove tpgroup tportal=<tportal> [noerr]
Parameter
| Parameter | Description |
|---|---|
tpgroup tportal=<tportal> |
削除する iSCSI ターゲット ポータルを指定します。 |
| noerr | スクリプトの場合のみ。 エラーが発生した場合、Diskraid はエラーが発生しなかったかのようにコマンドを処理し続けます。 |
置換
指定したドライブを現在選択されているドライブに置き換えます。 指定されたドライブが現在選択されているドライブではない可能性があります。
Syntax
replace drive=<drive_number>
Parameter
| Parameter | Description |
|---|---|
| drive= | 交換するドライブの <drive_number> を指定します。 |
リセット
現在選択されているコントローラーまたはポートをリセットします。
Syntax
reset {controller | port}
Parameters
| Parameter | Description |
|---|---|
| コントローラ | コントローラーをリセットします。 |
| ポート | ポートをリセットします。 |
select
現在選択されているオブジェクトを表示または変更します。
Syntax
select {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup } [<n>]
Parameters
| Parameter | Description |
|---|---|
| オブジェクト | 選択するオブジェクトの種類 (プロバイダー、サブシステム、コントローラー、ドライブ、LUN など) を指定します。 |
HBAPORTの [<n>] |
指定したローカル HBA ポートにフォーカスを設定します。 HBA ポートが指定されていない場合、コマンドは現在選択されている HBA ポート (存在する場合) を表示します。 無効な HBA ポート インデックスを指定すると、フォーカス内の HBA ポートがなくなります。 HBA ポートを選択すると、選択したイニシエーター アダプターとイニシエーター ポータルの選択が解除されます。 |
アイアダプター [<n>] |
指定したローカル iSCSI イニシエーター アダプターにフォーカスを設定します。 イニシエーター・アダプターが指定されていない場合、コマンドは現在選択されているイニシエーター・アダプター (存在する場合) を表示します。 無効なイニシエーター・アダプター索引を指定すると、フォーカス内イニシエーター・アダプターは作成されません。 イニシエーター アダプターを選択すると、選択した HBA ポートとイニシエーター ポータルの選択が解除されます。 |
アイポータル [<n>] |
選択した iSCSI イニシエーター アダプター内の指定したローカル iSCSI イニシエーター ポータルにフォーカスを設定します。 イニシエーター ポータルが指定されていない場合、コマンドは現在選択されているイニシエーター ポータル (存在する場合) を表示します。 無効なイニシエーター ポータル インデックスを指定すると、選択されたイニシエーター ポータルは表示されません。 |
供給者 [<n>] |
指定したプロバイダーにフォーカスを設定します。 プロバイダーが指定されていない場合、コマンドは現在選択されているプロバイダー (存在する場合) を表示します。 無効なプロバイダー インデックスを指定すると、フォーカス内プロバイダーは表示されません。 |
サブシステム [<n>] |
指定したサブシステムにフォーカスを設定します。 サブシステムが指定されていない場合、コマンドはフォーカスのあるサブシステム (存在する場合) を表示します。 無効なサブシステム インデックスを指定すると、フォーカス内サブシステムは作成されません。 サブシステムを選択すると、関連付けられているプロバイダーが暗黙的に選択されます。 |
コントローラー [<n>] |
現在選択されているサブシステム内の指定したコントローラーにフォーカスを設定します。 コントローラーが指定されていない場合、コマンドは現在選択されているコントローラー (存在する場合) を表示します。 無効なコントローラー インデックスを指定すると、フォーカス内コントローラーは表示されません。 コントローラーを選択すると、選択したコントローラー ポート、ドライブ、LUN、ターゲット ポータル、ターゲット、ターゲット ポータル グループの選択が解除されます。 |
ポート [<n>] |
現在選択されているコントローラー内の指定したコントローラー ポートにフォーカスを設定します。 ポートが指定されていない場合、コマンドは現在選択されているポート (存在する場合) を表示します。 無効なポート インデックスを指定すると、ポートが選択されません。 |
ドライブ [<n>] |
現在選択されているサブシステム内の指定したドライブ (物理スピンドル) にフォーカスを設定します。 ドライブが指定されていない場合、コマンドは現在選択されているドライブ (存在する場合) を表示します。 無効なドライブ インデックスを指定すると、フォーカス内ドライブがなくなります。 ドライブを選択すると、選択したコントローラー、コントローラー ポート、LUN、ターゲット ポータル、ターゲット、ターゲット ポータル グループの選択が解除されます。 |
LUN [<n>] |
現在選択されているサブシステム内の指定された LUN にフォーカスを設定します。 LUN が指定されていない場合、コマンドは現在選択されている LUN (存在する場合) を表示します。 無効な LUN インデックスを指定すると、LUN が選択されません。 LUN を選択すると、選択したコントローラー、コントローラー ポート、ドライブ、ターゲット ポータル、ターゲット、ターゲット ポータル グループの選択が解除されます。 |
tポータル [<n>] |
現在選択されているサブシステム内の指定した iSCSI ターゲット ポータルにフォーカスを設定します。 ターゲット ポータルが指定されていない場合、コマンドは現在選択されているターゲット ポータル (存在する場合) を表示します。 無効なターゲット ポータル インデックスを指定すると、選択されたターゲット ポータルは表示されません。 ターゲット ポータルを選択すると、コントローラー、コントローラー ポート、ドライブ、LUN、ターゲット、ターゲット ポータル グループの選択が解除されます。 |
ターゲット [<n>] |
現在選択されているサブシステム内の指定した iSCSI ターゲットにフォーカスを設定します。 ターゲットが指定されていない場合、コマンドは現在選択されているターゲット (存在する場合) を表示します。 無効なターゲット インデックスを指定すると、ターゲットが選択されません。 ターゲットを選択すると、コントローラー、コントローラー ポート、ドライブ、LUN、ターゲット ポータル、ターゲット ポータル グループの選択が解除されます。 |
TPグループ(tpgroup) [<n>] |
現在選択されている iSCSI ターゲット内の指定した iSCSI ターゲット ポータル グループにフォーカスを設定します。 ターゲット ポータル グループが指定されていない場合、コマンドは現在選択されているターゲット ポータル グループ (存在する場合) を表示します。 無効なターゲット ポータル グループ インデックスを指定すると、フォーカス内のターゲット ポータル グループは作成されません。 |
[<n>] |
選択する <object number> を指定します。 指定した <object number> が無効な場合は、指定した型のオブジェクトに対する既存の選択が解除されます。
<object number> が指定されていない場合は、現在のオブジェクトが表示されます。 |
setflag
現在選択されているドライブをホット スペアとして設定します。 ホット スペアは、通常の LUN バインド操作には使用できません。 これらは、障害処理専用に予約されています。 ドライブは、現在、既存の LUN にバインドすることはできません。
Syntax
setflag drive hotspare={true | false}
Parameters
| Parameter | Description |
|---|---|
| true | 現在選択されているドライブをホット スペアとして選択します。 |
| false | 現在選択されているドライブをホット スペアとして選択解除します。 |
shrink
選択した LUN のサイズを小さくします。
Syntax
shrink lun size=<n> [noerr]
Parameters
| Parameter | Description |
|---|---|
| size | LUN のサイズを小さくするために必要な領域を MB (MB) 単位で指定します。 他の単位を使用してサイズを指定するには、サイズの直後に次の認識されるサフィックスのいずれかを使用します。
|
| noerr | スクリプトの場合のみ。 エラーが発生した場合、Diskraid はエラーが発生しなかったかのようにコマンドを処理し続けます。 |
standby
現在選択されているホスト バス アダプター (HBA) ポートへのパスの状態を STANDBY に変更します。
Syntax
standby hbaport
Parameters
| Parameter | Description |
|---|---|
| hbaport | 現在選択されているホスト バス アダプター (HBA) ポートへのパスの状態を STANDBY に変更します。 |
unmask
現在選択されている LUN に、指定したホストからアクセスできるようにします。
Syntax
unmask lun {all | none | [add] wwn=<hexadecimal_number> [;<hexadecimal_number> [;…]] | [add] initiator=<initiator>[;<initiator>[;…]]} [uninstall]
Parameters
| Parameter | Description |
|---|---|
| all | すべてのホストから LUN にアクセスできるようにする必要があることを指定します。 ただし、iSCSI サブシステム内のすべてのターゲットに LUN のマスクを解除することはできません。
|
| none | LUN にどのホストにもアクセスできないことを指定します。
|
| add | 指定したホストを、この LUN にアクセスできるホストの既存のリストに追加する必要があることを指定します。 このパラメーターを指定しない場合は、指定されたホストのリストによって、この LUN にアクセスできるホストの既存のリストが置き換えられます。 |
| wwn= | LUN またはホストにアクセス可能にするワールドワイド名を表す 16 進数のリストを指定します。 ファイバー チャネル サブシステム内の特定のホスト セットをマスクまたはマスク解除するには、目的のホスト マシン上のポートの WWN のセミコロン区切りのリストを入力します。 |
| initiator= | 現在選択されている LUN にアクセスできるようにする iSCSI イニシエーターの一覧を指定します。 iSCSI サブシステム内の特定のホスト セットをマスクまたはマスク解除するには、目的のホスト コンピューター上のイニシエーターの iSCSI イニシエーター名のセミコロン区切りの一覧を入力します。 |
| アンインストール | 指定した場合は、LUN がマスクされる前に、ローカル システム上の LUN に関連付けられているディスクをアンインストールします。 |
Scripting Diskraid
Diskraid は、サポートされているバージョンの Windows Server を実行している任意のコンピューターで、関連する VDS ハードウェア プロバイダーを使用してスクリプト化できます。 Diskraid スクリプトを呼び出すには、コマンド プロンプトで次のように入力します。
diskraid /s <script.txt>
既定では、Diskraid はコマンドの処理を停止し、スクリプトに問題がある場合はエラー コードを返します。 スクリプトの実行を続行し、エラーを無視するには、コマンドに noerr パラメーターを含めます。 これにより、LUN の合計数に関係なく、1 つのスクリプトを使用してサブシステム内のすべての LUN を削除するなどの便利なプラクティスが可能になります。 すべてのコマンドが noerr パラメータをサポートしているわけではありません。 エラーは、 noerr パラメーターを含めたかどうかに関係なく、コマンド構文エラーで常に返されます。
Diskraid エラー コード
| Error Code | Error Description |
|---|---|
| 0 | エラーは発生しませんでした。 スクリプト全体が失敗せずに実行されました。 |
| 1 | 致命的な例外が発生しました。 |
| 2 | Diskraid コマンド ラインで指定された引数が正しくありません。 |
| 3 | Diskraid は、指定されたスクリプトまたは出力ファイルを開くことができませんでした。 |
| 4 | Diskraid が使用するサービスの 1 つがエラーを返しました。 |
| 5 | コマンド構文エラーが発生しました。 オブジェクトが正しく選択されていないか、そのコマンドで使用できなかったため、スクリプトが失敗しました。 |
Example
コンピューター上のサブシステム 0 の状態を表示するには、次のように入力します。
diskraid
Enter キーを押すと、次のような出力が表示されます。
Microsoft Diskraid version 5.2.xxxx
Copyright (©) 2003 Microsoft Corporation
On computer: COMPUTER_NAME
サブシステム 0 を選択するには、Diskraid プロンプトで次のように入力します。
select subsystem 0
Enter キーを押すと、次のような出力が表示されます。
Subsystem 0 is now the selected subsystem.
DISKRAID> list drives
Drive ### Status Health Size Free Bus Slot Flags
--------- ---------- ------------ -------- -------- --- ---- -----
Drive 0 Online Healthy 107 GB 107 GB 0 1
Drive 1 Offline Healthy 29 GB 29 GB 1 0
Drive 2 Online Healthy 107 GB 107 GB 0 2
Drive 3 Not Ready Healthy 19 GB 19 GB 1 1
Diskraid を終了するには、Diskraid プロンプトで次のように入力します。
exit