PingDirectory

Removing the admin console

This topic describes how to remove the admin console from PingDirectory after installation. You can configure and operate the PingDirectory server without the admin console by using the command-line interface (CLI). There aren’t any server functions available from the admin console that aren’t also available through the CLI.

Steps

Follow these steps to remove the admin console from your PingDirectory deployment:

  1. Stop the server.

    Example:

    $ bin/stop-server

  2. Remove the console.war file from the webapps directory.

  3. Edit the config/config.ldif file as follows:

    1. In the dn: cn=HTTPS Connection Handler,cn=Connection Handlers,cn=config section, remove the following line:

      ds-cfg-web-application-extension: cn=Console,cn=Web Applications,cn=config

    2. Delete the entire dn: cn=Console,cn=Web Applications,cn=config entry, including the following lines:

      dn: cn=Console,cn=Web Applications,cn=config
objectClass: top
objectClass: ds-cfg-web-application-extension
objectClass: ds-cfg-console-web-application-extension
ds-cfg-application-title: PingDirectory Admin Console
cn: Console
ds-cfg-description: The Administrative Console
ds-cfg-base-context-path: /console
ds-cfg-war-file: webapps/console.war
ds-cfg-ldap-server: ldaps://<server-hostname>:<ldaps-port>
ds-cfg-java-class: com.unboundid.directory.server.protocols.http.ConsoleWebApplicationExtension
ds-cfg-log-file: logs/webapps/console.log

    3. Save your changes.

  4. Restart the server.

    Example:

    $ bin/start-server

Result:

You have successfully removed the admin console from your PingDirectory deployment.

Upgrading the server after removing the admin console restores the console.war file but doesn’t affect the console configurations that you removed from config.ldif. The admin console won’t run with these configurations removed. Optionally, you can remove console.war after completing a server upgrade.