PingDirectory

Removing the administrative console

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

Steps

Follow these steps to remove the administrative 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 administrative console from your PingDirectory deployment.

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