Abonnieren

UiPath Automation Suite

Die Anleitung für die UiPath Automation Suite

Sichern und Wiederherstellen des Clusters

Auf dieser Seite finden Sie Anweisungen zum Sichern und Wiederherstellen des Clusters für die Automation Suite.

Um die Sicherungs- und Wiederherstellungsfunktionen nutzen zu können, müssen Sie einen NFS-Server, den Sicherungscluster und den Wiederherstellungscluster aktivieren. Alle drei sind unten definiert.

Terminologie


Der NFS-Server ist ein Server, der die Sicherungsdaten speichert und zur Erleichterung der Wiederherstellung verwendet wird. Dies kann jede Maschine sein.

Im Sicherungscluster wird die Automation Suite installiert. Dies bezieht sich auf den Cluster, den Sie während der Installation eingerichtet haben.

Der Wiederherstellungscluster ist der Cluster, in dem Sie alle Daten aus dem Sicherungscluster wiederherstellen möchten. Dieser Cluster wird zum neuen Cluster, in dem Sie die Automation Suite nach Abschluss der Wiederherstellung ausführen.

Die folgenden Schritte zeigen, wie alle drei eingerichtet werden.

 

Umgebungsvoraussetzungen


🚧

Wichtig!

  • Mit diesem Schritt wird keine Sicherung für externe Datenquellen (SQL-Server) aktiviert. Sie müssen die Sicherung der externen Datenquelle separat aktivieren.
  • Wir unterstützen keine zonenübergreifende Sicherung und Wiederherstellung.

Herunterladen von Installationspaketen

  • Der NFS-Server sollte von allen Clusterknoten aus erreichbar sein (sowohl von Sicherungs- als auch von Wiederherstellungsclustern).
  • The cluster you want to back up and the NFS server must be in the same region.
  • Before the cluster restore, make sure to disable the backup as described in Disabling the cluster backup
  • Stellen Sie sicher, dass die folgenden Ports aktiviert sind:

Port

Protocol

Source

Destination

Purpose

Requirements

2049, 111

TCP

NFS Server

All nodes in backup cluster

Data sync between backup cluster and NFS Server

This communication should be allowed from the NFS Server to the backup cluster node before running Step 2: Enabling the cluster backup.

2049, 111

TCP

All nodes in backup cluster

NFS Server

Data sync between backup cluster and NFS Server

This communication should be allowed from the backup cluster node to the NFS Server before running Step 2: Enabling the cluster backup.

2049, 111

TCP

NFS Server

All nodes in restore cluster

Data sync between NFS Server and restore cluster

This communication should be allowed from the NFS Server to restore the cluster node before running Step 3: Setting up the Restore Cluster.

2049, 111

TCP

All nodes in restore cluster

NFS Server

Data sync between backup cluster and NFS Server

This communication should be allowed from the NFS Server to the backup cluster node before running Step 3: Setting up the Restore Cluster.

 

Schritt 1: Einrichten des externen NFS-Servers


Anforderungen


Der NFS-Server sollte außerhalb des Sicherungsclusters und des Wiederherstellungsclusters ausgeführt werden.

Die Größe des NFS-Serverdatenträgers muss größer sein als der Datenträger des primären Serverknotens.
See Hardware requirements for more details.

Schritt 1.1: Installieren von NFS-Bibliotheken


🚧

Wichtig!

Ignorieren Sie Schritt 1.1, wenn Sie bereits über einen NFS-Server verfügen.

Installieren nfs-utils library on the node you plan to use as the NFS Server.

dnf install nfs-utils -y
systemctl start nfs-server.service
systemctl enable nfs-server.service

Schritt 1.2: Konfigurieren des Bereitstellungspfades


Configure the mount path that you want to expose from the NFS Server.

chown -R nobody: "/datadisk"
chmod -R 777 "/datadisk"
systemctl restart nfs-utils.service

Schritt 1.3: Deaktivieren der Firewall


Firewalld ist eine Sicherheitsbibliothek, die Netzwerk- und Firewallregeln verwaltet.
See official Firewalld documentation for more details.

