PingDirectory

Uninstalling the servers

You can run the uninstall command-line utility for quick removal of the server. The command runs in either of the following modes:

Interactive mode

Interactive mode prompts you for input in a text-based interface.

To use this mode, run the uninstall command without any options.

Non-interactive mode

Non-interactive mode uninstalls the server without displaying any processing information, except for fatal errors.

To use this mode, run the uninstall command with the --no-prompt option.

  • If the server is running, it shuts down before uninstallation continues. The uninstall action processes the removal requests before completing.

  • If the uninstall command can’t remove all of the server files indicated, it lists any remaining files and directories. Delete these manually.

  • For standalone installations with a single server instance, you can also remove the server manually by stopping it and recursively deleting its directory and subdirectories, as shown in the following example:

    $ rm -rf /ds/PingDirectory

Interactive mode

You must run the uninstall command as either the root user or the same user (or role) that installed the server.

To uninstall the server in interactive mode:

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 don’t 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 type no to keep it.

  3. Follow the next steps for your server type:

    Choose from:

    • For standalone servers, delete any files or directories that the uninstall tool couldn’t remove. The uninstallation is complete.

    • For replicated servers, continue with the following steps:

      1. Type yes to provide your authentication credentials (Global Administrator ID and password).

      2. Enter the Global Administrator ID and password to remove references to this server in other replicated servers, and then enter or verify the host name or IP address for the server that you’re uninstalling.

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

Non-interactive mode

To uninstall the server in non-interactive mode:

Steps

  • Run uninstall with the appropriate options:

    Choose from:

    • To remove all of the server’s libraries, include the --remove-all option.

      Example:

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

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

      • You can use the --ignoreWarnings option to continue the uninstall process even when an error occurs. Otherwise, if an option is incorrectly entered or a required option is omitted, the command fails and aborts.

      • The --quiet option suppresses output information.

    • To remove the server’s backup files, include the --backup-files option.

      Example:

      $ ./uninstall --backup-files --no-prompt --quiet --ignoreWarnings

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