Aktualisieren der Automation Suite

Führen Sie Haupt- und Nebenversions-Upgrades der Automation Suite auf EKS/AKS durch.

Die Automation Suite besteht aus mehreren Komponenten. Sie als Kunde und UiPath® sind gemeinsam für diese Komponenten verantwortlich. Weitere Informationen finden Sie in der Verantwortungsmatrix.

Sie sind für das Upgrade verantwortlich:

• Kubernetes-Infrastruktur, in der die Automation Suite bereitgestellt wird (AKS oder EKS)
• Komponenten, die Sie als Teil der Automation Suite einsetzen möchten (z. B. Gatekeeper, FluentD usw.)

UiPath® ist für das Upgrade dieser Komponenten verantwortlich:

• UiPath®-Dienste (z. B. Orchestrator)
• Komponenten, die als Teil der Automation Suite bereitgestellt werden (z. B. ArgoCD)

Upgraden von UiPath®-Diensten und -Komponenten

Vorbereitung

Hinweis:

• Wenn Sie auf die Automation Suite 2.2510 aktualisieren, müssen Sie eine PostgreSQL-Datenbank für AutomationSuite_Airflow mitbringen und die Verbindungszeichenfolge dafür in input.json konfigurieren. Weitere Informationen finden Sie unter Process Mining-spezifische Konfiguration.
• Wenn Sie mit Studio Web ein Upgrade von Versionen vor 2.2510.0 durchführen, stellen Sie sicher, dass Sie denselben Speicherklassennamen wie in storage_class_single_replica angegeben verwenden, um den RWX-Zugriffsmodus zu unterstützen. Weitere Informationen finden Sie unter Konfigurieren von input.json.

Lesen Sie außerdem die folgende Anleitung zur Datenbankwartung, bevor Sie das Upgrade starten.

Wichtig:

Sehr große Automation Suite-Datenbanktabellen können dazu führen, dass Datenbankmigrationsaufträge während des Upgrades viel länger dauern oder nicht abgeschlossen werden können. Wenn Sie Datenbanktabellen gut pflegen, verringert sich dieses Risiko.

Es wird empfohlen, nicht mehr benötigte Daten aus hohen Tabellen zu archivieren oder zu löschen, bevor das Upgrade gestartet wird; Weitere Informationen finden Sie unter Durchführen der Datenbankwartung.

Führen Sie die folgenden Schritte aus, um das Upgrade vorzubereiten:

1. Überprüfen Sie die Kompatibilitätsmatrix, um die unterstützten Versionen für jedes verfügbare Upgrade-Szenario zu bestimmen. Wenn Sie eigene Komponenten mitgebracht haben, stellen Sie sicher, dass die Versionen Ihrer Komponenten mit der Version kompatibel sind, auf die Sie aktualisieren möchten. Weitere Informationen finden Sie in der Kompatibilitätsmatrix.

2. Laden Sie versions.json und uipathctl für die Version, auf die Sie aktualisieren möchten, auf Ihre Verwaltungsmaschine herunter. Anweisungen zum Herunterladen finden Sie unter Herunterladen der Installationspakete.

3. Generieren Sie die neueste input.json -Datei wie folgt:

   • Option A: Um die neueste Revision Ihrer input.json -Datei abzurufen, führen Sie den folgenden Befehl aus:

     uipathctl manifest get-revision
     

   • Option B: Um alle letzten input.json -Dateien aufzulisten und diejenige zu bestimmen, die Sie auswählen möchten, führen Sie den folgenden Befehl aus:

     uipathctl manifest list-revisions
     

4. Wenn Sie ein Offline-Setup mit einer externen OCI-konformen Registrierung verwenden, müssen Sie die Registrierung vor dem Upgrade mit Container-Images und Helm-Charts hydratisieren. Weitere Informationen finden Sie unter Hydratisieren der Registrierung mit dem Offlinepaket.

