Restoring the backup

Note:

Once a cluster is restored, the snapshot backup is not enabled. To enable it after restore, see Enabling the backup snapshot.

Restoring the cluster does not restore external data sources such as SQL Server, objectstore, or the OCI-compliant registry. Make sure to restore these datasource to the relevant snapshot.

To restore the cluster, take the following steps:

1. Install the cluster infrastructure on all the server nodes. The hardware you provide for the restore cluster must be similar to the backup cluster hardware. For details, see Hardware and software requirements.
2. Configure the snapshot on the restored cluster.
3. Select the snapshot to restore.
4. Restore the data and settings.

Step 1: Installing the cluster infrastructure

Preparation

1. Download the restore installer. You can find it inside the as-installer.zip package. For download instructions, see Downloading the installation packages.
2. In offline environments, you must provide an external OCI-compliant registry or a temporary registry. Note that the registry configuration must remain the same as the one of the original cluster. To configure the registry, see the following instructions:
   • Configuring the external OCI-compliant registry
   • Configuring the temporary Docker registry. Choose this option only if you did not use an external OCI-compliant registry before the disaster occurred.
3. Prepare the configuration file and make it available on all the cluster nodes. To prepare the configuration file, take one of the following steps:
   • Option A: Reuse the cluster_config.json file that you applied to the cluster before the disaster occurred;
   • Option B: Create a minimal cluster_config.json file with the required parameters, as shown in the following example:

     {
       "fixed_rke_address": "fqdn",
       "fqdn": " fqdn ",
       "rke_token": "guid",
       "profile" : "cluster_profile"
       "external_object_storage": { "enabled": false },
       "install_type": "offline or online"
     }

The following table describes all the parameters that you must include in the minimal cluster_config.json file. Make sure to provide the same parameter values as the ones used in the orginal cluster. You can change the parameter values post-restore.

Important:

In offline environments, aside from setting the cluster_config.json parameters listed in the following table, you must also provide the external OCI-compliant registry configuration. For details, see External OCI-compliant registry configuration.

Parameter	Value
fqdn	FQDN of the Automation Suite cluster. The value must be the same as the old FQDN. Providing a different FQDN value may cause the restoration to fail.
fixed_rke_address	The fixed address used to load balance node registration and Kube API requests. If the load balancer is configured as recommended, the value should be the same value as the one for fqdn. Otherwise, use the fqdn value of the first server node. Refer to Configuring the load balancer for more details.
rke_token	Use a newly generated GUID here. This is a pre-shared, cluster-specific secret. It is needed for all the nodes joining the cluster.
profile	Sets the profile of the installation. The available profiles are: default – single-node evaluation profile ha – multi-node HA-ready production profile
install_type	Indicates the type of installation you plan to perform. Your options are: online – an installation with access to the Internet offline – an installation with no access to the Internet

For more details on how to configure cluster_config.json, see Manual: Advanced installation experience.

Execution

Installing the cluster infrastructure on the primary restore cluster node

To install the infrastructure on the primary restore cluster node, run the following commands:

cd <installer directory>
./install-uipath.sh -i ../../cluster_config.json -o output.json --restore --accept-license-agreement

Important: Copy cluster_config.json from the primary server node to the remaining server/agents nodes. The infrastructure installation step on the primary server node adds extra values that the remaining nodes need.

Installing the cluster infrastructure on secondary servers

To install the infrastructure on the secondary servers:

cd <installer directory>
./install-uipath.sh -i ../../cluster_config.json -o output.json --restore -j server --accept-license-agreement

Installing the cluster infrastructure on agent nodes

To install the infrastructure on the agent nodes:

cd <installer directory>
./install-uipath.sh -i ../../cluster_config.json -o output.json --restore -j agent --accept-license-agreement

Installing the cluster infrastructure on Task Mining nodes

To install the cluster infrastructure on Task Mining nodes:

cd <installer directory>
./install-uipath.sh -i ../../cluster_config.json -o output.json --restore -j task-mining --accept-license-agreement

Installing the cluster infrastructure on Automation Suite Robots nodes

To install the cluster infrastructure on Automation Suite Robots nodes:

cd <installer directory>
./install-uipath.sh -i ../../cluster_config.json -o output.json --restore -j asrobots --accept-license-agreement

Installing the cluster infrastructure on GPU nodes

To install the cluster infrastructure on GPU nodes:

cd <installer directory>
./install-uipath.sh -i ../../cluster_config.json -o output.json --restore -j gpu --accept-license-agreement

Step 2: Configuring the snapshot on the restored cluster

Once the infrastructure is installed, configure the snapshot while providing the minimum data, such as target, endpoint, and location. These values are used at the time of restoration.

To configure the backup of the restored cluster, follow the steps in the Configure the cluster snapshot section.

Step 3: Selecting the snapshot to restore

After configuring the snapshot, list the existing snapshots and decide on the one you want to use as a restoring point.

Step 4: Restoring data and settings

To restore to a previous cluster, provide the snapshot name you want to convert from using the --from-snapshot <snapshot-name> flag.

./configureUiPathAS.sh snapshot restore create --from-snapshot <snapshot name>

If you do not specify the snapshot name, the cluster restores the latest successful snapshot. See the snapshot list for available snapshots.

Restoring cluster_config.json

After the Automation Suite cluster recovery, you may want to recover the cluster_config.json file for future usage, such as adding new nodes to the cluster, upgrading, etc.

To restore cluster_config.json:

uipathctl manifest get-revision >> ./cluster_config.json

Adding CA certificates to the trust store

After restoring the cluster, make sure to add your CA certificates to the trust store of the restored VMs. For details, see:

• Accessing the TLS certificate
• Adding the CA certificate to the host trust store

Retrieving new monitoring password

After restoring an Automation Suite cluster, you need to retrieve the new monitoring password. For this, follow the steps from Accessing the monitoring tools.

Enabling AI Center on the Restored Cluster

After restoring an Automation Suite cluster with AI Center™ enabled, follow the steps from the Enabling AI Center on the Restored Cluster procedure.