OpsRamp agents can connect to the OpsRamp cloud in two ways:

  • Direct Agent: The direct agent connects to the OpsRamp cloud directly, and this type of agent does not require any special configuration.
  • Proxy Agent: The proxy agents are configured to connect to the cloud using an HTTP proxy embedded in the gateway.

The gateway proxy servers help agents to connect to the cloud so that the agents do not need direct access to the OpsRamp cloud.

Download the proxy agent

To download the proxy agent:

  1. Select a client and go to Setup.
  2. From the left pane, click Downloads > Agent.
  3. Select the client and change the type from Direct to Proxy.
  4. Select the Gateway management profile from the dropdown.

The selected gateway profile is used as a Proxy server for agents to connect to the OpsRamp cloud.

How do the agents connect to OpsRamp Cloud via Gateway proxy?

When the gateway profile is selected during agent download, the IP address, proxy port, and gateway profile UUID are automatically included in the Agent installers and instructions.

Agent file typeGateway detailsExample format
Windows EXEGateway IP, port, and UUID details are prepackaged at the time of download in the installer.N/A
Windows MSIAfter installing the agent MSI, follow the instruction page. Gateway details like proxy IP, port, and UUID will be automatically added to the instructions.msiexec.exe /i {.msi file path in quotes} /quiet WRAPPED_ARGUMENTS="/silent /apiserver=test.api.opsramp.com /key=v5TwJ7hEGmGKcXWScvDDtsYq6eX6ugf9 /secret=7kyyaSfCxfM6nwn5VCsarrRffyqbSchkWbNjTpNANfQvKKNdBC3M25mumx48YtXH /clientid=client_292263 /proxyip=172.25.251.7 /proxyport=3128 /gatewayprofileuuid=46513269-7e38-4d3c-8fe9-df1ceda1mv24"
Linux deployment script Python and Shell.Gateway IP, port, and UUID details are prepackaged at the time of download in agent deployment script for both Python and Shell script.N/A
Ansible-based agent deployment.Gateway IP, port, and UUID details are prepackaged at the time of download in ansible-based agent deployment playbook.N/A
Installers for individual Linux and FreeBSD distributions.After installing the agent on the respective operating system, follow the instruction page. Gateway details like proxy IP, port, and UUID will be automatically added to the instructions.sudo /opt/opsramp/agent/bin/configure -K v5TwJ7hEGmGKcXWScvDDtsYq6eX6ugf9 -S 7kyyaSfCxfM6nwn5VCsarrRffyqbSchkWbNjTpNANfQvKKNdBC3M25mumx48YtXH -s test.api.opsramp.com -m proxy
-x 172.25.251.7
-p 3128
-G 46513269-7e38-4d3c-8fe9-df1ceda1mv24