drbdadm [-d] [-c{file}] [-t{file}] [-s{cmd}] [-m{cmd}] [-S] [-h{host}] [--{backend-options}] { command } [ all | resource ... ]
drbdadmはDRBDプログラム群の中で高レベルのツールである。drbdadmはdrbdsetup、drbdmeta、IPアドレスについてはifconfigに対する上位レベルのインタフェースになる。drbdadmは設定ファイルを読み込んで、drbdsetupやdrbdmetaを呼び出して必要なコマンドを実行する。
-d, --dry-run実行すべきdrbdsetupコマンドを標準出力に書き出すが、実際にはコマンドを実行しない。
-c, --config-file filedrbdadmが使う設定ファイルを指定する。このパラメータを省略すると、/etc/drbd-83.conf、/etc/drbd-08.confおよび/etc/drbd.confが使われる。
-t, --config-to-test filedrbdadm にチェックさせる設定ファイルを指定する。このオプションは、dump コマンドまたはsh-nop コマンドと共に使用する場合のみ有効である。
-s, --drbdsetup filedrbdsetupコマンドの絶対パスを指定する。このパラメータを省略すると、drbdadmは/sbin/drbdsetupおよび ./drbdsetupを探す。
-m, --drbdmeta filedrbdmetaコマンドの絶対パスを指定する。このパラメータを省略すると、drbdadmは/sbin/drbdmetaおよび./drbdmetaを探す。
-S, --stacked積み重ねた上位リソースに対する操作を指示する場合に指定する。
-P, --peerどの対向ノードと接続するかを指定する。リソースの定義に3台以上のホストを指定した場合にのみ指定しなければならない。
-- backend-options2重ハイフンの後に続く、オプションはすべてbackend-optionsとして認識される。 これらはバックエンドコマンドに渡される。すなわち drbdsetupやdrbdmeta、drbd-proxy-ctl などに渡される。
DRBDリソースに対応する低レベルのローカルブロックデバイスを接続する。
ソースに対応するネットワーク設定を有効にする。対応する接続先がすでに設定されていれば、2台のDRBDデバイスは相互に接続される。リソース定義中に3台以上のホストを指定してある場合、接続先ホストを指定するために--peerも指定する必要がある。
リソースのデバイス状態をプライマリ状態に切り替える。DRBDが管理するデバイスにファイルシステムを作成したりそれをマウントする前に、必ずこのコマンドを実行する必要がある。
デバイス状態をセカンダリ状態に切り替える。設定ファイル中にallow-two-primariesを明示的に書いた場合を除いて、接続されたDRBDデバイスペアのどちらか一方しかプライマリ状態になれないため、このコマンドが必要になる場合がある。
ローカル下位デバイスが非同期になったとDRBDに判断させる。したがって、両デバイスが同期状態になるよう、DRBDはすべてのブロックを他方のノードからコピーする。</
invalidateコマンドに似ているが、他方のノードの下位デバイスが非同期状態になったと見なす。したがってローカルノードのデータが他ノードにコピーされる。
DRBDにディスクサイズ関連の状態を再評価させ、必要ならデバイスのサイズを変更する。たとえば両ノードの低レベルデバイスのパーティションサイズを大きくした場合、両ノードでこのコマンドを実行した後でDRBDは両ノードのサイズを新しいサイズに合わせて調整する。
--assume-peer-has-space により、現在対向ノードに接続されていないデバイスのサイズを変することができる。対向ノードのディスクサイズを同様に変更しないと、以降接続が失敗するので注意すること。
内部のメタデータを移動させるため、drbdmeta を呼び出す。DRBDが停止している間に下位デバイスのサイズが変更された場合、メタデータはデバイスの最後に移動される。すると次回 attach コマンドが成功する。
メタデータ領域を初期化する。 DRBDリソースを初めて利用する場合、オンラインにする前にこのコマンドを実行する必要がある。このコマンドで問題が発生した場合、 drbdmeta(8) を参照すること。
データ世代識別子(data generation identifiers)の情報を、説明テキストとともにテキスト情報として表示する。
設定ファイルの設定値にしたがってデバイスの設定状態を調整する。実際に実行する前に、あらかじめdru-runモードを実行して、得られた出力を吟味すべきである。
自機および対向ノードのデバイスの現在の役割を"自機/対向ノード"の形式で表示する。たとえばPrimary/Secondary。
設定ファイルに指定されたすべてのデバイスの現在の状態をXML形式で表示する。次のように出力される。
<drbd-status version="8.3.2" api="88">
<resources config_file="/etc/drbd.conf">
<resource minor="0" name="s0" cs="SyncTarget" st1="Secondary" st2="Secondary"
ds1="Inconsistent" ds2="UpToDate" resynced_precent="5.9" />
<resource minor="1" name="s1" cs="WFConnection" st1="Secondary"
st2="Unknown" ds1="Inconsistent" ds2="Outdated" />
<resource minor="3" name="dummy" cs="Unconfigured" />
<!-- resource minor="4" name="scratch" not available or not yet created -->
</resources>
</drbd-status>
オンライン照合を実行する。両ノードのデータが比較され、不整合がないか検査される。 進行状況は/proc/drbdに表示される。非同期ブロックが見つかった場合でも、自動的な再同期は行われない。再同期を実行したい場合は、検査が終わった後にいったんdisconnectを実行して、さらにconnectする。
drbd.conf(5)のデータ整合性に関する説明も参照のこと。
ローカルメタデータの一時停止フラグをセットして、進行中の再同期を一時停止する。再開させるには、ローカルと他ノードの両方の一時停止フラグをクリアする必要がある。下位デバイスのRAIDを再構成している場合などに、一時的にDRBDの再同期を停止できる。
現在のUUIDを生成して、他のすべてのUUIDをローテートする。
初期同期時間を短縮するためにこのコマンドを利用できる。詳細については、drbdsetup(8)も参照。
下位デバイスの同期状況を表示する。 表示形式は"ローカル/他ノード"である(例: UpToDate/Inconsistent)。
このマニュアルに記載されていない全部のコマンドを表示する。