Abonnieren

UiPath Automation Suite

Die Anleitung für die UiPath Automation Suite

Manuell: Offline-Upgrade

Auf dieser Seite wird erläutert, wie Sie die Automation Suite in einer Offlineumgebung manuell aktualisieren.

Vorbereitung

🚧

Wichtig!

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.

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

  2. Root-Benutzer werden:

sudo su -
  1. Erstellen Sie einen Installationsordner im Verzeichnis /opt/UiPathAutomationSuite :
# Please replace {version} with installer version
mkdir -p /opt/UiPathAutomationSuite/{version}/installer
  1. 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
  1. Laden Sie sf-infra.tar.gz herunter und kopieren Sie es nach /opt/UiPathAutomationSuite/{version} . Anweisungen zum Herunterladen finden Sie unter sf-infra.tar.gz : 
cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/{version}
  1. (Nur auf dem primären Serverknoten ). 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}
  1. sf-installer.zip entpacken:
cd /opt/UiPathAutomationSuite/{version}/installer
unzip sf-installer.zip -d .
  1. Erteilen Sie dem Installationsprogramm die erforderlichen Berechtigungen:
chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer
  1. Generieren Sie die neueste cluster_config.json auf dem ersten Serverknoten und kopieren Sie sie auf die restlichen Knoten. 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, 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
  • If you are upgrading from a previous version of AI CenterTM standalone, and your 2022.10 version of AI Center needs to be connected to an external Orchestrator, copy the Orchestrator certificate to the virtual machine. After you copy the certificate, the following configuration details are needed in cluster_config.json:
"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
  }

Note: If AI Center requires an external Orchestrator, add sql_connection_string_template and sql_connection_string_template_odbc in the cluster_config.json file.

  • 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 für docker-registry und containerd

Um die erforderliche Ausfallzeit zu minimieren, hydrieren Sie docker-registry und containerd mit Container-Images für die neue Produktversion vor dem Upgrade, indem Sie die folgenden Schritte 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
  1. Um containerd zu hydratisieren, führen Sie den folgenden Befehl auf allen Knoten aus:
cd /opt/UiPathAutomationSuite/{version}/installer

./configureUiPathAS.sh containerd --offline-bundle ../sf-infra.tar.gz --offline-tmp-folder ../../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. 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, indem Sie Folgendes ausführen:

/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
  1. 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 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 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
  1. Führen Sie den folgenden Befehl aus, um das Upgrade zu starten:

🚧

Wichtig!

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

./install-uipath.sh --upgrade -k -i ./cluster_config.json -o ./output.json --offline-bundle ../sf-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement

❗️

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

 

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
./install-uipath.sh --upgrade -f -s -i ./cluster_config.json -o ./output.json --install-type offline --accept-license-agreement

🚧

Wichtig!

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

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

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

🚧

Wichtig!

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

Aktualisiert vor 4 Monaten

Manuell: Offline-Upgrade

Auf dieser Seite wird erläutert, wie Sie die Automation Suite in einer Offlineumgebung manuell aktualisieren.

Auf API-Referenzseiten sind Änderungsvorschläge beschränkt

Sie können nur Änderungen an dem Textkörperinhalt von Markdown, aber nicht an der API-Spezifikation vorschlagen.