Ausführen des Upgrades

Führen Sie das Upgrade eines Automation Suite-Clusters aus, indem Sie den Wartungsmodus aktivieren, den Cluster sichern und den Upgradeprozess ausführen.

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

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:

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

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.

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

Aktualisieren der gemeinsamen Komponenten und UiPath®-Produktdienste

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

   ./install-uipath.sh --upgrade -i 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.