レプリケーションの設定および管理

手順

1. dc=example,dc=com 接尾辞のレプリケーションを有効にします。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com replication enable --suffix "dc=example,dc=com" --role "supplier" --replica-id 1

   このコマンドは、supplier.example.com ホストを dc=example,dc=com 接尾辞のサプライヤーとして設定し、このエントリーのレプリカ ID を 1 に設定します。

   重要

   トポロジー内のすべてのサプライヤーの接尾辞については、レプリカ ID は 1 から 65534 の間の一意の整数である必要があります。

2. レプリカ合意を追加し、コンシューマーを初期化します。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com repl-agmt create --suffix "dc=example,dc=com" --host "consumer.example.com" --port 389 --conn-protocol=LDAP --bind-dn "cn=replication manager,cn=config" --bind-passwd "password" --bind-method=SIMPLE --init example-agreement

   このコマンドは、example-agreement という名前のレプリカ合意を作成します。レプリカ合意は、コンシューマーのホスト名、プロトコル、このコンシューマーへのデータの接続や複製時にサプライヤーが使用する認証情報などの設定を定義します。

   この合意の作成後、Directory Server は consumer.example.com を初期化します。複製するデータ量によっては、初期化に時間がかかる場合があります。

検証

1. レプリケーション設定を表示します。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com replication get --suffix "dc=example,dc=com"
   dn: cn=replica,cn=dc\3Dexample\2Cdc\3Dcom,cn=mapping tree,cn=config
   ...
   nsDS5ReplicaRoot: dc=example,dc=com
   nsDS5ReplicaType: 3
   ...

   これらのパラメーターは以下を示しています。

   • nsDS5ReplicaRoot は、レプリケートされる接尾辞を設定します。
   • nsDS5ReplicaType を 3 に設定して、このホストがサプライヤーであることを定義します。

2. 初期化が成功したかどうかを確認します。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com repl-agmt init-status --suffix "dc=example,dc=com" example-agreement
   Agreement successfully initialized.

3. レプリケーションのステータスを表示します。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com repl-agmt status --suffix "dc=example,dc=com" example-agreement
   Status For Agreement: "example-agreement" (consumer.example.com:389)
   Replica Enabled: on
   Update In Progress: FALSE
   Last Update Start: 20210330075608Z
   Last Update End: 20210330075608Z
   Number Of Changes Sent: 1:3/0
   Number Of Changes Skipped: None
   Last Update Status: Error (0) Replica acquired successfully: Incremental update succeeded
   Last Init Start: 20210330074603Z
   Last Init End: 20210330074606Z
   Last Init Status: Error (0) Total update succeeded
   Reap Active: 0
   Replication Status: Not in Synchronization: supplier (6062d73c000000010000) consumer (Unavailable) State (green) Reason (error (0) replica acquired successfully: incremental update succeeded)
   Replication Lag Time: Unavailable

   Replication Status フィールドおよび Last Update Status フィールドを確認します。

トラブルシューティング

1. デフォルトでは、サーバー上のすべての合意に対するレプリケーションアイドルタイムアウトは 1 時間です。タイムアウトが原因で大規模なデータベースの初期化が失敗する場合は、nsslapd-idletimeout パラメーターをより高い値に設定します。たとえば、パラメーターを 7200(2 時間) に設定するには、次のコマンドを実行します。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com config replace nsslapd-idletimeout=7200

   無制限の期間を設定するには、nsslapd-idletimeout を 0 に設定します。

手順

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。
3. Enable Replication をクリックします。

4. Replication Role フィールドで Consumer を選択し、作成するレプリケーションマネージャーアカウントおよびパスワードを入力します。

   

   この設定により、ホストを dc=example,dc=com 接尾辞のコンシューマーとして設定します。さらに、サーバーは指定のパスワードで cn=replication manager,cn=config ユーザーを作成し、このアカウントがこのホストに接尾辞の変更を複製することができます。

5. Enable Replication をクリックします。

検証

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。
3. Replica Role フィールドに値 Consumer が含まれている場合、レプリケーションが有効になり、ホストがコンシューマーとして設定されます。

手順

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。

3. レプリケーションを有効にします。

   1. Enable Replication をクリックします。

   2. Replication Role フィールドで Supplier を選択し、レプリカ ID、レプリケーションマネージャーの認証情報を入力して、Bind Group DN フィールドを空のままにします。

      

      この設定により、ホストを dc=example,dc=com 接尾辞のサプライヤーとして設定し、このエントリーのレプリカ ID を 1 に設定します。

      重要

      トポロジー内のすべてのサプライヤーの接尾辞については、レプリカ ID は 1 から 65534 の間の一意の整数である必要があります。

   3. Enable Replication をクリックします。

4. レプリカ合意を追加し、コンシューマーを初期化します。

   1. Agreements タブで、Create Agreement をクリックし、次のフィールドに入力します。

      

      この設定により、example-agreement という名前のレプリカ合意が作成されます。レプリカ合意は、コンシューマーのホスト名、プロトコル、このコンシューマーへのデータの接続や複製時にサプライヤーが使用する認証情報などの設定を定義します。

   2. Consumer Initialization フィールドで Do Online Initialization を選択し、合意の保存後にコンシューマーを自動的に初期化します。

   3. Save Agreement をクリックします。

      この合意の作成後、Directory Server は consumer.example.com を初期化します。複製するデータ量によっては、初期化に時間がかかる場合があります。

検証

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。

3. Agreements タブで、テーブルの State 列での契約のステータスを確認。

   

手順

1. dc=example,dc=com 接尾辞のレプリケーションを有効にします。

   # dsconf -D "cn=Directory Manager" ldap://supplier1.example.com replication enable --suffix "dc=example,dc=com" --role "supplier" --replica-id 2 --bind-dn "cn=replication manager,cn=config" --bind-passwd "password"

   このコマンドは、supplier1.example.com ホストを dc=example,dc=com 接尾辞のサプライヤーとして設定し、このエントリーのレプリカ ID を 2 に設定します。また、このコマンドは、指定したパスワードを持つ cn=replication manager,cn=config ユーザーを作成し、このアカウントが接尾辞の変更をこのホストに複製するのを許可します。

   重要

   トポロジー内のすべてのサプライヤーの接尾辞については、レプリカ ID は 1 から 65534 の間の一意の整数である必要があります。

2. レプリカ合意を追加し、新規サーバーを初期化します。

   # dsconf -D "cn=Directory Manager" ldap://supplier1.example.com repl-agmt create --suffix "dc=example,dc=com" --host "supplier2.example.com" --port 389 --conn-protocol LDAP --bind-dn "cn=replication manager,cn=config" --bind-passwd "password" --bind-method SIMPLE --init example-agreement-supplier1-to-supplier2

   このコマンドは、example-agreement-supplier1-to-supplier2 という名前のレプリカ合意を作成します。レプリカ合意は、新規サプライヤーのホスト名、プロトコル、新規サプライヤーへのデータの接続や複製時にサプライヤーが使用する認証情報などの設定を定義します。

   この合意の作成後、Directory Server は supplier2.example.com を初期化します。複製するデータ量によっては、初期化に時間がかかる場合があります。

検証

1. レプリケーション設定を表示します。

   # dsconf -D "cn=Directory Manager" ldap://supplier1.example.com replication get --suffix "dc=example,dc=com"
   dn: cn=replica,cn=dc\3Dexample\2Cdc\3Dcom,cn=mapping tree,cn=config
   ...
   nsDS5ReplicaBindDN: cn=replication manager,cn=config
   nsDS5ReplicaRoot: dc=example,dc=com
   nsDS5ReplicaType: 3
   ...

   これらのパラメーターは以下を示しています。

   • nsDS5ReplicaBindDN はレプリケーションマネージャーアカウントを指定します。
   • nsDS5ReplicaRoot は、レプリケートされる接尾辞を設定します。
   • nsDS5ReplicaType を 3 に設定して、このホストがサプライヤーであることを定義します。

2. 初期化が成功したかどうかを確認します。

   # dsconf -D "cn=Directory Manager" ldap://supplier1.example.com repl-agmt init-status --suffix "dc=example,dc=com" example-agreement-supplier1-to-supplier2
   Agreement successfully initialized.

