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:
- Select a client and go to Setup.
- From the left pane, click Downloads > Agent.
- Select the client and change the type from Direct to Proxy.
- 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.
Note
The gateway should have a static IP address. Make sure to start the proxy service on the gateway before installing the agents.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 type | Gateway details | Example format |
|---|---|---|
| Windows EXE | Gateway IP, port, and UUID details are prepackaged at the time of download in the installer. | N/A |
| Windows MSI | After 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 |