Show Table of Contents
4.8. Removing Directory Server Instances
4.8.1. Removing a Single Directory Server Instance
It is possible to remove a single instance of Directory Server without uninstalling all other instances, removing an Admin Server instance, or removing the packages.
# remove-ds.pl -i instance_name -a
The script prompts for the administrative password.
Note
The Directory Server instance must be running for the script to bind to the server.
The
remove-ds.pl script unregisters the server from the Configuration Directory Server and removes any related files and directories.
By default, the
key and cert files are left in the instance configuration directory, and the configuration directory is renamed removed.instance-name. Using the -a option (as shown) removes the security databases, as well.
Note
If there is a problem with the Directory Server, like the installation failed or the server cannot be restarted, then running
remove-ds.pl script fails. In this case, try the -f option to force the removal process.
4.8.2. Removing a Directory Server Instance and Admin Server
It is possible to remove both the Directory Server and the Admin Server (if configured on the same system).
# remove-ds-admin.pl -y -a [-f]
The
-y option is required for the script to perform the removal operation. Otherwise, the remove-ds-admin.pl script performs a dry-run but does not remove any servers.
The
-a option is not required, but it is recommended if a Directory Server or Admin Server instance may be re-configured on the system later. By default, all of the security databases are preserved by the removal script. The -a option removes the security databases, as well.
The script prompts for the administrative password.
Note
The Directory Server instance must be running for the script to bind to the server.
Note
If there is a problem with the Directory Server, like the installation failed or the server cannot be restarted, then running
remove-ds.pl script fails. In this case, try the -f option to force the removal process.

Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.