Handbuch: Online-Upgrade

Vorbereitung

Wichtig:

Führen Sie die folgenden Schritte auf dem ersten Serverknoten und dann auf allen anderen Knoten (Server und Agent) im Cluster aus.

Stellen Sie sicher, dass Sie 10 GiB freien Speicherplatz im Ordner /opt/UiPathAutomationSuite auf allen Knoten haben. Wenn Sie nicht über genügend Speicherplatz verfügen, können Sie entweder die Kapazität dieses Ordners erhöhen oder alle vorherigen Installationsdateien mit Ausnahme von cluster_config.json entfernen. Sie können das vorherige Installationsprogramm jederzeit erneut herunterladen.

Führen Sie den folgenden Befehl aus, um den verfügbaren Speicherplatz zu überprüfen: df -h /opt/UiPathAutomationSuite .

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

1. Melden Sie sich mit SSH bei einer beliebigen Servermaschine an. Melden Sie sich bei einem Auswertungsprofil mit einem einzelnen Knoten, bei dem Sie nur über einen Serverknoten verfügen, bei diesem Knoten an.
2. Root-Benutzer werden:

   sudo su -

3. Erstellen Sie einen Installationsordner im Verzeichnis /opt/UiPathAutomationSuite :

   # Please replace {version} with installer version
   mkdir -p /opt/UiPathAutomationSuite/{version}/installer

4. Laden Sie sf-installer.zip herunter und kopieren Sie es nach /opt/UiPathAutomationSuite/{version}/installer. Anweisungen zum Herunterladen finden Sie unter sf-installer.zip.

   cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer

5. sf-installer.zip entpacken:

   cd /opt/UiPathAutomationSuite/{version}/installer
   unzip sf-installer.zip -d .

6. Erteilen Sie dem Installationsprogramm die Berechtigung:

   chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer

7. Generieren Sie die neueste cluster_config.json -Datei auf dem ersten Serverknoten und kopieren Sie sie auf die restlichen Knoten.
   Hinweis: Weitere Informationen zum Konfigurieren der cluster_config.json-Parameter finden Sie unter Erweiterte Installation.

   • Wenn Sie das alte cluster_config.json haben, generieren Sie die Konfigurationsdatei aus dem Cluster:

     cd /opt/UiPathAutomationSuite/{version}/installer
     
     ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json

   • Wenn Sie nicht über die alte cluster_config.json -Datei verfügen, generieren Sie eine Überschreibung aller Standardwerte, was Sie möglicherweise zum Zeitpunkt der Installation der vorherigen Version getan haben:

     cd /opt/UiPathAutomationSuite/{version}/installer
     
     ./configureUiPathAS.sh config get -o ./cluster_config.json

   • Wenn Sie ein Upgrade von einer früheren Version des eigenständigen AI CenterTM durchführen und Ihre Version 2022.10 von AI Center mit einem externen Orchestrator verbunden werden muss, kopieren Sie das Orchestrator-Zertifikat auf die virtuelle Maschine. Nachdem Sie das Zertifikat kopiert haben, werden die folgenden Konfigurationsdetails in cluster_config.jsonbenötigt:

     "aicenter": {
         "enabled": true,
         "orchestrator_url": "https://orchestrator.example.com", //Specify the Orchestrator URL for AI Center
         "identity_server_url": "https://orchestrator.example.com/identity", //Specify the Identiy URL for AI Center
         "orchestrator_cert_file_path": "/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer", //Specify the path to the Orchestrator certificate
         "identity_cert_file_path": "/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer", //Specify the path to Identity certificate file
         "metering_api_key": "test" //Specify the metering API key
       }

     Hinweis: Wenn das AI Center einen externen Orchestrator erfordert, fügen Sie sql_connection_string_template und sql_connection_string_template_odbc in der cluster_config.json-Datei hinzu.

     Nach dem Upgrade auf AI Center 2022.10 und dem Wechsel zu einem externen Speicher schlägt das Veröffentlichen einer in 2022.4 erstellten Fähigkeit fehl. Führen Sie das Skript hier aus, um dies zu beheben.

   • Wenn Sie die Automation Suite von einer früheren Version aktualisieren und jetzt auch Process Mining aktivieren, müssen Sie sql_connection_string_template_sqlalchemy_pyodbc aktualisieren. Nachfolgend finden Sie ein Beispiel.

     "sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://[e-mail]:[e-mail]:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

     Siehe auch Manuell: Erweiterte Installation.

