Verfahren

Schritt 1: Herunterladen des Installationsskripts auf der ersten Maschine

1.1 Die Installationspakete 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 Ihre AI Center-Version und Ihr Betriebssystem geeignet ist.

1.2 Alle heruntergeladenen Dateien auf die erste Maschine übertragen

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 777 /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 ./sf-infra.tar.gz <username>@<node dns>:/uipath/tmp/
  scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/
  scp ~/sf-infra.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.

Stellen Sie sicher, dass /opt/UiPathAutomationSuite über die richtige Berechtigung für das Kopieren von Dateien über scp verfügt, oder kopieren Sie die Datei in Ihr Hauptverzeichnis und verschieben Sie sie dann in /opt/UiPathAutomationSuite.

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

Wenn sich der Identity Server vom Orchestrator unterscheidet, wiederholen Sie die Schritte auch für identityserver.cer.

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

Grundkonfiguration

The following prerequisites are applicable for the main machine of the cluster.

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.

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

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.

Beim Starten des Installationsassistenten wird das Hauptmenü angezeigt. Hier müssen Sie den Bereitstellungsmodus auswählen: Mit einem einzelnen oder mit mehreren Knoten. Es erscheinen Details zu den einzelnen Modi, sobald Sie einen von ihnen auswählen. Danach haben Sie die Möglichkeit, mit der aktuellen Auswahl fortzufahren oder zum Hauptmenü zurückzukehren.

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 mehreren Knoten aus.

   

3. Wählen Sie „Weiter“ aus.

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

5. Wählen Sie Installation abschließen aus.

6. Geben Sie den DNS-Hostnamen ein.

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

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

9. 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":"<https://orchestrator-url.com>",
  "identity_server_url": "<https://orchestrator-url.com/identity>",
  "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.

For advanced configuration, see Using the configuration file.

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

From the first machine in the cluster, where the configuration was performed, copy the entire install folder to all other machines:

1. Kopieren Sie den Ordner ~/UiPathAutomationSuite auf alle anderen Knoten, indem Sie Folgendes ausführen:

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

   Hinweis:

   Since we 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.

Hinweis:

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

Schritt 5: Ausführen der Installation

1. Das Infrastruktur-Installationsprogramm auf allen Knoten ausführen:

   1. Richten Sie die primäre Maschine ein, indem Sie die folgenden Befehle auf dem primären Server ausführen:

      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 --install-standalone-aicenter
      

   2. Fügen Sie die restlichen Server in das Cluster hinzu, indem Sie die folgenden Befehle auf den restlichen Serverknoten ausführen:

      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 /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicenter
      

   3. Fügen Sie die restlichen Agenten in das Cluster hinzu, indem Sie die folgenden Befehle auf den restlichen Agentknoten ausführen:

      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 /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicenter
      

2. Das Fabric-Installationsprogramm auf dem primären Knoten ausführen

   cd /opt/UiPathAutomationSuite
   export TMPDIR="/uipath/lib/containers/tmp"
   mkdir -p "/uipath/lib/containers/tmp"
   ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f --offline-bundle /uipath/tmp/sf.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement --install-standalone-aicenter
   

3. Run the software installer on primary node 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 --install-type offline --accept-license-agreement --install-standalone-aicenter -s
   

4. Laden Sie die Befehle der optionalen Document Understanding-Pakete. Um die optionalen 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.

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

5. Laden Sie den Befehl der optionalen Computer Vision-Pakete. 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"