3. レプリケーションのステータスを表示します。

   # dsconf -D "cn=Directory Manager" ldap://supplier1.example.com repl-agmt status --suffix "dc=example,dc=com" example-agreement-supplier1-to-supplier2
   Status For Agreement: "example-agreement-supplier1-to-supplier2" (supplier2.example.com:389)
   Replica Enabled: on
   Update In Progress: FALSE
   Last Update Start: 20210331071545Z
   Last Update End: 20210331071546Z
   Number Of Changes Sent: 2:1/0
   Number Of Changes Skipped: None
   Last Update Status: Error (0) Replica acquired successfully: Incremental update succeeded
   Last Init Start: 20210331071541Z
   Last Init End: 20210331071544Z
   Last Init Status: Error (0) Total update succeeded
   Reap Active: 0
   Replication Status: Not in Synchronization: supplier (6064219e000100020000) consumer (Unavailable) State (green) Reason (error (0) replica acquired successfully: incremental update succeeded)

   Replication Status フィールドおよび Last Update Status フィールドを確認します。

トラブルシューティング

1. デフォルトでは、サーバー上のすべての合意に対するレプリケーションアイドルタイムアウトは 1 時間です。タイムアウトが原因で大規模なデータベースの初期化が失敗する場合は、nsslapd-idletimeout パラメーターをより高い値に設定します。たとえば、パラメーターを 7200(2 時間) に設定するには、次のコマンドを実行します。

   # dsconf -D "cn=Directory Manager" ldap://supplier1.example.com config replace nsslapd-idletimeout=7200

   無制限の期間を設定するには、nsslapd-idletimeout を 0 に設定します。

検証

1. 合意のステータスを表示します。

   # dsconf -D "cn=Directory Manager" ldap://supplier2.example.com repl-agmt init-status --suffix "dc=example,dc=com" example-agreement-supplier2-to-supplier1
   Agreement successfully initialized.

2. レプリケーションのステータスを表示します。

   # dsconf -D "cn=Directory Manager" ldap://supplier2.example.com repl-agmt status --suffix "dc=example,dc=com" example-agreement-supplier2-to-supplier1
   Status For Agreement: ""example-agreement-supplier2-to-supplier1 (supplier1.example.com:389)
   Replica Enabled: on
   Update In Progress: FALSE
   Last Update Start: 20210331073540Z
   Last Update End: 20210331073540Z
   Number Of Changes Sent: 7:1/0
   Number Of Changes Skipped: None
   Last Update Status: Error (0) Replica acquired successfully: Incremental update succeeded
   Last Init Start: 20210331073535Z
   Last Init End: 20210331073539Z
   Last Init Status: Error (0) Total update succeeded
   Reap Active: 0
   Replication Status: Not in Synchronization: supplier (60642649000000070000) consumer (Unavailable) State (green) Reason (error (0) replica acquired successfully: incremental update succeeded)
   Replication Lag Time: Unavailable

   Replication Status フィールドおよび Last Update Status フィールドを確認します。

トラブルシューティング

1. デフォルトでは、サーバー上のすべての合意に対するレプリケーションアイドルタイムアウトは 1 時間です。タイムアウトが原因で大規模なデータベースの初期化が失敗する場合は、nsslapd-idletimeout パラメーターをより高い値に設定します。たとえば、パラメーターを 7200(2 時間) に設定するには、次のコマンドを実行します。

   # dsconf -D "cn=Directory Manager" ldap://supplier2.example.com config replace nsslapd-idletimeout=7200

   無制限の期間を設定するには、nsslapd-idletimeout を 0 に設定します。

手順

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。

3. レプリケーションを有効にします。

   1. Enable Replication をクリックします。

   2. Replication Role フィールドで Supplier を選択し、レプリカ ID を入力し、作成するレプリケーションマネージャーアカウントの識別名 (DN) およびパスワードを入力します。

      

      この設定により、ホストを dc=example,dc=com 接尾辞のサプライヤーとして設定し、このエントリーのレプリカ ID を 1 に設定します。

      重要

      トポロジー内のすべてのサプライヤーの接尾辞については、レプリカ ID は 1 から 65534 の間の一意の整数である必要があります。

      レプリケーションマネージャー DN を設定しない場合は、バインドグループ DN を設定します。その後、レプリカ合意でこのグループの任意のメンバーを使用できます。

   3. Enable Replication をクリックします。

検証

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。
3. Replica Role フィールドに値 Supplier が含まれている場合、レプリケーションが有効になり、ホストがサプライヤーとして設定されます。

手順

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。

3. レプリケーションを有効にします。

   1. Enable Replication をクリックします。

   2. Replication Role フィールドで Supplier を選択し、レプリカ ID を入力し、作成するレプリケーションマネージャーアカウントの識別名 (DN) およびパスワードを入力します。

      

      この設定により、ホストを dc=example,dc=com 接尾辞のサプライヤーとして設定し、このエントリーのレプリカ ID を 2 に設定します。

      重要

      トポロジー内のすべてのサプライヤーの接尾辞については、レプリカ ID は 1 から 65534 の間の一意の整数である必要があります。

   3. Enable Replication をクリックします。

4. レプリカ合意を追加し、新規サーバーを初期化します。

   1. Agreements タブで、Create Agreement をクリックし、次のフィールドに入力します。

      

      この設定により、example-agreement-supplier1-to-supplier2 という名前のレプリカ合意が作成されます。レプリカ合意は、新規サプライヤーのホスト名、プロトコル、新規サプライヤーへのデータの接続や複製時にサプライヤーが使用する認証情報などの設定を定義します。

   2. Consumer Initialization フィールドで Do Online Initialization を選択し、合意の保存後に新規サーバーを自動的に初期化します。

   3. Save Agreement をクリックします。

      この合意の作成後、Directory Server は supplier2.example.com を初期化します。複製するデータ量によっては、初期化に時間がかかる場合があります。

検証

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。

3. Agreements タブで、テーブルの State 列での契約のステータスを確認。

   

手順

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。

3. レプリカ合意を追加し、既存のサーバーを初期化します。

   1. Agreements タブで、Create Agreement をクリックし、次のフィールドに入力します。

      

      この設定により、example-agreement-supplier2-to-supplier1 という名前のレプリカ合意が作成されます。レプリカ合意は、既存サーバーのホスト名、プロトコル、既存サプライヤーへのデータの接続や複製時にサプライヤーが使用する認証情報などの設定を定義します。

   2. Consumer Initialization フィールドで Do Online Initialization を選択し、合意の保存後に新規サーバーを自動的に初期化します。

   3. Save Agreement をクリックします。

      この合意の作成後、Directory Server は supplier1.example.com を初期化します。複製するデータ量によっては、初期化に時間がかかる場合があります。

検証

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。

3. Agreements タブで、テーブルの State 列での契約のステータスを確認。

   

手順

1. ou=services エントリーが存在しない場合は作成します。

   # ldapadd -D "cn=Directory Manager" -W -H ldaps://server1.example.com -x
   
   dn: ou=services,dc=example,dc=com
   objectClass: organizationalunit
   objectClass: top
   ou: services

2. cn=server1,ou=services,dc=example,dc=com および cn=server1,ou=services,dc=example,dc=com など、両方のサーバーのアカウントを作成します。

   # ldapadd -D "cn=Directory Manager" -W -H ldaps://server1.example.com -x
   
   dn: cn=server1,ou=services,dc=example,dc=com
   objectClass: top
   objectClass: person
   objectClass: inetOrgPerson
   sn: server1
   cn: server1
   userPassword: password
   userCertificate:< file:///root/server1.der
   
   adding new entry "cn=server1,ou=services,dc=example,dc=com"
   
   dn: cn=server2,ou=services,dc=example,dc=com
   objectClass: top
   objectClass: person
   objectClass: inetOrgPerson
   sn: server2
   cn: server2
   userPassword: password
   userCertificate:< file:///root/server2.der
   
   adding new entry "cn=server2,ou=services,dc=example,dc=com"

3. cn=repl_servers,dc=groups,dc=example,dc=com などのグループを作成します。

   # dsidm -D "cn=Directory Manager" ldaps://server1.example.com -b "dc=example,dc=com" group create --cn "repl_servers"

