SunOS リファレンスマニュアル 1M : システム管理コマンド

raidctl(1M)

名前 | 形式 | 機能説明 | オプション | 使用例 | 終了ステータス | 属性 | 関連項目 | 警告

名前

raidctl – RAID ハードウェアユーティリティー

形式

raidctl -C "disks" [-r raid_level] [-z capacity] [-s stripe_size] [-f]
     controller

raidctl -d [-f] volume

raidctl -F filename [-f] controller…

raidctl -a {set | unset} -g disk {volume | controller}

raidctl -p "param=value" [-f] volume

raidctl -c [-f] [-r raid_level] disk1 disk2 [disk3...]

raidctl -l -g disk controller

raidctl -l volume

raidctl -l controller…

raidctl [-l]

raidctl -S [volume | controller]

raidctl -S -g disk controller

raidctl -h

機能説明

raidctl ユーティリティーはハードウェア RAID 構成ツールであり、RAID ボリュームを作成、削除、または表示する CLI (コマンド行インタフェース) をエンドユーザーに提供することで、さまざまな RAID コントローラをサポートしています。このユーティリティーはまた、ボリュームのプロパティーの設定、ボリュームやコントローラへのホットスペア (HSP) ディスクの割り当て、および RAID コントローラのファームウェア/fcode/BIOS の更新にも使用できます。

raidctl ユーティリティーには、基本ファイルシステムのアクセス権で制御される特権が必要です。特権を持つユーザーだけが RAID システム構成を操作できます。特権を持たないユーザーが raidctl を実行しようとすると、終了ステータス 1 が返されてコマンドは失敗します。

raidctl ユーティリティーは、完全な機能を備えた RAID コントローラを管理するためのコマンド行オプションのセットを定義しています。RAID コントローラによってサポートされている機能が異なることがあるため、特定の RAID コントローラですべてのオプションがサポートされるわけではありません。ユーザーは raidctl を使用することで、特定のコントローラのタイプとファームウェアのバージョンを一覧表示して、サポートされる機能を確認できます。

現在、raidctl は次の RAID コントローラをサポートしています。

- LSI1020、LSI1030、LSI1064、および LSI1068 SCSI HBA。これらは x86 (32/64 ビット) および SPARC プラットフォーム上で、mpt ドライバによって維持管理されます。

オプション

次のオプションを指定できます。

-C "disks" [-r raid_level] [-z capacity] [-s stripe_size] [-f] controller

指定したディスクを使用して RAID ボリュームを作成します。

このオプションを使用して RAID ボリュームを作成すると、新しく作成されたボリュームの識別情報が自動的に生成され、raidctl はそれをユーザーに報告します。

このオプションによって指定される引数には、作成されるボリュームの構成に使われる要素が含まれます。要素にはディスクまたはサブボリュームのいずれかを指定できます。ディスクは空白で区切り、サブボリュームはディスクのセットを丸括弧でグループ化します。すべてのディスクは「C.ID.L」の形式にしてください (たとえば「0.1.2」は、チャネル 0 の物理ディスクであり、ターゲット ID は 1、論理ユニット番号は 2 であることを表す)。この引数は、(-r オプションを省略した場合でも) -r オプションで指定した RAID レベルと一致している必要があります。つまり、指定できる引数は次のように限定されます。

RAID 0 の場合: 少なくとも 2 つのディスク
RAID 1 の場合: 2 つのディスクのみ
RAID 1E の場合: 少なくとも 3 つのディスク
RAID 5 の場合: 少なくとも 3 つのディスク
RAID 10 の場合: 少なくとも 2 つのサブボリューム。各サブボリュームは 2 つのディスクで構成されている必要があります
RAID 50 の場合: 少なくとも 2 つのサブボリューム。各サブボリュームは 3 つ以上のディスクで構成されている必要があり、各サブボリューム内のディスク容量は同じであるべきです

たとえば、「0.0.0 0.1.0」の形式は、指定された 2 つのディスクが RAID ボリューム (RAID 0 または RAID 1 ボリュームのいずれか) を構成することを意味します。「(0.0.0 0.1.0)(0.2.0 0.3.0)」は、最初の 2 つのディスクと最後の 2 つのディスクが 2 つのサブボリュームを構成し、これら 2 つのサブボリュームが RAID 10 ボリュームを構成することを意味します。その他の例については、「使用例」の節を参照してください。

-r オプションは、作成されるボリュームの RAID レベルを指定します。指定できるレベルは 0、1、1E、5、10、50 です。このオプションを省略すると、raidctl はデフォルトで RAID 1 ボリュームを作成します。

