Manual, Offline: Restoring the Cluster

Before You Begin

• Make sure you meet the Prerequisites.
• Make sure the backup is disabled on the backup cluster. Inconsistencies will occurs if a new backup is created while cluster restore is in progress. See Disabling the backup on the cluster.
• Make sure package wget, unzip, jq are available on all the restore nodes.
• All external data sources must be the same (SQL Server).
• Restart the NFS server before restoring the cluster by running the following command on the NFS server node: systemctl restart nfs-server.

• The restore cluster should have the same FQDN as the backup cluster.

  Installation type	Configuration instructions	Requirements
  Offline single-node evaluation mode	Configuring the machines Configuring the DNS	Download the following files: sf-installer.zip – Mandatory. See sf-installer.zip for download instructions. sf-infra.tar.gz – Mandatory. See sf-infra.tar.gz for download instructions.
  Offline multi-node HA-ready production mode	Configuring the machines Configuring the load balancer Configuring the DNS	Download below files sf-installer.zip – Mandatory. See sf-installer.zip for download instructions. sf-infra.tar.gz – Mandatory. See sf-infra.tar.gz for download instructions.

Preparing the Restore Operation

Important: If you have multiple nodes in the cluster, follow these steps on all the nodes.

1. Log into any machine.
2. To create the /opt/UiPathAutomationSuite folder, run:

   # Become root
   sudo su -
   
   # Replace {version} with actual installer version
   
   mkdir -p /opt/UiPathAutomationSuite/{version}/installer
   chmod -R 777 /opt/UiPathAutomationSuite

3. To copy restore.json and other installer files to the /opt/UiPathAutomationSuite/{version} folder, run the following command. For details, see Preparing the restore configuration.

   # Replace {version} with actual installer version
   
   cp /path/to/restore.json /opt/UiPathAutomationSuite/${version}/installer
   cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/${version}/installer
   cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/${version}

4. To unzip sf-installer.zip, run:

   # Navigate to installer folder. Replace {version} with actual installer version
   cd /opt/UiPathAutomationSuite/${version}/installer
   
   unzip sf-installer.zip -d .

Restoring Etcd on the First Server Node

To restore etcd on the first node of the cluster, run:

./install-uipath.sh -i restore.json -o output.json -r --offline-bundle "../sf-infra.tar.gz" --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement --install-type offline

Note: This command restores the node configuration only on the first server node.

Restoring Etcd on the Remaining Server Nodes

To restore etcd on the other server nodes of the cluster, run:

./install-uipath.sh -i ../restore.json -o output.json -r -j server --offline-bundle "../sf-infra.tar.gz" --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement --install-type offline

Note: This command restores the node configuration on the remaining server nodes.

Restoring Etcd on Agent Nodes

To restore etcd on agent nodes of the cluster, run:

./install-uipath.sh -i restore.json -o output.json -r -j agent --offline-bundle "../sf-infra.tar.gz" --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement --install-type offline

Note: This command restores the node configuration on the remaining agent nodes.

Restoring Etcd on Task Mining Nodes

To restore etcd on Task Mining agent nodes of the cluster, run:

./install-uipath.sh -i restore.json -o output.json -r -j task-mining --offline-bundle "../sf-infra.tar.gz" --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement --install-type offline

Note: This command restores the node configuration on the Task Mining nodes.

Restoring Etcd on GPU Nodes

Note: Before restoring the GPU machine, make sure you have followed Installing a GPU driver on the machine.

To restore etcd on GPU agent nodes of the cluster, run:

./install-uipath.sh -i restore.json -o output.json -r -j gpu --offline-bundle "../sf-infra.tar.gz" --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement --install-type offline

Note: This command restores the node configuration on the remaining GPU nodes.

Disabling the Maintenance Mode

Note: This step is required only if the restore is part of the rollback operation during the upgrade.

Before restoring the volume, you need to disable the maintenance mode:

./configureUiPathAS.sh disable-maintenance-mode

Running Volume Restore on Any Server Node

Once the etcd restore is complete, restore the volume on any of the server node by running:

\./install-uipath.sh -i restore.json -o output.json -r --volume-restore --accept-license-agreement --install-type offline

Note: This command restores the volume data on the cluster.

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.

Restoring Cluster_config.json

Following the Automation Suite cluster recovery, you may want to recover the cluster_config.json for future. You may need it when adding new nodes to the cluster, when upgrading, etc.

To restore cluster_config.json, run the following command from any of the server nodes:

./configureUiPathAS.sh config get -o ./cluster_config.json

Note: The backup is not enabled on the restored cluster. If you want to enable the backup, refer to Enabling the backup on the cluster.

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