Offline-Upgrade

Vorbereitung

Warnung:

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. Identifizieren Sie den Server-Knoten (nicht den Agent-Knoten), der über eine zusätzliche UiPath bundle -Festplatte verfügt, die am /uipath angefügt ist. Dieser Knoten wird im gesamten Dokument als primärer Serverknoten bezeichnet. Bei einem Auswertungsprofil mit einem einzelnen Knoten, bei dem Sie nur über einen Serverknoten verfügen, müssen Sie sich bei diesem Knoten anmelden.

   Hinweis:

   Führen Sie die folgenden Schritte auf allen Knoten im Cluster aus. Beginnen Sie mit den Serverknoten und fahren Sie mit den Agent-Knoten fort.

2. Stellen Sie mithilfe von SSH eine Verbindung mit einem Knoten her.

3. Root-Benutzer werden:

   sudo su -
   

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

   <h1>Please replace {version} with installer version
   mkdir -p /opt/UiPathAutomationSuite/{version}/installer</h1>
   

5. Laden Sie sf-installer.zip herunter und kopieren Sie es nach /opt/UiPathAutomationSuite/{version}/installer.

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

6. Laden Sie sf-infra.tar.gz herunter und kopieren Sie es nach /opt/UiPathAutomationSuite/{version}.

   cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/{version}
   

7. (Only on the primary server node). Download sf.tar.gz and copy it to /uipath/{version}.

   cp /path/to/sf.tar.gz /uipath/{version}
   

8. sf-installer.zip entpacken:

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

9. Erteilen Sie dem Installationsprogramm die erforderlichen Berechtigungen:

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

10. Generieren Sie die neueste cluster_config.json auf dem ersten Serverknoten und kopieren Sie sie auf die restlichen Knoten.

• Wenn Sie das alte cluster_config.json haben, generieren Sie die Konfigurationsdatei aus dem Cluster, indem Sie Folgendes ausführen:

  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, die Sie möglicherweise zum Zeitpunkt der Installation der vorherigen Version vorgenommen haben:

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

Adding AI Center specific configuration

1. Öffnen Sie cluster_config.json mit Ihrem Editor (z. B. vi).

   vi /opt/UiPathAutomationSuite/{version}/installer/cluster_config.json
   

2. Ersetzen Sie den folgenden Block:

   "aicenter": {
     "enabled": "false"
   },
   

   Hinweis:

   Document Understanding is enabled by default if AI Center is enabled.

3. Mit den folgenden Informationen (ersetzen Sie die Informationen zwischen <> durch Ihre Werte):

   "aicenter": {
     "orchestrator_url":"<a href="https://orchestrator-url.com">https://orchestrator-url.com</a>",
     "identity_server_url": "<a href="https://orchestrator-url.com/identity">https://orchestrator-url.com/identity</a>",
     "orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
     "identity_cert_file_path":  "</opt/UiPathAutomationSuite/orch.cer or custom path>",
     "identity_access_token": "<placeholder will be replaced later>",
   },
   

Ausführung

Warnung:

If any errors or issues occur during or following the upgrade, you can rollback to the previous version, provided that you previously configured a backup. For instructions, see Rollback on error.

Konfigurieren der Sicherung

Führen Sie die folgenden Schritte aus, um die Sicherung zu konfigurieren:

1. Make sure you have enabled the backup on the cluster. You must create the backup using the same version of the installer as the one you used for the current deployment. For instructions, see the backup and restore documentation corresponding to the UiPath AI Center version from which you plan to upgrade.

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 AI Center-Cluster blockiert wird.

Warnung:

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
   

   Warnung:

   Erstellen Sie eine Sicherung Ihres SQL-Servers, nachdem Sie den Wartungsmodus aktiviert haben, damit keine weiteren Transaktionen in Ihrer SQL-Datenbank aufgezeichnet werden.

Aktualisieren von Kubernetes und anderen Infrastrukturkomponenten

Warnung:

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 Serverknoten:

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

   • Für 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:

   Warnung:

   Stellen Sie sicher, dass Sie cluster_config.json aktualisiert haben, wie in den Vorbereitungsschritten beschrieben.

   replace {version} with the version you are upgrading to
   cd /opt/UiPathAutomationSuite/{version}/installer
   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -i /path/to/cluster_config.json --offline-bundle "/path/to/sf-infra.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json
   

   Wichtig:

   If you get an error, follow the instructions in Downgrading Ceph from 16.2.6 to 15.2.9.

Aktualisieren freigegebener Komponenten und UiPath-Produktdienste

In diesem Schritt werden die Fabric- und Dienstkomponenten aktualisiert, die mit dem Cluster ausgeführt werden. Sie müssen diese Schritte nur auf dem primären 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 in both the commands
   cd /opt/UiPathAutomationSuite/{version}/installer
   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -f -i /path/to/cluster_config.json --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json
   

4. Führen Sie das Software-Installationsprogramm mit dem folgenden Befehl aus.

   Zuerst müssen Sie eine Verbindung mit dem Identitätsserver herstellen und ein Installationstoken abrufen. Kopieren Sie dann dieses Token und fügen Sie es in den Platzhalter aus der Datei „cluster_config.json“ ein.

   Sobald das Token vorhanden ist, können Sie die AI Center-Installation ausführen.

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -s -i /path/to/cluster_config.json --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json
   

   Warnung:

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

Aktivieren der Sicherung nach dem Upgrade

Warnung:

Stellen Sie sicher, dass das AI Center betriebsbereit ist und Ihre Automatisierung wie erwartet fortgesetzt wird, bevor Sie mit den nächsten Schritten fortfahren.

Bevor mit dem Upgrade des Clusters begonnen wird, erstellt das Upgrade-Skript automatisch eine Sicherung des Clusters und deaktiviert sie dann vorübergehend. Möglicherweise möchten Sie die Sicherung manuell aktivieren, sobald das Upgrade abgeschlossen ist.

Führen Sie den folgenden Befehl auf einem beliebigen Serverknoten aus, um die Sicherung zu aktivieren:

replace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh resume-scheduled-backups