Konfiguration des High Availability Add-ons

Die Automation Suite unterstützt das High Availability Add-on (HAA), das entweder im selben Cluster oder auf externen Maschinen installiert ist.

Hinweis:

Sie müssen HAA konfigurieren, um das eigentliche HA-Setup für das Setup mit mehreren Knoten zu aktivieren. Dazu können Sie dem Installationsprogramm entweder die HAA-Lizenz zur Verfügung stellen oder HAA auf den externen Maschinen installieren und die HAA-Konfigurationen zum Installationsprogramm übergeben.

Konfiguration des Redis High Availability Add-ons innerhalb des Clusters

Bei einer HA-fähigen Produktionseinrichtung mit mehreren Knoten ist standardmäßig Hochverfügbarkeit (HA) aktiviert. Die Redis-basierte Zwischenspeicherung im Arbeitsspeicher, die von Clusterdiensten verwendet wird, läuft jedoch auf einem einzelnen Knoten und gefährdet bei einem Ausfall das gesamte System. Wenn Sie keine HAA-Lizenz (High Availability Add-on) erworben haben, führt ein Ausfall des Cache-Knotens oder ein Neustart zu einer Ausfallzeit für den gesamten Cluster. Um einem solchen Vorfall vorzubeugen, können Sie HAA erwerben, das eine redundante, HA-fähige Produktionsbereitstellung des Caches mit mehreren Knoten ermöglicht.

Hinweis:

Zu allen Installationen gehört die HAA-Software mit einer Einzelknotenlizenz. Diese Lizenz ist kostenlos – kein Kauf erforderlich.

Wenn Sie die HAA über mehrere Knoten hinweg aktivieren möchten, ist der Kauf einer HAA-Lizenz erforderlich. Dadurch wird eine vollständige Hochverfügbarkeit für den Cluster in einer HA-fähigen Produktionseinrichtung mit mehreren Knoten implementiert.

Die HAA basiert auf der Redis-Technologie.

Führen Sie dazu die folgenden Schritte aus:

1. Kaufen Sie eine HAA-Lizenz. Wenden Sie sich an UiPath®, um weitere Informationen zu erhalten.
2. Aktualisieren Sie die folgenden Felder in der cluster_config.json-Datei:
   • fabric.redis.license – Geben Sie die HAA-Lizenz ein, die in einen einzelnen Base64-String konvertiert wurde. Sie müssen den gesamten Lizenzschlüssel, einschließlich des Texts -----LICENSE START----- and -----LICENSE END-----, in Base64 codieren. In der Bash können Sie dies mit dem folgenden Befehl tun:

     echo '-----LICENSE START-----<license_key_here>-----LICENSE END-----' | base64 -w0
     

   • fabric.redis.ha – Nutzen Sie true, um die HAA zu aktivieren und stellen Sie sicher, dass Sie auch den Parameter fabric.redis.license konfigurieren. Dies ermöglicht die HAA-Datenbankreplikation und erhöht die Anzahl der HAA-Pods auf 3. Standardmäßig ist fabric.redis.ha auf false festgelegt.
     Hinweis:

     Wenn redis.ha aktiviert ist, muss redis.license auf eine Lizenz festgelegt werden, die mehr als zwei Shards unterstützt.

     "fabric": {
         "redis": { 
             "ha": "true",
             "license": "Base64String" // Replace Base64String with the encoded full license string.
         }
     }
     

3. Führen Sie das Fabric-Installationsprogramm erneut aus:

   ./install-uipath.sh -i cluster_config.json -f -o output.json --accept-license-agreement
   

Aktualisieren der Redis-Lizenz

Führen Sie die folgenden Schritte aus, um die Redis-Lizenz zu aktualisieren:

1. Richten Sie den kubectl- und ArgoCD-Zugriff ein:

   1. Aktivieren Sie den kubectl-Zugriff auf dem primären Knoten. Anweisungen finden Sie unter Aktivieren von kubectl .
   2. Aktivieren Sie den Zugriff auf ArgoCD. Anweisungen finden Sie unter Zugreifen auf ArgoCD .

