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 Skripts uipathctl.sh 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-Pakets, der unter /uipath angefügt 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

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

4. sf-installer.zip entpacken:

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

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

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

7. Erteilen Sie dem Installationsprogramm die erforderlichen Berechtigungen:

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

8. Generieren Sie die neueste cluster_config.json -Datei auf dem Ansible-Hostknoten.

📘

Hinweis:

Ausführliche Informationen zum Konfigurieren der cluster_config.json -Parameter finden Sie unter Erweiterte Installationsumgebung .

• 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 die sql_connection_string_template_sqlalchemy_pyodbc aktualisieren. Nachfolgend finden Sie ein Beispiel.

"sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://testadmin@sfmfup20211043125452-8926d153-sql.database.windows.net:sgTQrg%40R%40dvoYddYBoKn045ncoC9WhWU@sfmfup20211043125452-8926d153-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

See also Manual: Advanced installation experience.

Execution

🚧

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 .

Feuchtigkeitsspendend docker-registry

Um die erforderliche Ausfallzeit zu minimieren, hydratisieren Sie docker-registry vor dem Upgrade mit Container-Images für die neue Produktversion, indem Sie den folgenden Schritt ausführen:

1. 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, von der Sie ein Upgrade planen. Wenn Sie beispielsweise ein Upgrade von der Automation Suite 2021.10 planen, Befolgen Sie die Anweisungen im Leitfaden 2021.10 .

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 eine Sicherung Ihres SQL-Servers, nachdem Sie den Wartungsmodus aktiviert haben, 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 cluster_config.json aktualisiert haben, wie in den Vorbereitungsschritten beschrieben.

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

❗️

Warnung!

Wenn Sie die folgende Fehlermeldung 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

Grundlegende Parameter

Erweiterte Parameter

📘

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.

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

kubectl get applications -n argocd

Aktivieren der Sicherung nach dem Upgrade

📘

Hinweis:

Stellen Sie sicher, dass die Automation Suite ausgeführt wird 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