Read and Review Automation Anywhere Documentation

Automation 360

Close Contents

Contents

Open Contents

Install Bot agent and register device

  • Updated: 2022/05/19
    • Automation 360 v.x
    • Install
    • RPA Workspace

Install Bot agent and register device

The Bot agent is a lightweight application that enables you to run bots on your device by connecting the device to the Control Room. To run bots on a local machine, install the Bot agent and add the local device to the list of enabled host devices.

Prerequisites

  • To install the Bot agent, the Windows installer policy must be enabled for the user device.
  • The read, write, and execute permissions must be enabled for the Bot agent folders on the user device.
  • Ensure the device system date and time are in sync with the current date and time so that the device registration is successful.

The Bot agent version available for download is the latest and compatible with the Control Room version that is used.

Note: You cannot install a Bot agent on a device with an existing Enterprise 10 or Enterprise 11 Enterprise Client.

Procedure

  1. Log in to the Control Room through your Automation Anywhere URL using a supported browser.
  2. Install the Bot agent and add a local device by choosing one of the following options:
    • From the menu on the right, click the device icon to connect a local device.
    • Go to the Devices page, and click the Connect local device icon located at the top-right of the Devices list.
  3. Click Connect to my computer.
    The Bot agent setup file is downloaded.
  4. Follow the steps outlined in the wizard.
    Authenticated proxy access: If your device's access to the internet is controlled through an authenticating proxy server, you are prompted to provide the proxy server authentication details. These credentials are required for the device to communicate with the Control Room.
    To enable the authenticated proxy, register the device through a Google Chrome browser with the Automation 360 Chrome extension enabled.
    Note: The Chrome extension is installed for Google Chrome Enterprise browser users even if the device is offline. The extension is downloaded along with the Bot agent MSI installer file.
  5. Select an option to install the Bot agent either at the system level or user level.
    • To install at the system level, select Anyone who uses this computer (all users)

      All users of the device can use this Bot agent. However, users installing the Bot agent must have administrator privileges.

    • To install at the user level, select Only for me (username).

      The Bot agent will be available only to the individual user.

  6. Enter the following in the Additional information screen:
    • Device nickname (optional)
    • Device type (single user or multiple user)
      Note: For a multiple user device, enter the number of concurrent sessions that will be allowed. A minimum of two concurrent sessions is supported.
  7. Click Done.
    • The Bot agent is installed to the default location C:\Program Files\Automation Anywhere\Bot Agent.
    • The Bot agent is registered as a Windows service: Automation Anywhere Bot agent Service.
    • A shortcut to access AARI Assistant is added to the Windows Start menu and desktop.
    • The Java Runtime Environment (JRE) files are installed with the Bot agent in the Bot agent install folder: C:\Program Files\Automation Anywhere\Bot Agent\jre.
  8. Set the user device credentials so that your device can run bots.
  9. Refresh the Devices page and verify that the local device is added.
    You can identify the devices by their IP address and hostname.
    Note: After you remove a device, wait for 35 seconds to re-register the device.

Troubleshooting:

  • If you face any issues registering your device, see Automation 360: Error while registering device - An unexpected problem occurred (A-People login required).

  • If the Bot agent service is paused and does not start after installation, see Automation 360 Error: Device is disconnected or needs upgrade (A-People login required)

  • If you are using Google Chrome browser version 94 or later and if you face issues registering your device in a Control Room On-Premises, we recommend that you configure the Control Room for HTTPS instead of HTTP. Alternatively, use Microsoft Internet Explorer or Mozilla Firefox to register your device.
  • If you manually remove the Google Chrome extension, existing Google Chrome policy does not allow you to add the extension (online or offline) even after you reinstall the Bot agent. We recommend that you do not remove the extension. However, if you manually remove the extension, perform any one of the following:
    • Go to Google Chrome extension store to add the extension online.

      Automation 360 extension for Chrome

    • Drag the ChromeExtension.crx file (C:\Program Files\Automation Anywhere\Bot Agent\AABrowserAgent) to the Google Chrome extension tab (three vertical dots menu on top-right > Settings > Extensions).

Watch the following video on how to install the Bot agent in Automation 360:

Next steps

Optionally, Edit profile.

If your device is set with a proxy, see the tasks that apply to your proxy settings, Connect Bot agent to a device with a proxy

Send Feedback