EN JA
GVINUM(8)
GVINUM(8) FreeBSD System Manager's Manual GVINUM(8)

名称

gvinum論理的なボリュームマネージャ (Logical Volume Manager) 制御プログラム

書式

gvinum [ command][ -options]

コマンド

attach plex volume [ rename]
attach subdisk plex [ offset][ rename]
plex をボリュームにアタッチするか、またはサブディスクを plex にアタッチします。オフセットが指定されるなら、サブディスクは、plex 中の与えられてオフセットにアタッチされます。 rename (改名) が指定されるなら、サブまたは plex は、それがアタッチされるオブジェクトにしたがって名前を変更します。
checkparity [ -f] plex
RAID-5 plex のパリティブロックをチェックします。パリティチェックは、 -f フラグが指定されているなら、plex の始めで開始されるか、またはそうでなければ、plex のパリティが不正確である最初の位置である、パリティチェックポインタの位置で開始されます。 plex のすべてのサブディスクは、パリティチェックのために起動していなければなりません。
concat [ -fv][ -n name] drives
指定されたドライブから連結された (concatenated) ボリュームを作成します。名前が指定されないなら、ユニークな名前が、 gvinum によって設定されます。
create [ -f][ description-file]
description-file に記述されるようなボリュームを作成します。 description-file が提供されなければ、エディタをオープンして、編集のために現在の gvinum 設定を提供します。 -f フラグによって、gvinum は、既に存在するオブジェクトを作成することに関してどんなエラーも無視します。しかしながら、vinum とは違って、 -f フラグが与えられるるとき、 description-file に適切に指定されないオブジェクトは、作成されません。
detach [ -f][ plex | subdisk]
アタッチされているボリュームまたは plex から plex またはサブディスクをデタッチします。
grow plex device
デバイスの gvinum ドライブとサブディスクを作成することによって plex 成長させ (大きくし)、それを plex にアタッチします。 plex 構成によって要求されるなら、それは成長可能状態に置かれます。
help
gvinum コマンドと引数の構文を提供します。
l | list [ -rvV][ volume | plex | subdisk]
ld [ -rvV][ drive ...]
ls [ -rvV][ subdisk ...]
lp [ -rvV][ plex ...]
lv [ -rvV][ volume ...]
関連するオブジェクトに関する情報をリストします。 -r フラグは、適切な関係の各オブジェクトの下位のオブジェクトを表示する、再帰的な表示を提供します。 -v-V フラグは、次第に、より詳細な出力を提供します。
mirror [ -fsv][ -n name] drives
指定されたドライブからミラーされたボリュームを作成します。少なくとも 2 の倍数のドライブを必要とします。名前が指定されないなら、ユニーク名前が、gvinum によって設定されます。 -s フラグが指定されるなら、ストライプされたミラーが作成され、そのため、4 の倍数のドライブを必要とします。
move | mv -f drive subdisk [ ...]
指定されたドライブに (複数の) サブディスクを移動します。示されたサブディスクに関するすべてのデータが移動の一部として破壊するとき、 -f フラグが必要です。現在サブディスクがアクセスされてないときだけ、これが行えます。

単一のサブディスクが移動され、RAID-5 plex の一部を形成するなら、移動されたサブディスクは、“stale” (陳腐) 状態に設定される必要があり、 plex は、 start コマンドを必要とします。複数のサブディスクが移動され、RAID-5 plex の部分として形成されるなら、移動された (複数の) サブディスクは、“up”状態に設定される必要があり、plex は、 rebuildparity コマンドを必要とします。 plex の部分として形成される (複数の) サブデスクが、他の (複数の) plex でミラーされるなら、plex は、再始動が必要であり、いったん再始動されると同期 (sync) します。 RAID-5 plex の 2 つ以上のサブディスクまたはミラーされた plex ボリュームの両側からのサブディスクを移動することは、データを破壊するでしょう。パリティの再構築と同期は、移動の後に手動で開始しなければならないことに注意してください。

printconfig
標準出力に現在の設定のコピーを書き込みます。
quit
インタラクティブモードで実行するとき、 gvinum は、終了します。通常、 EOF 文字を入力することによって、これを行うでしょう。
raid5 [ -fv][ -s stripesize][ -n name] drives
指定されたドライブから RAID-5 ボリュームを作成します。名前が指定されないなら、ユニークな名前が、 gvinum によって設定されます。この構成は、少なくとも 3 つのドライブを必要とします。
rename [ -r] drive | subdisk | plex | volume newname
指定されたオブジェクトの名前を変更します。 -r フラグは、下位のオブジェクトを再帰的に名前の変更を行います。

