Switch device registration between Control Room instances

Configure the device settings in the Control Room to enable single-user devices to easily switch between different instances of the Control Room to run bots in multiple environments. This option enables you to register the Bot Agent on multiple Control Room instances without uninstalling the Bot Agent.

Prerequisites

Ensure that you are logged in to the Control Room as the administrator.

  • You must have the View and Manage ALL device permission to enable the switching option.
  • You must enable the switching option on both Control Room instances.
  • You can switch between Control Room instances only if the instances are on the same build.

    For example, if one Control Room instance is on Build 9664 and another instance is on Build 8815, you cannot switch user device between the two Control Room instances. Both instances should be either on Build 9664 or Build 8815.

Procedure

  1. Navigate to Administration > Settings > Devices.
  2. Edit the General settings.
  3. Select Enabled to enable the local device as the default bot running device after a user logs into the Control Room.
  4. Optional: Select the Clear the user’s existing bot running device if the bot agent is not present on the local device check box to remove the existing default device.

    By default, the Clear the user’s existing bot running device if the bot agent is not present on the local device check box is not selected.

    When no Bot Agent is available on the local device and if you select this check box, the existing default device for the logged-in Bot Creator, attended Bot Runner, or Citizen developer users is removed. Otherwise, the default available device is assigned for the bot deployment.

    Note: If the local device is not enabled as the default bot running device and Clear the user’s existing bot running device if the bot agent is not present on the local device check box is selected, then the existing default device is discarded. In this case, you must select the default device manually.
  5. Use the Allow devices (single user) to be switched to another Control Room without reinstalling bot agent field to change the default setting:
    • Disabled: is the default setting.

      For the default setting, you must uninstall Bot Agent first and then reinstall it to switch device registration to a different Control Room instance.

    • Enabled: enables a single-user device to be switched to another Control Room without reinstalling the Bot AgentOptionally, select the Allow fast switching check box to enable the Bot Agent to switch devices with a single click. Select one of the following methods for switching the device to switch to another Control Room:
      • Can switch to pre-approved Control Rooms only
      • Can switch to any Control Room
      Note: Fast switching is recommended only if there is no change in the network configuration when connecting to a new Control Room. The first time you switch the Bot Agent to a new Control Room, the device lifespan information (that is, whether the device is Persistent or Temporary) is copied over to the new Control Room. No other configuration information is copied over. Fast switching will not work if your device cannot reach the new Control Room due to changes in the proxy settings.
  6. Optional: For additional security, you can enable the following setting in the Validate device credentials field to validate the device credentials prior to bot deployment:
    • Device credentials for all users: Validates the device credentials for Bot Creator, attended Bot Runner, Citizen Developer, and unattended Bot Runner users.
    • Device credentials for un-attended bot runner users only: Validates the device credentials for unattended Bot Runner users only.
    Note: This is applicable for all trigger-based bot deployments too.
  7. Save the settings.
  8. Log in as a Bot Creator user to a Control Room configured in a different environment to verify that users can switch between instances.
    The Connect device option is available when you click the device icon in the Control Room panel.