en to ja translation catalogue (390 entries)

note: type: Title ==
en: Common administrative tasks
ja: 一般的な管理作業

note: type: Plain text
en: This chapter outlines typical administrative tasks encountered during day-to-day operations. It does not cover troubleshooting tasks, these are covered in detail in <<ch-troubleshooting>>.
ja: この章では一般的なオペレーションでの管理作業を説明します。トラブルシューティングについては扱いません。トラブルシューティングについては<<ch-troubleshooting>>を参照ください。

note: type: Title ===
en: Checking DRBD status
ja: DRBDのステータスを確認する

note: type: Title ====
en: Retrieving status with drbdmon
ja: drbdmon でステータスを取得する

note: type: Plain text
en: One convenient way to look at DRBD's status is the `drbdmon` utility. It updates the state of DRBD resources in real time.
ja: DRBDの状態を見るのに便利な方法の1つは `drbdmon` ユーティリティを使うことです。これはリアルタイムでDRBDリソースの状態を更新します。

note: type: Title ====
en: Status information in `/proc/drbd`
ja: `/proc/drbd` でのステータス情報

note: type: Plain text
en: `/proc/drbd` is deprecated. While it won't be removed in the 8.4 series, we recommend to switch to other means, like <<s-drbdadm-status>>; or, for monitoring even more convenient, <<s-drbdsetup-events2>>.
ja: ''/proc/drbd'' は非推奨です。8.4系でこの機能を取り除く予定はありませんが、他の方法を使用することをおすすめします。<<s-drbdadm-status>>や、より便利なモニタリングとして<<s-drbdsetup-events2>>など

note: type: Plain text
en: indexterm:[/proc/drbd]`/proc/drbd` is a virtual file displaying basic information about the DRBD module.  It was used extensively up to DRBD 8.4, but couldn't keep up with the amount of information provided by DRBD 9.
ja: indexterm:[/proc/drbd]`/proc/drbd` はDRBDモジュールの基本情報を表示する仮想ファイルです。 DRBD8.4まで広く使用されていましたが、DRBD9の情報量を表示するためには対応できません。

note: type: Plain text
en: The first line, prefixed with `version:`, shows the DRBD version used on your system. The second line contains information about this specific build.
ja: 1行目にはシステムで使用するDRBDの `バージョン` を表示します。2行目にはビルド特有の情報を表示します。

note: type: Title ====
en: Status information via `drbdadm`
ja: `drbdadm` でのステータス情報

note: type: Plain text
en: indexterm:[drbdadm, status]In its simplest invocation, we just ask for the status of a single resource.
ja: indexterm:[drbdadmステータス]一番シンプルなものとして、1つのリソースのステータスを表示します。

note: type: Plain text
en: This here just says that the resource _home_ is locally, on 'nina', and on 'nino' _UpToDate_ and _Secondary_; so the three nodes have the same data on their storage devices, and nobody is using the device currently.
ja: ここではリソース `home` がローカルと `nina` と `nino` にあり、 `UpToDate` で `セカンダリ` であることを示しています。つまり、3ノードが同じデータをストレージデバイスに持ち、現在はどのノードでもデバイスを使用していないという意味です。

note: type: Plain text
en: The node 'nono' is not connected, its state is reported as _Connecting_; please see <<s-connection-states>> below for more details.
ja: ノード `nono` は接続していません。 _Connecting_ のステータスになっています。詳細は<<s-connection-states>>を参照してください。

note: type: Plain text
en: You can get more information by passing the `--verbose` and/or `--statistics` arguments to `drbdsetup` (lines broken for readability):
ja: `drbdsetup` に `--verbose` および/または `--statistics` の引数を付けると、より詳細な情報を得ることができます。

note: type: Plain text
en: Every few lines in this example form a block that is repeated for every node used in this resource, with small format exceptions for the local node - see below for more details.
ja: この例では、ローカルノードについては多少異なりますが、このリソースで使用しているノードすべてを数行ごとにブロックで表示しています。以下で詳細を説明します。

note: type: Plain text
en: The first line in each block shows the `node-id` (for the current resource; a host can have different ``node-id``s in different resources).  Furthermore the `role` (see <<s-roles>>) is shown.
ja: 各ブロックの最初の行は `node-id` です。(現在のリソースに対してのものです。ホストは異なるリソースには異なる `node-id` がつきます)  また、 `role` (<<s-roles>>参照)も表示されています。

note: type: Plain text
en: The next important line begins with the `volume` specification; normally these are numbered starting by zero, but the configuration may specify other IDs as well. This line shows the indexterm:[connection state] connection state in the `replication` item (see <<s-connection-states>> for details) and the remote indexterm:[disk state] disk state in `disk` (see <<s-disk-states>>).  Then there's a line for this volume giving a bit of statistics - data `received`, `sent`, `out-of-sync`, etc; please see <<s-performance-indicators>> and <<s-conn-info>> for more information.
ja: 次に重要な行が、 `volume` の表示がある行です。通常は0から始まる数字ですが、設定によっては別のIDをつけることもできます。この行では `replication` でindexterm:[connection state]コネクションステータス(<<s-connection-states>>参照)を、 `disk` でリモートのディスク状態indexterm:[disk state](<<s-disk-states>>参照)が表示されます。 また、ボリュームの統計情報が少し表示される行もあります。データの `received` 、 `sent` , `out-of-sync` などです。詳細は <<s-performance-indicators>>と<<s-conn-info>>を参照してください。

note: type: Plain text
en: For the local node the first line shows the resource name, _home_, in our example. As the first block always describes the local node, there is no _Connection_ or address information.
ja: ローカルノードでは、最初の行はリソース名を表示します。この例では `home` です。最初の行には常にローカルノードが表示されますので、 `Connection` やアドレス情報は表示されません。

note: type: Plain text
en: please see the `drbd.conf` manual page for more information.
ja: より詳細な情報については、 `drbd.conf` マニュアルページをご覧ください。

note: type: Plain text
en: The other four lines in this example form a block that is repeated for every DRBD device configured, prefixed by the device minor number. In this case, this is `0`, corresponding to the device `/dev/drbd0`.
ja: この例のブロックになっている他の4行は、すべての設定のあるDRBDデバイスごとになっており、最初にデバイスマイナー番号がついています。この場合にはデバイス `/dev/drbd0` に対応して `0` です。

note: type: Plain text
en: The resource-specific output contains various pieces of information about the resource:
ja: リソースごとの出力には様々なリソースに関する情報が含まれています。

note: //FIXME .Replication protocol The Replication protocol used by the resource. Either `A`, `B`, or `C`. See <<s-replication-protocols>> for details. type: Title ====
en: One-shot or real time monitoring via `drbdsetup events2`
ja: `drbdsetup events2` を使用した一回のみ、またはリアルタイムでの監視

note: and 8.4.6 type: Plain text
en: This is available only with userspace versions 8.9.3 and up.
ja: この機能はユーザスペースのDRBDが8.9.3より後のバージョンでのみ使用できます

note: type: Plain text
en: This is a low-level mechanism to get information out of DRBD, suitable for use in automated tools, like monitoring.
ja: これはDRBDから情報を取得するための下位機能です。監視など自動化ツールでの使用に向いています。

note: type: Plain text
en: In its simplest invocation, showing only the current status, the output looks like this (but, when running on a terminal, will include colors):
ja: 一番シンプルな使用方法では、以下のように現在のステータスのみを表示します(端末上で実行した場合には色も付いています)。

note: type: Plain text
en: Without the ''--now'', the process will keep running, and send continuous updates like this:
ja: ''--now'' を付けないで実行した場合には動作し続け、以下のように更新を続けます。

note: type: Plain text
en: Then, for monitoring purposes, there's another argument ''--statistics'', that will produce some performance counters and other facts:
ja: そして監視用途に、''--statistics''という別の引数もあります。これはパフォーマンスその他のカウンタを作成するものです。

note: type: Plain text
en: 'drbdsetup' **verbose output** (lines broken for readability):
ja: ''drbdsetup'' の詳細な出力(読みやすいように一部の行は改行しています)

note: type: Plain text
en: You might also like the ''--timestamp'' parameter.
ja: ''--timestamp'' パラメータも便利な機能です。

note: type: Title ====
en: Connection states
ja: コネクションステータス

note: type: Plain text
en: indexterm:[drbdadm, cstate]indexterm:[connection state, via drbdadm]A resource's connection state can be observed either by issuing the `drbdadm cstate` command:
ja: indexterm:[drbdadm cstate]indexterm:[connection state]リソースのコネクションステータスは `drbdadm cstate` コマンドで確認することができます。

note: type: Plain text
en: If you are interested in only a single connection of a resource, specify the connection name, too:
ja: 確認したいのが１つのコネクションステータスだけの場合にはコネクション名を指定してください。

note: type: Plain text
en: The default is the peer's hostname as given in the configuration file.
ja: デフォルトでは設定ファイルに記載のある対向ノードのホスト名です。

note: type: Plain text
en: A resource may have one of the following connection states:
ja: リソースのコネクションステータスには次のようなものがあります。

note: type: Plain text
en: indexterm:[connection state, StandAlone]No network configuration available. The resource has not yet been connected, or has been administratively disconnected (using `drbdadm disconnect`), or has dropped its connection due to failed authentication or split brain.
ja: indexterm:[connection state]ネットワーク構成は使用できません。リソースがまだ接続されていない、管理上の理由で切断している( `drbdadm disconnect` を使用)、認証の失敗またはスプリットブレインにより接続が解除された、のいずれかが考えられます。

note: type: Plain text
en: indexterm:[connection state, Disconnecting]Temporary state during disconnection. The next state is _StandAlone_.
ja: indexterm:[connection state]切断中の一時的な状態です。次の状態は `StandAlone` です。

note: type: Plain text
en: indexterm:[connection state, Unconnected]Temporary state, prior to a connection attempt. Possible next states: _Connecting_.
ja: indexterm:[connection state, Unconnected]接続を試行する前の一時的な状態です。次に考えられる状態は、 _Connecting_ です。

note: type: Plain text
en: indexterm:[connection state, Timeout]Temporary state following a timeout in the communication with the peer. Next state: _Unconnected_.
ja: indexterm:[connection state]対向ノードとの通信のタイムアウト後の一時的な状態です。次の状態は `Unconnected` です。

note: type: Plain text
en: indexterm:[connection state, BrokenPipe]Temporary state after the connection to the peer was lost. Next state: _Unconnected_.
ja: indexterm:[connection state]対向ノードとの接続が失われた後の一時的な状態です。次の状態は `Unconnected` です。

note: type: Plain text
en: indexterm:[connection state, NetworkFailure]Temporary state after the connection to the partner was lost. Next state: _Unconnected_.
ja: indexterm:[connection state]対向ノードとの接続が失われた後の一時的な状態です。次の状態は `Unconnected` です。

note: type: Plain text
en: indexterm:[connection state, ProtocolError]Temporary state after the connection to the partner was lost. Next state: _Unconnected_.
ja: indexterm:[connection state]対向ノードとの接続が失われた後の一時的な状態です。次の状態は `Unconnected` です。

note: type: Plain text
en: indexterm:[connection state, TearDown]Temporary state. The peer is closing the connection. Next state: _Unconnected_.
ja: indexterm:[connection state]一時的な状態です。対向ノードが接続を閉じています。次の状態は `Unconnected` です。

note: type: Plain text
en: indexterm:[connection state, Connecting]This node is waiting until the peer node becomes visible on the network.
ja: indexterm:[connection state, Connecting]対向ノードがネットワーク上で可視になるまでノードが待機します。

note: type: Plain text
en: indexterm:[connection state, Connected]A DRBD connection has been established, data mirroring is now active. This is the normal state.
ja: indexterm:[connection state, Connected]DRBDの接続が確立され、データミラー化がアクティブになっています。これが正常な状態です。

note: type: Title ====
en: Replication states
ja: 複製ステータス

note: type: Plain text
en: Each volume has over each connection a replication state. The possible replication states are:
ja: 各ボリュームは接続を介した複製ステータスを持ちます。可能な複製ステータスは以下になります。

note: type: Plain text
en: indexterm:[replication state, Off]The volume is not replicated over this connection, since the connection is not _Connected_.
ja: indexterm:[replication state, Off]ボリュームはこの接続を通して複製されていません。接続が _Connected_ になっていません。す。次の状態は `Unconnected` です。

note: type: Plain text
en: indexterm:[replication state, Established]All writes to that volume are replicated online. This is the normal state.
ja: indexterm:[replication state, Established]このボリュームへのすべての書き込みがオンラインで複製されています。これは通常の状態です。

note: type: Plain text
en: indexterm:[replication state, StartingSyncS]Full synchronization, initiated by the administrator, is just starting. The next possible states are: _SyncSource_ or _PausedSyncS_.
ja: indexterm:[replication state,StartingSyncS]管理者により開始されたフル同期が始まっています。次に考えられる状態は `SyncSource` または `PausedSyncS` です。

note: type: Plain text
en: indexterm:[replication state, StartingSyncT]Full synchronization, initiated by the administrator, is just starting. Next state: _WFSyncUUID_.
ja: indexterm:[replication state, StartingSyncT]管理者により開始されたフル同期が始まっています。次の状態は _WFSyncUUID_ です。

note: type: Plain text
en: indexterm:[replication state, WFBitMapS]Partial synchronization is just starting. Next possible states: _SyncSource_ or _PausedSyncS_.
ja: indexterm:[replication state, WFBitMapS]部分同期が始まっています。次に考えられる状態は _SyncSource_ または _PausedSyncS_ です。

note: type: Plain text
en: indexterm:[replication state, WFBitMapT]Partial synchronization is just starting. Next possible state: _WFSyncUUID_.
ja: indexterm:[replication state, WFBitMapT]部分同期が始まっています。次に考えられる状態は `WFSyncUUID` です。

