- Ü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
- Step 7: Configuring kernel and OS level settings
- Step 8: Configuring the disks
- Schritt 9: Konfigurieren der Knotenports
- Step 10: Applying miscellaneous settings
- 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
- Step 15: Configuring the temporary Docker registry for offline installations
- Step 16: Validating the prerequisites for the 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 von einem HA-Add-on zum externen High Availability Add-on
- Migrieren von Daten zwischen Objectstores
- Clusterinterner Objectstore zu einem externen Objectstore migrieren
- Manueller Wechsel zum sekundären Cluster in einer Aktiv-/Passiv-Einrichtung
- Disaster Recovery: Durchführen von Vorgängen nach der Installation
- Umwandlung einer bestehenden Installation in eine Multi-Site-Einrichtung
- Guidelines on upgrading an Active/Passive or Active/Active deployment
- Guidelines on backing up and restoring an Active/Passive or Active/Active deployment
- Redirecting traffic for the unsupported services to the primary 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
- Migrieren zu einer externen OCI-konformen Registrierung
- 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
- 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 NIC-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
- 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 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
- 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 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.
-
Wenn Sie ein Upgrade der Automation Suite 2022.10 durchführen, können Sie ein direktes Upgrade auf 2023.4 oder höher durchführen. Wenn Sie jedoch ein Upgrade der Automation Suite 2021.10 oder 2022.4 durchführen, müssen Sie zuerst auf 2022.10 aktualisieren und erst dann auf 2023.4 oder höher. Weitere Informationen finden Sie unter Upgrade-Pfade für dieAutomation Suite .
-
Durch das Aktualisieren der Automation Suite wird der Wartungsmodus auf dem Cluster aktiviert, was zu Ausfallzeiten für die gesamte Upgradedauer führt.
-
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.
-
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.
-
In the in-place upgrade process, you first upgrade Kubernetes and other infrastructure components, and then upgrade the shared components and UiPath® product services.
-
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 |
|
Sie müssen auf 2022.4.7-2022.4.10 aktualisieren und dann auf 2022.4.11 oder höher. |
Sie müssen zuerst auf 2022.10.0–2022.10.9 aktualisieren und dann auf 2022.10.10 oder höher. |
Sie müssen zuerst auf 2022.10.0–2022.10.9 aktualisieren und dann auf 2023.4.x. |
Sie müssen zuerst auf 2022.10.0–2022.10.9 aktualisieren und dann auf 2023.10.x. |
2022.4.x |
Keine Angabe |
|
Wenn Ihre aktuelle Version 2022.4.0–2022.4.6 ist, müssen Sie zuerst auf 2022.10.0–2022.10.9 aktualisieren und dann auf 2022.10.10 oder höher. Wenn Ihre aktuelle Version 2022.4.7 oder höher ist, müssen Sie auf 2022.10.10 oder höher aktualisieren. |
Wenn Ihre aktuelle Version 2022.4.0-2022.4.10 ist, müssen Sie zuerst auf 2022.10.0-2022.10.9 aktualisieren und dann auf 2023.4.x. Wenn Ihre aktuelle Version 2022.4.11 ist, müssen Sie zuerst auf 2022.10.10 aktualisieren und dann auf 2023.4.5. |
Erfordert mindestens Version 2022.4.7 mit Ceph auf unformatierten Geräten und Abschluss der Cilium-Migration vor dem Starten des Upgrades. Wenn Ihre aktuelle Version 2022.4.7-2022.4.10 ist, können Sie auf 2023.10.x aktualisieren. Wenn Ihre aktuelle Version 2022.4.11 ist, müssen Sie auf 2023.10.2 oder höher aktualisieren. |
2022.10.x |
Keine Angabe |
Keine Angabe |
|
Wenn Ihre aktuelle Version 2022.10.0-2022.10.9 ist, können Sie auf 2023.4.x aktualisieren. Wenn Ihre aktuelle Version 2022.10.10 oder höher ist, müssen Sie auf 2023.4.5 oder höher aktualisieren. |
Wenn Ihre aktuelle Version 2022.10.0-2022.10.9 ist, können Sie auf 2023.10.x aktualisieren. Wenn Ihre aktuelle Version 2022.10.10 oder höher ist, müssen Sie auf 2023.10.2 oder höher aktualisieren. |
2023.4.x |
Keine Angabe |
Keine Angabe |
Keine Angabe |
|
Wenn Ihre aktuelle Version 2023.4.0-2023.4.4 ist, können Sie auf 2023.10.x aktualisieren. Wenn Ihre aktuelle Version 2023.4.5 oder höher ist, müssen Sie auf 2023.10.2 oder höher aktualisieren. |
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