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. Make sure to restore the SQL server to the relevant snapshot.

To restore the cluster, take the following steps:

1. Install the cluster infrastructure on all the server nodes.
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

Prerequisites: Download and install the required installers and bundles:

• the restore installer – find it in the as-installer.zip package
• the offline infrastructure bundle – find it in the as-infra.tar.gz package

To install the cluster infrastructure, prepare the dr_input.json restore file and make it available on all the cluster nodes.

{
  "fixed_rke_address": "fqdn",
  "fqdn": " fqdn ",
  "rke_token": "guid",
  "profile" : "cluster_proflie"
  "external_object_storage": { "enabled": false }
}

Note: The restore file contains only the parameters required to restore the cluster, and it is a subset of the cluster_config.json.

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

For more details on the installation, read the Manual: Advanced installation experience page.

Online installation

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 dr_input.json -o dr_output.json --restore --accept-license-agreement

Important: Copy dr_input.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 dr_input.json -o dr_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 dr_input.json -o dr_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 dr_input.json -o dr_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 dr_input.json -o dr_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 dr_input.json -o dr_output.json --restore -j gpu --accept-license-agreement

Offline installation

Note:

Make the cluster infrastructure bundle as-infra.tar.gz available on all the cluster nodes:

1. Copy the bundle under the /uipath/ directory on primary restore server node.
2. Copy the bundle under the /opt/UiPathAutomationSuite/ directory on secondary servers and agent nodes.

Installing the cluster infrastructure on the primary restore cluster node

To install the infrastructure on the primary restore cluster node:

cd <installer directory>
./install-uipath.sh -i dr_input.json -o dr_output.json --restore --accept-license-agreement --offline-bundle /uipath/as-infra.tar.gz --offline-tmp-folder /uipath/tmp

Important: Copy dr_input.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 dr_input.json -o dr_output.json --restore -j server --accept-license-agreement --offline-bundle /opt/UiPathAutomationSuite/as-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp

Installing the cluster infrastructure on agent nodes

To install the infrastructure on the agent nodes:

cd <installer directory>
./install-uipath.sh -i dr_input.json -o dr_output.json --restore -j agent --accept-license-agreement --offline-bundle /opt/UiPathAutomationSuite/as-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp

Installing the cluster infrastructure on Task Mining nodes

To install the infrastructure on Task Mining nodes:

cd <installer directory>
./install-uipath.sh -i dr_input.json -o dr_output.json --restore -j task-mining --accept-license-agreement --offline-bundle /opt/UiPathAutomationSuite/as-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp

Installing the cluster infrastructure on Automation Suite Robots nodes

To install the infrastructure on Automation Suite Robots nodes:

cd <installer directory>
./install-uipath.sh -i dr_input.json -o dr_output.json --restore -j asrobots --accept-license-agreement --offline-bundle /opt/UiPathAutomationSuite/as-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp

Installing the cluster infrastructure on GPU nodes

To install the infrastructure on GPU nodes:

cd <installer directory>
./install-uipath.sh -i dr_input.json -o dr_output.json --restore -j gpu --accept-license-agreement --offline-bundle /opt/UiPathAutomationSuite/as-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp

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.