Directory Proxy 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 the specified server from the topology. In general, the uninstall tool should be used to remove a server from the topology. The remove-defunct-server tool should only be used if a prior attempt to uninstall a server was unsuccessful or the system where the server was installed is no longer available, leaving the server permanently inaccessible from the topology. If the defunct server is online and is able to reach other servers in the topology, running remove-defunct-server from it will cleanly remove it from the topology. If it cannot reach the other servers, then remove-defunct-server must also be run from one of the online servers.

Examples

Interactively choose a server to remove from the topology. The tool will prompt for credentials to an administrator user that is present on every server in the topology:
remove-defunct-server


Remove a specific server from the topology by specifying its instance name. The bind DN and password must be that of an administrator user that is present on every server in the topology:
remove-defunct-server --serverInstanceName "Austin Directory Proxy Server 1" \
     --bindDN "cn=Directory Manager" --bindPassword secret

Arguments

-V
--version

Description Display Directory Proxy 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 The DN of an administrator user that is present on every server in the topology
Default Value cn=admin
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

--serverInstanceName {serverInstanceName}

Description The instance name of the server to remove
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