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. In der Bash können Sie dies mit echo 'license_text_here' | base64 -w0 tun.
   • 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
         }
     }

3. Führen Sie das Installationsprogramm erneut aus:

   ./bin/uipathctl manifest apply /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json

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, klicken Sie selbst auf die Schaltfläche Synchronisierung. 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. Hinweis: Wenn ein Zertifikat erforderlich ist, wenn TLS aktiviert ist, stellen Sie sicher, dass Sie es über das Flag additional_ca_certs bereitstellen. Weitere Informationen finden Sie unter Zertifikatkonfiguration.

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