Konfiguration des High Availability Add-ons

Automation Suite supports High Availability Add-on (HAA) installed either in the same cluster or on external machines.

Hinweis:

You must configure HAA to enable the actual HA setup for the multi-node setup. To do that, you can either provide the HAA license to the installer or install HAA on the external machines and give the HAA configurations to the installer.

Konfiguration des High Availability Add-ons im Cluster

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. Um die Auswirkungen eines Ausfalls oder Neustarts eines Cache-Knotens zu verringern, können Sie das High Availability Add-on (HAA) erwerben, das eine redundante, HA-fähige Produktionsbereitstellung des Cache 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. Purchase an HAA license. Contact UiPath® for details.
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 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, 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.

   
   

   

   
   

External High Availability Add-on configuration

Wenn Sie sich für eine Aktiv/Aktiv-Konfiguration der Automation Suite entscheiden, ist ein externes, im Cluster gehostetes Hochverfügbarkeits-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,
  }
}