automation-suite
2024.10
true
- Überblick
- Anforderungen
- Bereitstellungsvorlagen
- Anleitung: Vorbereiten der Installation
- Anleitung: Vorbereiten der Installation
- Schritt 1: Konfigurieren der OCI-konformen Registrierung für Offline-Installationen
- Schritt 2: Konfigurieren des externen Objektspeichers
- Schritt 3: Konfigurieren eines High Availability Add-ons
- Schritt 4: Konfigurieren der SQL-Datenbanken
- Schritt 5: Konfigurieren des Lastausgleichs
- Schritt 6: Konfigurieren des DNS
- Schritt 7: Konfigurieren der Datenträger
- Schritt 8: Konfigurieren der Einstellungen auf Kernel- und Betriebssystemebene
- Schritt 9: Konfigurieren der Knotenports
- Schritt 10: Anwenden verschiedener Einstellungen
- Schritt 12: Validieren und Installieren der erforderlichen RPM-Pakete
- Cluster_config.json-Beispiel
- Allgemeine Konfiguration
- Profilkonfiguration
- Zertifikatkonfiguration
- Datenbankkonfiguration
- Konfiguration des externen Objektspeichers
- Vorsignierte URL-Konfiguration
- ArgoCD-Konfiguration
- 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
- AI Center-spezifische Konfiguration
- 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 Agent-Knotens für Task Mining
- Verbinden einer Task Mining-Anwendung
- 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
- Manuell: Durchführen der Installation
- Nach der Installation
- Clusterverwaltung
- Verwalten von Produkten
- Erste Schritte mit dem Clusterverwaltungsportal
- Migrieren von Objectstore von persistentem Volume zu Raw-Festplatten
- Migrieren vom clusterinternen zum externen High Availability Add-on
- Migrieren von Daten zwischen Objectstores
- Clusterinterner Objectstore zu einem externen Objectstore migrieren
- Migrieren 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 von eigenständigen Produkten zur Automation Suite
- Schritt 1: Wiederherstellen der eigenständigen Produktdatenbank
- Schritt 2: Aktualisieren des Schemas der wiederhergestellten Produktdatenbank
- Schritt 3: Verschieben der Identitätsorganisationsdaten von der eigenständigen Bereitstellung in die Automation Suite
- Schritt 4: Sichern der Plattformdatenbank in der Automation Suite
- Schritt 5: Zusammenführen von Organisationen in der Automation Suite
- Schritt 6: Aktualisieren der migrierten Produktverbindungszeichenfolgen
- Schritt 7: Migrieren des eigenständigen Orchestrator
- Schritt 8: Migrieren von eigenständigen Insights
- Schritt 9: Löschen des Standardmandanten
- Durchführen der Migration eines einzelnen Mandanten
- 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
- 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
- Best Practices und Wartung
- Fehlersuche und ‑behebung
- Fehlerbehebung bei Diensten während der Installation
- 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
- 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
- So löschen Sie ungenutzte Docker-Images aus Registrierungs-Pods
- Es kann keine Offlineinstallation auf RHEL 8.4 OS ausgeführt werden.
- Fehler beim Herunterladen des Pakets
- Die Offlineinstallation schlägt aufgrund fehlender binärer Dateien fehl
- Zertifikatproblem bei der Offlineinstallation
- Validierungsfehler bei der SQL-Verbindungszeichenfolge
- Voraussetzungsprüfung für das Selinux-iscsid-Modul schlägt fehl
- Azure-Datenträger nicht als SSD markiert
- Fehler nach der Zertifikatsaktualisierung
- 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.
- Volume nicht bereitstellbar, da es nicht für Workloads bereit ist
- Fehler bei der Protokollsammlung des Supportpakets
- Die temporäre Registrierungsinstallation schlägt unter RHEL 8.9 fehl
- Datenverlust bei der Neuinstallation oder Aktualisierung von Insights nach dem Automation Suite-Upgrade
- Zugriff auf Automation Hub nach Upgrade auf Automation Suite 2024.10.0 nicht mehr möglich
- Das Upgrade eines einzelnen Knotens schlägt in der Fabric-Phase fehl
- Upgrade schlägt aufgrund eines fehlerhaften Ceph . fehl
- Rke2 wird aufgrund von Platzproblemen nicht gestartet
- Datenträger kann nicht verbunden werden und verbleibt im Status der „Attach/Detach“-Schleife
- Upgrade schlägt aufgrund von klassischen Objekten in der Orchestrator-Datenbank fehl
- Ceph-Cluster in beeinträchtigtem Status nach parallelem Upgrade
- Fehlerhafte Insights-Komponente verursacht Fehlschlag der Migration
- Dienst-Upgrade schlägt für Apps fehl
- Timeouts beim direkten Upgrade
- Docker-Registrierungsmigration bleibt in PVC-Löschphase hängen
- AI Center-Bereitstellungsfehler nach Upgrade auf 2023.10 oder höher
- Upgrade schlägt in Offline-Umgebungen fehl
- SQL-Validierung schlägt während des Upgrades fehl
- Snapshot-controller-crds Pod im Status CrashLoopBackOff nach dem Upgrade
- Upgrade schlägt aufgrund überschriebener Insights-PVC-Größen fehl
- Fehler beim Upgrade auf Automation Suite 2024.10.1
- Upgrade schlägt aufgrund eines Velero-Migrationsproblems fehl
- Fehler beim Hoch- oder Herunterladen von Daten im Objektspeicher
- Die Größenänderung eines PVC bewirkt keine Korrektur von Ceph
- Fehler beim Ändern der Größe von objectstore PVC
- Rook Ceph oder Looker-Pod hängen im Init-Status fest
- Fehler beim Anhängen eines StatefulSet-Volumes
- Fehler beim Erstellen persistenter Volumes
- 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
- Aktualisieren Sie die zugrunde liegenden Verzeichnisverbindungen
- Der Roboter kann keine Verbindung mit einer Automation Suite-Orchestrator-Instanz herstellen
- Teilweiser Fehler beim Wiederherstellen der Sicherung in der Automation Suite 2024.10.0
- Fehler beim Abrufen des Sandbox-Abbilds
- Pods werden nicht in der ArgoCD-Benutzeroberfläche angezeigt
- Redis-Testfehler
- RKE2-Server kann nicht gestartet werden
- Secret nicht im UiPath-Namespace gefunden
- ArgoCD wechselt nach der ersten Installation in den Status „In Bearbeitung“.
- MongoDB-Pods in „CrashLoopBackOff“ oder ausstehende PVC-Bereitstellung nach Löschung
- Pods stecken in Init:0/X
- Fehlende Ceph-rook-Metriken in Überwachungs-Dashboards
- Diskrepanz bei gemeldeten Fehlern bei diagnostischen Zustandsprüfungen
- Kein normales Upstream-Problem
- 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
- Nach Disaster Recovery funktioniert Dapr für Process Mining nicht mehr ordnungsgemäß
- 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
- Ausführen des Diagnosetools
- Verwenden des Automation Suite-Supportpakets
- Erkunden von Protokollen
- Untersuchen der zusammengefassten Telemetrie
Abschließen eines Upgrades
Wichtig :
Bitte beachten Sie, dass dieser Inhalt teilweise mithilfe von maschineller Übersetzung lokalisiert wurde.
Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