8. (Optional) Wenn Sie immer noch ein selbstsigniertes Zertifikat verwenden, das vom Installationsprogramm generiert wurde, führen Sie den folgenden Befehl aus. Dieser Schritt ist auf dem ersten Serverknoten erforderlich, auf dem Sie das Upgrade von UiPath-Produkten durchführen.

   ### Please replace /path/to/cert with path to location where you want to store certificates.
   ./configureUiPathAS.sh tls-cert get --outpath /path/to/cert
   
   ### Now copy the ca.crt file generated in above location to trust store location
   sudo cp --remove-destination /part/to/cert/ca.crt /etc/pki/ca-trust/source/anchors/
   
   ### Update the trust store
   sudo update-ca-trust

Ausführung

Wichtig: Wenn während oder nach dem Upgrade Fehler oder Probleme auftreten, können Sie auf die vorherige Version zurücksetzen, sofern Sie zuvor eine Sicherung konfiguriert haben. Anweisungen finden Sie unter Rollback bei Fehlern.

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 zur Sicherung und Wiederherstellung der Automation Suite-Version, für die Sie eine Aktualisierung planen. Wenn Sie z. B. ein Upgrade der Automation Suite 2021.10 planen, befolgen Sie die Anweisungen im 2021.10-Handbuch.
2. Stellen Sie eine Verbindung mit einem der Serverknoten über SSH her.
3. Um zu überprüfen, ob alle gewünschten Volumes über Sicherungen im Cluster verfügen, führen Sie Folgendes aus:

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

   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.

Versetzen des Clusters in den Wartungsmodus

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

Wichtig: Dieser Vorgang führt zu Ausfallzeiten und Ihre Geschäftsautomatisierung wird während des gesamten Upgrade-Prozesses angehalten.

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

   cd /opt/UiPathAutomationSuite/{version}/installer
   ./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

   Wichtig: Erstellen Sie nach Aktivierung des Wartungsmodus eine Sicherung Ihres SQL-Servers, damit keine weiteren Transaktionen in Ihrer SQL-Datenbank aufgezeichnet werden.

Aktualisieren von Kubernetes und anderen Infrastrukturkomponenten

Wichtig:

Sie müssen das Infrastrukturupgrade auf allen Knoten im Cluster durchführen.

Sie können diesen Schritt nicht auf mehreren Knoten gleichzeitig ausführen. Sie müssen warten, bis das Upgrade auf jedem Knoten abgeschlossen ist, bevor Sie zu einem anderen wechseln.

1. Melden Sie sich bei jedem Knoten an, auf dem Sie das Infrastrukturupgrade durchführen möchten.
2. Führen Sie sudo su - aus, um zum Stammverzeichnis zu werden.
3. Stellen Sie sicher, dass rke service auf Server- und Agent-Knoten aktiviert ist.

   Wenn der Dienst deaktiviert ist, aktivieren Sie ihn, indem Sie den folgenden Befehl ausführen:

   • Für einen Serverknoten:

     [[ $(systemctl is-enabled rke2-server.service) != "enabled" ]] && systemctl enable rke2-server.service

   • Für einen Agent-Knoten:

     [[ $(systemctl is-enabled rke2-agent.service) != "enabled" ]] && systemctl enable rke2-agent.service