4. 2 つのレプリケーションアカウントをメンバーとしてグループに追加します。

   # dsidm -D "cn=Directory Manager" ldaps://server1.example.com -b "dc=example,dc=com" group add_member repl_servers "cn=server1,ou=services,dc=example,dc=com"
   
   # dsidm -D "cn=Directory Manager" ldaps://server1.example.com -b "dc=example,dc=com" group add_member repl_servers "cn=server2,ou=services,dc=example,dc=com"

手順

1. server2.example.com で、dc=example,dc=com 接尾辞のレプリケーションを有効にします。

   # dsconf -D "cn=Directory Manager" ldaps://server2.example.com replication enable --suffix "dc=example,dc=com" --role "supplier" --replica-id 2 --bind-dn "cn=replication manager,cn=config" --bind-passwd "password"

   このコマンドは、server2.example.com ホストを dc=example,dc=com 接尾辞のサプライヤーとして設定し、このホストのレプリカ ID を 2 に設定します。さらに、このコマンドは、指定されたパスワードで一時的な cn=replication manager,cn=config ユーザーを作成し、このアカウントが接尾辞の変更をこのホストに複製できるようにします。

   トポロジー内のすべてのサプライヤーにわたって、1 つの接尾辞に対するレプリカ ID は 1 から 65534 の間の一意の整数である必要があります。

2. server1.example.com 上で:

   1. レプリケーションを有効にします。

      # dsconf -D "cn=Directory Manager" ldaps://server1.example.com replication enable --suffix="dc=example,dc=com" --role="supplier" --replica-id="1"

   2. 認証用に直前の手順で一時的なアカウントを使用する一時的なレプリカ合意を作成します。

      # dsconf -D "cn=Directory Manager" ldaps://server1.example.com repl-agmt create --suffix="dc=example,dc=com" --host="server1.example.com" --port=636 --conn-protocol=LDAPS --bind-dn="cn=Replication Manager,cn=config" --bind-passwd="password" --bind-method=SIMPLE --init temporary_agreement

検証

1. 初期化が成功したことを確認します。

   # dsconf -D "cn=Directory Manager" ldaps://server1.example.com repl-agmt init-status --suffix "dc=example,dc=com" temporary_agreement
   Agreement successfully initialized.

手順

1. server1.example.com 上で:

   1. 一時的なレプリカ合意を削除します。

      # dsconf -D "cn=Directory Manager" ldaps://server1.example.com repl-agmt delete --suffix="dc=example,dc=com" temporary_agreement

   2. cn=repl_servers,dc=groups,dc=example,dc=com バインドグループをレプリケーション設定に追加します。

      # dsconf -D "cn=Directory Manager" ldaps://server1.example.com replication set --suffix="dc=example,dc=com" --repl-bind-group "cn=repl_servers,dc=groups,dc=example,dc=com"

   3. バインドグループの変更を自動的にチェックするように Directory Server を設定します。

      # dsconf -D "cn=Directory Manager" ldaps://server1.example.com replication set --suffix="dc=example,dc=com" --repl-bind-group-interval=0

2. server2.example.com 上で:

   1. 一時的なレプリケーションマネージャーアカウントを削除します。

      # dsconf -D "cn=Directory Manager" ldaps://server2.example.com replication delete-manager --suffix="dc=example,dc=com" --name="Replication Manager"

   2. cn=repl_servers,dc=groups,dc=example,dc=com バインドグループをレプリケーション設定に追加します。

      # dsconf -D "cn=Directory Manager" ldaps://server2.example.com replication set --suffix="dc=example,dc=com" --repl-bind-group "cn=repl_servers,dc=groups,dc=example,dc=com"

   3. バインドグループの変更を自動的にチェックするように Directory Server を設定します。

      # dsconf -D "cn=Directory Manager" ldap://server2.example.com replication set --suffix="dc=example,dc=com" --repl-bind-group-interval=0

   4. 証明書ベースの認証を使用して複製合意を作成します。

      dsconf -D "cn=Directory Manager" ldaps://server2.example.com repl-agmt create --suffix="dc=example,dc=com" --host="server1.example.com" --port=636 --conn-protocol=LDAPS --bind-method="SSLCLIENTAUTH" --init server2-to-server1

3. server1.example.com で、証明書ベースの認証を使用して複製合意を作成します。

   dsconf -D "cn=Directory Manager" ldaps://server1.example.com repl-agmt create --suffix="dc=example,dc=com" --host="server2.example.com" --port=636 --conn-protocol=LDAPS --bind-method="SSLCLIENTAUTH" --init server1-to-server2

検証

1. 初期化が成功したことを各サーバーで確認します。

   # dsconf -D "cn=Directory Manager" ldaps://server1.example.com repl-agmt init-status --suffix "dc=example,dc=com" server1-to-server2
   Agreement successfully initialized.
   
   # dsconf -D "cn=Directory Manager" ldaps://server2.example.com repl-agmt init-status --suffix "dc=example,dc=com" server2-to-server1
   Agreement successfully initialized.

手順

1. dc=example,dc=com 接尾辞のレプリケーションを有効にします。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com replication enable --suffix "dc=example,dc=com" --role "supplier" --replica-id 1

   このコマンドは、supplier.example.com ホストを dc=example,dc=com 接尾辞のサプライヤーとして設定し、このエントリーのレプリカ ID を 1 に設定します。

   重要

   トポロジー内のすべてのサプライヤーの接尾辞については、レプリカ ID は 1 から 65534 の間の一意の整数である必要があります。

2. レプリカ合意を追加し、新規サーバーを初期化します。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com repl-agmt create --suffix "dc=example,dc=com" --host "hub.example.com" --port 389 --conn-protocol LDAP --bind-dn "cn=replication manager,cn=config" --bind-passwd "password" --bind-method SIMPLE --init example-agreement-supplier-to-hub

   このコマンドは、example-agreement-supplier-to-hub という名前のレプリカ合意を作成します。レプリカ合意は、ハブのホスト名、プロトコル、ハブへのデータの接続や複製時にサプライヤーが使用する認証情報などの設定を定義します。

   この合意の作成後、Directory Server は hub.example.com を初期化します。複製するデータ量によっては、初期化に時間がかかる場合があります。

検証

1. レプリケーション設定を表示します。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com replication get --suffix "dc=example,dc=com"
   dn: cn=replica,cn=dc\3Dexample\2Cdc\3Dcom,cn=mapping tree,cn=config
   ...
   nsDS5ReplicaRoot: dc=example,dc=com
   nsDS5ReplicaType: 3
   ...

   これらのパラメーターは以下を示しています。

   • nsDS5ReplicaRoot は、レプリケートされる接尾辞を設定します。
   • nsDS5ReplicaType を 3 に設定して、このホストがサプライヤーであることを定義します。

2. 初期化が成功したかどうかを確認します。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com repl-agmt init-status --suffix "dc=example,dc=com" example-agreement-supplier-to-hub
   Agreement successfully initialized.

3. レプリケーションのステータスを表示します。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com repl-agmt status --suffix "dc=example,dc=com" example-agreement-supplier-to-hub
   Status For Agreement: "example-agreement-supplier-to-hub" (hub.example.com:389)
   Replica Enabled: on
   Update In Progress: FALSE
   Last Update Start: 20210331105030Z
   Last Update End: 20210331105030Z
   Number Of Changes Sent: 0
   Number Of Changes Skipped: None
   Last Update Status: Error (0) Replica acquired successfully: Incremental update succeeded
   Last Init Start: 20210331105026Z
   Last Init End: 20210331105029Z
   Last Init Status: Error (0) Total update succeeded
   Reap Active: 0
   Replication Status: Not in Synchronization: supplier (Unknown) consumer (Unknown) State (green) Reason (error (0) replica acquired successfully: incremental update succeeded)
   Replication Lag Time: Unavailable

   Replication Status フィールドおよび Last Update Status フィールドを確認します。

トラブルシューティング

