日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
MFIUTIL(8) FreeBSD システム管理者マニュアル MFIUTIL(8)
名称
mfiutil -- LSI MegaRAID SAS コントローラを管理するためのユーティリティ
書式
mfiutil version
mfiutil [-u unit] show adapter
mfiutil [-u unit] show battery
mfiutil [-d] [-e] [-u unit] show config
mfiutil [-u unit] show drives
mfiutil [-u unit] show events [-c class] [-l locale] [-n count] [-v]
[start [stop]]
mfiutil [-u unit] show firmware
mfiutil [-u unit] show foreign [volume]
mfiutil [-u unit] show logstate
mfiutil [-d] [-e] [-u unit] show patrol
mfiutil [-d] [-e] [-u unit] show progress
mfiutil [-u unit] show volumes
mfiutil [-u unit] fail drive
mfiutil [-u unit] good drive
mfiutil [-u unit] rebuild drive
mfiutil [-u unit] syspd drive
mfiutil [-u unit] drive progress drive
mfiutil [-u unit] drive clear drive {start | stop}
mfiutil [-u unit] start rebuild drive
mfiutil [-u unit] abort rebuild drive
mfiutil [-u unit] locate drive {on | off}
mfiutil [-u unit] cache volume [setting [value] [...]]
mfiutil [-u unit] name volume name
mfiutil [-u unit] volume progress volume
mfiutil [-u unit] clear
mfiutil [-u unit] create type [-v] [-s stripe_size] drive[,drive[,...]]
[drive[,drive[,...]]]
mfiutil [-u unit] delete volume
mfiutil [-u unit] add drive [volume]
mfiutil [-u unit] remove drive
mfiutil [-u unit] start patrol
mfiutil [-u unit] stop patrol
mfiutil [-u unit] patrol command [interval [start]]
mfiutil [-u unit] foreign scan
mfiutil [-u unit] foreign clear [config]
mfiutil [-u unit] foreign diag [config]
mfiutil [-u unit] foreign preview [config]
mfiutil [-u unit] foreign import [config]
mfiutil [-u unit] flash file
mfiutil [-u unit] start learn
mfiutil [-u unit] bbu setting value
mfiutil [-u unit] ctrlprop rebuild [rate]
mfiutil [-u unit] ctrlprop alarm [0/1]
解説
LSI MegaRAID SAS RAID コントローラで様々なパラメータを表示するか、または
変更するために mfiutil ユーティリティを使用することができます。mfiutil の
各呼び出しは、コマンドの後に続く 0 個以上のグローバルなオプションから成り
ます。コマンドは、コマンドの後に追加オプション、または、必要な引数をサ
ポートします。
現在の、1 つのグローバルなオプションがサポートされています:
-u unit
unit は、動作しているコントローラのユニットを指定します。ユニット
が指定されないなら、ユニット 0 が、使用されます。
様々なコマンドは、次の 2 つのオプションのいずれか、または両方を受け付けま
す:
-d ドライブ識別子として数値デバイス ID を印刷 (表示) します。これ
は、デフォルトです。数値デバイス ID と enclosure:slot 情報の両方
を印刷するために -e との組み合わせで役に立ちます。
-e enclosure:slot 形式でドライブ識別子を印刷 (表示) します。出力でな
く入力の内容の形式の詳細については、次のパラグラフを参照してくだ
さい。
ドライブは、2 つの形式で指定されます。最初に、ドライブは、デバイス ID に
よって識別されます。show config で、設定されたドライブのためのデバイス ID
を見つけることができます。2 番目に、ドライブは、[Exx:]Syy として位置に
よって識別されます、ここで、xx は、エンクロージャであり、yy は、show
drives で表示するような、各ドライブのためのスロットです。
ボリュームは、2 つの形式で指定されます。最初に、ボリュームは、ターゲット
ID によって識別されます。2 番目に、ボリュームにおいて、mfid0 のような対応
する mfidX デバイスによって指定されます。
mfiutil ユーティリティは、いくつかの異なったグループのコマンドをサポート
します。コマンドの最初のグループは、コントローラ、それが管理するボリュー
ム、とそれが制御するドライブに関する情報を提供します。コマンドの 2 番目の
グループは、コントローラにアタッチしている物理的なドライブを管理するため
に使用されます。コマンドの 3 番目のグループは、コントローラによって管理さ
れる論理的なボリュームを管理するために使用されます。コマンドの 4 番目のグ
ループは、コントローラのためのドライブの設定を管理するために使用されま
す。コマンドの 5 番目のグループは、コントローラ全体の操作を管理するために
使用されます。
情報のコマンドは、次の通りです:
version
mfiutil のバージョンを表示します。
show adapter
モデル番号のような RAID コントローラに関する情報を表示します。
show battery
バッテリバックアップユニットからバッテリに関する情報を表示しま
す。
show config
コントローラのためにボリュームとドライブ設定を表示します。各アレ
イは、アレイが構築される物理的なドライブとともにリストされます。
各ボリュームは、ボリュームがスパン (span) するアレイとともにリス
トされます。任意のホットスペア (hot spare) ドライブが設定されるな
ら、それらも同様にリストされます。
show drives
コントローラにアタッチされた物理的なドライブのすべてをリストしま
す。
show events [-c class] [-l locale] [-n count] [-v] [start [stop]]
コントローラのイベントログからエントリを表示します。コントローラ
は、イベントの循環バッファを維持します。各イベントは、クラスとロ
ケールでタグ付けをされます。
class パラメータは、指定されたクラスまたは高さでエントリへの出力
を制限します。デフォルトのクラスは、``warn'' (警告) です。最も低
い優先度から最も高い優先度の利用可能なクラスは、次の通りです:
debug デバッグメッセージ。
progress
バックグラウンド初期化、アレイの再構築、またはパトロール
読み込みのような、長い実行操作のための周期的な進行の更
新。
info ドライブ挿入やボリューム作成などの情報メッセージ。
warn いくつかのコンポーネントが失敗寸前であるかもしれないこと
を示します。
crit コンポーネントは、失敗しましたが、データは、失われていま
せん。例えば、ドライブの失敗のためにボリュームの品質が悪
化しました。
fatal コンポーネントは、データの損失をもたらして失敗しました。
dead コントローラ自体が、死にました。
locale パラメータは、コントローラの指定された部分のためのエントリ
への出力を制限します。デフォルトのロケールは、``all'' です。利用
可能なロケールは、``volume'', ``drive'', ``enclosure'',
``battery'', ``sas'', ``controller'', ``config'', ``cluster'' と
``all'' です。
count パラメータは、それぞれの低レベルな要求のためにコントローラ
からとって来るイベントの数を指定するデバッギングエイド (debugging
aid) です。デフォルトは、15 イベントです。
デフォルトで、今までのところ前のシャットダウンからマッチするイベ
ントのログエントリが表示されます。start と stop パラメータを通し
て、この範囲を調整することができます。ログエントリ番号として、ま
たは、次の別名の 1 つとして、これらのパラメータのそれぞれを指定す
ることできます:
newest イベントログの最も新しいエントリ。
oldest イベントログの最も古いエントリ。
clear イベントログがクリアされてときからの最初のエントリ。
shutdown
最後のコントローラに対応するイベントログのエントリは、き
れいにシャットダウンされました。
boot 最新のブートに対応するイベントログのエントリ。
show firmware
コントローラに存在するすべてのファームウェアイメージをリストしま
す。
show foreign
インポートまたは削除のためのディスクで検出された外部の設定を表示
します。
show logstate
イベントログに関連する様々なシーケンス番号を表示します。
show patrol
コントローラのパトロール読み込み操作の状態を表示します。
show progress
すべてのボリュームとドライブでアクティブな操作のための現在の進捗
状況と完了予定時刻を報告します。
show volumes
コントローラによって管理されたすべての論理的なボリュームをリスト
します。
物理的なドライブの管理コマンドは、次の通りです:
fail drive
失敗として drive をマークします。drive は、アレイの一部であるオン
ラインドライブでなければなりません。
good drive
設定されていない良いドライブとして drive をマークします。drive
は、既存のアレイの一部であってはなりません。
rebuild drive
再構築のために適切な良いドライブとしていまでもアレイの一部である
失敗した drive をマークします。ファームウェアは、失敗したドライブ
が再構築されたドライブとしてマークされているなら、それ自体で再構
築されたアレイを開始するべきです。
syspd drive
形式 /dev/mfisyspdX のディスク SYSPD ブロックデバイスとしてホスト
のオペレーティングシステムにドライブを公開します。good drive で、
このフラグをクリアします。
drive progress drive
再構築または読み込みのパトロールのようなドライブ操作の現在の進行
と推定される完了時間を報告します。
drive clear drive {start | stop}
ドライブへすべて 0x00 文字の書き込みを開始するか、または停止しま
す。
start rebuild drive
drive で手動で再構築を開始します。
abort rebuild drive
drive で進行中の再構築操作をアボートします。start rebuild コマン
ドで再開することができます。
locate drive {on | off}
drive に関連している外部の LED の状態を変更します。
論理的なボリューム管理コマンドは、次の通りです:
cache volume [setting [value] [...]]
setting 引数が供給されないなら、volume のための現在のキャッシュポ
リシが表示されます。そうでなければ、volume のためのキャッシュポリ
シは、変更されます。1 つ以上の setting 引数を与えることができま
す。いくつかの設定は、以下に述べられるような追加の value 引数を取
ります。有効な設定は、次の通りです:
enable 読み込みと書き込みの両方の I/O 操作のためのキャッシュを有
効にします。
disable
読み込みと書き込みの両方の I/O 操作のためのキャッシュを無
効にします。
reads 読み込み I/O 操作のためだけのキャッシュを有効にします。
writes 書き込み I/O 操作のためだけのキャッシュを有効にします。
write-back
キャッシュされている書き込みのためにライトバック (write
back) ポリシを使用します。
write-through
キャッシュされている書き込みのためにライトスルー (write
through) ポリシを使用します。
read-ahead value
キャッシュされている読み込みのためにリードアヘッド (read
ahead) ポリシを設定します。value 引数に、``none'',
``adaptive'' または ``always'' のいずれかを指定することが
できます。
bad-bbu-write-cache value
バッテリが死んでいるか、または失われているなら、I/O 書き
込みキャッシュの振る舞いを制御します。``disable'' または
``enable'' のいずれかに value 引数を設定することができま
す。一般的に、この設定は、システムの電源が失われるとき、
データの損失を避けるために無効にされたままにするべきで
す。
write-cache value
物理的なドライブ裏打ち volume で書き込みキャッシュを制御
します。value 引数には、``disable'', ``enable'' または
``default'' のいずれかを指定することができます。
一般的に、この設定は、物理的なドライブが電源を失うとき、
データの損失を避けるために無効のままにされるべきです。
RAID コントローラのバッテリのバックアップは、物理的なドラ
イブの書き込みキャッシュにデータを保存しません。
name volume name
volume の名前を name に設定します。
volume progress volume
一貫性のチェックと初期化のような、ボリューム操作の現在の進行と推
定される完了時間を報告します。
設定コマンドは、次の通りです:
clear すべてのボリューム、アレイ、と予備を含む全体の設定を削除します。
create type [-v] [-s stripe_size] drive[,drive[,...]]
[drive[,drive[,...]]]
新しいボリュームを作成します。type は、作成するボリュームのタイプ
を指定します。現在サポートしているタイプは、次の通りです:
jbod 指定された各ドライブのための RAID0 ボリュームを作成しま
す。各ドライブは、別々の引数として指定されなければなりま
せん。
raid0 単一ドライブリストにリストされたドライブを橋渡しする 1 つ
の RAID0 ボリュームを作成します。
raid1 単一ドライブリストにリストされたドライブを橋渡しする 1 つ
の RAID1 ボリュームを作成します。
raid5 単一ドライブリストにリストされたドライブを橋渡しする 1 つ
の RAID5 ボリュームを作成します。
raid6 単一ドライブリストにリストされたドライブを橋渡しする 1 つ
の RAID6 ボリュームを作成します。
raid10 複数の RAID1 アレイを橋渡しする 1 つの RAID10 ボリューム
を作成します。各 RAID1 アレイのためのドライブは、単一ドラ
イブリストとして指定されます。
raid50 複数の RAID5 アレイを橋渡しする 1 つの RAID50 ボリューム
を作成します。各 RAID5 アレイのためのドライブは、単一ドラ
イブリストとして指定されます。
raid60 複数の RAID6 アレイを橋渡しする 1 つの RAID60 ボリューム
を作成します。各 RAID6 アレイのためのドライブは、単一ドラ
イブリストとして指定されます。
concat 単一ドライブリストでドライブのすべてを連結することによっ
て、単一ボリュームを作成します。
注意: すべてのボリュームタイプがすべてのコントローラによってサ
ポートされるというわけではありません。
-v フラグが type の後に指定されるなら、より冗長な出力が、有効にさ
れます。現在の、これは、設定を構築するとき、ドライブがアレイとア
レイをボリュームに追加するように、ただ通知されます。
-s stripe_size パラメータによって、アレイのストライプ (stripe) サ
イズを設定することができます。デフォルトで、64K のストライプサイ
ズが使用されます。有効な値は、512 から 1M ですが、MFI ファーム
ウェアは、いくつかの値を拒否するかもしれません、
delete volume
ボリューム volume を削除します。
add drive [volume]
ホットスペアとして drive をマークします。Drive は、設定されていな
い良い状態でなければなりません。volume が指定されるなら、ホットス
ペアは、そのボリュームを裏打ちするアレイに専念されます。そうでな
ければ、drive は、このコントローラのためのすべてのアレイを裏打ち
するグローバルなホットスペアとして使用されます。drive は、それが
後方となるつもりの全てのアレイで最も小さいドライブと同じくらいの
大きさでなければならないことに注意してください。
remove drive
サービスからホットスペア drive を取り除きます。それは非設定されて
いない良い状態に置かれます。
コントローラ管理コマンドは、次の通りです:
patrol command [interval [start]]
パトロール読み込みオペレーションモードを設定します。command 引数
として、次の値の 1 つを指定できます:
disable
パトロール読み込みを無効にします。
auto ファームウェアによって開始される周期的なパトロール読み込
みを有効にします。オプション interval 引数は、パトロール
読み込みの間を秒単位の間隔を指定します。パトロール読み込
みが連続的に実行されるべきであるなら、interval は、単語
``continuously'' から成るべきです。オプションの start 引
数は、次のパトロール読み込みのための開始時間と相対的な負
でない値を指定します。間隔または開始時刻が指定されないな
ら、既存の設定が使用されます。
manual ユーザによってのみ開始される手動のパトロール読み込みを有
効にします。
start patrol
パトロール読み込み操作を開始します。
stop patrol
現在実行中のパトロール読み込み操作を停止します。
foreign scan
外部の設定をスキャンして、見つかった数を表示します。下記のコマン
ドのための config 引数は、0 から見つかった合計の設定の数の形式を
取ります。
foreign clear [config]
指定された外部の config または、config 引数が提供されないなら、す
べてをクリアします。
foreign diag [config]
指定された外部の config または、config 引数が提供されないなら、す
べての診断の表示を表示します。
foreign preview [config]
インポートの後に、指定された外部の config または、config 引数が提
供されないなら、すべてをプレビュー (下見) します。
foreign import [config]
指定された外部の config または、config 引数が提供されないなら、す
べてをインポートします。
flash file
file 中に格納されたファームウェアがあるコントローラでフラッシュを
更新します。リブートは、実施される新しいファームウェアを必要とし
ます。
start learn
バッテリの再確認を開始します。これは、BBU モードにかかわらず、常
に完全に空になっているバッテリの結果となるように思われることに注
意してください。特に、コントローラの書き込みキャッシュは、たとえ
透過的な学習モードが有効になってていも、再学習の間に無効にされま
す。
bbu setting value
バッテリの再確認に関連するバッテリバックアップ装置 (BBU) のプロパ
ティを更新します。次の設定が設定可能です:
learn-delay
次にスケジュールされたバッテリの再確認イベントに遅延を追
加します。この設定は、時間単位で与えられ、0 から 255 の範
囲になければなりません。
autolearn-mode
周期的にバッテリの再確認を自動的に有効にするか、または無
効にします。設定は、再確認サイクルを有効にするか、または
無効にするために、それぞれ、``enable'' または ``disable''
に設定されます。代わりに、0、1 または 2 のモードが、与え
られます。モード 0 は、周期的に再確認を有効にし、モード 1
は、それを無効にします、そして、モード 2 は、それを無効に
し、バッテリの再確認が実行されるべきであることを検出する
とき、警告をイベントログにログ記録します。
bbu-mode
BBU の操作のモードを設定します。この設定は、すべての BBU
によってサポートされていません。それがサポートされるとこ
ろで、指定できる値は、1 と 5 の間の整数です。モード 1、2
と 3 は、透過的な確認サイクルを有効にし、一方モード 4 と
5 は、有効にしません。BBU のデータ保持時間は、透過的な確
認が使用されていないとき、より大きくなります。
ctrlprop rebuild [rate]
引数なしで、ボリュームのための再構築の割合 (パーセンテー
ジ) を表示します。整数引数 (0-100) で、ボリュームのための
新しい再構築の割合として、その値を設定します。
ctrlprop alarm [0/1]
引数なしで、現在のアラーム有効/無効状態を表示します。0
で、アラームを無効にします。1 で、アラームを有効にしま
す。
使用例
書き込みのみをキャッシュするためのボリューム mfid0 のためのキャッシュを設
定します。
mfiutil cache mfid0 writes
mfiutil cache mfid0 write-back
2 番目の囲いで最初の 4 つのディスクを橋渡しする RAID5 アレイを作成します:
mfiutil create raid5 e1:s0,e1:s1,e1:s2,e1:s4
JBOD としてコントローラの最初の 3 つのディスクを設定します:
mfiutil create jbod 0 1 2
2 つの異なった囲みから 2 つのディスクを含む 2 つのアレイを橋渡しする
RAID10 ボリュームを作成します:
mfiutil create raid10 e1:s0,e1:s1 e2:s0,e2:s1
グローバルなホットスペアとして 4 のデバイス ID があるドライブを追加しま
す:
mfiutil add 4
ボリューム mfid0 のためのホットスペアとしてメインシャーシのスロット 2 で
ドライブを追加します:
mfiutil add s2 mfid0
RAID のない SYSPD ブロックデバイスとしてディスクを再設定します:
mfiutil syspd 0
5 分後に開始する最初のパトロール読み込みが 1 週間に一度周期的なパトロール
読み込みを実行するアダプタを設定します:
mfiutil patrol auto 604800 300
2 番目の検出された外部の設定を表示します:
mfiutil show foreign 1
ボリュームのための顕在の再構築の割合を 40% に設定します:
mfiutil ctrlprop rebuild 40
関連項目
mfi(4)
歴史
mfiutil ユーティリティは、FreeBSD 8.0 ではじめて登場しました。
FreeBSD 13.2 September 2, 2011 FreeBSD 13.2