en to ja translation catalogue (141 entries)

note: type: Title ===
en: Configuring DRBD
ja: DRBDの設定

note: type: Title ====
en: Preparing your lower-level storage
ja: 下位レベルストレージの準備

note: type: Plain text
en: After you have installed DRBD, you must set aside a roughly identically sized storage area on both cluster nodes. This will become the _lower-level device_ for your DRBD resource. You may use any type of block device found on your system for this purpose. Typical examples include:
ja: DRBDをインストールしたら、両方のクラスタノードにほぼ同じ容量の記憶領域を用意する必要があります。これがDRBDリソースの _下位レベルデバイス_ になります。システムの任意のブロックデバイスを下位レベルデバイスとして使用できます。たとえば、次のようなものがあります。

note: type: Plain text
en: A hard drive partition (or a full physical hard drive),
ja: ハードドライブのパーティション(または物理ハードドライブ全体)

note: type: Plain text
en: a software RAID device,
ja: ソフトウェアRAIDデバイス

note: type: Plain text
en: an LVM Logical Volume or any other block device configured by the Linux device-mapper infrastructure,
ja: LVM論理ボリュームまたはLinuxデバイスマッパインフラストラクチャによって構成されるその他のブロックデバイス

note: type: Plain text
en: any other block device type found on your system.
ja: システム内のその他のブロックデバイス

note: type: Plain text
en: You may also use _resource stacking_, meaning you can use one DRBD device as a lower-level device for another. Some specific considerations apply to stacked resources; their configuration is covered in detail in <<s-three-nodes>>.
ja: リソースを _スタッキング(積み重ね)_ することもできます。つまり、DRBDデバイスを他のDRBDデバイスの下位レベルのデバイスとして利用することができます。リソースの積み重ねにはいくつかの注意点があります。詳しくは<<s-three-nodes>>を参照ください。

note: type: Plain text
en: While it is possible to use loop devices as lower-level devices for DRBD, doing so is not recommended due to deadlock issues.
ja: ループデバイスをDRBDの下位レベルデバイスとして使用することもできますが、デッドロックの問題があるためお勧めできません。

note: type: Plain text
en: It is _not_ necessary for this storage area to be empty before you create a DRBD resource from it. In fact it is a common use case to create a two-node cluster from a previously non-redundant single-server system using DRBD (some caveats apply -- please refer to <<s-metadata>> if you are planning to do this).
ja: DRBDリソースを作成する前に、そのストレージ領域を空にしておく _必要はありません_ 。DRBDを使用して、非冗長のシングルサーバシステムから、2ノードのクラスタシステムを作成することは一般的なユースケースですが、いくつか重要な注意点があります。(その場合には<<s-metadata>>を参照ください)

note: type: Plain text
en: For the purposes of this guide, we assume a very simple setup:
ja: 本ガイドの説明は、次のようなとてもシンプルな構成を前提としています。

note: type: Plain text
en: Both hosts have a free (currently unused) partition named `/dev/sda7`.
ja: 両ホストには使用可能な(現在未使用の) `/dev/sda7` というパーティションがある。

note: type: Plain text
en: We are using <<s-internal-meta-data,internal meta data>>.
ja: <<s-internal-meta-data,内部メタデータ>>を使用する。

note: type: Title ====
en: Preparing your network configuration
ja: ネットワーク構成の準備

note: type: Plain text
en: It is recommended, though not strictly required, that you run your DRBD replication over a dedicated connection. At the time of this writing, the most reasonable choice for this is a direct, back-to-back, Gigabit Ethernet connection. When DRBD is run over switches, use of redundant components and the _bonding_ driver (in _active-backup_ mode) is recommended.
ja: 必須要件ではありませんが、DRBDによるレプリケーションの実行には、専用接続を使用することをお勧めします。この書き込みには、ギガビットイーサネット同士をケーブルで直結した接続が最適です。DRBDをスイッチを介して使用する場合には、冗長コンポーネントと _bonding_ ドライバ( _active-backup_ モードで)の使用を推奨します。

note: type: Plain text
en: It is generally not recommended to run DRBD replication via routers, for reasons of fairly obvious performance drawbacks (adversely affecting both throughput and latency).
ja: 一般に、ルータを介してDRBDレプリケーションを行うことはお勧めできません。スループットと待ち時間の両方に悪影響を及ぼし、パフォーマンスが大幅に低下します。

note: type: Plain text
en: In terms of local firewall considerations, it is important to understand that DRBD (by convention) uses TCP ports from 7788 upwards, with every resource listening on a separate port. DRBD uses _two_ TCP connections for every resource configured. For proper DRBD functionality, it is required that these connections are allowed by your firewall configuration.
ja: ローカルファイアウォールの要件として重要な点は、通常、DRBDは7788以上のTCPポートを使用し、それぞれのTCPリソースが個別のTCPポート上で待機するということです。DRBDは _2つ_ のTCP接続を使用します。これらの接続が許可されるようにファイアウォールを設定する必要があります。

