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:
-
If you have just run
./setup
for the first time, make sure you are have done so in a fresh terminal or have runsource ~/.bash_profile
. -
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.
-
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:
-
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
-
A bad Docker image. Pull the Docker image again to verify.
-
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" }