Configuring PATROL Agents to support multiple forward proxy servers
This topic provides instructions to configure a PATROL Agent to communicate with the proxy server.
The following video (23:51) provides the process to configure PATROL agents to support proxy server migration to BMC Helix Operations Management:
You can configure one or more proxy servers in your infrastructure so that PATROL Agents can communicate with BMC Helix Operations Management through them, creating an additional security layer. Use of multiple proxy servers improves infrastructure performance by providing high availability.
Setting up a proxy server is optional. To understand how to create a proxy server as a docker container, see Configuring-a-Squid-proxy-server.
Single proxy server
Multiple proxy servers
You can configure the proxy server in one of the following ways:
- During the installation of PATROL Agents
- After the installation of PATROL Agents
To configure the proxy server during the installation of PATROL Agents
To configure forward proxy server, perform the following:
- Single proxy server: Enter the proxy server details with the RunSilentInstall command:
RunSilentInstall.exe -apikey=a0000000-a000-0a0a-00a0-0000aaa00000 -forwardProxyServer=proxyServer.bmc.com:3128 -forwardProxyUser=user1 -forwardProxyPassword=user123 - Multiple proxy servers: Enter the comma-separated proxy server details with the RunSilentInstall command:
RunSilentInstall.exe -apikey=a0000000-a000-0a0a-00a0-0000aaa00000 -forwardProxyServer=proxyServer1.bmc.com:3128,proxyServer2.bmc.com:3128,proxyServer3.bmc.com:3128 -forwardProxyUser=user1 -forwardProxyPassword=user123
The forward proxy password is encrypted and then stored in the secure store.
For more information, see Installing-PATROL-Agents.
To configure the proxy server after the installation of PATROL Agents
After a PATROL Agent is installed, add the following configuration variables with forward proxy server details and restart PATROL Agent:
Variable | Details | Example |
|---|---|---|
/AgentSetup/integration/forwardProxyServer | Enter the forward proxy server address. | PATROL_CONFIG "/AgentSetup/integration/forwardProxyServer" = { REPLACE= "proxyServer1.bmc.com:3128,http://proxyServer2.bmc.com:3128,proxyServer3.bmc.com:3128"} |
/AgentSetup/integration/forwardProxyUser | Enter the forward proxy server username. | PATROL_CONFIG "/AgentSetup/integration/forwardProxyUser" = {REPLACE = "user1"} |
/SecureStore/mca/tenant/forwardProxyPasswd | Enter the forward proxy server password. The forward proxy password is encrypted and then stored in the secure store. | PATROL_CONFIG "/SecureStore/mca/tenant/forwardProxyPasswd" = {REPLACE = "MCA/user123"} |
/AgentSetup/integration/forwardProxyServerTimeoutRetryCount | Enter the forward proxy server retry count in case of timeout error. The timeout error occurs when curl send operation returns error code 28. The default retry count value is 15. If you do not want PATROL Agent to re-establish the connection and directly switch to the next available forward proxy server, set this variable to 0. | PATROL_CONFIG "/AgentSetup/integration/forwardProxyServerTimeoutRetryCount" = { REPLACE="15"} |
For more information about the pconfig utility, see Using the pconfig utility to modify PATROL Agent configuration variables.
For similar information about configuring PATROL agents to support proxy server migration to BMC Helix Operations Management, see the Configuring PATROL Agents to support proxy server migration to BHOM discussion on BMC Communities.