Installation

Die Installation des High Availability Add-ons (HAA) für Ihre Orchestrator-Instanz erfolgt durch Herunterladen und Ausführen eines bereitgestellten Skripts.

Before proceeding with your HAA installation be sure that you meet the Hardware and Software Requirements.

Hinweis:

• HAA erfordert eine separate Lizenz von Orchestrator. Wenden Sie sich an UiPath, um weitere Informationen zu erhalten.
• Active/Active Disaster Recovery deployment models require two HAA licenses.

Hinweis:

Wir unterstützen die Abwärtskompatibilität mit Orchestrator, empfehlen jedoch die Aktualisierung auf die neueste HAA-Version.

Installation

Voraussetzungen

Stellen Sie vor Beginn der HAA-Installation sicher, dass Sie:

• der Stammbenutzer sind oder Zugriff auf sudo für den Stammbenutzer haben.

• Rechte zum Erstellen von Benutzern haben.

• ensure that you have a valid SSL/TLS certificate. Refer to Redis documentation for instructions on how to update your certificates.

• Firewalldienst aktiviert haben.

  Hinweis:

  Stammberechtigungen sind nur für die Installation und Aktualisierung erforderlich, der HAA-Administratorbenutzer benötigt keine erweiterten Berechtigungen, um die Clusterdienste zu verwalten.

  Auf den folgenden Daemons, die vom HAA-Administrator ausgeführt werden, wurden Funktionsbits festgelegt, um der ausführbaren Datei die minimalen Berechtigungen zu gewähren, die für den Betrieb erforderlich sind:

  /opt/redislabs/bin/dmcproxy = cap_sys_resource+ep

  /opt/redislabs/bin/redis-server-4.0 = cap_sys_resource+ep

  /opt/redislabs/bin/redis-server-4.0-big = cap_sys_resource+ep

  /opt/redislabs/bin/redis-server-5.0 = cap_sys_resource+ep

  /opt/redislabs/bin/redis-server-5.0-big = cap_sys_resource+ep

  /opt/redislabs/bin/sentinel_service = cap_sys_resource+ep

  /opt/redislabs/sbin/pdns_server = cap_net_bind_service+ep

  /opt/redislabs/sbin/smaps = cap_sys_ptrace+ep

  Diese ermöglichen es dem HAA-Administratorbenutzer, diese Dienste mit Berechtigungen auszuführen, ohne dass dem Benutzer die Berechtigungen zugewiesen werden müssen.“

• Swap deaktivieren:

1. Deaktivieren Sie swap mit dem Befehl: sudo swapoff -a.
2. Um diese Änderung nach Neustarts beizubehalten, kommentieren Sie den Eintrag swap in der Datei etc/fstab, indem Sie diesen Befehl ausführen: sudo sed -i.bak '/ swap / s/^(.*)$/#1/g' /etc/fstab.
3. Installieren Sie das wget-Paket, das zum Herunterladen der RS-Installationsdatei verwendet wird, indem Sie den Befehl yum install wget ausführen.
4. Wiederholen Sie diesen Vorgang auf allen Knoten, auf denen Sie HAA installieren.

Je nach Sprache und Zeichensatz (Codierung) können beim Ausführen des Installationsskripts auch Probleme auftreten. Es wird empfohlen, zuerst zu überprüfen, ob Deutsch der Liste der Sprachen hinzugefügt wurde:

1. Informationen zur aktuell installierten und verwendeten locale anzeigen: locale -a oder localectl ausführen.
2. Legen Sie Deutsch als Sprache und Codierung für die aktuelle Sitzung fest, indem Sie diesen Befehl ausführen:$ export LANG="en_US.utf8".

Master-Knoten

1. Laden Sie das Installationsskript herunter, indem Sie wget https://raw.githubusercontent.com/UiPath/Infrastructure/main/Setup/get-haa.shausführen.

2. Machen Sie das Skript ausführbar, indem Sie chmod a+x get-haa.sh ausführen.

3. Installieren Sie den Masterknoten mit dem folgenden Befehl: sudo ./get-haa.sh -u <email> -p <password>.

   Geben Sie die E-Mail und das gewünschte Kennwort für den Kontoadministrator sowie die Installationsverzeichnisse an.

   Wichtig:

   • Um HAA an einem benutzerdefinierten Speicherort zu installieren, führen Sie das Skript install.sh für die erweiterte Konfiguration aus (dabei wird kein Cluster erstellt), wobei zu beachten ist, dass alle Speicherorte unterschiedlich sein müssen. Beispiel:

   sudo ./install.sh --install-dir /opt/haa-uipath --config-dir /etc/opt/haa-uipath --var-dir /var/opt/haa-uipath.

   • Überprüfen Sie den ausgewählten Installationspfad. Das Verschieben einer Installation von einem Speicherort an einen anderen wird nicht unterstützt.

Sekundäre Knoten

Nachdem Sie den primären (Master-)Knoten installiert haben, führen Sie auf jedem zusätzlichen Knoten Folgendes aus:

1. Erstellen Sie das Verzeichnis, in das HAA heruntergeladen und extrahiert werden soll, z. B.: mkdir haa.

2. Wechseln Sie mit diesem Befehl in das neu erstellte Verzeichnis: cd /<path-to>/haa/.

3. Laden Sie das Installationsskript herunter, indem Sie wget https://raw.githubusercontent.com/UiPath/Infrastructure/main/Setup/get-haa.shausführen.

4. Machen Sie das Skript ausführbar, indem Sie chmod a+x get-haa.sh ausführen.

5. Installieren Sie den Knoten mit dem folgenden Befehl: sudo ./get-haa.sh -u <email> -p <password> -j <IP_address_of_the_master_node>.

   Geben Sie die bei der Erstellung des Master-Knotens festgelegte E-Mail und das Kennwort sowie die IP-Adresse des primären Knotens an.

Skriptparameter

Die folgenden Parameter sind verfügbar, wenn sie das HAA-Installationsskript ausführen:

Parameter	Beschreibung
-u	Der Benutzername des HAA-Clusteradministrators. Beispiel: -u [e-mail].
-p	Das Kennwort für den Verwaltungsbenutzer, das bei der Installation des primären Knotens festgelegt wird. Beispiel: -p SuperSecret_Password.
-j	Die IP-Adresse des primären Knotens. Wenn angegeben, wird ein sekundärer (Slave)-Knoten installiert. Beispiel: -j 10.10.22.10.
--install-dir	Geben Sie den Pfad zum HAA-Installationsverzeichnis an (nur beim Ausführen des Skripts install.sh für die erweiterte Installation). Überprüfen Sie den ausgewählten Installationspfad. Das Verschieben einer Installation von einem Speicherort an einen anderen wird nicht unterstützt.
--config-dir	Geben Sie den Pfad zum HAA-Konfigurationsverzeichnis an (nur beim Ausführen des Skripts install.sh für die erweiterte Installation).
--var-dir	Geben Sie den Pfad zum HAA-Variablenverzeichnis an (nur beim Ausführen des Skripts install.sh für die erweiterte Installation).
-h	Wird zur Anzeige der Installationshilfe verwendet.
-l	Der Lizenzcode für Ihren HAA-Cluster.

UiPath.Orchestrator.dll.config Configuration

You must configure Orchestrator to use HAA and add all HAA nodes to the Orchestrator UiPath.Orchestrator.dll.config file using the LoadBalancer.UseRedis and LoadBalancer.Redis.ConnectionString parameters. For example:

<add key="LoadBalancer.UseRedis" value="true" />
<add key="LoadBalancer.Redis.ConnectionString" value="10.10.20.184:10000,10.10.24.148:10000,10.10.22.114:10000,password=SuperSecret_Password" />

Überprüfen der Clusterinstallation

Nachdem Sie alle Knoten Ihres HAA-Clusters installiert haben, überprüfen Sie wie folgt, ob die Konfiguration erfolgreich war:

1. Navigieren Sie mit Ihrem Browser zur IP-Adresse eines beliebigen HAA-Knotens auf Port 8443. Beispiel: https://10.10.20.196:8443/. Die HAA-Anmeldeseite wird angezeigt.

   

2. Geben Sie den Benutzernamen und das Kennwort ein, die während der Installation angegeben wurden, um sich anzumelden.

3. Wählen Sie die Registerkarte Knoten aus, und stellen Sie sicher, dass alle installierten Knoten hier mit dem Status OK angezeigt werden.

   

4. Wählen Sie die Registerkarte Datenbanken aus, und vergewissern Sie sich, dass die Datenbank uipath-orchestrator hier mit dem Status OK angezeigt wird.

5. Bei einer Bereitstellung auf mehreren Knoten stellen Sie sicher, dass Replikation in den Datenbankeinstellungen aktiviert ist und dass zwei Knoten eine Shard-Anzahl von 1 anzeigen. Dadurch wird sichergestellt, dass die Datenbank auf zwei Knoten repliziert wird.

   Hinweis:

   Standardmäßig wird diese Datenbank auf Port 10000 mit dem bei der Installation angegebenen Kennwort erstellt.

HAA-Lizenzierung

Um Ihre High Availability Add-on-Lizenz hinzuzufügen oder zu aktualisieren, folgen Sie diesen Schritten:

1. Navigieren Sie mit Ihrem Browser zur IP-Adresse eines beliebigen HAA-Knotens auf Port 8443. Beispiel: https://10.10.20.196:8443/. Die HAA-Anmeldeseite wird angezeigt.
2. Geben Sie den Benutzernamen und das Kennwort ein, die während der Installation angegeben wurden, um sich anzumelden.
3. Wählen Sie die Registerkarte Einstellungen > Allgemein aus.
4. Geben Sie im Feld Clusterschlüssel Ihren Lizenzschlüssel ein.
5. Klicken Sie auf Speichern (Save).

Your HAA cluster is now ready, and you can proceed with the Orchestrator installation, as described here.