note: type: Plain text
en: Security considerations other than firewalling may also apply if a Mandatory Access Control (MAC) scheme such as SELinux or AppArmor is enabled. You may have to adjust your local security policy so it does not keep DRBD from functioning properly.
ja: SELinuxやAppArmorなどのMAC (Mandatory Access Control)スキーマが有効な場合は、ファイアウォール以外のセキュリティ要件も考慮する場合があります。DRBDが正しく機能するように、 必要に応じてローカルセキュリティポリシーを調整してください。

note: type: Plain text
en: You must, of course, also ensure that the TCP ports for DRBD are not already used by another application.
ja: また、DRBDに使用するTCPポートを別のアプリケーションが使用していないことも確認してください。

note: type: Plain text
en: It is not (yet) possible to configure a DRBD resource to support more than one TCP connection pair. If you want to provide for DRBD connection load-balancing or redundancy, you can easily do so at the Ethernet level (again, using the _bonding_ driver).
ja: 現時点では1つのDRBDリソースに複数のTCPコネクション・ペアを設定することはできません。DRBD接続に負荷分散や冗長性が必要な場合は、イーサネットレベルで簡単に実現できます(この場合も _bonding_ ドライバを使用してください)。

note: type: Plain text
en: Our two DRBD hosts each have a currently unused network interface, `eth1`, with IP addresses `10.1.1.31` and `10.1.1.32` assigned to it, respectively.
ja: 2つのDRBDホストそれぞれに、現在使用されていないネットワークインタフェース `eth1` が存在する(IPアドレスはそれぞれ `10.1.1.31` と `10.1.1.32` )。

note: type: Plain text
en: No other services are using TCP ports 7788 through 7799 on either host.
ja: どちらのホストでも他のサービスがTCPポート7788〜7799を使用していない。

note: type: Plain text
en: The local firewall configuration allows both inbound and outbound TCP connections between the hosts over these ports.
ja: ローカルファイアウォール設定は、これらのポートを介したホスト間のインバウンドとアウトバウンドの両方のTCP接続を許可する。

note: type: Title ====
en: Configuring your resource
ja: リソースの設定

note: type: Plain text
en: All aspects of DRBD are controlled in its configuration file, `/etc/drbd.conf`. Normally, this configuration file is just a skeleton with the following contents:
ja: DRBDのすべての機能は、設定ファイル `/etc/drbd.conf` で制御されます。通常、この設定ファイルは、次のような内容となっています。

note: type: Plain text
en: By convention, `/etc/drbd.d/global_common.conf` contains the <<s-drbdconf-global,`global`>> and <<s-drbdconf-common,`common`>> sections of the DRBD configuration, whereas the `.res` files contain one <<s-drbdconf-resource,`resource`>> section each.
ja: 通例では、`/etc/drbd.d/global_common.conf` にはDRBD設定の <<s-drbdconf-global, `global`>> と <<s-drbdconf-common, `common`>> セクションが含まれます。また、 `.res` ファイルには各 <<s-drbdconf-resource, `リソース`>> セクションが含まれます。

note: type: Plain text
en: It is also possible to use `drbd.conf` as a flat configuration file without any `include` statements at all. Such a configuration, however, quickly becomes cluttered and hard to manage, which is why the multiple-file approach is the preferred one.
ja: `drbd.conf` に `include` ステートメントを使用せずにすべての設定を記載することも可能です。しかし、設定の見やすさの観点から、複数のファイルに分割することをお勧めします。

note: type: Plain text
en: Regardless of which approach you employ, you should always make sure that `drbd.conf`, and any other files it includes, are _exactly identical_ on all participating cluster nodes.
ja: いずれにしても `drbd.conf` や、その他の設定ファイルは、すべてのクラスタノードで `正確に同じ` である必要があります。

note: type: Plain text
en: The DRBD source tarball contains an example configuration file in the `scripts` subdirectory. Binary installation packages will either install this example configuration directly in `/etc`, or in a package-specific documentation directory such as `/usr/share/doc/packages/drbd`.
ja: DRBDのソースtarファイルの `scripts` サブディレクトリに、サンプル設定ファイルがあります。バイナリインストールパッケージの場合、サンプル設定ファイルは直接 `/etc` にインストールされるか、 `/usr/share/doc/packages/drbd` などのパッケージ固有の文書ディレクトリにインストールされます。

note: type: Plain text
en: This section describes only those few aspects of the configuration file which are absolutely necessary to understand in order to get DRBD up and running. The configuration file's syntax and contents are documented in great detail in the man page of `drbd.conf`.
ja: このセクションは、DRBDを稼働させるために理解しておく必要のある設定ファイルの項目についての説明です。設定ファイルの構文と内容の詳細については `drbd.conf` マニュアルページを参照ください。

note: type: Title =====
en: Example configuration
ja: 設定例

note: type: Plain text
en: For the purposes of this guide, we assume a minimal setup in line with the examples given in the previous sections:
ja: 本ガイドでの説明は、前章であげた例をもとにする最小限の構成を前提にしています。

note: type: Block title
en: Simple DRBD configuration (`/etc/drbd.d/global_common.conf`)
ja: シンプルなDRBD構成例 (`/etc/drbd.d/global_common.conf`)

note: type: Block title
en: Simple DRBD resource configuration (`/etc/drbd.d/r0.res`)
ja: シンプルなDRBDリソースの構成例 (`/etc/drbd.d/r0.res`)

