Common options

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

--create-device

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

--on-io-error err_handler

--fencing fencing_policy

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

--md-flushes

--max-bio-bvecs

--resync-rate rate

--resync-after minor

--al-extents extents

--al-updates {yes | no}

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

--c-min-rate min_rate

-t, --disk-timeout disk_timeout

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

--disable-write-same {yes | no}

--read-balancing method

--rs-discard-granularity bytes

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

--connect-int time

--ping-int time

--timeout val

--sndbuf-size size

--rcvbuf-size size

--ko-count count

--max-epoch-size val

--max-buffers val

--unplug-watermark val

--allow-two-primaries

--cram-hmac-alg alg

--shared-secret secret

--after-sb-0pri asb-0p-policy

--after-sb-1pri asb-1p-policy

--after-sb-2pri asb-2p-policy

--always-asbp

--rr-conflict role-resync-conflict-policy

--data-integrity-alg hash_alg

--no-tcp-cork

--ping-timeout ping_timeout

--discard-my-data

--tentative

--on-congestion congestion_policy,
--congestion-fill fill_threshold,
--congestion-extents active_extents_threshold

--verify-alg hash-alg

--csums-alg hash-alg

--use-rle

--socket-check-timeout

resource-options

Changes the options of the resource at runtime.

--cpu-mask cpu-mask

--on-no-data-accessible ond-policy

primary

デバイスをプライマリロールに切り替える。するとアプリケーション (この場合はファイルシステムなど) はデバイスを読み書きモードでオープンできるようになる。プライマリロールのデバイスに書き込まれたデータはセカンダリロールのデバイスにミラーされる。

通常の実行状態では、 DRBD デバイスペアの両方を同時にプライマリに切り替えることはできない。--allow-two-primaries オプションを使用すると、DRBD の既定の仕様を変更して両ノードをプライマリにできる。

--overwrite-data-of-peer

--force

secondary

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

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

verify

オンライン状態でデバイスを照合する。オンライン照合は、ローカルノードの全ブロックを対向ノードの対応するブロックと比較することである。照合の進行状況は、 /proc/drbd を通じて確認できる。ローカルディスクと対向ホストで内容が異なるブロックは、 DRBD のディスク上ビットマップに不整合としてマークされる。これらは自動的な再同期が行われない。再同期を行うには、いったんリソースの接続を切って再接続すればよい。

すでにオンライン照合が進行中の場合、 (当該ノードが照合を行い) このコマンドは成功する。この場合、 start-sector (以下参照) は無視され、 stop-sector (以下参照) が採用される。これは照合を終了するため、あるいは現在進行中の照合の範囲を 更新/ 短縮/ 拡張 するために使用される。

このコマンドはデバイスが接続されているデバイスペアのうちの一つでない場合は失敗する。

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

--start start-sector

-S, --stop 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

wait-sync

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

disconnect

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

detach

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

-f, --force

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}

たとえば、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

--unfiltered

new-current-uuid

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

利用可能なオプション:

--clear-bitmap

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

この方法の明らかな欠点は、別の方法でディスク内容を同一にしない限り、複製物全体に古いゴミのデータが残ることである。このため、オンライン照合は多数の非同期ブロックを見出してしまう。

この方法は、すでにデータのあるディスクに適用してはならない！ 最初は動作しているように見えても、ノードの切り替えを行うとデータが壊れてしまい二度と使えなくなる。そのため、mkfs を省略してはならない　(またはそれに相当する操作)。

このコマンドは、最初のノードを本稼働させた後でディスク自体を 2 番目のノードに移すという手法により、クラスタの初期化時間を短縮する目的にも適用できる。この方法は、切断されたデバイスに対してのみ有効である。デバイスのロールはプライマリでもセカンダリでもよい。

必要なステップは以下のとおり:

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