'\" t
.\"     Title: drbdmeta
.\"    Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 6 December 2012
.\"    Manual: System Administration
.\"    Source: DRBD 9.0.0
.\"  Language: English
.\"
.TH "DRBDMETA" "8" "6 December 2012" "DRBD 9.0.0" "System Administration"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
drbdmeta \- ディスク上の DRBD メタデータを操作する
.SH "SYNOPSIS"
.HP \w'\fBdrbdmeta\fR\ 'u
\fBdrbdmeta\fR [\-\-force] [\-\-ignore\-sanity\-checks] {\fIdevice\fR} {v06\ \fIminor\fR | v07\ \fImeta_dev\ index\fR | v08\ \fImeta_dev\ index\fR | v09\ \fImeta_dev\ index\fR} {\fIcommand\fR} [\fIcmd\ args\fR...]
.SH "DESCRIPTION"
.PP
\fBdrbdmeta\fR
ユーティリティは、 DRBD のディスク上のメタデータの作成、表示、および変更に使用される。ユーザは通常、
\fBdrbdmeta\fR
でなく、DRBD に対してより高度なインタフェースを提供する
\fBdrbdadm\fR
ユーティリティを通して使用する。(\fBdrbdadm\fR
が
\fBdrbdmeta\fR
をどのように使うかを表示するには
\fBdrbdadm\fR
の
\fB\-\-dry\-run\fR
オプションを使用する。)
.PP
このユーティリティは、カーネルが現在使用していないデバイスのみで使用できる。
.PP
最初の引数 （\fIdevice\fR） は、ボリュームに関連付けられている drbd デバイスを指定する。 そのボリュームに関連付けられているデバイスがない場合
\(lq\-\(rq
を指定する。drbd デバイスが指定されている場合、
\fBdrbdmeta\fR
ユーティリティは、アクティブボリュームのメタデータが破壊されないよう、drbd デバイスにボリュームが現在、接続されていないことを確認する。
.PP
2番目の引数は、使用するメタデータのバージョンを指定する （v06、v07、v08、v09）。ほとんどのメタデータバージョンでは、3番目の引数 （\fImeta_dev\fR） は、メタデータを含むデバイスを指定する。この引数は\fIdevice\fR
と同じにできる。第 4 引数 （\fIindex\fR） は次のいづれかのキーワードである:
\fBinternal\fR
（内部メタデータ用）、
\fBflex\-internal\fR
（v07 の場合、可変サイズのメタデータ、そうでない場合、デフォルトは固定サイズの内部メタデータ）、
\fBflex\-external\fR
（可変サイズの外部メタデータ）、数値メタデータインデックス（固定サイズの外部メタデータ）。次のコマンドの
\fBmeta\-disk\fR
パラメータを参照:
\fBdrbd.conf\fR(5)。
.SH "OPTIONS"
.PP
\-\-force
.RS 4
drbdmeta が尋ねるすべての質問に対する答えを yes とする。
.RE
.PP
\-\-ignore\-sanity\-checks
.RS 4
通常、\fBdrbdmeta\fR
はメタデータデバイスに書き込む前に健全性チェックを実行する。たとえば、デバイスにファイルシステムが含まれているように見える場合、書き込むことによってファイルシステムを破壊することを拒否する。これらのチェックを無視するには、このオプションを使用する。
.RE
.SH "COMMANDS"
.PP
\fBcreate\-md\fR [\fB\-\-peer\-max\-bio\-size=\fR\fIval\fR] (メタデータバージョン v06、 v07、v08), 
.br
\fBcreate\-md\fR {number\-of\-bitmap\-slots} [\fB\-\-peer\-max\-bio\-size=\fR\fIval\fR] [\fB\-\-initialize\-bitmap\-mode=\fR\fI{automatic|zeroout|pwrite|skip}\fR] [\fB\-\-al\-stripes=\fR\fIval\fR] [\fB\-\-al\-stripe\-size\-kB=\fR\fIval\fR] (metadata version v09)
.RS 4
メタデータを初期化する。これは、 DRBD リソースを接続する前に必要である。\fBdrbdmeta\fR
デバイス上で古いバージョンの DRBD メタデータが見つかると、そのフォーマットを変換する必要があるかどうかを尋ねる。
.sp
\fBdrbdadm\fR
が device に対して
\fBdrbdmeta\fR
の
\fBcreate\-md\fR
コマンドを呼びだすと,
\fInumber\-of\-bitmap\-slots\fR
引数をリソース内の対向ノード数にセットする。追加のビットマップスロット （将来的に対向ノードを追加できるようにする） を予約するには、 代わりに
\fBdrbdmeta\fR
を直接呼び出す。
.sp
デバイスが最初に対向ノードに接続される前に使用される場合、DRBD は対向ノードがデフォルトで 4KiB リクエストしか処理できないとみなす。\fB\-\-peer\-max\-bio\-size\fR
オプションにより柔軟な値を設定できる。このデバイスが接続する DRBD のバージョンがわかっている場合は、これを使用する。DRBD は、バージョン 8\&.3\&.8 以降 32 KiB の 最大 bio サイズ、バージョン 8\&.3\&.9 以降は 128 KiB、バージョン 8\&.4\&.0 以降は 1 MiB の最大 bio サイズをサポートする。
.sp
By default, we explicitly initialize the bitmap area to all zero\&. With
\fB\-\-initialize\-bitmap\-mode\fR
you can chose to only try the fast method (\fBzeroout\fR, try ioctl BLKZEROOUT only), only use explicit
\fBpwrite\fR
calls, or
\fBskip\fR
this bitmap initialization phase completely\&. If you intend to do an initial full sync anyways, you can use
\fBskip\fR
to leave the bitmap initialization to the kernel\&. This can make a noticable difference when initializing huge volumes\&. Default is
\fBautomatic\fR, which is zeroout with an implicit fallback to pwrite\&.
.sp
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 (\fB\-\-al\-stripes\fR, default 1), and the stripe size (\fB\-\-al\-stripe\-size\-kB\fR, default 32)\&. To just use a larger linear on\-disk ring\-buffer, leave the number of stripes at 1, and increase the size only:

\fBdrbdmeta 0 v08 /dev/vg23/lv42 internal create\-md \-\-al\-stripe\-size 1M\fR
.sp
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"\&.

\fBdrbdmeta 0 v08 /dev/vg23/lv42 internal create\-md \-\-al\-stripes 7 \-\-al\-stripe\-size 64\fR
.RE
.PP
\fBget\-gi\fR [\fB\-\-node\-id=\fR\fIid\fR]
.RS 4
特定の接続上のデバイスのデータ世代識別子を表示する。DRBD バージョン 9\&.0\&.0 以降は複数の対向ノードをサポートする。
\fInode\-id\fR
オプションを使用して、表示する対向ノードのデータ世代識別子を定義する。
.RE
.PP
\fBshow\-gi\fR [\fB\-\-node\-id=\fR\fIid\fR]
.RS 4
\fBget\-gi\fR
に似ているが、説明テキストとともに表示する。
.RE
.PP
\fBdump\-md\fR
.RS 4
ビットマップおよびアクティビティログを含むデバイスのメタデータをテキスト形式でダンプする。
.RE
.PP
\fBoutdate\fR
.RS 4
下位デバイスのデータ内容が「無効」であるとマークする。次のマニュアルを参照:
\fBdrbdsetup\fR(8)
.RE
.PP
\fBdstate\fR
.RS 4
下位デバイスの現在のディスク状態を表示する。
.RE
.PP
\fBcheck\-resize\fR
.RS 4
下位デバイスのデバイスサイズと最後に認識されたデバイスサイズを調べる（\fBdrbdsetup check\-resize\fR
により
\fB/var/lib/drbd/drbd\-minor\-\fR\fB\fIminor\fR\fR\fB\&.lkbd\fR
にセーブされる）。内部メタデータの場合、下位レベルのデバイスのサイズが変更され、メタデータが前の位置にある場合は、メタデータをブロックデバイスの最後の新しい位置に移動する。
.RE
.PP
\fBapply\-al\fR
.RS 4
指定したデバイスのアクティビティログを適用する。デバイスがカーネルによって再び接続される前にこれが必要である。
.RE
.SH "EXPERT COMMANDS"
.PP
\fBdrbdmeta\fR
ユーティリティを使用してメタデータを微調整することができる。これはメタデータの破壊やデータそのものの破損につながる可能性がある。細心の注意を払って使用すること。
.PP
\fBset\-gi\fR \fIgi\fR [\fB\-\-node\-id=\fR\fIid\fR]
.RS 4

世代識別子を設定する。\fIgi\fR
引数にはバージョン 0\&.6 および 0\&.7 では世代カウンタを、バージョン 8\&.x では UUID を指定する。\fBget\-gi\fR
の出力と同じ文法を指定できる。DRBD バージョン 9\&.0\&.0 以降は複数の対向ノードをサポートする。
\fI\-\-node\-id\fR
オプションを使用して、設定する対向ノードのデータ世代識別子を定義する。
.RE
.PP
\fBrestore\-md\fR \fIdump_file\fR
.RS 4
デバイスのメタデータを
\fIdump_file\fR
の内容に置き換える。 ダンプファイルのフォーマットは、
\fBdump\-md\fR
コマンドの出力で定義される。
.RE
.SH "VERSION"
.sp
このドキュメントは DRBD バージョン 9\&.0\&.0 向けに改訂されている。
.SH "AUTHOR"
.sp
Written by Philipp Reisner <philipp\&.reisner@linbit\&.com> and Lars Ellenberg <lars\&.ellenberg@linbit\&.com>\&.
.SH "REPORTING BUGS"
.sp
Report bugs to <drbd\-user@lists\&.linbit\&.com>\&.
.SH "COPYRIGHT"
.sp
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\&.
.SH "SEE ALSO"
.PP
\fBdrbdadm\fR(8)
\fBdrbd.conf\fR(5)