The server provides an uninstall command-line utility for quick removal of the code base.
To uninstall a server instance, run the setup command in interactive command-line, or non-interactive command-line mode.
- Interactive command-line mode
- Interactive command-line mode is a text-based interface that prompts the user for input. To use this mode, run the bin/uninstall command without any options.
- Non-interactive command-line mode
- Non-interactive command-line mode suppresses progress information from being written to standard output during processing, except for fatal errors. To run this mode, use the bin/uninstall command with the --no-prompt option.
For standalone installations with a single server instance, you can also manually remove the server by stopping it and recursively deleting the directory and subdirectories as shown in the following example:
$ rm -rf /ds/PingDirectory
Click the following tabs to see instructions for the type of uninstall you want to perform.
Uninstalling the server in interactive mode
Interactive mode uses the uninstall command, a text-based, command-line interface to help you remove your server instance.
From the server root directory, run the uninstall command.
Select the components to be removed.
- Remove all components - If you want to remove all components, press Enter to accept the default (remove all).
- Select the components to be removed - If you do not want to remove all
components, enter the option to specify the removal of only specific
For each type of server component, press Enter to remove it or enter no to keep it.
- If the server is part of a replication topology, enter yes to provide your authentication credentials (Global Administrator ID and password). If you are uninstalling a standalone server, continue to step 7.
- Enter the Global Administrator ID and password to remove the references to this server in other replicated servers, and then enter or verify the host name or IP address for the server that you are uninstalling.
Select how you want to trust the server certificate if you have set up SSL or
StartTLS. Press Enter to accept the default.
How do you want to trust the server certificate for the PingDirectory Server on server.example.com:389? 1) Automatically trust 2) Use a trust store 3) Manually validate Enter choice :
View the logs for any remaining files and manually remove any remaining files or
If your server is running, it shuts down before continuing the uninstall process. The uninstall action processes the removal requests before completing.
Uninstalling the server in non-interactive mode
The uninstall command provides a non-interactive method to run with the --no-prompt option.
From the server root directory, run uninstall with the
--remove-all option to remove all of the server’s
The optional --quiet option suppresses output information.
The following command assumes that the server is standalone and not part of a replication topology:
$ ./uninstall --remove-all --no-prompt --quiet --forceOnError
- View the logs for any remaining files and manually remove any remaining files or directories.
Uninstalling selected components in non-interactive mode
Use the --backup-files with the uninstall command to remove the server’s backup files.
From the server root directory, run the uninstall command with
the --backup-files option.
$ ./uninstall --backup-files --no-prompt --quiet --forceOnError
- To view the other options available to remove specific components, use the --help or -H option.