note: type: Plain text
en: indexterm:[replication state, WFSyncUUID]Synchronization is about to begin. Next possible states: _SyncTarget_ or _PausedSyncT_.
ja: indexterm:[replication state, WFSyncUUID]同期が開始されるところです。次に考えられる状態は _SyncTarget_ または _PausedSyncT_ です。

note: type: Plain text
en: indexterm:[replication state, SyncSource]Synchronization is currently running, with the local node being the source of synchronization.
ja: indexterm:[replication state, SyncSource]現在、ローカルノードを同期元にして同期を実行中です。

note: type: Plain text
en: indexterm:[replication state, SyncTarget]Synchronization is currently running, with the local node being the target of synchronization.
ja: indexterm:[replication state, SyncTarget]現在、ローカルノードを同期先にして同期を実行中です。

note: type: Plain text
en: indexterm:[replication state, PausedSyncS]The local node is the source of an ongoing synchronization, but synchronization is currently paused. This may be due to a dependency on the completion of another synchronization process, or due to synchronization having been manually interrupted by `drbdadm pause-sync`.
ja: indexterm:[replication state, PausedSyncS]ローカルノードが進行中の同期の同期元ですが、現在は同期が一時停止しています。原因として、別の同期プロセスの完了との依存関係、または `drbdadm pause-sync` を使用して手動で同期が中断されたことが考えられます。

note: type: Plain text
en: indexterm:[replication state, PausedSyncT]The local node is the target of an ongoing synchronization, but synchronization is currently paused. This may be due to a dependency on the completion of another synchronization process, or due to synchronization having been manually interrupted by `drbdadm pause-sync`.
ja: indexterm:[replication state, PausedSyncT]ローカルノードが進行中の同期の同期先ですが、現在は同期が一時停止しています。原因として、別の同期プロセスの完了との依存関係、または `drbdadm pause-sync` を使用して手動で同期が中断されたことが考えられます。

note: type: Plain text
en: indexterm:[replication state, VerifyS]On-line device verification is currently running, with the local node being the source of verification.
ja: indexterm:[replication state, VerifyS]ローカルノードを照合元にして、オンラインデバイスの照合を実行中です。

note: type: Plain text
en: indexterm:[replication state, VerifyT]On-line device verification is currently running, with the local node being the target of verification.
ja: indexterm:[replication state, VerifyT]現在、ローカルノードを照合先にして、オンラインデバイスの照合を実行中です。

note: type: Plain text
en: indexterm:[replication state, Ahead]Data replication was suspended, since the link can not cope with the load. This state is enabled by the configuration `on-congestion` option (see <<s-configure-congestion-policy>>).
ja: indexterm:[replication state, Ahead]リンクが負荷に対応できないので、データの複製が中断しました。このステータスは `on-congestion` オプションの設定で有効にできます(<<s-configure-congestion-policy>>を参照)。

note: type: Plain text
en: indexterm:[replication state, Behind]Data replication was suspended by the peer, since the link can not cope with the load. This state is enabled by the configuration `on-congestion` option on the peer node (see <<s-configure-congestion-policy>>).
ja: indexterm:[replication state, Behind]リンクが負荷に対応できないので、データの複製が対向ノードによって中断されました。このステータスは対向ノードの `on-congestion` オプション設定で有効にできま>す(<<s-configure-congestion-policy>>を参照)。

note: type: Title ====
en: Resource roles
ja: リソースのロール

note: type: Plain text
en: indexterm:[resource]A resource's role can be observed by issuing the indexterm:[drbdadm, role]`drbdadm role` command:
ja: indexterm:[resource]リソースのロールはindexterm:[drbdadm role]`drbdadm role` コマンドを実行することで確認できます。

note: type: Plain text
en: You may see one of the following resource roles:
ja: 以下のいずれかのリソースのロールが表示されます。

note: type: Plain text
en: indexterm:[role, Primary]The resource is currently in the primary role, and may be read from and written to. This role only occurs on one of the two nodes, unless <<s-dual-primary-mode,dual-primary mode>> is enabled.
ja: リソースは現在プライマリロールで読み書き加能です。2つのノードの一方だけがこのロールになることができます。ただし、<<s-dual-primary-mode,デュアルプライマリモード>>の場合は例外です。

note: type: Plain text
en: indexterm:[role, Secondary]The resource is currently in the secondary role. It normally receives updates from its peer (unless running in disconnected mode), but may neither be read from nor written to. This role may occur on one or both nodes.
ja: リソースは現在セカンダリロールです。対向ノードから正常に更新を受け取ることができますが(切断モード以外の場合)、このリソースに対して読み書きは実行できません。1つまたは両ノードがこのロールになることができます。

note: type: Plain text
en: indexterm:[role, Unknown]The resource's role is currently unknown. The local resource role never has this status. It is only displayed for the peer's resource role, and only in disconnected mode.
ja: リソースのロールが現在不明です。ローカルリソースロールがこの状態になることはありません。切断モードの場合に、対向ノードのリソースロールにのみ表示されます。

note: type: Title ====
en: Disk states
ja: ディスク状態

note: type: Plain text
en: A resource's disk state can be observed either by issuing the `drbdadm dstate` command:
ja: リソースのディスク状態は `drbdadm dstate` コマンドを実行することで確認できます。

note: type: Plain text
en: The disk state may be one of the following:
ja: ディスク状態は以下のいずれかです。

note: type: Plain text
en: indexterm:[disk state, Diskless]No local block device has been assigned to the DRBD driver. This may mean that the resource has never attached to its backing device, that it has been manually detached using `drbdadm detach`, or that it automatically detached after a lower-level I/O error.
ja: indexterm:[disk state]DRBDドライバにローカルブロックデバイスが割り当てられていません。原因として、リソースが下位デバイスに接続されなかった、 `drbdadm detach` を使用して手動でリソースを切り離した、または下位レベルのI/Oエラーにより自動的に切り離されたことが考えられます。

note: type: Plain text
en: indexterm:[disk state, Attaching]Transient state while reading meta data.
ja: indexterm:[disk state]メタデータ読み取り中の一時的な状態です。

note: type: Plain text
en: indexterm:[disk state, Detaching]Transient state while detaching and waiting for ongoing IOs to complete.
ja: indexterm:[disk state, Detaching]切断され、進行中のIO処理が完了するのを待っている一時的な状態。

note: type: Plain text
en: indexterm:[disk state, Failed]Transient state following an I/O failure report by the local block device. Next state: _Diskless_.
ja: indexterm:[disk state]ローカルブロックデバイスがI/O障害を報告した後の一時的な状態です。次の状態は `Diskless` です。

note: type: Plain text
en: indexterm:[disk state, Negotiating]Transient state when an _Attach_ is carried out on an already-__Connected__ DRBD device.
ja: indexterm:[disk state]すでに `Connected` のDRBDデバイスで `attach` が実行された場合の一時的状態です。

note: type: Plain text
en: indexterm:[disk state, Inconsistent]The data is inconsistent. This status occurs immediately upon creation of a new resource, on both nodes (before the initial full sync). Also, this status is found in one node (the synchronization target) during synchronization.
ja: indexterm:[disk state]データが一致しません。新規リソースを作成した直後に(初期フル同期の前に)両方のノードがこの状態になります。また、同期中には片方のノード(同期先)がこの状態になります。

note: type: Plain text
en: indexterm:[disk state, Outdated]Resource data is consistent, but <<s-outdate,outdated>>.
ja: indexterm:[disk state]リソースデータは一致していますが、<<s-outdate,無効>>です。

note: type: Plain text
en: indexterm:[disk state, DUnknown]This state is used for the peer disk if no network connection is available.
ja: indexterm:[disk state]ネットワーク接続を使用できない場合に、対向ノードディスクにこの状態が使用されます。

note: type: Plain text
en: indexterm:[disk state, Consistent]Consistent data of a node without connection. When the connection is established, it is decided whether the data is _UpToDate_ or _Outdated_.
ja: indexterm:[disk state]接続していない状態でノードのデータが一致しています。接続が確立すると、データが _UpToDate_ か _Outdated_ か判断されます。

note: type: Plain text
en: indexterm:[disk state, UpToDate]Consistent, up-to-date state of the data. This is the normal state.
ja: indexterm:[disk state]データが一致していて最新の状態です。これが正常な状態です。

note: type: Title ====
en: Connection information data
ja: 接続情報データ

note: type: Plain text
en: Shows the network family, the local address and port that is used to accept connections from the peer.
ja: ネットワークファミリ、ローカルアドレス、対向ノードから接続を許可されたポートを表示します。

note: type: Plain text
en: Shows the network family, the peer address and port that is used to connect.
ja: ネットワークファミリ、ローカルアドレス、接続に使用しているポートを表示します。

note: type: Plain text
en: This flag tells whether the TCP send buffer of the data connection is more than 80% filled.
ja: データのTCP送信バッファを80%より多く使用している場合にこのフラグがつきます。

note: type: Title ====
en: Performance indicators
ja: パフォーマンス指標

