drbdadm - DRBD
管理のためのユーティリティ
drbdadm [options...]
[-- [backend-options...]] {command}
{context...}
drbdadm
ユーティリティーは、構成ファイルに基づいて
DRBD
を管理するために使用される。次のマニュアルを参照:
drbd.conf(5)。これは、高レベルのコマンドを
1
つまたは複数の下位レベルのコマンド
drbdsetup、drbdmeta
に変換する。これらのコマンドはカーネルモジュールを制御し、ディスク上のメタデータを操作する。
コマンドに応じて、
drbdadm
ユーティリティは、 1
つまたは複数のリソース、デバイス、接続、または対向ノード上で動作する。次のコマンドコンテキストが有効である。
resource
resource
で指定されたリソース、またはキーワード
all
は定義されたすべてのリソースを意味する。
device
マイナー番号で指定されたデバイス
（例えば minor-0）
またはリソースとボリューム番号
（resource/volume）。resource
が指定された場合、コマンドはそのリソースのすべてのデバイスに対して反復処理を行う。
connection
リソースと接続名で指定された接続
（resource:connection-name)。resource
が指定された場合、コマンドはそのリソースのすべての接続に対して反復処理を行う。
peer_device
リソース、接続名、およびボリューム番号で指定された対向ノード
（resource:connection-name/volume）。resource,
device, connection
が指定された場合、コマンドはそのリソース、デバイス、または接続のすべての対向ノード上に対して反復処理を行う。
二重ダッシュに続くすべてのオプションは、指定された下位レベルのユーティリティに渡される。さらに
drbdadm は drbdsetup
の多くのオプションを理解する。二重ダッシュを使わなくてもそれらを
drbdsetup に渡せる。
-d, --dry-run
drbdadm
がどのコマンドを実行するか、それらを実際に実行する代わりに表示する
（たとえば、 drbdadm -d up
resource）。これは、drbdsetup、drbdmeta
がどのように使用されてるかを学習するのに便利な方法である。
-c, --config-file file
代わりの設定ファイルを指定する。デフォルトで
drbdadm
は、存在する次のファイルのうちの最初のものを使用する。
/etc/drbd-90.conf、 /etc/drbd-84.conf、
/etc/drbd-83.conf、 /etc/drbd-82.conf、
/etc/drbd-08.conf、 /etc/drbd.conf。
-t, --config-to-test file
追加の構成ファイルを確認する。dump
コマンドまたは sh-nop
コマンドと共に使用する場合のみ有効である。
-s, --drbdsetup file
drbdsetup
プログラムのフルパスを指定する。省略すると、自身のコマンド配置場所配下と、$PATH
が参照される。
-m, --drbdmeta file
drbdmeta
プログラムのフルパスを指定する。省略すると、自身のコマンド配置場所配下と、$PATH
が参照される。
-S, --stacked
スタックリソースに対してコマンドを実行する。
adjust {resource}
カーネルモジュールの設定を、設定ファイルと一致するように調整する。結果は、すべてのリソースを停止して再起動する場合と同じになる
（
drbdadm down all の後に
drbdadm up
all）。中断することないだけが違いである。
adjust
コマンドは、場合によっては設定変更を誤って解釈する可能性があるので注意すべきである。安全を期すために、実行前にコマンドが何をするのかを
--dry-run
オプションを使用して確認すること。
adjust-with-progress {resource}
adjust
と同じだが、コマンドの進捗状況についてさらに詳しい情報がある。
apply-al {device}
指定したデバイスのアクティビティログを適用する。次のマニュアルを参照:
drbdmeta(8)
attach {device}
下位デバイスを既存の複製デバイスに接続する。次のマニュアルを参照:
drbdsetup(8)
check-resize {device}
内部メタデータの移動のために
drbdmeta を呼び出す。DRBD
の停止中に下位デバイスのサイズが変更された場合、次回の
attach
コマンドが成功するように、メタデータをデバイスの最後に移動する必要がある。
connect {connection}
対向ノードへの既存の接続をアクティブにする。最初に
new-peer
コマンドを使用して接続を作成する必要があり、少なくとも
１
つ作られている必要がある。次のマニュアルを参照:
drbdsetup(8)
create-md {device}
デバイスのメタデータを初期化する。これは、デバイスを接続する前に必要である。次のマニュアルを参照:
drbdmeta(8)
cstate {connection}
接続の現在の状態を表示する。次のマニュアルを参照:
drbdsetup(8)
detach {device}
複製されたデバイスの下位デバイスを切り離す。次のマニュアルを参照:
drbdsetup(8)
disconnect {connection}
対向ノードへの接続を削除する。次のマニュアルを参照:
drbdsetup(8)
disk-options {device}
接続された下位デバイスのディスクオプションを変更する。次のマニュアルを参照:
drbdsetup(8)
down {resource}
すべてのボリューム、接続、およびリソース自体を削除して、リソースを落とす。次のマニュアルを参照:
drbdsetup(8)
dstate {device}
下位デバイスの現在のディスク状態を表示する。次のマニュアルを参照:
drbdsetup(8)
dump {resource}
設定ファイルを解析して標準出力に出力する。構成ファイルが構文的に正しくない場合、失敗する。
dump-md {device}
ビットマップおよびアクティビティログを含むデバイスのメタデータをテキスト形式でダンプする。次のマニュアルを参照:
drbdmeta(8)
get-gi {peer_device}
特定の接続上のデバイスのデータ世代識別子を表示する。接続されたデバイスには
drbdsetup
を、接続されていないデバイスには
drbdmeta
を使用する。次のマニュアルを参照:
drbdsetup(8)
hidden-commands
明示的に文書化されていないすべてのコマンドを表示する。
invalidate {peer_device}
デバイスのローカルデータを対向ノードのローカルデータで置き換える。次のマニュアルを参照:
drbdsetup(8)
invalidate-remote {peer_device}
対向ノードのリソースデータをローカルデータで置き換える。次のマニュアルを参照:
drbdsetup(8)
net-options {connection}
既存の接続のネットワークオプションを変更する。次のマニュアルを参照:
drbdsetup(8)
new-current-uuid {device}
新しい currend UUID
を生成する。次のマニュアルを参照:
drbdsetup(8)
outdate {device}
下位デバイスのデータ内容が「無効」であるとマークする。次のマニュアルを参照:
drbdsetup(8)
pause-sync {peer_device}
ローカルポーズフラグを設定して、ローカルデバイスと対向ノードとの再同期を停止する。次のマニュアルを参照:
drbdsetup(8)
primary {resource}
リソース内のノードの役割をプライマリに変更する。次のマニュアルを参照:
drbdsetup(8)
resize {device}
すべてのノードで、複製されたデバイスの下位デバイスのサイズを変更する。これは
check-resize と下位レベルの
resize
コマンドを組み合わせる。以下のマニュアルを参照:
drbdsetup(8)
resource-options {resource}
既存のリソースのリソースオプションを変更する。次のマニュアルを参照:
drbdsetup(8)
resume-sync {peer_device}
ローカル同期の一時停止フラグをクリアして、再同期を再開できるようにする。次のマニュアルを参照:
drbdsetup(8)
role {resource}
リソースの現在の役割を表示する。
secondary {resource}
リソース内のノードの役割をセカンダリに変更する。複製されたデバイスが使用中の場合、このコマンドは失敗する。
show-gi {peer_device}
特定の接続上のデバイスのデータ世代識別子を表示する。さらに、出力の説明を行う。次のマニュアルを参照:
drbdsetup(8)
state {resource}
これは drbdsetup role
の別名である。推奨しない。
up {resource}
すべてのボリュームのアクティビティ・ログを適用し、リソースを作成し、複製されたデバイスを作成し、下位デバイスを接続し、すべての対向ノードに接続することにより、リソースを起動する。drbdmeta
コマンドの apply-al , drbdsetup
コマンドの new-resource,
new-device, new-minor, attach, connect
を参照。
verify {peer_device}
オンライン照合を開始するか、デバイスの検証部分を変更するか、オンライン照合を停止する。次のマニュアルを参照:
drbdsetup(8)
wait-connect {[device] | [connection] |
[resource]}
対向ノード上のデバイス、接続上のすべてのデバイス、またはすべての対向ノード上のすべてのデバイスが見つかるまで待つ。次のマニュアルを参照:
drbdsetup(8)
wait-sync {[device] | [connection] |
[resource]}
デバイスが接続され、最終的に再同期操作が終了するまで待つ。接続とリソースレベルでも使用できる。次のマニュアルを参照:
drbdsetup(8)
wipe-md {device}
デバイスのDRBDメタデータを消去する。次のマニュアルを参照:
drbdmeta(8)
forget-peer {connection}
接続されていない対向ノードへの参照をすべてメタデータから完全に削除する。次のマニュアルを参照:
drbdmeta(8)
このドキュメントは
DRBD バージョン 9.0.0
向けに改訂されている。
Written by Philipp Reisner <philipp.reisner@linbit.com> and
Lars Ellenberg <lars.ellenberg@linbit.com>
Report bugs to <drbd-user@lists.linbit.com>.
Copyright 2001-2018 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), drbdsetup(8),
drbdmeta(8) and the DRBD project web site[1]
- 1.
- DRBD project web site
http://www.drbd.org/