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:

Sie müssen die Voraussetzungen für Hardware und Software erfüllen, bevor Sie mit der Installation fortfahren. Siehe Hardware- und Softwareanforderungen.

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

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)
Schritt 3: Kopieren der Installationsdateien auf alle Maschinen	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
Schritt 4: Ausführen der Installation	Erstellen Sie den Cluster und verbinden Sie alle Maschinen. Installieren Sie von der ersten Maschine den Rest der Suite. Schritt 4: Ausführen der Installation
Schritt 5: Abschließen der Installation	Schritt 5: Sie haben die Installation erfolgreich abgeschlossen und können mit den Schritten nach der Installation fortfahren. 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

Wichtig:

RHEL-Kernel-Version kernel-4.18.0-477.10.1.el8_8 ist von einem Problem betroffen, das die Installation oder Verwaltung des Automation Suite-Clusters unterbricht. Stellen Sie sicher, dass keiner der Automation Suite-Knoten vor oder nach der Installation diese Kernel-Version verwendet. Sie können die Kernel-Version aktualisieren, indem Sie den folgenden Befehl ausführen:

dnf install -y kernel kernel-tools kernel-tools-libs

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 – Obligatorisch. Anweisungen zum Herunterladen finden Sie unter installUiPathAS.sh .
   • sf-installer.zip – Obligatorisch. Anweisungen zum Herunterladen finden Sie unter sf-installer.zip .
   • sf.tar.gz – Optional. Nur auf dem Serverknoten erforderlich, wenn eine interne Docker-Registrierung verwendet wird. Downloadanweisungen finden Sie unter sf.tar.gz.
   • sf-infra.tar.gz – Obligatorisch. Downloadanweisungen finden Sie unter sf-infra.tar.gz.
   • du-ondemand.tar.gz – Optional. 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.gz – Optional. Nur für Computer Vision erforderlich. Anweisungen zum Herunterladen finden Sie unter du-ondemand.tar.gz.
     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/

   Warnung: Wenn Sie diesen optionalen Schritt überspringen, ist kein Zugriff auf die Document Understanding-Dienste möglich.
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/

   Warnung: 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

Ausführen des interaktiven Assistenten mit mehreren Knoten im Offlinemodus

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)

Dieser Schritt ist optional.

Wenn Sie die Installation mit der Standardkonfiguration ausführen, entscheiden Sie sich für die Ausführung unserer Basisproduktauswahl. Sie installieren unsere Kernplattform, den Orchestrator, Insights, Test Manager, Action Center, Automation Ops, Automation Hub und Data Service.

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.

Für die erweiterte Konfiguration können Sie die folgenden Anweisungen heranziehen: Erweiterte Installation.

Hinweis: Wenn Sie das interaktive Installationsprogramm beenden und eine erweiterte Konfiguration durchführen, müssen Sie das interaktive Installationsprogramm erneut ausführen, damit die Installation abgeschlossen ist.

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: Da Sie sich in einer Air Gap-Umgebung befinden, müssen Sie möglicherweise die private IP des Zielknotens verwenden.
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

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) – Legen Sie die Umgebungsvariable LICENSE_AGREEMENT auf accept fest, indem Sie den folgenden Befehl ausführen: 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

Schritt 4.3: Fertigstellen der Installation der 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

Warnung:

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:

  ./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"

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

  ./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"

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

Informationen zum Zugriff auf den neu erstellten Cluster und die Suite finden Sie unter Zugreifen auf die Automation Suite.

Ändern der PVC-Größe

Informationen zum Ändern der PVC-Größe finden Sie unter Ändern der PVC-Größe.

Wenn Sie das AI Center installiert haben, empfehlen wir, die Größe des PVC sofort nach der Installation auf 200 zu ändern, um Ausfallzeiten zu vermeiden. Weitere Informationen dazu finden Sie unter Ändern der PVC-Größe für das AI Center.

Hinzufügen von Rancher/Pause:3.5

Wenn Sie AI CenterTM installiert haben, müssen Sie das Rancher-Image importieren und exportieren. Weitere Informationen hierzu finden Sie unter Hinzufügen von Rancher/Pause:3.5 zur Offlineregistrierung.