2. Überprüfen Sie den aktuellen Lizenzstatus:

   Um den Status der aktuellen Lizenz zu überprüfen, führen Sie den folgenden Shell-Befehl aus:

   kubectl get rec -n redis-system redis-cluster -o jsonpath='{.status.licenseStatus}' | jq
   

   • Cluster, die nach dem Ablaufdatum der im Installationsprogramm enthaltenen Lizenz bereitgestellt werden, zeigen die 4-Shard-Testlizenz, die in 30 Tagen abläuft, wie im folgenden Beispiel:

   

   • Cluster, die bereits ausgeführt wurden, als die Lizenz abgelaufen war, zeigen den folgenden Status an:

   

3. Aktualisieren Sie die vorhandene Lizenz:

   1. Um die vorhandene Lizenz zu aktualisieren, führen Sie den folgenden Shell-Befehl aus:

      kubectl patch application fabric-installer -n argocd \
      --type=json -p '[{"op":"add","path":"/spec/source/helm/parameters/-","value":{"name": "global.redis.license", "value": "<LICENSE_KEY_IN_BASE64>"}}]'
      

      

   2. Um festzustellen, ob die Änderung angewendet wurde, greifen Sie auf ArgoCD zu. Anweisungen finden Sie unter Zugreifen auf ArgoCD .

   3. Wenn die Fabric-Installer- Anwendung nicht synchronisiert ist und der Synchronisierungsvorgang nicht automatisch ausgelöst wurde, wählen Sie selbst die Schaltfläche Synchronisierung aus. Dies kann passieren, wenn Sie eine ältere Automation Suite-Version verwenden.

      

      

      

      Hinweis:

      Es gibt eine kleine Verzögerung zwischen dem Moment, in dem die ArgoCD-Benutzeroberfläche die synchronisierte Anwendung anzeigt, und dem Moment, in dem der Redis-Operator die neue Lizenz erfolgreich anwendet.

   4. Um Protokolle vom Redis-Operator anzuzeigen, wenn er versucht, die Lizenz anzuwenden, führen Sie den folgenden Befehl aus:

      kubectl logs -n redis-system --since=300s -l name=redis-enterprise-operator -c redis-enterprise-operator --tail=-1 | grep license
      

      

   5. Wenn Sie versuchen, eine abgelaufene Lizenz anzuwenden oder das Installationsprogramm ausführen, das mit einer abgelaufenen Lizenz ausgeliefert wird, erhalten Sie die folgende Ausgabe:

      

   6. Um die Redis-Lizenz zu aktualisieren, die von älteren Installationsprogrammen verwendet wurde, bevor Sie sie ausführen, aktualisieren Sie den fabric.redis.license-Schlüssel in <installer_folder>/defaults.json:

      

4. Überprüfen Sie, ob die neue Lizenz angewendet wird:

   Führen Sie den folgenden Shell-Befehl aus, um zu überprüfen, ob die neue Lizenz angewendet wird:

   kubectl get rec -n redis-system redis-cluster -o jsonpath='{.status.licenseStatus}' | jq
   

   In der folgenden Abbildung sehen Sie, dass der Redis-Cluster von der 30-Tage-Testlizenz zu einer 10-Jahres-Lizenz mit Einzel-Shard gewechselt hat.

   

Konfiguration eines externen High Availability Add-ons

Wenn Sie sich für eine Aktiv/Aktiv-Konfiguration der Automation Suite entscheiden, ist ein externes, im Cluster gehostetes High Availability Add-on obligatorisch. In allen anderen Situationen ist dies lediglich optional.

Um das High Availability Add-on zu konfigurieren, müssen Sie die folgenden Parameter in der Datei cluster_config.json aktualisieren:

Parameter	Beschreibung
fabric.redis.hostname	Geben Sie den FQDN des HAA-Servers (High Availability Add-on) an.
fabric.redis.password	Geben Sie das Kennwort an, um eine Verbindung mit dem HAA-Server herzustellen.
fabric.redis.port	Geben Sie den Port für den HAA-Server an.
fabric.redis.tls	Aktivieren Sie das TLS-Protokoll. Standardmäßig ist TLS aktiviert. Wenn bei aktiviertem TLS ein Zertifikat erforderlich ist, stellen Sie sicher, dass Sie es über das Flag additional_ca_certs bereitstellen. Weitere Informationen dazu finden Sie unter Zertifikatkonfiguration.

"fabric": {
  "redis": {
    "hostname": "redis_fqdn",
    "password": "credential_to_connect_redis",
    "port": 6380,
    "tls": true,
  }
}