Troubleshooting ¶

Getting started ¶

Examples Not Working ¶

Many common errors using Ping containers arise from using stale images. Our development is highly dynamic and Docker images can rapidly change.

To avoid issues with stale images, remove all local images from your local cache. Doing so will force Docker to pull the latest images:

docker rmi $(docker images "pingidentity/*" -q)

Moving tag

Even though you might have a local image tagged "latest", this tag does not guarantee it is the newest image in the Docker hub registry. This tag is reapplied for each release image.

Misconfigured `pingctl` ¶

If your containers cannot pull a license based on your DevOps user name and key, there might be some misconfiguration in your pingctl config file.

Possible solutions:

If you have ran pingctl config for the first time, see the Environment Configuration Documentation on how to export configured variables to your environment.
Run pingctl info and make sure the configured variables in the utility are correct. See the utility's documentation for more information.

Unable To Retrieve Evaluation License ¶

If a product instance or instances cannot retrieve the evaluation license, you might receive an error similar to this:

----- Starting hook: /opt/staging/hooks/17-check-license.sh
Pulling evaluation license from Ping Identity for:
              Prod License: PD - v7.3
              DevOps User: some-devops-user@example.com...
Unable to download evaluation product.lic (000), most likely due to invalid PING_IDENTITY_DEVOPS_USER/PING_IDENTITY_DEVOPS_KEY

##################################################################################
############################        ALERT        #################################
##################################################################################
#
# No Ping Identity License File (PingDirectory.lic) was found in the server profile.
# No Ping Identity DevOps User or Key was passed.
#
#
# More info on obtaining your DevOps User and Key can be found at:
#     https://devops.pingidentity.com/how-to/devopsRegistration/
#
##################################################################################
CONTAINER FAILURE: License File absent
CONTAINER FAILURE: Error running 17-check-license.sh
CONTAINER FAILURE: Error running 10-start-sequence.sh

This error can be caused by:

An invalid DevOps user name or key (as noted in the error). This failure is usually caused by some issue with the variables being passed in. To verify the variables in the pingctl configuration are correct for running Docker commands, run the following command:
```
pingctl info
```
A bad Docker image. Pull the Docker image again to verify.
Network connectivity to the license server is blocked. To test this, on the machine that is running the container, run:
```
curl -k https://license.pingidentity.com/devops/license
```
If the license server is reachable, you will receive an error similar to this example:
```
{ "error":"missing devops-user header" }
```