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

Preparing the new cluster

Preparing the cluster_config.json file

Note:

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
      
      ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o /opt/UiPathAutomationSuite/cluster_config.jsoncd /opt/UiPathAutomationSuite/latest/installer
      
      ./configureUiPathAS.sh 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
      
      ./configureUiPathAS.sh config get -o /opt/UiPathAutomationSuite/cluster_config.jsoncd /opt/UiPathAutomationSuite/{version}/installer
      
      ./configureUiPathAS.sh 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.

Important:

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.

Important:

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.