To disable Firewalld, run the following command.

systemctl stop firewalld
systemctl disable firewalld

Schritt 1.4: Ermöglichung des Zugriffs auf den NFS-Bereitstellungspfad für alle Sicherungs- und Wiederherstellungsknoten


All nodes must be able to access the NFS mount path. On the NFS Server, go to the /etc/exports file, and add an entry for the FQDN for each node (both server and agent) for both the Backup Cluster and the Restore Cluster.

Im Folgenden finden Sie ein Beispiel für das Hinzufügen eines Eintrags, wobei der folgende Eintrag den FQDN einer Maschine und die entsprechenden Berechtigungen für diese Maschine angibt:

echo "/datadisk sfdev1868610-d053997f-node.eastus.cloudapp.azure.com(rw,sync,no_all_squash,root_squash)" >> /etc/exports

Then run the following command to export mount path:

exportfs -arv
exportfs -s

 

Schritt 2: Deaktivieren der Clustersicherung


🚧

Wichtig!

  • Stellen Sie sicher, dass Sie den Schritt Umgebungsvoraussetzungen befolgt haben.

  • Make sure to back up the cluster_config.json file used for installation.

  • Mit diesem Schritt wird keine Sicherung für externe Datenquellen (z. B. SQL-Server) aktiviert. Sie müssen die Sicherung der externen Datenquelle separat aktivieren.

  • It is not recommended to reduce the backup interval to less than 15 minutes.

  • Automation Suite does not make a backup of all the Persistent Volumes, such as the volumes attached to the training pipeline in AI Center. A backup is created only for a few Persistent Volumes such as Alert Manager, Prometheus, Docker Registry, MongoDB, RabbitMQ, Ceph Objectstore, and Insights.

Create a file and name it backup.json. Make sure to fill it out based on the field definitions below.

backup.json


{
  "backup": {
    "etcdBackupPath": "PLACEHOLDER",
    "nfs": {
      "endpoint": "PLACEHOLDER",
      "mountpath": "PLACEHOLDER"
    }
  },
  "backup_interval": "15"
}
  • backup.etcdBackupPath — Path where the backup data will be stored on the NFS Server
  • backup.nfs.endpoint – Endpunkt des NFS-Servers;
  • backup.nfs.mountpath — Bereitstellungspfad des NFS-Servers;
  • backup_interval – Das Sicherungszeitintervall in Minuten.

In the following example, the backup data will be stored under /datadisk/backup/cluster0 on the NFS server:

{
  "backup": {
    "etcdBackupPath": "cluster0",
    "nfs": {
      "endpoint": "20.224.01.66",
      "mountpath": "/datadisk"
    }
  }
}

Schritt 2.1: Aktivieren der Sicherung auf dem primären Knoten des Clusters


To enable the backup on the primary node of the cluster, run the following command:

./install-uipath.sh -i backup.json -o output.json -b --accept-license-agreement

Schritt 2.2: Aktivieren der Sicherung auf sekundären Knoten des Clusters


To enable the backup on secondary nodes of the cluster, run the following command:

./install-uipath.sh -i backup.json -o output.json -b -j server --accept-license-agreement

Schritt 2.3: Aktivieren der Sicherung auf Agent-Knoten des Clusters


To enable the backup on agent nodes of the cluster, run the following command:

./install-uipath.sh -i backup.json -o output.json -b -j agent --accept-license-agreement

 

Schritt 3: Einrichten des Wiederherstellungsclusters


🚧

Wichtig!

  • Stellen Sie sicher, dass die Sicherung deaktiviert ist, bevor Sie den Cluster wiederherstellen. Siehe Deaktivieren der Clustersicherung.

  • Stellen Sie sicher, dass die Pakete wget, unzip und jq auf allen Wiederherstellungsknoten verfügbar sind.

  • Stellen Sie sicher, dass Sie den Schritt Umgebungsvoraussetzungen befolgt haben.

  • Alle externen Datenquellenquellen müssen identisch sein (SQL-Server).

  • Restart the NFS Server before cluster restoration. Execute the following command on the NFS Server node: systemctl restart nfs-server.

Anforderungen zum Wiederherstellen von Clustern


  • The Restore Cluster should have the same fqdn as the Backup Cluster.
  • The Restore Cluster should have the same number of server and agent nodes as that of Backup Cluster.
  • The Restore Cluster should have the same server and agent nodes resources as the Backup Cluster, as shown below:
    • Hardwarekonfiguration für CPU
    • Hardwarekonfiguration für den Arbeitsspeicher
    • Hardwarekonfiguration für den Festplattenspeicher
    • Hostname des Knotens

Installation type

Installation instructions

Requirements

Online single-node evaluation mode

Configuring the machines
Configuring the DNS
Offline single-node evaluation installation

Download only sf-installer zip and provide chmod -R 755 <sf_installer_folder> to extracted folder.
chmod -R 755 <sf_installer_folder> to extracted folder.

Offline single-node evaluation mode

Configuring the machines
Configuring the DNS
Offline single-node evaluation installation

Download only sf-installer zip and sf-infra-bundle.tar.gz.
chmod -R 755 <sf_installer_folder> to extracted folder.

Online multi-node HA-ready production mode

Configuring the machines
Offline multi-node HA-ready production installation

Download only sf-installer zip and provide chmod -R 755 <sf_installer_folder> to extracted folder.

Offline multi-node HA-ready production mode

Configuring the machines
Offline multi-node HA-ready production installation

Download only sf-installer zip and sf-infra-bundle.tar.gz.
chmod -R 755 <sf_installer_folder> to extracted folder.

Create a file and name it restore.json. Make sure to fill it out based on the following field definitions.

restore.json


{
  "fixed_rke_address": "PLACEHOLDER",
  "gpu_support": false,
  "fqdn": "PLACEHOLDER",
  "rke_token": "PLACEHOLDER",
  "restore": {
    "etcdRestorePath": "PLACEHOLDER",
    "nfs": {
      "endpoint": "PLACEHOLDER",
      "mountpath": "PLACEHOLDER"
    }
  },
  "infra": {
    "docker_registry": {
      "username": "PLACEHOLDER",
      "password": "PLACEHOLDER"
    }
  }
}
  • fqdn – Der FQDN des Lastausgleichs für den HA-fähigen Produktionsmodus mit mehreren Knoten oder der FQDN der Maschine für den Auswertungsmodus mit einem einzelnen Knoten
  • fixed_rke_address — The fqdn of the load balancer if one is configured, otherwise it is the fqdn of the first restore server node. Used to load balance node registration and kube API request. Refer to Fixed address and Configuring the load balancer for more info.
  • gpu_support — Use true oder false to enable or disable GPU support for the cluster (use if you have agent nodes with GPUs).
  • rke_token — This is a pre-shared, cluster-specific secret. This should be the same as Backup Cluster and can be found in the cluster_config.json file. It is needed for all the nodes joining the cluster.
  • restore.etcdRestorePath — Path where backup data is stored for the cluster in NFS Server. Configured at Backup with etcdBackupPath.
  • restore.nfs.endpoint – Der Endpunkt des NFS-Servers.
  • restore.nfs.mountpath: Bereitstellungspfad des NFS-Servers.
  • infra.docker_registry.username — The username that you have set in the Backup Cluster. It can be found in the cluster_config.json file and is needed for the docker registry.
  • infra.docker_registry.password — The password that you have set in the Backup Cluster. It can be found in the cluster_config.json file and is needed for the docker registry installation.

 

Onlineinstallation


Step 3.1: Restoring etcd on the primary node of the cluster

To restore etcd on the primary node of the cluster, run the following command:

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

Step 3.2: Restoring etcd on secondary nodes of the cluster

To restore etcd on secondary nodes of the cluster, run the following command:

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

🚧

Wichtig!

Die Knotenrolle ist für alle sekundären Serverknoten obligatorisch.

Step 3.3: Restoring etcd on agent nodes of the cluster

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

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

Schritt 3.4: Ausführen der Volume-Wiederherstellung auf dem primären Knoten

Once the etcd restore is complete, run volume restore on the primary node using the following command:

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

