The dsreplication enable subcommand is used to set up replication. The enable subcommand carries out the following functions:
- If it does not already exist, the global administrator user is created. The global administrator user has all the rights and privileges to update replication-related configuration objects. Most dsreplication subcommands require the global administrator.
- The server instances are registered in the
cn=topology,cn=config
tree. The registration includes basic host name, port information, and the public key used during the replication authentication process.If both servers are already participating in replication, the
cn=topology,cn=config
is merged to retain the server information from existing topologies. - The embedded replication server is enabled. Servers already in replication see their replication server configuration updated with the information of the new replication server.
- A replication domain is created for the requested base distinguished names (DNs). If the
first base DN is enabled, the replication domains for two additional base DNs are also
enabled:
cn=topology,cn=config
andcn=schema
. - Initialization for the
cn=schema
base DN is executed. This ensures that a uniform schema is present in the replication topology. - Initialization must be performed for the enabled base DNs.
Important:
The dsreplication enable subcommand removes all existing topology administrative users except for the default uid=admin that is provided to enable replication. Administrative users must be re-added after enabling replication.