Manpages

NAME

drbdsetup - DRBD を 設 定 す る ツ ー ル

SYNOPSIS

DESCRIPTION

drbdsetup は 、 DRBD デ バ イ ス と 下 位 レ ベ ル ブ ロ ッ ク デ バ イ ス を 結 び つ け る 、 DRBD デ バ イ ス 間 で 下 位 レ ベ ル デ バ イ ス 同 士 ミ ラ ー リ ン グ を 設 定 す る 、 現 在 実 行 中 の DRBD デ バ イ ス の 設 定 を 検 査 す る 、 な ど の 目 的 で 使 用 す る 。

NOTE

drbdsetup は DRBD プ ロ グ ラ ム 群 の 中 で 低 レ ベ ル の ツ ー ル で あ る 。 デ バ イ ス ド ラ イ バ を 操 作 す る た め に 、 drbddisk や drbd ス ク リ プ ト な ど の 中 で 使 用 さ れ る 。

COMMANDS

サ ブ コ マ ン ド の 中 に は 、 独 自 の 引 数 や オ プ シ ョ ン を 持 つ も の が あ る 。 す べ て の 値 は デ フ ォ ル ト の 単 位 が あ る が 、 K、 M、 G と い っ た 通 常 の 方 法 で も 定 義 で き (K=2^10=1024、 M=1024K、 G=1024M)。

Common options す べ て の drbdsetup サ ブ コ マ ン ド に 次 の オ プ シ ョ ン を 指 定 す る こ と が で き る 。

--create-device 指 定 し た DRBD デ バ イ ス に 対 応 す る デ バ イ ス フ ァ イ ル が な い 場 合 、 自 動 的 に 作 成 す る す る よ う 指 定 す る 。

new-resource リ ソ ー ス は DRBD 構 成 の 最 初 の 対 象 で あ る 。 リ ソ ー ス は い か な る ボ リ ュ ー ム や マ イ ナ ー デ バ イ ス が 作 成 さ れ る よ り 前 に new-resource コ マ ン ド で 作 成 さ れ な け れ ば な ら な い 。 コ ネ ク シ ョ ン は 名 前 で 参 照 さ れ る 。

new-minor
minor は 複 製 さ れ た ブ ロ ッ ク デ バ イ ス と 同 じ 意 味 で 使 わ れ 、 ブ ロ ッ ク デ バ イ ス と し て /dev/ デ ィ レ ク ト リ で 表 示 さ れ て い る 。 こ れ は DRBD が 複 製 す る ブ ロ ッ ク デ バ イ ス へ の ア プ リ ケ ー シ ョ ン の イ ン タ ー フ ェ ー ス で あ る 。 drbdsetup の コ マ ン ド ラ イ ン で 、 こ れ ら の ブ ロ ッ ク デ バ イ ス は マ イ ナ ー 番 号 に よ っ て ア ド レ ス 指 定 さ れ る 。 複 製 さ れ た ブ ロ ッ ク デ バ イ ス の 組 は 2 マ シ ン 間 で 異 な っ た マ イ ナ ー 番 号 を 持 つ 場 合 も あ る が 、 共 通 の ボ リ ュ ー ム 番 号 で 関 連 付 け さ れ て い る 。 ボ リ ュ ー ム 番 号 は 各 々 の 接 続 に お け る ロ ー カ ル な も の で あ る 。 マ イ ナ ー 番 号 は 一 つ の ノ ー ド に お け る グ ロ ー バ ル な も の で あ る 。

del-resource リ ソ ー ス の オ ブ ジ ェ ク ト を 破 棄 す る 。 リ ソ ー ス に 値 が な い 場 合 の み 可 能 。

del-minor マ イ ナ ー は デ ィ ス ク が 外 さ れ て い る 場 合 の み 破 棄 で き る 。

attach, disk-options
Attach は デ バ イ ス と 下 位 ブ ロ ッ ク デ バ イ ス を 接 続 す る 。 -d (ま た は --disk-size) は 下 位 ブ ロ ッ ク デ バ イ ス を で き る だ け 使 い た く な い 場 合 に の み 使 用 す る 。 -d を 使 わ な い 場 合 、 デ バ イ ス は 対 向 ノ ー ド に 接 続 さ れ る と す ぐ に 使 用 で き る 状 態 に な る 。 (net コ マ ン ド を 参 照 )

disk-options コ マ ン ド を 使 う と 、 接 続 さ れ て い る 間 、 そ の マ イ ナ ー の オ プ シ ョ ン 変 更 が で き る 。

--disk-size size

DRBD は 利 用 で き る デ ー タ 領 域 を 自 動 的 に 決 定 す る 機 能 を 持 つ 。 こ れ ま で 対 向 ノ ー ド に 接 続 し た こ と の な い デ バ イ ス を 使 用 す る 場 合 に 、 DRBD デ バ イ ス の サ イ ズ を ド ラ イ バ に 渡 す た め に こ の オ プ シ ョ ン を 使 用 す る 。 デ フ ォ ル ト の 単 位 は セ ク タ (1s=512バ イ ト ) で あ る 。

size パ ラ メ ー タ を drbd.conf で 使 用 す る 場 合 に は 、 明 示 的 に 単 位 を 追 加 す る 事 が 推 奨 さ れ る 。 drbdadm と drbdsetup は デ フ ォ ル ト の 単 位 で 、 し ば し ば 食 い 違 い に な る こ と が あ る 。

--on-io-error err_handler 下 位 デ バ イ ス の ド ラ イ バ が エ ラ ー を 伝 え た 場 合 に DRBD は デ ィ ス ク を 不 整 合 と マ ー ク す る 。 そ し て ヘ ル パ ー プ ロ グ ラ ム を 呼 び 出 す か 、 デ バ イ ス を 下 位 ス ト レ ー ジ か ら 切 り 離 し て 以 後 の I/O を 対 向 ノ ー ド に 委 ね る 。 err_handlers に 指 定 で き る 値 は 、 pass_on, call-local-io-error, detach で あ る 。

--fencing fencing_policy

fencing は 、 2つ の ノ ー ド が と も に プ ラ イ マ リ に な る こ と (ス プ リ ッ ト ブ レ イ ン ) を 防 止 し 、 ど ち ら か を 切 り 離 す 防 御 手 段 の こ と で あ る 。 次 の フ ェ ン シ ン グ ポ リ シ ー を 指 定 で き る :

dont-care デ フ ォ ル ト の 設 定 値 で 、 フ ェ ン シ ン グ の た め の ア ク シ ョ ン を な に も 実 行 し な い 。

resource-only ノ ー ド が 切 り 離 さ れ た プ ラ イ マ リ 状 態 に な る と 、 DRBD は 他 ノ ー ド を 無 効 状 態 に 変 え よ う と し て 、 fence-peer ハ ン ド ラ を 実 行 す る 。 こ の ハ ン ド ラ に は 、 レ プ リ ケ ー シ ョ ン 用 と は 別 の ネ ッ ト ワ ー ク 経 由 で 他 ノ ー ド に ア ク セ ス し 、 'drbdadm outdate res' を 実 行 す る と い う 機 能 が 期 待 さ れ る 。

resource-and-stonith ノ ー ド が 切 り 離 さ れ た プ ラ イ マ リ 状 態 に な る と 、 DRBD は す べ て の デ ィ ス ク I/O を 停 止 し て fence-peer ハ ン ド ラ を 呼 び 出 す 。 こ の ハ ン ド ラ に は 、 レ プ リ ケ ー シ ョ ン 用 と は 別 の ネ ッ ト ワ ー ク 経 由 で 他 ノ ー ド に ア ク セ ス し 、 'drbdadm outdate res' を 実 行 す る と い う 機 能 を 想 定 し て い る 。 ハ ン ド ラ が 他 ノ ー ド に 到 達 で き な い 場 合 、 DRBD は STONITH 機 能 を 使 っ て 他 ノ ー ド を 強 制 排 除 す る 。 こ れ ら が 完 了 し た ら 、 デ ィ ス ク I/O を 再 開 す る 。 ハ ン ド ラ が 失 敗 し た 場 合 に は 、 resume-io コ マ ン ド で デ ィ ス ク I/O を 再 開 で き る 。

--disk-barrier,
--disk-flushes,
--disk-drain

DRBD は 下 位 デ バ イ ス に 対 す る 複 数 の デ ィ ス ク 書 き 込 み の 間 の 依 存 関 係 を 指 定 す る た め の 4 種 類 の オ プ シ ョ ン を 用 意 し て い る 。 そ の う ち 、 下 位 デ バ イ ス が サ ポ ー ト し て い て ユ ー ザ が 無 効 に 設 定 し て い な い 最 初 の オ プ シ ョ ン が 使 用 さ れ る 。 デ フ ォ ル ト で は flush メ ソ ッ ド が 使 わ れ る 。

drbd-8.4.2 か ら disk-barrier は 、 linux-2.6.36 (及 び RHEL6 の 2.6.32) 以 降 で の 正 常 動 作 が 確 認 で き な い た め デ フ ォ ル ト で 無 効 に な っ た 。 注 意 : 有 識 者 に よ る 指 示 の も と で の み 使 用 す る こ と 。 手 法 を 選 択 す る に あ た っ て は 、 測 定 可 能 な パ フ ォ ー マ ン ス デ ー タ の み に 頼 る べ き で は な い 。 下 位 デ バ イ ス が 揮 発 性 の 書 き 込 み キ ャ ッ シ ュ し か 持 た な い 場 合 (通 常 の ハ ー ド デ ィ ス ク や 通 常 の ハ ー ド デ ィ ス ク だ け で 構 成 さ れ る RAID な ど )、 最 初 の 2 つ の オ プ シ ョ ン の ど ち ら か を 使 う べ き で あ る 。 下 位 デ バ イ ス に バ ッ テ リ バ ッ ク ア ッ プ 機 能 付 き の 書 き 込 み キ ャ ッ シ ュ が あ る 場 合 に は 、 3 番 目 の オ プ シ ョ ン が 利 用 で き る 。 4番 目 の オ プ シ ョ ン (す べ て を 無 効 に す る 場 合 は "none") は 、 ほ と ん ど の I/O ス タ ッ ク に お い て 危 険 で 、 デ ィ ス ク へ の 書 き 込 み 順 序 が 入 れ 替 わ っ て し ま う 可 能 性 が あ る 。 no-disk-drain を 使 っ て は な ら な い 。 残 念 な こ と に 、 デ バ イ ス マ ッ パ (LVM) は バ リ ア を サ ポ ー ト し て い な い 。

