UiPath Documentation
automation-suite
2022.4
false
Automation Suite-Installationsanleitung
Wichtig :
Bitte beachten Sie, dass dieser Inhalt teilweise mithilfe von maschineller Übersetzung lokalisiert wurde. Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

Automatisiert: Online-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:

Before upgrading, make sure you have prepared your environment for using the uipathctl.sh script. For details, see Using 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. Log into the server node that you previously identified as the Ansible host node via SSH.

  2. Werden Sie Root-Benutzer.

    sudo su -
    sudo su -
    
  3. Erstellen Sie einen Installationsordner im Verzeichnis /opt/UiPathAutomationSuite .

    # Please replace {version} with installer version
    mkdir -p /opt/UiPathAutomationSuite/{version}/installer
    # Please replace {version} with installer version
    mkdir -p /opt/UiPathAutomationSuite/{version}/installer
    
  4. Download sf-installer.zip and copy it to /opt/UiPathAutomationSuite/{version}/installer. For download instructions, see sf-installer.zip.

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

    cd /opt/UiPathAutomationSuite/{version}/installer
    unzip sf-installer.zip -d .
    cd /opt/UiPathAutomationSuite/{version}/installer
    unzip sf-installer.zip -d .
    
  6. Erteilen Sie dem Installationsprogramm die erforderlichen Berechtigungen.

    chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer .
    chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer .
    
  7. Generieren Sie die neueste cluster_config.json -Datei auf dem Ansible-Hostknoten.

    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
      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
      cd /opt/UiPathAutomationSuite/{version}/installer
      
      ./configureUiPathAS.sh config get -o ./cluster_config.json
      

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.

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. Log into the server node that you previously identified as the Ansible host node via SSH.

  3. Stellen Sie sicher, dass alle gewünschten Volumes über Sicherungen im Cluster verfügen:

    /path/to/old-installer/configureUiPathAS.sh verify-volumes-backup
    /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
    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
    ./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.

    ./uipathctl.sh upgrade --cluster-config ./cluster_config.json --install-type online --steps all --accept-license-agreement
    ./uipathctl.sh upgrade --cluster-config ./cluster_config.json --install-type online --steps all --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:

    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

Grundparameter

Parameter Wert

--install-type

Mögliche Werte: online und offline .

Da diese Seite Anweisungen für eine Onlineumgebung enthält, wählen Sie den Wert online aus.

--steps

Mögliche Werte sind: all , infra , fabric und services . Bezeichnet jede Phase des Installations- und Upgradeprozesses.

  • all – Eine übergeordnete Gruppe aller anderen Schritte, die die gesamte Automation Suite aktualisiert.
  • infra – Aktualisiert Kubernetes und andere Infrastrukturkomponenten in der Automation Suite auf allen Knoten.
  • 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.

--cluster-config

cluster_config.json -Datei, die die Parameter, Einstellungen und Einstellungen definiert, die auf die UiPath-Dienste angewendet werden, die über die Automation Suite bereitgestellt werden.

Erweiterte Parameter

ParameterWert
--ansible-usernameGeben 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.
--inventoryGeben 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.

For details, see Generating the Ansible inventory.ini file.
Hinweis:

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
    kubectl get applications -n argocd
    
  • 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​

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
# replace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer

./configureUiPathAS.sh resume-scheduled-backups

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support(opens in new window)

Möchten Sie lernen? UiPath Academy(opens in new window)

Haben Sie Fragen? UiPath-Forum(opens in new window)

Auf dem neuesten Stand bleiben