-z オプションは、作成されるボリュームの容量を指定します。単位として、テラバイト、ギガバイト、またはメガバイト (たとえば 2t、10g、20m など) を使用できます。このオプションを省略すると、raidctl は指定されたディスクで作成できるボリュームの最大容量を計算し、この値を使用してボリュームを作成します。

-s オプションは、作成されるボリュームのストライプサイズを指定します。指定できる値は 512、1k、2k、4k、8k、16k、32k、64k、または 128k です。このオプションを省略すると、raidctl はボリュームに適した値 (たとえば 64k) を選択します。

たとえば LSI1020、LSI1030、LSI1064、または LSI1068 HBA において、場合によっては RAID ボリュームの作成が特定のディスク上のデータ消失を引き起こすことがあり、raidctl はユーザーに対してボリューム作成の確認を要求します。ユーザーへの確認要求なしでボリューム作成を強制させるには、-f オプションを使用します。

controller 引数は、指定したディスクがどの RAID コントローラに属するかを特定するために使用します。-l オプションを使用すれば、コントローラの ID 番号を一覧表示できます。

-d [-f] volume

volume として指定された RAID ボリュームを削除します。ボリュームは標準的な形式 (たとえば c0t0d0) で指定します。

ボリュームを削除すると、すべてのデータが失われます。このため、-f オプションを指定しないかぎり、raidctl はボリュームを削除する前にユーザーに対して確認を要求します。

LSI1020、LSI1030、LSI1064、または LSI1068 HBA から RAID 1 ボリュームを削除すると、一次ディスクと二次ディスクが「分離」します。ボリュームが SYNCING 状態にあった場合、一次側にはデータが含まれていますが、二次側には含まれていません。ボリュームの状態が OPTIMAL であった場合、両方のディスクにデータの完全なイメージが含まれています。

-F filename [-f] controller…

指定したコントローラで動作しているファームウェアを更新します。-f オプションを指定しないかぎり、raidctl ユーティリティーはユーザーに対してこのアクションの確認を要求します。

-a {set | unset} -g disk {volume | controller}

ボリュームを指定した場合、-a で指定した値によって、raidctl はディスクをボリューム専用のローカルホットスペアディスクとして設定するか、その設定を解除します。コントローラを指定した場合、raidctl はディスクをグローバルなホットスペアディスクとして設定するか、その設定を解除します。

-p "param=value" [-f] volume

指定した RAID ボリュームのプロパティー値を変更します。現在、キャッシュ書き込みポリシーのみが (「on」または「off」に) 変更可能です。このため、param には文字列「wp」(SET_WR_POLICY) のみを、value には「on」または「off」のいずれかのみを指定できます。

RAID ボリュームのプロパティーを変更すると RAID コントローラの内部動作に影響する可能性があるため、-f オプションを指定しないかぎり、raidctl は変更を適用する前にユーザーに対して確認を要求します。

-c [-f] [-r raid_level] disk1 disk2 [disk3...]

指定したディスクを使用してボリュームを作成します。これは、似た機能を持つ -C オプションの代替手段です。このオプションは互換性のために残されていますが、LSI1020、LSI1030、LSI1064、および LSI1068 HBA で RAID 0、RAID 1、または RAID 1E ボリュームを作成することしかできません。ほかの HBA では、ユーザーは -C オプションのみを使用できます。

-r オプションは、ターゲットボリュームの RAID レベルを指定するために使用できます。-r オプションを省略すると、raidctl は RAID 1 ボリュームを作成します。

ディスクは Solaris の標準的な形式 (たとえば c0t0d0) で指定する必要があります。

このオプションで RAID 1 ボリュームを作成すると、disk2 の内容が disk1 の内容に置き換わります。

ユーザーがこのオプションで RAID ボリュームを作成すると、RAID ボリュームは disk1 の識別情報を引き受けます。ほかのディスクは見えなくなり、RAID ボリュームは 1 つのディスクとして表示されます。

このオプションによるボリュームの作成は、デフォルトで対話形式で進められます。ボリュームを作成するには、ユーザーはプロンプトに明示的に答える必要があります。ユーザーへの確認要求なしでボリューム作成を強制させるには、-f オプションを使用します。

-l -g disk controller

指定したコントローラの、指定したディスクに関する情報を表示します。出力には次の情報が含まれます。

