High Availability Add-on – Installationshandbuch

Letzte Aktualisierung 22. Aug. 2024

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 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 finden Sie unter Installation der Active/Active Disaster Recovery.

Bevor Sie mit Ihrer HAA-Installation fortfahren, stellen Sie sicher, dass Sie die Anforderungen 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 -asudo 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 wgetyum 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 -alocalectllocale -alocalectl
    localectllocalectl
  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"$ export LANG="en_US.utf8"

Schnelle Installation

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:

SSH für den primären Knoten mit Stammberechtigungen.
Erstellen Sie das Verzeichnis, in das HAA heruntergeladen und extrahiert werden soll, z. B.:
```
mkdir haamkdir haa
```
Laden Sie das Installationsskript get-haa.sh herunter:
```
wget https://download.uipath.com/haa/get-haa.shwget https://download.uipath.com/haa/get-haa.sh
```
Hinweis: Weitere Informationen finden Sie im Abschnitt.
Machen Sie das Skript get-haa.sh ausführbar:
```
chmod a+x get-haa.shchmod a+x get-haa.sh
```
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 get-haa.sh -h aus und notieren Sie sich den entsprechenden Betriebssystemwert im Hilfemenü.
Die möglichen Betriebssystemwerte sind derzeit Rhel8, Rhel9 oder UbuntuFocal.
```
sudo ./get-haa.sh -u <email> -p <password> -o <OS> --accept-license-agreementsudo ./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:

SSH für den sekundären Knoten mit Stammberechtigungen.
Erstellen Sie das Verzeichnis, in das HAA heruntergeladen und extrahiert werden soll, z. B.:
```
mkdir haamkdir haa
```
Wechseln Sie in das neu erstellte Verzeichnis:
```
cd /<path-to>/haa/cd /<path-to>/haa/
```
Laden Sie das Installationsskript get-haa.sh herunter:
```
wget https://download.uipath.com/haa/get-haa.shwget https://download.uipath.com/haa/get-haa.sh
```
Hinweis: Weitere Informationen finden Sie im Abschnitt.
Machen Sie das Skript get-haa.sh ausführbar:
```
chmod a+x get-haa.shchmod a+x get-haa.sh
```
Installieren Sie den sekundären Knoten:
Hinweis: Um Ihr Betriebssystem beim Ausführen des Installationsbefehls im richtigen Format einzugeben, führen Sie zuerst get-haa.sh -h aus und notieren Sie sich den entsprechenden Betriebssystemwert im Hilfemenü.
Die möglichen Betriebssystemwerte sind derzeit Rhel8, Rhel9 oder UbuntuFocal.
```
sudo ./get-haa.sh -u <email> -p <password> -o <OS> -j <IP_address_of_the_master_node> --accept-license-agreementsudo ./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

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

Parameter	Beschreibung
`-u`	Der Benutzername des HAA-Clusteradministrators. Beispiel: `-u documentation@uipath.com`.
`-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). 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-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" /><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" />

Konfigurieren von cluster_config.json

Wichtig:

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

Sie müssen die Automation Suite für die Verwendung von HAA konfigurieren, indem Sie den Abschnitt fabric.redis in der Datei cluster_config.json aktualisieren. Weitere Informationen finden Sie unter Konfiguration des High Availability Add-ons.

Überprüfen der Clusterinstallation

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

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.
Geben Sie den Benutzernamen und das Kennwort ein, die während der Installation angegeben wurden, um sich anzumelden.
Wählen Sie die Registerkarte Knoten aus, und stellen Sie sicher, dass alle installierten Knoten hier mit dem Status OK angezeigt werden.
Wählen Sie die Registerkarte Datenbanken aus, und vergewissern Sie sich, dass die Datenbank uipath-orchestrator hier mit dem Status OK angezeigt wird.
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:

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