Skip to content

Troubleshooting

Getting started

Examples Not Working

One of the most common errors is from having stale images. Our development is highly dynamic and Docker images can rapidly change.

To avoid issues with stale images and have Docker pull the latest images by removing all the local, enter:

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

Having images tagged as "latest" locally does not mean they are the latest in the Docker hub registry.

Misconfigured ~/.bash_profile file

If your containers can't pull a license based on your DevOps user name and key, or running dhelp returns an error, there might be some misconfiguration in your ~/.bash_profile file.

Possible solutions:

  1. If you have just run ./setup for the first time, make sure you are have done so in a fresh terminal or have run source ~/.bash_profile.

  2. If running echo PING_IDENTITY_DEVOPS_USER returns nothing in a fresh terminal, it's likely your ~/.bash_profile file is misconfigured. There are two entries that need to be there:

    source <path>/pingidentity-devops-getting-started/bash_profile_devops

    Where <path> is the full path to the pingidentity-devops-getting-started directory. This entry sources our DevOps aliases.

    There also needs to be another entry for:

    sourcePingIdentityFiles

    This entry sources the Ping Identity file aliases.

    Make sure there are not old versions or duplicates of these entries.

  3. If you are running in Kubernetes, keep in mind that your PING_IDENTITY_DEVOPS_USER and key are local variables and need to be Passed as a Secret in your cluster.

Unable To Retrieve Evaluation License

If a product instance or instances can't get 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/get-started/devopsRegistration/
#
##################################################################################
CONTAINER FAILURE: License File absent
CONTAINER FAILURE: Error running 17-check-license.sh
CONTAINER FAILURE: Error running 10-start-sequence.sh

This can be caused by:

  1. An invalid DevOps user name or key (as noted in the error). This is usually caused by some issue with the variables being passed in.

    To verify the variables are available to the shell running (when running Docker commands), enter:

    echo $PING_IDENTITY_DEVOPS_USER $PING_IDENTITY_DEVOPS_KEY

  2. A bad Docker image. Pull the Docker image again to verify.

  3. Network connectivity to the license server is blocked. To test this, from the machine that's running the container, enter:

    curl -k https://license.pingidentity.com/devops/license

    If the license server is accessible, you receive an error similar to this:

    { "error":"missing devops-user header" }