note: type: Plain text
en: This example configures DRBD in the following fashion:
ja: この例では、DRBDが次のように設定されます。

note: type: Plain text
en: You "opt in" to be included in DRBD's usage statistics (see <<fp-usage-count>>).
ja: DRBDの使用状況の統計をオプトインとして含める(<<fp-usage-count>>参照)。

note: type: Plain text
en: Resources are configured to use fully synchronous replication (<<s-replication-protocols,Protocol C>>) unless explicitly specified otherwise.
ja: 特に他の指定がない限り完全に同期したレプリケーションを使用するようにリソースを設定する(<<s-replication-protocols,プロトコルC>>)。

note: type: Plain text
en: Our cluster consists of two nodes, 'alice' and 'bob'.
ja: クラスタには2つのノード `alice` と `bob` がある。

note: type: Plain text
en: We have a resource arbitrarily named `r0` which uses `/dev/sda7` as the lower-level device, and is configured with <<s-internal-meta-data,internal meta data>>.
ja: `r0` という名前のリソース(名前は自由に設定可能)があり `/dev/sda7` を下位レベルデバイスとして使用し、また、<<s-internal-meta-data,内部メタデータ>>を構成する。

note: type: Plain text
en: The resource uses TCP port 7789 for its network connections, and binds to the IP addresses 10.1.1.31 and 10.1.1.32, respectively.
ja: リソースはネットワーク接続にTCPポート7789を使用し、それぞれIPアドレス10.1.1.31と10.1.1.32にバインドされる

note: type: Plain text
en: The configuration above implicitly creates one volume in the resource, numbered zero (`0`). For multiple volumes in one resource, modify the syntax as follows (assuming that the same lower-level storage block devices are used on both nodes):
ja: 暗黙的に、上記の設定はリソースの1つのボリュームを作成し、番号 `ゼロ(0)` が付与されます。1つのリソースに複数のボリュームを設定する場合には、次のようにします(両ノードで下位デバイスとして同レベルでストレージブロックデバイスを使用する場合)。

note: type: Block title
en: Multi-volume DRBD resource configuration (`/etc/drbd.d/r0.res`)
ja: 複数ボリュームのDRBDリソース構成例(`/etc/drbd.d/r0.res`)

note: type: Plain text
en: Host sections ('on' keyword) inherit _volume_ sections from the resource level. They may contain _volume_ themselves, these values have precedence over inherited values.
ja: ホストセクション（'on' キーワード）は、リソースレベルから _volume_ セクションを継承します。それには _volume_ 自体が含まれる場合があり、この値は継承された値よりも優先されます。

note: type: Plain text
en: Volumes may also be added to existing resources on the fly. For an example see <<s-lvm-add-pv>>.
ja: ボリュームは既存のデバイスの動作中にも追加できます。<<s-lvm-add-pv>>をご参照ください。

note: type: Plain text
en: For compatibility with older releases of DRBD it supports also drbd-8.4 like configuration files.
ja: DRBD の古いリリースとの互換性のために、drbd-8.4 の構成ファイルもサポートします。

note: type: Block title
en: An old(8.4) style configuration file
ja: 古い（8.4）スタイルの構成ファイル

note: type: Plain text
en: Strings that do not contain keywords, might be gives withouth double quotes `"`.
ja: キーワードを含まない文字列は、二重引用符 `"` なしで指定される場合があります。

note: type: Plain text
en: The old version to specify the device, was to give a string containing the name of the resulting device file.
ja: 古いバージョンのデバイス指定は、デバイスファイル名を与えることでした。

note: type: Plain text
en: Two node configurations get node numbers assigned by drbdadm.
ja: 2 ノード構成は、drbdadm によって割り当てられたノード番号を使用します。

note: type: Plain text
en: A pure two node configuration gets an implicit connection.
ja: 純粋な 2 ノード構成は暗黙的な connection を使用します。

note: type: Title =====
en: The `global` section
ja: `global` セクション

note: type: Plain text
en: This section is allowed only once in the configuration. It is normally in the `/etc/drbd.d/global_common.conf` file. In a single-file configuration, it should go to the very top of the configuration file. Of the few options available in this section, only one is of relevance to most users:
ja: このセクションは設定の中で1回しか使用できません。通常この設定は `/etc/drbd.d/global_common.conf` ファイルに記述します。設定ファイルが1つの場合は、設定ファイルの一番上に記述します。このセクションで使用できるオプションはわずかですが、ほとんどのユーザーの場合、必要なのは次の1つだけです。

note: type: Plain text
en: The DRBD project keeps statistics about the usage of various DRBD versions. This is done by contacting an HTTP server every time a new DRBD version is installed on a system. This can be disabled by setting `usage-count no;`.  The default is `usage-count ask;` which will prompt you every time you upgrade DRBD.
ja: DRBDプロジェクトはさまざまなバージョンのDRBDの使用状況について統計を取ります。これは、システムに新規のDRBDバージョンがインストールされるたびに、HTTPサーバに接続することにより実行されます。これを無効にするには、 `usage-count no;` を指定します。デフォルトは `usage-count ask;` で、 DRBDをアップグレードするたびにプロンプトが表示されます。

note: type: Plain text
en: DRBD's usage statistics are, of course, publicly available: see http://usage.drbd.org.
ja: DRBDの使用状況の統計は公開されています。http://usage.drbd.orgを参照ください。

