Offline-Auswertungsinstallation mit einem Knoten

Ü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 .

Der Installationsvorgang umfasst die folgenden grundlegenden Schritte:

Schritt	Beschreibung
Schritt 1: Herunterladen der Installationspakete	Sie müssen diesen Schritt von einer Linux- oder Windows-Maschine aus durchführen, die Zugriff auf das Internet und auf die Offline-Maschinen hat, auf denen Sie die Automation Suite bereitstellen möchten. Während die Installationspakete fertig heruntergeladen werden, können Sie einige der nächsten Schritte ausführen. Schritt 1.1: Herunterladen des Installationspakets Schritt 1.2: Übertragen aller heruntergeladenen Dateien auf die Maschine
Schritt 2: Konfigurieren der Installation	Das interaktive Installationsprogramm sammelt Eingaben für die meisten gängigen Installationsoptionen und erstellt eine Konfiguration, die Sie während der Installation verwenden können. Schritt 2.1: Konfigurieren der Installation: Standardkonfiguration Das interaktive Installationsprogramm bietet ein Standardprogramm mit einer begrenzten Anzahl von Konfigurationsoptionen. Bearbeiten Sie die Konfigurationsdatei, um die installierten Produkte anzupassen, separate SQL-Server für bestimmte Produkte einzurichten und vieles mehr. Schritt 2.2: (Optional) Konfigurieren der Installation: Erweiterte Konfiguration (optional)
Schritt 3: Ausführen der Installation	Führen Sie die Installation aus. Sobald die Installation abgeschlossen ist, können Sie mit der Verwendung des Clusters beginnen. Schritt 3: Ausführen der Installation
Schritt 4: Abschließen der Installation	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 4: 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 der Dateien auf die Maschine

Schritt 1.1: Herunterladen des Installationspakets

Sie müssen diesen Schritt auf einer Linux- oder Windows-Maschine mit Zugriff auf das Internet und auf die Maschine in der Offlineumgebung ausführen, auf der Sie die Automation Suite installieren möchten.

Die Befehle auf dieser Seite gelten für ein RHEL-basiertes Betriebssystem. Für Windows oder andere Betriebssysteme müssen Sie die entsprechenden Befehle für diese Umgebungen anpassen.

Wichtig: Sie müssen die erforderlichen RPM-Pakete installieren, bevor Sie das Automation Suite-Installationsprogramm starten. Weitere Informationen finden Sie unter RPM-Paketanforderungen.

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 Installationsdatei 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 – Obligatorisch. Anweisungen zum Herunterladen finden Sie unter sf.tar.gz.
   • sf-infra.tar.gz – Optional. Nur erforderlich, wenn Sie zusätzliche Knoten hinzufügen möchten, einschließlich Task Mining und GPU. Anweisungen zum Herunterladen 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.

Schritt 1.2: Übertragen aller heruntergeladenen Dateien auf die 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 DER HAUPTMASCHINE DES CLUSTERS

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

sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 755 /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

Kopieren Sie die Dateien auf einen der Knoten:

1. Kopieren Sie die Dateien von der Maschine mit Internetzugang in den Installationsordner auf der Zielmaschine und die Offlinepakete in den Ordner /uipath/tmp.

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

   Wenn Sie zusätzliche Knoten hinzufügen möchten, z. B. für Task Mining oder GPU, führen Sie stattdessen den folgenden Befehl aus:

   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 die folgenden Pakete 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: Standardkonfiguration

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 /opt/UiPathAutomationSuite
   cd /opt/UiPathAutomationSuite
   unzip ./sf-installer.zip -d .
   chmod +x ./bin/jq
   export PATH=${PATH}:/opt/UiPathAutomationSuite/bin

   Wenn Sie zusätzliche Knoten hinzufügen möchten, z. B. für Task Mining oder GPU, führen Sie stattdessen den folgenden Befehl aus:

   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 abgelegt und ausgeführt werden, ausreichende Berechtigungen zu erteilen. Das Installationsprogramm erstellt auch einige Dateien (output.json) nach der Ausführung jeder Phase. Um die erforderlichen Berechtigungen bereitzustellen, führen Sie den folgenden Befehl aus:

   chmod -R 755 /opt/UiPathAutomationSuite

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

   Das interaktive Installationsprogramm versucht, sf-installer.zip herunterzuladen und schlägt in Offline-Umgebungen fehl. Um den Schritt zum Herunterladen zu umgehen und Probleme bei der Installation zu vermeiden, führen Sie den folgenden Befehl aus:

   export BUNDLE_FILE="/opt/UiPathAutomationSuite/sf-installer.zip"

   Führen Sie den folgenden Befehl aus, um das interaktive Installationsprogramm zu starten:

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

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