/proc/drbd の "wo:" の 文 字 の 後 ろ に 、 下 位 デ バ イ ス に 対 す る 現 在 の 設 定 が b, f, d, n の 文 字 で 表 示 さ れ る 。 オ プ シ ョ ン は 次 の と お り :

barrier 下 位 デ バ イ ス が バ リ ア (SCSI で は "tagged command queuing"、 SATA で は "native com-mand queuing" と 呼 ば れ る ) を サ ポ ー ト し て い る 場 合 、 こ の オ プ シ ョ ン を 選 択 で き る 。 こ の オ プ シ ョ ン を 有 効 に す る に は disk-barrier オ プ シ ョ ン を yes に す る 。

flush 下 位 デ バ イ ス が デ ィ ス ク フ ラ ッ シ ュ (ベ ン ダ ー は "force unit access" と 呼 ん で い る ) を サ ポ ー ト し て い る 場 合 、 こ の オ プ シ ョ ン を 選 択 で き る 。 こ の オ プ シ ョ ン を 無 効 に す る に は disk-flushes を no に 設 定 す る 。

drain

３ 番 目 の 方 法 は 、 単 純 に 、 最 初 の 書 き 込 み は 次 の 書 き 込 み リ ク エ ス ト を 処 理 す る 前 に 吐 き 出 す 、 方 法 で あ る 。 8.0.9 ま で は こ れ が 唯 一 の オ プ シ ョ ン で あ っ た 。

none

no-disk-drain を 指 定 す る と 、 下 位 デ バ イ ス へ の 書 き 込 み の 依 存 関 係 を 一 切 指 示 し な く な る 。 こ れ は ほ と ん ど の I/O ス タ ッ ク に お い て 危 険 で あ り 、 デ ィ ス ク へ の 書 き 込 み 順 序 が 入 れ 替 わ っ て し ま う 可 能 性 が あ る 。 そ う な る と 、 理 論 的 に は デ ー タ 破 損 の 原 因 、 ま た は DRBD プ ロ ト コ ル を 乱 し 、 再 接 続 と 切 断 を 繰 り 返 す よ う な 状 態 に 陥 る 可 能 性 が あ る 。 no-disk-drain を 使 っ て は な ら な い 。

--md-flushes メ タ デ ー タ デ バ イ ス へ の ア ク セ ス に あ た っ て バ リ ア や フ ラ ッ シ ュ を 使 用 し な い 。 See the notes on --disk-flushes.

--max-bio-bvecs あ る 特 別 な 環 境 に お い て 、 デ バ イ ス マ ッ パ ー ス タ ッ ク は 、 複 数 の bvec を 持 つ 制 約 に 違 反 す る BIO を merge_bvec（ ） 関 数 の ４ 番 目 の 引 数 に 設 定 し DRBD に 渡 す 。 例 え ば 、 物 理 デ ィ ス ク → DRBD → LVM → Xen → 誤 っ た パ ー テ ィ シ ョ ン (63) → DomU FS の 場 合 で あ る 。 Dom0 の カ ー ネ ル ロ グ に は 、 "bio would need to, but cannot, be split:" と 記 録 さ れ る 。 最 も 良 い 回 避 方 法 は 、 VM の 内 部 に パ ー テ ィ シ ョ ン を 適 切 に 配 置 す る (例 え ば 、 セ ク タ 1024 か ら 開 始 す る ) こ と で あ る 。 こ れ は 、 ス ト レ ー ジ 領 域 を 480 KiB を 消 費 す る 。 残 念 な が ら 、 ほ と ん ど の Linux パ ー テ ィ シ ョ ン ツ ー ル は 、 奇 数 (63) で パ ー テ ィ シ ョ ン を 開 始 す る 。 そ の た め 、 ほ と ん ど の デ ィ ス ト リ ビ ュ ー シ ョ ン は 、 仮 想 Linux マ シ ン に イ ン ス ト ー ル を 行 う と 、 誤 っ た パ ー テ ィ シ ョ ン で 終 了 し て し ま う 。 第 2 の 回 避 方 法 は 、 BIO あ た り の 最 大 DRBD bvecs (= max-bio-bvecs) を 1 に す る こ と で あ る 。 し か し 、 パ フ ォ ー マ ン ス は 低 下 す る 。

max-bio-bvecs の デ フ ォ ル ト 値 は 0 で 、 こ れ は ユ ー ザ に 制 限 が 無 い こ と を 意 味 す る 。

--resync-rate rate

DRBD の 上 位 で 動 作 す る ア プ リ ケ ー シ ョ ン の 円 滑 な 実 行 の た め に 、 バ ッ ク グ ラ ウ ン ド の 同 期 作 業 が 利 用 す る 帯 域 幅 を 制 限 で き る 。 デ フ ォ ル ト 値 は 250KiB/秒 、 デ フ ォ ル ト 単 位 は KiB/秒 で あ る 。

--resync-after minor

minor に 指 定 し た マ イ ナ ー 番 号 を 持 つ デ バ イ ス が 接 続 さ れ る と 、 こ の デ バ イ ス の 再 同 期 を 開 始 す る 。 接 続 さ れ る ま で の 間 は SyncPause 状 態 に な る 。

--al-extents extents

DRBD は ホ ッ ト エ リ ア を 自 動 的 に 検 出 す る 。 こ の パ ラ メ ー タ を 指 定 す る と 、 ホ ッ ト エ リ ア の 大 き さ を 制 御 で き る 。 各 エ ク ス テ ン ト は 、 下 位 デ バ イ ス の 4MB の 領 域 に な る 。 予 定 外 の 事 情 に よ っ て プ ラ イ マ リ ノ ー ド が ク ラ ス タ か ら 切 り 離 さ れ る と 、 そ の と き の ホ ッ ト エ リ ア の デ ー タ は 、 次 回 接 続 し た と き の 再 同 期 の 対 象 に な る 。 こ の デ ー タ 構 造 は 、 メ タ デ ー タ 領 域 に 書 き 込 ま れ る 。 し た が っ て 、 ホ ッ ト エ リ ア の 状 態 更 新 は 、 メ タ デ ー タ デ バ イ ス へ の 書 き 込 み を 引 き 起 こ す 。 エ ク ス テ ン ト 値 を 大 き く す る と 、 再 同 期 所 要 時 間 が 長 く な る が 、 メ タ デ ー タ の 更 新 頻 度 を 減 ら す こ と が で き る 。 extents の デ フ ォ ル ト 値 は 1237 で あ る 。 (最 小 値 :7、 最 大 値 :65534) 追 加 の 制 限 と 必 要 な 準 備 に つ い て は 、 次 の マ ニ ュ ア ル を 参 照 :drbd.conf(5) , drbdmeta(8)

--al-updates {yes | no}

DRBD の ア ク テ ィ ビ テ ィ ロ グ 処 理 の 書 き 込 み に よ っ て 、 プ ラ イ マ リ ノ ー ド の ク ラ ッ シ ュ 後 の 部 分 的 な (ビ ッ ト マ ッ プ に 基 づ く ) 再 同 期 で ノ ー ド を up-to-date に 復 帰 さ せ る 事 が で き る よ う に な る 。 al-updates を no に 設 定 す る と 通 常 の 運 用 パ フ ォ ー マ ン ス が 向 上 す る か も し れ な い が 、 ク ラ ッ シ ュ 時 に プ ラ イ マ リ が 再 接 続 し た 際 に は フ ル 同 期 と な る 。 デ フ ォ ル ト 値 は yes で あ る 。

--c-plan-ahead plan_time,
--c-fill-target fill_target,
--c-delay-target delay_target,
--c-max-rate max_rate

plan_time に 正 の 値 を 指 定 す る と 、 再 同 期 速 度 を 動 的 に 調 整 で き る よ う に な る 。 こ れ は 、 fill_target に 指 定 し た 一 定 速 度 で 、 あ る い は delay_target に 指 定 し た 一 定 の 遅 延 で デ ー タ を 送 信 バ ッ フ ァ に 送 り 込 む こ と に よ っ て 実 現 さ れ る 。 調 整 に お け る 最 大 値 は max_rate で 指 定 す る 。

plan_time パ ラ メ ー タ で 調 節 機 能 の 機 敏 さ を 設 定 す る 。 大 き な 値 を 設 定 す る と 、 調 節 機 能 の レ ス ポ ン ス が 低 下 す る 。 こ の 値 は 最 低 で も ネ ッ ト ワ ー ク の RTT の 5 倍 以 上 を 指 定 す る 。 通 常 の デ ー タ 経 路 で は fill_target に 4k か ら 100k を 指 定 す る の が 適 切 で あ る 。 DRBD-Proxy を 使 用 す る 場 合 に は 、 代 わ り に delay_target を 使 用 す る の が 望 ま し い 。 delay_target は fill_target が 0 の 場 合 に の み 使 用 で き る 。 初 期 値 は RTT の 5 倍 が 適 切 で あ る 。 Max_rate に は DRBD 間 ま た は DRBD-Proxy 間 の 帯 域 幅 あ る い は デ ィ ス ク 帯 域 幅 を 指 定 す る 。

plan_time の デ フ ォ ル ト 値 は 0 で 、 0.1 秒 単 位 で 指 定 す る 。 Fill_target の デ フ ォ ル ト 値 は 0 で セ ク タ 数 を 指 定 す る 。 Delay_target の デ フ ォ ル ト 値 は 1 (100 ミ リ 秒 ) で 0.1 秒 単 位 で 指 定 す る 。 Max_rate の デ フ ォ ル ト 値 は 10240 (100MiB/s) で 、 KiB/s 単 位 で 指 定 す る 。

--c-min-rate min_rate 再 同 期 の 際 、 デ ィ ス ク I/O 速 度 を 監 視 す る と 、 下 位 レ ベ ル デ バ イ ス が 再 同 期 し て い な い こ と が わ か る 。 下 位 レ ベ ル デ バ イ ス が ビ ジ ー で 、 再 同 期 速 度 が min_rate を 超 え て い る 場 合 、 再 同 期 の 処 理 を 調 整 す る 。

min_rate の デ フ ォ ル ト 値 は 4M で 、 k 単 位 で 指 定 す る 。 調 整 し た く な い 場 合 は 0 を 設 定 す る 。 常 に 調 整 す る 場 合 は 1 を 設 定 す る 。

-t, --disk-timeout disk_timeout

