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.

Clusterdaten werden auf dem NFS-Server gesichert. Stellen Sie sicher, dass Sie den NFS-Server konfigurieren, bevor Sie fortfahren.

Sie müssen die Sicherung konfigurieren, nachdem Sie den Wartungsmodus deaktiviert haben, um sicherzustellen, dass alle Transaktionen abgeschlossen sind.

Versetzen des Clusters in den Wartungsmodus

Putting the cluster in maintenance mode shuts down the ingress controller and all the UiPath® services, blocking all the incoming traffic to the Automation Suite cluster.

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

   ./configureUiPathAS.sh enable-maintenance-mode

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

   ./configureUiPathAS.sh is-maintenance-enabled

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

   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.

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

./install-uipath.sh --upgrade -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k --accept-license-agreement

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 GiB 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.

Updating the shared components and UiPath® product services

1. To upgrade the shared components and the UiPath® product services, run the following command on the primary server node:

   ./install-uipath.sh --upgrade -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -f -s --accept-license-agreement

   Wichtig:

   Nach Abschluss des Upgrades wird der Wartungsmodus automatisch deaktiviert.

2. 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

   cd /opt/UiPathAutomationSuite/latest/installer/bin
   ./uipathctl health test --versions versions.json

   Hinweis:

   Informationen zum Herunterladen des Skripts versions.json finden Sie unter Herunterladen der Installationspakete.

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