Synchronization Server Documentation Index
Command-Line Tool Reference Home

remove-defunct-server

Description
Examples
Arguments

Description

Remove a server from this server's topology.

This tool will remove a Synchronization Server from a topology by removing Sync Server External Server instances and server descriptors referring to a chosen server from admin backends and configurations of all other peers in the topology. Servers available for removal are discovered through the local server's admin data and can be listed using dsframework.

This tool need only be used when a Synchronization Server has been permanently made unavailable since a server is removed from its topology by the uninstall tool.

Examples

Interactively choose a server to remove from the local server's topology. The tool will prompt for manager credentials for each server in the topology:
remove-defunct-server


Remove a specific server from the topology by specifying its admin server ID. The manager bind DN and password are used to to interact with all servers in the topology:
remove-defunct-server --serverID server1.example.com:1389 \
     --bindDN "cn=Directory Manager" --bindPassword secret

Arguments

-V
--version

Description Display Synchronization Server version information

-H
--help

Description Display general usage information

--help-debug

Description Display help for using debug options
Advanced Yes

-D {bindDN}
--bindDN {bindDN}

Description DN used to bind to the server
Default Value cn=Directory Manager
Required No
Multi-Valued No

-w {bindPassword}
--bindPassword {bindPassword}

Description Password used to bind to the server
Required No
Multi-Valued No

-j {bindPasswordFile}
--bindPasswordFile {bindPasswordFile}

Description Bind password file
Required No
Multi-Valued No

--serverID {serverID}

Description ID of the server to unregister. Use 'dsframework list-servers' to get a list of server IDs
Required No
Multi-Valued No

-n
--no-prompt

Description Use non-interactive mode. If data in the command is missing, you will not be prompted and the tool will fail

-c
--continueOnError

Description Continue processing even if there are errors