HA-fähige Offline-Produktionsinstallation mit mehreren Knoten

Auf dieser Seite wird erklärt, wie Sie eine Offlineinstallation der Automation Suite mit einer HA-fähigen Produktionseinrichtung mit mehreren Knoten durchführen können.

Überblick

Wichtig:

Hardware and software prerequisites must be completed before proceeding with the installation. See Hardware and software requirements.

Für eine reibungslose Installation halten Sie sich an unsere empfohlenen Vorgehensweisen. Siehe .

Dieses Dokument enthält eine Offline-Installationsanleitung für die Bereitstellung der UiPath Automation Suite in einer Air-Gap-Umgebung ohne Internetzugang.

Der Installationsvorgang umfasst die folgenden grundlegenden Schritte:

Schritt	Beschreibung
Schritt 1: Herunterladen der Installationspakete	Dieser Schritt muss mit einer Maschine mit Zugriff auf das Internet und auf die Air-Gap-Maschinen durchgeführt werden, auf denen die Automation Suite bereitgestellt wird. Während diese noch mit dem Download beschäftigt sind, können Sie mit einigen der nächsten Schritte fortfahren. Dies kann über eine Linux- oder Windows-Maschine erfolgen. Schritt 1.1: Herunterladen des Installationspakets Schritt 1.2: Übertragen aller heruntergeladenen Dateien auf die erste Maschine
Schritt 2: Konfigurieren der Installation	Führen Sie den interaktiven Installationsassistenten aus, um die Installationsoptionen zu konfigurieren. Dieses Tool sammelt Eingaben für die gängigsten Installationsarten und generiert eine Konfigurationsdatei, die während der Installation verwendet wird. Konfigurieren von erweiterten Installationsoptionen (optional) Die grundlegende Konfiguration der Installation umfasst die in der Kernautomatisierung verwendeten Produkte und einen gemeinsam verwendeten SQL-Server, der von allen Produkten verwendet werden soll. Um die Produkte anzupassen, die installiert sind oder separate SQL-Server für bestimmte Produkte verwenden, können Sie dies durch Bearbeiten der Konfigurationsdatei tun. Schritt 2.1: Grundlegende Konfiguration Schritt 2.2: Erweiterte Konfiguration (optional)
Step 3: Copy the installation files on all the machines	Kopieren Sie auf der ersten Maschine die heruntergeladenen Dateien in den Installationsordner, den der Installationsassistent in Schritt 2 erstellt hat. Kopieren Sie auf die anderen Clustermaschinen den gesamten Installationsordner von der ersten Maschine in denselben Ordnerpfad auf jeder Maschine. Schritt 3: Kopieren der Installationsdateien auf alle Maschinen
Step 4: Run the installation	Erstellen Sie das Cluster und verbinden Sie alle Maschinen. Installieren Sie von der ersten Maschine aus den Rest der Suite. Schritt 4: Ausführen der Installation
Step 5: Complete the installation	Step 5: You have completed the installation successfully and can move to post-installation steps. Sie können nun auf den neu erstellten Cluster und die Suite zugreifen, Zertifikate aktualisieren, die Größe des PVC ändern und vieles mehr. Schritt 5: Abschließen der Installation

Schritt 1: Herunterladen der Installationspakete und Übertragen aller Dateien auf die erste Maschine

Schritt 1.1: Herunterladen des Installationspakets

Sie müssen diesen Schritt auf einer Maschine mit Zugriff auf das Internet und auf der Maschine in der Offlineumgebung ausführen, auf der die Automation Suite installiert wird.

Hinweis:

Diese Maschine kann mit Linux oder Windows laufen. Die Befehle in diesem Handbuch gelten für ein RHEL-basiertes Betriebssystem. Nutzen Sie bei Windows oder anderen Betriebssystemen Befehle, die diesen Umgebungen entsprechenden.

Das Automation Suite-Installationsprogramm ist ein Wrapper mehrerer Pakete, der auch einige Abhängigkeiten mit Hilfe des Red Hat Package Managers (RPM) installiert. Es bietet eine interaktive Erfahrung, die Sie bei der Konfiguration externer Ressourcen wie SQL und anderen Installationsoptionen unterstützt.

AUF DER SEPARATEN MASCHINE MIT INTERNETZUGANG

In diesem Abschnitt wird erläutert, wie Sie die erforderlichen Dateien zum Starten des Installationsvorgangs erhalten.

