PingDirectory

Disabling replication and removing a server from the topology

Before you begin

More than 50% of the servers not being removed from the topology must be online during the process.

About this task

When removing a server from the topology, the remaining servers need to be made aware of the change. If additional servers are offline and cannot be online while removing the server, you must distinguish between offline servers that are offline permanently and those that are offline temporarily.

  • Remove a live server

  • Remove an offline server

Removing a live server

Steps

  • To remove a server that is online, run the dsreplication disable command from any server.

    $ bin/dsreplication disable --hostname austin03.example.com --port 1389 \
--baseDN dc=example,dc=com --adminUID admin --adminPassword password \
--no-prompt

    If the server to remove is online, only one invocation of dsreplication disable is necessary.

Removing an offline server from the topology

Steps

  • To remove a defunct or misbehaving server from the topology while that server is offline, run remove-defunct-server from a live server in the topology. Doing this will remove configuration references to the offline server from the topology’s perspective. This is useful if the server is broken and cannot start. For example:

    $ bin/remove-defunct-server --serverInstanceName austin01 \
--bindDN "cn=Directory Manager" --bindPassword password

    After you have removed the server, you can delete it. However, if you want to keep the server as a standalone server, proceed to Cleaning up an offline defunct server.

    The --ignore-online option removes an online server cleanly from the topology.

    To speed up the process of removing multiple servers, change the default 10-minute timeout for each server you are taking out of rotation by setting the Java virtual machine (JVM) property com.unboundid.connectionutils.LdapResponseTimeoutMillis before you run remove-defunct-server.