Abonnieren

UiPath Automation Suite

Die Anleitung für die UiPath Automation Suite

HA-fähige Offline-Produktionsinstallation mit mehreren Knoten

This page provides instructions on how to install Automation Suite on multiple machines, in an offline environment with no access to the Internet.

Überblick


🚧

Wichtig!

Sie müssen die Hardware- und Softwarevoraussetzungen erfüllen, bevor Sie mit der Installation fortfahren können.
Hard- und Softwareanforderungen

Sie können ein dediziertes Skript verwenden, um die Installationsvoraussetzungen und die Bereitschaft der Infrastruktur zu überprüfen.
Validierung der Voraussetzungen

Für eine reibungslose Installation halten Sie sich an unsere empfohlenen Vorgehensweisen.
Empfehlungen für die Installation

Der Installationsvorgang umfasst die folgenden grundlegenden Schritte:

StepDescription
Step 1: Download the installation packages You must perform this step from a Linux or Windows machine with access to the internet and to the offline machines where you plan to deploy Automation Suite. While the installation packages finish downloading, you can continue to some of the next steps.

Step 1.1: Downloading the installation package
Step 1.2: Getting all downloaded files on the first machine
Step 2: Configure the installation Run the interactive installer to configure the installation options.
The tool gathers inputs for most common installation options and generates a configuration file that you can use during installation.

(Optional) Configure advanced installation options.
The interactive installer offers a default experience with a limited number of configuration options. To customize the installed products, set up separate SQL servers for specific products, and more, edit the configuration file.

Step 2.1: Default configuration
Step 2.2: (Optional) Advanced configuration
Step 3: Copy the installation files on all the machines On the first machine, copy the downloaded files in the installation folder created by the interactive installer at step 2.
On the other cluster machines, copy the entire installation folder from the first machine to the same folder path on each machine.

Step 3: Copy the installation files on all the machines
Step 4: Run the installation Create the cluster and join all machines

Install the rest of the suite from the first machine.

Step 4: Running the installation
Step 5: Complete the installation Step 5: You have completed the installation successfully and can move to post-installation steps.
You can now access the newly created cluster and suite, update certificates, resize the PVC, and more.

Step 5: Completing the installation

 

Schritte auf blauem Hintergrund werden auf der Maschine mit Internetzugang ausgeführt.
Schritte auf grünem Hintergrund werden auf den Maschinen ausgeführt, auf denen die Installations-Suite bereitgestellt wird.

 

Schritt 1: Herunterladen des Installationspakets und Übertragen aller Dateien auf die erste Maschine


Schritt 1.1: Herunterladen des Installationspakets

You must perform this step on a machine with access to the internet and to the machines in the offline environment where you plan to install Automation Suite.

This machine can be Linux or Windows. The commands in this guide are for a RHEL-based OS. For Windows or other OSes, adjust for equivalent commands specific to those environments.

🚧

Wichtig!

You must install the required RPM packages before launching the Automation Suite installer.
For details, see RPM package requirements.

 

AUF DER SEPARATEN MASCHINE MIT INTERNETZUGANG

To get the installation packages required to start the installation process, take the following steps:

  1. Connect to a machine with internet access:
    ssh <user>@<dns_of_vm>

  2. Wenn Sie einen SSH-Schlüssel verwendet haben, führen Sie den folgenden Befehl aus:
    ssh -i <path/to/Key.pem> <user>@<dns_of_vm>

  3. Laden Sie die folgenden Pakete herunter:
    • installUiPathAS.shObligatorisch. Anweisungen zum Herunterladen finden Sie unter installUiPathAS.sh.
    • sf-installer.zipObligatorisch. Anweisungen zum Herunterladen finden Sie unter sf-installer.zip.
    • sf.tar.gzObligatorisch. Anweisungen zum Herunterladen finden Sie unter sf.tar.gz.
    • sf-infra.tar.gzObligatorisch. Anweisungen zum Herunterladen finden Sie unter sf-infra.tar.gz.
    • du-ondemand.tar.gzOptional. Nur für Document Understanding erforderlich. Anweisungen zum Herunterladen finden Sie unter du-ondemand.tar.gz.
      Hinweis: Wenn Sie diesen optionalen Schritt überspringen, ist die Funktionalität der Document Understanding-Dienste begrenzt.
    • cv-ondemand.tar.gzOptional. Nur für Computer Vision erforderlich. Anweisungen zum Herunterladen finden Sie unter cv-ondemand.tar.gz.
      Hinweis: Wenn Sie diesen optionalen Schritt überspringen, ist kein Zugriff auf die Computer Vision-Dienste möglich.

    Make sure to download the packages suitable for your Automation Suite version and your operating system.

 