note: type: Title =====
en: The `common` section
ja: `common` セクション

note: type: Plain text
en: This section provides a shorthand method to define configuration settings inherited by every resource. It is normally found in `/etc/drbd.d/global_common.conf`. You may define any option you can also define on a per-resource basis.
ja: このセクションで、各リソースに継承される設定を簡単に定義できます。通常この設定は `/etc/drbd.d/global_common.conf` に指定します。ここで定義するオプションは、リソースごとに定義することもできます。

note: type: Plain text
en: Including a `common` section is not strictly required, but strongly recommended if you are using more than one resource. Otherwise, the configuration quickly becomes convoluted by repeatedly-used options.
ja: `common` セクションは必須ではありませんが、複数のリソースを使用する場合は、記述することを強くお勧めします。これにより、オプションを繰り返し使用することによって設定が複雑になることを回避できます。

note: type: Plain text
en: In the example above, we included `net { protocol C; }` in the `common` section, so every resource configured (including `r0`)  inherits this option unless it has another `protocol` option configured explicitly. For other synchronization protocols available, see <<s-replication-protocols>>.
ja: 上の例では `net { protocol C; }` が `common` セクションで指定されているため、設定されているすべてのリソース( `r0` 含む)がこのオプションを継承します。ただし、明示的に別の `protocol` オプションが指定されている場合は除きます。使用可能なその他の同期プロトコルについては、<<s-replication-protocols>>を参照してください。

note: type: Title =====
en: The `resource` sections
ja: `resource` セクション

note: type: Plain text
en: A per-resource configuration file is usually named `/etc/drbd.d/__resource__.res`.  Any DRBD resource you define must be named by specifying a resource name in the configuration. The convention is to use only letters, digits, and the underscore; while it is technically possible to use other characters as well, you won't like the result if you ever happen stumble to need the more specific `__resource__:___peer__/__volume__` syntax.
ja: 各リソースの設定ファイルは、通常 `/etc/drbd.d/resource.res` という名前にします。定義するDRBDリソースは、設定ファイルでresource nameを指定して名前を付ける必要があります。通常は文字または数字、アンダースコアのみを使用します。他の文字を使用することも技術的には可能ですが、より具体的な `__resource__:___peer__/__volume__` の構文が必要になった場合、うまくいかないでしょう。

note: type: Plain text
en: Every resource configuration must also have at least two `on _host_` sub-sections, one for every cluster node. All other configuration settings are either inherited from the `common` section (if it exists), or derived from DRBD's default settings.
ja: 各リソースには各クラスタノードに最低2つの `on <host>` サブセクションも必要です。その他すべての設定は `common` セクション(記述した場合)から継承されるか、DRBDのデフォルト設定から取得されます。

note: type: Plain text
en: In addition, options with equal values on all hosts can be specified directly in the `resource` section. Thus, we can further condense our example configuration as follows:
ja: さらに、オプションの値が両方のホストで等しい場合は、直接 `resource` セクションで指定することができます。このため、設定例は次のように短くすることができます。

note: type: Title ====
en: Defining network connections
ja: ネットワークコネクションの定義

note: type: Plain text
en: Currently the communication links in DRBD 9 must build a full mesh, i.e. in every resource every node must have a direct connection to every other node (excluding itself, of course).
ja: 現時点では、DRBD9の通信リンクはフルメッシュである必要があります。つまり、全リソース全ノードが他の全ノードに直接のコネクションを持っている必要があります(当然、自ノードに対しては不要です)。

note: type: Plain text
en: For the simple case of two hosts `drbdadm` will insert the (single) network connection by itself, for ease of use and backwards compatibility.
ja: ホスト2台のシンプルな構成の場合、使い勝手と後方互換性のため、`drbdadm` は(1つの)ネットワークコネクションを自身で挿入します。

note: type: Plain text
en: The net effect of this is a quadratic number of network connections over hosts. For the "traditional" two nodes one connection is needed; for three hosts there are three node pairs; for four, six pairs; 5 hosts: 10 connections, and so on. For (the current)  maximum of 16 nodes there'll be 120 host pairs to connect.
ja: 必要なネットワークコネクション数はホスト数の二次関数です。"従来の"2ノードでは1コネクションが必要でしたが、3つのホストでは3対、4つのホストでは6対、5つのホストでは10対のコネクションが…というように必要になってきます。32ノードであれば496対のコネクションが必要になります。

note: type: Block title
en: Number of connections for _N_ hosts
ja: _N_ 個のホストの時のコネクション数

note: type: Plain text
en: An example configuration file for three hosts would be this:
ja: 以下は3つのホストでの設定ファイルの例です。

note: type: Plain text
en: If you have got enough network cards in your servers, you can create direct cross-over links between server pairs.  A single four-port ethernet card allows to have a single management interface, and to connect 3 other servers, to get a full mesh for 4 cluster nodes.
ja: サーバに十分なネットワークカードがあれば、サーバ間をクロスケーブルで直結できます。 1つ4ポートのイーサネットカードであれば、4ノードのフルメッシュにするために1つの管理インターフェースと3つの他サーバへの接続を行うことができます。

