Deploying the administrative console - PingDirectory

Deploying the administrative console - PingDirectory - 9.3

PingDirectory 9.3

bundle

pingdirectory-93

ft:publication_title

PingDirectory 9.3

Product_Version_ce

PingDirectory 9.3 (Latest)

Using Docker to run a standalone administrative console

The administrative console is available as a standalone Docker image on Docker Hub. To see a docker-compose example that deploys a PingDirectory container with a corresponding console, see the PingDirectory getting started demo.

Note:

The Ping Identity Helm charts also include support for the administrative console, which you should use when deploying the console in Kubernetes.

To connect with a PingDirectory server that is deployed in Docker, run the administrative console image in a local Docker deployment.

The network you use must match the network used by the PingDirectory server's container.
The following example deploys the standalone console image in a local Docker deployment with the console listening on port 8443 using the pingnet network:
```
docker run \
    --name pingdataconsole \
    --publish 8443:8443 \
    --network pingnet \
    --detach \
    pingidentity/pingdataconsole:edge
```
Important:
You can change the first port in the --publish line based on what port you want to use on your local machine, but you shouldn't change the second port. To access the console outside of Docker on port 9443, for example, use 9443:8443.

To access the console, go to https://<hostname>:<port>/console/login and enter the following credentials.

Field	Credential
Server	`<PingDirectory container name>:<LDAPS port>` Note: The name of the server you enter on the sign-on page must match the name of the PingDirectory container you are trying to connect to along with the LDAPS port of that container. For example, use `pingdirectory:1636` to connect to a standalone PingDirectory Docker container on the same network.
Username	`administrator`
Password	`2FederateM0re`

Setting up the administrative console on a Tomcat environment

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 archive from the Apache Tomcat downloads page.
Extract the .zip archive.
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 startup.sh or startup.bat 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.