5. Wenn Process Mining installiert ist und Sie die neueste Version von Airflow verwenden möchten, die PostgreSQL benötigt, müssen Sie vor dem Upgrade die Vorlage für die sqlalchemy -Verbindungszeichenfolge für PostgreSQL in der input.json -Datei hinzufügen oder aktualisieren: postgresql_connection_string_template_sqlalchemy_pyodbc.

   postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/<airflow db name>
   

6. Wenn Integration Service installiert ist, stellen Sie sicher, dass Ihre externen Cloud-Warteschlangen (SQS) synchronisiert sind und die Regionsübergreifende Replikation aktiviert ist. Zum Beispiel:

   • Konfigurieren Sie in Azure Queue Storage die Redundanzoptionen GRS/RA-GRS oder GZRS/RA-GZRS. Weitere Details finden Sie unter:
     • Datenredundanz in Azure Storage
     • Zuverlässigkeit im Azure-Warteschlangenspeicher
     • Anleitung für geografisch redundanten Entwurf
   • Erstellen Sie in Amazon SQS SQS-Warteschlangen in jeder Region und replizieren Sie Nachrichten mithilfe von SNS Fan-out oder benutzerdefinierter Logik. Weitere Details finden Sie unter:
     • Amazon SQS – Active/Active Disaster Recovery
     • Regionsübergreifende SNS-Nachrichtenzustellung

7. Wenn Sie von früheren Versionen der Automation Suite 2024.10 auf die Automation Suite 2.2510.0 oder höher aktualisieren und Studio Web aktiviert ist, müssen Sie auch Lösungen aktivieren. Weitere Details finden Sie unter Aktivieren oder Deaktivieren von Lösungen. Überprüfen Sie auch die zusätzlichen Hardwareanforderungen für Lösungen. Weitere Informationen finden Sie unter Kapazitätsplanung.

Ausführung

Führen Sie die folgenden Schritte aus, um ein Upgrade von UiPath®-Diensten und -Komponenten durchzuführen:

1. Bestätigen Sie, dass sich Ihr Cluster in einem guten Zustand befindet:

   uipathctl health check --namespace <uipath> --versions versions.json
   

2. Versetzen Sie den Cluster in den Wartungsmodus, um eine konsistente Sicherung zu gewährleisten:

   uipathctl cluster maintenance enable
   

   Wichtig:

   Dieser Vorgang verursacht Ausfallzeiten und Ihre Geschäftsautomatisierung wird angehalten, während der Wartungsmodus aktiviert ist.

3. Überprüfen Sie, ob sich der Cluster im Wartungsmodus befindet:

   uipathctl cluster maintenance is-enabled
   

4. Sichern Sie den Cluster und die SQL-Datenbank und überprüfen Sie dann, ob die Sicherung erfolgreich abgeschlossen wurde. Erstellen Sie eine Sicherung, bevor Sie auch Ihre Kubernetes-Infrastruktur aktualisieren.

   Wenn die folgenden Anforderungen gleichzeitig erfüllt sind, kopieren Sie den Wert von global.userInputs.identity.krb5KeytabSecret zu global.kerberosAuthConfig.userKeytab:

   • Sie die Active Directory-Integration mit Benutzername und Kennwort konfiguriert haben
   • Sie haben die Windows-Authentifizierung aktiviert
   • Sie verwenden keine integrierte SQL-Authentifizierung.

5. Ab Automation Suite 2.2510.2 muss der Wartungsmodus während des Upgrades aktiviert bleiben. Für Versionen vor Automation Suite 2.2510.2, Deaktivieren Sie den Wartungsmodus, bevor Sie das Upgrade durchführen:

   uipathctl cluster maintenance disable
   

   Hinweis:

   Wenn Sie auf die Automation Suite 2.2510.2 oder höher aktualisieren, überspringen Sie diesen Schritt und deaktivieren Sie den Wartungsmodus erst nach Abschluss des Upgrades.

