Verfahren

Schritt 1: Herunterladen des Installationsskripts

1.1 Das Installationspaket herunterladen

This step needs to be run on a machine with internet access and access to the machines in the air-gapped environment where UiPath AI Center will be installed.

Hinweis:

Diese Maschine kann mit Linux oder Windows laufen. Die angegebenen Schritte müssen auf dieser Maschine ausgeführt werden. Die Beispiele in diesem Dokument beziehen sich auf ein RHEL-basiertes Betriebssystem. Für Windows oder andere Betriebssystemversionen müssen Sie die entsprechenden Schritte für die jeweilige Umgebung anpassen.

Follow the steps below on the separate machine with internet access to get the required files to start the installation process:

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 installUiPath.as for download instructions.

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

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

   • sf-infra.tar.gz - Optional. Only needd if you want to join additional nodes, including Task Mining and GPU. See sf-infra.tar.gz for download instructions.

   • du-ondemand.tar.gz - Optional. Needed only for Document Understanding. See du-ondemand.tar.gz 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 cv-ondemand.tar.gz 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.

1.2 Alle heruntergeladenen Dateien auf die Maschine herunterladen

Führen Sie die folgenden Schritte aus:

• Vergewissern Sie sich, dass alle Dateien auf der Maschine mit Internetzugang fertig heruntergeladen wurden.
• Erstellen Sie den Zielordner auf der Maschine.
• Kopieren Sie die Dateien von der Onlinemaschine auf die Zielmaschine.

Create the installation folder on the main machine of the cluster by running the following command:

sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 755 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp

On the separate machine with internet access, copy the files to the first node:

• 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/
  

