table of contents
| DRBDMETA(8) | System Administration | DRBDMETA(8) |
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
--ignore-sanity-checks
COMMANDS¶
create-md [--peer-max-bio-size=val]
(メタデータバージョン
v06、 v07、v08),
create-md {number-of-bitmap-slots}
[--peer-max-bio-size=val]
[--initialize-bitmap-mode={automatic|zeroout|pwrite|skip}]
[--al-stripes=val] [--al-stripe-size-kB=val]
(metadata version v09)
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 サイズをサポートする。
By default, we explicitly initialize the bitmap area to all zero. With --initialize-bitmap-mode you can chose to only try the fast method (zeroout, try ioctl BLKZEROOUT only), only use explicit pwrite calls, or skip this bitmap initialization phase completely. If you intend to do an initial full sync anyways, you can use skip to leave the bitmap initialization to the kernel. This can make a noticable difference when initializing huge volumes. Default is automatic, which is zeroout with an implicit fallback to pwrite.
If you want to use more than 6433 activity log extents, or live on top of a spriped RAID, you may specify the number of stripes (--al-stripes, default 1), and the stripe size (--al-stripe-size-kB, default 32). To just use a larger linear on-disk ring-buffer, leave the number of stripes at 1, and increase the size only:
drbdmeta 0 v08 /dev/vg23/lv42 internal create-md --al-stripe-size 1M
To avoid a single "spindle" from becoming a bottleneck, increase the number of stripes, to achieve an interleaved layout of the on-disk activity-log transactions. What you give as "stripe-size" should be what is a.k.a. "chunk size" or "granularity" or "strip unit": the minimum skip to the next "spindle".
drbdmeta 0 v08 /dev/vg23/lv42 internal create-md --al-stripes 7 --al-stripe-size 64
get-gi [--node-id=id]
show-gi [--node-id=id]
dump-md
outdate
dstate
check-resize
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
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¶
| 6 December 2012 | DRBD 9.0.0 |