DRBDADM(8)

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 コマンドを使用して接続を作成する必要があり、少なくとも １ つ作られている必要がある。次のマニュアルを参照: 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/