PingDirectory

Uninstalling the PingDirectory and PingDirectoryProxy servers

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 either 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

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.

About this task

If the uninstall command cannot remove all of the server files, it generates a message with a list of the files and directories that must be deleted manually. The uninstall command must be run as either the root user or the same user (or role) that installed the server.

Steps

  1. From the server root directory, run the uninstall command.

    Example:

    $ ./uninstall

  2. Select the components to be removed.

    Choose from:

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

      For each type of server component, press Enter to remove it or enter no to keep it.

  3. 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 6.

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

  5. Select how you want to trust the server certificate if you have set up SSL or StartTLS. Press Enter to accept the default.

    Example:

    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 [3]:

  6. View the logs for any remaining files and manually remove any remaining files or directories.

    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.

About this task

Another useful argument is the --forceOnError option that continues the uninstall process when an error is encountered. If an option is incorrectly entered or if a required option is omitted and the --forceOnError option is not used, the command fails and aborts.

Steps

  1. From the server root directory, run uninstall with the --remove-all option to remove all of the server’s libraries.

    The optional --quiet option suppresses output information.

    Example:

    The following command assumes that the server is standalone and not part of a replication topology:

    $ ./uninstall --remove-all --no-prompt --quiet --forceOnError

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

Steps

  1. From the server root directory, run the uninstall command with the --backup-files option.

    Example:
    $ ./uninstall --backup-files --no-prompt --quiet --forceOnError

  2. To view the other options available to remove specific components, use the --help or -H option.