drbdmeta [--force] [--ignore-sanity-checks] { device } { v06 minor | v07 meta_dev index | v08 meta_dev index } { command } [ cmd args ...]
drbdmetaは、DRBDメタデータを作成、内容表示、あるいは変更する。通常はフロントエンドのdrbdadm(8)コマンドを使うため、このコマンドを直接使用する必要はない。
このコマンドは、DRBDリソースを無効にしてある場合、もしくは少なくとも下位レベルストレージから切り離してある場合のみ動作する。最初の引数は、リソースに結び付けたデバイス名である。第2引数はメタデータのバージョンで、現在の主要な全バージョン(0.6、0.7および8.0)が指定できる。
メタデータストレージを作成する。 DRBDリソースを初めて利用する場合、オンラインにする前にこのコマンドを実行する必要がある。すでに古いバージョンのメタデータが存在する場合、drbdmetaは指定したバージョンの形式に変換するかどうかを尋ねる。
データ世代識別子(data generation identifiers)の情報を簡潔なテキスト情報として表示する。バージョン0.6および0.7形式のメタデータには世代カウンタがあるが、バージョン8ではUUIDが表示される。
データ世代識別子(data generation identifiers)の情報を、説明テキストとともにテキスト情報として表示する。
メタデータの「無効」フラグをセットする。他ノードが自ノードと通信できない状態でプライマリ状態になりたい場合、他ノードからのリモート実行でこのコマンドが実行される。
下位レベルストレージの状態を表示する。drbdmetaはローカルメタデータのみにアクセスするため、出力にははつねに'/DUnknown'が表示される。
下位デバイスのデバイスサイズを調べ、最新のデバイスサイズを、ファイル /var/lib/drbd/drbd-minor-??.lkbd に記録する。下位デバイスのサイズが変更されている場合、または古い場所にメタデータを検出した場合、メタデータを正しい場所であるブロックデバイスの最後に移動させる。
drbdmetaを使うと、メタデータの内容を変更できる。以下のコマンドは、コマンド自身の使用法表示から意図的に削除してある。これは、何をしているのか明確に理解した上で実行しないと危険なためである。データ世代識別子に間違った値をセットすると、古いデータで最新データを上書きしてしまうなどのリスクが生じる。