PingDirectory

Removing the administrative console

You can remove the administrative console from your PingDirectory deployment.

About this task

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. In the dn: cn=Console,cn=Web Applications,cn=config section, remove the following lines:

      objectClass: ds-cfg-console-web-application-extension
      objectClass: ds-cfg-web-application-extension
      objectClass: top
      cn: Console
      ds-cfg-description: The Administrative Console
      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.