Ausführen des Upgrades

Wichtig:

Um ein Automation Suite-Upgrade durchzuführen, müssen Sie den Cluster in den Wartungsmodus versetzen. Im Wartungsmodus kommt es während des gesamten Upgrade-Prozesses zu Ausfallzeiten und Ihre Geschäftsautomatisierung wird während dieser Zeit angehalten.

Es wird dringend empfohlen, vor dem Upgrade eine Sicherung des Clusters und der SQL-Datenbank zu erstellen. Dadurch wird sichergestellt, dass Sie den Cluster wiederherstellen können, wenn während des Upgradevorgangs etwas schief läuft.

Ausführen der Voraussetzungsprüfungen

Sie müssen sicherstellen, dass alle Upgrade-Anforderungen erfüllt sind, bevor Sie den Cluster in den Wartungsmodus versetzen.

1. Führen Sie die Prüfungen der Infrastrukturvoraussetzungen mit dem folgenden Befehl aus:

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl rke2 prereq run cluster_config.json --versions versions/helm-charts.json

2. Führen Sie die Voraussetzungsprüfungen für die gemeinsam genutzten Komponenten und Dienste mit dem folgenden Befehl aus:

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl prereq run cluster_config.json --versions versions/helm-charts.json

Konfigurieren der Sicherung

Führen Sie die folgenden Schritte aus, um die Sicherung zu konfigurieren:

1. Stellen Sie sicher, dass Sie die Sicherung im Cluster aktiviert haben. Sie müssen die Sicherung mit derselben Version des Installationsprogramms erstellen, die Sie für die aktuelle Bereitstellung verwendet haben. Anweisungen finden Sie in der Dokumentation zum Sichern und Wiederherstellen der Automation Suite-Version, für die Sie ein Upgrade planen. Wenn Sie z. B. ein Upgrade der Automation Suite 2023.4 planen, befolgen Sie die Anweisungen in der Anleitung 2023.4.
2. Stellen Sie eine Verbindung mit einem der Serverknoten über SSH her.
3. Stellen Sie sicher, dass alle gewünschten Volumes über Sicherungen im Cluster verfügen:

   • Wenn Sie von 2022.4 oder älter upgraden, führen Sie den folgenden Befehl aus:

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

   • Wenn Sie von 2022.10 oder neuer upgraden, führen Sie den folgenden Befehl aus:

     ./configureUiPathAS.sh snapshot list

   • Wenn Sie von 2024.10 oder neuer upgraden, führen Sie den folgenden Befehl aus:

     ./bin/uipathctl snapshot list

   Hinweis: Die Sicherung kann einige Zeit in Anspruch nehmen. Warten Sie etwa 15–20 Minuten und überprüfen Sie die Sicherung des Volumes erneut.

Nachdem die Sicherung erstellt wurde, fahren Sie mit den folgenden Schritten fort.

Hinweis:

Stellen Sie sicher, dass Sie den Befehl uipathctl aus dem Zielversionsverzeichnis verwenden, wenn Sie ein Upgrade von 23.10.0 oder höher durchführen.

Deaktivieren der Sicherung

Bevor Sie den Cluster in den Wartungsmodus versetzen, müssen Sie die Sicherung deaktivieren, um zu vermeiden, dass der Cluster in einem suboptimalen Zustand gesichert wird. Weitere Informationen finden Sie unter Deaktivieren der Snapshot-Sicherung.

Wichtig: Wenn Sie die Sicherung aktiviert haben und auf 2024.10.1 oder 2024.10.2 aktualisieren, stellen Sie sicher, dass Sie die auf der Seite Upgrade schlägt aufgrund des Migrationsproblems von Velero fehlgeschlagen beschriebenen Schritte ausführen.

Versetzen des Clusters in den Wartungsmodus

Wenn der Cluster in den Wartungsmodus versetzt wird, werden der Ingress-Controller und alle UiPath®-Dienste heruntergefahren und der gesamte eingehende Datenverkehr zum Automation Suite-Cluster blockiert.

1. Führen Sie Folgendes aus, um den Cluster in den Wartungsmodus zu versetzen:

   ./bin/uipathctl cluster maintenance enable

2. Führen Sie Folgendes aus, um zu überprüfen, ob sich der Cluster im Wartungsmodus befindet:

   ./bin/uipathctl cluster maintenance is-enabled

Migrieren von Longhorn-Workloads, MongoDB-Daten und Ceph zu einer Helm-basierten Bereitstellung