Schritt 1.2: Übertragen aller heruntergeladenen Dateien auf die erste Maschine

  • Check that all files downloaded on the machine with internet access;
  • Erstellen Sie den Zielordner auf der ersten Maschine;
  • Copy the files from the online machine to the first target machine.
AUF ALLEN MASCHINEN IM CLUSTER
&nbsp

Erstellen Sie die Installationsordner, indem Sie den folgenden Befehl ausführen:

sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 777 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp
Hinweis : Das Ausführen von mkdir -p /opt/UiPathAutomationSuite/ ist nicht erforderlich, wenn Sie das Skript configureUiPathDisks.sh verwenden.
AUF DER SEPARATEN MASCHINE MIT INTERNETZUGANG
&nbsp

Kopieren Sie die Dateien in den ersten Knoten, indem Sie die folgenden Schritte ausführen:

  1. From the machine with internet access, copy the files to the installation folder on the target machine, and the offline bundle(s) to the /uipath/tmp folder:
  2. scp ~/installUiPathAS.sh ~/sf-installer.zip ~/sf-infra.tar.gz <username>@<node dns>:/uipath/tmp
    scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/
  3. (Optional) Um Document Understanding zu verwenden, kopieren Sie das folgende Paket in den Ordner /uipath/tmp :
  4. scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/
    Hinweis: Wenn Sie diesen optionalen Schritt überspringen, ist kein Zugriff auf die Document Understanding-Dienste möglich.
    &nbsp
  5. (Optional) To use Computer Vision, copy the following bundle to the /uipath/tmp folder:
  6. scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/
    Hinweis: Wenn Sie diesen optionalen Schritt überspringen, ist kein Zugriff auf die Computer Vision-Dienste möglich.

 

Schritt 2: Konfigurieren der Installation


Step 2.1: Default configuration

AUF DER HAUPTMASCHINE DES CLUSTERS
&nbsp
  1. Fügen Sie den Voraussetzungsordner zum aktuellen PATH hinzu.
    The interactive installer requires jq, which the Automation Suite offline bundles already includes. To add jq to PATH, make sure you are still root and run the following command:
  2. mv /uipath/tmp/installUiPathAS.sh /uipath/tmp/sf-installer.zip /uipath/tmp/sf-infra.tar.gz  /opt/UiPathAutomationSuite
    cd /opt/UiPathAutomationSuite
    unzip ./sf-installer.zip -d .
    chmod +x ./bin/jq
    export PATH=${PATH}:/opt/UiPathAutomationSuite/bin

  3. Provide permissions to the interactive installer folder.
    Es ist erforderlich, dem Ordner /opt/UiPathAutomationSuite, in dem die Installationsskripte gespeichert sind und ausgeführt werden, entsprechende Berechtigungen zu erteilen.
    The interactive installer also creates some files (output.json) after the execution of each stage.
    Führen Sie den folgenden Befehl aus, um die erforderlichen Berechtigungen zu erteilen:
  4. chmod -R 755 /opt/UiPathAutomationSuite

  5. Führen Sie das interaktive Installationsprogramm aus, um die Installationsoptionen zu konfigurieren.
    The interactive installer guides you through the configuration steps and generates the configuation file that you can then customize and use through the remaining installation steps.

  6. Führen Sie das folgende Skript aus, um das interaktive Installationsprogramm zu starten:
    chmod +x ./installUiPathAS.sh
    export BUNDLE_FILE="/opt/UiPathAutomationSuite/sf-installer.zip"
    ./installUiPathAS.sh


Ausführen des interaktiven Installationsprogramms


Run the interactive installer to configure the installation options. The tool gathers inputs for most common installation options and generates a configuration file. Note that HAA is not supported in single-node evaluation mode.

