Installieren des High Availability Add-on

Installationsübersicht

Hinweis:

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

Es gibt zwei Möglichkeiten, das High Availability Add-on (HAA) für Ihre Orchestrator-Instanz zu installieren:

• Schnell – durch Herunterladen und Ausführen eines bereitgestellten Skripts; wird verwendet, wenn Sie HAA innerhalb eines einzelnen Rechenzentrums einrichten möchten. Weitere Informationen dazu finden Sie unter Schnellinstallation.
• Erweitert – durch Ausführen einiger komplexer Vorgänge, einschließlich der Cluster-DNS-Konfiguration und der Clustererstellung und -einrichtung; wird verwendet, wenn Sie HAA in mehreren Rechenzentren einrichten möchten. Weitere Informationen dazu finden Sie unter Installation der Active/Active Disaster Recovery.

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

Hinweis:

HAA erfordert eine separate Lizenz vom Orchestrator.

Das Active/Active Disaster Recovery-Bereitstellungsmodell erfordert zwei HAA-Lizenzen. Wenden Sie sich an UiPath, um weitere Informationen zu erhalten.

Voraussetzungen

Die folgenden Voraussetzungen sind sowohl für die schnelle als auch für die erweiterte Installation identisch. 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.

1. Deaktivieren Sie swap:

   sudo swapoff -a
   

2. Um diese Änderung bei Neustarts beizubehalten, löschen Sie die Partition swap in der Datei etc/fstab.

3. Installieren Sie das wget-Paket. Stellen Sie sicher, dass Sie einen Download-Befehl verwenden, der von Ihrer Linux-Distribution unterstützt wird. Wenn Sie beispielsweise CentOS verwenden, führen Sie Folgendes aus:

   yum install wget
   

4. Wiederholen Sie diesen Vorgang auf allen Knoten, auf denen Sie HAA installieren. überprüfen, ob Englisch zur Liste der Sprachen hinzugefügt wurde. Je nach Sprache und Zeichensatz (Codierung) können Probleme beim Ausführen des Installationsskripts auftreten. Es wird empfohlen, zuerst zu überprüfen, ob Englisch der Liste der Sprachen hinzugefügt wurde:

   1. Zeigen Sie Informationen über das derzeit installierte locale an, indem Sie einen oder die folgenden Befehle ausführen:

      locale -alocalectl
      

      localectl
      

   2. Legen Sie Englisch als Sprache und Codierung für die aktuelle Sitzung fest, indem Sie diesen Befehl ausführen:

      $ export LANG="en_US.utf8"
      

Schnellinstallation

Wichtig:

Bevor Sie mit der schnellen HAA-Installation fortfahren, stellen Sie sicher, dass alle Ihre Knoten die Voraussetzungen erfüllen.

Installieren des primären Knotens

Führen Sie die folgenden Schritte aus, um HAA auf dem primären Knoten zu installieren:

1. SSH für den primären Knoten mit Stammberechtigungen.

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

   mkdir haa
   

3. Laden Sie das Installationsskript get-haa.sh herunter:

   wget https://download.uipath.com/haa/get-haa.sh
   

   Hinweis:

   Weitere Informationen dazu finden Sie im Abschnitt Skriptparameter.

4. Machen Sie das Skript get-haa.sh ausführbar:

   chmod a+x get-haa.sh
   

5. Installieren Sie den primären Knoten. Stellen Sie sicher, dass Sie eine E-Mail-Adresse und ein Kennwort für das Administratorkonto angeben. Sie können eine temporäre E-Mail-Adresse verwenden. Sie müssen auch das Betriebssystem (OS) angeben, das auf dem Knoten läuft.

   Hinweis:

   Um Ihr Betriebssystem beim Ausführen des Installationsbefehls im richtigen Format einzugeben, führen Sie zuerst Folgendes aus und beachten Sie den entsprechenden Betriebssystemwert im Hilfemenü:

   get-haa.sh -h
   

   Die Liste der unterstützten Betriebssysteme finden Sie unter Softwareanforderungen.

   sudo ./get-haa.sh -u <email> -p <password> -o <OS> --accept-license-agreement
   

Wichtig:

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

sudo ./install-haa.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 zu einem anderen nach der Installation wird nicht unterstützt.

Installieren der sekundären Knoten

Führen Sie nach der Installation des primären Knotens die folgenden Schritte auf jedem sekundären Knoten aus:

