The following article explains how to install a BlazeMeter on-premise agent for Docker on your server/instance behind your firewall.
Prerequisites: Before proceeding with installation, ensure that your server/instance meets the minimum requirements. For more information, see Private Location System Requirements.
- Log into your BlazeMeter account and click Settings in the top right corner.
- Navigate to the Private Location where you want to create the Agent. Go to Workspaces, Private Locations and choose the Private Location.
- Click Add agent.
- Enter the agent name.
- (Optional) Enter the IP address of the machine.
- Click Create Agent.
- A Docker installation command is generated on the Docker Command tab.
- Copy the command, add environment variables as per details of your Docker instance, then run the updated command on your private engine. For more information, see BlazeMeter Agent Environment Variables.
- Installing the agent inside Docker requires sufficient permissions (root access required).
- When installing an agent behind a corporate proxy, follow these additional steps.
- When installing an agent that uses a CA certificate, follow these additional steps.
- When installing an agent on a host with multiple network interfaces, follow these additional steps.
- If your application requires a custom certificate to be able to communicate over HTTPS, see Optional Installation Step: Bring Your Own Certificate – Mock Services.
- Once the command has finished running, a container will be created (called bzm-crane-<shipId>) and the images required for the installation will begin to download. Downloads can take up to 30 minutes (depending on the network speed on the machine) - during this time, the new agent will be listed in the Private Location, and show up with the 'Downloading' status.
- Once the download has finished, the agent will show to be in an 'Idle' status and will be available for use. Visit this article to learn how to use your new private location!
- Optional: You can check the downloaded docker images using the following command:
$ sudo docker imagesYou should see something similar to the following depending on what functionalities you selected in the private location (both tags MUST be present for proper functionality):