Ausführen des interaktiven Assistenten im Einzelknoten-Offlinemodus

Führen Sie das interaktive Installationsprogramm aus, um die Installationsoptionen zu konfigurieren. Das Tool sammelt Eingaben für die gängigsten Installationsoptionen und generiert eine Konfigurationsdatei. HAA wird im Auswertungsmodus mit einem einzelnen Knoten nicht unterstützt.

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

1. Starten Sie das interaktive Installationsprogramm.
2. Akzeptieren Sie die Lizenzvereinbarung, um die Installation fortzusetzen.
3. Wählen Sie im Hauptmenü Ihren Bereitstellungsmodus aus. Wählen Sie Bereitstellung mit einem einzelnen Knoten (empfohlen für Demo-/Auswertungszwecke) und bestätigen Sie Ihre Auswahl.
   
4. Wählen Sie unter Bereitstellungskonfiguration Ihren Umgebungstyp aus. Wählen Sie Air-Gap aus.
5. Wählen Sie Ihre Produktauswahl aus. Ihre Optionen sind:
   • Vollständig (Alle Produkte)
   • Produkte auswählen

   Hinweis:

   Weitere Informationen zu den Produktauswahloptionen finden Sie unter Hardware- und Softwareanforderungen.

6. 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

   Wichtig:

   Einige Produkte der Automation Suite haben zusätzliche Abhängigkeiten zueinander. Berücksichtigen Sie bei der Auswahl der Produkte, die Sie installieren möchten, die produktübergreifenden Abhängigkeiten. Der Versuch, ein Produkt ohne dessen Abhängigkeiten zu installieren, würde zu einem Fehler führen.

   Einige Automation Suite-Produkte, z. B. Task Mining und Document Understanding, erfordern einen dedizierten Agentknoten. Bevor Sie fortfahren, stellen Sie sicher, dass Sie die Hardwareanforderungen erfüllen.

7. Um AI Center zu installieren, müssen Sie zusätzliche Schritte ausführen:
   1. Geben Sie an, ob AI Center einen externen Orchestrator erfordert.
      • Wenn das AI Center keinen externen Orchestrator erfordert, fahren Sie mit Schritt 8 fort.
      • Wenn das AI Center einen externen Orchestrator erfordert, fahren Sie mit Schritt 7b fort.
   2. Kopieren Sie das Orchestrator-Zertifikat auf die virtuelle Maschine. Weitere Informationen hierzu finden Sie auf der Seite Orchestrator-Zertifikat kopieren.
   3. Geben Sie die Orchestrator-URL für AI Center an. Beispiel: https://orchestrator.example.com.
   4. Geben Sie die Identitäts-URL für das AI Center an. Beispiel: https://orchestrator.example.com/identity.
   5. Geben Sie den Pfad zur Orchestrator-Zertifikatdatei an. Beispiel: /opt/UiPathAutomationSuite/UiPath_Installer/orch.cer.
   6. Geben Sie den Pfad zur Identitätszertifikatdatei an. Beispiel: /opt/UiPathAutomationSuite/UiPath_Installer/identity.cer.
      Wichtig: Bei Offlineinstallationen müssen Sie den API-Schlüssel für die Messung nicht angeben. Um die Installation des AI Centers abzuschließen, führen Sie die Schritte aus dem Abschnitt Installation abschließen aus.
8. Bestätigen Sie Ihre Produktauswahl, um die minimalen Hardware- und Softwareanforderungen zu bestimmen.
9. Geben Sie den FQDN der Automation Suite ein.
10. 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:
    • Azure-Speicherkonto – Geben Sie an, ob Sie mit Ihrem Azure-Speicherkonto verwaltete Identitäten verwenden möchten, geben Sie die folgenden Details entsprechend Ihrer Auswahl an und legen Sie dann fest, ob die Container für alle ausgewählten Produkte automatisch bereitgestellt werden sollen:
      • Wenn Ja, geben Sie den Namen des Azure-Speicherkontos und das Endpunktsuffix sowie Ihre Client-ID an.
      • 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.
      Wichtig: Viele S3-Objectstores erfordern, dass der CORS auf den gesamten Datenverkehr aus dem Automation Suite-Cluster festgelegt ist. Sie müssen die CORS-Richtlinie auf Objectstore-Ebene konfigurieren, um den FQDN des Clusters zuzulassen.
