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 -R argument of export-ldif. The resulting LDIF can be reimported using import-ldif. For example, export-ldif -n userRoot -R -l cleansed.ldif import-ldif -n userRoot -l cleansed.ldif Exporting using the -R 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

Detaches a single Directory Server instance or Directory Server instances in the same replication set from the rest of the replication topology. This will create two independent replication topologies. After the detaching process completes, replication will not propagate update messages between the removed server (or servers) and the rest of the replication topology

dsreplication detach --hostname host.example.com --port 1389 --adminUID admin \
     --adminPassword secret --setName setA

dsreplication detach --hostname host.example.com --port 1389 --adminUID admin \
     --adminPassword secret

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

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. This operation performs a background export and import and should only be used for replicated base DNs whose database files are less than 1 GB in size ('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. This operation performs a background export and import and should only be used for replicated base DNs whose database files are less than 1 GB in size ('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 initializing the contents of all the replicated servers using the import-ldif tool or the binary copy method. You must specify the list of base DNs that have been initialized and provide the credentials of any of the servers that are being replicated. 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 before initializing the contents of all the replicated servers using the import-ldif tool or the binary copy method. You must specify the list of base DNs that will be initialized and provide the credentials of any of the servers that are being replicated. After calling this subcommand, initialize the contents of all the servers in the topology, then call 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

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}

-b {baseDN}
--baseDN {baseDN}

-I {adminUID}
--adminUID {adminUID}

-w {bindPassword}
--adminPassword {bindPassword}

-j {bindPasswordFile}
--adminPasswordFile {bindPasswordFile}

-n
--no-prompt

-Q
--quiet

--ignoreWarnings

--ignoreLock

--noPropertiesFile