PingDirectory

Removing the admin console

You can remove the admin console from your PingDirectory deployment.

About this task

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