Setting up the administrative console on a Tomcat environment - PingDirectory

Page created: 7 Dec 2021 |

Page updated: 14 Jan 2022

| 1 min read

9.0 Product PingDirectory

Use a Java application server to set up the administrative console as a standalone instance.

To set up a standalone console, you need the admin-console.war file from the PingDirectory Server's resource/admin-console.zip archive.

You can use the .war file with Java application servers, such as Tomcat or Jetty. The following example uses Tomcat as the server environment.

Note:

Because Tomcat server version 10 has a defect with Spring Boot applications, use Tomcat 9 instead.

Download the Tomcat 9 .zip file from the Apache Tomcat downloads page.
Extract the .zip archive files.
To set up the Tomcat server, follow the instructions in the RUNNING.txt file from the extracted directory.
Copy the admin-console.war file into the webapps folder in the Tomcat root directory.
To start the Tomcat server, run the startup.sh or startup.bat file from the bin folder of the Tomcat root directory.

Tomcat automatically extracts the console from the compressed .war file into an exploded application directory and starts running the console.
To access the console, use the admin-console path from the Tomcat server path.

By default, the path to access the console is localhost:8080/admin-console.