Führen Sie die folgenden Schritte aus, um die Automation Suite zu installieren:

  1. Start the interactive installer.

  2. Akzeptieren Sie die Lizenzvereinbarung, um die Installation fortzusetzen.

  3. Wählen Sie im Hauptmenü Ihren Bereitstellungsmodus aus. Wählen Sie Bereitstellung mit mehreren Knoten (empfohlen für die Produktionsverwendung) aus, und bestätigen Sie Ihre Auswahl.

  4. &nbsp
  5. In Deployment configuration select your environment type. Choose Air-gapped.

  6. Wählen Sie Ihre Produktauswahl aus. Ihre Optionen sind:
    • Complete (All products)
    • Produkte auswählen

  7. Wenn Sie im vorherigen Schritt Produkte auswählen ausgewählt haben, geben Sie die Produkte an, die Sie installieren möchten. Ihre Optionen sind:
    • Action Center
    • AI Center
    • Apps
    • Automation Hub
    • Automation Ops
    • Automation Suite-Roboter
    • Data Service
    • Document Understanding
    • Insights
    • Orchestrator
    • Process Mining
    • Task Mining
    • Test Manager

    Some Automation Suite products have additional dependencies on each other. When selecting the products you want to install, make sure you consider Cross-products dependencies. Trying to install a product without its dependencies would result in an error.

    Einige Automation Suite-Produkte erfordern einen dedizierten Agent-Knoten.Bevor Sie fortfahren, stellen Sie sicher, dass Sie die Hardwareanforderungen erfüllen.


  8. To install AI Center, you must follow additional steps:
    1. Specify whether AI Center requires an external Orchestrator.
      1. If AI Center does not require an external Orchestrator, continue to Step 8.
      2. Wenn das AI Center einen externen Orchestrator erfordert, fahren Sie mit Schritt ii fort.
    2. Copy the Orchestrator certificate to the virtual machine. For more information on this, check the Copy the Orchestrator certificate page.
    3. Specify the Orchestrator URL for AI Center. Example: https://orchestrator.example.com.
    4. Specify the Identity URL for AI Center. Example: https://orchestrator.example.com/identity.
    5. Specify the path to the Orchestrator certificate file. Example: /opt/UiPathAutomationSuite/UiPath_Installer/orch.cer.
    6. Specify the path to Identity certificate file. Example: /opt/UiPathAutomationSuite/UiPath_Installer/identity.cer.
    7. In offline installations, you do not need to specify the metering API key. To complete the AI Center installation, follow the step from the Completing AI Center installation section.


  9. Bestätigen Sie Ihre Produktauswahl, um die minimalen Hardware- und Softwareanforderungen zu bestimmen.

  10. Geben Sie den FQDN der Automation Suite ein.

  11. Geben Sie an, ob Sie Ihren eigenen Objektspeicher für die ausgewählten Produkte verwenden möchten. Wenn Sie Nein auswählen, entscheiden Sie sich für den Standardobjektspeicher. Wenn Sie Ja auswählen, wählen Sie eine der folgenden Optionen aus:
    • Azure Storage Account – Indicate if you want to use managed identity-based with your Azure storage account, provide the following details corresponding to your choice, then specify if you want the containers to be automatically provisioned for all the selected products:
      1. Wenn Ja, geben Sie den Namen des Azure-Speicherkontos und das Endpunktsuffix sowie Ihre Client-ID an.
      2. Wenn Nein , geben Sie den Namen des Azure-Speicherkontos und das Endpunktsuffix sowie Ihren Azure-Kontoschlüssel an.
    • AWS S3 – Geben Sie das Präfix und Suffix für die Bucket-Namen, die AWS-Region, in der Buckets gehostet werden, den Zugriffsschlüssel und den geheimen Schlüssel für das S3-Konto an und bestimmen Sie, ob die Buckets automatisch für alle ausgewählten Produkte bereitgestellt werden sollen.
    • Anderer S3-kompatibler Speicher – Geben Sie das Präfix und Suffix für die Bucket-Namen, den FQDN des S3-Servers, den S3-Port, den Zugriffsschlüssel und den geheimen Schlüssel für das S3-Konto an und legen Sie fest, ob die Buckets für alle ausgewählten Produkte automatisch bereitgestellt werden sollen.
    • Many S3 objectstores require the CORS set to all the traffic from the Automation Suite cluster. You must configure the CORS policy at the objectstore level to allow the FQDN of the cluster.


  12. Geben Sie an, ob Sie Kerberos Auth für SQL-Verbindungen verwenden möchten.

  13. Geben Sie die SQL Server-URL ein. Folgen Sie der Eingabeaufforderung, um den Verbindungsport, den Benutzernamen und das Kennwort einzugeben.
  14. Process Mining requires a second SQL Server. If you install Process Mining, make sure to provide the warehouse SQL Server URL, connection prompt, username, and password.
    Ausführliche Informationen zu den Hardwareanforderungen, die der zweite SQL-Server erfüllen muss, finden Sie unter SQL-Anforderungen für Process Mining .


  15. Specify whether you want the interactive installer to automatically create the necessary databases.

  16. Provide CA certificates for any external software that requires a secure TLS communication, otherwise the installation will fail. If you did not enable the TLS communication, you can configure the certificates post-installation.
  17. Das Installationsprogramm akzeptiert nur Base64-codierte DER-Zertifikate im PEM-Format. Wenn die externen Server über verschiedene Zertifizierungsstellen verfügen, können Sie alle öffentlichen Zertifikate in einer einzigen Datei verketten.


  18. Nach dem Definieren der Konfigurationsparameter generiert das interaktive Installationsprogramm automatisch die Konfigurationsdatei. Sie können die Konfigurationsparameter direkt im Terminal bearbeiten.
  19. At this step, you can directly edit the cluster_config.json for advanced configuration settings in the UiPathAutomationSuite folder. After you edit the configuration file, you need to re-run the interactive installer to complete the installation or complete it manually.