11. Geben Sie an, ob Sie Kerberos Auth für SQL-Verbindungen verwenden möchten.
12. Geben Sie die SQL Server-URL ein. Folgen Sie der Eingabeaufforderung, um den Verbindungsport, den Benutzernamen und das Kennwort einzugeben.
    Wichtig: Wenn Sie Process Mining installieren, wird ein zweiter SQL Server empfohlen. Stellen Sie sicher, dass Sie die Warehouse SQL Server-URL, die Verbindungsaufforderung, den Benutzernamen und das Kennwort angeben.

    Weitere Informationen zu den Hardwareanforderungen, die der zweite SQL Server erfüllen muss, finden Sie unter SQL-Anforderungen für Process Mining.
13. Geben Sie an, ob das Installationsprogramm automatisch die erforderlichen Datenbanken erstellen soll.
14. Stellen Sie CA-Zertifikate für jede externe Software bereit, die eine sichere TLS-Kommunikation erfordert, andernfalls schlägt die Installation fehl. Wenn Sie die TLS-Kommunikation nicht aktiviert haben, können Sie die Zertifikate nach der Installation konfigurieren.
    Wichtig: Das Installationsprogramm akzeptiert nur Base64-codierte DER-Zertifikate im „PEM“-Format. Wenn die externen Server unterschiedliche Zertifizierungsstellen haben, können Sie alle öffentlichen Zertifikate in einer einzigen Datei verketten.
15. Nach dem Definieren der Konfigurationsparameter generiert das Installationsprogramm automatisch die Konfigurationsdatei. Sie können die Konfigurationsparameter direkt im Terminal bearbeiten.
    Wichtig: Nachdem Sie die Konfigurationsdatei und den Ordner erstellt haben, können Sie das Installationsprogramm beenden und mit den verbleibenden Schritten fortfahren, um die Installation abzuschließen.

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)

Dieser Schritt ist optional.

Sie finden die Datei cluster_config.json im Ordner UiPathAutomationSuite. Sie können mit dieser Datei zusätzliche Produkte aktivieren, eines der Standardprodukte deaktivieren, Ihre SQL-DBs und deren jeweilige Verbindungszeichenfolgen und Zertifikate konfigurieren. Sie können auch Proxyeinstellungen aktivieren, wenn Sie einen Proxy für die Internetverbindung verwenden.

Beachten Sie, dass Sie bei einer Auswertungsinstallation mit nur einem einzelnen Knoten keine Hochverfügbarkeit aktivieren können.

Informationen zur erweiterten Konfiguration finden Sie unter Erweiterte Installation.

Hinweis:

Sie können den Assistenten nach der vollständigen Installation erneut ausführen.

Schritt 3: Ausführen der Installation

Stellen Sie sicher, dass Sie die heruntergeladenen Dateien auf der Offline-Hauptmaschine, auf der Sie die Konfiguration durchgeführt haben, in den vom Installationsassistenten erstellten Installationsordner kopiert haben.

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 zu akzeptierende Umgebungsvariable LICENSE_AGREEMENT 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.shanfügen.

Ausführen der Installation

Führen Sie die Installationsbefehle aus, um das Offlinepaket auszuführen (geschätzte Dauer: 2,5–3,5 Stunden):

./install-uipath.sh -i ./cluster_config.json -o ./output.json -a --offline-bundle /uipath/tmp/sf.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement

Wenn Sie Hilfe benötigen, können Sie ./install-uipath.sh -h --accept-license-agreement ausführen.

Laden der optionalen Pakete

Um die optionalen Document Understanding-Bundles zu laden, führen Sie die folgenden Befehle 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"

Dieses Dokument konzentriert sich auf das Befehlsargument -a, da dieses für die Installation aller erforderlichen Komponenten sorgt.

Installieren von Task Mining

Wenn Sie Task Mining im Auswertungsmodus mit einem einzelnen Knoten installieren, müssen Sie eine zusätzliche Reihe von Schritten ausführen. Befolgen Sie die Installationsanleitung für Task Mining, um die Schritte für Task Mining abzuschließen.

Schritt 4: Abschließen der Installation

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

Aktualisieren der Zertifikate

Achtung:

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.

Abschließen einer AI Center-Installation

Wenn das AI Center einen externen Orchestrator erfordert, führen Sie den folgenden Befehl aus, um die Installation abzuschließen:

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

Weitere Informationen zum Konfigurieren des Orchestrators für AI Center finden Sie auf der Seite Konfigurieren des Orchestrators im AI Center-Handbuch.

Ändern der PVC-Größe

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