1. デフォルトでは、サーバー上のすべての合意に対するレプリケーションアイドルタイムアウトは 1 時間です。タイムアウトが原因で大規模なデータベースの初期化が失敗する場合は、nsslapd-idletimeout パラメーターをより高い値に設定します。たとえば、パラメーターを 7200(2 時間) に設定するには、次のコマンドを実行します。

   # dsconf -D "cn=Directory Manager" ldap://supplier1.example.com config replace nsslapd-idletimeout=7200

   無制限の期間を設定するには、nsslapd-idletimeout を 0 に設定します。

検証

1. 初期化が成功したかどうかを確認します。

   # dsconf -D "cn=Directory Manager" ldap://hub.example.com repl-agmt init-status --suffix "dc=example,dc=com" example-agreement-hub-to-consumer
   Agreement successfully initialized.

2. レプリケーションのステータスを表示します。

   # dsconf -D "cn=Directory Manager" ldap://hub.example.com repl-agmt status --suffix "dc=example,dc=com" example-agreement-hub-to-consumer
   Status For Agreement: "example-agreement-hub-to-consumer" (consumer.example.com:389)
   Replica Enabled: on
   Update In Progress: FALSE
   Last Update Start: 20210331131534Z
   Last Update End: 20210331131534Z
   Number Of Changes Sent: 0
   Number Of Changes Skipped: None
   Last Update Status: Error (0) Replica acquired successfully: Incremental update succeeded
   Last Init Start: 20210331131530Z
   Last Init End: 20210331131533Z
   Last Init Status: Error (0) Total update succeeded
   Reap Active: 0
   Replication Status: Not in Synchronization: supplier (Unknown) consumer (Unknown) State (green) Reason (error (0) replica acquired successfully: incremental update succeeded)
   Replication Lag Time: Unavailable

   Replication Status フィールドおよび Last Update Status フィールドを確認します。

トラブルシューティング

1. デフォルトでは、サーバー上のすべての合意に対するレプリケーションアイドルタイムアウトは 1 時間です。タイムアウトが原因で大規模なデータベースの初期化が失敗する場合は、nsslapd-idletimeout パラメーターをより高い値に設定します。たとえば、パラメーターを 7200(2 時間) に設定するには、次のコマンドを実行します。

   # dsconf -D "cn=Directory Manager" ldap://hub .example.com config replace nsslapd-idletimeout=7200

   無制限の期間を設定するには、nsslapd-idletimeout を 0 に設定します。

手順

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。

3. レプリケーションを有効にします。

   1. Enable Replication をクリックします。

   2. Replication Role フィールドで Consumer を選択し、作成するレプリケーションマネージャーアカウントおよびパスワードを入力します。

      

      この設定により、ホストを dc=example,dc=com 接尾辞のハブとして設定します。

   3. Enable Replication をクリックします。

検証

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。
3. Replica Role フィールドに値 Hub が含まれている場合、レプリケーションが有効になり、ホストがコンシューマーとして設定されます。

手順

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。

3. レプリケーションを有効にします。

   1. Enable Replication をクリックします。

   2. Replication Role フィールドで Supplier を選択し、レプリカ ID を入力し、作成するレプリケーションマネージャーアカウントの識別名 (DN) およびパスワードを入力します。

      

      この設定により、ホストを dc=example,dc=com 接尾辞のサプライヤーとして設定し、このエントリーのレプリカ ID を 1 に設定します。

      重要

      トポロジー内のすべてのサプライヤーの接尾辞については、レプリカ ID は 1 から 65534 の間の一意の整数である必要があります。

   3. Enable Replication をクリックします。

4. レプリカ合意を追加し、新規サーバーを初期化します。

   1. Agreements タブで、Create Agreement をクリックし、次のフィールドに入力します。

      

      この設定により、example-agreement-supplier-to-hub という名前のレプリカ合意が作成されます。レプリカ合意は、ハブのホスト名、プロトコル、このハブへのデータの接続や複製時にサプライヤーが使用する認証情報などの設定を定義します。

   2. Consumer Initialization フィールドで Do Online Initialization を選択し、合意の保存後に新規サーバーを自動的に初期化します。

   3. Save Agreement をクリックします。

      この合意の作成後、Directory Server は hub.example.com を初期化します。複製するデータ量によっては、初期化に時間がかかる場合があります。

検証

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。

3. Agreements タブで、テーブルの State 列での契約のステータスを確認。

   

手順

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。
3. Enable Replication をクリックします。

4. Replication Role フィールドで Consumer を選択し、作成するレプリケーションマネージャーアカウントおよびパスワードを入力します。

   

   この設定により、ホストを dc=example,dc=com 接尾辞のコンシューマーとして設定します。さらに、サーバーは指定のパスワードで cn=replication manager,cn=config ユーザーを作成し、このアカウントがこのホストに接尾辞の変更を複製することができます。

5. Enable Replication をクリックします。

検証

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。
3. Replica Role フィールドに値 Consumer が含まれている場合、レプリケーションが有効になり、ホストがコンシューマーとして設定されます。

手順

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。

3. レプリカ合意を追加し、コンシューマーを初期化します。

   1. Agreements タブで、Create Agreement をクリックし、次のフィールドに入力します。

      

      この設定により、example-agreement-hub-to-consumer という名前のレプリカ合意が作成されます。レプリカ合意は、コンシューマーのホスト名、プロトコル、このコンシューマーへのデータの接続や複製時にハブが使用する認証情報などの設定を定義します。

   2. Consumer Initialization フィールドで Do Online Initialization を選択し、合意の保存後にコンシューマーを自動的に初期化します。

   3. Save Agreement をクリックします。

      この合意の作成後、Directory Server は consumer.example.com を初期化します。複製するデータ量によっては、初期化に時間がかかる場合があります。

検証

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。

3. Agreements タブで、テーブルの State 列での契約のステータスを確認。

   

手順

1. 接尾辞のタイムアウト値を設定します。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com replication set --suffix="dc=example,dc=com" --repl-release-timeout=70

   このコマンドは、example,dc=com の接尾辞のレプリケーションタイムアウトを 70 秒に変更します。

2. インスタンスを再起動します。

   # dsctl instance_name restart

手順

1. Replication タブで、接尾辞エントリーを選択します。
2. Show Advanced Settings をクリックします。
3. Replication Release Timeout フィールドの値を更新します。
4. Save Configuration をクリックします。

手順

1. コンシューマーを初期化するには、次を実行します。

   # dsconf <supplier_instance_name> repl-agmt init --suffix="dc=example,dc=com" <supplier_consumer_agreement_name>

   複製するデータ量によっては、初期化に時間がかかる場合があります。

手順

1. Replication メニューを開き、レプリケートする接尾辞を選択します。
2. Agreements タブで、レプリカ合意の名前の横にあるオプションメニュー (⋮) をクリックし、Initialize Agreement を選択します。

3. ポップアップウィンドウの Yes, I am sure チェックボックスをオンにして初期化を確定します。

   複製するデータ量によっては、初期化に時間がかかる場合があります。

手順

1. サプライヤーサーバーで、次の手順を実行します。

   1. サプライヤー上のインスタンスをシャットダウンします。

      # dsctl <supplier_instance_name> stop

   2. レプリケートする接尾辞を含む userRoot データベースを、レプリケーション情報を含む /var/lib/dirsrv/slapd-<supplier_instance_name>/ldif/example.ldif ファイルにエクスポートします。

      # dsctl <supplier_instance_name> db2ldif userRoot /var/lib/dirsrv/slapd-<supplier_instance_name>/ldif/example.ldif

   3. サプライヤーでインスタンスを起動します。

      # dsctl <supplier_instance_name> start

2. コンシューマーサーバーで、次の手順を実行します。

   1. コンシューマー上のインスタンスをシャットダウンします。

      # dsctl <consumer_instance_name> stop

   2. エクスポートされた example.ldif ファイルをコンシューマーの /var/lib/dirsrv/slapd-<consumer_instance_name>/ldif/ ディレクトリーにコピーします。
   3. /var/lib/dirsrv/slapd-<consumer_instance_name>/ldif/example.ldif ファイルから userRoot データベースをインポートします。dsctl ldif2db コマンドを使用してデータをインポートする方法の詳細は、サーバーがオフラインのときにコマンドラインを使用してデータをインポートする を参照してください。

   4. コンシューマー側でインスタンスを起動します。

      # dsctl <consumer_instance_name> start