Disk: ディスクを C.ID.L の形式で表示します。
Vendor: ベンダー ID の文字列を表示します。
Product: 製品 ID の文字列を表示します。
Capacity: ディスクの合計容量を表示します。
Status: ディスクの現在の状態を表示します。状態は「GOOD」(正常動作中) または「FAILED」(機能していない) のいずれかです。
HSP: ディスクがグローバルホットスペアディスク、ローカルホットスペアディスク、または通常のものとして設定されているかを示します。ローカルホットスペアディスクの場合、このディスクが割り当てられているすべてのボリュームが表示されます。

-l volume

指定したボリュームに関する情報を表示します。出力には次の情報が含まれます。

Volume: ボリュームを標準的な形式で表示します。
Sub: 指定したボリュームが RAID 10 または RAID 50 ボリュームの場合、サブボリュームを表示します。
Disk: 指定したボリュームを構成するディスクをすべて表示します。
Stripe Size: ボリュームのストライプサイズを表示します。
Status: 指定したボリューム、または指定したボリュームを構成するサブボリューム/ディスクの状態を表示します。ボリュームの場合、状態は「OPTIMAL」(正常動作中)、「DEGRADED」(機能制限付きで動作中)、「FAILED」(機能していない)、または「SYNC」(ディスクが同期中) のいずれかです。ディスクの場合、状態は「GOOD」または「FAILED」のいずれかです。
Cache: キャッシュの入出力書き込み動作が有効になっているかどうかを示します。キャッシュは「ON」または「OFF」のいずれかです。
RAID level: RAID レベルを表示します。RAID レベルは 0、1、1E、5、10、または 50 のいずれかです。

-l controller ...

指定したコントローラに関する情報を表示します。出力には次の情報が含まれます。

Controller: RAID コントローラの ID 番号を表示します。
Type: RAID コントローラの製品タイプを表示します。
fw_version: コントローラのファームウェアのバージョンを表示します。

[-l]

raidctl ユーティリティーが操作できる、RAID に関連するすべてのオブジェクトを一覧表示します。これには、使用可能なすべての RAID コントローラ、RAID ボリューム、および物理ディスクが含まれます。-l オプションは省略できます。

出力には次の情報が含まれます。

Controller: RAID コントローラの ID 番号を表示します。
Volume: 論理 RAID ボリューム名を表示します。
Disk: RAID ディスクを C.ID.L の形式で表示します。

-S [volume | controller]

使用可能なすべての RAID デバイス、RAID コントローラ、ボリューム、およびディスクを含む、RAID 構成情報のスナップショットを取得します。

出力の各行には、RAID デバイスとその関連情報が空白で区切られて表示されます。すべてのボリュームとディスクは、最後に指定したコントローラに属します。

出力には次の情報が一覧表示されます。

Controller: コントローラの ID 番号と、コントローラのタイプを表す文字列 (二重引用符に囲まれている) が表示されます。
Volume: RAID ボリューム名、構成要素のディスクの数、構成要素のディスクの C.ID.L 形式、RAID レベル、および状態を表示します。状態は「OPTIMAL」、「DEGRADED」、「FAILED」、または「SYNCING」のいずれかです。
Disk: ディスクの C.ID.L 形式と状態を表示します。状態は「GOOD」、「FAILED」、または「HSP」(ディスクが予備用ディスクとして設定されている) のいずれかです。

ボリュームまたはコントローラを指定すると、指定したボリュームまたはコントローラの情報のスナップショットしか取得されません。

-S -g disk controller

指定したディスクの情報のスナップショットを取得します。

-h

使用法についての文字列を出力します。

使用例

例 1 RAID 構成の作成

次のコマンドは、コントローラ 0 に 10G の RAID 0 ボリュームを作成し、ストライプサイズは 64k に設定されます。

# raidctl -C "0.0.0 0.2.0" -r 0 -z 10g -s 64k 0

次のコマンドは、コントローラ 2 に RAID 1 ボリュームを作成します。

# raidctl -C "0.0.0 1.1.0" -r 1 2

次のコマンドは、コントローラ 2 に RAID 5 ボリュームを作成します。

# raidctl -C "0.0.0 0.1.0 0.2.0" -r 5 2

次のコマンドは、コントローラ 0 に RAID 10 ボリュームを作成します。

# raidctl -C "(0.0.0 0.1.0)(0.2.0 0.3.0)" -r 10 0

次のコマンドは、コントローラ 0 に RAID 50 ボリュームを作成します。

# raidctl -C "(0.0.0 0.1.0 0.2.0)(0.3.0 0.4.0 0.5.0)" -r 50 0

例 2 RAID 構成の表示