Am Ende des Installationsvorgangs wird eine Bereitstellungszusammenfassung angezeigt, die Ihnen Zugriff auf das Clusterverwaltungsportal, das Hostportal, die Organisationsverwaltungsoberfläche, Rancher, ArgoCD und mehr gibt.

 

Schritt 2.2: Erweiterte Konfiguration (optional)

You can find the cluster_config.json file in the UiPathAutomationSuite folder. You can use this file to disable products, configure your SQL databases and their respective connection strings, and update certificates. You can also enable proxy settings if you use a proxy for the internet connection.
Beim HA-fähigen Produktionsmodus mit mehreren Knoten ist die Hochverfügbarkeit standardmäßig aktiviert, kann aber bei Bedarf auch deaktiviert werden.

Informationen zur erweiterten Konfiguration finden Sie unter Erweiterte Installationsumgebung .

 

Schritt 3: Kopieren der Installationsdateien auf alle anderen Cluster-Maschinen


Kopieren Sie den gesamten Installationsordner von der ersten Maschine im Cluster, auf der die Konfiguration durchgeführt wurde, auf alle anderen Maschinen. Dieser Schritt stellt sicher, dass die gleiche Konfiguration und alle heruntergeladenen Installationspakete auf allen Maschinen repliziert werden.

AUF DER ERSTEN MASCHINE IM CLUSTER
&nbsp
  1. Kopieren Sie den Ordner /opt/UiPathAutomationSuite auf alle anderen Knoten, indem Sie den folgenden Befehl ausführen:
  2. scp -r /opt/UiPathAutomationSuite <username>@<node dns>:/opt
    Note: Since you are in an offline environment, you might need to use the private IP of the target node.
    &nbsp

  3. Add -i <cert.pem> if you use a certificate to login. If you copy the .pem contents to a local file, the new file requires the correct permissions. To grant the necessary permissions, run chmod 400 <cert.pem>.

 

Schritt 4: Ausführen der Installation


The multi-node HA-ready production mode requires a minimum of 3 server machines. Installing Task Mining or Automation Suite Robots requires adding an additional machine used as an agent. An additional agent node with GPU support is recommended for Document Understanding.

Weitere Informationen zum Hinzufügen eines spezialisierten Agent-Knotens finden Sie im Folgenden:

📘

Hinweis:

Für eine HA-fähige Produktionsinstallation mit mehreren Knoten benötigen Sie einen Lastausgleich. Stellen Sie sicher, dass einer erstellt wurde und der Datenverkehr zwischen den Knoten verteilt ist. Der Domänenname des Lastausgleichs muss in der Datei cluster_config.json verwendet werden.

Sie benötigen mindestens einen Serverknoten; für HA benötigen Sie mindestens drei Serverknoten. Eine ungerade Anzahl von Serverknoten ist erforderlich.

Schritt 4.1: Akzeptieren der Lizenzvereinbarung

