Provided by: drbd-utils_9.15.0-1ubuntu0.1_amd64 
NAME
drbdmeta - ディスク上の DRBD メタデータを操作する
SYNOPSIS
drbdmeta [--force] [--ignore-sanity-checks] {device} {v06 minor | v07 meta_dev index | v08 meta_dev index
| v09 meta_dev index} {command} [cmd args...]
DESCRIPTION
drbdmeta ユーティリティは、 DRBD のディスク上のメタデータの作成、表示、および変更に使用される。ユーザは通
常、 drbdmeta でなく、DRBD に対してより高度なインタフェースを提供する drbdadm ユーティリティを通して使用
する。(drbdadm が drbdmeta をどのように使うかを表示するには drbdadm の --dry-run オプションを使用する。)
このユーティリティは、カーネルが現在使用していないデバイスのみで使用できる。
最初の引数 （device） は、ボリュームに関連付けられている drbd デバイスを指定する。 そのボリュームに関連付
けられているデバイスがない場合 “-” を指定する。drbd デバイスが指定されている場合、 drbdmeta ユーティリ
ティは、アクティブボリュームのメタデータが破壊されないよう、drbd デバイスにボリュームが現在、接続されてい
ないことを確認する。
2番目の引数は、使用するメタデータのバージョンを指定する （v06、v07、v08、v09）。ほとんどのメタデータバー
ジョンでは、3番目の引数 （meta_dev） は、メタデータを含むデバイスを指定する。この引数はdevice と同じにで
きる。第 4 引数 （index） は次のいづれかのキーワードである: internal （内部メタデータ用）、 flex-internal
（v07 の場合、可変サイズのメタデータ、そうでない場合、デフォルトは固定サイズの内部メタデータ）、
flex-external （可変サイズの外部メタデータ）、数値メタデータインデックス（固定サイズの外部メタデー
タ）。次のコマンドの meta-disk パラメータを参照: drbd.conf(5)。
OPTIONS
--force
drbdmeta が尋ねるすべての質問に対する答えを yes とする。
--ignore-sanity-checks
通常、drbdmeta はメタデータデバイスに書き込む前に健全性チェックを実行する。たとえば、デバイスにファイ
ルシステムが含まれているように見える場合、書き込むことによってファイルシステムを破壊することを拒否す
る。これらのチェックを無視するには、このオプションを使用する。
COMMANDS
create-md [--peer-max-bio-size=val] (メタデータバージョン v06、 v07、v08),
create-md {number-of-bitmap-slots} [--peer-max-bio-size=val] [--al-stripes=val] [--al-stripe-size-kB=val]
(メタデータバージョン v09)
メタデータを初期化する。これは、 DRBD リソースを接続する前に必要である。drbdmeta デバイス上で古いバー
ジョンの DRBD メタデータが見つかると、そのフォーマットを変換する必要があるかどうかを尋ねる。
drbdadm が device に対して drbdmeta の create-md コマンドを呼びだすと, number-of-bitmap-slots 引数を
リソース内の対向ノード数にセットする。追加のビットマップスロット （将来的に対向ノードを追加できるよう
にする） を予約するには、 代わりに drbdmeta を直接呼び出す。
デバイスが最初に対向ノードに接続される前に使用される場合、DRBD は対向ノードがデフォルトで 4KiB リクエ
ストしか処理できないとみなす。--peer-max-bio-size オプションにより柔軟な値を設定できる。このデバイス
が接続する DRBD のバージョンがわかっている場合は、これを使用する。DRBD は、バージョン 8.3.8 以降 32
KiB の 最大 bio サイズ、バージョン 8.3.9 以降は 128 KiB、バージョン 8.4.0 以降は 1 MiB の最大 bio サ
イズをサポートする。
6433 以上のアクティビティログのエクステントを使用したい場合、またはストライプド RAID 上で使用する場合
には、ストライプ数 (--al-stripes、デフォルトは 1) とストライプのサイズ(--al-stripe-size-kB、デフォル
トは32)を指定することが可能。単に大きなオンディスクのリングバッファを使用する場合には、ストライプ 数
を1にし、サイズを次のように拡大する。 :
drbdmeta 0 v08 /dev/vg23/lv42 internal create-md --al-stripe-size 1M
ボトルネックの単一の「スピンドル」になるのを避けるため、ストライプ数を増やし、オンディスクのアクティ
ビティログ処理のインターリーブ対応の構成する。"stripe-size" で指定するものは、いわゆる「チャンクサイ
ズ」または「粒度」あるいは「ストライプユニット」である。つまり、次の「スピンドル」への最短のステップ
となる。
drbdmeta 0 v08 /dev/vg23/lv42 internal create-md --al-stripes 7 --al-stripe-size 64
get-gi [--node-id=id]
特定の接続上のデバイスのデータ世代識別子を表示する。DRBD バージョン 9.0.0 以降は複数の対向ノードをサ
ポートする。 node-id オプションを使用して、表示する対向ノードのデータ世代識別子を定義する。
show-gi [--node-id=id]
get-gi に似ているが、説明テキストとともに表示する。
dump-md
ビットマップおよびアクティビティログを含むデバイスのメタデータをテキスト形式でダンプする。
outdate
下位デバイスのデータ内容が「無効」であるとマークする。次のマニュアルを参照: drbdsetup(8)
dstate
下位デバイスの現在のディスク状態を表示する。
check-resize
下位デバイスのデバイスサイズと最後に認識されたデバイスサイズを調べる（drbdsetup check-resize により
/var/lib/drbd/drbd-minor-minor.lkbd にセーブされる）。内部メタデータの場合、下位レベルのデバイスのサ
イズが変更され、メタデータが前の位置にある場合は、メタデータをブロックデバイスの最後の新しい位置に移
動する。
apply-al
指定したデバイスのアクティビティログを適用する。デバイスがカーネルによって再び接続される前にこれが必
要である。
EXPERT COMMANDS
drbdmeta ユーティリティを使用してメタデータを微調整することができる。これはメタデータの破壊やデータそのも
のの破損につながる可能性がある。細心の注意を払って使用すること。
set-gi gi [--node-id=id]
世代識別子を設定する。gi 引数にはバージョン 0.6 および 0.7 では世代カウンタを、バージョン 8.x では
UUID を指定する。get-gi の出力と同じ文法を指定できる。DRBD バージョン 9.0.0 以降は複数の対向ノードを
サポートする。 --node-id オプションを使用して、設定する対向ノードのデータ世代識別子を定義する。
restore-md dump_file
デバイスのメタデータを dump_file の内容に置き換える。 ダンプファイルのフォーマットは、 dump-md コマン
ドの出力で定義される。
VERSION
このドキュメントは DRBD バージョン 9.0.0 向けに改訂されている。
AUTHOR
Written by Philipp Reisner <philipp.reisner@linbit.com> and Lars Ellenberg <lars.ellenberg@linbit.com>.
REPORTING BUGS
Report bugs to <drbd-user@lists.linbit.com>.
COPYRIGHT
Copyright 2001-2008,2012 LINBIT Information Technologies, Philipp Reisner, Lars Ellenberg. This is free
software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.
SEE ALSO
drbdadm(8) drbd.conf(5)
DRBD 9.0.0 6 December 2012 DRBDMETA(8)