- Überblick
- Anforderungen
- Bereitstellungsvorlagen
- Anleitung: Vorbereiten der Installation
- Anleitung: Vorbereiten der Installation
- Schritt 2: Konfigurieren der OCI-konformen Registrierung für Offline-Installationen
- Schritt 3: Konfigurieren des externen Objektspeichers
- Schritt 4: Konfigurieren des High Availability Add-on
- Schritt 5: Konfigurieren von SQL-Datenbanken
- Schritt 7: Konfigurieren des DNS
- Schritt 8: Konfigurieren der Datenträger
- Schritt 9: Konfigurieren der Einstellungen auf Kernel- und Betriebssystemebene
- Schritt 10: Konfigurieren der Knotenports
- Schritt 11: Anwenden verschiedener Einstellungen
- Schritt 12: Validieren und Installieren der erforderlichen RPM-Pakete
- Schritt 13: Generieren von cluster_config.json
- Cluster_config.json-Beispiel
- Allgemeine Konfiguration
- Profilkonfiguration
- Zertifikatkonfiguration
- Datenbankkonfiguration
- Konfiguration des externen Objektspeichers
- Vorsignierte URL-Konfiguration
- ArgoCD-Konfiguration
- Konfiguration der Kerberos-Authentifizierung
- Externe OCI-konforme Registrierungskonfiguration
- Disaster Recovery: Aktiv/Passiv- und Aktiv/Aktiv-Konfigurationen
- Konfiguration des High Availability Add-ons
- Spezifische Orchestrator-Konfiguration
- Insights-spezifische Konfiguration
- Process Mining-spezifische Konfiguration
- Spezifische Konfiguration für Document Understanding
- Spezifische Konfiguration für Automation Suite Robots
- Konfiguration der Überwachung
- Optional: Konfigurieren des Proxyservers
- Optional: Aktivieren der Widerstandsfähigkeit gegen zonale Ausfälle in einem HA-fähigen Produktionscluster mit mehreren Knoten
- Optional: Übergeben einer benutzerdefinierten resolv.conf-Datei
- Optional: Erhöhen der Fehlertoleranz
- Hinzufügen eines dedizierten Agent-Knotens mit GPU-Unterstützung
- Hinzufügen eines dedizierten Agentenknotens für Automation Suite-Roboter
- Schritt 15: Konfigurieren der temporären Docker-Registrierung für Offline-Installationen
- Schritt 16: Validieren der Voraussetzungen für die Installation
- Ausführen von uipathctl
- Manuell: Durchführen der Installation
- Nach der Installation
- Clusterverwaltung
- Verwalten von Produkten
- Erste Schritte mit dem Clusterverwaltungsportal
- Migrieren von Redis vom clusterinternen zum externen High Availability Add-on
- Clusterinterner Objectstore zu einem externen Objectstore migrieren
- Migrieren von der clusterinternen Registrierung zu einer externen OCI-konformen Registrierung
- Manueller Wechsel zum sekundären Cluster in einem Aktiv-/Passiv-Setup
- Disaster Recovery: Durchführen von Vorgängen nach der Installation
- Umwandlung einer bestehenden Installation in eine Multi-Site-Einrichtung
- Richtlinien zum Upgrade einer Aktiv/Passiv- oder Aktiv/Aktiv-Bereitstellung
- Leitlinien zum Sichern und Wiederherstellen einer Aktiv-/Passiv- oder Aktiv/Aktiv-Bereitstellung
- Skalieren einer Bereitstellung mit einem einzelnen Knoten (Auswertung) zu einer Bereitstellung mit mehreren Knoten (HA).
- Überwachung und Warnungen
- Migration und Upgrade
- Migrieren zwischen Automation Suite-Clustern
- Aktualisieren der Automation Suite
- Herunterladen der Installationspakete und Übertragen aller Dateien auf den ersten Serverknoten
- Abrufen der zuletzt angewendeten Konfiguration aus dem Cluster
- Aktualisieren der Clusterkonfiguration
- Konfigurieren der OCI-konformen Registrierung für Offline-Installationen
- Ausführen des Upgrades
- Durchführen von Vorgängen nach dem Upgrade
- Produktspezifische Konfiguration
- Erweiterte Orchestrator-Konfiguration
- Konfigurieren von Orchestrator-Parametern
- Konfigurieren von AppSettings
- Konfigurieren der maximalen Anforderungsgröße
- Überschreiben der Speicherkonfiguration auf Clusterebene
- Konfigurieren von NLog
- Speichern von Roboterprotokollen in Elasticsearch
- Konfigurieren von Anmeldeinformationsspeichern
- Konfigurieren der Verwendung von einem Verschlüsselungsschlüssel pro Mandant
- Bereinigen der Orchestrator-Datenbank
- Installation der Hostbibliothek überspringen
- Best Practices und Wartung
- Fehlersuche und ‑behebung
- Fehlerbehebung bei Diensten während der Installation
- So reduzieren Sie Berechtigungen für ein NFS-Sicherungsverzeichnis
- Deinstallieren des Clusters
- Löschen von Offline-Artefakten für mehr Speicherplatz
- So löschen Sie Redis-Daten
- So können Sie die Istio-Protokollierung aktivieren
- So werden Protokolle manuell bereinigt
- Verschieben von Ceph aus dem schreibgeschützten Modus
- So löschen Sie alte Protokolle, die im sf-logs-Bucket gespeichert sind
- So deaktivieren Sie Streaming-Protokolle für das AI Center
- Fehlerbehebung bei fehlgeschlagenen Automation Suite-Installationen
- So löschen Sie Bilder aus dem alten Installationsprogramm nach dem Upgrade
- Deaktivieren von TX-Prüfsummen-Offloading
- So legen Sie die ArgoCD-Protokollebene manuell auf Info fest
- So erweitern Sie den AI Center-Speicher
- So wird der codierte pull_secret_value für externe Registrierungen generiert
- Umgang mit schwachen Verschlüsselungen in TLS 1.2
- So überprüfen Sie die TLS-Version
- So arbeiten Sie mit Zertifikaten
- So planen Sie die Ceph-Sicherung und Wiederherstellung von Daten
- Sammeln von DU-Nutzungsdaten mit dem clusterinternen Objektspeicher (Ceph)
- So installieren Sie RKE2 SELinux in Air-Gap-Umgebungen
- So löschen Sie alte differenzielle Sicherungen auf einem NFS-Server
- So stellen Sie Insights in einem FIPS-fähigen Cluster bereit
- So migrieren Sie zu cgroup v2
- So stellen Sie die Kerberos-Authentifizierung nach einem VM-Neustart wieder her
- So pushen Sie ein lokales Docker-Image in die Registrierung innerhalb des Clusters
- So schließen Sie Buckets von der Sicherung aus
- Fehler beim Herunterladen des Pakets
- Die Offlineinstallation schlägt aufgrund fehlender binärer Dateien fehl
- Azure-Datenträger nicht als SSD markiert
- Fehler nach der Zertifikatsaktualisierung
- Validierungsfehler beim TLS-Zertifikat
- Virenschutz verursacht Probleme bei der Installation
- Automation Suite funktioniert nach Betriebssystem-Upgrade nicht
- Bei der Automation Suite muss „backlog_wait_time“ auf 0 gesetzt werden.
- Die temporäre Registrierungsinstallation schlägt unter RHEL 8.9 fehl
- Häufiges Neustartproblem bei UiPath-Namespace-Bereitstellungen während Offline-Installationen
- DNS-Einstellungen werden von CoreDNS nicht berücksichtigt
- Das Seeding der Registrierung innerhalb des Clusters schlägt aufgrund von unzureichendem Speicher fehl
- Voraussetzungsprüfungen schlagen fehl, wenn moderne Document Understanding-Projekte aktiviert und AI Center deaktiviert ist
- Pods hängen im Init-Status fest, da ein Fehler bei der Bereitstellung des XFS-Volumes auf RHEL 8.x-Knoten fehlgeschlagen ist
- Clusterdaten scheinen nach einem Neustart aufgrund einer falschen Bereitstellungsreihenfolge von Rancher und etcd verloren zu gehen
- Upgrade schlägt aufgrund eines fehlerhaften Ceph . fehl
- Upgrade schlägt aufgrund von klassischen Objekten in der Orchestrator-Datenbank fehl
- Ceph-Cluster in beeinträchtigtem Status nach parallelem Upgrade
- Dienst-Upgrade schlägt für Apps fehl
- Timeouts beim direkten Upgrade
- Upgrade schlägt in Offline-Umgebungen fehl
- Snapshot-controller-crds Pod im Status CrashLoopBackOff nach dem Upgrade
- Upgrade schlägt aufgrund überschriebener Insights-PVC-Größen fehl
- Upgradefehler aufgrund von Hostnamen in Großbuchstaben
- Festlegen eines Timeout-Intervalls für die Verwaltungsportale
- Die Authentifizierung funktioniert nach der Migration nicht
- kinit: KDC kann für Realm <AD Domain> beim Abrufen der ersten Anmeldeinformationen nicht gefunden werden
- Kinit: Keytab enthält keine geeigneten Schlüssel für *** beim Abrufen der ersten Anmeldeinformationen
- GSSAPI-Vorgang aufgrund eines ungültigen Statuscodes fehlgeschlagen
- Alarm für fehlgeschlagenen Kerberos-tgt-update-Auftrag erhalten
- SSPI-Anbieter: Server in Kerberos-Datenbank nicht gefunden
- Anmeldung eines AD-Benutzers aufgrund eines deaktivierten Kontos fehlgeschlagen
- ArgoCD-Anmeldung fehlgeschlagen
- Fehler beim Abrufen des Sandbox-Abbilds
- Pods werden nicht in der ArgoCD-Benutzeroberfläche angezeigt
- Redis-Testfehler
- RKE2-Server kann nicht gestartet werden
- ArgoCD wechselt nach der ersten Installation in den Status „In Bearbeitung“.
- ArgoCD-Repository-Server-Pod in „CrashLoopBackOff“.
- Manuelle Schadensbegrenzung bei ArgoCD NetworkPolicy (GHSA-47m3-95c7-g2g8)
- Fehlende Ceph-rook-Metriken in Überwachungs-Dashboards
- Diskrepanz bei gemeldeten Fehlern bei diagnostischen Zustandsprüfungen
- Konfigurieren von Ressourcenanforderungen und Limits für von uipathctl erstellte Workloads
- Kein normales Upstream-Problem
- Redis-Start wird durch Antivirenprogramm blockiert
- AI Center und Document Understanding Pods können bei aktivierter TLS-Zertifikatsverifizierung nicht gestartet werden
- Fluentd exportiert keine Protokolle in IPv6-Umgebungen
- Studio Desktop kann keine Integration Service-Connectors und -Aktivitäten laden
- Document Understanding erscheint nicht auf der linken Leiste der Automation Suite
- Fehlerstatus beim Erstellen einer Datenbeschriftungssitzung
- Fehlerstatus beim Versuch, eine ML-Fähigkeit bereitzustellen
- Migrationsauftrag schlägt in ArgoCD fehl
- Die Handschrifterkennung mit dem Intelligent Form Extractor funktioniert nicht oder arbeitet zu langsam
- Ausführen von Hochverfügbarkeit mit Process Mining
- Die Process Mining-Datenaufnahme ist bei der Anmeldung über Kerberos fehlgeschlagen
- Verbindung mit der Datenbank „AutomationSuite_ProcessMining_Lager“ über eine Verbindungszeichenfolge im pyodbc-Format nicht möglich
- Die Airflow-Installation schlägt mit „sqlaldemy.exc.ArgumentError“ fehl: URL konnte nicht analysiert werden rfc1738 aus Zeichenfolge „
- So fügen Sie eine IP-Tabellenregel hinzu, um den SQL Server-Port 1433 zu verwenden
- Dem Automation Suite-Zertifikat des Servers, auf dem CData Sync ausgeführt wird, wird nicht vertraut
- Process Mining kann nach dem Deaktivieren und erneuten Aktivieren nicht geladen werden
- Ausführen des Diagnosetools
- Verwenden des Automation Suite-Supportpakets
- Erkunden von Protokollen
Hinzufügen eines dedizierten Agentenknotens für Automation Suite-Roboter
Fügen Sie einen dedizierten Agentknoten für Automation Suite Robots hinzu, um Roboter-Workloads von anderen Clusterdiensten zu trennen.
Anforderungen
Stellen Sie vor dem Starten der Installation des Automation Suite-Roboters sicher, dass Sie die Hardwareanforderungen erfüllen.
-
Bei einer Evaluierungsinstallation mit einem einzelnen Knoten werden Automation Suite-Roboter auf dem Hauptserverknoten ausgeführt. Zwischengespeicherte Pakete werden auf dem Dateisystem des Hauptknotens in einem Ordner gespeichert, den das interaktive Installationsprogramm automatisch bereitstellt. Das Hinzufügen eines dedizierten Agentknotens für Automation Suite-Roboter ist bei Evaluierungsinstallationen mit einem einzelnen Knoten optional.
Hinweis:Bei einer Evaluierungsinstallation mit einem einzelnen Knoten ist die Anzahl der gleichzeitigen serverlosen Aufträge auf 5 begrenzt.
-
In a multi-node HA-ready production environment, adding a dedicated node for Automation Suite Robots is mandatory. For details on the requirements the dedicated node must meet, refer to Hardware and software requirements.
Hinweis:Bei einer HA-fähigen Produktionsinstallation mit mehreren Knoten wird die maximale Anzahl gleichzeitiger serverloser Aufträge durch die Ressourcen des Knotens bestimmt.
-
Für das Caching von Paketen sind mindestens 10 GB erforderlich.
Hinzufügen eines Automation Suite-Agentknotens zum Cluster
Die folgenden Abschnitte enthalten Anweisungen zum Hinzufügen eines dedizierten Agentenknotens für Automation Suite-Roboter.
Schritt 1: Konfigurieren der Maschine
Schritt 1.1: Partitionieren der Festplatte
To ensure the disk is partitioned correctly, refer to Configuring the disks. Make sure to follow the steps for agent nodes.
Schritt 1.2: Konfigurieren des Datenträgers für die Paketzwischenspeicherung
Option A
Wenn Sie die Paketzwischenspeicherung während der Installation aktiviert haben, müssen Sie einen Ordner im Dateisystem der Hostmaschine am Speicherort /uipath_asrobots_package_cache oder im benutzerdefinierten Pfad bereitstellen, der über cluster_config.json/packagecachefolder konfiguriert wurde. Der Ordner muss über mindestens 10 GB freien Speicherplatz verfügen, andernfalls schlägt die Installation fehl.
Option B
Alternativ können Sie einen separaten Datenträger für das configureUiPathDisks -Skript bereitstellen, das den Datenträger und den Pfad konfigurieren kann:
./bin/uipathctl rke2 disk --robot-package-disk-name [DISKNAME] --robot-package-path /uipath_asrobots_package_cache
./bin/uipathctl rke2 disk --robot-package-disk-name [DISKNAME] --robot-package-path /uipath_asrobots_package_cache
Der Parameter --robot-package-path ist optional. Wenn nicht festgelegt, wird der Parameter standardmäßig auf /uipath_asrobots_package_cache festgelegt. Wenn Sie den Standardwert von cluster_config.json/packagecachefolder ändern, stellen Sie sicher, dass der an den Parameter --robot-package-path übergebene Wert mit dem konfigurierten Wert übereinstimmt.
Schritt 1.3: Konfigurieren des Knotens für serverlose Roboter
Beim Konfigurieren eines Knotens für serverlose Roboter hängt das Setup davon ab, wie der Knoten zum Cluster hinzugefügt wird:
Option A: Fügen Sie einen dedizierten ASR-Knoten hinzu
Wenn Sie dem Cluster einen neuen Knoten als dedizierten ASR-Knoten hinzufügen, werden die erforderlichen Beschriftungen und Markierungen automatisch angewendet. Führen Sie den folgenden Befehl aus:
./bin/uipathctl rke2 install -i ./cluster_config.json -o ./output.json -k -j asrobots --accept-license-agreement
./bin/uipathctl rke2 install -i ./cluster_config.json -o ./output.json -k -j asrobots --accept-license-agreement
Der Befehl fügt automatisch Folgendes hinzu:
- Taint:
serverless.robot=present:NoSchedule - Beschriftungen:
serverless.robot=trueundserverless.daemon=true
Option B: Einen vorhandenen Agent-Knoten verwenden
Wenn Sie einen bereits konfigurierten Agent-Knoten (nicht standardmäßig als ASR konfiguriert) umfunktionieren möchten, müssen Sie die Beschriftungen und Markierungen manuell hinzufügen und den Paket-Cache-Datenträger konfigurieren. Führen Sie die folgenden Befehle aus, um den Knoten manuell zu konfigurieren:
-
Fügen Sie eine Markierung für serverlose Roboter hinzu:
kubectl taint nodes [NODE_NAME] serverless.robot=present:NoSchedulekubectl taint nodes [NODE_NAME] serverless.robot=present:NoSchedule -
Fügen Sie die Beschriftungen für serverlose Roboter hinzu:
kubectl label nodes [NODE_NAME] serverless.robot=true serverless.daemon=truekubectl label nodes [NODE_NAME] serverless.robot=true serverless.daemon=true
Schritt 2: Kopieren des interaktiven Installationsprogramms auf die Zielmaschine
Führen Sie die folgenden Schritte aus, um das interaktive Installationsprogramm auf die Zielmaschine zu kopieren:
-
Verbinden Sie sich per SSH mit der richtigen Maschine:
- Wenn Sie Automation Suite-Roboter zu einer Evaluierungsinstallation mit einem einzelnen Knoten hinzugefügt haben, wechseln Sie zur Hauptmaschine.
- Wenn Sie Automation Suite-Roboter zu einer HA-fähigen Produktionsinstallation mit mehreren Knoten hinzugefügt haben, wechseln Sie zu einem der Serverknoten.
-
Kopieren Sie den Inhalt des Ordners
UiPathAutomationSuitein den Knoten Automation Suite Robots. Stellen Sie sicher, dass Sie den Benutzernamen und das DNS verwenden, die für den Automation Suite-Roboterknoten spezifisch sind.sudo su - scp -r /opt/UiPathAutomationSuite <username>@<node dns>:/opt/ scp -r ~/* <username>@<node dns>:/opt/UiPathAutomationSuite/sudo su - scp -r /opt/UiPathAutomationSuite <username>@<node dns>:/opt/ scp -r ~/* <username>@<node dns>:/opt/UiPathAutomationSuite/
Schritt 3: Ausführen des interaktiven Installationsprogramms zum Konfigurieren des dedizierten Knotens
Führen Sie die folgenden Schritte aus, um den spezifischen Knoten zu konfigurieren:
-
SSH mit dem Automation Suite-Roboterknoten.
-
Führen Sie das interaktive Installationsprogramm der Automation Suite aus.
sudo su - cd /opt/UiPathAutomationSuite yum install unzip jq -y CONFIG_PATH=/opt/UiPathAutomationSuite/cluster_config.json ./bin/uipathctl rke2 install -i ./cluster_config.json -o ./output.json -k -j asrobots --accept-license-agreementsudo su - cd /opt/UiPathAutomationSuite yum install unzip jq -y CONFIG_PATH=/opt/UiPathAutomationSuite/cluster_config.json ./bin/uipathctl rke2 install -i ./cluster_config.json -o ./output.json -k -j asrobots --accept-license-agreement
Schritt 4: Aktivieren von Kubectl
Um den kubectl-Kontext auf der Automation Suite Robots-Maschine festzulegen, führen Sie den folgenden Befehl aus:
sudo su -
export KUBECONFIG=/var/lib/rancher/rke2/agent/kubelet.kubeconfig
export PATH=$PATH:/var/lib/rancher/rke2/bin
kubectl get nodes
sudo su -
export KUBECONFIG=/var/lib/rancher/rke2/agent/kubelet.kubeconfig
export PATH=$PATH:/var/lib/rancher/rke2/bin
kubectl get nodes
Sie sollten die Knoten und ihre entsprechenden Namen sehen. Für den nächsten Schritt benötigen Sie den Namen des Automation Suite-Roboterknotens.
Schritt 5: Überprüfen der Automation Suite-Roboterkonfiguration
Überprüfen Sie, ob der Knoten Automation Suite Robots konfiguriert ist. Stellen Sie sicher, dass Sie <node name> durch den Knotennamen der Automation Suite-Roboter ersetzen.
kubectl describe node <node name> | grep -i "taints"
kubectl describe node <node name> | grep -i "taints"
Der Befehl sollte die folgende Ausgabe zurückgeben:
$ kubectl describe node asrobots0 | grep -i "taints"
Taints: serverless.robot=present:NoSchedule
$ kubectl describe node asrobots0 | grep -i "taints"
Taints: serverless.robot=present:NoSchedule
Zu diesem Zeitpunkt haben Sie die Installation für Automation Suite-Roboter erfolgreich abgeschlossen.
- Anforderungen
- Hinzufügen eines Automation Suite-Agentknotens zum Cluster
- Schritt 1: Konfigurieren der Maschine
- Schritt 2: Kopieren des interaktiven Installationsprogramms auf die Zielmaschine
- Schritt 3: Ausführen des interaktiven Installationsprogramms zum Konfigurieren des dedizierten Knotens
- Schritt 4: Aktivieren von Kubectl
- Schritt 5: Überprüfen der Automation Suite-Roboterkonfiguration