1. SSH für den sekundären Knoten mit Stammberechtigungen.

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

   mkdir haa
   

3. Wechseln Sie in das neu erstellte Verzeichnis:

   cd /<path-to>/haa/
   

4. Laden Sie das Installationsskript get-haa.sh herunter:

   wget https://download.uipath.com/haa/get-haa.sh
   

   Hinweis:

   Weitere Informationen dazu finden Sie im Abschnitt Skriptparameter.

5. Machen Sie das Skript get-haa.sh ausführbar:

   chmod a+x get-haa.sh
   

6. Installieren Sie den sekundären Knoten:

   Hinweis:

   Um Ihr Betriebssystem beim Ausführen des Installationsbefehls im richtigen Format einzugeben, führen Sie zuerst Folgendes aus und beachten Sie den entsprechenden Betriebssystemwert im Hilfemenü:

   get-haa.sh -h
   

   Die Liste der unterstützten Betriebssysteme finden Sie unter Softwareanforderungen.

   sudo ./get-haa.sh -u <email> -p <password> -o <OS> -j <IP_address_of_the_master_node> --accept-license-agreement
   

   Wichtig:

   Geben Sie die E-Mail-Adresse, das Kennwort und die IP-Adresse an, die beim Erstellen des primären Knotens festgelegt wurden.

Script parameters

In der folgenden Tabelle werden die Parameter beschrieben, die bei der Ausführung des HAA-Installationsskripts verfügbar sind:

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-haa.sh für die erweiterte Installation). Ü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-haa.sh für die erweiterte Installation).
--var-dir	Geben Sie den Pfad zum HAA-Variablenverzeichnis an (nur beim Ausführen des Skripts install-haa.sh für die erweiterte Installation).
-h	Wird zur Anzeige der Installationshilfe verwendet.
-l	Der Lizenzcode für Ihren HAA-Cluster. Geben Sie die Lizenz ohne --- LICENSE START --- oder --- LICENSE END --- am Anfang oder am Ende und ohne new line-(Absatz-)Zeichen ein.
--accept-license-agreement	Akzeptieren der UiPath-Lizenzvereinbarung
--offline	Für die Offline-Installation. Er geht davon aus, dass sich das Paket im aktuellen Ordner befindet, genauso wie das Installationsskript. Der Link für das Paket finden Sie im Skript get-haa.sh.

Konfigurieren von UiPath.Orchestrator.dll.config

Wichtig:

Dieser Schritt ist nur erforderlich, wenn Sie HAA für den eigenständigen Orchestrator verwenden.

Sie müssen den selbstständigen Orchestrator für die Verwendung von HAA konfigurieren und alle HAA-Knoten mit den Parametern LoadBalancer.UseRedis und LoadBalancer.Redis.ConnectionString zur Konfigurationsdatei des Orchestrators 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,abortConnect=false" />

Hinweis:

Sie können für die Redis-Clusterknoten im Parameter LoadBalancer.Redis.ConnectionString entweder IP-Adressen oder DNS-Datensätze verwenden.

Für Produktionsumgebungen ist die Verwendung von DNS-Datensätzen jedoch skalierbarer und empfohlen.

Weitere Informationen dazu finden Sie unter Konfigurieren von Cluster-DNS.

Konfigurieren von cluster_config.json

Wichtig:

Dieser Schritt ist nur erforderlich, wenn Sie HAA für die Automation Suite verwenden.

Um HAA verwenden zu können, müssen Sie Automation Suite durch Aktualisierung des Abschnitts fabric.redis in cluster_config.json Datei konfigurieren. Weitere Informationen dazu finden Sie unter Konfiguration des High Availability Add-onx.

Ü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 und überprüfen Sie, ob alle installierten Knoten mit dem Status OK angezeigt werden.

   

4. Wählen Sie die Registerkarte Datenbanken aus, und vergewissern Sie sich, dass die Datenbank uipath-orchestrator 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 an Port 8443.

   Zum 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 Einstellungen > Registerkarte Allgemein.

4. Geben Sie im Feld Clusterschlüssel Ihren Lizenzschlüssel ein.

5. Wählen Sie Speichern.

Ihr HAA-Cluster steht nun bereit, und Sie können mit der Installation von Orchestrator wie im Windows Installer beschrieben fortfahren.