Documentation update To provide a better user experience, we have now created a separate documentation space for Helix Vulnerability Management. Users of Helix Vulnerability Management (includes BMC Helix Automation Console) can find the latest documentation at BMC Helix Vulnerability Management.

Troubleshooting installation and upgrade issues

This topic describes the problems that you may encounter while installing or upgrading the product and provides their resolution. 

Error encountered while creating a local Docker registry

Before installing or upgrading toTrueSight Automation Console, you are required to create a local Docker registry to pull images. When you run the docker run -d \ command, you may get the following error:

Unable to find image 'registry:2' locally
docker: Error response from daemon: toomanyrequests: You have reached your pull rate limit. You may increase the limit by authenticating and upgrading: https://www.docker.com/increase-rate-limit.
See 'docker run --help'.

This error occurs because from November 2020, Docker has limited the number of Anonymous and Free Docker Hub users to 100 and 200 container image pull requests per six hours. While installing or upgrading TrueSight Automation Console, this error may occur even if you try creating a local registry after six hours. 

Resolution

To prevent this error, use your registered Docker Hub credentials to create a local registry. 

Run the following command to log in to Docker. 

docker login
Login with your Docker ID to push and pull images from Docker Hub. If you don't have a Docker ID, head over to https://hub.docker.com to create one.
Username:<Enter a username>
Password:<Enter a password>

After successfully logging in, continue to create a local registry. For details, see Preparing-for-installation or Preparing-for-upgrade. 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*