note: type: Plain text
en: indexterm:[performance indicators] The command ``drbdsetup status --verbose --statistics`` can be used to show performance statistics.  These are also available in ``drbdsetup events2 --statistics``, although there will not be a _changed_ event for every change.  The statistics include the following counters and gauges:
ja: indexterm:[performance indicators] コマンド `drbdsetup status --verbose --statistics`` を使用して、パフォーマンス統計を表示できます。これは ``drbdsetup events2 --statistics`` でも利用できますが、変更ごとに _changed_ イベントが発生するわけではありません。統計には、次のカウンターとゲージが含まれます。

note: type: Plain text
en: Per volume/device:
ja: ボリューム/デバイス単位:

note: type: Plain text
en: Net data read from local disk; in KiB.
ja: ローカルディスクから読み取られたネットデータ (kibyte単位)。

note: type: Plain text
en: Net data written to local disk; in KiB.
ja: ローカルのディスクに書き込んだ正味データ量(kibyte単位)。

note: type: Plain text
en: Number of updates of the activity log area of the meta data.
ja: メタデータのアクティビティログエリアのアップデート数。

note: type: Plain text
en: Number of updates of the bitmap area of the meta data.
ja: メタデータのビットマップエリアのアップデート数。

note: type: Plain text
en: Number of block I/O requests forwarded to DRBD, but not yet answered (completed)  by DRBD.
ja: まだDRBDから応答がない（完了していない）DRBDへのブロックI/Oリクエスト数。

note: type: Plain text
en: Number of open requests to the local I/O sub-system issued by DRBD.
ja: DRBDが発行したローカルI/Oサブシステムへのオープンリクエストの数。

note: type: Plain text
en: indexterm:[blocked]Shows local I/O congestion.
ja: indexterm:[blocked]ローカルI/Oの輻輳を示します。

note: type: Plain text
en: _no_: No congestion.
ja: _no_:輻輳なし

note: type: Plain text
en: _upper_: I/O _above_ the DRBD device is blocked, i.e. to the filesystem. Typical causes are
ja: _uppeer_: ファイルシステムなどDRBD _より上位_ のI/Oがブロックされている。代表的なものには以下がある。

note: type: Plain text
en: I/O suspension by the administrator, see the `suspend-io` command in `drbdadm`.
ja: 管理者によるI/O中断。 `drbdadm` コマンドの `suspend-io` を参照。

note: type: Plain text
en: transient blocks, e.g. during attach/detach
ja: アタッチ/デタッチ時の一時的なブロック。

note: type: Plain text
en: buffers depleted, see <<p-performance>>
ja: バッファーの枯渇。<<p-performance>> 参照。

note: type: Plain text
en: Waiting for bitmap IO
ja: ビットマップIO待ち

note: type: Plain text
en: _lower_: Backing device is congested.
ja: _lower_: 下位デバイスの輻輳

note: type: Plain text
en: _upper,lower_: Both _upper_ and _lower_ are blocked.
ja: 上位、下位両方がブロックされている。

note: type: Plain text
en: Per connection:
ja: 接続単位:

note: type: Plain text
en: Application data that is being written by the peer.  That is, DRBD has sent it to the peer and is waiting for the acknowledgement that it has been written.  In sectors (512 bytes).
ja: 対向ノードによって書き込まれているアプリケーションデータ。つまり、DRBD はそれを対向ノードに送信し、書き込まれたという確認応答を待っています。セクター単位（512バイト）。

note: type: Plain text
en: Resync data that is being written by the peer.  That is, DRBD is _SyncSource_, has sent data to the peer as part of a resync and is waiting for the acknowledgement that it has been written.  In sectors (512 bytes).
ja: 対向ノードによって書き込まれている同期データ。つまり、DRBD は _SyncSource_ が　同期データを対向ノードに送信し、データが書き込まれたことの確認応答を待っています。セクター単位（512バイト）。

note: type: Plain text
en: Per connection and volume ("peer device"):
ja: 接続とボリューム単位 ("peer device"):

note: type: Plain text
en: Net data received from the peer; in KiB.
ja: 対向ノードから受信したネットデータ（KiB単位）。

note: type: Plain text
en: Net data sent to the peer; in KiB.
ja: 対向ノードへ送信したネットデータ（KiB単位）。

note: type: Plain text
en: indexterm:[out-of-sync]indexterm:[oos]Amount of data currently out of sync with this peer, according to the bitmap that DRBD has for it; in KiB.
ja: indexterm:[out-of-sync]indexterm:[oos]DRBD のビットマップによる現在この対向ノードと同期していないデータ量（KiB単位）。

note: type: Plain text
en: Number of requests sent to the peer, but that have not yet been acknowledged by the peer.
ja: 対向ノードに送信されたが、対向ノードによってまだ確認されていないリクエスト数。

note: type: Plain text
en: Number of requests received from the peer, but that have not yet been acknowledged by DRBD on this node.
ja: 対向ノードから受信したが、このノードの DRBD によってまだ確認されていないリクエスト数。

note: type: Plain text
en: Whether the resynchronization is currently suspended or not. Possible values are _no_, _user_, _peer_, _dependency_.  Comma separated.
ja: 現在同期が中断されているかどうかを示す。値は _no_, _user_, _peer_, _dependency_ でカンマ区切り。

note: type: Title ===
en: Enabling and disabling resources
ja: リソースの有効化と無効化

note: type: Title ====
en: Enabling resources
ja: リソースの有効化

note: type: Plain text
en: indexterm:[resource]Normally, all configured DRBD resources are automatically enabled
ja: indexterm:[resource]通常、自動的にすべての設定済みDRBDリソースが有効になります。これは、

note: type: Plain text
en: by a cluster resource management application at its discretion, based on your cluster configuration, or
ja: クラスタ構成に応じたクラスタ管理アプリケーションの操作による、または

note: type: Plain text
en: by the systemd units (e.g., `drbd@.target`)
ja: systemd units (e.g., `drbd@.target`) による

note: type: Plain text
en: If, however, you need to enable resources manually for any reason, you may do so by issuing the command
ja: 手動でリソースを起動する必要がある場合には、以下のコマンドの実行によって行うことができます。

note: type: Plain text
en: As always, you may use the keyword `all` instead of a specific resource name if you want to enable all resources configured in `/etc/drbd.conf` at once.
ja: 他の場合と同様に、特定のリソース名の代わりにキーワード `all` を使用すれば、 `/etc/drbd.conf` で設定しているすべてのリソースを一度に有効にできます。

note: type: Title ====
en: Disabling resources
ja: リソースを無効にする

note: type: Plain text
en: indexterm:[resource]You may temporarily disable specific resources by issuing the command
ja: indexterm:[resource]特定のリソースを一時的に無効にするには、次のコマンドを実行します。

note: type: Plain text
en: Here, too, you may use the keyword `all` in place of a resource name if you wish to temporarily disable all resources listed in `/etc/drbd.conf` at once.
ja: ここでも、リソース名の代わりにキーワード `all` を使用して、1回で `/etc/drbd.conf` に記述しているすべてのリソースを一時的に無効にできます。

note: type: Title ===
en: Reconfiguring resources
ja: リソースの再設定

note: type: Plain text
en: indexterm:[resource]DRBD allows you to reconfigure resources while they are operational. To that end,
ja: indexterm:[resource]DRBDの動作中にリソースを再設定することができます。次の手順を行います。

note: type: Plain text
en: make any necessary changes to the resource configuration in `/etc/drbd.conf`,
ja: `/etc/drbd.conf` のリソース設定を変更します。

note: type: Plain text
en: synchronize your `/etc/drbd.conf` file between both nodes,
ja: 両方のノードで `/etc/drbd.conf` ファイルを同期します。

note: type: Plain text
en: issue the indexterm:[drbdadm, adjust]`drbdadm adjust <resource>` command on both nodes.
ja: indexterm:[drbdadm] `drbdadm adjust <resource>` コマンドを 両ノードで実行します。

note: type: Plain text
en: `drbdadm adjust` then hands off to `drbdsetup` to make the necessary adjustments to the configuration. As always, you are able to review the pending `drbdsetup` invocations by running `drbdadm` with the `-d` (dry-run) option.
ja: `drbdadm adjust` は `drbdsetup` を通じて実行中のリソースを調整します。保留中の `drbdsetup` 呼び出しを確認するには、 `drbdadm` を `-d` (dry-run,予行演習)オプションを付けて実行します。

note: type: Plain text
en: When making changes to the `common` section in `/etc/drbd.conf`, you can adjust the configuration for all resources in one run, by issuing `drbdadm adjust all`.
ja: `/etc/drbd.conf` の `common` セクションを変更して一度にすべてのリソースに反映させたいときには `drbdadm adjust all` を実行します。

note: type: Title ===
en: Promoting and demoting resources
ja: リソースの昇格と降格

note: type: Plain text
en: indexterm:[resource]Manually switching a <<s-resource-roles,resource's role>> from secondary to primary (promotion) or vice versa (demotion)  is done using one of the following commands:
ja: indexterm:[resource]手動で<<s-resource-roles,リソースロール>>をセカンダリからプライマリに切り替える(昇格)、またはその逆に切り替える(降格)には、次のコマンドを実行します。

note: type: Plain text
en: In <<s-single-primary-mode,single-primary mode>> (DRBD's default), any resource can be in the primary role on only one node at any given time while the <<s-connection-states,connection state>> is _Connected_. Thus, issuing `drbdadm primary <resource>` on one node while the specified resource is still in the primary role on another node will result in an error.
ja: DRBDが<<s-single-primary-mode,シングルプライマリモード>>(DRBDのデフォルト)で、<<s-connection-states,コネクションステータス>>が `Connected` の場合、任意のタイミングでどちらか1つのノード上でのみリソースはプライマリロールになれます。したがって、あるリソースが他のノードに対してプライマリロールになっているときに `drbdadm primary <resource>` を実行すると、エラーが発生します。

note: type: Plain text
en: A resource configured to allow <<s-dual-primary-mode,dual-primary mode>> can be switched to the primary role on two nodes; this is e.g. needed for online migration of virtual machines.
ja: リソースが<<s-dual-primary-mode,デュアルプライマリモード>>に対応するよう設定している場合には、両方のノードをプライマリロールに切り替えることができます。これは、例えば仮想マシンのオンラインマイグレーションの際に利用できます。

note: type: Title ===
en: Basic manual fail-over
ja: 基本的な手動フェイルオーバ

note: type: Plain text
en: If not using a cluster manager and looking to handle fail-overs manually in a passive/active configuration, the process is as follows.
ja: Pacemakerを使わず、パッシブ/アクティブ構成でフェイルオーバを手動で制御するには次のようにします。

note: type: Plain text
en: On the current primary node stop any applications or services using the DRBD device, unmount the DRBD device, and demote the resource to secondary.
ja: 現在のプライマリノードでDRBDデバイスを使用するすべてのアプリケーションとサービスを停止し、リソースをセカンダリに降格します。

note: type: Plain text
en: Now on the node we wish to make primary promote the resource and mount the device.
ja: プライマリにしたいノードでリソースを昇格してデバイスをマウントします。

note: type: Plain text
en: If you're using the `auto-promote` feature, you don't need to change the roles (_Primary_/_Secondary_) manually; only stopping of the services and unmounting, respectively mounting, is necessary.
ja: `自動プロモート` 機能を使用している場合はロール(`プライマリ`/`セカンダリ`)を手動で変更する必要はありません。それぞれサービス停止とアンマウント、マウントの操作のみ必要です。

note: type: Title ===
en: Using on-line device verification
ja: オンラインデバイス照合の使用

note: type: Title ====
en: Enabling on-line verification
ja: オンライン照合を有効にする

note: type: Plain text
en: indexterm:[on-line device verification]<<s-online-verify,On-line device verification>> for resources is not enabled by default. To enable it, add the following lines to your resource configuration in `/etc/drbd.conf`:
ja: indexterm:[on-line device verification]<<s-online-verify,オンラインデバイス照合>>はデフォルトでは有効になっていません。有効にするには `/etc/drbd.conf` のリソース設定に以下の行を追加します。

note: type: Plain text
en: _<algorithm>_ may be any message digest algorithm supported by the kernel crypto API in your system's kernel configuration. Normally, you should be able to choose at least from `sha1`, `md5`, and `crc32c`.
ja: _<algorithm>_ は、システムのカーネル構成内のカーネルcrypto APIでサポートされる任意のメッセージダイジェストアルゴリズムです。通常は `sha1` 、 `md5` 、 `crc32c` から選択します。

note: type: Plain text
en: If you make this change to an existing resource, as always, synchronize your `drbd.conf` to the peer, and run `drbdadm adjust _<resource>_` on both nodes.
ja: 既存のリソースに対してこの変更を行う場合は、 `drbd.conf` を対向ノードと同期し、両方のノードで `drbdadm adjust <resource>` を実行します。

note: type: Title ====
en: Invoking on-line verification
ja: オンライン照合の実行

note: type: Plain text
en: indexterm:[on-line device verification]After you have enabled on-line verification, you will be able to initiate a verification run using the following command:
ja: indexterm:[on-line device verification]オンライン照合を有効にしたら、次のコマンドでオンライン照合を開始します。

note: type: Plain text
en: When you do so, DRBD starts an online verification run for _<volume>_ to _<peer_> in _<resource>_, and if it detects any blocks that are not in sync, will mark those blocks as such and write a message to the kernel log. Any applications using the device at that time can continue to do so unimpeded, and you may also <<s-switch-resource-roles,switch resource roles>> at will.
ja: コマンドを実行すると、DRBD が _<peer_> の _<resource>_ の _<volume>_ に対してオンライン照合を実行します。同期していないブロックを検出した場合は、ブロックに非同期のマークを付け、カーネルログにメッセージを書き込みます。このときにデバイスを使用しているアプリケーションは中断なく動作し続けます。また、<<s-switch-resource-roles,リソースロールの切り替え>>も行うことができます。

note: type: Plain text
en: _<Volume>_ is optional, if ommited, it will verify all volumes in that resource.
ja: _<Volume>_ はオプションで、省略した場合、そのリソース内のすべてのボリュームを照合します。

note: type: Plain text
en: If out-of-sync blocks were detected during the verification run, you may resynchronize them using the following commands after verification has completed.
ja: 照合中に同期していないブロックが検出された場合は、照合の完了後に、次のコマンド使用して再同期できます。

note: type: Plain text
en: Since drbd-9.0.29 the preferred way is one of these commands:
ja: drbd-9.0.29 以降、推奨される方法は次のいずれかのコマンドです。

note: type: Plain text
en: The first command will cause the local differences to be overwritten by the remote version. The second command does it in the opposite direction.
ja: 最初のコマンドは、リモートバージョンによってローカルの違いが上書きされます。 2 番目のコマンドは反対方向にそれを行います。

note: type: Plain text
en: Before drbd-9.0.29 one needs to initiate a resync. A way to do that is disconnecting from a primary and ensuring that the primary changes at least one block while the peer is away.
ja: drbd-9.0.29 より前のバージョンでは、再同期を開始する必要があります。これを行う方法は、対向ノードをプライマリから切断し、切断している間にプライマリが少なくとも1 つのブロックを変更するようにすることです。

note: type: Title ====
en: Automating on-line verification
ja: 自動オンライン照合

note: type: Plain text
en: indexterm:[on-line device verification]Most users will want to automate on-line device verification. This can be easily accomplished. Create a file with the following contents, named `/etc/cron.d/drbd-verify` on *one* of your nodes:
ja: indexterm:[on-line device verification]通常は、オンラインデバイス照合を自動的に実行するほうが便利です。自動化は簡単です。*一方* のノードに `/etc/cron.d/drbd-verify` という名前で、次のような内容のファイルを作成します。

note: type: Plain text
en: This will have `cron` invoke a device verification every Sunday at 42 minutes past midnight; so, if you come into the office on Monday morning, a quick look at the resource's status would show the result. If your devices are very big, and the \~32 hours were not enough, then you'll notice _VerifyS_ or _VerifyT_ as connection state, meaning that the `verify` is still in progress.
ja: これにより、毎週日曜日の午前0時42分に、 `cron` がデバイス照合を呼び出します。そのため、月曜の朝にリソース状態をチェックして結果を確認することができます。デバイスが大きくて32時間では足りなかった場合、 コネクションステータスが `VerifyS` または `VerifyT` になっています。これは `verify` がまだ動作中であることを意味しています。

note: type: Plain text
en: If you have enabled on-line verification for all your resources (for example, by adding `verify-alg _<algorithm>_` to the `common` section in `/etc/drbd.d/global_common.conf`), you may also use:
ja: オンライン照合をすべてのリソースで有効にした場合（例えば `/etc/drbd.d/global_common.conf` の `common` セクションに `verify-alg <アルゴリズム>` を追加するなど)には、以下のようにします。

note: type: Title ===
en: Configuring the rate of synchronization
ja: 同期速度の設定

note: type: Plain text
en: indexterm:[synchronization]Normally, one tries to ensure that background synchronization (which makes the data on the synchronization target temporarily inconsistent) completes as quickly as possible. However, it is also necessary to keep background synchronization from hogging all bandwidth otherwise available for foreground replication, which would be detrimental to application performance. Thus, you must configure the synchronization bandwidth to match your hardware -- which you may do in a permanent fashion or on-the-fly.
ja: indexterm:[synchronization]バックグラウンド同期中は同期先のデータとの一貫性が一時的に失われるため、同期はできるだけ短時間で完了させるべきです。ただし、すべての帯域幅がバックグラウンド同期に占有されてしまうと、フォアグラウンドレプリケーションに使用できなくなり、アプリケーションのパフォーマンス低下につながります。これは避ける必要があります。同期用の帯域幅はハードウェアに合わせて設定する必要があります。

note: type: Plain text
en: It does not make sense to set a synchronization rate that is higher than the maximum write throughput on your secondary node. You must not expect your secondary node to miraculously be able to write faster than its I/O subsystem allows, just because it happens to be the target of an ongoing device synchronization.
ja: 同期速度をセカンダリノードの最大書き込みスループットを上回る速度に設定しても意味がありません。デバイス同期の速度をどれほど高速に設定しても、セカンダリノードがそのI/Oサブシステムの能力より高速に書き込みを行うことは不可能です。

note: type: Plain text
en: Likewise, and for the same reasons, it does not make sense to set a synchronization rate that is higher than the bandwidth available on the replication network.
ja: また、同じ理由で、同期速度をレプリケーションネットワークの帯域幅の能力を上回る速度に設定しても意味がありません。

note: type: Title ====
en: Estimating a synchronization speed
ja: 同期速度の計算

note: type: Plain text
en: A good rule of thumb for this value is to use about 30% of the available replication bandwidth. Thus, if you had an I/O subsystem capable of sustaining write throughput of 400MB/s, and a Gigabit Ethernet network capable of sustaining 110 MB/s network throughput (the network being the bottleneck), you would calculate:
ja: 概算としては使用可能なレプリケーション帯域幅の30%程度を想定するのがよいでしょう。400MB/sの書き込みスループットを維持できるI/Oサブシステム、および110MB/sのネットワークスループットを維持できるギガビットイーサネットネットワークの場合は、ネットワークがボトルネックになります。速度は次のように計算できます。

note: type: Block title
en: Syncer rate example, 110MB/s effective available bandwidth
ja: syncer 速度の例(有効帯域幅が110MB/sの場合)

note: type: Plain text
en: Thus, the recommended value for the `rate` option would be `33M`.
ja: この結果、 `resynce-rate` オプションの推奨値は `33M` になります。

note: type: Plain text
en: By contrast, if you had an I/O subsystem with a maximum throughput of 80MB/s and a Gigabit Ethernet connection (the I/O subsystem being the bottleneck), you would calculate:
ja: 一方、最大スループットが80MB/sのI/Oサブシステム、およびギガビットイーサネット接続を使用する場合は、I/Oサブシステムが律速要因になります。速度は次のように計算できます。

note: type: Block title
en: Syncer rate example, 80MB/s effective available bandwidth
ja: syncer 速度の例(有効帯域幅が80MB/sの場合)

note: type: Plain text
en: In this case, the recommended value for the `rate` option would be `24M`.
ja: この場合、 `resync-rate` オプションの推奨値は `24M` です。

note: type: Plain text
en: Similarly, for a storage speed of 800MB/s and a 10Gbe network connection, you would shoot for \~240MB/s synchronization rate.
ja: 同じようにして800MB/sのストレージ速度で10Gbeのネットワークコネクションであれば、〜240MB/sの同期速度が得られます。

note: type: Title ====
en: Variable sync rate configuration
ja: 可変同期速度設定

note: type: Plain text
en: When multiple DRBD resources share a single replication/synchronization network, synchronization with a fixed rate may not be an optimal approach. So, in DRBD 8.4.0 the variable-rate synchronization was enabled by default. In this mode, DRBD uses an automated control loop algorithm to determine, and adjust, the synchronization rate. This algorithm ensures that there is always sufficient bandwidth available for foreground replication, greatly mitigating the impact that background synchronization has on foreground I/O.
ja: 複数のDRBDリソースが1つのレプリケーション/同期ネットワークを共有する場合、同期が固定レートであることは最適なアプローチではありません。そのためDRBD 8.4.0から可変同期速度がデフォルトで有効になっています。このモードではDRBDが自動制御のループアルゴリズムで同期速度を決定して調整を行います。このアルゴリズムはフォアグラウンド同期に常に十分な帯域幅を確保し、バックグラウンド同期がフォアグラウンドのI/Oに与える影響を少なくします。

note: type: Plain text
en: The optimal configuration for variable-rate synchronization may vary greatly depending on the available network bandwidth, application I/O pattern and link congestion.
ja: 最適な可変同期速度の設定は、使用できるネットワーク帯域幅、アプリケーションのI/Oパターンやリンクの輻輳によって変わります。

note: type: Plain text
en: Ideal configuration settings also depend on whether <<s-drbd-proxy,DRBD Proxy>> is in use or not.  It may be wise to engage professional consultancy in order to optimally configure this DRBD feature. An _example_ configuration (which assumes a deployment in conjunction with DRBD Proxy) is provided below:
ja: <<s-drbd-proxy,DRBD Proxy>> の有無によっても適切な設定は異なります。DRBDの機能を最適化するためにコンサルタントを利用するのもよいでしょう。以下は(DRBD Proxy使用を想定した環境での)設定の _一例_ です。

note: type: Plain text
en: A good starting value for `c-fill-target` is _BDP * 2_, where _BDP_ is your bandwidth-delay-product on the replication link.
ja: `c-fill-target` の初期値は _BDP✕2_ がよいでしょう。 _BDP_ とはレプリケーションリンク上の帯域幅遅延積(Bandwidth Delay Product)です。

note: type: Plain text
en: For example, when using a 1GBit/s crossover connection, you'll end up with about 200µs latencyfootnote:[The rule-of-thumb is using the time reported by `ping`.]. + 1GBit/s means about 120MB/s; times 200*10^-6^ seconds gives 24000 Byte. Just round that value up to the next MB, and you're good to go.
ja: 例えば、1GBit/sの接続の場合、200µsのレイテンシになります。footnote:[概算は `ping` の結果を使用しています]1GBit/sは約120MB/sです。120掛ける200*10^-6^秒は24000Byteです。この値はMB単位まで丸めてもよいでしょう。

note: type: Plain text
en: Another example: a 100MBit WAN connection with 200ms latency means 12MB/s times 0.2s, or about 2.5MB "on the wire". Here a good starting value for `c-fill-target` would be 3MB.
ja: 別の例をあげると、100MBitのWAN接続で200msのレイテンシなら12MB/s掛ける0.2sです。2.5MBくらいになります。`c-fill-target` の初期値は3MBがよいでしょう。

note: type: Plain text
en: Please see the `drbd.conf` manual page for more details on the other configuration items.
ja: 他の設定項目については `drbd.conf` のマニュアルページを参照してください。

note: type: Title ====
en: Permanent fixed sync rate configuration
ja: 永続的な固定同期速度の設定

note: type: Plain text
en: In a few, very restricted situationsfootnote:[Like benchmarking.], it might make sense to just use some fixed synchronization rate. In this case, first of all you need to turn the dynamic sync rate controller off, by using `c-plan-ahead 0;`.
ja: ごく限られた状況footnote:[ベンチマークなど]では、固定同期速度を使うことがあるでしょう。この場合には、まず `c-plan-ahead 0;` にして可変同期速度調節の機能をオフにします。

note: type: Plain text
en: Then, the maximum bandwidth a resource uses for background re-synchronization is determined by the `resync-rate` option for a resource. This must be included in the resource's `disk` section in `/etc/drbd.conf`:
ja: そして、リソースがバックグラウンド再同期に使用する最大帯域幅をリソースの `resync-rate` オプションによって決定します。この設定はリソースの `/etc/drbd.conf` の `disk` セクションに記載します。

note: type: Plain text
en: Note that the rate setting is given in _bytes_, not _bits_ per second; the default unit is _Kibibyte_, so a value of `4096` would be interpreted as `4MiB`.
ja: 同期速度の設定は1秒あたりの _バイト_ 単位であり _ビット_ 単位でない点に注意してください。デフォルトの単位は _kibibyte_ で、 `4096` であれば `4MiB` となります。

note: type: Plain text
en: This just defines a rate that DRBD tries to achieve. If there is a bottleneck with lower throughput (network, storage speed), the defined speed (aka the "wished-for" performance ;) won't be reached.
ja: これはあくまでDRBDが行おうとする速度にすぎません。低スループットのボトルネック(ネットワークやストレージの速度)がある場合、設定した速度(いわゆる"理想値")には達しません。

note: type: Title ====
en: Some more hints about synchronization
ja: 同期に関するヒント

note: type: Plain text
en: When some amount of the to-be-synchronized data isn't really in use anymore (e.g. because files got deleted while one node wasn't connected), you might benefit from the <<s-trim-discard>>.
ja: 同期すべきデータ領域の一部が不要になった場合、例えば、対向ノードとの接続が切れている時にデータを削除した場合などには<<s-trim-discard>>の有効性が感じられるかもしれません。

note: type: Plain text
en: Furthermore, `c-min-rate` is easy to misunderstand - it doesn't define a *minimum* synchronization speed, but rather a limit below which DRBD will not slow down further *on purpose*. + Whether you manage to *reach* that synchronization rate depends on your network and storage speed, network latency (which might be highly variable for shared links), and application IO (which not might be able to do anything about).
ja: `c-min-rate` は間違われやすいです。これは同期速度の *最低値* ではなくて、この速度以上の速度低下を *意図的に* 行わないという制限です。ネットワークとストレージの速度、ネットワーク遅延(これは回線共有による影響が大きいでしょう)、アプリケーションIO（関与することは難しいかもしれません）に応じた同期速度の管理まで *手が及ぶか* どうかによります。

note: type: Title ===
en: Configuring checksum-based synchronization
ja: チェックサムベース同期の設定

note: type: Plain text
en: indexterm:[checksum-based synchronization]<<p-checksum-sync,Checksum-based synchronization>> is not enabled for resources by default. To enable it, add the following lines to your resource configuration in `/etc/drbd.conf`:
ja: indexterm:[checksum-based synchronization]<<p-checksum-sync, チェックサムベース同期>>はデフォルトでは有効になっていません。有効にするには、 `/etc/drbd.conf` のリソース構成に次の行を追加します。

note: type: Title ===
en: Configuring congestion policies and suspended replication
ja: 輻輳ポリシーと中断したレプリケーションの構成

note: type: Plain text
en: In an environment where the replication bandwidth is highly variable (as would be typical in WAN replication setups), the replication link may occasionally become congested. In a default configuration, this would cause I/O on the primary node to block, which is sometimes undesirable.
ja: レプリケーション帯域幅が大きく変動する環境(WANレプリケーション設定で典型的)の場合、レプリケーションリンクは時に輻輳します。デフォルト設定では、プライマリノードのI/Oのブロックを引き起こし、望ましくない場合があります。

note: type: Plain text
en: Instead, you may configure DRBD to _suspend_ the ongoing replication in this case, causing the Primary's data set to _pull ahead_ of the Secondary. In this mode, DRBD keeps the replication channel open -- it never switches to disconnected mode -- but does not actually replicate until sufficient bandwidth becomes available again.
ja: その代わりに、進行中の同期を suspend (中断)に設定し、プライマリのデータセットをセカンダリから _pull ahead_ (引き離す)にします。このモードではDRBDはレプリケーションチャネルを開いたままにし、切断モードにはしません。しかし十分な帯域幅が利用できるようになるまで実際にはレプリケートを行いません。

note: type: Plain text
en: The following example is for a DRBD Proxy configuration:
ja: 次の例は、DRBD Proxy構成のためのものです。

note: type: Plain text
en: It is usually wise to set both `congestion-fill` and `congestion-extents` together with the `pull-ahead` option.
ja: 通常は `congestion-fill` と `congestion-extents` を `pull-ahead` オプションと合わせて設定するのがよい方法でしょう。

note: type: Plain text
en: A good value for `congestion-fill` is 90%
ja: `congestion-fill` の値は以下の値の90%にするとよいでしょう。

note: type: Plain text
en: of the allocated DRBD proxy buffer memory, when replicating over DRBD Proxy, or
ja: DRBD Proxy越しの同期の場合のDRBD Proxyのバッファメモリの割り当て、 または

note: type: Plain text
en: of the TCP network send buffer, in non-DRBD Proxy setups.
ja: DRBD Proxy構成でない環境でのTCPネットワークの送信バッファ

note: type: Plain text
en: A good value for `congestion-extents` is 90% of your configured `al-extents` for the affected resources.
ja: `congestion-extents` の値は、影響するリソースの `al-extents` に設定した値の90%がよいでしょう。

note: type: Title ===
en: Configuring I/O error handling strategies
ja: I/Oエラー処理方針の設定

note: type: Plain text
en: indexterm:[I/O errors]indexterm:[drbd.conf]DRBD's <<s-handling-disk-errors,strategy for handling lower-level I/O errors>> is determined by the `on-io-error` option, included in the resource `disk` configuration in `/etc/drbd.conf`:
ja: indexterm:[I/O errors]indexterm:[drbd.conf]DRBDが <<s-handling-disk-errors,下位レベルI/Oエラーを処理する際の方針>>は、リソースの `/etc/drbd.conf` の `disk` セクションの `on-io-error` で指定します。

note: type: Plain text
en: You may, of course, set this in the `common` section too, if you want to define a global I/O error handling policy for all resources.
ja: すべてのリソースのグローバルI/Oエラー処理方針を定義したい場合は、これを `common` セクションで設定します。

note: type: Plain text
en: _<strategy>_ may be one of the following options:
ja: _<strategy>_ は以下のいずれかを指定します。

note: type: Plain text
en: This is the default and recommended option. On the occurrence of a lower-level I/O error, the node drops its backing device, and continues in diskless mode.
ja: これがデフォルトで、推奨オプションです。下位レベルI/Oエラーが発生すると、DRBDはそのノードの下位デバイスを切り離し、ディスクレスモードで動作を継続します。

note: type: Plain text
en: This causes DRBD to report the I/O error to the upper layers. On the primary node, it is reported to the mounted file system. On the secondary node, it is ignored (because the secondary has no upper layer to report to).
ja: 上位層にI/Oエラーを通知します。プライマリノードの場合は、マウントされたファイルシステムに通知されます。セカンダリノードの場合は無視されます(セカンダリノードには通知すべき上位層がないため)。

note: type: Plain text
en: Invokes the command defined as the local I/O error handler. This requires that a corresponding `local-io-error` command invocation is defined in the resource's `handlers` section. It is entirely left to the administrator's discretion to implement I/O error handling using the command (or script) invoked by `local-io-error`.
ja: ローカルI/Oエラーハンドラとして定義されたコマンドを呼び出します。このオプションを使うには、対応する `local-io-error` ハンドラをリソースの `handlers` セクションに定義する必要があります。`local-io-error` で呼び出されるコマンド(またはスクリプト)にI/Oエラー処理を実装するかどうかは管理者の判断です。

note: type: Plain text
en: Early DRBD versions (prior to 8.0) included another option, `panic`, which would forcibly remove the node from the cluster by way of a kernel panic, whenever a local I/O error occurred. While that option is no longer available, the same behavior may be mimicked via the `local-io-error`/`call-local-io-error` interface. You should do so only if you fully understand the implications of such behavior.
ja: DRBDの以前のバージョン(8.0以前)にはもう1つのオプション panic があり、これを使用すると、ローカルI/Oエラーが発生するたびにカーネルパニックによりノードがクラスタから強制的に削除されました。このオプションは現在は使用できませんが、 `local-io-error` / `call-local-io-error` インタフェースを使用すると同じような動作を実現します。ただし、この動作の意味を十分理解した上で使用してください。

note: type: Plain text
en: You may reconfigure a running resource's I/O error handling strategy by following this process:
ja: 次のコマンドで、実行中のリソースのI/Oエラー処理方針を再構成することができます。

note: type: Plain text
en: Edit the resource configuration in `/etc/drbd.d/__<resource>__.res`.
ja: `/etc/drbd.d/<resource>.res` のリソース構成の編集

note: type: Plain text
en: Copy the configuration to the peer node.
ja: 構成の対向ノードへのコピー

note: type: Plain text
en: Issue `drbdadm adjust _<resource>_` on both nodes.
ja: 両ノードでの `drbdadm adjust <resource>` の実行

note: type: Title ===
en: Configuring replication traffic integrity checking
ja: レプリケーショントラフィックの整合性チェックを設定

note: type: Plain text
en: indexterm:[replication traffic integrity checking]<<s-integrity-check,Replication traffic integrity checking>> is not enabled for resources by default. To enable it, add the following lines to your resource configuration in `/etc/drbd.conf`:
ja: indexterm:[replication traffic integrity checking]<<s-integrity-check,レプリケーショントラフィックの整合性チェック>> はデフォルトでは有効になっていません。有効にする場合は、 `/etc/drbd.conf` のリソース構成に次の行を追加します。

note: type: Plain text
en: This feature is not intended for production use. Enable only if you need to diagnose data corruption problems, and want to see whether the transport path (network hardware, drivers, switches) might be at fault!
ja: この機能は本番環境での使用は想定していません。データ破壊の問題や、通信経路(ネットワークハードウェア、ドライバ、スイッチ)に障害があるかどうかを診断する場合にのみ使用してください。

note: type: Title ===
en: Resizing resources
ja: リソースのサイズ変更

note: type: Plain text
en: When growing (extending) DRBD volumes, you need to grow from bottom to top.  You need to extend the backing block devices on all nodes first.  Then you can tell DRBD to use the new space.
ja: DRBD ボリュームを拡張する場合は、下から上に拡張する必要があります。最初に、すべてのノードで下位ブロックデバイスを拡張する必要があります。次に、DRBD に新しいスペースを使用するように指示します。

note: type: Plain text
en: Once the DRBD volume is extended, you need to still propagate that into whatever is using DRBD: extend the file system, or make a VM running with this volume attached aware of the new "disk size".
ja: DRBD ボリュームが拡張された後、DRBD を使用しているものにそれを伝える必要があります。ファイルシステムを拡張する、あるいはこのボリュームが接続された状態で実行されている VM に新しい「ディスクサイズ」を認識させます。

note: type: Plain text
en: That all typically boils down to
ja: これは通常、次のようになります。

note: type: Plain text
en: See also the next sections <<s-growing-online>> and following.
ja: 次のセクション <<s-growing-online>> も参照ください。

note: type: Plain text
en: Note that different file systems have different capabilities and different sets of management tools. For example XFS can only grow.  You point its tool to the active mount point: `xfs_growfs /where/you/have/it/mounted`.
ja: ファイルシステムが異なれば、機能や管理ツールのセットも異なることに注意してください。例えば、XFS は拡張しかできません。また、引数にアクティブなマウントポイントを指定します: `xfs_growfs /where/you/have/it/mounted`

note: type: Plain text
en: While the EXT family can both grow (even online), and also shrink (only offline; you have to unmount it first). To resize an ext3 or ext4, you would point the tool not to the mount point, but to the (mounted)  block device: `resize2fs /dev/drbd#`
ja: EXT ファミリは、拡張（オンラインでも）と縮小（オフラインのみ。最初にマウントを解除する必要があります）の両方が可能です。 ext3 または ext4 のサイズを変更するには、引数にマウントポイントではなく、（マウントされた）ブロックデバイスを指定します: `resize2fs /dev/drbd#`

