- Überblick
- Anforderungen
- Empfohlen: 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 von Microsoft SQL Server
- 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
- Schritt 13: Generieren von cluster_config.json
- Zertifikatkonfiguration
- Datenbankkonfiguration
- Konfiguration des externen Objektspeichers
- Vorsignierte URL-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
- 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
- install-uipath.sh-Parameter
- 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
- Umleitung des Datenverkehrs für die nicht unterstützten Dienste auf den primären Cluster
- Überwachung und Warnungen
- Migration und Upgrade
- Schritt 1: Verschieben der Identitätsorganisationsdaten von einer eigenständigen in die Automation Suite
- Schritt 2: Wiederherstellen der eigenständigen Produktdatenbank
- Schritt 3: Sichern der Plattformdatenbank in der Automation Suite
- Schritt 4: Zusammenführen von Organisationen in der Automation Suite
- Schritt 5: Aktualisieren der migrierten Produktverbindungszeichenfolgen
- Schritt 6: Migrieren des eigenständigen Orchestrators
- Schritt 7: Migrieren von eigenständigen Insights
- Schritt 8: Löschen des Standardmandanten
- B) Migration von einzelnen Mandanten
- Migrieren von der Automation Suite unter Linux zur Automation Suite unter EKS/AKS
- 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
- Verwenden des Orchestrator-Konfiguratortools
- Konfigurieren von Orchestrator-Parametern
- Orchestrator-appSettings
- Konfigurieren von AppSettings
- Konfigurieren der maximalen Anforderungsgröße
- Überschreiben der Speicherkonfiguration auf Clusterebene
- 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-Paket 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
- Upgrade von Automation Suite 2022.10.10 und 2022.4.11 auf 2023.10.2
- 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
- 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
- Die erste Installation schlägt während des Longhorn-Setups fehl
- 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
- Das Upgrade eines einzelnen Knotens schlägt in der Fabric-Phase fehl
- Fehler im Cluster nach automatisiertem Upgrade von 2021.10
- 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
- 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
- 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
- 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
- Fehlerhafte Dienste nach Clusterwiederherstellung oder Rollback
- Pods stecken in Init:0/X
- Fehlende Ceph-rook-Metriken in Überwachungs-Dashboards
- 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 und Task 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
- Ausführen des Diagnosetools
- Verwenden des Automation Suite Support Bundle-Tools
- Erkunden von Protokollen
Aktualisieren der Automation Suite
-
Automation Suite 2023.4.5 und 2023.10.2 umfassen ein Upgrade auf Kubernetes 1.26.11. Daher müssen Sie beim Aktualisieren von Automation Suite sicherstellen, dass Sie kein Downgrade von Kubernetes durchführen. Dazu müssen Sie beim Wechsel von Automation Suite 2023.4.5 oder einer späteren Nebenversion auf die nächste Hauptversion mindestens auf 2023.10.2 aktualisieren.
-
Die verfügbaren Upgrade-Pfade finden Sie unter Upgrade-Pfade für die Automation Suite.
-
Wenn Sie ein Upgrade von Automation Suite 2022.10 oder früher planen und Process Mining aktiviert ist, müssen Sie Prozess-Apps auf das neue Prozessdiagrammlayout migrieren, bevor Sie das Upgrade starten.
-
Wenn Sie eine Automation Suite-Version aktualisieren, auf der eine Maschine mit deaktiviertem FIPS 140-2 installiert ist, können Sie FIPS 140-2 aktivieren, indem Sie die Anweisungen zu Sicherheit und Compliance befolgen.
-
Stellen Sie sicher, dass Sie die Hardware- und Softwareanforderungen für die neue Automation Suite-Version erfüllen. Wenn AI Center aktiviert ist, stellen Sie sicher, dass Sie die CUDA-Anforderungen erfüllen.
-
Stellen Sie sicher, dass Sie die Best Practices für das Automation Suite-Upgrade befolgen und den Upgradeprozess durchführen, der Ihren Anforderungen am besten entspricht.
Die Automation Suite unterstützt zwei Upgrade-Prozesse:
-
Direktes Upgrade
-
Paralleles Upgrade
Mit dem direkten Upgradeprozess der Automation Suite können Sie auf eine neue Automation Suite-Version wechseln, während Ihre Einstellungen und Daten auf der gleichen Hardware intakt bleiben.
-
Beim direkten Upgradeprozess aktualisieren Sie zuerst Kubernetes und andere Infrastrukturkomponenten. Dann aktualisieren Sie die gemeinsam genutzten Komponenten und UiPath®-Produktdienste.
-
Bei einem schwerwiegenden Fehler, der während des Upgrade-Prozesses nicht wieder herstellt werden kann, müssen Sie mithilfe der Sicherungs- und Wiederherstellungsfunktion zur vorherigen Version zurückkehren.
Das parallele Automation Suite-Upgrade nutzt ein Enterprise-Upgrade, das normalerweise als „blau-grün“ bezeichnet wird und ein branchenweiter Standardprozess ist.
-
Das parallele Upgrade ermöglicht es Ihnen, ein Upgrade sicher in einer parallelen Umgebung durchzuführen, anstatt ein Upgrade an Ort und Stelle durchzuführen.
-
Mit dieser Methode können Administratoren den Datenverkehr vom alten Automation Suite-Cluster (d. h. die blaue Bereitstellung) zum neuen Automation Suite-Cluster (d. h. die grüne Bereitstellung) umleiten, nachdem die neue Bereitstellung überprüft wurde. Wenn Sie ein Problem feststellen, können Sie schnell zur alten Bereitstellung zurückkehren.
Funktion |
Upgrade-Mechanismus | |
---|---|---|
Direktes Upgrade |
Paralleles Upgrade | |
Aktualisieren Sie auf eine neue LTS-Version |
|
|
Upgrade von einer beliebigen unterstützten Version |
1 |
2 |
Datenmigration mit hoher Genauigkeit |
|
3 |
Keine Ausfallzeit während des Upgrades |
|
|
Sofortiges Rollback |
|
|
1 Sie können ein Upgrade von jeder Automation Suite-Version durchführen, aber es kann ein Zwischenupgrade zwischen Ihrer ursprünglichen und gewünschten Version erforderlich sein. Weitere Informationen finden Sie unter Pfade für direkte Upgrades.
2 Sie können ein Upgrade von jeder Automation Suite-Version durchführen, außer 2021.10. Weitere Informationen finden Sie unter Parallele Upgrade-Pfade.
3 Weitere Informationen finden Sie unter Datenmigration und Zuständigkeiten.
Die folgende Matrix zeigt die verfügbaren direkten Upgrade-Pfade für Automation Suite-Versionen:
– Ein direkter Upgrade-Pfad zwischen Hauptversionen ist verfügbar;
– Ein zwischenzeitliches direktes Upgrade zwischen Ihrer Ausgangs- und Zielhauptversion ist erforderlich.
Es wird dringend empfohlen, auf die neueste Nebenversion der Automation Suite zu aktualisieren. So können Sie die neuesten Verbesserungen nutzen und den nahtlosen Betrieb aller internen Komponenten gewährleisten.
Ursprüngliche Version |
Zielversion | ||||
---|---|---|---|---|---|
2021.10.x |
2022.4.x |
2022.10.x |
2023.4.x |
2023.10.x | |
2021.10.x |
|
|
|
|
|
2022.4.x |
Keine Angabe |
|
|
|
Erfordert mindestens Version 2022.4.7 mit Ceph auf unformatierten Geräten und Abschluss der Cilium-Migration vor dem Starten des Upgrades.
|
2022.10.x |
Keine Angabe |
Keine Angabe |
|
|
|
2023.4.x |
Keine Angabe |
Keine Angabe |
Keine Angabe |
|
|
2023.10.x |
Keine Angabe |
Keine Angabe |
Keine Angabe |
Keine Angabe |
|
-
In einigen Fällen erfordert das Upgrade der Automation Suite den Übergang durch eine Zwischenversion oder das vollständige Überspringen einiger Versionen, um das reibungslose Funktionieren der internen Komponenten aufrechtzuerhalten. Die Nichtbeachtung der Upgrade-Richtlinien in der vorherigen Tabelle kann zu einer internen Komponenten-Downgrade oder zu einem fehlgeschlagenen internen Komponenten-Upgrade führen, wodurch das Automation Suite-Upgrade fehlschlägt.
-
Wenn Sie ein Upgrade von Automation Suite 2022.10 oder früher planen und Process Mining aktiviert ist, müssen Sie Prozess-Apps auf das neue Prozessdiagrammlayout migrieren, bevor Sie das Upgrade starten.
-
Wenn Sie Active Directory (AD) verwenden und ein Upgrade auf 2023.4.0 planen, empfehlen wir dringend, direkt zur Version 2023.4.3 zu springen, da 2023.4.0, 2023.4.1 und 2023.4.2 von einem AD-Problem betroffen sind.
-
Nur Upgrades auf die Automation Suite 2023.10 und höher nutzen den vereinfachten Upgrade-Prozess.
Die folgende Matrix zeigt die verfügbaren nebeneinanderstehenden Upgrade-Pfade für Automation Suite-Versionen:
– Ein direkter paralleler Upgradepfad zwischen Versionen ist verfügbar;
- Ein Parallel-Upgrade zwischen Ihrer ursprünglichen und der Zielversion ist nicht möglich.
Es wird dringend empfohlen, auf die neueste Nebenversion der Automation Suite zu aktualisieren. So können Sie die neuesten Verbesserungen nutzen und den nahtlosen Betrieb aller internen Komponenten gewährleisten.
Ursprüngliche Version |
Zielversion | ||||
---|---|---|---|---|---|
2021.10.x |
2022.4.x |
2022.10.x |
2023.4.x |
2023.10.x | |
2021.10.x |
|
|
|
|
|
2022.4.x |
Keine Angabe |
|
|
|
|
2022.10.x |
Keine Angabe |
Keine Angabe |
|
|
|
2023.4.x |
Keine Angabe |
Keine Angabe |
Keine Angabe |
|
|
2023.10.x |
Keine Angabe |
Keine Angabe |
Keine Angabe |
Keine Angabe |
|
Wenn Sie eine zusätzliche Umgebung für die Durchführung des Upgrades mitbringen können, empfehlen wir, den Parallel-Upgradepfad zu wählen, da er ein sichereres Upgrade und ein sofortiges Rollback bietet.
Wenn Sie keine zusätzliche Umgebung für die Durchführung des Upgrades bereitstellen können, können Sie sich für das direkte Upgrade entscheiden. Stellen Sie sicher, dass Sie die bewährten Methoden für die Upgradevalidierung befolgen.
Wir empfehlen, zwei ähnliche Automation Suite-Umgebungen vorzubereiten, unabhängig davon, ob Sie das direkte oder das parallele Upgrade verwenden möchten:
-
Automation Suite-Cluster mit mehreren Knoten für Entwickler oder QA
Hinweis: Die dev/QA-Umgebung muss nicht die ganze Zeit online sein, wenn sie nicht für etwas anderes als die Upgradevalidierung verwendet wird. -
Automation Suite-Cluster mit mehreren Knoten für die Produktion
Es wird dringend empfohlen, vor dem Upgrade der Automation Suite eine Sicherung des Clusters und der SQL-Datenbank zu erstellen. Dadurch wird sichergestellt, dass Sie den Cluster wiederherstellen können, wenn während des Upgradevorgangs etwas schief geht.
Clusterdaten werden auf dem NFS-Server gesichert. Stellen Sie sicher, dass Sie den NFS-Server konfiguriert haben, bevor Sie fortfahren.
global.userInputs.identity.krb5KeytabSecret
in global.kerberosAuthConfig.userKeytab
kopieren, wenn die folgenden Anforderungen gleichzeitig erfüllt sind:
-
Sie haben die Active Directory-Integration mit Benutzername und Kennwort konfiguriert;
-
Die Windows-Authentifizierung ist aktiviert;
-
Sie verwenden keine integrierte SQL-Authentifizierung.
Um die von Ihnen erstellten Automatisierungen zu validieren, erstellen Sie separate Organisationen oder Mandanten direkt in Ihrer Automation Suite-Produktionsumgebung, da dies die kostengünstigste Lösung ist. Weitere Best Practices finden Sie unter Orchestrator – Best Practices für die Automatisierung.
Um Ihre Automatisierungen in verschiedenen Umgebungen und Versionen zu validieren, nutzen Sie Ihren zweiten Automation Suite-Cluster, nachdem Sie den neuen Automation Suite-Cluster installiert haben, aber bevor Sie den Datenverkehr auf den neuen Cluster in der Produktion umschalten.
Das Upgrade auf eine neue Automation Suite-Version erfordert keine zusätzliche Lizenz, unabhängig davon, welchen Upgrade-Pfad Sie wählen. Wenn Sie jedoch unsere bewährten Methoden befolgen und zwei Automation Suite-Cluster verwenden (einen für QA/Dev und einen anderen für die Produktion), benötigen Sie eine Lizenz pro Cluster.
- Anforderungen
- Upgrade-Prozess
- Direkter Upgradeprozess
- Paralleles Upgrade
- Upgrade-Mechanismus und -Funktionen
- Pfade für direktes Upgrade
- Parallele Upgrade-Pfade
- Aktualisieren der Best Practices
- Aktualisieren der Best Practices zur Validierung
- Umgebungen
- Sicherung
- Authentication
- Best Practices für die Automatisierungsvalidierung
- Versionsvalidierung
- Lizenzierung