Control Room registration token from the autoregistration.properties file is used to register a device in the specified Control Room URL. You cannot auto register a device if the Control Room URL is not available in the autoregistration.properties file.

The autoregistration.properties file must be available on your local macOS device, and you must not delete the file after the registration is complete.

Prerequisites

Ensure that you have generated a Control Room registration key that is downloaded as automationAnywhereBotAgent.pkg. For more information, see Generate Control Room registration key.

You can then configure or customize the various parameters of the autoregistration.properties file before using it along with the default automationAnywhereBotAgent.pkg file for bulk installation of Bot Agent.

Procedure

  1. Run the automationAnywhereBotAgent.pkg file.
    For example, you can use the sudo command to run sudo installer -pkg /Users/m4macmini2/Downloads/AutomationAnywhereBotAgent.pkg -target/
  2. Stop the Bot Agent service by running the command: sudo /bin/launchctl bootout system /Library/LaunchDaemons/com.automationanywhere.nodemanager.plist
  3. Run the command to provide the folder permission: sudo chmod -R 755 "/Library/Application Support/aai"
  4. Run the following command to create autoregister folder: sudo mkdir -p "/Library/Application Support/aai/autoregister"
  5. In the autoregister folder, save the autoregistration.properties file.
    Here is a sample autoregistration.properties file:
    url=http://ec2-myexampleCR.com
url2=URL2
url3=URL3
token=eyJhbGciOiJSUzUxMiJ9.eyJjbGllbnRUeXBlIjoiQk9UX0FHRU5UX0FVVE9fUkVHSVNUUkFUSU9OIiwidGVuYW50VXVpZCI6IjgzZmNlNGRmLWEyMTAtNGEwZi1hNGQ0LTgwNDFjMWZmOGU1ZSIsImlhdCI6MTc0Mjg0NTkxNiwiZXhwIjoyMDU4MjA1OTE2LCJpc3MiOiJBdXRvbWF0aW9uQW55d2hlcmUiLCJuYW5vVGltZSI6MzM4MzU0MDYzNDM1MTMzfQ.W7g7AFBGqziV6vYFb5f7igoysXQ3lM3OixSpq_9k4rJFJBBGrkIBTrsOMitNgmcn138bEBz5sA0VnqHibc2YknP3dunJw6jfMRvK_vIYJ13G4mK0kPeDZ-1V2eGiBKw_--xJbG5i9zhr3kRkd7aBLFr8p4WddvQz8YiZCXoN1KDuW63kDqWnbHgGFvNLKlcW2i4V-eCJIq4TZsgg_nyCG0-DgV0LLyvn1tbPw6bO_gOWB6iuFMsS_Pb-pGUD13WdHfb6qxum3Q3--aYDx8emyoH2XtFAQAYuXiw6vOXWa1o-TYDtPknIJsga6aAiFJ9-
token2=t2
token3=t3
device_type=SINGLE_USER
lifespan=PERSISTENT
device_pool_name=AAdevPool
host_type=CUSTOMER_MACOS
    The autoregistration.properties fie is created.
  6. Optional: Edit the autoregistration.properties file.
    Review the following table to understand what each parameter is used for:
    Parameter Description
    url Enter the Control Room URL to which the Bot Agent will be connected.
    token Enter the corresponding registration key for each chosen Control Room.
    Note: You provide the corresponding registration tokens under CRURL2, CRURL3 through CRURL20 for each configured Control Room URL.
    device_type Enter SINGLE_USER value for the device type.

    For more information, see Configure device registration.

    Note: Ensure that you enter the property value in uppercase.
    concurrent_sessions Enter the concurrent sessions allowed, from 1 through 99.
    lifespan Enter one of the following values for a temporary or persistent device:
    • TEMPORARY
    • PERSISTENT

    For more information, see Configure device registration.

    Note: Ensure that you enter the values in uppercase.
    device_pool_name Specify the device pool name.
    Note: Ensure that you use an existing device pool.
    host_type Specify the device operating system type. For example, CUSTOMER_MACOS.
    managed_device_id Specify the device to be mapped to a specific device_id (already exists in CR).

    This will ensure that the available deice will not be registered as new device and will be mapped.
  7. Start the Bot Agent service by running the command: sudo /bin/launchctl bootstrap system /Library/LaunchDaemons/com.automationanywhere.nodemanager.plist