DRBD デ バ イ ス が デ ー タ を 格 納 す る 下 位 レ ベ ル デ バ イ ス が 、 指 定 し た disk-timeout 以 内 で I/O リ ク エ ス ト を 完 了 し な い 場 合 、 DRBD は こ れ を 障 害 と み な す 。 下 位 デ バ イ ス は 切 り 離 さ れ 、 デ バ イ ス の デ ィ ス ク 状 態 は デ ィ ス ク レ ス 状 態 に な る 。 DRBD が 1 台 以 上 の 対 向 ノ ー ド に 接 続 し た と き 、 失 敗 し た リ ク エ ス ト は そ の う ち 1 台 に 伝 え ら れ る 。 こ の オ プ シ ョ ン は カ ー ネ ル パ ニ ッ ク を 引 き 起 こ す 可 能 性 が あ り 、 注 意 が 必 要 で あ る 。 リ ク エ ス ト の 「 中 断 」 あ る い は デ ィ ス ク の 強 制 切 り 離 し は 、 完 全 に 下 位 デ バ イ ス を ブ ロ ッ ク ま た は ハ ン ギ ン グ し て 、 リ ク エ ス ト を ま っ た く 処 理 せ ず エ ラ ー も 処 理 し な く な る 。 こ の 状 況 で は ハ ー ド リ セ ッ ト と フ ェ イ ル オ ー バ 以 外 に な す 術 が な い 。 「 中 断 」 す る と 、 基 本 的 に ロ ー カ ル エ ラ ー の 完 了 を 装 い 、 す み や か に サ ー ビ ス の 移 行 を 行 う こ と で 安 全 な 切 り 替 え を 行 う 。 そ れ で も な お 、 影 響 を 受 け る ノ ー ド は "す ぐ " に 再 起 動 さ れ る 必 要 は あ る 。 リ ク エ ス ト を 完 了 す る こ と で 、 上 位 レ イ ヤ ー に 関 連 す る デ ー タ ペ ー ジ を 再 利 用 さ せ る こ と が で き る 。 後 に ロ ー カ ル の 下 位 デ バ イ ス が 「 復 帰 」 す る と 、 デ ィ ス ク か ら 元 の リ ク エ ス ト ペ ー ジ へ の DMA の デ ー タ は 、 う ま く い く と 未 使 用 の ペ ー ジ へ ラ ン ダ ム な デ ー タ を 送 る が 、 多 く の 場 合 そ の 間 に 関 係 の な い デ ー タ に 変 形 し て し ま い 、 様 々 な ダ メ ー ジ の 原 因 に な る 。 つ ま り 遅 延 し た 正 常 な 完 了 は 、 特 に 読 み 込 み リ ク エ ス ト の 場 合 panic() の 原 因 に な る 。 遅 延 し た 「 エ ラ ー 」 完 了 は 、 そ の 都 度 に 通 知 は 行 う が 、 問 題 な い と 考 え て よ い 。

disk-timeout の デ フ ォ ル ト 値 は 0 で あ り 、 無 限 の タ イ ム ア ウ ト を 意 味 す る 。 タ イ ム ア ウ ト は 0.1 秒 単 位 で 指 定 す る 。 こ の オ プ シ ョ ン は DRBD 8.3.12. か ら 利 用 で き る 。

--discard-zeroes-if-aligned {yes | no}

discard-zeroes-if-aligned を no に 設 定 す る と 、 そ れ ぞ れ の バ ッ ク エ ン ド が discard_zeroes_data = false を ア ナ ウ ン ス す る 場 合 、 DRBD は 常 に 受 信 側 で ゼ ロ ア ウ ト に フ ォ ー ル バ ッ ク し 、 プ ラ イ マ リ 側 で は discard に 関 し て 通 知 し な い 。

discard-zeroes-if-aligned を yes に 設 定 す る と 、 discard_zeroes_data = false を 通 知 す る バ ッ ク エ ン ド で あ っ て も DRBD は discard を 使 用 し 、 discard_zeroes_data = true を 通 知 す る 。 私 た ち は 、 discard_zeroes_data 設 定 を 完 全 に 無 視 し て い ま し た 。 確 立 し 、 期 待 さ れ た 動 作 を 壊 さ な い た め の デ フ ォ ル ト 値 は yes で あ る 。 こ の オ プ シ ョ ン は 8.4.7 か ら 有 効 で あ る 。 追 加 の 制 限 と 必 要 な 準 備 に つ い て は 、 次 の マ ニ ュ ア ル を 参 照 :drbd.conf(5).

--disable-write-same {yes | no} 一 部 の デ ィ ス ク は 、 WRITE_SAME サ ポ ー ト を カ ー ネ ル に 通 知 す る が 、 実 際 に そ の よ う な リ ク エ ス ト を 受 信 す る と 、 I/O エ ラ ー で 失 敗 す る 。 こ れ は 主 に 、 仮 想 化 さ れ た デ ィ ス ク を 使 用 し て い る と き に 発 生 す る 。 特 に 、 こ の 動 作 は VMware の 仮 想 デ ィ ス ク で 観 察 さ れ て い る 。

disable-write-same を yes に 設 定 す る と 、 WRITE_SAME サ ポ ー ト が 手 動 で 無 効 に で き る 。

disable-write-same の デ フ ォ ル ト 値 は no で あ る 。 こ の オ プ シ ョ ン は 8.4.7 か ら 有 効 で あ る 。

--read-balancing method 読 み 込 み リ ク エ ス ト の 負 荷 分 散 で 使 用 で き る methods は prefer-local, prefer-remote, round-robin, least-pending, when-congested-remote, 32K-striping, 64K-striping, 128K-striping, 256K-striping, 512K-striping, 1M-striping で あ る 。

read-balancing の デ フ ォ ル ト 値 は prefer-local で あ る 。 こ の オ プ シ ョ ン は 8.4.1 か ら 有 効 で あ る 。

--rs-discard-granularity bytes

rs-discard-granularity が ゼ ロ 以 外 の 正 の 値 に 設 定 さ れ て い る 場 合 、 DRBD は こ の サ イ ズ で 再 同 期 操 作 を 要 求 す る 。 そ の よ う な ブ ロ ッ ク が 同 期 ソ ー ス ノ ー ド 上 に ゼ ロ バ イ ト し か 含 ま な い 場 合 、 同 期 タ ー ゲ ッ ト ノ ー ド は 、 そ の 領 域 に 対 し て discard/trim/unmap コ マ ン ド を 発 行 す る 。 こ の 値 は 、 下 位 ブ ロ ッ ク デ バ イ ス の discard 粒 度 に よ っ て 制 約 さ れ る 。 rs-discard-granularity が 下 位 ブ ロ ッ ク デ バ イ ス の discard 粒 度 の 乗 数 で な い 場 合 、 DRBD は そ れ を 切 り 上 げ る 。 こ の 機 能 は 、 下 位 ブ ロ ッ ク デ バ イ ス が discard コ マ ン ド の 後 に 、 ゼ ロ を 読 み 戻 す 場 合 に の み ア ク テ ィ ブ に な る 。

rs-discard-granularity の デ フ ォ ル ト 値 は 0 で あ る 。 こ の オ プ シ ョ ン は 8.4.7 か ら 有 効 で あ る 。

connect, net-options
Connect は device を af:local_addr:port の 内 向 き の コ ネ ク シ ョ ン を Listen さ せ 、 ま た af:remote_addr:port へ 接 続 さ せ る 。 port が 省 略 さ れ る と 、 デ フ ォ ル ト で 7788 が 使 用 さ れ る 。 af が 省 略 さ れ る と ipv4 が 使 用 さ れ る 。 他 の 対 応 す る ア ド レ ス フ ァ ミ リ は ipv6, ssocks, sdp が あ る 。 ssocks は Dolphin Interconnect Solutions の 「 super sockets」 、 sdp は Sockets Direct Protocol(Infiniband) を 指 す 。

net-options コ マ ン ド は コ ネ ク シ ョ ン の 確 立 中 に オ プ シ ョ ン の 変 更 が 行 え る 。

--protocol protocol

DRBD の TCP/IP の 通 信 の 際 に 使 わ れ る プ ロ ト コ ル を 指 定 す る 。 指 定 で き る プ ロ ト コ ル は A, B, C で あ る 。 プ ロ ト コ ル A: ロ ー カ ル デ ィ ス ク と ロ ー カ ル TCP 送 信 バ ッ フ ァ に デ ー タ を 書 き 込 ん だ ら デ ィ ス ク へ の 書 き 込 み が 完 了 し た と 判 断 す る 。 プ ロ ト コ ル B: ロ ー カ ル デ ィ ス ク と リ モ ー ト バ ッ フ ァ キ ャ ッ シ ュ に デ ー タ を 書 き 込 ん だ ら デ ィ ス ク へ の 書 き 込 み が 完 了 し た と 判 断 す る 。 プ ロ ト コ ル C: ロ ー カ ル デ ィ ス ク と リ モ ー ト デ ィ ス ク の 両 方 に デ ー タ を 書 き 込 ん だ ら デ ィ ス ク へ の 書 き 込 み が 完 了 し た と 判 断 す る 。

--connect-int time 対 向 ノ ー ド に た だ ち に 接 続 で き な い 場 合 、 DRBD は 接 続 を 繰 り 返 し 試 行 す る 。 こ の パ ラ メ ー タ は 試 行 間 隔 を 指 定 す る 。 デ フ ォ ル ト 値 は 10 で あ る 。 単 位 は 秒 で あ る 。

--ping-int time

DRBD デ バ イ ス 間 の TCP/IP 接 続 が あ り 、 対 向 ノ ー ド か ら time 秒 の 間 に 何 も 通 信 が 行 わ れ な か っ た 場 合 、 DRBD は 死 活 確 認 の た め キ ー プ ア ラ イ ブ パ ケ ッ ト を 生 成 す る 。 デ フ ォ ル ト 値 は 10 で あ る 。 単 位 は 秒 で あ る 。

--timeout val 対 向 ノ ー ド か ら の 応 答 パ ケ ッ ト が 1/10 の val 倍 の 時 間 以 内 に 返 っ て こ な い 場 合 、 対 向 ノ ー ド が 死 ん だ と 判 断 し て TCP/IP コ ネ ク シ ョ ン を 切 断 す る 。 デ フ ォ ル ト 値 は 60 で 、 こ れ は 6 秒 に 相 当 す る 。

