HA-fähiger Offline-Produktionsmodus mit mehreren Knoten

Vorbereitung

1. Suchen Sie einen Server (kein Agent), der die Anforderungen an die Festplatte für eine Offlineinstallation 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 vollständige Offlinepaket (sf.tar.gz) auf den ausgewählten Server herunter.
3. Laden Sie das reine Infrastruktur-Offlinepaket (sf-infra.tar.gz) auf alle anderen Knoten herunter.
4. 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.
5. Stellen Sie die ursprüngliche cluster_config.json-Datei auf dem primären Server zur Verfügung.
6. Generieren Sie die neue cluster_config.json-Datei wie folgt:

   • Wenn Sie die alte Datei „cluster_config.json“ 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 cluster config-Datei 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.
7. 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 Informationen finden Sie unter Sichern und Wiederherstellen des Clusters.
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 den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh verify-volumes-backup

   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

Hinweis: Das gleichzeitige Aktualisieren der Infrastruktur auf Servern und Agenten wird nicht unterstützt und führt zu einem Fehler. Führen Sie diese Schritte nacheinander aus.

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 Serverknoten aus:

   /path/to/new-installer/install-uipath.sh --upgrade -k -i /path/to/cluster_config.json --offline-bundle "/path/to/sf-infra.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json

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

Upgrade der Infrastruktur auf Agenten

Hinweis: Das gleichzeitige Aktualisieren der Infrastruktur auf Servern und Agenten wird nicht unterstützt und führt zu einem Fehler. Führen Sie diese Schritte nacheinander aus.

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 --offline-bundle "/path/to/sf-infra.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --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 --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --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 ältere 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 eine 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 Server 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 (dieser ist derselbe wie der, der beim Upgrade ausgewählt wurde).
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 ausführen:

   /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

   Hinweis: Führen Sie diesen Befehl nacheinander auf den Serverknoten aus. Das parallele Ausführen wird nicht unterstützt.

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 neuen Installationsordner.
   Hinweis: Die vorherigen Infrastruktur-Wiederherstellungsbefehle wurden mit dem älteren Installationsprogramm ausgeführt. Die folgenden Befehle werden mit dem neueren 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.jsonfile, die in der Phase der Infrastrukturwiederherstellung verwendet wurde, in den neuen Installationspaketordner.
6. Stellen Sie Volumes vom dem neueren 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