Schritt 3.5: Installieren des Clusterzertifikats der Automation Suite auf dem primären Wiederherstellungsknoten

sudo ./configureUiPathAS.sh tls-cert get --outpath /opt/
cp /opt/ca.crt /etc/pki/ca-trust/source/anchors/
update-ca-trust

 

Offline-Installation


Step 3.1: Restoring etcd on the primary node of the cluster


To restore etcd on primary node of the cluster, run the following command:

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

Step 3.2: Restoring etcd on secondary nodes of the cluster

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

Step 3.3: Restoring etcd on agent nodes of the cluster

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

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

Schritt 3.4: Ausführen der Volume-Wiederherstellung auf dem primären Knoten


Once the etcd restore is complete, run volume restore on the primary node using the following command:

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

Schritt 3.5: Installieren des Clusterzertifikats der Automation Suite auf dem primären Wiederherstellungsknoten

sudo ./configureUiPathAS.sh tls-cert get --outpath /opt/
cp /opt/ca.crt /etc/pki/ca-trust/source/anchors/
update-ca-trust

 

Deaktivieren der Clustersicherung


🚧

Wichtig!

You can enable the cluster backup to save data at a specified time using the backup_interval parameter. Disabling the cluster backup will cause data loss that was created between the last scheduled run and the time you disabled the backup.

To disable the backup, run the following commands in this order:

  1. Deaktivieren Sie die Sicherung auf dem primären Knoten des Clusters.
./install-uipath.sh -i backup.json -o output.json -b --disable-backup --accept-license-agreement
  1. Deaktivieren Sie die Sicherung auf sekundären Knoten des Clusters.
./install-uipath.sh -i backup.json -o output.json -b -j server --disable-backup --accept-license-agreement
  1. Deaktivieren Sie die Sicherung auf Agent-Knoten des Clusters.
./install-uipath.sh -i backup.json -o output.json -b -j agent --disable-backup --accept-license-agreement

 

Zusätzliche Konfigurationen


Aktualisieren des NFS-Servers


🚧

Wichtig!

  • Stellen Sie sicher, dass die Sicherung deaktiviert ist, bevor Sie den NFS-Server aktualisieren. Weitere Informationen finden Sie unter Deaktivieren der Clustersicherung.

To update the NFS server, do the following:

  1. Führen Sie die folgenden Schritte erneut aus:
    a. Schritt 1: Einrichten des externen NFS-Servers
    b. Schritt 2: Einrichten des Sicherungsclusters
    c. Schritt 3: Einrichten des Wiederherstellungsclusters

  2. Update the NFS Server information, and then include the new nfs.endpoint in both the backup.json and restore.json files.

Hinzufügen eines neuen Knotens zum Cluster


To add a new node to the cluster, re-run the following steps:

  1. Schritt 1: Einrichten des externen NFS-Servers
  2. Schritt 2: Einrichten des Sicherungsclusters

 

Bekannte Probleme (Known Issues)


Redis-Wiederherstellung


Wenn die Wiederherstellung ausgeführt wird, schlägt die Wiederherstellung von Redis fehl, sodass Sie einige zusätzliche Schritte ausführen müssen.

Follow the steps in the Troubleshooting section.

🚧

Wichtig!

Once Redis is restored, make sure to restart orchestratorpods.

Der Insights Looker-Pod kann nach der Wiederherstellung nicht gestartet werden


Sie können dieses Problem beheben, indem Sie den Looker-Pod aus der Insights-Anwendung in der ArgoCD-Benutzeroberfläche löschen. Die Bereitstellung erzeugt einen neuen Pod, der erfolgreich gestartet werden sollte.

Aktualisiert vor 4 Monaten


Sichern und Wiederherstellen des Clusters


Auf dieser Seite finden Sie Anweisungen zum Sichern und Wiederherstellen des Clusters für die Automation Suite.

Auf API-Referenzseiten sind Änderungsvorschläge beschränkt

Sie können nur Änderungen an dem Textkörperinhalt von Markdown, aber nicht an der API-Spezifikation vorschlagen.