Enabling upstream proxy support for the Synthetic Playback agent

Enable upstream proxy support for the Synthetic Playback agent to monitor HTTP requests from internal web applications to external web applications.

Before you begin

Ensure that you are running Synthetic Playback agent version 01.00.05.08 or later. To check what agent version you are running, enter install_dir/bin/cinfo -t in the command line, where install_dir is the installation location of the agent. If you are running any other version of the Synthetic Playback agent, you must download and install IBM® Cloud Application Performance Management, Private 8.1.4.0 Synthetic Playback agent interim fix 08 from IBM Fix Central (Enter Synthetic in the Search field and the list of Synthetic Playback agent interim fixes are displayed). For installation instructions, see 8.1.4.0-IBM-IPM-SYNTHETIC-PLAYBACK-AGENT-IF0008 Readme.

About this task

Internal web applications behind an enterprise firewall require an upstream proxy to access external web resources. Configure the proxy setting of the Synthetic Playback agent to allow your agent to support your upstream proxy so that you can monitor HTTP requests from internal web applications to external web applications.

Linux

Procedure

  • To configure and enable upstream proxy support for your agent, complete the following steps.
    1. As the root user, configure the proxy settings by running the following commands in the command line.
      cd install_dir/agent/lx8266/sn/bin
      #./set_proxy.sh

      When you are prompted, enter the agent installation path, the default path is /opt/ibm/apm/agent. Enter the number for the proxy type that you want to configure for your Synthetic Playback agent.

      For example:
      # cd /install_dir/agent/lx8266/sn/bin/
      #./set_proxy.sh
      please input the agent install path, default is (/opt/ibm/apm/agent)
      agent install path is:/opt/ibm/apm/agent
      please input the number of proxy type:
      1 manual proxy
      2 no proxy
      
      Note: From Synthetic Playback agent version 01.00.05.16, system proxy and pac proxy are not supported anymore. For details, see 8.1.4.0-IBM-IPM-SYNTHETIC-PLAYBACK-AGENT-IF0016 Readme.
    2. Enter install_dir/bin/synthetic_playback-agent.sh start to restart your agent.
  • LinuxTo disable upstream proxy support for your agent, run the ./set_proxy.sh command again, and select 2 no proxy. Then, restart your agent.