Automatisiert: Offline-Upgrade

Ansible wird verwendet, um das Upgrade des gesamten Automation Suite-Clusters zu automatisieren, indem einige Vorgänge auf einer Maschine im Cluster ausgeführt werden.

In der folgenden Abbildung verwendet der Server 1 -Knoten (oder Ansible-Hostknoten) Ansible, um das Upgrade des gesamten Automation Suite-Clusters zu orchestrieren.

Vorbereitung

Wichtig:

Stellen Sie vor dem Upgrade sicher, dass Sie Ihre Umgebung für die Verwendung des uipathctl.sh -Skripts vorbereitet haben. Weitere Informationen finden Sie unter Verwenden von uipathctl.sh.

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 über SSH bei dem Serverknoten an, den Sie zuvor als Ansible-Hostknoten identifiziert haben. Stellen Sie sicher, dass Sie den primären Serverknoten mit dem zusätzlichen Datenträger des UiPath Bundles, der unter /uipath angehängt ist, als Ihren Ansible-Hostknoten ausgewählt haben.
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. Laden Sie sf-infra.tar.gz herunter und kopieren Sie es nach /uipath/{version}. Anweisungen zum Herunterladen finden Sie unter sf-infra.tar.gz.

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

7. Laden Sie sf.tar.gz herunter und kopieren Sie es nach /uipath/{version}. Anweisungen zum Herunterladen finden Sie unter sf.tar.gz.

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

8. Erteilen Sie dem Installationsprogramm die erforderlichen Berechtigungen:

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

9. Generieren Sie die neueste cluster_config.json -Datei auf dem Ansible-Hostknoten.
   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 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.

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.

Hydratisieren von Docker-Registry

Um die erforderliche Ausfallzeit zu minimieren, hydratisieren Sie docker-registry vor dem Upgrade mit Container-Images für die neuen Produktversionen.

Wichtig:

• Stellen Sie sicher, dass Sie Container- und/oder andere Infra-Images nicht mehr als 10 Stunden vor dem Upgrade hydratisieren.

• Wenn Sie Document Understanding und Computer Vision aktualisieren, müssen Sie die Basis-Images herunterladen, die der aktualisierten Automation Suite-Version entsprechen (verwenden Sie das Basis-Image, das Ihrer ML-Paketversion entspricht) und sie vor dem Upgrade in Ihre Docker-Registrierung übertragen, um Unterbrechungen laufender DU-Fähigkeiten zu vermeiden. Informationen zum Herunterladen der Installationspakete für Document Understanding und Computer Vision finden Sie unter Herunterladen der Installationspakete.

Um docker-registry zu hydratisieren, führen Sie den folgenden Befehl auf dem ersten Serverknoten aus:

cd /opt/UiPathAutomationSuite/{version}/installer

./configureUiPathAS.sh registry upload --offline-bundle /uipath/{version}/sf.tar.gz --offline-tmp-folder /uipath/tmp

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 2021.10 planen, befolgen Sie die Anweisungen im 2021.10-Handbuch.
2. Melden Sie sich über SSH bei dem Serverknoten an, den Sie zuvor als Ansible-Hostknoten identifiziert haben.
3. Stellen Sie sicher, dass alle gewünschten Volumes über Sicherungen im Cluster verfügen:

   /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 des Clusters

Führen Sie die folgenden Schritte aus, um den Automation Suite-Cluster zu aktualisieren:

1. Stellen Sie über SSH eine Verbindung mit dem Ansible-Hostknoten her und werden Sie Root-Benutzer.
2. Um die Upgrade-Schritte auf allen Knoten auszuführen, führen Sie den folgenden Befehl mit den grundlegenden Parametern aus. Eine detailliertere Steuerung finden Sie im Abschnitt Parameter.
   Hinweis: Stellen Sie sicher, dass Sie die Datei cluster_config.json aktualisiert haben, die wie in den Vorbereitungsschritten beschrieben generiert wurde.

   # Please replace {version} with installer version, in all the below commands
   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./uipathctl.sh upgrade --cluster-config ./cluster_config.json --install-type offline --steps all --offline-infra-bundle /uipath/{version}/sf-infra.tar.gz --accept-license-agreement

   Wichtig:

   Der Upgrade-Prozess erfordert die Migration von Canal CNI zu Cilium CNI. Das automatisierte Upgrade führt diesen Schritt automatisch aus und startet dann alle Knoten im Cluster neu, um die Migration abzuschließen.

   Warten Sie nach dem Neustart der Knoten einige Minuten, um sicherzustellen, dass alle Dienste wieder online sind. Sie können sich bei ArgoCD anmelden, um den Status aller Anwendungen zu überwachen.

   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