note: type: Plain text
en: In this case you can specify a different IP address to use the direct link:
ja: この場合には直接接続に異なるIPアドレスを指定することができます。

note: type: Plain text
en: For easier maintenance and debugging it's recommend to have different ports for each endpoint - looking at a `tcpdump` trace the packets can be associated easily.
ja: 管理とデバッグを容易にするため、エンドポイントごとに異なるポートを使用することをお勧めします。 `tcpdump` 使用の際にパケットの追跡が容易になります。

note: type: Plain text
en: The examples below will still be using two servers only; please see <<s-4node-example>> for a four-node example.
ja: 以下の例は2サーバのみで使用するものです。4ノードでの例は<<s-4node-example>>を参照ください。

note: type: Title ====
en: Configuring transport implementations
ja: トランスポートプロトコルの設定

note: type: Plain text
en: DRBD allows configuring multiple paths per connection, by introducing multiple path sections in a connection. Please see the following example:
ja: DRBD は、connection に複数の path セクションを使用することで、connection ごとに複数の path を構成できます。次の例を参照してください。

note: type: Plain text
en: Obviously the two endpoint hostname need to be equal in all paths of a connection. Paths may be on different IPs (potential different NICs)  or may only be on different ports.
ja: 2 つのエンドポイントホスト名は connection の path 内で同じである必要があります。path は異なる IP（潜在的に異なるNIC）上にある場合もあれば、異なるポート上のみである場合もあります。

note: type: Plain text
en: The TCP transport uses one path at a time. In case the backing TCP connections get dropped, or show timeouts, the TCP transport implementation tries to establish a connection over the next path. It goes over all paths in a round-robin fashion until a connection gets established.
ja: TCP トランスポートは、一度に1つの path を使用します。使用中の TCP 接続がダウンした場合、またはタイムアウトになった場合、次の path に接続を確立しようとします。接続が確立されるまで、ラウンドロビン方式ですべての path を試みます。

note: type: Plain text
en: The RDMA transport uses all paths of a connection concurrently and it balances the network traffic between the paths evenly.
ja: RDMA トランスポートは、connection のすべての path を同時に使用し、path 間のネットワークトラフィックを均等に分散します。

note: type: Plain text
en: DRBD supports multiple network transports. A transport implementation can be configured for each connection of a resource.
ja: DRBDは複数のネットワーク転送プロトコルに対応しています。 トランスポートプロトコルの設定はリソースの各コネクションごとに設定できます。

note: type: Plain text
en: `tcp` is the default transport. I.e. each connection that lacks a transport option uses the `tcp` transport.
ja: デフォルトは `tcp` です。トランスポートオプションを設定していない場合は `TCP` トランスポートが使用されます。

note: type: Plain text
en: The `tcp` transport can be configured with the net options: `sndbuf-size`, `rcvbuf-size`, `connect-int`, `sock-check-timeo`, `ping-timeo`, `timeout`.
ja: `tcp` トランスポートオプションでは次のnetオプションが設定できます。 `sndbuf-size` 、 `rcvbuf-size` 、 `connect-int` 、 ` sock-check-timeo` 、 `ping-timeo` 、 `timeout` 。

note: type: Plain text
en: The `rdma` transport can be configured with the net options: `sndbuf-size`, `rcvbuf-size`, `max_buffers`, `connect-int`, `sock-check-timeo`, `ping-timeo`, `timeout`.
ja: `rdma` トランスポートでは次のnetオプションが設定できます。 `sndbuf-size` 、 `rcvbuf-size` 、 `max_buffers` 、 `connect-int` 、 `sock-check-timeo` 、 `ping-timeo` 、 `timeout` 。

note: type: Plain text
en: The `rdma` transport is a zero-copy-receive transport. One implication of that is that the `max_buffers` configuration options must be set to a value big enough to hold all `rcvbuf-size`.
ja: `rdma` トランスポートはゼロコピーレシーブ転送です。その関係で、 `max_buffers` の設定オプションはすべての `rcvbuf-size` を保存するのに十分なサイズにする必要があります。

note: type: Plain text
en: `rcvbuf-size` is configured in bytes, while `max_buffers` is configured in pages. For optimal performance `max_buffers` should be big enough to hold all of `rcvbuf-size` and the amount of data that might be in flight to the backend device at any point in time.
ja: `rcvbuf-size` はバイト単位で設定しますが、 `max_buffers` はページ単位で設定します。パフォーマンス最適化のためには、 `max_buffers` はすべての `rcvbuf-size` と、下位デバイスとの間の全通信量を合わせたものよりも大きい必要があります。

note: type: Plain text
en: In case you are using InfiniBand HCAs with the `rdma` transport, you need to configure IPoIB as well. The IP address is not used for data transfer, but it is used to find the right adapters and ports while establishing the connection.
ja: InfiniBand HCAで `rdma` トランスポートを使っている場合、IPoIBも設定する必要があります。IPアドレスはデータ転送では使用しませんが、コネクションを確立する際に正しいアダプタとポートを見つけるために使用します。

