Automation Suite
Preparing the new cluster - Automation Suite 2023.10
Banner background image
Automation Suite on Linux Installation Guide
Last updated Feb 13, 2024

Preparing the new cluster

Preparing the cluster_config.json file


You must not modify the source cluster after starting the export-import process.

To prepare the cluster_config.json file, take the following steps:
  1. Generate the cluster_config.json file on the source cluster by running one of the following commands:
    • Option A: If you already have a cluster_config.json file available, get it by navigating to the latest installer folder and running the following command:
      cd /opt/UiPathAutomationSuite/latest/installer
      ./ config get -i /path/to/old/cluster_config.json -o /opt/UiPathAutomationSuite/cluster_config.jsoncd /opt/UiPathAutomationSuite/latest/installer
      ./ config get -i /path/to/old/cluster_config.json -o /opt/UiPathAutomationSuite/cluster_config.json
    • Option B: If you do not have a cluster_config.json file available, generate it by navigating to the latest installer folder and running the following command:
      cd /opt/UiPathAutomationSuite/{version}/installer
      ./ config get -o /opt/UiPathAutomationSuite/cluster_config.jsoncd /opt/UiPathAutomationSuite/{version}/installer
      ./ config get -o /opt/UiPathAutomationSuite/cluster_config.json
  2. Copy the cluster_config.json file from the source cluster and place it in the target cluster:
    scp cluster_config.json user@target_cluster_IP /foo/barscp cluster_config.json user@target_cluster_IP /foo/bar
  3. Use a newly generated GUID for rke_token, as well as a different temporary FQDN, SQL Server, or other configurations, as needed for the target cluster, and update cluster_config.json accordingly.
    • You must generate a new GUID for rke_token to prevent the new cluster from joining the source cluster. To do that, run the following command:
      LC_CTYPE=C tr </dev/urandom -dc '!@#$%q_A-Z-a-z-0-9' | head -c 16LC_CTYPE=C tr </dev/urandom -dc '!@#$%q_A-Z-a-z-0-9' | head -c 16
    • You can use any text editor to modify the cluster_config.json file.
    • Optional external objectstore: Provide the external objectstore if you want to change any of its settings.


To ensure instant rollback in case of failures, you must bring different resources than the ones used for the source cluster, as follows:

  • You must bring different SQL databases for the new target cluster.

  • You must bring different external objectstore buckets for the new target cluster.

Note: We currently do not support migrating from an in-cluster objectstore to an external objectstore as part of the side-by-side upgrade process. To use an external objectstore in the new environment, you must migrate to an external objectstore either before starting or after completing the side-by-side upgrade.

Installing the new cluster

To install your new target cluster, follow the preparation and installation instructions.


You must complete the installation of the services only after migrating the data.

  • Preparing the cluster_config.json file
  • Installing the new cluster
Support and Services icon
Get The Help You Need
UiPath Academy icon
Learning RPA - Automation Courses
UiPath Forum icon
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.