Konfigurieren des FQDN nach der Installation

Um den FQDN der Automation Suite zu ändern, müssen Sie die cluster_config.json-Datei aktualisieren und das uipathctl -Installationsprogramm ausführen.

Der FQDN-Aktualisierungsprozess gilt sowohl für den Auswertungsmodus mit einem Knoten als auch für den HA-fähigen Produktionsmodus mit mehreren Knoten.

Hinweis:

Das Ändern des FQDN erfordert auch neue Serverzertifikate. Wenn kein neues Zertifikat verfügbar ist, haben Sie zwei Optionen: Entweder fahren Sie mit dem neuen, selbstsignierten Zertifikat fort, das vom Installationsprogramm automatisch konfiguriert wurde, oder Sie beenden die Installation und fügen ein neues Zertifikat der Zertifizierungsstelle ein.

Sie können das Zertifikat über das Feld server_certificate in der Datei cluster_config.jsonkonfigurieren.

Aktualisieren der Konfigurationsdatei mit dem neuen FQDN-Wert

Sie müssen die folgenden Parameter in der input.json-Datei aktualisieren. Je nach Ihren Anforderungen ist jede Kombination dieser Werte zulässig.

• fqdn – Überschreiben Sie dieses Feld mit dem neuen FQDN, den Sie brauchen, um auf den Cluster zuzugreifen.
  Hinweis: Wir unterstützen nur FQDNs in Kleinbuchstaben. Verwenden Sie keine Großbuchstaben in Ihrem FQDN.
• fixed_rke_address – Wenn dieser Wert identisch mit dem Feld fqdn in cluster_config.jsonist, müssen Sie sicherstellen, dass die beiden Werte übereinstimmen, um den neuen FQDN widerzuspiegeln.

  Bei einem Aktiv/Passiv- oder Aktiv/Aktiv-Setup muss dieser Wert mit cluster_fqdn übereinstimmen.

• cluster_fqdn – Aktualisieren Sie dieses Feld für den Aktiv/Passiv- oder Aktiv/Aktiv-Cluster.
  Hinweis:

  cluster_fqdn -Aktualisierung ist erforderlich, wenn Sie die DNS-Konfigurationen auf Lastausgleichsebene für einen der Cluster ändern

Das folgende Beispiel zeigt die cluster_config.json-Konfiguration, die zum Aktualisieren des FQDN erforderlich ist.

{
  "fqdn": "new-automationsuite.mycompany.com" //this is the fqdn for accessing the automation suite cluster
  "fixed_rke2_address": "new-automationsuite.mycompany.com,"//this is only required for the node joining, if customer wish to change "cluster_fqdn": "new-primary-automationsuite.mycompany.com" //this is only required for the a/p or a/a cluster
}

Schritt 1: Aktualisieren des FQDN auf Infrastrukturebene

Um den FQDN auf Infrastrukturebene zu ändern, führen Sie das Installationsprogramm nur auf der ersten Servermaschine aus. Dadurch werden alle anderen Knoten im Cluster aktualisiert, einschließlich der verbleibenden Serverknoten, Agent-Knoten und spezialisierten Agent-Knoten.

Um den FQDN zu ändern, führen Sie den folgenden Befehl aus:

./bin/uipathctl rke2 update-fqdn -i /path/to/cluster_config.json --versions versions/helm-charts.json

Hinweis:

Wenn Sie den Befehl mit dem Flag --force ausführen, überschreibt er die Warnaufforderungen und führt die FQDN-Änderungen direkt aus.

Das Installationsprogramm warnt Sie vor den Folgen der Aktualisierung des FQDN. Es fragt nach der Bestätigung, bevor sie fortfahren.

[WARN]  You are about to change the FQDN of the Automation Suite Cluster.
        Changing the fqdn is a disruptive operation, and it will result in 
        disconnecting your robots, mobile orchestrator users, ML Activities, 
        and ML Skills and invalidating any pending user invites. 
        
        If you wish to continue type 'yes' and hit enter to continue.

Schritt 2: Aktualisieren des FQDN auf Komponenten- und Dienstebene

Um den FQDN zu ändern, führen Sie den folgenden Befehl aus:

./bin/uipathctl manifest apply /path/to/cluster_config.json --versions versions/helm-charts.json 

Hinweis:

Wenn Sie den Befehl mit dem Flag --force ausführen, überschreibt er die Warnaufforderungen und führt die FQDN-Änderungen direkt aus.

Das Installationsprogramm warnt Sie vor den Folgen der Aktualisierung des FQDN. Es fragt nach der Bestätigung, bevor sie fortfahren.

[WARN]  You are about to change the FQDN of the Automation Suite Cluster.
        Changing the fqdn is a disruptive operation, and it will result in 
        disconnecting your robots, mobile orchestrator users, ML Activities, 
        and ML Skills and invalidating any pending user invites. 
        If you wish to continue type 'yes' and hit enter to continue.

Das Installationsprogramm warnt Sie auch, wenn kein neues gültiges Zertifikat im Zusammenhang mit dem FQDN vorhanden ist. Wenn die Zertifikatsvalidierung fehlschlägt, müssen Sie das neue, von der Zertifizierungsstelle ausgestellte Zertifikat bereitstellen oder mit dem neuen, selbstsignierten Zertifikat fortfahren.

************************************************************************************
[ERROR] Validating certificate... Failed
[ERROR] Certificate doesn't have new-automationsuite.mycompany.com in the SAN
************************************************************************************

Certificate provided is invalid for the new fqdn, would you like us to configure the new self signed certificate?
If you wish to continue type `yes` and hit enter to continue.

Hinweis:

Stellen Sie sicher, dass Sie alle Daten aus Ihrer Redis-Datenbank löschen. Sie können dies tun, indem Sie den BefehlFLUSHALL ausführen.

Aktualisieren des FQDN in einer Aktiv/Aktiv-Bereitstellung

Wenn Sie den FQDN des primären Clusters in einem Aktiv/Aktiv-Setup ändern, müssen Sie die folgenden zusätzlichen Schritte ausführen:

1. Generieren Sie eine neue kubeconfig für den primären Cluster.
2. Fügen Sie die neue kubeconfig in der cluster_config.json des sekundären Clusters unter other_kube_config hinzu.
3. Führen Sie auf dem sekundären Cluster den folgenden Befehl aus:

   uipathctl manifest apply cluster_config.json --versions versions/helm-charts.json