note: type: Plain text
en: The configuration options `sndbuf-size`, `rcvbuf-size` are only considered at the time a connection is established. I.e. you can change them while the connection is established. They will take effect in the moment the connection is re-established.
ja: 設定オプションの `sndbuf-size` と `rcvbuf-size` はコネクションが確立される時に考慮されます。つまり、接続が確立している時は変更する事ができますが、その変更が反映されるのは、再接続後になります。

note: type: Title =====
en: Performance considerations for RDMA
ja: RDMAのパフォーマンスにおける考慮事項

note: type: Plain text
en: By looking at the pseudo file _/sys/kernel/debug/drbd/<resource>/connections/<peer>/transport_, the counts of available receive descriptors (rx_desc) and transmit descriptors (tx_desc)  can be monitored. In case one of the descriptor kinds becomes depleted you should increase `sndbuf-size` or `rcvbuf-size`.
ja: 擬似ファイル/sys/kernel/debug/drbd/<リソース>/connections/<対向ノード>/transportを見れば、使用可能な受信識別子(rx_desc)と送信識別子(tx_desc)の数を監視できます。識別子が枯渇した場合には `sndbuf-size` または `rcvbuf-size` を増やす必要があります。

note: type: Title ====
en: Enabling your resource for the first time
ja: リソースを初めて有効にする

note: type: Plain text
en: After you have completed initial resource configuration as outlined in the previous sections, you can bring up your resource.
ja: すでに述べた手順に従って最初のリソース設定を完了したら、リソースを稼働させます。

note: type: Plain text
en: Each of the following steps must be completed on both nodes.
ja: 両方のノードに対して、次の手順を行います。

note: type: Plain text
en: Please note that with our example config snippets (`resource r0 { ... }`), `<resource>` would be `r0`.
ja: さきほどの構成例( `resource r0{ … }` )では、 `<resource>` は `r0` となります。

note: type: Block title
en: Create device metadata
ja: メタデータを作成する

note: type: Plain text
en: This step must be completed only on initial device creation. It initializes DRBD's metadata:
ja: この手順は、最初にデバイスを作成するときにのみ必要です。これにより、DRBDのメタデータを初期化します。

note: type: Plain text
en: Please note that the number of bitmap slots that are allocated in the meta-data depends on the number of hosts for this resource; per default the hosts in the resource configuration are counted.  If all hosts are specified _before_ creating the meta-data, this will "just work"; adding bitmap slots for further nodes is possible later, but incurs some manual work.
ja: メタデータに割り当てられるビットマップスロットの数はリソースのホストの数に依存します。 デフォルトではリソース設定のホストの数をカウントします。 メタデータの作成前にすべてのホストが指定されていれば、そのまま動作します。後から追加ノード用のビットマップを付け足すことも可能ですが、手動での作業が必要になります。

note: type: Block title
en: Enable the resource
ja: リソースを有効にする

note: type: Plain text
en: This step associates the resource with its backing device (or devices, in case of a multi-volume resource), sets replication parameters, and connects the resource to its peer:
ja: これにより、リソースとその下位デバイス(マルチボリュームリソースの場合は、すべてのデバイス)とを結びつけます。また、対向ノードのリソースと接続します。

note: type: Block title
en: Observe the status via `drbdadm status`
ja: `drbdadm status` でステータスを確認する

note: type: Plain text
en: ``drbdsetup``'s status output should now contain information similar to the following:
ja: `drbdsetup` のステータス出力は次のような情報を表示します。

note: type: Plain text
en: The _Inconsistent/Inconsistent_ disk state is expected at this point.
ja: この時点では `Inconsistent/Inconsistent` のディスク状態になっているはずです。

note: type: Plain text
en: By now, DRBD has successfully allocated both disk and network resources and is ready for operation. What it does not know yet is which of your nodes should be used as the source of the initial device synchronization.
ja: これで、DRBDがディスクリソースとネットワークリソースに正しく割り当てられ、稼働できるようになりました。次に、どちらのノードをデバイスの初期同期のソースとして使用するか指定する必要があります。

note: type: Title ====
en: The initial device synchronization
ja: デバイスの初期同期

note: type: Plain text
en: There are two more steps required for DRBD to become fully operational:
ja: DRBDを完全に機能させるには、さらに次の2つの手順が必要です。

note: type: Block title
en: Select an initial sync source
ja: 同期元を選択する

note: type: Plain text
en: If you are dealing with newly-initialized, empty disks, this choice is entirely arbitrary. If one of your nodes already has valuable data that you need to preserve, however, _it is of crucial importance_ that you select that node as your synchronization source.  If you do initial device synchronization in the wrong direction, you will lose that data. Exercise caution.
ja: 新しく初期化した空のディスクを使用する場合は、任意のディスクを同期元にできます。いずれかのノードにすでに重要なデータが格納されている場合は、 _十分注意して、必ず_ そのノードを同期元として選択してください。デバイスの初期同期の方向が誤っていると、データを失うおそれがあります。慎重に行ってください。

note: type: Block title
en: Start the initial full synchronization
ja: 初期フル同期を開始する

note: type: Plain text
en: This step must be performed on only one node, only on initial resource configuration, and only on the node you selected as the synchronization source. To perform this step, issue this command:
ja: この手順は、最初のリソース設定の際に、同期ソースとして選択した1つのノードに対してのみ実行します。次のコマンドで実行します。

