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 using Docker for Mac 4.3.0 or above, add the following parameter to the command:
--privileged -v /sys/fs/cgroup:/sys/fs/cgroup:rw
- 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.
After the command has finished running, a container is created (called bzm-crane-<shipId>) and the images required for the installation begin to download. Downloads can take up to 30 minutes (depending on the network speed on the machine) - during this time, the new agent is listed in the Private Location section, and it indicates its status as 'Downloading'.
After the download has finished, the agent indicates to be in an 'Idle' status and is available for use. Visit this article to learn how to use your new private location!
To check the downloaded docker images, use the following command:
$ sudo docker images
You should see something similar to the following depending on what functionalities you selected (both tags MUST be present for proper functionality) when creating the private location:
Now that you have an Agent installed, let's have a look at how you use your new Private Location.