Installing a BlazeMeter Agent for Docker
You want 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.
- Go to Workspaces, Private Locations and choose the Private Location where you want to create the Agent.
-
Click Add agent.
- Enter a new agent name that helps your team members recognize what to use this location for.
- (Optional) Enter the IP address of the machine.
- Click Create Agent.
- BlazeMeter generates a Docker installation command in 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 – Service Virtualization.
After the command has finished running, a container is created (called bzm-crane-<agentId>) 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. For more information about how to use your new private location, see Using Private Locations.
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:
REPOSITORY TAG IMAGE ID CREATED SIZE taurus-cloud 1.13.0-975 5df8fa4f6613 11 days ago 3.76GB taurus-cloud latest 5df8fa4f6613 11 days ago 3.76GB apm-image 1.3.0-826 58c5cfab39a2 2 weeks ago 281MB apm-image latest 58c5cfab39a2 2 weeks ago 281MB blazemeter/crane 3.1.1-1425 7e1c470769df 5 weeks ago 700MB blazemeter/crane latest 7e1c470769df 5 weeks ago 700MB blazemeter/proxy-recorder 1.9.0-833 cb9cdf0c1067 3 weeks ago 1.13GB blazemeter/proxy-recorder latest cb9cdf0c1067 3 weeks ago 1.13GB blazemeter/service-mock 0.2.4-11 df8d54721102 3 days ago 165MB blazemeter/service-mock latest df8d54721102 3 days ago 165MB blazemeter/charmander/firefox_65.0.2 2.1.0-266 681cf263e9d1 8 hours ago 1.45GB blazemeter/charmander/firefox_65.0.2 latest 681cf263e9d1 8 hours ago 1.45GB blazemeter/charmander/chrome_69.0.3497.92 2.1.0-266 89fb01cb9950 8 hours ago 1.47GB blazemeter/charmander/chrome_69.0.3497.92 latest 89fb01cb9950 8 hours ago 1.47GB
Now that you have an Agent installed, let's have a look at how you use your new Private Location.