note: type: Plain text
en: After issuing this command, the initial full synchronization will commence. You will be able to monitor its progress via `drbdadm status`. It may take some time depending on the size of the device.
ja: このコマンドを指定すると、初期フル同期が開始します。 `drbdadm status` で同期の進行状況を監視できます。デバイスのサイズによっては、同期に時間がかかる場合があります。

note: type: Plain text
en: By now, your DRBD device is fully operational, even before the initial synchronization has completed (albeit with slightly reduced performance). If you started with empty disks you may now already create a filesystem on the device, use it as a raw block device, mount it, and perform any other operation you would with an accessible block device.
ja: この時点で、初期同期が完了していなくてもDRBDデバイスは完全に稼働します(ただし、パフォーマンスは多少低いです)。空のディスクから開始した場合は、デバイスにファイルシステムを作成してもかまいません。これを下位ブロックデバイスとして使用し、マウントして、アクセス可能なブロックデバイスとしてさまざまな操作を実行することができます。

note: type: Plain text
en: You will now probably want to continue with <<p-work>>, which describes common administrative tasks to perform on your resource.
ja: リソースに対して一般的な管理タスクを行う場合は、<<p-work>>に進んでください。

note: type: Title ====
en: Skipping initial resynchronization
ja: 初期同期のスキップ

