When troubleshooting issues with On-Premise Locations (OPLs), you may discover one or more image tags missing. This article will walk you through how to check if this problem is present and how to resolve it.
When to Check
Check for missing image tags any time that a test fails to run properly on an OPL. A number of unexpected behaviors can occur when an OPL has one or more images missing tags.
How to Check
There are two methods to check for any missing images on your OPL.
Method #1: Check via the API
The quickest way is to check via the BlazeMeter API's Private Locations resource, which will list out all images for all agents (aka ships), among other details:
Or to check images for a specific ship, use the following instead:
NOTE: You can find the Harbor ID and each Ship ID in this article.
Method #2: Check via Docker
The other method is by checking directly on the Docker host itself:
- Log on to the machine hosting your Docker containers.
- From the terminal, run the command
sudo docker images. You should see a list of various images appear, similar to the following example:
NOTE: Versions are updated regularly so your version numbers may differ from the ones above, which were current as of the time of this writing.
- Each of the following images should be included in the list:
blazemeter/proxy-recorder apm-imageNOTE: If any of the above are not listed, you must regenerate the agent.
- Once you verify all images are present, next make sure there are two of each image: one with a version number tag, and the other with a "latest" tag.
For example, "blazemeter/crane" should appear twice, one with a version tag ("2.2.0-425" in this example) and another with a "latest" tag, such as in this example:
- If if you have all of the images above and a version and "latest" tag for each image, then you likely are not missing any tags. If you are missing any of the above, please proceed to the next section of this article.
How to Fix
Let's say, for example, after running
sudo docker images you see something similar to the following among the other images listed (the list of images here is shortened to save space - see the previous example for the full list you should see):
Notice how the "blazemeter" image has no "latest" tag? This is easy to fix via the following steps:
- Enter the command
sudo docker tag <IMAGE_ID> <REPOSITORY>:latest
Replace <IMAGE_ID> with the value from the column above, and <REPOSITORY> with the image name from the respective column.
So for our "blazemeter" image, we would enter:
- After running the above command to add the missing tag, list the images again vis
sudo docker imagesto ensure the added tag now appears in the list.
That's all there is to it! You should now have all of your tags updated and are ready to resume executing your tests!