gvinum が再開されるまでデバイスノードは、名前の変更がされないことに注意してください。

rebuildparity [ -f] plex
RAID-5 plex のパリティブロックを再構築します。パリティの再構築は、 -f フラグが指定されているなら、plex の始めで開始され、そうでなければパリティチェックポインタの位置で開始されます。 plex のすべてのサブディスクは、パリティチェックのためにアップしていなければなりません。
resetconfig
完全な gvinum 設定をリセットします。
rm [ -r] volume | plex | subdisk
オブジェクトを削除します、 -r が指定されるなら、その下位のオブジェクトを削除します。
saveconfig
設定失敗の後に gvinum の設定をディスクに保存します。
setstate [ -f] state volume | plex | subdisk | drive
診断目的のためだけに、他のオブジェクトに影響を及ぼさずに状態を設定します。 -f フラグは、それらが正当であるかどうかにかかわらず、強制的に状態を変更します。
start
すべての vinum ドライブから設定を読み込みます。
start [ -S size] volume | plex | subdisk
システムがオブジェクトにアクセスできるようにします。必要なら、(複数の) plex は、同期され、再構築されます。サブディスクが実行している RAID-5 またはストライプされた plex に追加されたなら、gvinum は、このサブディスクを拡張し、全体の RAID-5 アレイを成長 (大きく) します。利用者のファイルシステムをアンマウトせずに、これを行うことができます。 -S フラグは、現在、無視されます。
stop [ -f][ volume | plex | subdisk]
オブジェクトへのアクセスを終了するか、またはパラメータが指定されないなら、 gvinum を停止します。
stripe [ -fv][ -n name] drives
指定されたドライブからストライプされたボリュームを作成します。名前が指定されないなら、ユニークな名前が、 gvinum によって設定されます。この構成は、少なくとも 2 つのドライブを必要とします。

解説

gvinum ユーティリティは、GVinum 論理ボリュームマネージャのカーネルコンポーネントと通信します。コマンドライン引数なしで始めるとき、インタラクティブに使用するか、またはコマンドがコマンドラインで供給されるなら、単一のコマンドを実行するように設計されています。インタラクティブモードでは、 gvinum は、コマンドラインのヒストリ機能が使えます。

オプション

gvinum コマンドは、1 つのオプションが続きます。
-f
-f (“force”) (強制的) オプションは、安全チェックを無効にします。細心の注意を払って使用されるべきです。このオプションは、 move コマンドを使用するために必要です。
-r
-r (“recursive”) (再帰的) オプションは、コマンドを再帰的に下位のオブジェクトに適応します。例えば、 lv コマンドに関連して、 -r オプションは、また、ボリュームに属する plex とサブディスクに関する情報を表示します。また、サブディスクのような下位のオブジェクトは、指定された (複数の) オブジェクトに適合するように名前を変更するべきであることを示すために、 rename コマンドによって、そして、ボリュームなどに属する plex を削除するために rm コマンドによって使用されます。
-v
-v (“verbose”) (冗長) オプションは、より詳細な出力を提供します。
-V
-V (“very verbose”) (非常に冗長) オプションは、 -v よりさらに詳細な出力を提供します。

環境変数

EDITOR
デフォルトが vi(1) の設定ファイルを編集するのに使用するエディタの名前。

関連ファイル

/dev/gvinum
gvinum オブジェクトのためのデバイスノードがあるディレクトリ

使用例

ディスク /dev/ada1 と /dev/ada2 にミラーを作成するためには、ファイルシステムを作成し、マウントし、アンマウントし、次に gvinum を停止します:

gvinum mirror /dev/ada1 /dev/ada2
newfs /dev/gvinum/gvinumvolume0
mount /dev/gvinum/gvinumvolume0 /mnt
...
unmount /mnt
gvinum stop

"data"と名前が付けられたディスク /dev/ada1 /dev/ada2 /dev/ada3 と /dev/ada4 にストライプされたミラーを作成するためには、ファイルシステムを作成します:

gvinum mirror -s -n data /dev/ada1 /dev/ada2 /dev/ada3 /dev/ada4
newfs /dev/gvinum/data