1. Stellen Sie eine Verbindung mit einer Maschine mit Internetzugang her und führen Sie den folgenden Befehl aus, um die interaktive Assistentendatei zu erhalten:

   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.sh – Mandatory. See for download instructions.

   • sf-installer.zip – Mandatory. See for download instructions.

   • sf.tar.gz – Optional. Required only on server node when using internal Docker registry. See for download instructions.

   • sf-infra.tar.gz - Mandatory. See for download instructions.

   • du-ondemand.tar.gz – Optional. Needed only for Document Understanding. See for download instructions.Note: Not following this optional step limits the functionality of the Document Understanding services.

   • du2110-ondemand.tar.gz – Optional. Needed only for Document Understanding. See for download instructions.

     Hinweis:

     Wenn Sie diesen optionalen Schritt überspringen, ist die Funktionalität der Document Understanding-Dienste begrenzt.

   • cv-ondemand.tar.gz – Optional. Needed only for Computer Vision. See for download instructions.

     Hinweis:

     Wenn Sie diesen optionalen Schritt überspringen, ist kein Zugriff auf die Computer Vision-Dienste möglich.

   Stellen Sie sicher, dass Sie das Paket herunterladen, das für die Version Ihrer Automation Suite und Ihr Betriebssystem geeignet ist.

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

Führen Sie die folgenden Schritte aus:

• Überprüfen Sie, ob alle Dateien mit Internetzugang auf den Computer heruntergeladen wurden;
• Erstellen Sie den Zielordner auf der Maschine;
• Kopieren Sie die Dateien von der Onlinemaschine auf die Zielmaschine.

AUF ALLEN MASCHINEN IM CLUSTER

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

Wichtig:

Das Ausführen von mkdir -p /opt/UiPathAutomationSuite/ ist nicht erforderlich, wenn Sie das Skript configureUiPathDisks.sh verwenden.

AUF DER SEPARATEN MASCHINE MIT INTERNETZUGANG

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:

   scp ~/installUiPathAS.sh ~/sf-installer.zip ~/sf-infra.tar.gz <username>@<node dns>:/uipath/tmp
   scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/
   

2. (Optional) Um Document Understanding zu verwenden, kopieren Sie das folgende Paket in den Ordner /uipath/tmp :

   scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/
   scp ~/du2110-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/
   

   Wichtig:

   Not following this optional step prevents access to the Document Understanding services.

3. (Optional) Um Computer Vision zu verwenden, kopieren Sie das folgende Paket in den Ordner /uipath/tmp:

   scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/
   

   Wichtig:

   Wenn Sie diesen optionalen Schritt überspringen, ist kein Zugriff auf die Computer Vision-Dienste möglich.

Schritt 2: Konfigurieren der Installation

Schritt 2.1: Grundlegende Konfiguration

AUF DER HAUPTMASCHINE DES CLUSTERS

1. Fügen Sie den Voraussetzungsordner zum aktuellen PATH hinzu.

   Das interaktive Installationsprogramm erfordert jq. Die Offlinepakete der Automation Suite enthalten es bereits. Führen Sie die folgenden Befehle aus, um es zum PATH hinzuzufügen, und stellen Sie sicher, dass Sie sich immer noch im Stammverzeichnis befinden:

   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
   

2. Erteilen Sie Berechtigungen für den Installationsordner.

   Es ist erforderlich, dem Ordner /opt/UiPathAutomationSuite, in dem die Installationsskripte gespeichert sind und ausgeführt werden, entsprechende Berechtigungen zu erteilen. Das Installationsprogramm erstellt nach dem Ausführen der einzelnen Schritte auch einige Dateien (output.json). Führen Sie den folgenden Befehl aus, um die erforderlichen Berechtigungen zu erteilen:

   chmod -R 755 /opt/UiPathAutomationSuite
   

3. Führen Sie das interaktive Installationsprogramm aus, um die Installationsoptionen zu konfigurieren.

   Wenn sf-installer.zip nicht in /opt/UiPathAutomationSuite/vorhanden ist, versucht das Installationsprogramm, es herunterzuladen, was fehlschlägt, da es sich um eine Offlineinstallation handelt.

   Das interaktive Installationsprogramm führt Sie durch die Konfigurationsschritte und generiert die Konfiguration, die Sie dann anpassen und bei den verbleibenden Installationsschritten verwenden können.

4. Führen Sie das folgende Skript aus, um das interaktive Installationsprogramm zu starten:

   Führen Sie den folgenden Befehl aus

   chmod +x ./installUiPathAS.sh
   ./installUiPathAS.sh
   

Running the interactive wizard in multi-node offline mode

1. Geben Sie die Option für den HA-fähigen Produktionsmodus mit mehreren Knoten ein.

   

2. Geben Sie die Option Air-Gap ein:

   

3. Geben Sie die URL für den Cluster (DNS-Hostname/Lastausgleich-URL im HA-fähigen Produktionsmodus mit mehreren Knoten) und die SQL Server-Informationen wie unten gezeigt an:

   

4. Die Konfiguration wird mit einem Ordner generiert, wie in der folgenden Abbildung gezeigt.

   