--sndbuf-size size ソ ケ ッ ト 送 信 バ ッ フ ァ は 、 セ カ ン ダ リ ノ ー ド に 送 信 す る パ ケ ッ ト を 格 納 す る た め に 使 わ れ る 。 こ の 中 の パ ケ ッ ト は 、 ネ ッ ト ワ ー ク 的 に は セ カ ン ダ リ 側 か ら 受 信 確 認 を 受 け 取 っ て い な い 。 プ ロ ト コ ル A を 使 う 場 合 は 、 両 ノ ー ド 間 の 同 期 を 高 め る た め に 、 こ の バ ッ フ ァ サ イ ズ を 増 や す 必 要 が 生 じ る 可 能 性 が あ る 。 し か し 、 プ ラ イ マ リ ノ ー ド が フ ェ イ ル し た と き に 失 う デ ー タ が 増 え る こ と も 考 慮 し て お く 必 要 が あ る 。 8.0.13 か ら 8.2.7 ま で は 、 手 動 で 0 を 設 定 し な い と 自 動 調 整 に な ら な い 。 デ フ ォ ル ト 値 は 0 で 自 動 調 整 さ れ る 。

--rcvbuf-size size ネ ッ ト ワ ー ク か ら 受 信 し た パ ケ ッ ト は 、 最 初 に ソ ケ ッ ト の 受 信 バ ッ フ ァ に 保 存 さ れ る 。 そ こ か ら DRBD に 使 わ れ る 。 8.3.1 以 前 は 、 ソ ケ ッ ト 受 信 バ ッ フ ァ の サ イ ズ は ソ ケ ッ ト 送 信 バ ッ フ ァ と 同 じ サ イ ズ に 固 定 さ れ て い た 。 8.3.2 か ら こ れ ら を 別 々 に 設 定 で き る よ う に な っ て い る 。 0 を 指 定 す る と カ ー ネ ル が 自 動 的 に 設 定 す る 。 デ フ ォ ル ト 値 は 0 で 自 動 調 整 さ れ る 。

--ko-count count セ カ ン ダ リ ノ ー ド が 書 き 込 み リ ク エ ス ト を timeout 内 で count 回 以 上 失 敗 し た 場 合 、 そ の セ カ ン ダ リ ノ ー ド は ク ラ ス タ か ら 排 除 さ れ 、 プ ラ イ マ リ ノ ー ド は StandAlone モ ー ド に 遷 移 す る 。 こ の 機 能 を 無 効 に す る に は 、 明 示 的 に 0 に 設 定 す る 必 要 が あ る 。 デ フ ォ ル ト は バ ー ジ ョ ン 間 で 変 更 さ れ て い る 。 8.4 は 7 が デ フ ォ ル ト 値 で あ る 。

--max-epoch-size val こ の オ プ シ ョ ン を 指 定 す る と 、 バ リ ア と バ リ ア の 間 の 書 き 込 み リ ク エ ス ト 数 の 最 大 値 を 制 限 で き る 。 |--max-buffers と 同 じ 値 か 、 取 り う る 最 大 値 を 指 定 す る の が 望 ま し い 。 10 よ り 小 さ い 値 は 、 パ フ ォ ー マ ン ス 低 下 を も た ら す 。 デ フ ォ ル ト 値 は 2048 で あ る 。

--max-buffers val

DRBD 受 信 ス レ ッ ド に 割 り 当 て る バ ッ フ ァ ペ ー ジ の 最 大 値 を 指 定 す る 。 --max-epoch-size と 同 じ 値 を 指 定 す る の が 望 ま し い 。 小 さ い 値 は パ フ ォ ー マ ン ス 低 下 を も た ら す 。 デ フ ォ ル ト 値 は 2048 で 、 最 小 は 32 で あ る 。 リ ニ ア 書 き 込 み や 一 方 が ア イ ド ル 状 態 で の 再 同 期 の 際 、 受 け 取 り 側 の I/O バ ッ ク エ ン ド に 余 裕 が あ る 場 合 に は こ の 値 を 増 や す の が よ い 。 追 加 の 制 限 と 必 要 な 準 備 に つ い て は 、 次 の マ ニ ュ ア ル を 参 照 :drbd.conf(5)

--unplug-watermark val こ の 設 定 は 、 最 近 の 明 示 的 に ス タ ッ ク プ ラ ギ ン グ を 使 用 す る カ ー ネ ル に は 効 果 が な い (Linux kernel 2.6.39 に は 移 植 さ れ て い る )。 ス タ ン バ イ (セ カ ン ダ リ ) ノ ー ド で 書 き 込 ま れ て い な い 書 き 込 み リ ク エ ス ト 数 が unplug-watermark を 上 回 る と 、 下 位 デ バ イ ス に 対 し て 書 き 込 み リ ク エ ス ト を 送 る 。 ス ト レ ー ジ に よ っ て は 小 さ い 値 で も 良 好 な 結 果 が 得 ら れ る が 、 多 く の デ バ イ ス で は max-buffers と 同 じ 値 を 指 定 す る と き に 最 良 の 結 果 が 得 ら れ る 。 デ フ ォ ル ト 値 は 128 で 、 指 定 で き る 最 小 値 は 16、 最 大 値 は 131072 で あ る 。

--allow-two-primaries こ の オ プ シ ョ ン を 指 定 す る と 、 両 ノ ー ド に プ ラ イ マ リ を 割 り 当 て ら れ る 。 こ の オ プ シ ョ ン は 分 散 共 有 フ ァ イ ル シ ス テ ム を 使 う と き の み 指 定 す る 。 現 在 DRBD が サ ポ ー ト す る フ ァ イ ル シ ス テ ム は OCFS2 と GFS で あ る 。 こ れ ら 以 外 の フ ァ イ ル シ ス テ ム を 使 う と き に こ の オ プ シ ョ ン を 指 定 す る と 、 デ ー タ の 破 損 と ノ ー ド の ダ ウ ン を 引 き 起 こ す 。

--cram-hmac-alg alg 対 向 ノ ー ド の 認 証 を 行 い た い 場 合 、 +HMAC ア ル ゴ リ ズ ム を 指 定 す る 。 対 向 ノ ー ド の 認 証 は 行 う べ き で あ る 。 チ ャ レ ン ジ -レ ス ポ ン ス 方 式 で 対 向 ノ ー ド を 認 証 す る の に 、 HMA CFC ア ル ゴ リ ズ ム が 使 わ れ る 。 /proc/crypto に 記 録 さ れ て い る 任 意 の ダ イ ジ ェ ス ト ア ル ゴ リ ズ ム を 指 定 で き る 。

--shared-secret secret 対 向 ノ ー ド の 認 証 に は 共 有 秘 密 鍵 が 使 用 さ れ 、 64文 字 ま で で 指 定 す る 。

--after-sb-0pri asb-0p-policy 指 定 で き る ポ リ シ ー は 以 下 の 通 り :

disconnect 自 動 再 同 期 を 行 わ ず 接 続 を 切 断 す る 。

discard-younger-primary ス プ リ ッ ト ブ レ イ ン 発 生 前 に プ ラ イ マ リ で あ っ た ノ ー ド か ら の 再 同 期 を 自 動 的 に 実 行 す る 。

discard-older-primary ス プ リ ッ ト ブ レ イ ン 発 生 時 に プ ラ イ マ リ に な っ た ノ ー ド か ら の 再 同 期 を 自 動 的 に 実 行 す る 。

discard-zero-changes プ リ ッ ト ブ レ イ ン 発 生 後 ど ち ら か 一 方 の ノ ー ド に 書 き 込 み が ま っ た く 行 わ れ な か っ た こ と が 明 白 な 場 合 、 書 き 込 み が 行 わ れ た ノ ー ド か ら 行 わ れ な か っ た ノ ー ド に 対 す る 再 同 期 が 実 行 さ れ る 。 ど ち ら も 書 き 込 ま れ な か っ た 場 合 は 、 DRBD は ラ ン ダ ム な 判 断 に よ っ て 0 ブ ロ ッ ク の 再 同 期 を 実 行 す る 。 両 ノ ー ド に 書 き 込 み が 行 わ れ た 場 合 、 こ の ポ リ シ ー は ノ ー ド の 接 続 を 切 断 す る 。

discard-least-changes ス プ リ ッ ト ブ レ イ ン 発 生 後 、 よ り 多 く の ブ ロ ッ ク を 書 き 込 ん だ ノ ー ド か ら 他 方 に 対 す る 再 同 期 を 実 行 す る 。

discard-node-NODENAME 指 定 し た 名 前 の ノ ー ド に 対 す る 再 同 期 を 実 行 す る 。

--after-sb-1pri asb-1p-policy 指 定 で き る ポ リ シ ー は 以 下 の 通 り :

disconnect 自 動 再 同 期 を 行 わ ず 接 続 を 切 断 す る 。

consensus

after-sb-0pri ア ル ゴ リ ズ ム の 結 果 が 現 在 の セ カ ン ダ リ ノ ー ド の デ ー タ を 壊 す こ と に な る 場 合 、 セ カ ン ダ リ ノ ー ド の デ ー タ を 捨 て る 。 そ う で は な い 場 合 は 接 続 を 切 断 す る 。 そ う で は な い 場 合 は 接 続 を 切 断 す る 。

discard-secondary セ カ ン ダ リ 側 の デ ー タ を 捨 て る 。

call-pri-lost-after-sb

after-sb-0pri ア ル ゴ リ ズ ム の 判 断 を 常 に 採 用 す る 。 セ カ ン ダ リ 側 の デ ー タ が 正 し い と 判 断 さ れ た 場 合 に は 、 現 在 の プ ラ イ マ リ 側 で pri-lost-after-sb ハ ン ド ラ が 呼 び 出 さ れ る 。

violently-as0p

after-sb-0pri ア ル ゴ リ ズ ム の 判 断 を 常 に 採 用 す る 。 セ カ ン ダ リ 側 の デ ー タ が 正 し い と 判 断 さ れ た 場 合 で も 、 プ ラ イ マ リ 側 の デ ー タ の 変 更 箇 所 を 受 け 入 れ る 。

--after-sb-2pri asb-2p-policy 指 定 で き る ポ リ シ ー は 以 下 の 通 り :

disconnect 自 動 再 同 期 を 行 わ ず 接 続 を 切 断 す る 。

call-pri-lost-after-sb

after-sb-0pri ア ル ゴ リ ズ ム の 判 断 を 常 に 採 用 す る 。 セ カ ン ダ リ 側 の デ ー タ が 正 し い と 判 断 さ れ た 場 合 に は 、 現 在 の プ ラ イ マ リ 側 で pri-lost-after-sb ハ ン ド ラ が 呼 び 出 さ れ る 。