ストライプサイズ 493k で、ディスク /dev/ada1 /dev/ada2 と /dev/ada3 に raid5 アレイを作成するためには、raid5 コマンドを使用することができます:

gvinum raid5 -s 493k /dev/ada1 /dev/ada2 /dev/ada3

次に、ボリュームが、自動的に作成されます。その後、利用者は、ボリュームを初期化しなければなりません:

gvinum start myraid5vol

初期化が、始まり、それが終わったとき、状態は、更新されます。 list コマンドは、進歩の情報を利用者に与えます。

ドライブの 1 つが失敗して、'printconfig' の出力が次のように見えると想像してください:

drive gvinumdrive1 device /dev/ada2
drive gvinumdrive2 device /dev/???
drive gvinumdrive0 device /dev/ada1
volume myraid5vol
plex name myraid5vol.p0 org raid5 986s vol myraid5vol
sd name myraid5vol.p0.s2 drive gvinumdrive2 len 32538s driveoffset 265s
plex myraid5vol.p0 plexoffset 1972s
sd name myraid5vol.p0.s1 drive gvinumdrive1 len 32538s driveoffset 265s
plex myraid5vol.p0 plexoffset 986s
sd name myraid5vol.p0.s0 drive gvinumdrive0 len 32538s driveoffset 265s
plex myraid5vol.p0 plexoffset 0s

この構成で新しいドライブを作成します:

drive gdrive4 device /dev/ada4

次に、stale (陳腐) サブディスクを新しいドライブに移動します:

gvinum move gdrive4 myraid5vol.p0.s2

次に、再構築を開始します:

gvinum start myraid5vol.p0

plex は、再構築が終了した後にデグレイド (degrade) モードを形成します。再構築が進行中でも、plex を使用できますが、要求は、遅れるかもしれません。

前の例のように構成を仮定すると、 RAID-5 または STRIPED アレイを成長させることは、 grow コマンドを使用することによって達成されます:

gvinum grow myraid5vol.p0 /dev/ada4

すべてが OK となるなら、今、plex 状態は、成長可能と設定されるべきです。次に、 start コマンドで成長を始めることができます:

gvinum start myraid5vol.p0

再構築と同様に、 list コマンドを使用して進捗状況を見ることができます。

gvinum のより高度な使用法と詳細な説明については、、ハンドブックが、推薦されます。

関連項目

geom(4), geom(8)

歴史

gvinum ユーティリティは、 FreeBSD 5.3 ではじめて登場しました。 gvinum の基となっている vinum ユーティリティは、 Greg Lehey によって書かれました。

gvinum ユーティリティは、 Lukas Ertl によって書かれました。 moverename コマンド、および文書は、Code プログラムの 2005 Google Summer を通して Chris Jones によって追加されました。 gvinum の部分的な書き直しは、2007 Google Summer Summer of Code プログラムを通して Lukas ErtlUlf Lilleengen によって行われました。文書は、新しい機能を反映するために更新されました。

作者

Lukas Ertl <le@FreeBSD.org> Chris Jones <soc-cjones@FreeBSD.org> Ulf Lilleengen <lulf@FreeBSD.org>

バグ

現在、 gvinum は、リロードされるまで、 /dev/gvinum でデバイスの名前を変更しません。

start のための -S initsize フラグは、無視されます。

ミラーまたは RAID-5 ボリュームの一部でないサブディスクを移動することは、データを破壊するでしょう。それは、恐らくこれを可能にするバグです。

サブディスクが移動された plex は、自動的に同期しないし、パリティの再構築もしません。これは、データを保護がない状態のままとして、恐らく賢明ではありません。

現在、 gvinum は、 vinum で見つけられるすべての機能をまだ完全に実装していません。特に vinum からの次のコマンドは、サポートされません:

debug
ボリュームマネージャがカーネルデバッガに入るようにします。
debug flags
デバッグフラグを設定します。
dumpconfig [ drive ...]
指定されたドライブまたは、ドライブ名が指定されないなら、システムのすべてのドライブに格納された設定情報をリストします。
info [ -vV]
ボリュームマネージャ状態に関する情報をリストします。
label volume
ボリュームラベルを作成します。
resetstats [ -r][ volume | plex | subdisk]
指定されたオブジェクト、または、なにも指定されないなら、すべてのオブジェクトのための統計カウンタをリセットします。
setdaemon [ value]
デーモン設定を設定します。
October 1, 2013 FreeBSD