Configure the agent over firewalls

On each load generator machine that runs over a firewall and on each Monitor-Over-Firewall machine, you configure the OpenText Professional Performance Engineering Agent to communicate with the MI Listener. The MI Listener serves as a router between the load generator and Controller.

  1. Configure the agent on Windows.

    1. Stop the OpenText Professional Performance Engineering Agent by right-clicking its icon in the system tray and selecting Close, and then setting the options in the Agent Configuration dialog box as described in Agent Configuration dialog box.

    2. Restart the agent by double-clicking the shortcut on the desktop.

  2. Configure and run the OpenText Professional Performance Engineering Agent on Linux.

    1. Open <installdir>/dat/br_lnch_server.cfg in a text editor.

    2. In the Firewall section, set FireWallServiceActive to 1 and save your changes.

    3. Run agent_config from the <installdir>/bin folder to display a menu of actions:

      1. Show current settings.
      2. Change a setting.
      3. Save changes and exit.
      4. Exit without saving.
      5. Use default values.

      Note: If agent_config does not display the menu shown above, see Known issues for firewalls for a possible solution.

    4. Enter 1 to display the current settings:

      Settings:
      -----------
      1. MI Listener Name =
      2. Local Machine Key =
      3. Connection Timeout (seconds) = 20
      4. Connection Type = TCP
      5. Use Secure Connection (SSL) = False
      6. Check Server Certificates= False
      7. Client Certificate Owner = False
      8. Private Key User Name =
      9. Private Key Password =
      10. Proxy Name =
      11. Proxy Port =
      12. Proxy User Name =
      13. Proxy Password =
      14. Proxy Domain =

      Menu:
      1. Show current settings
      2. Change a setting.
      3. Save changes and exit.
      4. Exit without saving.
      5. Use default values.

    5. To change a setting, enter 2 to display the settings menu:

      Settings:
      -----------
      1. MI Listener Name =
      2. Local Machine Key =
      3. Connection Timeout (seconds) = 20
      4. Connection Type= TCP
      5. Use Secure Connection (SSL) = False
      6. Check Server Certificates= False
      7. Client Certificate Owner = False
      8. Private Key User Name =
      9. Private Key Password =
      10. Proxy Name =
      11. Proxy Port =
      12. Proxy User Name =
      13. Proxy Password =
      14. Proxy Domain =
      Enter number of setting to change or 0 to go back to menu.

    6. Enter the setting and continue according to the menu instructions. Set each option according to the Agent Configuration Settings dialog box.

  3. Restart the agent.

    1. To remove (turn off) the agent, run the command m_daemon_setup -remove from the <installdir>/bin folder.

    2. Note: When the agent is configured to run over a firewall, and the agent is connected to the MI Listener, a file called <local_machine_key>_connected_to_MI_Listener is created in the temporary folder of the machine. The file is removed when the agent disconnects from the MI Listener.

    3. To start the agent, run the command m_daemon_setup -install from the <installdir>/bin folder.

Back to top

See also: