Configuring the Unified Agent to communicate through a proxy

If your firewall rules do not allow transparent outbound HTTPS connections to external hosts, you can configure the Unified Agent to send traffic to a proxy by editing the Unified Agent conf file.

The forward proxy must be able to resolve the hostname of the IBM Cloud Pak for Multicloud Management ingress.

If you use a reverse proxy, you need to use the Ingress URL in the configuration, and the Unified Agent must have the port defined in the setupenv.sh script file.

Configuring the forward proxy

1. Go to the conf directory where the icam.conf file is located, for example, opt/ibm/apm/ua/conf/icam.conf.
2. Open icam.conf for editing.
3. Search for http_proxy to navigate to the place where the following line is located:

   #http_proxy = "http://xxxx:yy"
   

4. Uncomment the line and add the host and port information into proxy address. For example,

   http_proxy = "http://HostA:8091"
   

5. Save conf file and restart the Unified Agent.

Configuring the reverse proxy

1. Go to the conf directory where the setupenv.sh file is located, for example, opt/ibm/apm/ua/conf/setupenv.sh.
2. Open setupenv.sh for editing.
3. Search for IBM_APM_SERVER_INGRESS_URL to navigate to the place where the IBM_APM_SERVER_INGRESS_URL is located.
4. Input the ingress url and the port number.
5. Save conf file and restart the Unified Agent.