violently-as0p

after-sb-0pri ア ル ゴ リ ズ ム の 判 断 を 常 に 採 用 す る 。 セ カ ン ダ リ 側 の デ ー タ が 正 し い と 判 断 さ れ た 場 合 で も 、 プ ラ イ マ リ 側 の デ ー タ の 変 更 箇 所 を 受 け 入 れ る 。

--always-asbp 通 常 、 3 番 目 の ノ ー ド が 存 在 し な い こ と が 現 在 の UUID 値 か ら 明 ら か な 場 合 の み 、 ス プ リ ッ ト ブ レ イ ン 発 生 後 の 修 復 ポ リ シ ー だ け が 適 用 さ れ る 。 こ の オ プ シ ョ ン を 指 定 す る と 、 両 ノ ー ド の デ ー タ に 関 連 性 が あ る と し て 、 ス プ リ ッ ト ブ レ イ ン 発 生 後 の ポ リ シ ー が 適 用 さ れ る 。 UUID の 分 析 に よ り 3 番 目 の ノ ー ド の 存 在 が 疑 わ れ る 場 合 に は 、 フ ル 同 期 が 行 わ れ る こ と が あ る 。 (ま た は 、 な ん ら か の 別 の 原 因 に よ っ て 間 違 っ た UUID セ ッ ト で 判 断 し て し ま っ た 場 合 )

--rr-conflict role-resync-conflict-policy こ の オ プ シ ョ ン は 、 SyncTarget ノ ー ド が す で に プ ラ イ マ リ で あ り 、 再 同 期 が 必 要 で あ る こ と を DRBD が メ タ デ ー タ か ら 推 測 す る と き の DRBD の 動 作 を 設 定 す る 。 設 定 で き る 値 は : disconnect, call-pri-lost, violently で あ る 。 disconnect は 接 続 を 切 断 す る 。 call-pri-lost は pri-lost ハ ン ド ラ を 呼 び 出 す 。 こ の ハ ン ド ラ は 、 ノ ー ド の 状 態 を セ カ ン ダ リ に 切 り 替 え る か 、 あ る い は ノ ー ド を ク ラ ス タ か ら 切 り 離 す と き に 呼 ば れ る 。 デ フ ォ ル ト は disconnect で あ る 。

violently を 指 定 す る と 、 プ リ マ リ ノ ー ド を 強 制 的 に 同 期 先 (SyncTarget) に で き る 。 こ の オ プ シ ョ ン を 指 定 す る と 、 即 座 に 同 期 元 (SyncSource) の デ ー タ に 書 き 換 え ら れ る 。 こ の オ プ シ ョ ン は 、 何 を し て い る の か を 理 解 し た 上 で 使 用 す る よ う に 。

--data-integrity-alg hash_alg ネ ッ ト ワ ー ク 経 由 で 受 け 渡 さ れ る デ ー タ の 整 合 性 を 担 保 す る た め に 、 DRBD は ハ ッ シ ュ 値 を 比 較 す る 機 能 を 備 え て い る 。 通 常 は 、 TCP/IP パ ケ ッ ト 自 体 の ヘ ッ ダ に 含 ま れ る 16 ビ ッ ト チ ェ ッ ク サ ム で 保 証 さ れ る 。 こ の オ プ シ ョ ン 値 に は 、 カ ー ネ ル が サ ポ ー ト す る 任 意 の ダ イ ジ ェ ス ト ア ル ゴ リ ズ ム を 指 定 で き る 。 一 般 的 な カ ー ネ ル の 場 合 、 少 な く と も md5, sha1, crc32c の ど れ か が 利 用 で き る 。 デ フ ォ ル ト で は 、 こ の 機 能 は 無 効 で あ る 。

drbd.conf マ ニ ュ ア ル ペ ー ジ の デ ー タ 整 合 性 に 関 す る 説 明 も 参 照 の こ と 。

--no-tcp-cork

DRBD は 、 TCP ソ ケ ッ ト の TCP_CORK オ プ シ ョ ン を 使 っ て 、 い つ 追 加 デ ー タ を 受 け 取 る か 、 あ る い は 送 信 キ ュ ー の デ ー タ を い つ フ ラ ッ シ ュ す る か の ヒ ン ト を 得 て い る 。 こ の 方 法 が 悪 影 響 を 及 ぼ す ネ ッ ト ワ ー ク ス タ ッ ク が 少 な く と も 存 在 す る 。 こ の オ プ シ ョ ン を 指 定 す る と 、 TCP_CORK ソ ケ ッ ト オ プ シ ョ ン の 設 定 が 無 効 に な る 。

--ping-timeout ping_timeout こ の パ ラ メ ー タ で 指 定 し た 時 間 内 に キ ー プ ア ラ イ ブ パ ケ ッ ト に 応 答 し な け れ ば な ら な い 。 応 答 パ ケ ッ ト が 返 っ て こ な い 場 合 、 そ の 対 向 ノ ー ド は 死 ん だ と 判 断 さ れ る 。 デ フ ォ ル ト 値 は 5(500ms) で 、 100ms 単 位 で 指 定 す る 。

--discard-my-data ス プ リ ッ ト ブ レ イ ン 状 態 か ら 復 旧 す る と き に 、 こ の オ プ シ ョ ン を 手 作 業 で 指 定 す る 。 自 動 的 な 復 旧 ポ リ シ ー を 設 定 し て い な い 場 合 に は 、 DRBD は 接 続 を 拒 否 す る 。 こ の オ プ シ ョ ン を 実 行 す る と 、 そ の ノ ー ド は 接 続 後 た だ ち に 同 期 先 に な る 。

--tentative 再 同 期 を 実 行 さ せ な い 場 合 な ど に お い て 、 再 同 期 ハ ン ド シ ェ ー ク 後 に DRBD 接 続 プ ロ セ ス を 終 了 さ せ る 。 DRBD が ど の 再 同 期 を 実 行 し て い る か に つ い て は 、 カ ー ネ ル ロ グ で 確 認 す る こ と が で き る 。

--on-congestion congestion_policy,
--congestion-fill fill_threshold,
--congestion-extents active_extents_threshold デ フ ォ ル ト で は 、 TCP 送 信 キ ュ ー が 一 杯 に な る と 、 DRBD は 書 き 込 み を ブ ロ ッ ク す る 。 こ の こ と は DRBD が TCP で 送 信 で き る デ ー タ 量 を 越 え て デ ィ ス ク に 書 き こ も う と す る ア プ リ ケ ー シ ョ ン の 処 理 速 度 が 低 下 す る こ と を 意 味 す る 。

DRBD-Proxy を 使 っ て い る 場 合 、 送 信 キ ュ ー が 満 杯 に な る 直 前 に AHEAD/BEAIND モ ー ド に 移 行 す る の が 望 ま し い 。 AHEAD/BEHIND モ ー ド で は 、 DRBD 間 の 通 信 は 切 断 し な い が 、 デ ー タ レ プ リ ケ ー シ ョ ン は 行 わ れ な く な る 。

AHEAD/BEHIND モ ー ド の 利 点 は 、 た と え DRBD-Proxy の バ ッ フ ァ が す べ て の 書 き 込 み 要 求 を 受 け 入 れ る の に 十 分 で な く て も 、 ア プ リ ケ ー シ ョ ン が 遅 く な ら な い こ と で あ る 。 欠 点 は 、 対 向 ノ ー ド が 後 れ を と っ て い る た め 、 同 期 状 態 に 戻 す た め に 再 同 期 が 必 要 に な る こ と で あ る 。 再 同 期 中 対 向 ノ ー ド の デ ー タ は 不 整 合 状 態 の ま ま と な る 。

congestion_policy で は block と pull-ahead が 使 用 で き る 。 デ フ ォ ル ト は block で あ る 。 Fill_threshold は 0 か ら 10GiB ま で の 値 を 指 定 で き る 。 デ フ ォ ル ト 値 は 0 で 、 こ れ は チ ェ ッ ク が 無 効 に な る こ と を 意 味 す る 。 Active_extents_threshold は 、 al-extents と 同 じ 制 限 が あ る 。

AHEAD/BEHIND は DRBD8.3.10 以 降 で 利 用 で き る 。

--verify-alg hash-alg

verify サ ブ コ マ ン ド で デ ィ ス ク 内 容 を オ ン ラ イ ン 照 合 す る 際 、 DRBD は ビ ッ ト 単 位 の 比 較 で は な く 、 ブ ロ ッ ク ご と の ハ ッ シ ュ 値 を 計 算 し 、 対 向 ノ ー ド の ハ ッ シ ュ 値 と 比 較 す る 。 照 合 に 利 用 す る ハ ッ シ ュ ア ル ゴ リ ズ ム は 、 こ の パ ラ メ ー タ で 指 定 す る 。 オ プ シ ョ ン 値 に は 、 カ ー ネ ル が サ ポ ー ト す る 任 意 の ダ イ ジ ェ ス ト ア ル ゴ リ ズ ム を 指 定 で き る 。 一 般 的 な カ ー ネ ル の 場 合 、 少 な く と も md5, sha1, crc32c の ど れ か が 利 用 で き る 。 デ フ ォ ル ト で は 、 こ の 機 能 は 無 効 で あ る 。 オ ン ラ イ ン 照 合 を 有 効 に す る に は 、 こ の パ ラ メ ー タ を 明 示 的 に 設 定 す る 必 要 が あ る 。

drbd.conf マ ニ ュ ア ル ペ ー ジ の デ ー タ 整 合 性 に 関 す る 説 明 も 参 照 の こ と 。

--csums-alg hash-alg

csums-alg が 指 定 さ れ て い な い 場 合 、 再 同 期 プ ロ セ ス は す べ て の マ ー ク さ れ た デ ー タ ブ ロ ッ ク を コ ピ ー 元 か ら コ ピ ー 先 に 転 送 す る こ の オ プ シ ョ ン を 指 定 す る と 、 マ ー ク さ れ た デ ー タ ブ ロ ッ ク の ハ ッ シ ュ 値 を 最 初 に 送 り 、 ハ ッ シ ュ 値 が 一 致 し な い ブ ロ ッ ク に つ い て の み デ ー タ を 転 送 す る 。 帯 域 幅 が 小 さ い 回 線 を 使 う と き 、 こ の オ プ シ ョ ン は 有 用 で あ る 。 ク ラ ッ シ ュ し た プ ラ イ マ リ ノ ー ド が 復 帰 し た と き 、 ア ク テ ィ ビ テ ィ ロ グ に 記 録 さ れ た す べ て の ブ ロ ッ ク が 再 同 期 の 対 象 と な る 。 し か し 大 部 分 の ブ ロ ッ ク は 同 期 が 取 れ て い る 。 こ の た め 、 csums-alg を 指 定 す る こ と に よ っ て 、 CPU の 使 用 量 と 引 き 換 え に 必 要 な 転 送 量 を 減 ら せ る 。

