名前

drbdadm — DRBDの管理ツール

概要

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 file

drbdadmが使う設定ファイルを指定する。このパラメータを省略すると、/etc/drbd-83.conf/etc/drbd-08.confおよび/etc/drbd.confが使われる。

-t, --config-to-test file

drbdadm にチェックさせる設定ファイルを指定する。このオプションは、dump コマンドまたはsh-nop コマンドと共に使用する場合のみ有効である。

-s, --drbdsetup file

drbdsetupコマンドの絶対パスを指定する。このパラメータを省略すると、drbdadmは/sbin/drbdsetupおよび ./drbdsetupを探す。

-m, --drbdmeta file

drbdmetaコマンドの絶対パスを指定する。このパラメータを省略すると、drbdadmは/sbin/drbdmetaおよび./drbdmetaを探す。

-S, --stacked

積み重ねた上位リソースに対する操作を指示する場合に指定する。

-P, --peer

どの対向ノードと接続するかを指定する。リソースの定義に3台以上のホストを指定した場合にのみ指定しなければならない。

-- backend-options

2重ハイフンの後に続く、オプションはすべてbackend-optionsとして認識される。 これらはバックエンドコマンドに渡される。すなわち drbdsetupdrbdmetadrbd-proxy-ctl などに渡される。

コマンド

attach

DRBDリソースに対応する低レベルのローカルブロックデバイスを接続する。

detach

DRBDリソースに接続していたブロックデバイスを切り離す。

connect

ソースに対応するネットワーク設定を有効にする。対応する接続先がすでに設定されていれば、2台のDRBDデバイスは相互に接続される。リソース定義中に3台以上のホストを指定してある場合、接続先ホストを指定するために--peerも指定する必要がある。

disconnect

リソースに対するネットワーク設定を無効にする。デバイスは当然ながらスタンドアローン状態になる。

syncer

デバイスの再同期に関するパラメータを読み込む。

up

attachとconnectの両方を実行するショートカット。

down

disconectとdetachの両方を実行するショートカット。

primary

リソースのデバイス状態をプライマリ状態に切り替える。DRBDが管理するデバイスにファイルシステムを作成したりそれをマウントする前に、必ずこのコマンドを実行する必要がある。

secondary

デバイス状態をセカンダリ状態に切り替える。設定ファイル中にallow-two-primariesを明示的に書いた場合を除いて、接続されたDRBDデバイスペアのどちらか一方しかプライマリ状態になれないため、このコマンドが必要になる場合がある。

invalidate

ローカル下位デバイスが非同期になったとDRBDに判断させる。したがって、両デバイスが同期状態になるよう、DRBDはすべてのブロックを他方のノードからコピーする。</

invalidate-remote

invalidateコマンドに似ているが、他方のノードの下位デバイスが非同期状態になったと見なす。したがってローカルノードのデータが他ノードにコピーされる。

resize

DRBDにディスクサイズ関連の状態を再評価させ、必要ならデバイスのサイズを変更する。たとえば両ノードの低レベルデバイスのパーティションサイズを大きくした場合、両ノードでこのコマンドを実行した後でDRBDは両ノードのサイズを新しいサイズに合わせて調整する。

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

check-resize

内部のメタデータを移動させるため、drbdmeta を呼び出す。DRBDが停止している間に下位デバイスのサイズが変更された場合、メタデータはデバイスの最後に移動される。すると次回 attach コマンドが成功する。

create-md

メタデータ領域を初期化する。 DRBDリソースを初めて利用する場合、オンラインにする前にこのコマンドを実行する必要がある。このコマンドで問題が発生した場合、 drbdmeta(8) を参照すること。

get-gi

データ世代識別子(data generation identifiers)の情報を簡潔なテキスト情報として表示する。

show-gi

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

dump-md

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

outdate

メタデータの「無効」フラグをセットする。

adjust

設定ファイルの設定値にしたがってデバイスの設定状態を調整する。実際に実行する前に、あらかじめdru-runモードを実行して、得られた出力を吟味すべきである。

wait-connect

他ノードのデバイスと接続するまで待機する。

role

自機および対向ノードのデバイスの現在の役割を"自機/対向ノード"の形式で表示する。たとえばPrimary/Secondary。

state

廃止された"role"の別名。前項を参照。

cstate

両ノードのデバイスの接続状態を表示する。

status

設定ファイルに指定されたすべてのデバイスの現在の状態を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>

dump

設定ファイルを調べて現在の値を標準出力に表示する。設定ファイルの構文上の修正を行うときに有用である。

outdate

ノードのデータ状態を「無効」にする。通常は、他ノードのfence-peerハンドラによってセットされる。

verify

オンライン照合を実行する。両ノードのデータが比較され、不整合がないか検査される。 進行状況は/proc/drbdに表示される。非同期ブロックが見つかった場合でも、自動的な再同期は行われない。再同期を実行したい場合は、検査が終わった後にいったんdisconnectを実行して、さらにconnectする。

drbd.conf(5)のデータ整合性に関する説明も参照のこと。

pause-sync

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

resume-sync

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

new-current-uuid

現在のUUIDを生成して、他のすべてのUUIDをローテートする。

初期同期時間を短縮するためにこのコマンドを利用できる。詳細については、drbdsetup(8)も参照。

dstate

下位デバイスの同期状況を表示する。 表示形式は"ローカル/他ノード"である(例: UpToDate/Inconsistent)。

hidden-commands

このマニュアルに記載されていない全部のコマンドを表示する。

バージョン

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

著者

Philipp Reisner、Lars Ellenberg

バグ報告方法

バグについては、.

著作権

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.

参照

drbd.conf(5), drbd(8), drbddisk(8), drbdsetup(8), drbdmeta(8) and the DRBD project web site