Sobald Sie die Konfigurationsdatei und den Ordner generieren, können Sie den Assistenten beenden und mit den restlichen Schritten fortfahren, um die Installation abzuschließen.

Schritt 2.2: Erweiterte Konfiguration (optional)

Wenn Sie die Installation mit der Standardkonfiguration ausführen, wählen Sie unsere Standardumgebung aus. Sie installieren unsere Kernplattform mit dem Orchestrator, Insights, Action Center, Test Manager, Automation Ops und Automation Hub.

Sie können die Datei für erweiterte Konfigurationen konfigurieren. Sie können zusätzliche Produkte aktivieren, eines der Standardprodukte deaktivieren sowie Ihre SQL-DBs und deren jeweilige Verbindungszeichenfolgen und Zertifikate konfigurieren. Beim HA-fähigen Produktionsmodus mit mehreren Knoten ist die Hochverfügbarkeit standardmäßig aktiviert, kann aber bei Bedarf auch deaktiviert werden.

For advanced configuration, you can follow the following instructions: Advanced installation experience.

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

Kopieren Sie das Installationsprogramm, die Zertifikate und cluster_config.json von der ersten Maschine im Cluster, auf der die Konfiguration durchgeführt wurde, auf alle anderen Maschinen.

AUF DER ERSTEN MASCHINE IM CLUSTER

1. Kopieren Sie den Ordner /opt/UiPathAutomationSuite auf alle anderen Knoten, indem Sie den folgenden Befehl ausführen:

   scp -r /opt/UiPathAutomationSuite <username>@<node dns>:/opt
   

   Wichtig:

   Since you are in an air-gapped environment, you might need to use the private IP of the target node.

2. Fügen Sie -i <cert.pem> hinzu, wenn Sie ein Zertifikat zum Anmelden verwenden. Wenn Sie den Inhalt der .pem-Datei in eine lokale Datei kopieren, muss die neue Datei über die korrekten Berechtigungen verfügen. Sie können die Berechtigung mit chmod 400 <cert.pem> erteilen.

Der obige Schritt stellt sicher, dass auf allen Maschinen dieselbe Konfiguration repliziert wird sowie alle heruntergeladenen Pakete für das Installationspaket.

Schritt 4: Ausführen der Installation

Es gibt zwei Arten von Maschinen: Server und Agent.

• Server – Maschinen, auf denen die Kubernetes-Infrastruktur (d. h. apiserver, etcd) ausgeführt wird. Diese Komponenten verwalten den gesamten Cluster.
• Agent – Eine einfache Maschine, die zum Ausführen von Workloads verwendet wird.

Der HA-fähige Produktionsmodus mit mehreren Knoten erfordert mindestens 3 Servermaschinen. Die Installation von Task Mining erfordert das Hinzufügen einer zusätzlichen Maschine, die als Agent verwendet wird.

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 und für HA (Hochverfügbarkeit) mindestens drei Serverknoten. Die Anzahl der Serverknoten muss ungerade sein.

Schritt 4.1: Akzeptieren der Lizenzvereinbarung

Before running the installation, make sure to read the License Agreement.

Um die Lizenzvereinbarung zu akzeptieren, wählen Sie eine der folgenden Methoden:

• Option 1 (Environment Variable) - Set the LICENSE_AGREEMENT environment variable to accept by executing the following command: export LICENSE_AGREEMENT=accept
• Option 2 (Inline-Parameter) – Alternativ können Sie --accept-license-agreement an jede Ausführung von install-uipath.sh anfügen.

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
   

Step 4.3: Finishing installing the suite

Beenden der Installation auf dem ersten Knoten

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 /opt/UiPathAutomationSuite/sf.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement
   

Wichtig:

Dies ist der zeitaufwändigste Vorgang. Rechnen Sie mit ca. 2 Stunden.

Laden der optionalen Pakete

• Um das optionale Document Understanding-Bundle zu laden, führen Sie den folgenden Befehl aus:

  ./install-uipath.sh -i ./cluster_config.json -o ./output.json --optional-offline-bundle "/uipath/tmp/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" --accept-license-agreement
  ./install-uipath.sh -i ./cluster_config.json -o ./output.json --optional-offline-bundle "/uipath/tmp/du2110-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" --accept-license-agreement
  

• Um das optionale Computer Vision-Paket zu laden, führen Sie den folgenden Befehl aus:

  ./install-uipath.sh -i ./cluster_config.json -o ./output.json --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" --accept-license-agreement
  

Step 5: Completing the 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.

For instructions, see Managing certificates.

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.

If you installed AI Center, we recommend resizing the PVC to 200 immediately after the installation to avoid downtimes. For more information on this, check Resizing PVC for AI Center.