--use-rle 再 同 期 開 始 時 の ハ ン ド シ ェ ー ク の 過 程 で 各 ノ ー ド の ビ ッ ト マ ッ プ が 交 換 さ れ 、 ビ ッ ト 単 位 の OR 計 算 が 行 わ れ る 。 こ れ に よ っ て 、 ど の ブ ロ ッ ク が ダ ー テ ィ (不 一 致 ) で あ る か に つ い て 、 そ れ ぞ れ の ノ ー ド は 共 通 の 認 識 を 持 つ 。 大 容 量 デ バ イ ス で は ビ ッ ト マ ッ プ も 大 き く な り 、 帯 域 幅 が 小 さ い ネ ッ ト ワ ー ク で は そ の 交 換 に 時 間 を 要 す る 。 典 型 的 な ビ ッ ト マ ッ プ は 、 す べ て が セ ッ ト さ れ て い な い (ク リ ー ン ) あ る い は セ ッ ト さ れ て い る (ダ ー テ ィ ) い く つ か の エ リ ア に 分 か れ て い る 。 こ の た め 、 単 純 で は あ る が ラ ン レ ン グ ス 符 号 化 を 採 用 す る こ と に よ り 、 ビ ッ ト マ ッ プ 交 換 の た め の ネ ッ ト ワ ー ク ト ラ フ ィ ッ ク を 顕 著 に 減 ら す こ と が で き る 。 過 去 の バ ー ジ ョ ン と の 互 換 性 の た め 、 ま た 高 速 ネ ッ ト ワ ー ク で は 転 送 時 間 改 善 効 果 が 少 な く CPU 使 用 量 が 増 え る た め 、 デ フ ォ ル ト で は こ の 機 能 は 無 効 で あ る 。

Introduced in 8.3.2.

--socket-check-timeout

DRBD-Proxy を 使 っ て い て 大 量 の バ ッ フ ァ を 確 保 す る 必 要 が あ る 環 境 で は ping-timeout に 非 現 実 的 な 大 き な 値 を 指 定 し な け れ ば な ら な い こ と が あ る 。 TCP コ ネ ク シ ョ ン が 開 始 し た と き の 安 定 す る の を 待 つ 局 面 で も 、 DRBD は デ フ ォ ル ト で ping-timeout を 使 っ て し ま う 。 DRBD-Proxy は 通 常 、 同 じ デ ー タ セ ン タ ー に 配 置 さ れ て い る た め 、 長 い 待 機 時 間 は DRBD の 接 続 プ ロ セ ス を 妨 げ る 可 能 性 が あ る 。 こ の よ う な 場 合 、 socket-check-timeout に DRBD と DRBD-Proxy 間 の round trip time(RTT) を 設 定 す る と よ い 。 た い て い の 場 合 1 で あ る 。 デ フ ォ ル ト の 単 位 は 10 分 の 1 秒 で あ る 。 デ フ ォ ル ト 値 は 0 で socket-check-timeout 値 の 代 わ り に ping-timeout 値 を 使 用 す る 。 8.4.5 か ら 導 入 さ れ た 。

resource-options
Changes the options of the resource at runtime.

--cpu-mask cpu-mask

DRBD の カ ー ネ ル ス レ ッ ド に CPU ア フ ィ ニ テ ィ マ ス ク を 設 定 す る 。 cpu-mask の デ フ ォ ル ト 値 は 0 で 、 DRBD の カ ー ネ ル ス レ ッ ド が マ シ ン 全 体 の CPU に ま た が っ て 動 作 す る こ と を 意 味 し て い る 。 こ の 値 は 16 進 表 現 で 指 定 す る 必 要 が あ る 。 値 が 大 き す ぎ る と 切 り 捨 て ら れ る 。

--on-no-data-accessible ond-policy こ の 設 定 は 、 デ ィ ス ク レ ス モ ー ド が 発 生 し た 際 の 操 作 を 指 定 す る 。 設 定 で き る ポ リ シ ー は io-error と suspend-io で あ る 。

ond-policy に suspend-io を 設 定 す る と 、 最 後 に 接 続 し て い た デ ー タ ス ト レ ー ジ か ら 、 も し く は 、 drbdadm resume-io res コ マ ン ド に よ り 、 I/O を 再 開 す る こ と が で き る 。 後 者 は も ち ろ ん I/O エ ラ ー を 発 生 さ せ る 。 デ フ ォ ル ト は io-error で あ る 。 こ の 設 定 は 、 DRBD 8.3.9 か ら 有 効 で あ る 。

primary デ バ イ ス を プ ラ イ マ リ ロ ー ル に 切 り 替 え る 。 す る と ア プ リ ケ ー シ ョ ン (こ の 場 合 は フ ァ イ ル シ ス テ ム な ど ) は デ バ イ ス を 読 み 書 き モ ー ド で オ ー プ ン で き る よ う に な る 。 プ ラ イ マ リ ロ ー ル の デ バ イ ス に 書 き 込 ま れ た デ ー タ は セ カ ン ダ リ ロ ー ル の デ バ イ ス に ミ ラ ー さ れ る 。 通 常 の 実 行 状 態 で は 、 DRBD デ バ イ ス ペ ア の 両 方 を 同 時 に プ ラ イ マ リ に 切 り 替 え る こ と は で き な い 。 --allow-two-primaries オ プ シ ョ ン を 使 用 す る と 、 DRBD の 既 定 の 仕 様 を 変 更 し て 両 ノ ー ド を プ ラ イ マ リ に で き る 。

--overwrite-data-of-peer

--force の エ イ リ ア ス 。

--force ロ ー カ ル デ ィ ス ク の 複 製 物 が 最 新 (UpToDate) で な い 場 合 は 、 プ ラ イ マ リ に な れ な い 。 つ ま り 、 デ ー タ が 一 致 し な か っ た り 、 古 か っ た り す る 場 合 で あ る 。 こ の オ プ シ ョ ン を 指 定 す る と 、 状 況 に 関 係 な く プ ラ イ マ リ に 切 り 替 え ら れ る 。 こ の オ プ シ ョ ン は 、 何 を し て い る の か を 理 解 し た 上 で 使 用 す る よ う に 。

secondary デ バ イ ス を セ カ ン ダ リ ロ ー ル に 切 り 替 え る 。 何 ら か の ア プ リ ケ ー シ ョ ン (ま た は フ ァ イ ル シ ス テ ム ) が 書 き 込 み モ ー ド で デ バ イ ス を オ ー プ ン し て い る 間 は 、 こ の 操 作 は 失 敗 す る 。

DRBD デ バ イ ス ペ ア の 両 方 が と も に セ カ ン ダ リ 状 態 に な る こ と は 問 題 な く 可 能 で あ る 。

verify オ ン ラ イ ン 状 態 で デ バ イ ス を 照 合 す る 。 オ ン ラ イ ン 照 合 は 、 ロ ー カ ル ノ ー ド の 全 ブ ロ ッ ク を 対 向 ノ ー ド の 対 応 す る ブ ロ ッ ク と 比 較 す る こ と で あ る 。 照 合 の 進 行 状 況 は 、 /proc/drbd を 通 じ て 確 認 で き る 。 ロ ー カ ル デ ィ ス ク と 対 向 ホ ス ト で 内 容 が 異 な る ブ ロ ッ ク は 、 DRBD の デ ィ ス ク 上 ビ ッ ト マ ッ プ に 不 整 合 と し て マ ー ク さ れ る 。 こ れ ら は 自 動 的 な 再 同 期 が 行 わ れ な い 。 再 同 期 を 行 う に は 、 い っ た ん リ ソ ー ス の 接 続 を 切 っ て 再 接 続 す れ ば よ い 。 す で に オ ン ラ イ ン 照 合 が 進 行 中 の 場 合 、 (当 該 ノ ー ド が 照 合 を 行 い ) こ の コ マ ン ド は 成 功 す る 。 こ の 場 合 、 start-sector (以 下 参 照 ) は 無 視 さ れ 、 stop-sector (以 下 参 照 ) が 採 用 さ れ る 。 こ れ は 照 合 を 終 了 す る た め 、 あ る い は 現 在 進 行 中 の 照 合 の 範 囲 を 更 新 / 短 縮 / 拡 張 す る た め に 使 用 さ れ る 。 こ の コ マ ン ド は デ バ イ ス が 接 続 さ れ て い る デ バ イ ス ペ ア の う ち の 一 つ で な い 場 合 は 失 敗 す る 。

drbd.conf マ ニ ュ ア ル ペ ー ジ の デ ー タ 整 合 性 に 関 す る 説 明 も 参 照 の こ と 。

--start start-sector バ ー ジ ョ ン 8.3.2 以 降 で こ の オ プ シ ョ ン が 利 用 で き る 。 接 続 が 切 れ て 復 旧 し た と き 、 オ ン ラ イ ン 照 合 は 直 前 の 最 後 の 位 置 か ら 再 開 す る 。 こ の オ プ シ ョ ン を 指 定 す る と 、 任 意 の 位 置 か ら 照 合 を 開 始 で き る 。 以 前 に stop-sector に 達 し た 事 が あ り 、 明 示 的 に start-sector を 指 定 し な い 場 合 に は 、 照 合 は 以 前 の 停 止 セ ク タ か ら 再 開 さ れ る 。 デ フ ォ ル ト の 単 位 は セ ク タ で あ る 。 単 位 を 明 示 的 に 指 定 す る こ と も で き る 。 開 始 セ ク タ は 8 セ ク タ の 倍 数 (4kB) に 切 り 捨 て ら れ る 。