6. Führen Sie das Upgrade von UiPath®-Diensten und -Komponenten durch:

   uipathctl cluster upgrade input.json --versions versions.json
   

   In der Automation Suite 2.2510.0 schlägt der Befehl uipathctl cluster upgrade mit dem folgenden Fehler fehl, wenn der Wartungsmodus deaktiviert ist: Please enable maintenance mode prior to attempting an upgrade. Use 'uipathctl cluster maintenance enable'.

   Um die Fehlermeldung zu vermeiden, verwenden Sie den folgenden Befehl, um das Upgrade auszuführen. Stellen Sie sicher, dass Sie alle erforderlichen Sicherungen erstellt haben, bevor Sie fortfahren.

   uipathctl cluster upgrade input.json --versions versions.json --skip-upgrade-readiness
   

   Wichtig:

   Dieser Vorgang führt zu Ausfallzeiten und Ihre Geschäftsautomatisierung wird während des gesamten Upgrade-Prozesses angehalten. Es ist wichtig, dass Sie das Upgrade nur während Ihres Wartungsfensters durchführen.

7. Ab Automation Suite 2.2510.2 Deaktivieren des Wartungsmodus:

   uipathctl cluster maintenance disable
   

8. Prüfen Sie, ob sich der Cluster nach dem Upgrade in einem guten Zustand befindet:

   uipathctl health check --namespace <uipath> --versions versions.json
   

   Hinweis:

   Wenn Sie ein Upgrade auf die Automation Suite 2.2510 oder höher durchgeführt haben, können Sie Dapr und Cert Manager deinstallieren, wenn Sie diese Add-ons für Process Mining oder Task Mining installiert haben. Weitere Informationen finden Sie in den Abschnitten Dapr deinstallieren und Zertifikatsmanager deinstallieren .

Upgrade der Kubernetes-Infrastruktur

Hinweis:

Die Automation Suite unterstützt die Upstream-Versionen N-1 bis N-3 von Kubernetes unabhängig vom Cloud-Anbieter. Wenn die Upstream-Version beispielsweise 1.27 ist, unterstützen wir die Versionen 1.26, 1.25 und 1.24. Unterstützte Versionen finden Sie in der Kompatibilitätsmatrix.

Sie sind für das Upgrade der Kubernetes-Infrastruktur verantwortlich, die die Automation Suite hostet. Sie sollten die Standardpraktiken Ihres Unternehmens befolgen, um die Kubernetes-Infrastruktur zu upgraden.

Durchführen von Vorgängen nach dem Upgrade

In den folgenden Szenarien wird beschrieben, welche Vorgänge nach dem Upgrade für Ihre Umgebung erforderlich sind:

• Wenn Sie ein Upgrade auf Automation Suite 2.2510.0 oder höher durchgeführt haben und Process Mining oder Task Mining in der vorherigen Version aktiviert war:

  • Deinstallieren Sie Dapr. Weitere Informationen finden Sie unter Deinstallieren von Dapr.
  • Deinstallieren Sie den Zertifikatsmanager. Weitere Informationen finden Sie unter Deinstallieren des Zertifikatsmanagers.

• Wenn Sie ein Upgrade auf die Automation Suite 2.2510.0 oder höher durchgeführt haben, müssen Sie Ihre vorhandenen Lizenzen für jede Organisation und jeden Host sofort reaktivieren:

  • Online-Aktivierung: Direkt nach dem Upgrade reaktivieren.
  • Offline-Aktivierung: Generieren Sie eine neue Aktivierungsnutzlastdatei aus der Automation Suite-Instanz und laden Sie sie dann unter Aktivierung hoch.

  Die Wiederverwendung alter Aktivierungsdateien ist nicht zulässig und führt zu einer ungültigen Lizenz. Die Lizenzreaktivierung muss mit der Schaltfläche Lizenz aktualisieren durchgeführt werden. Deaktivieren und aktivieren Sie die Lizenz dann nicht manuell, da dadurch Dienste deaktiviert werden.