Manual, Online: Restoring the Cluster

Before You Begin

• Make sure you have followed the Prerequisites.
• Make sure the backup is disabled on the backup cluster. Inconsistencies will occur if a new backup is created while restoring the cluster. See Manual: Disabling the backup on the cluster.
• Make sure package wget, unzip, jq are available on all the restore nodes.
• All external data source source should be the same (SQL Server).
• Restart the NFS server before restoring the cluster. Execute the following command on the NFS server node: systemctl restart nfs-server.

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

  Installation type	configuration instructions	Requirements
  Online single-node evaluation mode	Configuring the machines Configuring the DNS	Download the following file: sf-installer.zip – Mandatory. See sf-installer.zip for download instructions.
  Online multi-node HA-ready production mode	Configuring the machines Configuring the load balancer Configuring the DNS	Download the following file: sf-installer.zip – Mandatory. See sf-installer.zip 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 for the installer, 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:

   # 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

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 --accept-license-agreement --install-type online

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

Restoring Etcd on the Remaining Server Nodes

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

./install-uipath.sh -i ../restore.json -o output.json -r -j server --accept-license-agreement --install-type online

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 --accept-license-agreement --install-type online

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 --accept-license-agreement --install-type online

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 --accept-license-agreement --install-type online

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

Disabling the Maintenance Mode

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

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

./configureUiPathAS.sh disable-maintenance-mode

Running Volume Restore on Any Server Node

After restoring etcd, restore the volume on any of the server nodes by running:

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

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 reference. You may need it when adding new nodes to the cluster, when upgrading, etc.

To restore cluster_config.json, run:

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

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