dsreplication

Description

Manage data replication between two or more Directory Server instances.

For replication to work, you must first to enable replication using the 'enable'. Then, you initialize the contents of one of the servers with the contents of the other using the 'initialize' subcommand.

Examples

dsreplication

dsreplication enable --host1 server1.example.com --port1 1389 \
     --bindDN1 "cn=Directory Manager" --bindPassword1 secret1 \
     --replicationPort1 8989 --host2 server2.example.com --port2 1389 \
     --bindDN2 "cn=Directory Manager" --bindPassword2 secret2 \
     --replicationPort2 8989 --baseDN dc=example,dc=com --adminUID admin \
     --adminPassword secret --no-prompt

dsreplication status --hostname host.example.com --port 1389 --adminUID admin \
     --adminPassword secret --no-prompt

Subcommands

Removes all replication artifacts from the configuration, schema and the server registry of the local server

This subcommand does not remove references to this server from other replicas and replication servers in the topology, it is therefore recommended to remove this server first from the replication topology either by using the disable or the remove-defunct-server subcommands

Since this subcommand can only be executed when the server is offline, replication attributes from suffixes other than the server registry or the schema will not be removed. The tool will produce an LDIF file that may be used to the remove replica state from the base entry of these suffixes after the server is restarted

To remove the replication history from regular suffixes, export the formerly replicated suffixes using --excludeReplication argument of export-ldif. The resulting LDIF can be reimported using import-ldif. For example, export-ldif -n userRoot --excludeReplication -l cleansed.ldif import-ldif -n userRoot -l cleansed.ldif Exporting using the --excludeReplication argument of export-ldif will also remove the replica state from the output. In this case, the LDIF created by the cleanup-local-server subcommand does not need to be applied after the server is restarted

dsreplication cleanup-local-server --changelogDir changelogDb

Disable replication on the specified server for the provided base DN and removes references to this server in the other servers with which it is replicating data

dsreplication disable --hostname host.example.com --port 1389 \
     --baseDN dc=example,dc=com --adminUID admin --adminPassword secret \
     --no-prompt

Update the configuration of the servers to replicate the data under the specified base DN. If one of the servers is already replicating the data under the base DN with other servers, executing this subcommand will update the configuration of all the servers (so it is sufficient to execute the command-line once for each server you add to the replication topology). The server-to-server replication communication is always secured with SSL.

dsreplication enable --host1 server1.example.com --port1 1389 \
     --bindDN1 "cn=Directory Manager" --bindPassword1 secret1 \
     --replicationPort1 8989 --host2 server2.example.com --port2 1389 \
     --bindDN2 "cn=Directory Manager" --bindPassword2 secret2 \
     --replicationPort2 8989 --baseDN dc=example,dc=com --adminUID admin \
     --adminPassword secret --no-prompt

Initialize the data under a specified base DN on the destination server with the contents on a source server ('initialize-all' can also be used for this purpose)

dsreplication initialize --hostSource src.example.com --portSource 1389 \
     --hostDestination dst.example.com --portDestination 2389 \
     --baseDN dc=example,dc=com --adminUID admin --adminPassword secret \
     --no-prompt

Initialize the data under a specified base DN on all the servers in the replication topology with the contents on a specified server ('initialize' applied to each server can also be used for this purpose)

dsreplication initialize-all --hostname source.example.com --port 1389 \
     --baseDN dc=example,dc=com --adminUID admin \
     --adminPasswordFile password.txt --no-prompt

This subcommand must be called after replacing the data for one or more base DNs across all servers. You must specify the list of base DNs that have been initialized and apply the subcommand, once, to any of the replicating servers. See the usage of the 'post-external-initialization' subcommand for more information

dsreplication post-external-initialization --hostname host.example.com \
     --port 1389 --baseDN dc=example,dc=com \
     --baseDN ou=people,dc=example,dc=com --adminUID admin \
     --adminPassword secret

This subcommand must be called once before replacing the data for one or more replicating base DNs. You must specify the list of base DNs that will have the data replaced and apply the subcommand to any of the servers taking part in replication of the base DNs. After calling this subcommand, replace the data on one server for the base DNs using import-ldif or restore. Then initialize all other servers in the topology with the initialize subcommand, followed finally by the 'post-external-initialization' subcommand

dsreplication pre-external-initialization --hostname host.example.com \
     --port 1389 --baseDN dc=example,dc=com --adminUID admin \
     --adminPassword secret

Remove an offline defunct server from a replication topology

dsreplication remove-defunct-server --hostname host.example.com --port 1389 \
     --adminUID admin --adminPassword secret --no-prompt --defunctHost deadhost \
     --defunctPort 2389 --defunctReplPort 2989

Display the basic replication configuration information for the base DNs of the servers defined in the registration information. If no base DNs are specified as parameters, the information for all base DNs is displayed

dsreplication status --hostname host.example.com --port 1389 --adminUID admin \
     --adminPassword secret --no-prompt

dsreplication status --baseDN dc=example,dc=com --location Austin

dsreplication status --displayServerTable --showAll

Arguments

-V
--version

-H
--help

--help-debug

--help-subcommands

--useNoSecurity

-o {name=value}
--saslOption {name=value}

-X
--trustAll

-P {truststorePath}
--trustStorePath {truststorePath}

-T {truststorePassword}
--trustStorePassword {truststorePassword}

-U {path}
--trustStorePasswordFile {path}

-K {keystorePath}
--keyStorePath {keystorePath}

-W {keystorePassword}
--keyStorePassword {keystorePassword}

-u {keystorePasswordFile}
--keyStorePasswordFile {keystorePasswordFile}

-N {nickname}
--certNickname {nickname}

--propertiesFilePath {propertiesFilePath}

--noPropertiesFile

--script-friendly

-b {baseDN}
--baseDN {baseDN}

-I {adminUID}
--adminUID {adminUID}

-w {bindPassword}
--adminPassword {bindPassword}

-j {bindPasswordFile}
--adminPasswordFile {bindPasswordFile}

-n
--no-prompt

-Q
--quiet

--ignoreWarnings

--ignoreLock