4. Führen Sie den folgenden Befehl aus, um das Upgrade zu starten:
   Wichtig: Stellen Sie sicher, dass Sie die Datei cluster_config.json aktualisiert haben, die wie in den Vorbereitungsschritten beschrieben generiert wurde.

   # replace {version} with the version you are upgrading to
   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./install-uipath.sh --upgrade -k -i ./cluster_config.json -o ./output.json --accept-license-agreement

   Wichtig:

   Wenn Sie den folgenden Fehler erhalten, befolgen Sie die Anweisungen unter Herabstufen von Ceph von 16.2.6 auf 15.2.9.

   Ceph cluster is running on version: 16.2.6 with known bug(https://docs.ceph.com/en/quincy/releases/pacific/#v16-2-6-pacific). Please provide temporary backup directory (via environment variable 'TMP_CEPH_BACKUP_PATH') to downgrade ceph

Aktualisieren von gemeinsam genutzten Komponenten und UiPath Produktdiensten

Wichtig: Wenn Sie Ihre Installation mit einem einzelnen Knoten zuvor mit einer Azure-Vorlagenversion vor 2022.10.3 bereitgestellt haben und jetzt auf eine neuere Automation Suite-Version aktualisieren möchten, müssen Sie das Flag zone_resilience in der cluster_config.json-Datei in /opt/UiPathAutomationSuite/Installer auf false festlegen.

In diesem Schritt werden die Fabric- und Dienstkomponenten aktualisiert, die mit dem Cluster ausgeführt werden. Sie müssen diese Schritte nur einmal auf einem der Serverknoten ausführen.

1. Stellen Sie eine Verbindung mit einem beliebigen Serverknoten her.
2. Führen Sie sudo su - aus, um zum Stammverzeichnis zu werden.
3. Führen Sie den folgenden Befehl aus:

   # replace {version} with the version you are upgrading to
   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./install-uipath.sh --upgrade -f -s -i ./cluster_config.json --accept-license-agreement -o ./output.json

   Wichtig:

   Sobald das Upgrade abgeschlossen ist, wird der Wartungsmodus automatisch deaktiviert.

   Nach dem manuellen Upgrade von Automation Suite 2021.10 müssen Sie auch zu Cilium CNI migrieren. Anweisungen finden Sie unter Migrieren von Canal zu Cilium CNI.

Nach dem Upgrade können Sie die folgenden zusätzlichen Schritte ausführen:

• Um zu überprüfen, ob die Automation Suite fehlerfrei ist, führen Sie Folgendes aus:

  kubectl get applications -n argocd

• Wenn Sie nach einem Upgrade Probleme mit Sicherheitslücken in den Bildern oder dem Speicherverbrauch haben, dann löschen Sie die Bilder des alten Installationsprogramms. Weitere Informationen finden Sie im Abschnitt Fehlerbehebung.

Aktivieren der Sicherung nach dem Upgrade

Sie müssen die Sicherung fortsetzen, nachdem Sie ein Upgrade und die Bereinigungs- und Migrationsvorgänge durchgeführt haben.

Wichtig:

Stellen Sie sicher, dass die Automation Suite betriebsbereit ist und Ihre Automatisierung erwartungsgemäß fortgesetzt wird, bevor Sie mit den folgenden Schritten fortfahren.

Um die Sicherung zu aktivieren, befolgen Sie die Anweisungen in der Dokumentation zum Sichern und Wiederherstellen des Clusters.

Durchführen eines Upgrades mit einer Bereitstellungsvorlage

Nach dem Durchführen eines Automation Suite Cluster-Upgrades erfordern Azure- und AWS-Vorlagenbereitstellungen einige Änderungen, um sicherzustellen, dass ein neuer Knoten durch Scale-out-Vorgänge korrekt dem Cluster beitritt. Um die Änderungen zu automatisieren, empfehlen wir die Verwendung der dedizierten Skripte. Für Anweisungen siehe die Azure-Bereitstellungsvorlagen-Dokumentation und die Azure-Bereitstellungsvorlagen-Dokumentation.

Besondere Überlegungen

Bei der Durchführung eines Upgrades für einen Cluster, der mit Azure-Vorlagen bereitgestellt wurde, kann ein Fehler auftreten, der ähnlich wie in der folgenden Abbildung dargestellt ist:

Dies liegt an der Funktionsweise des Azure-Lastenausgleichs. Um das Problem zu beheben, ändern Sie das Feld fixed_rke_address in der Datei cluster_config.json. Sie müssen den Wert dieses Felds in die IP-Adresse der ersten Serverinstanz ändern, bevor Sie den Upgrade-Befehl ausführen. Die in den Schlüsseltresor hochgeladene cluster_config.json sollte weiterhin die IP-Adresse des ILB haben, da der Knoten nicht fehlerfrei ist und der Datenverkehr nicht darauf verteilt wird.