The following article explains how to install, uninstall, and regenerate BlazeMeter's on-premise agent on your server/instance behind your firewall.

First, make sure your server/instance meets the minimum requirements as described in this article. 

• Installing a Docker Agent
• Installing a Kubernetes Agent

Installing a Docker Agent

1. Log into your BlazeMeter account and click on the cog in the top right corner of the screen.
2. Navigate to the private location where you want to create the Agent: go to Workspaces -> Private Locations and choose the Private Location.
   
3. Choose "Add agent".
   
4. Provide a name for the new agent, and optionally, the IP address of the machine.
   
5. A Docker installation command will be generated on the Docker Command tab - Copy the command and run it on your private engine.
   NOTE: Installing the agent inside Docker requires sufficient permissions (root access required).
   NOTE: When installing an agent behind a corporate proxy, follow these additional steps
   NOTE: When installing an agent that uses a CA certificate, follow these additional steps
   NOTE: When installing an agent on a host with multiple network interfaces, follow these additional steps
   
6. 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.
   
   
7. 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!
   
8. Optional: You can check the downloaded docker images using the following command:
   

   $ sudo docker images

   You 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):

   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 review how you can use your new Private Location!

Installing a Kubernetes Agent

1. Log into your BlazeMeter account and click on the cog in the top right corner of the screen.
2. Navigate to the private location where you want to create the Agent: go to Workspaces -> Private Locations and choose the Private Location.
   
3. Choose "Add agent".
   
4. Provide a name for the new agent, and optionally, the IP address of the machine.
   
5. A Kubernetes installation command and configuration will be generated on the Kubernetes Configuration tab - Copy the command, update the variables as per details of your Kubernetes instance, then run the updated command on your private engine. For details, see Kubernetes Installation Configuration.
   
   NOTE: When installing an agent behind a corporate proxy, follow these additional steps
   NOTE: When installing an agent that uses a CA certificate, follow these additional steps
6. Use the following command to check on the status of the pod launch for the crane deployment:
   kubectl get pods
7. Once the Kubernetes pod shows as 'Running',  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!
   

Now that you have an Agent installed, let's review how you can use your new Private Location!