HA-fähiger Online-Produktionsmodus mit mehreren Knoten

Vorbereitung

1. Suchen Sie einen Server (kein Agent), der die Anforderungen an die Festplatte für eine Onlineinstallation erfüllt. Dieser wird im gesamten Dokument primärer Server genannt. Wenn Sie ein selbstsigniertes Zertifikat verwenden, führen Sie den folgenden Befehl aus:

   ### Please replace /path/to/cert with path to location where you want to store certificates.
   sudo ./configureUiPathAS.sh tls-cert get --outpath /path/to/cert
   
   ### Now copy the ca.crt file generated in above location to trust store location
   sudo cp --remove-destination /part/to/cert/ca.crt /etc/pki/ca-trust/source/anchors/
   
   ### Update the trust store
   sudo update-ca-trust

2. Laden Sie das neue Installationsprogramm (installer.zip) auf alle Knoten herunter und entpacken Sie es.
   Hinweis: Erteilen Sie dem Ordner die richtigen Berechtigungen, indem Sie sudo chmod 755 -R <installer-folder> ausführen.
3. Stellen Sie die ursprüngliche cluster_config.json-Datei auf dem primären Server zur Verfügung.
4. Generieren Sie die neue cluster_config.json-Datei wie folgt:
   • Wenn Sie die alte cluster_config.json-Datei haben, verwenden Sie den folgenden Befehl, um die Konfigurationsdatei aus dem Cluster zu generieren:

     cd /path/to/new-installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o /path/to/store/generated/cluster_config.json

   • Wenn Sie nicht über die alte Konfigurationsdatei verfügen, führen Sie den folgenden Befehl aus:

     cd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.json

     Hinweis: Unter Erweiterte Installation erfahren Sie, wie Sie die verbleibenden Parameter ausfüllen.
5. Kopieren Sie diese Datei cluster_config.json auf allen Knoten in den Installationsordner.

Ausführung

Wartung und Sicherung

1. Stellen Sie sicher, dass Sie die Sicherung im Cluster aktiviert haben. Weitere Details finden Sie unter Aktivieren der Clustersicherung.
2. Stellen Sie eine Verbindung mit einem der Serverknoten über SSH her.
3. Stellen Sie sicher, dass alle gewünschten Volumes Sicherungen im Cluster haben, indem Sie /path/to/new-installer/configureUiPathAS.sh verify-volumes-backup ausführen.
   Hinweis: Die Sicherung kann einige Zeit in Anspruch nehmen. Warten Sie etwa 15–20 Minuten und überprüfen Sie die Sicherung des Volumes erneut.
4. Um zu überprüfen, ob die Automation Suite fehlerfrei ist, führen Sie Folgendes aus:

   kubectl get applications -n argocd

5. Versetzen Sie den Cluster wie folgt in den Wartungsmodus:
   1. Führen Sie den folgenden Befehl aus:

      /path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode

   2. Stellen Sie sicher, dass sich der Cluster im Wartungsmodus befindet, indem Sie den folgenden Befehl ausführen:

      /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

6. Erstellen Sie eine Sicherung der SQL-Datenbank.

Upgrade der Infrastruktur auf Servern

1. Stellen Sie eine Verbindung mit jedem Server über SSH her.
2. Führen Sie sudo su - aus, um zum Stammverzeichnis zu werden.
3. Führen Sie den folgenden Befehl auf allen Servern aus:

   /path/to/new-installer/install-uipath.sh --upgrade -k -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

Als Teil dieses Befehls wird auch die Sicherung des Clusterstatus übernommen und alle weiteren geplanten Sicherungen pausiert.

Hinweis: Dieser Befehl erstellt auch eine Sicherung des Clusterstatus und hält alle anderen geplanten Sicherungen an.

Upgrade der Infrastruktur auf Agenten

1. Stellen Sie eine Verbindung mit jedem Server über SSH her.
2. Führen Sie sudo su - aus, um zum Stammverzeichnis zu werden.
3. Führen Sie den folgenden Befehl aus:

   /path/to/new-installer/install-uipath.sh --upgrade -k -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

Ausführen des Rests des Upgrades auf dem primären Server

1. Stellen Sie eine Verbindung mit dem primären Server über SSH her.
2. Führen Sie sudo su - aus, um zum Stammverzeichnis zu werden.
3. Führen Sie den folgenden Befehl aus:

   /path/to/new-installer/install-uipath.sh --upgrade -f -s -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

   Hinweis: Dieser Befehl deaktiviert den Wartungsmodus, den Sie vor dem Upgrade aktiviert haben, da alle Dienste während des Upgrades aktiv sein müssen.
4. Setzen Sie nach dem erfolgreichen Upgrade und der Verifizierung die Sicherungsplanung auf dem Knoten fort, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

Rollback bei Fehler

Vorbereitung

1. Erstellen Sie einen separaten Ordner, um die alten Bundles zu speichern und die folgenden Vorgänge innerhalb dieses Ordners durchzuführen.
2. Laden Sie die alte Version des Installationsprogramms (installer.zip) auf alle Knoten herunter und entpacken Sie es.
   Hinweis: Erteilen Sie dem Ordner die richtigen Berechtigungen, indem Sie sudo chmod 755 -R <installer-folder> ausführen.
3. Erstellen Sie die restore.json-Datei und kopieren Sie sie auf alle Knoten. Weitere Informationen finden Sie unter Sichern und Wiederherstellen des Clusters.
4. Stellen Sie sicher, dass die etcd-Sicherungsdaten auf dem primären Knoten am folgenden Speicherort vorhanden sind: /mnt/backup/backup/<etcdBackupPath>/<node-name>/snapshots.
   • etcdBackupPath – Dies ist derselbe wie der beim Aktivieren des node-name der Sicherung in backup.json angegeben;
   • node-name – der Hostname der VM des primären Servers.

Bereinigung des Clusters

1. Kopieren Sie das dedizierte Skript und führen Sie es aus, um alles von diesem Knoten zu deinstallieren. Tun Sie dies für alle Knoten. Weitere Informationen finden Sie unter Fehlerbehebung.
2. Stellen Sie alle UiPath-Datenbanken in der älteren Sicherung wieder her, die vor dem Upgrade erstellt wurde.

Wiederherstellen der Infrastruktur auf Serverknoten

1. Stellen Sie eine Verbindung mit dem primären Server her. Dies sollte der gleiche Serverknoten sein, den Sie während des Upgrades ausgewählt haben.
2. Stellen Sie die Infrastruktur wieder her, indem Sie den folgenden Befehl ausführen:

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

3. Verbinden Sie die restlichen Serverknoten nacheinander über SSH.
4. Stellen Sie die Infrastruktur auf diesen Knoten wieder her, indem Sie den folgenden Befehl nacheinander auf den Serverknoten ausführen. Das parallele Ausführen wird nicht unterstützt.

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

Wiederherstellen der Infrastruktur auf Agentenknoten

1. Stellen Sie eine Verbindung mit jeder Agenten-VM über SSH her.
2. Stellen Sie die Infrastruktur auf diesen Knoten wieder her, indem Sie den folgenden Befehl ausführen:

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

Wiederherstellen von Volume-Daten

1. Stellen Sie mit SSH eine Verbindung mit dem primären Server her.
2. Wechseln Sie zum neueren Installationsordner.
   Hinweis: Die vorherigen Infrastruktur-Wiederherstellungsbefehle wurden mit dem alten Installationsprogramm ausgeführt. Die folgenden Befehle werden mit dem neuen Installationspaket ausgeführt.
3. Deaktivieren Sie den Wartungsmodus im Cluster, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode

4. Stellen Sie sicher, dass der Wartungsmodus deaktiviert ist, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

5. Kopieren Sie die Datei restore.json, die in der Phase der Infrastrukturwiederherstellung verwendet wurde, in den neuen Installationspaketordner.
6. Stellen Sie Volumes vom dem neuen Installationspaket aus wieder her, indem Sie den folgenden Befehl ausführen:

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

7. Überprüfen Sie nach Abschluss der Wiederherstellung, ob alles wiederhergestellt ist und ordnungsgemäß funktioniert.
8. Während des Upgrades wurden geplante Sicherungen auf dem primären Knoten deaktiviert. Führen Sie den folgenden Befehl aus, um sie wieder zu aktivieren:

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups