Steps to Enable Inter-cluster Replication

Product: Radiant FID

Purpose: How to enable inter-cluster replication

Procedure: The following steps will guide you through enabling inter-cluster replication

1. Disable replication on both the primary and secondary clusters:

• Go to Directory Namespace
• Select your HDAP store
• Uncheck the "Enable Inter-cluster Replication" box
• Save

2. Also disable schema-checking on both clusters if it is enabled.

3. Delete the attributes "vdsSyncCursor" and "vdsSyncState" on the Store naming context from the Directory Browser Tab in both the clusters:

• Go to Directory Browser tab > Select the HDAP store > on the right-hand side > Delete attribute as above.

4. Delete the replication (cn=<storename>) node under "cn=replication,cn=config" from the Directory Tree on both clusters' leader nodes:

• Expand cn=replication,cn=config in Directory Browser
• Select the branch immediately below and delete it. (example: cn=<storename>,cn=replication,cn=config)
• Note: This branch may not exist on both nodes. If not, that is ok, you can continue.

5. In the ZooKeeper tab, radiantone/v1/cluster/config/replication/domains, delete the replication branch and Save:

• Go into Expert mode of Control Panel and select the Zookeeper tab
• Go inside radiantone/v1/cluster/config/replication/domains and delete the replication branch for store immediately below domains.
• Do this on both the clusters

6. Export LDIF for Replication from the primary Cluster where the replication journal resides.

• Go to Directory Namespace
• Click on your HDAP store
• Click on the Export button and make sure you select the "Export for Replication" option while exporting the LDIF.

7. Re-initialize the HDAP store on the secondary cluster using this LDIF you exported for replication from the primary cluster.

• On the secondary cluster, go to Directory Namespace.
• Click on the HDAP store and initialize using the LDIF exported from the primary cluster for replication in Step 6 above.

8. On the Directory Browser tab, click on the root entry of the HDAP store to find the attributes "vdsSyncCursor" and "vdsSyncState". Now delete these attributes from both primary and secondary clusters.

9. Re-enable Inter-cluster replication on both Clusters.

• Go to Settings > Directory Namespace
• Select HDAP store
• Check the "Enable Inter-cluster Replication" box
• Save
• Do it on both the clusters.

10. Also re-enable- schema checking.

11. Test changes.

12. Verify that Inter-cluster replication is set properly :

• Go to Directory Browser, click on cn=<hdapstore>,cn=replication,cn=config
• Check if the replica values are correct

13. Check in the Zookeeper tab, radiantone/v1/cluster/config/replication/domains, and see if the o=hdapstore is listed under domains.

14. Whenever you make a change on any cluster, there should be a vdsSynCursor attribute created for the HDAP for replication to work properly. Where its value is the same in both clusters.

NOTE: In Active/Active to bring your Clusters up to date using the Resync Utility ensure Inter-cluster Replication is enabled then run the Resync Utility Tool.

Additional Documentation on how to use the Resync Utility: 

https://developer.radiantlogic.com/idm/v7.4/operations-guide/05-inter-cluster-management/#detecting-differences-across-replicated-radiantone-universal-directory-hdap-stores

Additional Documentation on Inter-cluster Replication: 

https://developer.radiantlogic.com/idm/v7.4/architect-guide/high-availability-and-performance/#inter-cluster-logical-replication