次のコマンドは、使用可能なすべてのコントローラ、ボリューム、およびディスクを表示します。

# raidctl -l

Controller: 0
Controller: 2
         Volume:c2t0d0
         Disk: 0.0.0
         Disk: 0.1.0
         Disk: 0.2.0
         Disk: 0.3.0(HSP)

次のコマンドは、コントローラ 2 に関する情報を表示します。

# raidctl -l 2

Controller      Type            Fw_version
--------------------------------------------------------------
c2              LSI 1030        1.03.39.00

次のコマンドは、指定したボリュームに関する情報を表示します。

# raidctl -l c2t0d0

Volume                  Size    Stripe  Status  Cache   RAID
         Sub                     Size                    Level
                Disk
--------------------------------------------------------------
c2t0d0                 10240M  64K     OPTIMAL ON      RAID5
                0.0.0   5120M           GOOD
                0.1.0   5120M           GOOD
                0.2.0   5120M           GOOD

次のコマンドは、コントローラ 2 のディスク 0.3.0 に関する情報を表示します。

# raidctl -l -g 0.3.0 2

Disk    Vendor  Product         Capacity        Status  HSP
--------------------------------------------------------------
0.3.0   MAXTOR  ATLAS10K4_36SC  34732M          GOOD    c2t0d0

例 3 RAID 構成の削除

次のコマンドは、ボリュームを削除します。

# raidctl -d c0t0d0

例 4 コントローラのフラッシュイメージの更新

次のコマンドは、コントローラ 0 のフラッシュイメージを更新します。

# raidctl -F lsi_image.fw 0

例 5 ホットスペアディスクの設定または設定解除

次のコマンドは、コントローラ 2 のディスク 0.3.0 をグローバルホットスペアディスクとして設定します。

# raidctl -a set -g 0.3.0 2

次のコマンドは、コントローラ 2 のディスク 0.3.0 を、ボリューム c2t0d0 に対するローカルホットスペアディスクとして設定します。

# raidctl -a set -g 0.3.0 c2t0d0

次のコマンドは、コントローラ 2 のディスク 0.3.0 を、グローバルホットスペアディスクから通常のディスクへ変換します。

# raidctl -a unset -g 0.3.0 2

次のコマンドは、ディスク 0.3.0 のボリューム c2t0d0 に対するローカルホットスペアディスクの設定を解除します。

# raidctl -a unset -g 0.3.0 c2t0d0

例 6 ボリュームプロパティーの設定

次のコマンドは、ボリュームの書き込みポリシーを「off」に設定します。

# raidctl -a set -p "wp=off" c0t0d0

例 7 -c オプションによるボリュームの作成

次のコマンドは、RAID 1 ボリュームを作成します。

# raidctl -c c0t0d0 c0t1d0

次のコマンドは、RAID 0 ボリュームを作成します。

# raidctl -c -r 0 c0t1d0 c0t2d0 c0t3d0

例 8 RAID 構成情報のスナップショットの取得

次のコマンドは、すべての RAID デバイスのスナップショットを取得します。

# # raidctl -S

1 "LSI 1030"
c1t1d0 2 0.2.0 0.3.0 1 DEGRADED
0.2.0 GOOD
0.3.0 FAILED

次のコマンドは、ボリューム c1t0d0 についてのスナップショットを取得します。

# raidctl -S c1t0d0

c1t0d0 2 0.0.0 0.1.0 1 OPTIMAL

次のコマンドは、コントローラ 1 のディスク 0.1.0 についてのスナップショットを取得します。

# raidctl -S -g 0.1.0 1

0.1.0 GOOD

終了ステータス

次の終了ステータスが返されます。

0: 正常終了。
1: コマンド行入力が不正、またはアクセスが拒否された。
2: 要求操作は失敗した。

属性

次の属性についての詳細は、マニュアルページの attributes(5) を参照してください。

属性タイプ	属性値
使用条件	SUNWcsu
インタフェースの安定性	開発中

警告

Solaris マルチパス入出力機能 (MPxIO としても知られる) を使用する場合は、内部 SAS ディスク上に RAID ボリュームを作成しないでください。Solaris マルチパス環境で新しい RAID ボリュームを作成すると、既存デバイスの GUID と一致しない新しい GUID が root デバイスに与えられます。これによって /etc/vfstab 内の root デバイスのエントリが一致しなくなり、ブート障害を引き起こします。

SunOS 5.10 最終更新日 2007 年 5 月 30 日

名前 | 形式 | 機能説明 | オプション | 使用例 | 終了ステータス | 属性 | 関連項目 | 警告