Installation

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

Bevor Sie mit Ihrer HAA-Installation fortfahren, stellen Sie sicher, dass Sie die Hardware- und Softwareanforderungen erfüllen.

Hinweis:

• HAA erfordert eine separate Lizenz von Orchestrator. Wenden Sie sich an UiPath, um weitere Informationen zu erhalten.
• Active/Active Disaster Recovery- Bereitstellungsmodelle erfordern zwei HAA-Lizenzen.

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.
• stellen Sie sicher, dass Sie über ein gültiges SSL/TLS-Zertifikat verfügen. Anweisungen zum Aktualisieren Ihrer Zertifikate finden Sie in der Redis-Dokumentation.

• 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). Hinweis: Überprüfen Sie den ausgewählten Installationspfad. Das Verschieben einer Installation von einem Speicherort zu einem anderen nach der Installation 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

Sie müssen den Orchestrator für die Verwendung von HAA konfigurieren und alle HAA-Knoten der UiPath.Orchestrator.dll.config -Datei des Orchestrators mit den Parametern LoadBalancer.UseRedis und LoadBalancer.Redis.ConnectionString hinzufügen. Zum Beispiel:

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

Ihr HAA-Cluster ist nun bereit, und Sie können mit der Orchestrator-Installation fortfahren, wie hier beschrieben.