-S, --stop stop-sector バ ー ジ ョ ン 8.3.14 以 降 で は 、 オ ン ラ イ ン 照 合 は デ バ イ ス の 最 後 に 達 す る 前 に 終 了 す る こ と が で き る 。 デ フ ォ ル ト の 単 位 は セ ク タ で あ る 。 単 位 を 明 示 的 に 指 定 す る こ と も で き る 。 照 合 が 進 行 中 に 追 加 の drbdsetup verify コ マ ン ド を 同 じ ノ ー ド で 実 行 す る こ と で 、 stop-sector を 更 新 す る 事 が で き る 。 こ れ は 照 合 を 終 了 す る た め 、 あ る い は 現 在 進 行 中 の 照 合 の 範 囲 を 更 新 / 短 縮 / 拡 張 す る た め に 使 用 さ れ る 。

invalidate 接 続 さ れ た DRBD デ バ イ ス ペ ア の ロ ー カ ル 側 を SyncTarget 状 態 に 切 り 替 え る 。 こ れ に よ り 、 対 向 ホ ス ト 側 の す べ て の デ ー タ ブ ロ ッ ク が ロ ー カ ル デ ィ ス ク に コ ピ ー さ れ る 。 デ バ イ ス が 対 向 ホ ス ト 側 の デ バ イ ス と 接 続 し て い な か っ た り 、 切 断 さ れ た セ カ ン ダ リ の 場 合 、 コ マ ン ド は 失 敗 す る 。

invalidate-remote 接 続 さ れ た DRBD デ バ イ ス ペ ア の ロ ー カ ル デ バ イ ス 側 を SyncSource 状 態 に 切 り 替 え る 。 こ れ に よ り 、 ロ ー カ ル デ ィ ス ク の す べ て の デ ー タ ブ ロ ッ ク が 対 向 ペ ア に コ ピ ー さ れ る 。 切 断 さ れ た プ ラ イ マ リ デ バ イ ス 側 で は 、 す べ て の ビ ッ ト が 非 同 期 の ビ ッ ト マ ッ プ に 設 定 さ れ る 。 こ れ に よ っ て オ ン デ ィ ス ク の ア ク テ ィ ビ テ ィ ロ グ の 更 新 が 一 時 停 止 す る 。 ア ク テ ィ ビ テ ィ ロ グ の 更 新 が 再 開 す る と 、 必 要 に 応 じ て 自 動 的 再 開 さ れ る 。

wait-connect デ バ イ ス が 対 向 デ バ イ ス と 通 信 可 能 に な る ま で 待 機 す る 。

--wfc-timeout wfc_timeout,
--degr-wfc-timeout degr_wfc_timeout,
--outdated-wfc-timeout outdated_wfc_timeout,
--wait-after-sb デ バ イ ス が timeout 秒 以 内 に 対 向 ペ ア と 通 信 で き な い と 、 こ の コ マ ン ド は 失 敗 す る 。 ノ ー ド が 再 起 動 す る 前 に 対 向 ノ ー ド が 動 作 し て い た 場 合 、 wfc_timeout パ ラ メ ー タ の 値 が 使 わ れ る 。 ノ ー ド が 再 起 動 す る 前 に 対 向 ノ ー ド が ダ ウ ン し て い た 場 合 に は 、 degr_wfc_timeout パ ラ メ ー タ の 値 が 使 わ れ る 。 ノ ー ド が 再 起 動 す る 前 に 対 向 ノ ー ド が 無 効 に さ れ て い た 場 合 に は outdated_wfc_timeout パ ラ メ ー タ が 使 わ れ る 。 こ れ ら す べ て の タ イ ム ア ウ ト 値 の デ フ ォ ル ト は 0 で 、 接 続 さ れ る ま で 永 久 に 待 機 す る こ と を 表 す 。 単 位 は 秒 で あ る 。 ス プ リ ッ ト ブ レ イ ン 状 態 が 起 き た た め に デ バ イ ス が 接 続 さ れ た 後 StandaAlone 状 態 に な っ て し ま っ た 場 合 、 こ の コ マ ン ド は 失 敗 す る 。 --wait-after-sb を 指 定 す る と 、 デ フ ォ ル ト の 動 作 を 変 更 で き る 。

wait-sync デ バ イ ス の 同 期 が 終 わ る ま で 待 機 す る 。 こ の オ プ シ ョ ン は wait-connect コ マ ン ド と 同 じ で あ る 。

disconnect
net コ マ ン ド で 設 定 し た デ バ イ ス の 情 報 を 削 除 す る 。 そ の 結 果 、 デ バ イ ス は 切 断 状 態 に な り 、 そ の 後 は ネ ッ ト ワ ー ク 経 由 の 情 報 を 受 け 取 ら な い 。

detach
disk コ マ ン ド で 設 定 し た デ バ イ ス の 情 報 を 消 去 す る 。 そ の 結 果 、 デ バ イ ス は 下 位 ス ト レ ー ジ デ バ イ ス か ら 切 り 離 さ れ る 。

-f, --force 通 常 、 detach は 、 デ ィ ス ク 状 態 が デ ィ ス ク レ ス に な っ て か ら 戻 っ て く る 。 そ の た め 、 フ リ ー ズ し て い る 下 位 ブ ロ ッ ク デ バ イ ス の 切 り 離 し は 終 了 し な い 。 一 方 で 、 強 制 切 り 離 し は 即 座 に 返 答 が く る 。 こ れ で フ リ ー ズ し た 下 位 ブ ロ ッ ク デ バ イ ス を 切 り 離 す こ と が で き る 。 デ ィ ス ク は 全 I/O リ ク エ ス ト が 下 位 ブ ロ ッ ク デ バ イ ス で 完 了 す る ま で failed と し て マ ー ク さ れ る こ と に 注 意 。

down デ バ イ ス の 全 て の 設 定 情 報 を 消 去 す る 。 ま た 、 未 設 定 の 状 態 に 戻 す 。

role デ バ イ ス と そ の 対 向 デ バ イ ス の 現 在 の ロ ー ル (役 割 ) を 表 示 す る 。 表 示 形 式 は ロ ー カ ル /他 ノ ー ド で あ る 。

state
"role" の 別 名 で あ る 。

cstate 現 在 の デ バ イ ス の 接 続 状 態 を 表 示 す る 。

dstate 現 在 の 下 位 デ バ イ ス の 状 態 を 表 示 す る 。 表 示 形 式 は ロ ー カ ル /他 ノ ー ド で あ る 。

resize 下 位 デ バ イ ス の サ イ ズ を 再 検 査 す る 。 実 際 に オ ン ラ イ ン 拡 張 す る に は 、 両 デ バ イ ス で 下 位 デ バ イ ス を 拡 張 し て か ら 、 そ の う ち の 1 台 で resize コ マ ン ド を 実 行 す る 。

--size オ プ シ ョ ン は DRBD デ バ イ ス で 使 用 で き る サ イ ズ の オ ン ラ イ ン 縮 小 に 使 用 さ れ る 。 フ ァ イ ル シ ス テ ム が こ の 操 作 に よ っ て 破 損 し な い こ と は ユ ー ザ 責 任 に お い て 確 認 す る 。

--assume-peer-has-space オ プ シ ョ ン は 、 現 在 対 向 ノ ー ド に 接 続 さ れ て い な い デ バ イ ス の サ イ ズ 変 更 が で き る 。 対 向 ノ ー ド の デ ィ ス ク サ イ ズ を 同 様 に 変 更 し な い と 、 以 降 接 続 が 失 敗 す る の で 注 意 す る こ と 。

--assume-clean オ プ シ ョ ン を 使 用 す る と DRBD は 新 し い ス ト レ ー ジ の 再 同 期 を ス キ ッ プ す る 。 新 し い ス ト レ ー ジ が 、 別 の 方 法 で 初 期 化 さ れ て い る こ と が 確 認 で き て い る 場 合 の み 、 こ れ を 設 定 す る 。

--al-stripes と --al-stripe-size-kB オ プ シ ョ ン は オ ン ラ イ ン で ア ク テ ィ ビ テ ィ ロ グ の レ イ ア ウ ト を 変 更 す る 。 内 部 メ タ デ ー タ の 場 合 に は 、 同 時 に 、 下 位 デ バ イ ス の ユ ー ザ ー に 見 え る サ イ ズ (--size を 使 用 し て )の 縮 小 、 ま た は 拡 大 が 必 要 で あ る 。

check-resize
DRBD が 下 位 デ バ イ ス の オ フ ラ イ ン リ サ イ ズ を 検 知 で き る よ う に す る た め 、 こ の コ マ ン ド は 下 位 デ バ イ ス の 現 在 の サ イ ズ を 記 録 す る た め に 使 用 さ れ る 。 サ イ ズ は 、 /var/lib/drbd/ 下 に drbd-minor-??.lkbd と い う 名 前 で 記 録 さ れ る 。 こ の コ マ ン ド は drbdsetup device resize が 実 行 さ れ た 後 で drbdadm resize res か ら コ ー ル さ れ る 。

pause-sync ロ ー カ ル メ タ デ ー タ の 一 時 停 止 フ ラ グ を セ ッ ト し て 、 進 行 中 の 再 同 期 を 一 時 停 止 す る 。 再 開 さ せ る に は 、 ロ ー カ ル と 他 ノ ー ド の 両 方 の 一 時 停 止 フ ラ グ を ク リ ア す る 必 要 が あ る 。 下 位 レ ベ ル デ バ イ ス の RAID を 再 構 成 し て い る と き な ど 、 DRBD の 再 同 期 を 一 時 停 止 す る の が 望 ま し い 場 合 が あ る 。

resume-sync 自 機 の 一 時 停 止 フ ラ グ を ク リ ア す る 。

outdate 自 ノ ー ド の 下 位 レ ベ ル デ バ イ ス の 内 容 が 「 無 効 」 で あ る と マ ー ク す る 。 無 効 ノ ー ド は プ ラ イ マ リ に な れ な い 。 こ の コ マ ン ド は 通 常 fencing や 対 向 ノ ー ド の fence-peer ハ ン ド ラ と 組 み 合 わ せ て 使 用 さ れ る 。

show-gi デ バ イ ス の デ ー タ 世 代 識 別 子 (data generation identifiers) の 内 容 を 説 明 テ キ ス ト と と も に 表 示 す る 。

get-gi デ バ イ ス の デ ー タ 世 代 識 別 子 (data generation identifiers) の 内 容 を 表 示 す る 。

show リ ソ ー ス の 全 て の 有 効 な 設 定 情 報 を 表 示 す る 。 利 用 可 能 な オ プ シ ョ ン :

