ImportantThis documentation space contains information about PATROL Agents when deployed in a BMC Helix Operations Management environment. If you are a TrueSight Operations Management user, see PATROL Agent 20.08.

Configuring PATROL Agents to support a forward proxy server


This topic provides instructions to configure a PATROL Agent to communicate with the proxy server. 

You can set up a proxy server in your infrastructure environment so that PATROL Agents can communicate with BMC Helix Operations Management via the proxy server to create an additional layer of security. Setting up a proxy server is optional. To understand how to create a proxy server as a docker container, see Installing-a-Squid-proxy-server.


Note

You can configure a PATROL Agent for the forward proxy support only on Windows and Linux operating systems.

forward_proxy_diagram.png


PATROL Agent uses the following variables to configure the proxy server:

  • /AgentSetup/integration/forwardProxyServer
  • /AgentSetup/integration/forwardProxyUser
  • /SecureStore/mca/tenant/forwardProxyPassword

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

While installing a PATROL Agent, you can provide the proxy server details in the RunSilentInstall install command as shown in the following example:

RunSilentInstall.exe -apikey=a3908418-a963-4e3b-91d1-0664eaf73217 -forwardProxyServer=proxyServer.bmc.com:3128 -forwardProxyUser=user1 -forwardProxyPassword=user123

 For more information, see Installing-PATROL-Agents.

To configure the proxy server after the installation of PATROL Agents

After a PATROL Agent is installed, provide the proxy server details by configuring the following variables using the pconfig utility:

  • /AgentSetup/integration/forwardProxyServer
  • /AgentSetup/integration/forwardProxyUser
  • /SecureStore/mca/tenant/forwardProxyPassword

The following example shows how to set these configuration variables:

PATROL_CONFIG "/AgentSetup/integration/forwardProxyServer" = {REPLACE = "proxyServer.bmc.com:3128"}
PATROL_CONFIG "/AgentSetup/integration/forwardProxyUser" = {REPLACE = "user1"}
PATROL_CONFIG "/SecureStore/mca/tenant/forwardProxyPassword" = {REPLACE = "MCA/user123"}

Note: Restart the PATROL Agent for the forwardProxyPassword changes to take effect.

For more information about the pconfig utility, see Using-the-pconfig-utility-to-modify-PATROL-Agent-configuration-variables.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*