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

手順

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

   Copy to Clipboard Toggle word wrap

   このコマンドは、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

   Copy to Clipboard Toggle word wrap

   このコマンドは、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
   ...

   Copy to Clipboard Toggle word wrap

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

   • 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.

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

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

手順

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

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

   

   View larger image

   

   この設定により、ホストを 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 フィールドを空のままにします。

      

      View larger image

      

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

      重要

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

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

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

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

      

      View larger image

      

      この設定により、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 列での契約のステータスを確認。

   

   View larger image

   

手順

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"

   Copy to Clipboard Toggle word wrap

   このコマンドは、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

   Copy to Clipboard Toggle word wrap

   このコマンドは、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
   ...

   Copy to Clipboard Toggle word wrap

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

   • 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.

   Copy to Clipboard Toggle word wrap

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)

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

   無制限の期間を設定するには、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.

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

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

手順

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

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

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

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

      

      View larger image

      

      この設定により、ホストを 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) およびパスワードを入力します。

      

      View larger image

      

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

      重要

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

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

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

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

      

      View larger image

      

      この設定により、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 列での契約のステータスを確認。

   

   View larger image

   

手順

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

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

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

      

      View larger image

      

      この設定により、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 列での契約のステータスを確認。

   

   View larger image

   

手順

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

   Copy to Clipboard Toggle word wrap

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"

   Copy to Clipboard Toggle word wrap

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"

   Copy to Clipboard Toggle word wrap

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"

   Copy to Clipboard Toggle word wrap

手順

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"

   Copy to Clipboard Toggle word wrap

   このコマンドは、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"

      Copy to Clipboard Toggle word wrap

   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

      Copy to Clipboard Toggle word wrap

検証

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

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

   Copy to Clipboard Toggle word wrap

手順

1. server1.example.com 上で:

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

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

      Copy to Clipboard Toggle word wrap

   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"

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

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"

      Copy to Clipboard Toggle word wrap

   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"

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

   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

      Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

検証

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.

   Copy to Clipboard Toggle word wrap

手順

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

   Copy to Clipboard Toggle word wrap

   このコマンドは、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

   Copy to Clipboard Toggle word wrap

   このコマンドは、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
   ...

   Copy to Clipboard Toggle word wrap

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

   • 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.

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

   無制限の期間を設定するには、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.

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

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

手順

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

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

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

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

      

      View larger image

      

      この設定により、ホストを 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) およびパスワードを入力します。

      

      View larger image

      

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

      重要

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

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

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

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

      

      View larger image

      

      この設定により、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 列での契約のステータスを確認。

   

   View larger image

   

手順

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

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

   

   View larger image

   

   この設定により、ホストを 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 をクリックし、次のフィールドに入力します。

      

      View larger image

      

      この設定により、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 列での契約のステータスを確認。

   

   View larger image

   

手順

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

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

   Copy to Clipboard Toggle word wrap

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

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

   # dsctl instance_name restart

   Copy to Clipboard Toggle word wrap

手順

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>

   Copy to Clipboard Toggle word wrap

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

手順

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

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

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

手順

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

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

      # dsctl <supplier_instance_name> stop

      Copy to Clipboard Toggle word wrap

   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

      Copy to Clipboard Toggle word wrap

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

      # dsctl <supplier_instance_name> start

      Copy to Clipboard Toggle word wrap

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

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

      # dsctl <consumer_instance_name> stop

      Copy to Clipboard Toggle word wrap
   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

      Copy to Clipboard Toggle word wrap

手順

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

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

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

      Copy to Clipboard Toggle word wrap

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

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

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

      Copy to Clipboard Toggle word wrap

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
      ...

      Copy to Clipboard Toggle word wrap

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

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

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

      Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

手順

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

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

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

      Copy to Clipboard Toggle word wrap

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

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

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

      Copy to Clipboard Toggle word wrap

   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

      Copy to Clipboard Toggle word wrap

   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

      Copy to Clipboard Toggle word wrap

      この例では、レプリカ 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
      ...

      Copy to Clipboard Toggle word wrap

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

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

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

      Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

手順

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

   このコマンドは、待機時間を 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

   Copy to Clipboard Toggle word wrap

   このコマンドは、一時停止を 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

   Copy to Clipboard Toggle word wrap

   このコマンドは、タイムアウトを 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

   Copy to Clipboard Toggle word wrap

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

手順

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

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

   Copy to Clipboard Toggle word wrap

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

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

   nsDS5ReplicaUpdateSchedule: 0800-2200 0246

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

手順

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

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

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

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

      

      View larger image

      

      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
      ...

      Copy to Clipboard Toggle word wrap

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

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

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

      Copy to Clipboard Toggle word wrap

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

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

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

     Copy to Clipboard Toggle word wrap
     重要

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

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

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

     Copy to Clipboard Toggle word wrap
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
      ...

      Copy to Clipboard Toggle word wrap

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

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

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

      Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   設定するロールに応じて --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"

     Copy to Clipboard Toggle word wrap

     このコマンドは、最長期間を 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"

     Copy to Clipboard Toggle word wrap

     このコマンドは、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

   Copy to Clipboard Toggle word wrap

   このコマンドは、間隔を 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)

      Copy to Clipboard Toggle word wrap

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

   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

      Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   出力に特定の属性が表示されない場合、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

   Copy to Clipboard Toggle word wrap
   重要

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

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

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

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

手順

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"

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

   # dsctl instance_name restart

   Copy to Clipboard Toggle word wrap

検証

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

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

   # dsctl instance_name stop

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

   # dsctl instance_name start

   Copy to Clipboard Toggle word wrap

手順

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

手順

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"

   Copy to Clipboard Toggle word wrap

   このコマンドは、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

   Copy to Clipboard Toggle word wrap

手順

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

   Copy to Clipboard Toggle word wrap

   各 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

   Copy to Clipboard Toggle word wrap

   この例では、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)

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   -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/

   Copy to Clipboard Toggle word wrap

   このコマンドでは、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"

   Copy to Clipboard Toggle word wrap

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