Aktualisieren der Automation Suite

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 (OpenShift)
• 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 oder höher 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 verwenden, um den RWX-Zugriffsmodus zu unterstützen.

  Weitere Informationen dazu finden Sie unter Konfigurieren von input.json .

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 --namespace <uipath>

   • 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 --namespace <uipath>

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 unterstützen. 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 cluster_config.json -Datei hinzufügen oder aktualisieren: postgresql_connection_string_template_sqlalchemy_pyodbc.

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

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>

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

   uipathctl cluster maintenance enable --namespace <uipath>

   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 --namespace <uipath>

4. Sichern Sie den Cluster und die SQL-Datenbank und überprüfen Sie dann, ob die Sicherung erfolgreich abgeschlossen wurde.
   Wichtig:

   Es wird dringend empfohlen, vor dem Upgrade der Automation Suite 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. Dies gilt auch vor dem Upgrade Ihrer Kubernetes-Infrastruktur.

   Make sure to copy the value of global.userInputs.identity.krb5KeytabSecret to global.kerberosAuthConfig.userKeytab, if you simultaneously meet the following requirements:

   • Sie die Active Directory-Integration mit Benutzername und Kennwort konfiguriert haben
   • Sie haben die Windows-Authentifizierung aktiviert
   • Sie verwenden keine integrierte SQL-Authentifizierung.
5. Führen Sie das Upgrade von UiPath®-Diensten und -Komponenten durch:

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

   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.

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

   uipathctl health check --namespace <uipath>

   Note: If you upgraded to Automation Suite 2.2510 or higher, you can uninstall Dapr and Cert Manager, if you previously installed these add-ons for Process Mining or Task Mining. For details, refer to the and sections.

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 der folgenden Tabelle werden die möglichen Szenarien beschrieben, in denen Sie Vorgänge nach dem Upgrade durchführen müssen:

Bedingung

Aktion

1. Sie haben auf Automation Suite 2.2510.0 oder neuer aktualisiert.

Sie müssen 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.