Manpages

NAME

drbdmeta - DRBD の メ タ デ ー タ 管 理 ツ ー ル

SYNOPSIS

DESCRIPTION

drbdmeta は 、 DRBD メ タ デ ー タ を 作 成 、 内 容 表 示 、 あ る い は 変 更 す る 。 通 常 は フ ロ ン ト エ ン ド の コ マ ン ド を 使 う た め 、 直 接 使 用 す る 必 要 は な い 、 drbdadm(8) を 参 照 。 こ の コ マ ン ド は 、 DRBD リ ソ ー ス を 無 効 に し て あ る 場 合 、 も し く は 少 な く と も 下 位 レ ベ ル ス ト レ ー ジ か ら 切 り 離 し て あ る 場 合 の み 動 作 す る 。 最 初 の 引 数 は 、 リ ソ ー ス に 結 び 付 け た デ バ イ ス 名 で あ る 。 第 2引 数 は メ タ デ ー タ の バ ー ジ ョ ン で 、 現 在 の 主 要 な 全 バ ー ジ ョ ン (0.6、 0.7お よ び 8) を 指 定 で き る 。

OPTIONS

--force

drbdmeta か ら の す べ て の 質 問 に 'yes' と 回 答 す る よ う に す る 。

--ignore-sanity-checks サ ニ テ ィ チ ェ ッ ク を す る と drbdmeta が 終 了 す る こ と が あ る 。 メ タ デ ー タ を 作 成 す る こ と に よ り 、 フ ァ イ ル シ ス テ ム イ メ ー ジ が 破 壊 さ れ た 場 合 な ど で あ る 。 こ の オ プ シ ョ ン を 使 う こ と に よ り 、 drbdmeta が こ れ ら の チ ェ ッ ク を 無 視 す る よ う に な る 。

COMMANDS

create-md --peer-max-bio-size val --al-stripes val --al-stripe-size-kB val

create-md は メ タ デ ー タ 領 域 を 新 し く 作 成 す る 。 DRBD リ ソ ー ス を 初 め て 利 用 す る 場 合 、 オ ン ラ イ ン に す る 前 に こ の コ マ ン ド を 実 行 す る 必 要 が あ る 。 す で に 古 い バ ー ジ ョ ン の メ タ デ ー タ が 存 在 す る 場 合 、 drbdmeta は 指 定 し た バ ー ジ ョ ン の 形 式 に 変 換 す る か ど う か を 尋 ね る 。 最 初 に 対 向 ノ ー ド に 接 続 す る 前 に リ ソ ー ス を 使 用 す る 場 合 、 --peer-max-bio-size オ プ シ ョ ン を 使 用 す る と DRBD の 性 能 が 向 上 す る 。 対 向 ノ ー ド の DRBD の バ ー ジ ョ ン に よ っ て 、 こ れ ら の 値 を 使 う 。 8.3.7 → 4k、 8.3.8 → 32k、 8.3.9 → 128k、 8.4.0 → 1M。

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 64k

get-gi デ ー タ 世 代 識 別 子 (data generation identifiers) の 情 報 を 簡 潔 な テ キ ス ト 情 報 と し て 表 示 す る 。 バ ー ジ ョ ン 0.6 お よ び 0.7 形 式 の メ タ デ ー タ に は 世 代 カ ウ ン タ が あ る が 、 バ ー ジ ョ ン 8 で は UUID が 表 示 さ れ る 。

show-gi デ ー タ 世 代 識 別 子 (data generation identifiers) の 情 報 を 、 説 明 テ キ ス ト と と も に テ キ ス ト 情 報 と し て 表 示 す る 。

dump-md メ タ デ ー タ の 全 内 容 を テ キ ス ト 形 式 で ダ ン プ す る 。 ダ ン プ に は ビ ッ ト マ ッ プ と ア ク テ ィ ビ テ ィ ロ グ も 含 ま れ る 。

outdate メ タ デ ー タ に outdated フ ラ グ を た て る 。 他 ノ ー ド が 自 ノ ー ド と 通 信 で き な い 状 態 で プ ラ イ マ リ 状 態 に な り た い 場 合 、 他 ノ ー ド か ら の リ モ ー ト 実 行 で こ の コ マ ン ド が 実 行 さ れ る 。 た だ し 、 ス タ ッ ク さ れ た ノ ー ド に は で き な い 。

dstate 下 位 レ ベ ル ス ト レ ー ジ の 状 態 を 表 示 す る 。 drbdmeta は ロ ー カ ル メ タ デ ー タ の み に ア ク セ ス す る た め 、 出 力 に は は つ ね に '/DUnknown' が 表 示 さ れ る 。

check-resize 下 位 デ バ イ ス の デ バ イ ス サ イ ズ を 調 べ 、 最 新 の デ バ イ ス サ イ ズ を /var/lib/drbd/ 下 の フ ァ イ ル drbd-minor-??.lkbd に 記 録 す る 。 下 位 デ バ イ ス の サ イ ズ が 変 更 さ れ て い て 、 古 い 場 所 に メ タ デ ー タ を 検 出 し た 場 合 、 メ タ デ ー タ を 正 し い 場 所 で あ る ブ ロ ッ ク デ バ イ ス の 最 後 に 移 動 さ せ る 。

EXPERTS COMMANDS

drbdmeta を 使 う と 、 メ タ デ ー タ の 内 容 を 変 更 で き る 。 以 下 の コ マ ン ド は 、 コ マ ン ド 自 身 の 使 用 法 表 示 か ら 意 図 的 に 削 除 し て あ る 。 こ れ は 、 何 を し て い る の か 明 確 に 理 解 し た 上 で 実 行 し な い と 危 険 な た め で あ る 。 デ ー タ 世 代 識 別 子 に 間 違 っ た 値 を セ ッ ト す る と 、 古 い デ ー タ で 最 新 デ ー タ を 上 書 き し て し ま う な ど の リ ス ク が 生 じ る 。

set-gi gi デ ー タ 世 代 識 別 子 に 値 を セ ッ ト す る 。 Gi に は バ ー ジ ョ ン 0.6 お よ び 0.7 で は 世 代 カ ウ ン タ を 、 バ ー ジ ョ ン 8.x で は UUID を 指 定 す る 。 get-gi で 表 示 さ れ た 値 と 同 じ 値 を 指 定 す る こ と 。

restore-md dump_file

dump_file を 読 み 込 ん で 、 そ の 内 容 を メ タ デ ー タ に 書 き 込 む 。

VERSION

こ の ド キ ュ メ ン ト は DRBD バ ー ジ ョ ン 8.3.2 向 け に 改 訂 さ れ て い る 。

AUTHOR

Written by Philipp Reisner <philipp.reisner [AT] linbit.com> and Lars Ellenberg <lars.ellenberg [AT] linbit.com>.

REPORTING BUGS

Report bugs to <drbd-user [AT] lists.com>.

COPYRIGHT

Copyright 2001-2008 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)