note: type: Plain text
en: If (and only if) you are starting DRBD resources from scratch (with no valueable data on them) you can use following command sequence to skip initial resync (don't do that with data you want to keep on the devices):
ja: DRBD リソースを最初から開始する場合（貴重なデータがない場合のみ）、次のコマンドシーケンスを使用して、最初の同期をスキップできます（デバイスにデータを保存する場合は実行しないでください）。

note: type: Plain text
en: On all nodes:
ja: すべてのノードで次のコマンドを実行します。

note: type: Plain text
en: The command `drbdadm status` should now show all disks as _Inconsistent_.
ja: コマンド `drbdadm status` は、すべてのディスクを _Inconsistent_ として表示するはずです。

note: type: Plain text
en: Then, on one node execute the following command:
ja: 次に１つのノードで次のコマンドを実行します。

note: type: Plain text
en: or
ja: または

note: type: Plain text
en: Running `drbdadm status` now shows the disks as _UpToDate_ (even tough the backing devices might be out of sync). You can now create a file system on the disk and start using it.
ja: その後 `drbdadm status` を実行すると、ディスクが _UpToDate_ として表示されるようになります（下位デバイスが同期していない場合でも）。これでディスク上にファイルシステムを作成し、使用を開始できます。

note: type: Plain text
en: Don't do the above with data you want to keep or it gets corrupted.
ja: データを保存したい場合は使用しないでください。データが壊れます。

note: type: Title ====
en: Using truck based replication
ja: トラックベースのレプリケーションの使用

note: type: Plain text
en: In order to preseed a remote node with data which is then to be kept synchronized, and to skip the initial full device synchronization, follow these steps.
ja: リモートノードに同期するデータを前もってロードし、デバイスの初期同期をスキップする場合は、次の手順を行います。

note: type: Plain text
en: This assumes that your local node has a configured, but disconnected DRBD resource in the _Primary_ role.  That is to say, device configuration is completed, identical `drbd.conf` copies exist on both nodes, and you have issued the commands for <<s-initial-full-sync,initial resource promotion>> on your local node
ja: 初期設定済みで `プライマリ` に昇格し、相手ノードとの接続を切断した状態のDRBDリソースが必要です。つまり、デバイスの設定が完了し、両方のノードに同一の `drbd.conf` のコピーが存在し <<s-initial-full-sync,最初のリソース昇格>>をローカルノードで実行するコマンドを発行した後、

note: type: Plain text
en: but the remote node is not connected yet.
ja: リモートノードがまだ接続されていない状態です。

note: type: Plain text
en: On the local node, issue the following command:
ja: ローカルノードで次のコマンドを実行します。

note: type: Plain text
en: Create a consistent, verbatim copy of the resource's data _and its metadata_. You may do so, for example, by removing a hot-swappable drive from a RAID-1 mirror.  You would, of course, replace it with a fresh drive, and rebuild the RAID set, to ensure continued redundancy. But the removed drive is a verbatim copy that can now be shipped off site.  If your local block device supports snapshot copies (such as when using DRBD on top of LVM), you may also create a bitwise copy of that snapshot using `dd`.
ja: リソースのデータ _およびそのメタデータ_ の正確に同一のコピーを作成します。 たとえば、ホットスワップ可能な RAID-1ドライブの一方を抜き取ります。この場合は、もちろん 新しいドライブをセットしてRAIDセットを再構築しておくべきでしょう。 抜き取ったドライブは、正確なコピーとして リモートサイトに移動できます。別の方法としては、ローカルのブロックデバイスがスナップショットコピーをサポートする場合 (LVMの上位でDRBDを使用する場合など)は、 `dd` を使用してスナップショットのビット単位のコピーを作ってもかまいません。

note: type: Plain text
en: On the local node, issue:
ja: ローカルノードで次のコマンドを実行します。

note: type: Plain text
en: or the matching `drbdsetup` command.
ja: または `drbdsetup` コマンドを使用します。

note: type: Plain text
en: Note the absence of the `--clear-bitmap` option in this second invocation.
ja: この2回目のコマンドには `--clear-bitmap` がありません。

note: type: Plain text
en: Physically transport the copies to the remote peer location.
ja: 対向ホストの設置場所にコピーを物理的に移動します。

note: type: Plain text
en: Add the copies to the remote node. This may again be a matter of plugging a physical disk, or grafting a bitwise copy of your shipped data onto existing storage on the remote node.  Be sure to restore or copy not only your replicated data, but also the associated DRBD metadata. If you fail to do so, the disk shipping process is moot.
ja: コピーをリモートノードに追加します。ここでも物理ディスクを接続するか、リモートノードの既存のストレージに移動したデータのビット単位のコピーを追加します。レプリケートしたデータだけでなく、関連するDRBDメタデータも必ず復元するかコピーしてください。そうでない場合、ディスクの移動を正しく行うことができません。

note: type: Plain text
en: On the new node we need to fix the node ID in the meta data, and exchange the peer-node info for the two nodes. Please see the following lines as example for changing node id from 2 to 1 on a resource `r0` volume `0`.
ja: 新しいノードでメタデータのノードIDを修正し、2つのノード間で対向ノードの情報を交換する必要があります。リソース `r0` ボリューム `0` 上でnode idを2から1に変更するには、次の行を参照ください。

note: type: Plain text
en: This must be done while the volume is not in use.
ja: これはボリュームが未使用中のときに実行する必要があります。

note: type: Plain text
en: You need to edit the first 4 lines to match your needs. V is the resource name with the volume number. NODE_FROM is the node ID of the node the data originates from. NOTE_TO is the node ID of the node where data will be replicated to. META_DATA_LOCATION is the location of the meta data which might be internal or flex-external.
ja: 最初の4行は環境に合わせて変更します。V は、ボリューム番号を持つリソース名です。 NODE_FROM は、データの発信元のノードのノード ID です。NOTE_TO は、データが複製されるノードのノード ID です。META_DATA_LOCATION はメタデータの場所で internal または flex-external のどちらかです。

note: type: Plain text
en: `drbdmeta` before 8.9.7 cannot cope with out-of-order `peer` sections; you'll need to exchange the blocks via an editor.
ja: バージョン 8.9.7 以前の `drbdmeta` 順不同の対向ノードセクションを扱えません。エディタを用いてブロックを交換する必要があります。

note: type: Plain text
en: Bring up the resource on the remote node:
ja: リモートノードで次のコマンドを実行します。

note: type: Plain text
en: After the two peers connect, they will not initiate a full device synchronization. Instead, the automatic synchronization that now commences only covers those blocks that changed since the invocation of `drbdadm{nbsp}--clear-bitmap{nbsp}new-current-uuid`.
ja: 2つのホストを接続しても、デバイスのフル同期は開始されません。代わりに、 `drbdadm{nbsp}--clear-bitmap{nbsp}new-current-uuid` の呼び出し以降に変更されたブロックのみを対象とする自動同期が開始されます。

note: type: Plain text
en: Even if there were _no_ changes whatsoever since then, there may still be a brief synchronization period due to areas covered by the <<s-activity-log,Activity Log>> being rolled back on the new Secondary. This may be mitigated by the use of <<p-checksum-sync,checksum-based synchronization>>.
ja: 以降、データの変更が _全くない_ 場合でも、セカンダリで<<s-activity-log,アクティビティログ>>を含む領域がロールバックされるため、同期が短時間行われることがあります。これは<<p-checksum-sync,チェックサムベースの同期>>を使用することで緩和されます。

note: type: Plain text
en: You may use this same procedure regardless of whether the resource is a regular DRBD resource, or a stacked resource. For stacked resources, simply add the `-S` or `--stacked` option to `drbdadm`.
ja: この手順は、リソースが通常のDRBDリソースの場合でもスタックリソースの場合でも使用できます。スタックリソースの場合は、 `-S` または `--stacked` オプションを `drbdadm` に追加します。

note: type: Title ====
en: Example configuration for four nodes
ja: 4ノードでの構成例

note: type: Plain text
en: Here is an example for a four-node cluster.
ja: 以下は4ノードクラスタの例です。

note: type: Plain text
en: In case you want to see the `connection-mesh` configuration expanded, try `drbdadm dump _<resource>_ -v`.
ja: `connection-mesh` 設定を確認したい場合には `drbdadm dump <resource> -v` を実行します。

note: type: Plain text
en: As another example, if the four nodes have enough interfaces to provide a complete mesh via direct linksfootnote:[i.e. three crossover and at least one outgoing/management interface], you can specify the IP addresses of the interfaces:
ja: 別の例として、4ノードに直接接続でフルメッシュにできるだけのインターフェースがある場合には、footnote:[例:3つのノード間接続用と最低1つの外部接続/管理用インターフェース]インターフェースにIPアドレスを指定することができます。

note: type: Plain text
en: Please note the numbering scheme used for the IP addresses and ports. Another resource could use the same IP addresses, but ports `71__xy__`, the next one `72__xy__`, and so on.
ja: IPアドレスやポート番号の付け方には注意してください。別のリソースであれば同じIPアドレスを使用することができますが、 71xy、72xy のようにずらしてください。
