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 über 10 GB freien Speicherplatz im Ordner /opt/UiPathAutomationSuite auf allen Knoten verfügen. 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. Bei einem Auswertungsprofil mit einem einzelnen Knoten, bei dem Sie nur über einen Serverknoten verfügen, melden Sie sich 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. Download as-installer.zip and copy it to /opt/UiPathAutomationSuite/{version}/installer. For download instructions, see sf-installer.zip.

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

5. as-installer.zip entpacken:

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

   For details on how to configure the cluster_config.json parameters, see Advanced installation experience.

   • 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
     

   • If you upgrade from Automation Suite 2022.10 to Automation Suite 2023.4 or later, and Orchestrator is enabled on both the old and new versions, you must set the orchestrator.block_classic_executions flag to true in the cluster_config.json file. Using the flag shows that you agree with blocking classic folders executions. Not using the flag causes the upgrade operation to fail. For a configuration example, see Orchestrator-specific configuration.

   • If you are using AI Center^TM connected to an external Orchestrator, make sure that you have the Orchestrator certificate in the cluster_config.json file. If you upgrade from a version older than 2022.10, 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
       }
     

     Hinweis:

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

     After upgrading to AI Center 2023.4 and moving to external storage, making a skill created in 2022.4 public will fail. To fix this, run the script from here.

   • If you upgrade Automation Suite from a previous version and now enable Process Mining as well, you must update the sql_connection_string_template_sqlalchemy_pyodbc. Below is an example.

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

   • If you upgrade Automation Suite from a version previous to 2023.4 and you have Apps enabled, you must create the SQL database for Apps, and then update the cluster_config.json file with the following configuration:

     "apps": {
     "enabled": "true" // This will already be true in existing cluster_config.json if apps is enabled
     "sql_connection_str": "" // Provide ODBC database connection string if apps is enabled
     }
     

     Hinweis:

     Verwenden Sie die aktualisierte Datei cluster_config.json in den nächsten Upgrade-Schritten.

   See also Manual: Advanced installation experience.

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:

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 Automation Suite version from which you plan to upgrade. For instance, if you plan to upgrade from Automation Suite 2021.10, follow the instructions in the 2021.10 guide.

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 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 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 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 --accept-license-agreement
   

   Wichtig:

   If you get the following error, follow the instructions in Downgrading Ceph from 16.2.6 to 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

Wichtig:

If you previously deployed your single-node installation using any Azure template version prior to 2022.10.3, and you now want to upgrade to a newer Automation Suite version, you must set the zone_resilience flag to false in the cluster_config.json file in /opt/UiPathAutomationSuite/Installer.

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.

   After manually upgrading from Automation Suite 2021.10, you must also migrate to Cilium CNI. For instructions, see Migrating from Canal to 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
  

• Überprüfen Sie beim Aktualisieren von einer Automation Suite-Version vor 2023.4.0, ob Apps ausgeführt wird, und entfernen Sie dann MongoDB:

  ./configureUiPathAS.sh mongodb uninstall --force
  

• Wenn beim Entfernen von MongoDB mit dem Befehl ./configureUiPathAS.sh mongodb uninstall --force ein Fehler auftritt, führen Sie bitte den folgenden Befehl aus:

  kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": false }}}}'
  
  ./configureUiPathAS.sh mongodb uninstall --force
  
  kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": true }}}}'
  

• If you experience issues with image vulnerabilities or storage consumption after performing an upgrade, delete the images from the old installer. For details, see the Troubleshooting section.

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.

To enable the backup, follow the instructions in described in the Backing up and restoring the cluster documentation.

Durchführen eines Upgrades mit einer Bereitstellungsvorlage

After performing an Automation Suite cluster upgrade, Azure and AWS template deployments require some changes to ensure a new node joins the cluster correctly through scale-out operations. To automate the changes, we recommend using the dedicated scripts. For instructions, see the Azure deployment template docs and the AWS deployment template docs.

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.