--show-defaults す べ て の 設 定 パ ラ メ ー タ を 表 示 す る 。 設 定 フ ァ イ ル に 未 設 定 の パ ラ メ ー タ も 初 期 値 の 設 定 で 表 示 す る 。 こ の オ プ シ ョ ン を つ け な い と 、 初 期 値 の パ ラ メ ー タ は 確 認 で き な い 。

suspend-io こ の コ マ ン ド の 明 確 な 使 用 法 は な い が 、 コ マ ン ド セ ッ ト の 完 全 性 の た め に 用 意 さ れ て い る 。

resume-io
fencing ポ リ シ ー が resource-and-stonith に 設 定 さ れ て お り 、 fence-peer ハ ン ド ラ の 実 行 に 失 敗 し た 場 合 、 こ の コ マ ン ド に よ っ て フ リ ー ズ さ れ た I/O 操 作 を 再 開 で き る 。

status リ ソ ー ス の 全 て の 有 効 な 設 定 情 報 を 表 示 す る 。 出 力 は 、 構 成 さ れ た リ ソ ー ス ご と に 1 つ の 段 落 で 構 成 さ れ る 。 各 段 落 は 、 リ ソ ー ス ご と に 1 行 、 各 デ バ イ ス に 1 行 、 接 続 ご と に 1 行 が 続 く デ バ イ ス と 接 続 行 は イ ン テ ン ド さ れ る 。 各 接 続 行 は 、 対 向 ノ ー ド の デ バ イ ス ご と に 1 行 、 こ れ ら は 接 続 行 に 対 し て イ ン テ ン ド さ れ る 。 長 い 行 は 端 末 の 幅 で 折 り 返 さ れ 、 ど の 行 に 属 し て い る か を 示 す た め に イ ン デ ン ト さ れ る 。 利 用 可 能 な オ プ シ ョ ン :

--verbose 冗 長 か 無 関 係 で あ っ て も 、 よ り 多 く の 情 報 を 出 力 に 含 め る 。

--statistics 出 力 に デ ー タ 転 送 の 統 計 情 報 を 含 め る 。

--color={always | auto | never} 出 力 を カ ラ ー 化 す る 。 --color=auto, drbdsetup は 標 準 出 力 が 端 末 に 接 続 さ れ て い る 場 合 に の み カ ラ ー コ ー ド を 出 力 す る 。 た と え ば 、 1 つ の 接 続 と 1 つ の ボ リ ュ ー ム の み を 持 つ リ ソ ー ス の 出 力 は 、 次 の よ う に な る 。

fs-backoffice role:Primary
disk:UpToDate
peer role:Secondary
replication:Established peer-disk:UpToDate

--verbose と --statistics を 使 用 す る と , 同 じ リ ソ ー ス は 次 の よ う に 出 力 さ れ る :

fs-data role:Primary suspended:no
write-ordering:drain
volume:0 minor:1 disk:UpToDate
size:10616472 read:134465 written:144800 al-writes:18 bm-writes:0
upper-pending:0 lower-pending:0 al-suspended:no blocked:no
peer connection:Connected role:Secondary congested:no
volume:0 replication:Established peer-disk:UpToDate resync-suspended:no
received:122596 sent:22204 out-of-sync:0 pending:0 unacked:0

events2 設 定 さ れ た す べ て の DRBD オ ブ ジ ェ ク ト の 現 在 の 状 態 、 状 態 へ の す べ て の 変 更 を 表 示 す る 。 出 力 形 式 は 、 機 械 だ け で な く 人 も 読 め る 形 式 で あ る 。 各 行 は イ ベ ン ト 番 号 で 始 ま り 、 イ ベ ン ト が 次 の 行 に 続 く 場 合 は ア ス タ リ ス ク が 続 く 。 各 行 の 2 番 目 の 単 語 は 、 イ ベ ン ト の 種 類 を 示 す : 既 存 オ ブ ジ ェ ク ト の exists; オ ブ ジ ェ ク ト が 作 成 、 破 棄 、 変 更 さ れ た 場 合 create, destroy, change; イ ベ ン ト ハ ン ド ラ が 呼 び 出 さ れ た 、 戻 っ た 場 合 call, response で あ る 。 第 3 の 単 語 は 、 イ ベ ン ト が 適 用 さ れ る オ ブ ジ ェ ク ト を 示 す : resource, device, connection, peer-device, helper, 現 在 の 状 態 が 完 全 に ダ ン プ さ れ た こ と を 示 す た め の dash (-) 残 り の 単 語 は オ ブ ジ ェ ク ト を 識 別 し 、 オ ブ ジ ェ ク ト が 入 っ て い る 状 態 を 記 述 す る 。 利 用 可 能 な オ プ シ ョ ン :

--now 現 在 の 状 態 を 報 告 し た 後 に 終 了 す る 。 デ フ ォ ル ト で は 、 継 続 的 に 監 視 し 、 状 態 の 変 化 を 報 告 す る 。

--statistics 統 計 情 報 を 出 力 に 含 め る 。

events 推 奨 し な い 。 可 能 で あ れ ば 、 events2 サ ブ コ マ ン ド に 変 更 す る 。

DRBD の す べ て の 状 態 変 化 と ヘ ル パ ー プ ロ グ ラ ム の 呼 び 出 し 経 緯 を 表 示 す る 。 こ の コ マ ン ド は 、 DRBD の 状 態 変 化 を 他 の プ ロ グ ラ ム に パ イ プ で 渡 し た い と き に 利 用 で き る 。

--all-devices す べ て の DRBD デ バ イ ス の 状 態 を 表 示 す る 。

--unfiltered こ の オ プ シ ョ ン は デ バ ッ グ 用 で あ る 。 す べ て の ネ ッ ト リ ン ク レ イ や の 受 信 メ ッ セ ー ジ の 内 容 を 表 示 す る 。

new-current-uuid 現 在 UUID を 生 成 し て 、 他 の す べ て の UUID を ロ ー テ ー ト す る 。 こ の コ マ ン ド に は 2 通 り の 利 用 シ ー ン が 考 え ら れ る 。 ま ず 、 初 期 同 期 を 省 略 す る 際 に 利 用 す る 。 ま た 、 1 台 で 設 定 を 行 っ た 後 遠 隔 サ イ ト に 運 搬 す る こ と に よ り 帯 域 幅 を 節 約 す る た め に も 利 用 で き る 。 利 用 可 能 な オ プ シ ョ ン :

--clear-bitmap 現 在 UUID を 生 成 す る と 同 時 に 同 期 ビ ッ ト マ ッ プ を ク リ ア す る 。 こ の オ プ シ ョ ン は 、 ゼ ロ か ら 新 規 に 構 築 す る 際 に 初 期 同 期 を 省 略 す る た め に 使 用 す る 。 こ の 方 法 は 、 作 っ た ば か り の メ タ デ ー タ に 対 し て 効 果 が あ る 。 必 要 な ス テ ッ プ は 以 下 の と お り :

1. 両 ノ ー ド で メ タ デ ー タ を 初 期 化 し て デ バ イ ス を 設 定 す る 。

drbdadm -- --force create-md res

2. そ れ ぞ れ の サ イ ズ を 知 る た め に 初 期 ハ ン ド シ ェ ー ク が 必 要 と な る 。

drbdadm up res

3. Secondary/Secondary Inconsistent/Inconsistent の 状 態 で 接 続 さ れ る 。 新 し い 現 在 UUID を 作 り ダ ー テ ィ な ビ ッ ト マ ッ プ を ク リ ア す る 。

drbdadm new-current-uuid --clear-bitmap res

4. Secondary/Secondary UpToDate/UpToDate の 状 態 で 接 続 さ れ る 。 片 方 を プ ラ イ マ リ に 切 り 替 え て フ ァ イ ル シ ス テ ム を 作 成 す る 。

drbdadm primary res

mkfs -t fs-type $(drbdadm sh-dev res) こ の 方 法 の 明 ら か な 欠 点 は 、 別 の 方 法 で デ ィ ス ク 内 容 を 同 一 に し な い 限 り 、 複 製 物 全 体 に 古 い ゴ ミ の デ ー タ が 残 る こ と で あ る 。 こ の た め 、 オ ン ラ イ ン 照 合 は 多 数 の 非 同 期 ブ ロ ッ ク を 見 出 し て し ま う 。 こ の 方 法 は 、 す で に デ ー タ の あ る デ ィ ス ク に 適 用 し て は な ら な い ！ 最 初 は 動 作 し て い る よ う に 見 え て も 、 ノ ー ド の 切 り 替 え を 行 う と デ ー タ が 壊 れ て し ま い 二 度 と 使 え な く な る 。 そ の た め 、 mkfs を 省 略 し て は な ら な い 　 (ま た は そ れ に 相 当 す る 操 作 )。 こ の コ マ ン ド は 、 最 初 の ノ ー ド を 本 稼 働 さ せ た 後 で デ ィ ス ク 自 体 を 2 番 目 の ノ ー ド に 移 す と い う 手 法 に よ り 、 ク ラ ス タ の 初 期 化 時 間 を 短 縮 す る 目 的 に も 適 用 で き る 。 こ の 方 法 は 、 切 断 さ れ た デ バ イ ス に 対 し て の み 有 効 で あ る 。 デ バ イ ス の ロ ー ル は プ ラ イ マ リ で も セ カ ン ダ リ で も よ い 。 必 要 な ス テ ッ プ は 以 下 の と お り :

1. drbdsetup new-current-uuid --clear-bitmap minor

2. 現 在 の ア ク テ ィ ブ な サ ー バ の デ ィ ス ク を コ ピ ー す る 。 た と え ば RAID1 コ ン ト ロ ー ラ 配 下 の デ ィ ス ク を 1 本 抜 く 、 dd で コ ピ ー す る な ど 。 実 際 の デ ー タ 領 域 と メ タ デ ー タ の 両 方 を コ ピ ー す る 必 要 が あ る 。

3. drbdsetup new-current-uuid minor こ の デ ィ ス ク を セ カ ン ダ リ の ノ ー ド に 挿 入 し て ク ラ ス タ に 参 加 さ せ る 。 ス テ ッ プ 1 で の drbdsetup の 実 行 以 降 に 変 更 し た 箇 所 の 再 同 期 が 行 わ れ る 。

EXAMPLES

詳 し く は DRBD ユ ー ザ ー ズ ガ イ ド DRBD User's Guide [1] を 参 照 。

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

drbd.conf(5), drbd(8), drbddisk(8), drbdadm(8), DRBD User's Guide [1] , DRBD web site [2]

NOTES

http://www.drbd.org/users-guide/

http://www.drbd.org/