Grundparameter

Parameter	Wert
--install-type	Mögliche Werte: online und offline . Da diese Seite Anweisungen für eine Offlineumgebung enthält, wählen Sie den Wert offline aus.
--steps	Mögliche Werte sind: all , infra , fabric und services . Bezeichnet jede Phase des Installations- und Upgradeprozesses. all – Empfohlen: Eine Obermenge aller anderen Schritte, die die gesamte Automation Suite aktualisiert. infra – Aktualisiert Kubernetes und andere Infrastrukturkomponenten in der Automation Suite auf allen Knoten. bundles – Lädt die im Automation Suite-Cluster gehostete Docker-Registrierung hoch und hydratisiert sie mit den Fabric- und Dienst-Container-Images. Wichtig: Sie müssen die Docker-Registrierung hochladen und gleichzeitig mit dem Upgrade von Kubernetes und den Infrastrukturkomponenten aktualisieren. Um die beiden Schritte gleichzeitig auszuführen, führen Sie --steps bundles infraaus. Nicht alleine ausführen: --steps bundles , da dies den Cluster beschädigt. fabric – Aktualisiert alle Fabric- und freigegebenen Komponenten der Automation Suite. services – Aktualisiert alle UiPath-Produktdienste, die in der Automation Suite installiert sind. Wenn während des Upgrades ein Fehler auftritt, können Sie diese Prüfpunkte verwenden, um den Upgradevorgang fortzusetzen, anstatt es von Anfang an zu wiederholen.
--offline-bundle	Pfad zum sf.tar.gz -Offlinepaket, das die Container-Images des Fabric und der Dienste enthält. Es wird empfohlen, sie unter /uipath/{version}/sf.tar.gzzu speichern.
--offline-infra-bundle	Pfad zum Offlinepaket sf-infra.tar.gz , das Kubernetes- und Infrastrukturpakete enthält.
--cluster-config	cluster_config.json -Datei definiert die Parameter, Einstellungen und Präferenzen, die auf die über die Automation Suite bereitgestellten UiPath-Dienste angewendet werden.

Erweiterte Parameter

Parameter	Wert
--ansible-username	Geben Sie den Benutzernamen an, der für SSH-Verbindungen zu allen Knoten verwendet werden soll. Standardmäßig ist der aktuelle Benutzer. Wenn Sie für alle Knoten einen anderen Benutzernamen verwenden, legen Sie anstelle dieses Parameters den Benutzernamen für alle Knoten in inventory.ini fest und übergeben Sie ihn an das Skript. Beispiel: Während Sie das Skript ausführen, sind Sie mit dem myadminuser -Benutzernamen angemeldet. Wenn Sie jedoch den Benutzernamen testadmin für die Verbindung über SSH verwenden möchten, müssen Sie testadmin für diesen Parameter angeben.
--inventory	Geben Sie eine vorhandene Ansible-Inventardatei an. Wenn nicht angegeben, wird automatisch einer aus dem vorhandenen Cluster mit der Basiskonfiguration generiert. In bestimmten Szenarien, in denen Sie eine detailliertere Kontrolle haben möchten, möchten Sie möglicherweise Ihre eigene Inventardatei bereitstellen. Ein solches Beispiel wäre, wenn Sie einen anderen SSH-Benutzernamen oder SSH-Schlüssel für alle Knoten im Cluster verwenden möchten. Weitere Informationen finden Sie unter Generieren der Ansible evaluation.ini-Datei.

Hinweis:

Wenn das Upgrade aus irgendeinem Grund fehlgeschlagen ist, der Upload in die Docker-Registrierung jedoch erfolgreich ist, ist kein erneuter Upload erforderlich. Sie können das Upgrade fortsetzen, indem Sie die Fabric- oder Dienstinstallation direkt ausführen: ./uipathctl.sh upgrade --install-type offline --steps {fabric | services} .

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

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

Hinweis: Stellen Sie sicher, dass die Automation Suite betriebsbereit ist und Ihre Automatisierung erwartungsgemäß 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.

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