Setting up the administrative console on a Tomcat environment

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

Before you begin

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.

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.
To keep the Tomcat server information from being exposed, in the Host section of the Tomcat_directory/conf/server.xml file, add the following line:
```
<Valve className="org.apache.catalina.valves.ErrorReportValve" showReport="true" showServerInfo="false" />
```
This information is sourced from the Smart Scanner website, where you can learn more about this Tomcat server vulnerability.
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.

Result:

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.