• (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/
  

  Hinweis:

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

• (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/
  

  Hinweis:

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

Schritt 2: Kopieren des Orchestrator-Zertifikats auf die virtuelle Maschine

Hinweis:

In case of chain certificates, check the Chain certificates section on how to correctly provide certificates.

Laden Sie das Orchestrator-Zertifikat auf Ihrer lokalen Maschine herunter und speichern Sie es. Sie können dies mit einem Browser tun oder Ihre IT-Abteilung bitten, das Zertifikat bereitzustellen. Zertifikate müssen im Format base64 und .cer sein. Kopieren Sie das Zertifikat mit dem folgenden Befehl auf die virtuelle Maschine.

scp /path/to/orch.cer <username>@<node dns>:/opt/UiPathAutomationSuite

Kettenzertifikate

Stellen Sie bei Verwendung eines von der Domäne ausgestellten Zertifikats sicher, dass Sie das Stammzertifikat wie folgt exportieren:

1. Öffnen Sie das Zertifikat, wechseln Sie zur Registerkarte Zertifizierungspfad und wählen Sie das erste Zertifikat aus. Klicken Sie auf Zertifikat anzeigen.

   

2. Sobald das Stammzertifikat angezeigt wird, wechseln Sie zur Registerkarte Details und klicken Sie auf In Datei kopieren.

   

3. Achten Sie darauf, das Dateiformat base64 cer auszuwählen.

4. Speichern Sie es mit dem Namen Ihrer Wahl und senden Sie ihn dann an die AI Center-Maschine.

Die Datei sollte wie im nachfolgenden Beispiel aussehen:

-----BEGIN CERTIFICATE-----
certificate
base64
encoded
-----END CERTIFICATE-----

Schritt 3: Konfigurieren der Installation

3.1. Den interaktiven Assistenten verwenden, um die Basiskonfigurationsdatei zu erstellen

1. Fügen Sie dem aktuellen PATH die folgenden Voraussetzungen hinzu:

   • Das interaktive Installationsprogramm erfordert jq. Unsere Offlinepakete enthalten es bereits. Führen Sie die folgenden Befehle aus, um ihn 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
     

2. Berechtigungen für den Installationsordner bereitstellen:

   • 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 Ausführung einer jeden Phase auch einige Dateien (output.json).

     Führen Sie den folgenden Befehl aus, um die Berechtigungen bereitzustellen:

     chmod -R 755 /opt/UiPathAutomationSuite
     

3. Den interaktiven Installationsassistenten ausführen, um die Installationsoptionen zu konfigurieren:

   • Der interaktive Assistent führt durch die Konfigurationsschritte und generiert die Konfigurationsdatei, die dann angepasst und bei den verbleibenden Installationsschritten verwendet werden kann.

4. Führen Sie das Skript aus und starten Sie den interaktiven Assistenten, indem Sie den folgenden Befehl ausführen:

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

5. Führen Sie die Schritte im Assistenten aus.

Hinweis:

Make sure to not start the install from the script and exit it when config file is generated, it will try to install full Automation suite otherwise. This script is primarily used for Automation Suite and the displayed information (products, requirements) is relative to Automation Suite. The config file will be adapted to our needs in the next steps of the procedure.

Führen Sie die Schritte zur Bereitstellungskonfiguration aus:

1. Accept the license agreement.

2. Wählen Sie den Bereitstellungsmodus aus: Wählen Sie Bereitstellung mit einem einzelnen Knoten aus.

   

3. Wählen Sie „Weiter“ aus.

4. Wählen Sie die Airgapped-Installation aus.

5. Geben Sie den DNS-Hostnamen ein.

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

7. Geben Sie die SQL Server-URL ein. Folgen Sie der Eingabeaufforderung, um den Verbindungsport, den Benutzernamen und das Kennwort einzugeben.

8. Geben Sie an, ob das Installationsprogramm automatisch die erforderlichen Datenbanken erstellen soll.

   

Die Clusterkonfigurationsdatei wird mit einem Ordner erstellt, wie in der folgenden Abbildung dargestellt.

Hinweis:

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. Sie können die Liste der Produkte ignorieren, da wir diese in den folgenden Schritten aktualisieren werden.

Eine erste Version der Datei cluster_config.json wird nun generiert. Wir aktualisieren diese Datei zum Zweck der Installation des AI Centers.

3.2 Fügen Sie die AI Center-spezifische Konfiguration hinzu

Öffnen Sie die Datei mit Ihrem Editor (z. B.: vi):

vi /opt/UiPathAutomationSuite/cluster_config.json

Ersetzen Sie den folgenden Block:

"aicenter": {
  "enabled": "false"
},

Hinweis:

Document Understanding is enabled by default if AI Center is enabled.

Mit den folgenden Informationen (ersetzen Sie die Informationen zwischen <> durch Ihre Werte):

"aicenter": {
  "enabled": "true",
  "orchestrator_url":"<a href="https://orchestrator-url.com">https://orchestrator-url.com</a>",
  "identity_server_url": "<a href="https://orchestrator-url.com/identity">https://orchestrator-url.com/identity</a>",
  "orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
  "identity_cert_file_path":  "</opt/UiPathAutomationSuite/orch.cer or custom path>",
  "identity_access_token": "<placeholder will be replaced later>"
},

3.3. (Optional) Erweiterte Konfiguration

Sie finden die Datei cluster_config.json im Ordner UiPathAutomationSuite. Sie können diese Datei verwenden, um Ihre SQL-DBs und deren jeweilige Verbindungszeichenfolgen und Zertifikate zu konfigurieren. Sie können auch Proxyeinstellungen aktivieren, wenn Sie einen Proxy für die Internetverbindung verwenden.

Bei einer Installation mit einem Knoten beachten Sie, dass Sie keine Hochverfügbarkeit aktivieren können.

For advanced configuration, see Using the configuration file.

Schritt 4: Ausführen der Installation

1. Führen Sie das Infrastrukturinstallationsprogramm aus.

   Wechseln Sie zum Ordner UiPath_Installer und führen Sie das Infrastruktur-Installationsprogramm mit dem eigenständigen AI Center-Flag aus.

   /opt/UiPathAutomationSuite
   ./install-uipath.sh -i cluster_config.json -o output.json --offline-bundle "/uipath/tmp/sf.tar.gz" --offline-tmp-folder /uipath/tmp --accept-license-agreement --install-offline-prereqs --install-standalone-aicenter -k
   

2. Installieren Sie die Fabric (Software-Komponenten).

   Führen Sie das Installationsprogramm mit dem eigenständigen AI Center-Flag aus.

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

3. Führen Sie das Software-Installationsprogramm aus.

   First you need to connect to identity server and retrieve an installation token. Then copy this token and paste it in placeholder we had in step 3.2. (in the cluster_config.json file). Once the token is there, you can run the AI Center install.

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

4. Laden Sie die Befehle der optionalen Document Understanding-Pakete.

   Um die optionalen Document Understanding-Pakete zu laden, führen Sie den folgenden Befehl aus. Stellen Sie sicher, dass Sie den Namen des Pakets verwenden, das Sie laden müssen.

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

5. Laden Sie die Befehle der optionalen Computer Vision-Pakete.

   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 /configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" --accept-license-agreement