While installing Bot Agent, configuration of system proxy for connecting to the Control Room is the default setting. However, for manual installation of Bot Agent you can also configure a custom proxy.

Prerequisites

Note: Only a HTTP proxy server is supported by Bot Agent when setting up a custom proxy server.

Ensure that you log into Control Room as an administrator and download the Bot Agent installation file.

Review the following considerations before configuring proxy during Bot Agent installation::
  • You can choose between Automatic and Custom during Bot Agent installation. In order to configure proxy settings, ensure that you select the Custom option in the Bot Agent installer screen.
  • When you update the Bot Agent, the custom options that you had selected during the original installation are retained.
  • Uninstalling Bot Agent removes the registry key that was created as part of the custom installation.

Considerations

Review the following considerations when configuring custom proxy during Bot Agent installation:
  • Proxy address field

    The Proxy address field accepts space as value and saves them successfully, without trimming the leading or trailing spaces.

  • File address field

    Special characters such as <>:"/\|?* are allowed in the file address.

  • Input validation

    Invalid or negative input scenarios are not properly handled or validated.

  • Port field

    The Port field allows free text entry as random or invalid port values are saved directly to registry keys without validation.

Procedure

  1. Double-click the Bot Agent installation file.
    The Select type screen is displayed:

    Setup type

  2. Select All users/System level (Recommended) option.
  3. Click Next.
    The Proxy configuration screen is displayed where the proxy option is set to Automatic by default.
  4. Select Custom.
    Various configurations available for the custom proxy are displayed.

    Proxy configuration

  5. In the Proxy Options field, select the Custom radio button.
    Automatic is the default proxy setting. For more information, see Connect Bot Agent to a device with a proxy.
  6. Select one of the following options based on your requirement:
    • Manual
      Enter the server details in the Host and Port fields.
      Note: Ensure that you enter the correct details as a validation check is not performed.

      (Optional) If you want to bypass the proxy server, select Bypass proxy server for local address check box.

    • PAC

      Enter comma separated server addresses in the Address field. For example, http://pac.webdefence.global.blackspider.com/proxy.pac, https://pac.webdefence.global.blackspider.com:8087/proxy.pac and so on.

  7. Click Next.
    The Ready to install the program screen is displayed.

    Ready to install

  8. Click Install.
    Bot Agent is installed based on the custom proxy that you have configured.

Next steps

If you have used the Automatic option to install Bot Agent, you can also use the following registry key to configure custom proxy:

HKEY_LOCAL_MACHINE\SOFTWARE\Automation Anywhere\Bot Agent\Proxy Settings

Type (String): AUTOMATIC | MANUAL | PAC
  • If Type = AUTOMATIC: Node manager will detect the proxy configuration automatically.
  • If Type = MANUAL: Keys Host (String) & Port (Number), ByPassLocalAddresses (String) → TRUE/FALSE.
  • If Type = PAC: Key Address (TEXT).