Wichtig:

Wenn Sie ein Upgrade von der Automation Suite 2024.10.0 auf die Automation Suite 2024.10.1 durchführen, müssen Sie vor der Ausführung des Befehls vor dem Upgrade zusätzliche Schritte ausführen. Weitere Informationen finden Sie im Abschnitt Fehlerbehebung .

Führen Sie den folgenden obligatorischen Befehl vor dem Upgrade aus:

./bin/uipathctl cluster pre-upgrade cluster_config.json --versions-dir ./versions

Dieser Befehl migriert selektiv Longhorn-Workloads zu lokalen PV- und MongoDB-Daten zu SQL und migriert die Ceph-Bereitstellung von ArgoCD zu einer Helm-basierten Bereitstellung.

Aktualisieren von Kubernetes und anderen Infrastrukturkomponenten

Um Kubernetes und die anderen Infrastrukturkomponenten zu aktualisieren, führen Sie den folgenden Befehl auf dem primären Serverknoten aus:

Wichtig:

Stellen Sie sicher, dass Sie die generierte cluster_config.json-Datei wie unter Aktualisieren der Clusterkonfiguration beschrieben aktualisiert haben.

cd /opt/UiPathAutomationSuite/latest/installer

./bin/uipathctl rke2 upgrade cluster_config.json --versions versions/helm-charts.json

Hinweis:

• Wenn Sie den vorherigen Befehl auf dem primären Serverknoten ausführen, werden das Installationsprogramm und cluster_config.json in den Standardspeicherort /opt/UiPathAutomationSuite/<version>/installer kopiert und es wird ein Upgrade der Infrastruktur auf allen Maschinen ausgeführt.
• Am Standardspeicherort /opt/UiPathAutomationSuite/<version> müssen auf allen Knoten mindestens 5 GB verfügbar sein.

• Um den Standardspeicherort zu ändern, aktualisieren Sie die folgende Umgebungsvariable mit dem gewünschten Speicherort. Stellen Sie sicher, dass der Speicherort auf allen Knoten verfügbar ist und die erforderlichen Berechtigungen zum Ausführen des Upgrades vorliegen.

  export INSTALLER_DIRECTORY=/path/to/copy/installer

• Nachdem Sie den vorherigen Befehl sowie das Upgrade ausgeführt haben, wird das Installationsprogramm in den Speicherort /path/to/copy/installer/<version>/installer kopiert. version wird durch die Version des Installationsprogramms ersetzt, das Sie ausführen.

Fehlersuche und ‑behebung

• Die Upgrade-Protokolle auf dem primären Server sind am Standardspeicherort /opt/UiPathAutomationSuite/latest/installer/upgrade-logs verfügbar, außer Sie haben explizit einen benutzerdefinierten Speicherort für das Installationsprogramm verwendet.
• Auf allen anderen Knoten sind die Protokolle am Standardspeicherort /opt/UiPathAutomationSuite/<version>/installer/upgrade-logs verfügbar, außer Sie haben diesen Speicherort explizit über die Variable INSTALLER_DIRECTORY geändert.

Installieren der gemeinsamen Komponenten und UiPath®-Dienste

1. Wenn Sie Insights aktiviert haben, müssen Sie den folgenden Befehl ausführen, um sicherzustellen, dass die Insights-Daten nach dem Upgrade vorhanden sind:

   kubectl -n uipath create cm migration-lock --from-literal=migration=pending --dry-run=client -o yaml | kubectl apply -f -

   Hinweis:

   Die Ausführung dieses Befehls hat keine nachteiligen Auswirkungen, wenn Insights nicht aktiviert ist.

2. Um die gemeinsamen Komponenten und die UiPath®-Produktdienste zu installieren, führen Sie den folgenden Befehl auf dem primären Serverknoten aus:

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl manifest apply cluster_config.json --versions versions/helm-charts.json

   Wichtig:

   Nach Abschluss des Upgrades wird der Wartungsmodus automatisch deaktiviert.

3. Um zu überprüfen, ob die Automation Suite fehlerfrei ist, führen Sie einen der folgenden Befehle aus:

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl health check

   Hinweis:

   Wenn Sie helm-charts.json nicht finden können, können Sie alternativ versions.json verwenden. Informationen zum Herunterladen von versions.json finden Sie unter Herunterladen der Installationspakete.

Führen Sie nach Abschluss des Upgrades Ihre relevante Bereinigungs- und Migrationsaktivität durch.