手順

1. 削除するコンシューマーまたはハブ:

   1. 接尾辞とそれに対応するデータベースをリスト表示します。

      # dsconf -D "cn=Directory Manager" ldap://host-to-remove.example.com backend suffix list
      dc=example,dc=com (userroot)

      データベースの名前を書き留めます。

   2. データベースを読み取り専用モードに設定して、追加の更新を回避します。

      # dsconf -D "cn=Directory Manager" ldap://host-to-remove.example.com backend suffix set --enable-readonly "userroot"

2. 削除するコンシューマーまたはハブとレプリカ合意を結んでいるすべてのサプライヤーで以下を実行します。

   1. レプリケートされる接尾辞のレプリカ合意をリスト表示します。

      # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-agmt list --suffix "dc=example,dc=com"
      dn: cn=example-agreement,cn=replica,cn=dc\3Dexample\2Cdc\3Dcom,cn=mapping tree,cn=config
      cn: example-agreement
      ...

      cn 属性には、次の手順に必要なレプリカ合意名が含まれます。

   2. レプリカ合意を削除します。

      # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-agmt delete --suffix "dc=example,dc=com" example-agreement

3. コンシューマーまたはハブで、すべての接尾辞のレプリケーションを無効にします。

   # dsconf -D "cn=Directory Manager" ldap://host-to-remove.example.com replication disable --suffix "dc=example,dc=com"

   このホストがハブの場合は、レプリケーションを無効にすると、このサーバーのこの接尾辞のすべてのレプリカ合意も自動的に削除されます。

手順

1. 削除するサプライヤーで、以下を行います。

   1. 接尾辞とそれに対応するデータベースをリスト表示します。

      # dsconf -D "cn=Directory Manager" ldap://host-to-remove.example.com backend suffix list
      dc=example,dc=com (userroot)

      データベースの名前を書き留めます。

   2. データベースを読み取り専用モードに設定して、追加の更新を回避します。

      # dsconf -D "cn=Directory Manager" ldap://host-to-remove.example.com backend suffix set --enable-readonly "userroot"

   3. トポロジー内の他のすべてのサーバーが、このサプライヤーからすべてのデータを受け取るまで待ちます。確認のため、他のサーバーの CSN が、削除するサプライヤーの CSN と同等以上であることを確認します。

      # ds-replcheck online -D "cn=Directory Manager" -w password -m ldap://host-to-remove.example.com:389 -r ldap://server.example.com:389 -b dc=example,dc=com
      ================================================================================
               Replication Synchronization Report  (Tue Mar  5 09:46:20 2021)
      ================================================================================
      
      Database RUV's
      =====================================================
      
      Supplier RUV:
        {replica 1 ldap://host-to-remove.example.com:389} 5c7e8927000100010000 5c7e89a0000100010000
        {replicageneration} 5c7e8927000000010000
      
      Replica RUV:
        {replica 1 ldap://host-to-remove.example.com:389} 5c7e8927000100010000 5c7e8927000400010000
        {replica 2 ldap://server.example.com:389}
        {replicageneration} 5c7e8927000000010000

   4. レプリカ ID を表示します。

      # dsconf -D "cn=Directory Manager" ldap://host-to-remove.example.com replication get --suffix "dc=example,dc=com" | grep -i "nsds5replicaid"
      nsDS5ReplicaId: 1

      この例では、レプリカ ID は 1 です。この手順の最後のステップのレプリカ ID を書き留めます。

2. 削除するホストとレプリカ合意があるすべてのサプライヤーで、以下を実施します。

   1. レプリケートされる接尾辞のレプリカ合意をリスト表示します。

      # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-agmt list --suffix "dc=example,dc=com"
      dn: cn=example-agreement,cn=replica,cn=dc\3Dexample\2Cdc\3Dcom,cn=mapping tree,cn=config
      cn: example-agreement
      ...

      cn 属性には、次の手順に必要なレプリカ合意名が含まれます。

   2. レプリカ合意を削除します。

      # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-agmt delete --suffix "dc=example,dc=com" example-agreement

3. 削除するサプライヤーで、すべての接尾辞のレプリケーションを無効にします。

   # dsconf -D "cn=Directory Manager" ldap://host-to-remove.example.com replication disable --suffix "dc=example,dc=com"

   レプリケーションを無効にすると、このサーバーのこの接尾辞のレプリカ合意もすべて自動的に削除されます。

4. 次に進む前に、ds-replcheck 出力の Replica RUV セクションにリスト表示されているすべての Directory Server インスタンスがオンラインであることを確認します。

5. トポロジー内の残りのサプライヤーのいずれかで、レプリカ ID の RUV をクリーンアップします。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-tasks cleanallruv --suffix "dc=example,dc=com" --replica-id 1

   このコマンドでは、この手順の前のステップで表示されるレプリカ ID を指定する必要があります。

手順

1. レプリケーションロギングを有効にします。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com config replace nsslapd-errorlog-level=8192

   このコマンドは、レプリケーションロギングのみを有効にし、他のエラーメッセージのロギングは無効である点に注意してください。

2. /var/log/dirsrv/slapd-instance_name/errors ログファイルを監視し、以下のエラーメッセージを検索します。

   Replica Busy! Status: [Error (1) Replication error acquiring replica: replica busy]

   Directory Server がしばしばこのエラーをログに記録することがある点に注意してください。ただし、レプリカが頻繁に更新を受信せず、サプライヤーがこのエラーをログに記録する場合は、設定を更新してこの問題を解決することを検討してください。

手順

1. nsds5ReplicaBusyWaitTime パラメーターを設定し、レプリカがビジー応答を送信した後に、サプライヤーが再度レプリカへのアクセスの取得を試みるまでに待機する時間を設定します。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com repl-agmt set --suffix "dc=example,dc=com" --busy-wait-time 5 replication_agreement_name

   このコマンドは、待機時間を 5 秒に設定します。この設定は、指定されたレプリカ合意にのみ適用されます。

2. nsds5ReplicaSessionPauseTime パラメーターを設定して、2 つの更新セッション間でサプライヤーが待機する時間を設定します。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com repl-agmt set --suffix "dc=example,dc=com" --session-pause-time 15 replication_agreement_name

   このコマンドは、一時停止を 15 秒に設定します。デフォルトでは、nsds5ReplicaSessionPauseTime は nsds5ReplicaBusyWaitTime の値よりも 1 秒長くなるように設計されています。この設定は、指定されたレプリカ合意にのみ適用されます。

3. nsds5ReplicaReleaseTimeout パラメーターを設定して、更新の送信が完了したかどうかに関わらず、指定時間後にレプリケーションセッションを終了します。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com replication set --suffix "dc=example,dc=com" --repl-release-timeout 90

   このコマンドは、タイムアウトを 90 秒に設定します。この設定は、指定した接尾辞のすべてのレプリカ合意に適用されます。

4. オプション: サプライヤーのタイムアウト期間を設定して、低速または切断された接続を介して更新を無限に送信しようとするコンシューマーに接続されたままにならないようにします。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com repl-agmt set --conn-timeout 600 --suffix "dc=example,dc=com" replication_agreement_name

   このコマンドは、タイムアウトを 600 秒 (10 分) に設定します。最適な値を特定するには、アクセスログでレプリケーションプロセスにかかる平均時間を確認し、それに応じてタイムアウト期間を設定します。

手順

1. レプリカ合意に更新スケジュールが設定されているかどうかを確認します。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-agmt get --suffix "dc=example,dc=com" example-agreement

   コマンドの出力に nsDS5ReplicaUpdateSchedule: * が含まれている、または nsDS5ReplicaUpdateSchedule パラメーターが存在しない場合、更新スケジュールは設定されていません。

   nsDS5ReplicaUpdateSchedule に、以下のようなスケジュールが含まれる場合には、値を書き留めておきます。

   nsDS5ReplicaUpdateSchedule: 0800-2200 0246

2. 更新スケジュールが設定されている場合は、以下のコマンドを実行して一時的に無効にします。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-agmt set --schedule \ --suffix "dc=example,dc=com" example-agreement*

3. レプリカ合意を一時的に無効にします。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-agmt disable --suffix "dc=example,dc=com" example-agreement

4. レプリカ合意を再度有効にして、レプリケーションの更新を強制的に実行します。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-agmt enable --suffix "dc=example,dc=com" example-agreement

5. この手順の最初にレプリケーションスケジュールが設定されていた場合、スケジュールを以前の値に設定します。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-agmt set --schedule "0800-2200 0246" --suffix "dc=example,dc=com" example-agreement

手順

1. Replication メニューを開きます。
2. dc=example,dc=com 接尾辞を選択します。
3. Agreements タブを開きます。

4. レプリカ合意に更新スケジュールが設定されているかどうかを確認します。

   1. 契約の横にあるオーバーフローメニューをクリックし、Edit Agreement を選択します。

   2. Scheduling タブで、現在設定されている値をメモします。

      

      Use A Custom Schedule が選択されていない場合、スケジュールは設定されません。

5. レプリカ合意の横にあるオーバーフローメニューをクリックし、Disable/Enable Agreement を選択して合意を無効にします。

   State 列の合意のステータスが Disabled になります。

6. レプリカ合意の横にあるオーバーフローメニューをもう一度クリックし、Disable/Enable Agreement を選択して、レプリカ合意を再度有効にし、レプリケーションの更新を適用します。

   State 列の合意のステータスが Enabled になります。

7. この手順の最初にレプリケーションスケジュールが設定されていた場合、スケジュールを以前の値に設定します。

   1. オーバーフローメニューをクリックし、Actions → Edit Agreement を選択します。
   2. Scheduling タブで、以前の値を設定します。

手順

1. プロモートするレプリカがレプリカ合意を持つハブで、ハブがプロモート後にデータを他のホストに送信しないようにするには、レプリカ合意を削除します。

   1. ハブのレプリカ合意をリスト表示します。

      # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-agmt list --suffix "dc=example,dc=com"
      dn: cn=example-agreement,cn=replica,cn=dc\3Dexample\2Cdc\3Dcom,cn=mapping tree,cn=config
      cn: example-agreement
      ...

      cn 属性には、次の手順に必要なレプリカ合意名が含まれます。

   2. ハブからレプリカ合意を削除します。

      # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-agmt delete --suffix "dc=example,dc=com" example-agreement

2. インスタンスをプロモートします。

   • コンシューマーまたはハブをサプライヤーにプロモートする場合は、以下を入力します。

     # dsconf -D "cn=Directory Manager" ldap://server.example.com replication promote --suffix "dc=example,dc=com" --newrole "supplier" --replica-id 2

     重要

     トポロジー内のすべてのサプライヤーの接尾辞については、レプリカ ID は 1 から 65534 の間の一意の整数値である必要があります。

   • コンシューマーをハブにプロモートする場合は、以下を入力します。

     # dsconf -D "cn=Directory Manager" ldap://server.example.com replication promote --suffix "dc=example,dc=com" --newrole "hub"

3. 新しいロールのレプリカがトポロジー内の他のホストに更新を送信する必要がある場合は、レプリカ合意を作成します。

手順

1. プロモートするレプリカがレプリカ合意を持つハブで、ハブがプロモート後にデータを他のホストに送信しないようにするには、レプリカ合意を削除します。

   1. Replication → Agreements に移動します。
   2. 削除する合意の横にある Actions をクリックし、Delete Agreement を選択します。

2. Replication → Configuration に移動し、Change Role ボタンをクリックします。

   • コンシューマーまたはハブをサプライヤーにプロモートする場合は、Supplier を選択して一意のレプリカ ID を入力します。

     重要

     トポロジー内のすべてのサプライヤーの接尾辞については、レプリカ ID は 1 から 65534 の間の一意の整数値である必要があります。

   • コンシューマーをハブにプロモートする場合は、Hub を選択します。
3. Yes, I am sure. を選択します。
4. Change Role をクリックします。
5. 新しいロールのレプリカがトポロジー内の他のホストに更新を送信する必要がある場合は、レプリカ合意を作成します。

手順

1. デモートするレプリカに必要なくなったレプリカ合意がある場合は、たとえばレプリカをコンシューマーにデモートする場合、レプリカ合意を削除します。

   1. レプリカのレプリカ合意をリスト表示します。

      # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-agmt list --suffix "dc=example,dc=com"
      dn: cn=example-agreement,cn=replica,cn=dc\3Dexample\2Cdc\3Dcom,cn=mapping tree,cn=config
      cn: example-agreement
      ...

      cn 属性には、次の手順に必要なレプリカ合意名が含まれます。

   2. レプリカからレプリカ合意を削除します。

      # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-agmt delete --suffix "dc=example,dc=com" example-agreement

2. インスタンスをデモートします。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com replication demote --suffix "dc=example,dc=com" --newrole "hub_or_consumer"

   設定するロールに応じて --newrole パラメーターを hub または consumer に設定します。

3. レプリカをハブとして設定していて、トポロジー内の他のホストに更新を送信する必要がある場合は、レプリカ合意を作成します。

手順

1. デモートするレプリカに必要なくなったレプリカ合意がある場合は、たとえばレプリカをコンシューマーにデモートする場合、レプリカ合意を削除します。

   1. Replication → Agreements に移動します。
   2. 削除する合意の横にある Actions をクリックし、Delete Agreement を選択します。
2. Replication → Configuration に移動し、Change Role ボタンをクリックします。
3. 新しいレプリカロールを選択します。
4. Yes, I am sure. を選択します。
5. Change Role をクリックします。
6. 新しいロールのレプリカがトポロジー内の他のホストに更新を送信する必要がある場合は、レプリカ合意を作成します。

手順

1. 変更ログのトリミングを設定します。

   • changelog エントリーの最長期間を設定するには、以下を入力します。

     # dsconf -D "cn=Directory Manager" ldap://server.example.com replication set-changelog --suffix "dc=example,dc=com" --max-age "4w"

     このコマンドは、最長期間を 4 週間に設定します。パラメーターは、以下の単位をサポートします。

     • s (S) (秒)
     • m (M) (分)
     • h (H) (時間)
     • d (D) (日)
     • w (W) (週)

   • エントリーの最大数を設定するには、以下を入力します。

     # dsconf -D "cn=Directory Manager" ldap://server.example.com replication set-changelog --suffix "dc=example,dc=com" --max-entries "100000"

     このコマンドは、changelog のエントリーの最大数を 100,000 に設定します。

2. デフォルトでは、Directory Server は changelog を 5 分 (300 秒) ごとにトリミングします。別の間隔を設定するには、以下を入力します。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com replication set-changelog --suffix "dc=example,dc=com" --trim-interval 600

   このコマンドは、間隔を 10 分 (600 秒) に設定します。

手順

1. オプション: changelog のサイズを表示します。

   1. dc=example,dc=com 接尾辞のバックエンドデータベースを特定します。

      # dsconf -D "cn=Directory Manager" ldap://server.example.com backend suffix list
      dc=example,dc=com (userroot)

      括弧内の名前は、対応する接尾辞のデータを保存するバックエンドデータベースです。

   2. userroot バックエンドの変更ログファイルのサイズを表示します。

      # ls -lh /var/lib/dirsrv/slapd-instance_name/db/userroot/replication_changelog.db
      -rw-------. 1 dirsrv dirsrv 517M Jul  5 12:58 /var/lib/dirsrv/slapd-instance_name/db/userroot/replication_changelog.db

2. changelog サイズを縮小した後にパラメーターをリセットできるようにするには、対応するパラメーターの現在の値を表示して書き留めます。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com replication get-changelog --suffix "dc=example,dc=com"
   dn: cn=changelog,cn=userroot,cn=ldbm database,cn=plugins,cn=config
   cn: changelog
   nsslapd-changelogmaxage: 4w
   nsslapd-changelogtrim-interval: 300

   出力に特定の属性が表示されない場合、Directory Server はデフォルト値を使用します。

3. 一時的に、トリミングに関連するパラメーターを減らします。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com replication set-changelog --suffix "dc=example,dc=com" --max-age "300s" --max-entries 500 --trim-interval 60

   重要

   パフォーマンス上の理由から、短い間隔設定を永続的に使用しないでください。

4. --trim-interval パラメーターに設定した時間が経過するのを待ちます。

5. changelog を圧縮して、ディスク領域を再度確保します。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com backend compact-db --only-changelog

6. changelog パラメーターを、一時的に減らす前の値にリセットします。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com replication set-changelog --suffix "dc=example,dc=com" --max-age "4w" --trim-interval 300

手順

1. changelog(例: /tmp/changelog.ldif ファイル) をエクスポートします。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com replication export-changelog to-ldif -o /tmp/changelog.ldif -r "dc=example,dc=com"

2. dc=example,dc=com 接尾辞の変更ログの暗号化を有効にします。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com replication --suffix "dc=example,dc=com" --encrypt

3. /tmp/changelog.ldif ファイルから changelog をインポートします。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com replication import-changelog from-ldif -r "dc=example,dc=com" /tmp/changelog.ldif

4. インスタンスを再起動します。

   # dsctl instance_name restart

検証

1. エントリーの更新など、LDAP ディレクトリーに変更を加えます。

2. インスタンスを停止します。

   # dsctl instance_name stop

3. 接尾辞とそれに対応するデータベースをリスト表示します。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com backend suffix list
   dc=example,dc=com (userroot)

   changelog の暗号化を有効にするデータベースの名前を書き留めておきます。

4. 以下のコマンドを実行して、changelog の一部を表示します。

   # dbscan -f /var/lib/dirsrv/slapd-instance_name/db/userroot/replication_changelog.db | tail -50

   changelog が暗号化されている場合は、暗号化されたデータのみが表示されます。

5. インスタンスを起動します。

   # dsctl instance_name start

手順

1. 現在のエラーログレベルを表示します。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com config get nsslapd-errorlog-level
   nsslapd-errorlog-level: 16384

2. レプリケーションのデバッグを有効にする値は 8192 です。nsslapd-errorlog-level パラメーターを 24576 (8192 + 以前の値 16384) に設定して、現在有効になっているエラーログ機能に加えてレプリケーションのデバッグを有効にします。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com config replace nsslapd-errorlog-level=24576

手順

1. dsconf ユーティリティーを使用して部分レプリケーションを設定します。

   # dsconf -D "cn=Directory Manager" instance_name repl-agmt set example_agreement --suffix="dc=example,dc=com" --frac-list="authorityRevocationList accountUnlockTime memberof" --frac-list-total="accountUnlockTime"

   このコマンドは、authorityRevocationList、accountUnlockTime、memberof 属性を増分更新から除外し、accountUnlockTime のみを合計更新から除外します。

   注記

   合計更新と増分更新から同じ属性のリストを除外する場合は、the-- frac-list オプションを使用して、除外される属性のリスト を nsDS5ReplicatedAttributeList 設定属性にのみ追加します。

2. オプション: 空のレプリケーション更新を防ぐ場合は、--strip-list オプションを使用して、Directory Server がレプリケーションから削除する属性を追加します。詳細は、部分レプリケーションでの空の更新の防止 を参照してください。

手順

1. Replication → Agreements に移動します。
2. 部分レプリケーションを設定する合意の Options メニュー (⫶) をクリックし、Edit を選択してウィザードウィンドウを開きます。

3. Fractional Settings タブを開き、次のフィールドを設定します。

   • 合計更新と増分更新から同じ属性を除外する場合は、これらの属性を Exclude Attributes フィールドにのみ追加します。

   • 合計更新と増分更新から異なる属性を除外する場合:

     1. 増分更新から除外される属性を、nsDS5ReplicatedAttributeList パラメーターを設定する 除外属性 フィールドに追加します。
     2. 合計 (初期) 更新から除外される属性を、nsDS5ReplicatedAttributeListTotal パラメーターを設定する Exclude Init Attributes フィールドに追加します。
4. オプション: 空のレプリケーション更新を防止する場合は、Directory Server がレプリケーションから削除する属性を Strip Attributes フィールドに追加します。
5. Save Agreement ボタンをクリックします。

手順

1. dsconf ユーティリティーを使用して部分レプリケーションを調整します。

   # dsconf -D "cn=Directory Manager" instance_name repl-agmt set example_agreement \
       --suffix="dc=example,dc=com" --strip-list="modifiersname \
       modifytimestamp internalmodifiersname"
   Successfully updated agreement

手順

1. ldapsearch ユーティリティーを使用して、keep-alive エントリーを見つけます。

   # ldapsearch -D "cn=Directory Manager" -b "dc=example,dc=com" -W -H ldap://server.example.com -x 'objectClass=ldapsubentry'
   Enter LDAP Password: password
   
   # repl keep alive 1, example.com
   dn: cn=repl keep alive 1,dc=example,dc=com
   keepalivetimestamp: 20250204204708Z
   objectClass: top
   objectClass: ldapsubentry
   objectClass: extensibleObject
   cn: repl keep alive 1

   各 keep-alive エントリーは特定のサプライヤーに固有であり、識別名 (DN) にサプライヤーのレプリカ ID が含まれます。この例では、レプリカ ID は 1 です。

手順

1. オプション: ~/.dsrc ファイルを作成します。

2. ~/.dsrc ファイルで、バインド DN およびパスワードを設定します。以下に例を示します。

   [repl-monitor-connections]
   connection1 = server1.example.com:389:cn=Directory Manager:*
   connection2 = server2.example.com:389:cn=Directory Manager:[~/pwd.txt]
   connection3 = hub1.example.com:389:cn=Directory Manager:S3cret

   この例では、connection1 から connection3 を各エントリーのキーとして使用します。ただし、任意の一意のキーを使用できます。

   dsconf replication monitor コマンドを実行すると、dsconf ユーティリティーはインスタンスのレプリカ合意で設定されたすべてのサーバーに接続します。このユーティリティーが ~/.dsrc でホスト名を見つけると、定義された認証情報を使用してリモートサーバーに対して認証されます。上記の例では、dsconf はサーバーへの接続時に以下の認証情報を使用します。

   Expand

   ホスト名	バインド DN	パスワードの設定方法
   server1.example.com	cn=Directory Manager	パスワードを要求する
   server2.example.com	cn=Directory Manager	~/pwd.txt からパスワードを読み取る
   hub1.example.com	cn=Directory Manager	S3cret

   Show more

手順

1. Monitoring → Replication に移動します。Replication Monitoring ページが開きます。
2. Generate Report をクリックします。

3. リモートインスタンスにログインするためのパスワードを入力し、Confirm Credentials Input をクリックします。Directory Server は、既存のレプリケーションアグリーメントのバインド DN 値を使用します。

   レプリケーショントポロジーレポートは、Report Result タブで生成されます。

   注記

   別のレプリケーショントポロジーレポートを生成するには、Prepare Report タブに移動します。

手順

1. Monitoring → Replication に移動します。Replication Monitoring ページが開きます。
2. Add Credentials をクリックします。

3. リモートインスタンスへの認証に使用するレプリケーションのログイン認証情報を入力します。

   • Hostname。サーバーが認証するリモートインスタンスのホスト名。
   • Port。リモートインスタンスポート。
   • Bind DN。認証に使用される DN をリモートインスタンスにバインドします。
   • Password。認証に使用されるパスワード。
   • Interactive Input。オンにすると、レプリケーショントポロジーレポートを生成するたびに Directory Server がパスワードを要求します。
4. Save をクリックします。

手順

1. Monitoring → Replication に移動します。Replication Monitoring ページが開きます。
2. Add Alias をクリックします。

3. エイリアスの詳細を入力します。

   • Alias。レプリケーショントポロジーレポートに表示されるエイリアス。
   • Hostname。インスタンスのホスト名。
   • Port。インスタンスポート。
4. Save をクリックします。

手順

1. サプライヤーで、接尾辞とそれに対応するデータベースをリストします。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com backend suffix list
   dc=example,dc=com (userroot)
   o=test (test_database)

   比較するデータベースの名前または接尾辞をメモします。

2. インスタンスの実行中にデータベースをエクスポートします。

   # dsconf -D "cn=Directory Manager" ldap://supplier.example.com backend export -r -l /var/lib/dirsrv/slapd-instance_name/ldif/export-supplier.ldif userRoot

   -r パラメーターは、エクスポートにレプリケーション状態情報が含まれるようにし、-l はエクスポートファイルへのパスを設定します。そのファイルを作成するには、dirsrv ユーザーが宛先ディレクトリーへの書き込み権限を持っている必要があることに注意してください。

3. サプライヤーと比較するレプリカで前の手順を繰り返します。

4. エクスポートしたファイルを一方のホストからもう一方のホストにコピーします。たとえば、LDIF ファイルを replica.example.com から supplier.example.com にコピーするには、レプリカで次のコマンドを入力します。

   # scp /var/lib/dirsrv/slapd-instance_name/ldif/export-replica.ldif supplier.example.com:/var/lib/dirsrv/slapd-instance_name/ldif/

   このコマンドでは、SSH を使用してサプライヤーにアクセスできる必要があることに注意してください。

5. サプライヤーで、2 つの LDIF ファイルを比較します。

   # ds-replcheck offline -m /var/lib/dirsrv/slapd-instance_name/ldif/export-supplier.ldif -r /var/lib/dirsrv/slapd-instance_name/ldif/export-replica.ldif -rid 1 -b "dc=example,dc=com"

   -m および -r パラメーターは、サプライヤーとレプリカへのパスを設定し、-rid は、サプライヤーのレプリカ ID を設定します。

手順

1. 競合エントリーをリスト表示します。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-conflict list dc=example,dc=com
   dn: nsuniqueid=a7f1758b-512211ec-b115e2e9-7dc2d46b+uid=user_name,ou=people,dc=example,dc=com
   cn: user_name
   displayName: user
   gidNumber: 99998
   homeDirectory: /var/empty
   legalName: user name
   loginShell: /bin/false
   nsds5replconflict: namingConflict (ADD) uid=user_name,ou=people,dc=example,dc=com
   objectClass: top
   objectClass: nsPerson
   objectClass: nsAccount
   objectClass: nsOrgPerson
   objectClass: posixAccount
   objectClass: ldapsubentry
   uid: user_name
   uidNumber: 99998

2. 競合エントリーが存在する場合は、続行方法を決定します。

   • 有効なエントリー (uid=user_name,ou=people,dc=example,dc=com) を維持し、競合エントリーを削除するには、次のコマンドを実行します。

     # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-conflict delete nsuniqueid=a7f1758b-512211ec-b115e2e9-7dc2d46b+uid=user_name,ou=People,dc=example,dc=com

   • 競合エントリー (nsuniqueid=a7f1758b-512211ec-b115e2e9-7dc2d46b+uid=user_name,ou=People,dc=example,dc=com) のみを保持し、有効なエントリーを削除するには、次のように入力します。

     # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-conflict swap nsuniqueid=a7f1758b-512211ec-b115e2e9-7dc2d46b+uid=user_name,ou=People,dc=example,dc=com

   • 両方のエントリーを保持するには、新しい相対識別名 (RDN) を指定して、競合エントリーの名前を変更します。

     # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-conflict convert --new-rdn=uid=user_name_NEW nsuniqueid=a7f1758b-512211ec-b115e2e9-7dc2d46b+uid=user_name,ou=people,dc=example,dc=com

     上記のコマンドは、競合エントリーの名前を uid=user_name_NEW,ou=people,dc=example,dc=com に変更します。

手順

1. 孤立したエントリーの競合をリスト表示します。

   # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-conflict list-glue suffix
   dn: ou=parent,dc=example,dc=com
   objectClass: top
   objectClass: organizationalunit
   objectClass: glue
   objectClass: extensibleobject
   ou: parent

2. 孤立したエントリーの競合が存在する場合は、続行する方法を決定します。

   • glue エントリーおよびその子エントリーを削除するには、次のコマンドを実行します。

     # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-conflict delete-glue "ou=parent,dc=example,dc=com"
     dn: ou=parent,dc=example,dc=com
     objectClass: top
     objectClass: organizationalunit
     objectClass: extensibleobject
     ou: parent

   • glue エントリーを通常のエントリーに変換するには、次のコマンドを実行します。

     # dsconf -D "cn=Directory Manager" ldap://server.example.com repl-conflict convert-glue "ou=parent,dc=example,dc=com"

手順

1. /var/log/dirsrv/slapd-instance_name/errors ログファイルを監視し、以下のようなエントリーを検索します。

   [22/Jan/2021:17:16:01 -0500] NSMMReplicationPlugin - ruv_compare_ruv: RUV [changelog max RUV] does not contain element [{replica 8 ldap://server2.example.com:389} 4aac3e59000000080000 4c6f2a02000000080000] which is present in RUV [database RUV]
   ...
   [22/Jan/2021:17:16:01 -0500] NSMMReplicationPlugin - replica_check_for_data_reload: Warning: for replica dc=example,dc=com there were some differences between the changelog max RUV and the database RUV. If there are obsolete elements in the database RUV, you should remove them using the CLEANALLRUV task. If they are not obsolete, you should check their status to see why there are no changes from those servers in the changelog.

   この場合、レプリカ ID 8 が原因でこのエラーが発生します。

2. 有効な ID と無効なすべての RUV レコードとレプリカ ID を表示します。

   # dsconf -D "cn=Directory Manager" ldap://server1.example.com replication get-ruv --suffix "dc=example,dc=com"
   RUV:        {replica 1 ldap://server1.example.com} 61a4d8f8000100010000 61a4f5b8000000010000
   
   Replica ID: 1
   LDAP URL:   ldap://server1.example.com
   Min CSN:    2021-11-29 13:43:20 1 0 (61a4d8f8000100010000)
   Max CSN:    2021-11-29 15:46:00 (61a4f5b8000000010000)
   RUV:        {replica 2 ldap://server2.example.com} 61a4d8fb000100020000 61a4f550000000020000
   
   Replica ID: 2
   LDAP URL:   ldap://server2.example.com
   Min CSN:    2021-11-29 13:43:23 1 0 (61a4d8fb000100020000)
   Max CSN:    2021-11-29 15:44:16 (61a4f550000000020000)
    RUV:        {replica 8 ldap://server3.example.com} 61a4d903000100080000 61a4d908000000080000
   
   Replica ID: 8
   LDAP URL:   ldap://server3.example.com
   Min CSN:    2021-11-29 13:43:31 1 0 (61a4d903000100080000)
   Max CSN:    2021-11-29 13:43:36 (61a4d908000000080000)

   返されるレプリカ ID のリスト (1、2、および 8) を書き留めます。

3. レプリカ ID 8 のクリーンアップタスクを実行します。

   # dsconf -D "cn=Directory Manager" ldap://server1.example.com repl-tasks cleanallruv --suffix="dc=example,dc=com" --replica-id=8

   Directory Server は RUV クリーンアップタスクを複製することに注意してください。したがって、1 つのサプライヤーでのみ、タスクを開始する必要があります。

   レプリカの 1 つがダウンしている場合などに参加できない場合は、--force-cleaning オプションを使用して、RUV の即時クリーンアップを実行できます。

手順

1. サプライヤーのすべての cleanallruv タスクを表示します。

   # dsconf <instance_name> repl-tasks list-cleanruv-tasks
   
   dn: cn=cleanallruv_2025-04-15T09:15:18.535868,cn=cleanallruv,cn=tasks,cn=config
   cn: cleanallruv_2025-04-15T09:15:18.535868
   nsTaskCreated: 20250415131518Z
   ...
   nsTaskStatus: Not all replicas online, retrying in 20 seconds...
   nsTaskTotalItems: 1
   nsTaskWarning: 0
   objectClass: top
   objectClass: extensibleObject
   replica-base-dn: dc=example,dc=com
   replica-id: 2

   この例では、レプリカが応答しなくなったため、cleanallruv タスクを完了できないことが示されています。場合によっては、サーバーのパフォーマンスに悪影響を与える可能性があります。

2. cleanallruv タスクを停止します。

   # dsconf <instance_name> repl-tasks abort-cleanallruv --suffix "dc=example,dc=com" --replica-id 12

   さらに、--certify オプションを使用して、Directory Server にすべてのレプリカ上の cleanallruv タスクを強制的に停止させることもできます。