Provided by: drbd-utils_9.22.0-1.1_amd64
NAME
drbdadm - DRBD 管理のためのユーティリティ
SYNOPSIS
drbdadm [options...] [-- [backend-options...]] {command} {context...}
DESCRIPTION
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 に渡せる。
OPTIONS
-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 スタックリソースに対してコマンドを実行する。
COMMANDS
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 コマンドを使用して接続を作 成する必要があり、少なくとも 1 つ作られている必要がある。次のマニュアルを参照: 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)
VERSION
このドキュメントは DRBD バージョン 9.0.0 向けに改訂されている。
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-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.
SEE ALSO
drbd.conf(5), drbd(8), drbdsetup(8), drbdmeta(8) and the DRBD project web site[1]
NOTES
1. DRBD project web site http://www.drbd.org/