Lesen Sie vor dem Ausführen der Installation die Lizenzvereinbarung.
Um die Lizenzvereinbarung zu akzeptieren, wählen Sie eine der folgenden Methoden:

  • Option 1 (Umgebungsvariable)
  • Set the LICENSE_AGREEMENT environment variable to accept by running the following command:
export LICENSE_AGREEMENT=accept
  • Option 2 (Inline-Parameter)
  • Append --accept-license-agreement to every execution of install-uipath.sh.

     

    Schritt 4.2: Erstellen und Verbinden aller Maschinen mit dem Cluster

    1. Richten Sie die erste Maschine ein.
      Führen Sie die folgenden Befehle auf dem ersten Server aus:
      cd /opt/UiPathAutomationSuite
      ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement

    2. Verbinden Sie die restlichen Server mit dem Cluster.
      Führen Sie die folgenden Befehle nacheinander auf den restlichen Serverknoten aus:
      cd /opt/UiPathAutomationSuite
      sudo chmod -R 755 /opt/UiPathAutomationSuite
      sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j server --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement

    3. Verbinden Sie die restlichen Agenten mit dem Cluster.
      Führen Sie die folgenden Befehle nacheinander auf den restlichen Agentknoten aus:
      cd /opt/UiPathAutomationSuite
      sudo chmod -R 755 /opt/UiPathAutomationSuite
      sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j agent --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement

     

    Schritt 4.3: Fertigstellen der Installation der Suite

    Sobald alle Knoten verbunden sind, wechseln Sie zum ersten Server, um die Installation der Automation Suite abzuschließen:
     
    1. Überprüfen Sie, ob die Knoten ordnungsgemäß hinzugefügt wurden, indem Sie den folgenden Befehl ausführen:
      sudo su
      export KUBECONFIG=/etc/rancher/rke2/rke2.yaml PATH=$PATH:/var/lib/rancher/rke2/bin
      kubectl get nodes

    2. Wenn Sie mehr als einen Knoten in der Liste sehen, hat alles funktioniert.

    3. Schließen Sie die Installation ab, indem Sie den folgenden Befehl ausführen:
      cd /opt/UiPathAutomationSuite
      ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f -s --offline-bundle /uipath/tmp/sf.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement
      Note: This is the most time-consuming operation. Expect it to take approximately two hours.
     

    Laden der optionalen Pakete
     
    • To load the optional Document Understanding bundle, run the following command:
    ./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"

  • Führen Sie den folgenden Befehl aus, um das optionale Computer Vision-Paket zu laden:
  • ./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"

    Abschließen der AI Center-Installation
     

    If AI Center requires an external Orchestrator, run the following command to complete the installation:

    ./configureUiPathAS.sh aicenter configure --installation-token <identity token>

    For more information on how to configure Orchestrator for AI Center, check the Configuring Orchestrator page from the AI Center guide.

     

    Schritt 5: Abschließen der Installation


    📘

    Hinweis:

    Sie haben die Installation erfolgreich abgeschlossen und können mit den Schritten nach der Installation fortfahren.

    Aktualisieren der Zertifikate

    🚧

    Wichtig!

    Bei der Installation werden selbstsignierte Zertifikate in Ihrem Namen erstellt. Die Azure-Bereitstellungsvorlage bietet Ihnen jedoch auch die Möglichkeit, zum Zeitpunkt der Installation ein von der Zertifizierungsstelle ausgestelltes Serverzertifikat bereitzustellen, anstatt ein automatisch generiertes, selbstsigniertes Zertifikat zu verwenden.

    Selbstsignierte Zertifikate laufen in 90 Tagen ab und Sie müssen sie durch Zertifikate ersetzen, die von einer vertrauenswürdigen Zertifizierungsstelle signiert wurden, sobald die Installation abgeschlossen ist. Wenn Sie die Zertifikate nicht aktualisieren, funktioniert die Installation nach 90 Tagen nicht mehr.

    Anweisungen finden Sie unter Verwalten von Zertifikaten.

    Zugreifen auf die Automation Suite

    To access the newly created cluster and suite, see Accessing Automation Suite.

    Ändern der PVC-Größe

    To resize the PVC, see Resizing PVC.

    Vor etwa einem Monat aktualisiert


    HA-fähige Offline-Produktionsinstallation mit mehreren Knoten


    This page provides instructions on how to install Automation Suite on multiple machines, in an offline environment with no access to the Internet.

    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.