Provided by: drbd-utils_9.22.0-1.1_amd64 
NAME
drbdsetup - DRBD を設定するツール
SYNOPSIS
drbdsetup new-resource resource [--cpu-mask {val}]
[--on-no-data-accessible {io-error | suspend-io}]
drbdsetup new-minor resource minor volume
drbdsetup del-resource resource
drbdsetup del-minor minor
drbdsetup attach minor lower_dev meta_data_dev meta_data_index [--size {val}]
[--max-bio-bvecs {val}] [--on-io-error {pass_on | call-local-io-error | detach}]
[--fencing {dont-care | resource-only | resource-and-stonith}] [--disk-barrier]
[--disk-flushes] [--disk-drain] [--md-flushes] [--resync-rate {val}]
[--resync-after {val}] [--al-extents {val}] [--al-updates]
[--discard-zeroes-if-aligned] [--disable-write-same] [--c-plan-ahead {val}]
[--c-delay-target {val}] [--c-fill-target {val}] [--c-max-rate {val}]
[--c-min-rate {val}] [--disk-timeout {val}]
[--read-balancing {prefer-local | prefer-remote | round-robin | least-pending | when-congested-remote | 32K-striping | 64K-striping | 128K-striping | 256K-striping | 512K-striping | 1M-striping}]
[--rs-discard-granularity {val}]
drbdsetup connect resource local_addr remote_addr [--tentative] [--discard-my-data]
[--protocol {A | B | C}] [--timeout {val}] [--max-epoch-size {val}]
[--max-buffers {val}] [--unplug-watermark {val}] [--connect-int {val}]
[--ping-int {val}] [--sndbuf-size {val}] [--rcvbuf-size {val}]
[--ko-count {val}] [--allow-two-primaries] [--cram-hmac-alg {val}]
[--shared-secret {val}]
[--after-sb-0pri {disconnect | discard-younger-primary | discard-older-primary | discard-zero-changes | discard-least-changes | discard-local | discard-remote}]
[--after-sb-1pri {disconnect | consensus | discard-secondary | call-pri-lost-after-sb | violently-as0p}]
[--after-sb-2pri {disconnect | call-pri-lost-after-sb | violently-as0p}]
[--always-asbp] [--rr-conflict {disconnect | call-pri-lost | violently}]
[--ping-timeout {val}] [--data-integrity-alg {val}] [--tcp-cork]
[--on-congestion {block | pull-ahead | disconnect}] [--congestion-fill {val}]
[--congestion-extents {val}] [--csums-alg {val}] [--csums-after-crash-only]
[--verify-alg {val}] [--use-rle] [--socket-check-timeout {val}]
drbdsetup disk-options minor [--on-io-error {pass_on | call-local-io-error | detach}]
[--fencing {dont-care | resource-only | resource-and-stonith}] [--disk-barrier]
[--disk-flushes] [--disk-drain] [--md-flushes] [--resync-rate {val}]
[--resync-after {val}] [--al-extents {val}] [--al-updates]
[--discard-zeroes-if-aligned] [--disable-write-same] [--c-plan-ahead {val}]
[--c-delay-target {val}] [--c-fill-target {val}] [--c-max-rate {val}]
[--c-min-rate {val}] [--disk-timeout {val}]
[--read-balancing {prefer-local | prefer-remote | round-robin | least-pending | when-congested-remote | 32K-striping | 64K-striping | 128K-striping | 256K-striping | 512K-striping | 1M-striping}]
[--rs-discard-granularity {val}]
drbdsetup net-options local_addr remote_addr [--protocol {A | B | C}] [--timeout {val}]
[--max-epoch-size {val}] [--max-buffers {val}] [--unplug-watermark {val}]
[--connect-int {val}] [--ping-int {val}] [--sndbuf-size {val}]
[--rcvbuf-size {val}] [--ko-count {val}] [--allow-two-primaries]
[--cram-hmac-alg {val}] [--shared-secret {val}]
[--after-sb-0pri {disconnect | discard-younger-primary | discard-older-primary | discard-zero-changes | discard-least-changes | discard-local | discard-remote}]
[--after-sb-1pri {disconnect | consensus | discard-secondary | call-pri-lost-after-sb | violently-as0p}]
[--after-sb-2pri {disconnect | call-pri-lost-after-sb | violently-as0p}]
[--always-asbp] [--rr-conflict {disconnect | call-pri-lost | violently}]
[--ping-timeout {val}] [--data-integrity-alg {val}] [--tcp-cork]
[--on-congestion {block | pull-ahead | disconnect}] [--congestion-fill {val}]
[--congestion-extents {val}] [--csums-alg {val}] [--csums-after-crash-only]
[--verify-alg {val}] [--use-rle] [--socket-check-timeout {val}]
drbdsetup resource-options resource [--cpu-mask {val}]
[--on-no-data-accessible {io-error | suspend-io}]
drbdsetup disconnect local_addr remote_addr [--force]
drbdsetup detach minor [--force]
drbdsetup primary minor [--force]
drbdsetup secondary minor
drbdsetup down resource
drbdsetup verify minor [--start {val}] [--stop {val}]
drbdsetup invalidate minor
drbdsetup invalidate-remote minor
drbdsetup wait-connect minor [--wfc-timeout {val}] [--degr-wfc-timeout {val}]
[--outdated-wfc-timeout {val}] [--wait-after-sb {val}]
drbdsetup wait-sync minor [--wfc-timeout {val}] [--degr-wfc-timeout {val}]
[--outdated-wfc-timeout {val}] [--wait-after-sb {val}]
drbdsetup role minor
drbdsetup cstate minor
drbdsetup dstate minor
drbdsetup resize minor [--size {val}] [--assume-peer-has-space] [--assume-clean]
[--al-stripes {val}] [--al-stripe-size-kB {val}]
drbdsetup check-resize minor
drbdsetup pause-sync minor
drbdsetup resume-sync minor
drbdsetup outdate minor
drbdsetup show-gi minor
drbdsetup get-gi minor
drbdsetup show {resource | minor | all}
drbdsetup suspend-io minor
drbdsetup resume-io minor
drbdsetup status {resource | all} [--color {val}]
drbdsetup events2 {resource | all}
drbdsetup events {resource | minor | all}
drbdsetup new-current-uuid minor [--clear-bitmap]
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@linbit.com> and Lars Ellenberg
<lars.ellenberg@linbit.com>
REPORTING BUGS
Report bugs to <drbd-user@lists.linbit.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
1. DRBD User's Guide
http://www.drbd.org/users-guide/
2. DRBD web site
http://www.drbd.org/