Aktivieren eines High Availability Add-ons für den 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. 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 Fabric-Installationsprogramm erneut aus:
   • Onlineinstallation

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

   • Offline-Installation

     ./install-uipath.sh -i cluster_config.json -f --install-type offline -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.