Disabling replication and removing a server from the topology - PingDirectory - 10.1

PingDirectory 10.1

bundle
pingdirectory-101
ft:publication_title
PingDirectory 10.1
Product_Version_ce
PingDirectory 10.1 (Latest)
category
Product
pd-101
pingdirectory
ContentType_ce
More than 50% of the servers not being removed from the topology must be online during the process.

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.

Removing a live server

  • 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
    Note:

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

Removing an offline server from the topology

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

    Note:

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

    Tip:

    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.