Automation Suite unter Linux – Installationsanleitung
Letzte Aktualisierung 10. Juni 2025
Abschließen eines Upgrades
Nach dem Ausführen eines Automation Suite-Cluster-Upgrades sind einige Änderungen erforderlich, um sicherzustellen, dass ein neuer Knoten dem Cluster ordnungsgemäß beitritt. Um die Änderungen zu automatisieren, empfehlen wir die Verwendung des Skripts
upgradeUiPathAS.sh
.
Diese Seite enthält Anweisungen zum Ersetzen der benutzerdefinierten Skripterweiterung (Custom Script Extension, CSE) in den Rechenressourcen, damit beim Upgrade auf eine neue Automation Suite-Version neue Knoten zu Ihrem Cluster hinzugefügt werden können.
Der in den folgenden Abschnitten beschriebene Prozess lädt die Skripts herunter, die erforderlich sind, um einige kleinere Änderungen an den Azure-Ressourcen durchzuführen und einige Voraussetzungen zu validieren. Die Skripts befinden sich in den Ordnern
<targetVersion>
und Modules
. Wenn der Prozess fehlschlägt, werden Sie gefragt, ob Sie die Dateien behalten möchten.
Nachdem sichergestellt wurde, dass die Voraussetzungen gültig sind, werden die
CustomScriptExtension
-Objekte auf allen unseren Rechenressourcen aktualisiert, sodass neu hinzugefügte Knoten die Automation Suite <targetVersion>
verwenden. Schließlich werden die Dateien auf den anfänglichen Clusterknoten überschrieben, sodass sie auch mit den Dateien aus der <targetVersion>
übereinstimmen.
Stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen:
- Sie müssen die der Bereitstellung zugeordnete verwaltete Dienstidentität (Managed Service Identity, MSI) (mit dem Namen
<basename>-MSI
) als eine vom Benutzer zugewiesene Identität allen Skalierungsgruppen/virtuellen Maschinen in der Bereitstellung hinzufügen. Wechseln Sie dazu zu Skalierungsgruppe/virtuelle Maschine > Identität > Benutzer zugewiesen > Hinzufügen. Neuere Versionen von Automation Suite-Vorlagen haben diese möglicherweise bereits hinzugefügt. - Sie müssen den vorhandenen MSI-Rechten zum Lesen/Schreiben/Verwalten von Geheimnissen im bereitgestellten Keyvault (mit dem Namen
<basename>-VAULT
) erteilen. Wechseln Sie dazu zum Keyvault, wählen Sie Zugriffsrichtlinien aus, dann Hinzufügen, alle geheimen Vorgänge, dann die MSI sowie Hinzufügen. - Überprüfen Sie die Datei
cluster_config.json
und ändern Sie alle booleschen Werte, die als String ("true"
/"false"
) markiert sind, in tatsächliche boolesche Werte (true
/false
). Zum Beispiel:- Um die Widerstandsfähigkeit von Zonen zu aktivieren, verwenden Sie
"zone_resilience": true
. - Damit das Installationsprogramm die Datenbanken erstellen kann, verwenden Sie
"sql.create_db": true
.
- Um die Widerstandsfähigkeit von Zonen zu aktivieren, verwenden Sie
- Stellen Sie sicher, dass Ihre RHEL-Version für die Skalierungsgruppen für virtuelle Maschinen (Server, Agent usw.) aktualisiert ist und mit der Version übereinstimmt, auf die Sie aktualisieren.
- Wenn Sie ein Upgrade von der Automation Suite 2022.10 auf die Automation Suite 2023.4 oder höher durchführen und der Orchestrator sowohl auf der alten als auch auf der neuen Version aktiviert ist, müssen Sie das Flag
orchestrator.block_classic_executions
in dercluster_config.json
-Datei auftrue
festlegen. Die Verwendung des Flags zeigt, dass Sie mit dem Blockieren klassischer Ordnerausführungen einverstanden sind. Wenn das Flag in diesem Szenario nicht verwendet wird, schlägt der Upgradevorgang fehl. Dieser Parameter ist bei Neuinstallationen nicht erforderlich. - Wenn Sie auf die Automation Suite 2023.10 oder höher aktualisieren und Insights sowohl in der alten als auch in der neuen Umgebung aktiviert ist, müssen Sie das Flag
insights.external_object_storage.bucket_name
auf denselben Bucket festlegen, der fürplatform
in dercluster_config.json
-Datei verwendet wird. Wenn das Flag in diesem Szenario nicht verwendet wird, schlägt der Upgradevorgang fehl. Dieser Parameter ist bei Neuinstallationen nicht erforderlich. - Wenn Sie auf die Automation Suite 2023.10 oder höher aktualisieren, stellen Sie sicher, dass Sie die folgenden Felder in
cluster_config.json
ausfüllen, wennsql.create_db
auftrue
festgelegt ist:sql.server_url = "<db_endpoint>" sql.port = "1433" sql.username = <SQL Username> sql.password = <SQL password>
sql.server_url = "<db_endpoint>" sql.port = "1433" sql.username = <SQL Username> sql.password = <SQL password> - Exportieren Sie nach dem Upgradeprozess den neuen
cluster_config.json
-Dateiinhalt in ein geheimes Azure Key Vault-Geheimnis mit dem NamenclusterConfig
im Schlüsseltresor der Bereitstellung (Details finden Sie im vorherigen Listenelement). Verwenden Sie den Wert des FeldsFixedRKEAddress
als IP des internen Lastausgleichs. Führen Sie dazu einen Befehl ähnlich dem folgenden aus:az keyvault secret set --name clusterConfig --vault-name "<vaultName>" --value "$(cat path/to/cluster_config.json)
az keyvault secret set --name clusterConfig --vault-name "<vaultName>" --value "$(cat path/to/cluster_config.json) - Auf der Maschine, auf der das Upgrade-Skript ausgeführt wird, müssen Sie bei Azure angemeldet sein und den Kontext auf das richtige Abonnement festlegen. Das Konto muss die Rolle
Owner
in der Ressourcengruppe haben, in der der Cluster bereitgestellt wurde. -
Wenn Process Mining aktiviert ist und Sie die neueste Version von Airflow verwenden möchten, stellen Sie sicher, dass Sie die PostgreSQL-Verbindungszeichenfolge für die Datenbank
AutomationSuite_Airflow
angeben.Weitere Informationen finden Sie unter SQL-Anforderungen für Process Mining .
Hinweis:Dies gilt nur, wenn Sie auf die Automation Suite 2024.10.3 oder höher aktualisieren.
Bevor Sie mit dem Upgrade beginnen, sollten Sie die folgenden Empfehlungen berücksichtigen:
- Es wird dringend empfohlen, auf die neueste RHEL-Betriebssystemversion zu aktualisieren, die von der Automation Suite unterstützt wird. Weitere Informationen finden Sie unter Hardwareanforderungen.
- Bevor Sie das Upgrade starten, können Sie zwei Container mit den Namen
logs
undflags
im Bereitstellungsspeicherkonto (mit dem Namen<basename>st
) erstellen. Wenn Sie diese nicht erstellen, kann das Upgrade-Skript dies für Sie übernehmen. - Wenn an die bereitgestellten Serverskalierungsgruppen kein Ceph-Datenträger angefügt ist, erstellt das Skript einen und fügt ihn an die Serverskalierungsgruppe an.
- Der Upgradeprozess ändert das VMSS-Modell, wendet es jedoch nicht auf ältere Instanzen an.
- Bei der Durchführung eines Upgrades für einen Cluster, der mit Azure-Vorlagen bereitgestellt wurde, kann ein Fehler auftreten, der ähnlich wie in der folgenden Abbildung dargestellt ist:
fixed_rke_address
in der Dateicluster_config.json
. Sie müssen den Wert dieses Felds in die IP-Adresse der ersten Serverinstanz ändern, bevor Sie den Upgrade-Befehl ausführen. Die in den Schlüsseltresor hochgeladenecluster_config.json
sollte weiterhin die IP-Adresse des ILB haben, da der Knoten nicht fehlerfrei ist und der Datenverkehr nicht darauf verteilt wird.
Führen Sie die folgenden Schritte aus, um erfolgreich ein Upgrade auf eine neue Version der Automation Suite vorzunehmen:
Beschreibungen der Parameter, die zum Aktualisieren auf eine bestimmte Automation Suite-Version erforderlich sind, finden Sie in der Datei
cluster_config.json
. Sie finden die cluster_config.json
-Datei unter diesem Link.