note: type: Plain text
en: Obviously use the correct DRBD (as displayed by `mount` or `df -T`, while mounted), and *not* the backing block device.  As long as DRBD is up, that's not supposed to work anyways (`resize2fs: Device or resource busy while trying to open /dev/mapper/VG-LV Couldn't find valid filesystem superblock.`).  If you tried to do that offline (with DRBD stopped), you may corrupt DRBD meta data if you ran the file system tools directly against the backing LV or partition.  So don't.
ja: デバイスには DRBD デバイス（マウント中に `mount` または `df -T` で表示される）を使用し、下位ブロックデバイスは使用しないでください。 DRBD が起動している限り、それは機能しないはずです（ resize2fs ではオープンしにようとするとデバイスまたはリソースがビジーで、有効なファイルシステムのスーパーブロックが見つかりません）。しかし、オフラインで（DRBDを停止して）実行した場合、ファイルシステムツールを下位 LV またはパーティションに対して直接実行すると、DRBD メタデータが破壊する可能性があります。よって決して実行しないでください。

note: type: Plain text
en: You do the file system resize only *once* on the Primary, against the active DRBD device.  DRBD replicates the changes to the file system structure.  That is what you have it for.
ja: ファイルシステムのサイズ変更は、アクティブな DRBD デバイスに対して、プライマリで１回のみ行います。DRBD はファイルシステム構造への変更を複製します。

note: type: Plain text
en: Also, don't use resize2fs on XFS volumes, or XFS tools on EXT, or ...  but the right tool for the file system in use.
ja: また、XFS ボリュームで resize2fs を使用したり、EXT で XFS ツールを使用したりしないでください。使用中のファイルシステムに適したツールを使用してください。

note: type: Plain text
en: `resize2fs: Bad magic number in super-block while trying to open /dev/drbd7` is probably just trying to tell you that this is *not* an EXT file system, and you should try an other tool instead. Maybe `xfs_growfs`? But as mentioned, that does not take the block device, but the mount point as argument.
ja: resize2fs で /dev/drbd7 をオープンしたとき、スーパーブロックの不正なマジックナンバーは、これが EXT ファイルシステムではないことを伝えているので、代わりに他のツールを試す必要があります。例えば `xfs_growfs` です。ブロックデバイスではなく、マウントポイントを引数として取ることに注意してください。

note: type: Plain text
en: When shrinking (reducing) DRBD volumes, you need to shrink from top to bottom.  So first make sure no one is using the space you want to cut off.  Next, shrink the file system (if your file system supports that).  Then tell DRBD to stop using that space, which is not so easy with DRBD internal meta data, because they are by design "at the end" of the backing device.
ja: DRBD ボリュームを縮小する場合は、上から下に縮小する必要があります。したがって、最初に、切り取りたいスペースを誰も使用していないことを確認してください。次に、ファイルシステムを縮小します（ファイルシステムがサポートしている場合）。次に、DRBD にそのスペースの使用を停止するように指示します。DRBD 内部メタデータは下位デバイスの最後にあるので、それほど簡単ではありません。

note: type: Plain text
en: Once you are sure that DRBD won't use the space anymore either, you can cut it off from the backing device, for example using `lvreduce`.
ja: DRBD がスペースを使用しないことが確実になったら、たとえば `lvreduce` を使用して、下位デバイスからスペースを切り離すことができます。

note: type: Plain text
en: See also <<s-shrinking-online>>, <<s-shrinking-offline>>.
ja: <<s-shrinking-online>>, <<s-shrinking-offline>> も参照ください。

note: type: Title ====
en: Growing on-line
ja: オンライン拡張

note: type: Plain text
en: indexterm:[resource]If the backing block devices can be grown while in operation (online), it is also possible to increase the size of a DRBD device based on these devices during operation. To do so, two criteria must be fulfilled:
ja: indexterm:[resource]動作中(オンライン)に下位ブロックデバイスを拡張できる場合は、これらのデバイスをベースとするDRBDデバイスについても動作中にサイズを拡張することができます。その際に、次の2つの条件を満たす必要があります。

note: type: Plain text
en: The affected resource's backing device must be one managed by a logical volume management subsystem, such as LVM.
ja: 影響を受けるリソースの下位デバイスが、 LVMやEVMSなどの論理ボリューム管理サブシステムによって管理されている。

note: type: Plain text
en: The resource must currently be in the _Connected_ connection state.
ja: 現在、リソースのコネクションステータスが `Connected` になっている。

note: type: Plain text
en: Having grown the backing block devices on all nodes, ensure that only one node is in primary state. Then enter on one node:
ja: 両方のノードの下位ブロックデバイスを拡張したら、一方のノードだけがプライマリ状態であることを確認してください。プライマリノードで次のように入力します。

note: type: Plain text
en: This triggers a synchronization of the new section. The synchronization is done from the primary node to the secondary node.
ja: 新しいセクションの同期がトリガーされます。同期はプライマリノードからセカンダリノードへ実行されます。

note: type: Plain text
en: If the space you're adding is clean, you can skip syncing the additional space by using the --assume-clean option.
ja: 追加する領域がクリーンな場合には、追加領域の同期を--assume-cleanオプションでスキップできます。

note: type: Title ====
en: Growing off-line
ja: オフライン拡張する

note: type: Plain text
en: indexterm:[resource]When the backing block devices on both nodes are grown while DRBD is inactive, and the DRBD resource is using <<s-external-meta-data,external meta data>>, then the new size is recognized automatically. No administrative intervention is necessary. The DRBD device will have the new size after the next activation of DRBD on both nodes and a successful establishment of a network connection.
ja: indexterm:[resource]<<s-external-meta-data,外部メタデータ>>を使っている場合、DRBD停止中に両ノードの下位ブロックデバイスを拡張すると、新しいサイズが自動的に認識されます。管理者による作業は必要ありません。両方のノードで次にDRBDを起動した際に、DRBDデバイスのサイズが新しいサイズになり、ネットワーク接続が正常に確立します。

note: type: Plain text
en: If however the DRBD resource is configured to use <<s-internal-meta-data,internal meta data>>, then this meta data must be moved to the end of the grown device before the new size becomes available. To do so, complete the following steps:
ja: DRBDリソースで<<s-internal-meta-data,内部メタデータ>>を使用している場合は、リソースのサイズを変更する前に、メタデータを拡張されるデバイス領域の後ろの方に移動させる必要があります。これを行うには次の手順を実行します。

note: type: Plain text
en: This is an advanced procedure. Use at your own discretion.
ja: これは高度な手順です。慎重に検討した上で実行してください。

note: type: Plain text
en: Unconfigure your DRBD resource:
ja: DRBDリソースを停止します。

note: type: Plain text
en: Save the meta data in a text file prior to resizing:
ja: 縮小する前に、メタデータをテキストファイルに保存します。

note: type: Plain text
en: You must do this on both nodes, using a separate dump file for every node. *Do not* dump the meta data on one node, and simply copy the dump file to the peer. *This. will. not. work.*
ja: 各ノードごとにそれぞれのダンプファイルを作成する必要があります。この手順は、両方のノードでそれぞれ実行します。一方のノードのメタデータのダンプを対向ノードに *コピーしないでください* 。 DRBDは *動作しなくなります* 。

note: type: Plain text
en: Grow the backing block device on both nodes.
ja: 両方のノードの下位ブロックデバイスを拡大します。

note: type: Plain text
en: Adjust the size information (`la-size-sect`) in the file `/tmp/metadata` accordingly, on both nodes. Remember that `la-size-sect` must be specified in sectors.
ja: `/tmp/metadata` ファイルのサイズ情報( `la-size-sect` )を書き換えます。`la-size-sect` は、必ずセクタ単位で指定する必要があります。

note: type: Plain text
en: Re-initialize the metadata area:
ja: メタデータ領域の再初期化をします。

note: type: Plain text
en: Re-import the corrected meta data, on both nodes:
ja: 両ノードで修正したメタデータをインポートします。

note: type: Plain text
en: This example uses `bash` parameter substitution. It may or may not work in other shells. Check your `SHELL` environment variable if you are unsure which shell you are currently using.
ja: この例では `bash` パラメータ置換を使用しています。他のシェルの場合、機能する場合もしない場合もあります。現在使用しているシェルが分からない場合は、 `SHELL` 環境変数を確認してください。

note: type: Plain text
en: Re-enable your DRBD resource:
ja: 再度DRBDリソースを起動します。

note: type: Plain text
en: On one node, promote the DRBD resource:
ja: 一方のノードでDRBDリソースを昇格します。

note: type: Plain text
en: Finally, grow the file system so it fills the extended size of the DRBD device.
ja: 最後に、拡張したDRBDデバイスを活用するために、ファイルシステムを拡張します。

note: type: Title ====
en: Shrinking on-line
ja: オンライン縮小

note: type: Plain text
en: Online shrinking is only supported with external metadata.
ja: 警告 : オンラインでの縮小は外部メタデータ使用の場合のみサポートしています。

note: type: Plain text
en: indexterm:[resource]Before shrinking a DRBD device, you _must_ shrink the layers above DRBD, i.e. usually the file system. Since DRBD cannot ask the file system how much space it actually uses, you have to be careful in order not to cause data loss.
ja: indexterm:[resource]DRBDデバイスを縮小する前に、DRBDの上位層(通常はファイルシステム)を縮小 _しなければいけません_ 。ファイルシステムが実際に使用している容量を、DRBDが知ることはできないため、データが失われないように注意する必要があります。

note: type: Plain text
en: Whether or not the _filesystem_ can be shrunk on-line depends on the filesystem being used. Most filesystems do not support on-line shrinking. XFS does not support shrinking at all.
ja: ファイルシステムをオンラインで縮小できるかどうかは、使用しているファイルシステムによって異なります。ほとんどのファイルシステムはオンラインでの縮小をサポートしません。XFSは縮小そのものをサポートしません。

note: type: Plain text
en: To shrink DRBD on-line, issue the following command _after_ you have shrunk the file system residing on top of it:
ja: オンラインでDRBDを縮小するには、その上位に常駐するファイルシステムを縮小した_後に_、次のコマンドを実行します。

note: type: Plain text
en: You may use the usual multiplier suffixes for _<new-size>_ (K, M, G etc.). After you have shrunk DRBD, you may also shrink the containing block device (if it supports shrinking).
ja: _<new-size>_ には通常の乗数サフィックス(K、M、Gなど)を使用できます。DRBDを縮小したら、DRBDに含まれるブロックデバイスも縮小できます(デバイスが縮小をサポートする場合)。

note: type: Plain text
en: It might be a good idea to issue `drbdadm resize _<resource>_` after resizing the lower level device, so that the DRBD metadata *really* gets written into the expected space at the end of the volume.
ja: DRBDのメタデータがボリュームの想定される箇所に *実際に* 書き込まれるように下位デバイスのリサイズ後に `drbdadm resize <resource>` を実行してもよいでしょう。

note: type: Title ====
en: Shrinking off-line
ja: オフライン縮小

note: type: Plain text
en: indexterm:[resource]If you were to shrink a backing block device while DRBD is inactive, DRBD would refuse to attach to this block device during the next attach attempt, since it is now too small (in case external meta data is used), or it would be unable to find its meta data (in case internal meta data is used). To work around these issues, use this procedure (if you cannot use <<s-shrinking-online,on-line shrinking>>):
ja: indexterm:[resource]DRBDが停止しているときに下位ブロックデバイスを縮小すると、次にそのブロックデバイスを接続しようとしてもDRBDが拒否します。これは、ブロックデバイスが小さすぎる(外部メタデータを使用する場合)、またはメタデータを見つけられない(内部メタデータを使用する場合)ことが原因です。この問題を回避するには、次の手順を行います (<<s-shrinking-online,オンライン縮小>>を使用出来ない場合)。

note: type: Plain text
en: Shrink the file system from one node, while DRBD is still configured.
ja: DRBDがまだ動作している状態で、一方のノードのファイルシステムを縮小します。

note: type: Plain text
en: Save the meta data in a text file prior to shrinking:
ja: 縮小する前に、メタデータをテキストファイルに保存します。

note: type: Plain text
en: Shrink the backing block device on both nodes.
ja: 両方のノードの下位ブロックデバイスを縮小します。

note: type: Plain text
en: *Only if you are using internal metadata* (which at this time have
    probably been lost due to the shrinking process), re-initialize the
    metadata area:
ja: *内部メタデータを使用している場合は、メタデータ領域を再初期化します(この時点では、縮小によりおそらく内部メタデータが失われています)。

note: type: Title ===
en: Disabling backing device flushes
ja: 下位デバイスのフラッシュを無効にする

note: type: Plain text
en: You should only disable device flushes when running DRBD on devices with a battery-backed write cache (BBWC). Most storage controllers allow to automatically disable the write cache when the battery is depleted, switching to write-through mode when the battery dies. It is strongly recommended to enable such a feature.
ja: バッテリバックアップ書き込みキャッシュ(BBWC)を備えたデバイスでDRBDを実行している場合にのみ、デバイスのフラッシュを無効にできます。ほとんどのストレージコントローラは、バッテリが消耗すると書き込みキャッシュを自動的に無効にし、バッテリが完全になくなると即時書き込み(ライトスルー)モードに切り替える機能を備えています。このような機能を有効にすることを強くお勧めします。

note: type: Plain text
en: Disabling DRBD's flushes when running without BBWC, or on BBWC with a depleted battery, is _likely to cause data loss_ and should not be attempted.
ja: BBWC機能を使用していない、またはバッテリが消耗した状態でBBWCを使用しているときに、DRBDのフラッシュを無効にすると、 _データが失われるおそれがあります_ したがって、これはお勧めできません。

note: type: Plain text
en: DRBD allows you to enable and disable <<s-disk-flush-support,backing device flushes>> separately for the replicated data set and DRBD's own meta data. Both of these options are enabled by default. If you wish to disable either (or both), you would set this in the `disk` section for the DRBD configuration file, `/etc/drbd.conf`.
ja: DRBDは<<s-disk-flush-support,下位デバイスのフラッシュ>>を、レプリケートされたデータセットとDRBD独自のメタデータについて、個別に有効と無効を切り替える機能を備えています。この2つのオプションはデフォルトで有効になっています。このオプションのいずれか(または両方)を無効にしたい場合は、DRBD設定ファイルの `/etc/drbd.conf` の `disk` セクションで設定できます。

note: type: Plain text
en: To disable disk flushes for the replicated data set, include the following line in your configuration:
ja: レプリケートされたデータセットのディスクフラッシュを無効にするには、構成に次の行を記述します。

note: type: Plain text
en: To disable disk flushes on DRBD's meta data, include the following line:
ja: DRBDのメタデータのディスクフラッシュを無効にするには、次の行を記述します。

note: type: Plain text
en: After you have modified your resource configuration (and synchronized your `/etc/drbd.conf` between nodes, of course), you may enable these settings by issuing this command on both nodes:
ja: リソースの構成を修正し、また、もちろん両ノードの `/etc/drbd.conf` を同期したら、両ノードで次のコマンドを実行して、これらの設定を有効にします。

note: type: Plain text
en: In case only one of the serves has a BBWCfootnote:[For example, in the DR site you might be using different hardware, right?], you should move the setting into a host section, like this:
ja: 1台のサーバのみがBBWCがある場合footnote:[例えばDRサイトでは異なるハードウェアを使うでしょう]には、ホストセクションに以下のような設定をしてください。

note: type: Title ===
en: Configuring split brain behavior
ja: スプリットブレイン時の動作の設定

note: type: Title ====
en: Split brain notification
ja: スプリットブレインの通知

note: type: Plain text
en: DRBD invokes the `split-brain` handler, if configured, at any time split brain is _detected_. To configure this handler, add the following item to your resource configuration:
ja: スプリットブレインが _検出される_ と、DRBDはつねに `split-brain` ハンドラを呼び出します(設定されていれば)。このハンドラを設定するには、リソース構成に次の項目を追加します。

note: type: Plain text
en: _<handler>_ may be any executable present on the system.
ja: _<handler>_ はシステムに存在する任意の実行可能ファイルです。

note: type: Plain text
en: The DRBD distribution contains a split brain handler script that installs as `/usr/lib/drbd/notify-split-brain.sh`. It simply sends a notification e-mail message to a specified address. To configure the handler to send a message to `root@localhost` (which is expected to be an email address that forwards the notification to a real system administrator), configure the `split-brain handler` as follows:
ja: DRBDディストリビューションでは `/usr/lib/drbd/notify-split-brain.sh` という名前のスプリットブレイン対策用のハンドラスクリプトを提供しています。これは指定したアドレスに電子メールで通知を送信するだけのシンプルなものです。`root@localhost` (このアドレス宛のメールは実際のシステム管理者に転送されると仮定)にメッセージを送信するようにハンドラを設定するには、 `split-brain handler` を次のように記述します。

note: type: Plain text
en: After you have made this modification on a running resource (and synchronized the configuration file between nodes), no additional intervention is needed to enable the handler. DRBD will simply invoke the newly-configured handler on the next occurrence of split brain.
ja: 実行中のリソースで上記の変更を行い(ノード間で設定ファイルを同期すれば)、後はハンドラを有効にするための他の操作は必要ありません。次にスプリットブレインが発生すると、DRBDが新しく設定したハンドラを呼び出します。

note: type: Title ====
en: Automatic split brain recovery policies
ja: スプリットブレインからの自動復旧ポリシー

note: type: Plain text
en: Configuring DRBD to automatically resolve data divergence situations resulting from split-brain (or other) scenarios is configuring for potential *automatic data loss*.  Understand the implications, and don't do it if you don't mean to.
ja: スプリットブレイン(またはその他)のシナリオの結果、データの相違状況を自動的に解決するDRBDの構成は、潜在的な *自動データ損失* を構成することを意味します。その意味をよく理解し、それを意味しない場合は設定しないでください。

note: type: Plain text
en: You rather want to look into fencing policies, quorum settings, cluster manager integration, and redundant cluster manager communication links to *avoid* data divergence in the first place.
ja: むしろ、フェンシングポリシー、クォーラム設定、クラスタマネージャの統合、クラスタマネージャの冗長化通信リンクなどを調べて、まず最初にデータの相違状況をつくらないようにすべてきです。

note: type: Plain text
en: In order to be able to enable and configure DRBD's automatic split brain recovery policies, you must understand that DRBD offers several configuration options for this purpose. DRBD applies its split brain recovery procedures based on the number of nodes in the Primary role at the time the split brain is detected. To that end, DRBD examines the following keywords, all found in the resource's `net` configuration section:
ja: スプリットブレインからの自動復旧ポリシーには、状況に応じた複数のオプションが用意されています。DRBDは、スプリットブレインを検出したときのプライマリロールのノードの数にもとづいてスプリットブレイン回復手続きを適用します。そのために、DRBDはリソース設定ファイルの net セクションの次のキーワードを読み取ります。

note: type: Plain text
en: Split brain has just been detected, but at this time the resource is not in the Primary role on any host. For this option, DRBD understands the following keywords:
ja: スプリットブレインが検出されたときに両ノードともセカンダリロールの場合に適用されるポリシーを定義します。次のキーワードを指定できます。

note: type: Plain text
en: `disconnect`: Do not recover automatically, simply invoke the `split-brain` handler script (if configured), drop the connection and continue in disconnected mode.
ja: `disconnect`: 自動復旧は実行されません。 `split-brain` ハンドラスクリプト(設定されている場合)を呼び出し、 コネクションを切断して切断モードで続行します。

note: type: Plain text
en: `discard-younger-primary`: Discard and roll back the modifications made on the host which assumed the Primary role last.
ja: `discard-younger-primary`: 最後にプライマリロールだったホストに加えられた変更内容を破棄して ロールバックします。

note: type: Plain text
en: `discard-least-changes`: Discard and roll back the modifications on the host where fewer changes occurred.
ja: `discard-least-changes`:変更が少なかったほうのホストの変更内容を破棄してロールバックします。

note: type: Plain text
en: `discard-zero-changes`: If there is any host on which no changes occurred at all, simply apply all modifications made on the other and continue.
ja: `discard-zero-changes`: 変更がなかったホストがある場合は、 他方に加えられたすべての変更内容を適用して 続行します。

note: type: Plain text
en: Split brain has just been detected, and at this time the resource is in the Primary role on one host. For this option, DRBD understands the following keywords:
ja: スプリットブレインが検出されたときにどちらか1つのノードがプライマリロールである場合に適用されるポリシーを定義します。次のキーワードを指定できます。

note: type: Plain text
en: `disconnect`: As with `after-sb-0pri`, simply invoke the `split-brain` handler script (if configured), drop the connection and continue in disconnected mode.
ja: `disconnect`: `after-sb-0pri` と同様に `split-brain` ハンドラスクリプト(構成されている場合)を呼び出し、 コネクションを切断して切断モードで続行します。

note: type: Plain text
en: `consensus`: Apply the same recovery policies as specified in `after-sb-0pri`. If a split brain victim can be selected after applying these policies, automatically resolve. Otherwise, behave exactly as if `disconnect` were specified.
ja: `consensus`: `after-sb-0pri` で設定したものと同じ復旧ポリシーが適用されます。 これらのポリシーを適用した後で、 スプリットブレインの犠牲ノードを選択できる場合は自動的に解決します。それ以外の場合は、 `disconnect` を指定した場合と同様に動作します。

note: type: Plain text
en: `call-pri-lost-after-sb`: Apply the recovery policies as specified in `after-sb-0pri`. If a split brain victim can be selected after applying these policies, invoke the `pri-lost-after-sb` handler on the victim node. This handler must be configured in the `handlers` section and is expected to forcibly remove the node from the cluster.
ja: `call-pri-lost-after-sb`: `after-sb-0pri` で指定した復旧ポリシーが適用されます。 これらのポリシーを適用した後で、 スプリットブレインの犠牲ノードを選択できる場合は、犠牲ノードで `pri-lost-after-sb` ハンドラを起動します このハンドラは `handlers` セクションで設定する必要があります。 また、クラスタからノードを強制的に削除します。

note: type: Plain text
en: `discard-secondary`: Whichever host is currently in the Secondary role, make that host the split brain victim.
ja: `discard-secondary`: 現在のセカンダリロールのホストを、 スプリットブレインの犠牲ノードにします。

note: type: Plain text
en: Split brain has just been detected, and at this time the resource is in the Primary role on both hosts. This option accepts the same keywords as `after-sb-1pri` except `discard-secondary` and `consensus`.
ja: スプリットブレインが検出されたときに両ノードともプライマリロールである場合に適用されるポリシーを定義します。このオプションは `after-sb-1pri` と同じキーワードを受け入れます。ただし、 `discard-secondary` と `consensus` は除きます。

note: type: Plain text
en: DRBD understands additional keywords for these three options, which have been omitted here because they are very rarely used. Refer to the man page of `drbd.conf` for details on split brain recovery keywords not discussed here.
ja: 上記の3つのオプションで、DRBDは他のキーワードも認識しますが、それらはめったに使用されないためここでは省略します。ここで説明されていないスプリットブレインの復旧キーワードに関しては `drbd.conf` のマニュアルページを参照ください。

note: type: Plain text
en: For example, a resource which serves as the block device for a GFS or OCFS2 file system in dual-Primary mode may have its recovery policy defined as follows:
ja: たとえば、デュアルプライマリモードでGFSまたはOCFS2ファイルシステムのブロックデバイスとして機能するリソースの場合、次のように復旧ポリシーを定義できます。

note: type: Title ===
en: Creating a stacked three-node setup
ja: スタック3ノード構成の作成

note: type: Plain text
en: A three-node setup involves one DRBD device _stacked_ atop another.
ja: 3ノード構成では、1つのDRBDデバイスを別のデバイスの上に _スタック_ (積み重ね)します。

note: type: Plain text
en: Stacking is deprecated in DRBD version 9.x, as more nodes can be implemented on a single level. See <<s-drbdconf-conns>> for details.
ja: DRBD9.xでは1つの階層で複数ノードを使用できるのでスタッキングは非推奨です。詳細は <<s-drbdconf-conns>>をご参照ください。

note: type: Title ====
en: Device stacking considerations
ja: デバイススタックの留意事項

note: type: Plain text
en: The following considerations apply to this type of setup:
ja: 次のような事項に注意する必要があります。

note: type: Plain text
en: The stacked device is the active one. Assume you have configured one DRBD device `/dev/drbd0`, and the stacked device atop it is `/dev/drbd10`, then `/dev/drbd10` will be the device that you mount and use.
ja: スタックデバイス側が利用可能です。1つのDRBDデバイス `/dev/drbd0` を設定して、その上位にスタックデバイス `/dev/drbd10` があるとします。この場合は、 `/dev/drbd10` がマウントして使用するデバイスになります 。

note: type: Plain text
en: Device meta data will be stored twice, on the underlying DRBD device _and_ the stacked DRBD device. On the stacked device, you must always use <<s-internal-meta-data,internal meta data>>. This means that the effectively available storage area on a stacked device is slightly smaller, compared to an unstacked device.
ja: 下位のDRBDデバイス _および_ スタックDRBDデバイス(上位DRBDデバイス)の両方にそれぞれメタデータが存在します 。上位デバイスには、必ず <<s-internal-meta-data,内部メタデータ>>を使用してください。このため、 3ノード構成時の使用可能なディスク領域は、 2ノード構成に比べてわずかに小さくなります。

note: type: Plain text
en: To get the stacked upper level device running, the underlying device must be in the primary role.
ja: スタックした上位デバイスを実行するには、下位のデバイスが プライマリロールになっている必要があります。

note: type: Plain text
en: To be able to synchronize the backup node, the stacked device on the active node must be up and in the primary role.
ja: バックアップノードにデータを同期するには、 アクティブなノードのスタックデバイスがプライマリモードで動作している必要があります。

note: type: Title ====
en: Configuring a stacked resource
ja: スタックリソースの設定

note: type: Plain text
en: In the following example, nodes are named 'alice', 'bob', and 'charlie', with 'alice' and 'bob' forming a two-node cluster, and 'charlie' being the backup node.
ja: 次の例では `alice` 、 `bob` 、 `charlie` という名前のノードがあり、 `alice` と `bob` が2ノードクラスタを構成し、 `charlie` がバックアップノードになっています。

note: type: Plain text
en: As with any `drbd.conf` configuration file, this must be distributed across all nodes in the cluster -- in this case, three nodes. Notice the following extra keyword not found in an unstacked resource configuration:
ja: 他の `drbd.conf` 設定ファイルと同様に、この設定ファイルもクラスタのすべてのノード(この場合は3つ)に配布する必要があります。非スタックリソースの設定にはない、次のキーワードにご注意ください。

note: type: Plain text
en: This option informs DRBD that the resource which contains it is a stacked resource. It replaces one of the `on` sections normally found in any resource configuration. Do not use `stacked-on-top-of` in an lower-level resource.
ja: このオプションによって、DRBDに含まれるリソースがスタックリソースであることをDRBDに知らせます。これは、通常リソース設定内にある `on` セクションのうちの１つを置き換えます。`stacked-on-top-of` は下位レベルのリソースには使用しないでください。

note: type: Plain text
en: It is not a requirement to use <<fp-protocol-a,Protocol A>> for stacked resources. You may select any of DRBD's replication protocols depending on your application.
ja: スタックリソースに<<fp-protocol-a,Protocol A>>を使用することは必須ではありません。アプリケーションに応じて任意のDRBDのレプリケーションプロトコルを選択できます。

note: type: Block title
en: Single stacked setup
ja: 単一スタックの構成

note: type: Title ====
en: Enabling stacked resources
ja: スタックリソースを有効にする

note: type: Plain text
en: To enable a stacked resource, you first enable its lower-level resource and promote it:
ja: スタックリソースを有効にするには、まず、下位レベルリソースを有効にしてどちらか一方をプライマリに昇格します。

note: type: Plain text
en: As with unstacked resources, you must create DRBD meta data on the stacked resources. This is done using the following command:
ja: 非スタックリソースと同様に、スタックリソースの場合もDRBDメタデータを作成する必要があります。次のコマンドで実行します。次に、スタックリソースを有効にします。

note: type: Plain text
en: Then, you may enable the stacked resource:
ja: この後でバックアップノードのリソースを起動し、3ノードレプリケーションを有効にします。

note: type: Plain text
en: After this, you may bring up the resource on the backup node, enabling three-node replication:
ja: この後でバックアップノードのリソースを起動し、3ノードレプリケーションを有効にします。

note: type: Plain text
en: In order to automate stacked resource management, you may integrate stacked resources in your cluster manager configuration.
ja: クラスタ管理システムを使えばスタックリソースの管理を自動化できます。

note: type: Plain text
en: See <<s-pacemaker-stacked-resources>> for information on doing this in a cluster managed by the Pacemaker cluster management framework.
ja: Pacemakerクラスタ管理フレームワークで管理する方法については、<<s-pacemaker-stacked-resources>>を参照してください。

note: type: Title ===
en: Permanently diskless nodes
ja: 永続的なディスクレスノード

note: type: Plain text
en: A node might be permanently diskless in DRBD. Here is a configuration example showing a resource with 3 diskful nodes (servers) and one permanently diskless node (client).
ja: ノードはしばしDRBDの中で永続的にディスクレスになるときがあります。以下はディスクをもつ３つのノードと永続的なディスクレスノードの構成例です。

note: type: Plain text
en: For permanently diskless nodes no bitmap slot gets allocated. For such nodes the diskless status is displayed in green color since it is not an error or unexpected state. See <<s-drbd-client-internals>> for internal details.
ja: 永続的なディスクレスノードはビットマップスロットが割り当てられません。このようなノードのステータスは、エラーでも予期せぬ状態でもないので緑で表示されます。詳細は <<s-drbd-client-internals>> を参照ください。

note: type: Title ===
en: Data rebalancing
ja: データ再配置

note: type: Plain text
en: indexterm:[rebalance]Given the (example) policy that data needs to be available on 3 nodes, you need at least 3 servers for your setup.
ja: indexterm:[rebalance]以下の例では、すべてのデータ領域は3台に冗長化するポリシーを想定しています。したがって最小構成で3台のサーバが必要です。

note: type: Plain text
en: Now, as your storage demands grow, you will encounter the need for additional servers. Rather than having to buy 3 more servers at the same time, you can _rebalance_ your data across a single additional node.
ja: しかし、データ量が増えてくると、サーバ追加の必要性に迫られます。その際には、また新たに3台のサーバを購入する必要はなく、１つのノードだけを追加をしてデータを _再配置_ することができます。

note: type: Block title
en: DRBD data rebalancing
ja: DRBDデータ再配置

note: type: Plain text
en: In the figure above you can see the _before_ and _after_ states: from 3 nodes with three 25TiB volumes each (for a net 75TiB), to 4 nodes, with net 100TiB.
ja: 上の図では、3ノードの各々に25TiBのボリュームがある合計75TiBの状態から、4ノードで合計100TiBの状態にしています。

note: type: Plain text
en: To redistribute the data across your cluster you have to choose a _new_ node, and one where you want to remove this DRBD resource. + Please note that removing the resource from a currently _active_ node (i.e.  where DRBD is _Primary_) will involve either migrating the service or running this resource on this node as a <<s-drbd-client,DRBD client>>; it's easier to choose a node in _Secondary_ role. (Of course, that might not always be possible.)
ja: データを再配置する時には、 _新しい_ ノードとDRBDリソースを削除したいノードを選択する必要があります。現在 _アクティブ_ なノードからリソースを削除する場合には注意が必要です。 DRBDが `プライマリ` のノードからリソースを削除する場合にはサービスを移行するか、そのノードのリソースを<<s-drbd-client,DRBDクライアント>>として稼働させるかにしてください。通常は `セカンダリ` のノードから選ぶほうが簡単です(それができない場合もあるでしょうが)。

note: type: Title ====
en: Prepare a bitmap slot
ja: ビットマップスロットの用意

note: type: Plain text
en: You will need to have a free <<s-quick-sync-bitmap,bitmap slot>> for temporary use, on each of the nodes that have the resource that is to be moved.
ja: 移動するリソースには一時的に未使用の<<s-quick-sync-bitmap,ビットマップスロット>>用のスペースが必要です。

note: type: Plain text
en: You can allocate one more at <<s-first-time-up,`drbdadm create-md` time>>, or simply put a placeholder in your configuration, so that `drbdadm` sees that it should reserve one more slot:
ja: <<s-first-time-up,`drbdadm create-md` の時>>にもう一つ割り当てます。または、 `drbdadm` がもう１つスロットを取っておくように設定にプレースホルダを設けてもよいでしょう。

note: type: delimited block =
en: If you need to make that slot available during live use, you will have to
ja: このスロットを実際に利用するには以下が必要です。

note: type: delimited block =
en: dump the metadata,
ja: メタデータをダンプする,

note: type: delimited block =
en: enlarge the metadata space,
ja: メタデータ領域を拡大する,

note: type: delimited block =
en: edit the dumpfile,
ja: ダンプファイルを編集する,

note: type: delimited block =
en: load the changed metadata.
ja: メタデータをロードする

note: type: delimited block =
en: In a future version `drbdadm` will have a shortcut for you; most probably you'll be able to say `drbdadm resize --peers _N_` and have the kernel rewrite the metadata for you.
ja: 今後のバージョンの `drbdadm` ではショートカットキーが用意されます。 `drbdadm resize --peers N` が使用できるようになる予定であり、カーネルがメタデータを書き換えられるようになります。

note: type: Title ====
en: Preparing and activating the new node
ja: 新しいノードの用意と有効化

note: type: Plain text
en: First of all you have to create the underlying storage volume on the new node (using e.g. `lvcreate`).  Then the placeholder in the configuration can be filled with the correct host name, address, and storage path. Now copy the resource configuration to all relevant nodes.
ja: まずは新しいノードに( `lvcreate` 等で)下位のストレージリュームを作成する必要があります。 次に設定ファイルのプレイスホルダーに現在のホスト名、アドレス、ストレージのパスを書き込みます。そしてすべての必要なノードにリソース設定をコピーします。

note: type: Plain text
en: On the new node initialize the meta-data (once) by doing
ja: 新しいノードでメタデータを次のようにして(一度だけ)初期化します

note: type: Title ====
en: Starting the initial sync
ja: 初期同期の開始

note: type: Plain text
en: Now the new node needs to get the data.
ja: 新しいノードでデータを受け取ります。

note: type: Plain text
en: This is done by defining the network connection on the existing nodes via
ja: そのために以下のようにして既存のノードでネットワークコネクションを定義します。

note: type: Plain text
en: and starting the DRBD device on the new node via
ja: そして新しいノードでDRBDデバイスを開始します。

note: type: Title ====
en: Check connectivity
ja: 接続確認

note: type: Plain text
en: At this time please do a
ja: この時に、新しいノードで以下のコマンドを実行してください。

note: type: Plain text
en: on the new node, and check that _all_ other nodes are connected.
ja: 他のノード _すべて_ が接続しているか確認します。

note: type: Title ====
en: After the initial sync
ja: 初期同期後

note: type: Plain text
en: As soon as the new host is _UpToDate_, one of the other nodes in the configuration can be renamed to `for-later-rebalancing`, and kept for another migration.
ja: 新しいノードが `UpToDate` になったらすぐに、設定中の他のノードのうち１つが `for-later-rebalancing` に変更できるようになり、次のマイグレーション用にキープしておけるようになります。

note: type: Plain text
en: Perhaps you want to comment the section; although that has the risk that doing a `drbdadm create-md` for a new node has too few bitmap slots for the next rebalancing. + It might be easier to use a reserved (unused) IP address and host name.
ja: 次の再配置用に小さなビットマップスロットしかない新規ノードに `drbdadm create-md` をすることにはリスクがあると思う方もいることでしょう。あらかじめIPアドレスとホスト名を用意しておくのが簡単な方法でしょう。

note: type: Plain text
en: Copy the changed configuration around again, and use it by running
ja: 再度変更した設定をコピーして、以下のコマンドを

note: type: Plain text
en: on all nodes.
ja: 全ノードで実行します。

note: type: Title ====
en: Cleaning up
ja: クリーニング

note: type: Plain text
en: On the one node that had the data up to now, but isn't used anymore for this resource, you can now take the DRBD device down by starting
ja: 今までデータのあったノードでは、もうリソースを使用しない場合にはDRBDデバイスを次のようにして停止できます。

note: type: Plain text
en: Now the lower level storage device isn't used anymore, and can either be re-used for other purposes or, if it is a logical volume, its space can be returned to the volume group via `lvremove`.
ja: これで下位デバイスを使用しなくなり、他の用途で使用することができるようになります。論理ボリュームであれば lvremove でボリュームグループに戻すことができます。

note: type: Title ====
en: Conclusion and further steps
ja: まとめと他のステップ

note: type: Plain text
en: One of the resources has been migrated to the new node. The same could be done for one or more other resources, to free space on two or three nodes in the existing cluster.
ja: １つのリソースを新しいノードに移動しました。同様の手順で１つまたはそれ以上のリソースを、クラスタ内の既存の2つまたは3つのノードの空きスペースに行う事も可能です。

note: type: Plain text
en: Then new resources can be configured, as there are enough nodes with free space to achieve 3-way redundancy again.
ja: 再び3重の冗長化を行うのに必要な空き容量のあるノードが揃えば、新しいリソースを設定することが出来ます。

note: type: Title ===
en: Configuring quorum
ja: クォーラム設定

note: type: Plain text
en: In order to avoid split brain or diverging data of replicas one has to configure fencing. All the options for fencing rely on redundant communication in the end.  That might be in the form of a management network that connects the nodes to the IPMI network interfaces of the peer machines. In case of the crm-fence-peer script it is necessary that Pacemakers communication stays available when DRBD's network link breaks.
ja: スプリットブレインや複製データの相違を防ぐために、フェンシングを構成する必要があります。フェンシングのすべてのオプションは、最後には冗長な通信路に依存します。それはノードが対向ノードのIPMIネットワークインタフェースに接続する形かもしれません。crm-fence-peerスクリプトの場合、DRBDのネットワークリンクが切断されたときに、pacemaker の通信が有効であることが必要になります。

note: type: Plain text
en: The quorum mechanism on the other hand takes a completely difference approach. The basic idea is that a cluster partition may only modify the replicated data set if the number of nodes that can communicate is greater than the half of the overall number of nodes. A node of such a partition _has quorum_.  On the other hand a node does not have quorum needs to guarantee that the replicated data set it not touched, that it does not create a diverging data set.
ja: 一方クォーラムは完全に異なるアプローチをとります。基本的な考え方は、通信できるノードの数がノード総数の半分を超える場合、クラスタパーティションは複製されたデータセットを変更できるということです。そのようなパーティションのノードは、クォーラムを持つといいます。言い換えると、クォーラムを持たないノードは、複製されたデータを変更しないことを保証します。これはデータの相違を作成しないことを意味します。

note: type: Plain text
en: The quorum implementation in DRBD gets enabled by setting the `quorum` resource option to `majority`, `all` or a numeric value. Where `majority` selects the behavior that was described in the previous paragraph.
ja: DRBDのクォーラムの実装は、`quorum` リソースに `majority` , `all` または数値を設定することで有効にできます。 `majority` の動作が、前の文章で説明した動作になります。

note: type: Title ====
en: Guaranteed minimal redundancy
ja: 保証された最低限の冗長化

note: type: Plain text
en: By default every node with a disk gets a vote in the quorum election. In other words only diskless nodes do not count. So a partition with two _Inconsistent_ disks gets quorum, while a partition with one _UpToDate_ node will have quorum in a 3 node cluster. By configuring `quorum-minimum-redundancy` this behavior can be changed so that only nodes that are `UpToDate` have a vote in the quorum election. The option takes the same arguments as the `quorum` option.
ja: デフォルトでは、ディスクを持つすべてのノードがクォーラム選挙で投票権を持ちます。言い換えると、ディスクレスノードだけが持ちません。従って、3ノードクラスタでは、 _Inconsistent_ ディスクを持つ2つのノード、 _UpToDate_ を持つ1つノードは、クォーラム投票権を持つことができます。 `quorum-minimum-redundancy` を設定することによって、`UpToDate` ノードだけがクォーラム選挙で投票権を持つように変更することもできます。このオプションは `quorum` オプションと同じ引数をとります。

note: type: Plain text
en: With this option you express that you rather want to wait until eventually necessary resync operations finish before any services start. So in a way you prefer that the minimal redundancy of your data is guaranteed over the availability of your service. Financial data and services is an example that comes to mind.
ja: このオプションを使用すると、サービスを開始する前に必要な再同期操作が完了するまで待機する、ということも表現できます。 したがって、データの最低限の冗長性がサービスの可用性よりも保証されることを好む方法です。金融データとサービスなどはその一例です。

note: type: Plain text
en: Consider following example for a 5 node cluster. It requires a partitions to have at least 3 nodes, and two of them must be `UpToDate`:
ja: 以下に5ノードクラスタの設定例を示します。パーティションは少なくとも3つのノードが必要であり、そのうち2つは `UpToDate` である必要があります。

note: type: Title ====
en: Actions on loss of quorum
ja: クォーラムを失った時の動作

note: type: Plain text
en: When a node that is running the service loses quorum it needs to cease write-operations on the data set immediately. That means that IO immediately starts to complete all IO requests with errors. Usually that means that a graceful shutdown is not possible, since that would require more modifications to the data set. The IO errors propagate from the block level to the file system and from the file system to the user space application(s).
ja: サービスを実行しているノードがクォーラムを失うと、すぐにデータセットの書き込み操作を中止する必要があります。これはIOがすぐにすべてのIO要求をエラーで完了し始めることを意味します。通常、これは、正常なシャットダウンが不可能であることを意味します。これはデータセットをさらに変更する必要があるためです。IOエラーはブロックレベルからファイルシステムに、ファイルシステムからユーザースペースアプリケーションに伝わります。

note: type: Plain text
en: Ideally the application simply terminates in case of IO errors. This allows then Pacemaker to unmount the filesystem and to demote the DRBD resource to secondary role.  If that is true you should set the `on-no-quorum` resource option to `io-error`.  Here is an example:
ja: 理想的には、IOエラーの場合、アプリケーションを単に終了させることです。これはその後、Pacemaker がファイルシステムをアンマウントし、DRBDリソースを降格させセカンダリロールに移すことを可能にします。その場合は、`on-no-quorum` リソースに `io-error` を設定してください。以下はその設定例です。

note: type: Plain text
en: If you application does not terminate on the first IO error, you can choose to freeze IO instead and to reboot the node. Here is a configuration example:
ja: アプリケーションが最初のIOエラーで終了しない場合は、IOをフリーズさせノードをリブートさせることもできます。以下はその設定例です。

note: type: Title ====
en: Using a diskless node as a tiebreaker
ja: タイブレーカーとしてのディスクレスノードを使用

note: type: Plain text
en: A diskless node with connections to all nodes in a cluster can be utilized to break ties in the quorum negotiation process.
ja: クラスタ内のすべてのノードに接続されているディスクレスノードを利用して、クォーラムネゴシエーションプロセスのタイブレークを解消できます。

note: type: Plain text
en: Consider the following two-node cluster, where node A is the primary and node B is a secondary:
ja: ノードAがプライマリで、ノードBがセカンダリである、次の2ノードクラスタを考えます。

note: type: Plain text
en: As soon as the connection between the two nodes is interrupted, they lose quorum and the application on top of the cluster cannot write data anymore.
ja: 2つのノード間の接続が失われるとすぐに、2つのノードはクォーラムを失い、クラスタ上のアプリケーションはデータを書き込めなくなります。

note: type: Plain text
en: Now if we add a third node, C, to the cluster and configure it as diskless, we can take advantage of the tiebreaker mechanism.
ja: 3番目のノードCをクラスタに追加し、それをディスクレスとして構成すると、タイブレーカーメカニズムを利用できます。

note: type: Plain text
en: In this case, when the primary and secondary nodes lose connection, they can still "see" the diskless tiebreaker. Because of this, the primary can continue working, while the secondary demotes its disk to Outdated and the service can therefore not be migrated there.
ja: この場合、プライマリノードとセカンダリノードが接続を失っても、両ノードはディスクレスタイブレーカーとの接続をまだ維持しています。このため、プライマリは機能し続けることができますが、セカンダリはそのディスクをOutdatedに降格させるため、サービスをそこに移行することはできません。

note: type: Plain text
en: There are a few special cases in case two connections fail. Consider the following scenario:
ja: 同時に2つの接続が失われる場合は特別なケースであり、次に説明します。

note: type: Plain text
en: In this case, the tiebreaker node forms a partition with the primary node. The primary therefore keeps quorum, while the secondary becomes outdated. Note that the secondary's disk state will be "UpToDate", but regardless it cannot be promoted to primary because it lacks quorum.
ja: この場合、タイブレーカーノードはプライマリとパーティションを形成します。そのため、プライマリはクォーラムを維持し、セカンダリは古くなります。セカンダリのディスクの状態は "UpToDate" のままですが、クォーラムがないためにプライマリに昇格できません。

note: type: Plain text
en: Let's consider the possibility of the primary losing connection to the tiebreaker:
ja: プライマリがタイブレーカーとの接続を失う可能性を考えてみます。

note: type: Plain text
en: In this case, the primary becomes unusable and goes into a "quorum suspended" state. This effectively results in the application on top of DRBD receiving I/O errors. A cluster manager could then promote node B to primary and keep the service running there instead.
ja: この場合、プライマリは使用できなくなり、"クォーラム中断" 状態になります。これにより、DRBD上のアプリケーションが I/O エラーを受信します。その後、クラスタマネージャはノードBをプライマリに昇格させ、代わりにそこでサービスを実行し続けることができます。

note: type: Plain text
en: In case the diskless tiebreaker "switches sides", we need to avoid data divergence. Consider this scenario:
ja: ディスクレスタイブレーカーが "サイドを切り替える" 場合、データの相違を避ける必要があります。このシナリオを考えます。

note: type: Plain text
en: The connection between the primary and secondary has failed, and the application is continuing to run on the primary, when the primary suddenly loses its connection to the diskless node.
ja: プライマリとセカンダリ間の接続が失われ、プライマリのディスクレスノードへの接続が突然失われた場合でも、アプリケーションはプライマリ上で実行を継続しています。

note: type: Plain text
en: In this case, no node can be promoted to primary and the cluster cannot continue to operate.
ja: この場合は、どのノードもプライマリに昇格できず、クラスタは動作を継続できません。

note: type: delimited block =
en: Protecting from data divergence always takes priority over ensuring service availability.
ja: データの分離を避けることは、サービスの可用性を確保することよりも常に優先されます。

note: type: Plain text
en: Let's look at another scenario:
ja: 他のシナリオを見てみます。

note: type: Plain text
en: Here, the application is running on the primary, while the secondary is unavailable. Then, the tiebreaker first loses connection to the primary, and then reconnects to the secondary.  It is important to note here that *a node that has lost quorum cannot regain quorum by connecting to a diskless node*. Thus, in this case, no node has quorum and the cluster halts.
ja: ここでは、アプリケーションはプライマリで実行されていますが、セカンダリは利用できません。その後、タイブレーカーはプライマリへの接続を失い、次にセカンダリに再接続します。ここで重要なのは、クォーラムを失ったノードは、ディスクレスノードに接続してもクォーラムを取り戻すことはできないことです。したがって、この場合、どのノードもクォーラムを持たず、クラスタは停止します。

note: type: Title ====
en: Last man standing
ja: ラストマン・スタンディング

note: type: Plain text
en: It needs to be mentioned that nodes that leave a cluster gracefully are counted different than failed nodes. In this context _leaving gracefully_ means that the leaving node marked it's data as Outdated, and that it was able to tell the remaining nodes that it's data is Outdated.
ja: クラスタから正常に離脱するノードは、障害が発生したノードとは異なるものとしてカウントされることに注意する必要があります。正常に離脱した場合、離脱ノードのデータは Outdated(無効状態) としてマークされ、残りのノードにデータが無効状態であることを伝えることができます。

note: type: Plain text
en: In a group of nodes where all disks are Outdated no one in that group can promote to Primary footnote:[The exception is a manual promotion with the --force flag. We assume that one that uses the --force knows what he is doing.].
ja: すべてのディスクが無効状態になっているノードのグループでは、そのグループの誰もプライマリに昇格できません footnote:[例外は -force フラグを使用した手動昇格です。 --force を使用する場合、それが何を意味するかを認識していると仮定します。]。

note: type: Plain text
en: An implication is that, if a cluster is left by all but one node, it can keep quorum as long as all the others left in a graceful way. If a single node leaves ungraceful, it has to assume that all away nodes form a partition and have access to up-to-date data. If the other partition might (potentially) be larger than my own partition it looses quorum.
ja: つまり、1 つのノードを除くすべてのノードがクラスターから離脱した場合、そのすべてのノードが正常に離脱している限り、クォーラムを維持できます。1 つのノードが正常に離脱しなかった場合、残ったすべてのノードでパティションを形成し、UpToDate データにアクセスすると仮定します。他のパーティションが（潜在的に）自分のパーティションよりも大きい場合、クォーラムを失います。

note: type: Title ===
en: Removing DRBD
ja: DRBD の削除

note: type: Plain text
en: For the unlikely case that you want to remove DRBD, here are the necessary steps.
ja: DRBD を削除する場合は、以下のステップに従います。

note: type: Plain text
en: Stop the services and unmount the filesystems on top of the DRBD volumes. In case you are using a cluster manager, make sure it ceases to control the services fist.
ja: サービスを停止し、DRBD ボリュームのファイルシステムをマウント解除します。クラスタマネージャを使用している場合は、最初にサービスの制御を停止するようにしてください。

note: type: Plain text
en: Stop the DRBD resource(s) by using `drbdadm down <res>` or `drbdadm down all`
ja: `drbdadm down <res>` または `drbdadm down all` で DRBD リソースを停止します。

note: type: Plain text
en: In case the DRBD resource was using internal meta-data you might choose to resize the filesystem to cover all of the backing device's space. This step effectively removes DRBD's meta-data. This is an action that can not be reversed easily. You can do that with `resize2fs <backing_dev>` for ext[234] family of file systems.  It supports resizing of unmounted filesystem and under certain conditions also online grow. XFS can be grown online only with the `xfs_growfs` command.
ja: DRBD リソースが内部メタデータを使用していた場合は、ファイルシステムのサイズを変更して、下位デバイスのすべてのスペースをカバーすることができます。この手順により、DRBD のメタデータが効果的に削除されます。これは簡単に元に戻せないアクションです。ファイルシステムが ext[234] ファミリの場合 `resize2fs <backing_dev>` でそれを行うことができます。マウントされていないファイルシステムのサイズ変更と特定の条件下ではオンラインでも対応可能です。 XFS は `xfs_growfs` コマンドを使用してのみオンラインで拡張できます。

note: type: Plain text
en: Mount the backing device(s) directly, start the services on top of them
ja: 下位デバイスを直接マウントし、それらの上でサービスを開始します。

note: type: Plain text
en: Unload the drbd kernel driver modules with `rmmod drbd_transport_tcp` and `rmmod drbd`.
ja: `rmmod drbd_transport_tcp` と `rmmod drbd` で DRBD カーネルモジュールをアンロードします。

note: type: Plain text
en: Uninstall the drbd software packages.
ja: DRBD ソフトウェアパッケージをアンインストールします。
