- Ü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
Schritt 1: Konfigurieren der OCI-konformen Registrierung für Offline-Installationen
Bei Offline-Installationen benötigen Sie eine Registrierung, die mit OCI (Open Container Initiative) konform ist, um die Container-Images und Helm-Charts für die Bereitstellung zu speichern. Wenn Sie eine Online-Installation durchführen, überspringen Sie diesen Schritt.
Es wird dringend empfohlen, eine eigene Registrierung mitzubringen. Wenn Sie keines zur Verfügung haben, können Sie vorübergehend eine OCI-kompatible Registrierung auf einer der Servermaschinen installieren.
Es gibt zwei Möglichkeiten, die Automation Suite-Artefakte in die externe OCI-konforme Registrierung hochzuladen:
- Option A: Durch Spiegeln Ihrer OCI-konformen Registrierung mit der UiPath®-Registrierung;
- Option B: Durch Hydratisieren Ihrer OCI-konformen Registrierung mit dem Offlinepaket.
In der folgenden Tabelle werden die beiden Optionen zum Hochladen der Artefakte in die Registrierung verglichen, sodass Sie die geeignete Option auswählen können:
Option A: Spiegeln der Registrierung |
Option B: Hydratisieren der Registrierung |
---|---|
Kopiert die Artefakte aus der UiPath®-Registrierung in eine beliebige Zielregistrierung. |
Verwendet den Offline-Tarball, um die Artefakte zu entpacken und in die Zielregistrierung hochzuladen. |
Erfordert Docker- und Helm-Tools. |
Erfordert Podman- und Helm-Tools. |
Requires internet access to copy the artifacts from the UiPath® registry to the target registry. |
Erfordert Internetzugang nur, um den Offline-Tarball auf den Jump Server herunterzuladen. Das Hochladen des Tarballs erfordert keinen Internetzugang. |
Erfordert einen temporären Speicherplatz zum Zwischenspeichern der Images während des Kopierens. Dieser Speicherplatz wird normalerweise während der Docker-Installation konfiguriert. Der standardmäßige Speicherort ist
/var/lib/docker .
|
Erfordert einen temporären Speicherplatz zum Extrahieren des Tarballs und einen temporären Speicherplatz für Podman zum Laden der Images. The location of the tarball extraction must be provided during the hydration step. The Podman location can be
/var/tmp , which must have adequate storage available.
|
The required storage capacity for the
/var/lib/docker directory is around 128 GiB.
|
Die erforderliche Speicherkapazität für die Extraktion beträgt etwa 200 GiB, und
/var/tmp erfordert 256 GiB.
|
Diese Methode erfordert einen Internetzugang auf der Sprungmaschine, von der Sie die Artefakte der Automation Suite auf Ihre OCI-konforme Registrierung hochladen.
Voraussetzungen für die Spiegelung der UiPath®-Registrierung
Um die UiPath®-Registrierung zu spiegeln, benötigen Sie Folgendes:
-
Eine VM mit einer Linux-Distribution (empfohlen) oder einen Laptop (nicht empfohlen);
-
Einen Docker-Client, der mit der privaten Registrierung authentifiziert wurde;
-
Helm 3.8 oder neuer, authentifiziert mit der privaten Registrierung;
-
as-images.txt
; -
as-helm-charts.txt
; -
mirror-registry.sh
; -
Ausgehende Konnektivität zu
registry.uipath.com
; -
128 GiB freier Datenträgerspeicher für Docker unter der Partition
/var/lib/docker
auf der Maschine, von der Sie die Container-Images und Charts hochladen.
Installieren von Docker und Helm
Docker und Helm müssen auf der Maschine installiert und authentifiziert sein, von der Sie die Automation Suite Container-Images und -Charts in Ihre Registrierung hochladen möchten.
-
Informationen zum Herunterladen der Docker-Binärdateien finden Sie in der offiziellen Dokumentation.
-
Informationen zum Authentifizieren der Docker-Registrierung finden Sie in der offiziellen Dokumentation. Alternativ können Sie den folgenden Befehl verwenden, indem Sie die Beispielanmeldeinformationen durch Ihre tatsächlichen Registrierungsanmeldeinformationen ersetzen:
docker login my.registry.io:443 --username "admin" --password "secret"
docker login my.registry.io:443 --username "admin" --password "secret" -
Informationen zum Herunterladen der Helm-Binärdateien finden Sie in der offiziellen Dokumentation.
-
Informationen zum Authentifizieren der Helm-Registrierung finden Sie in der offiziellen Dokumentation. Alternativ können Sie den folgenden Befehl verwenden, indem Sie die Beispielanmeldeinformationen durch Ihre tatsächlichen Registrierungsanmeldeinformationen ersetzen:
helm registry login my.registry.io:443 --username "admin" --password "secret"
helm registry login my.registry.io:443 --username "admin" --password "secret"
Herunterladen von as-images.txt
as-images.txt
finden Sie unter Herunterladen von Installationspaketen.
Herunterladen von as-helm-charts.txt
as-helm-charts.txt
finden Sie unter Herunterladen von Installationspaketen.
Herunterladen der optionalen Document Understanding-Pakete
Informationen zum Herunterladen der optionalen Document Understanding-Pakete finden Sie in der Document Understanding-Dokumentation.
Herunterladen von mirror-registry.sh
mirror-registry.sh
finden Sie unter Herunterladen der Installationspakete.
Hochladen der Automation Suite-Images in Ihre Registrierung
mirror-registry.sh
-Skript erfordert ausgehende Konnektivität zu den Quell- (Standard: registry.uipath.com
) und Ziel-Registern.
mirror-registry.sh
führt keine Authentifizierung bei der Registrierung durch. Es wird davon ausgegangen, dass Sie sich bereits bei der Registrierung authentifiziert haben.
Markieren |
Umgebungsvariable |
Beschreibung |
---|---|---|
|
|
Obligatorisch. Der Pfad zur Image-Manifestdatei. |
|
|
Obligatorisch. Pfad zur Helm-Chart-Manifestdatei. |
|
|
Obligatorisch. Übergeben Sie die URL für die Zielregistrierung. |
|
|
Optional. Übergeben Sie die URL für die Quellregistrierung; der Standardwert ist
registry.uipath.com .
|
-
Ensure that you have the necessary permissions to execute the shell script, by running the following command:
chmod +x mirror-registry.sh
chmod +x mirror-registry.sh -
Um die Automation Suite-Images in die Registrierung hochzuladen, führen Sie den folgenden Befehl aus:
./mirror-registry.sh --target-registry-url my.registry.io:443 --source-registry-url registry.uipath.com --images-manifest /home/myuser/as-images.txt --helm-charts-manifest /home/myuser/as-helm-charts.txt
./mirror-registry.sh --target-registry-url my.registry.io:443 --source-registry-url registry.uipath.com --images-manifest /home/myuser/as-images.txt --helm-charts-manifest /home/myuser/as-helm-charts.txtNote: For registries, such as Harbor, which require using a project, make sure you append the project name to the target registry URL you include in the command, as shown in the following example:./mirror-registry.sh --target-registry-url my.registry.io:443/myproject --source-registry-url registry.uipath.com --images-manifest /home/myuser/as-images.txt --helm-charts-manifest /home/myuser/as-helm-charts.txt
./mirror-registry.sh --target-registry-url my.registry.io:443/myproject --source-registry-url registry.uipath.com --images-manifest /home/myuser/as-images.txt --helm-charts-manifest /home/myuser/as-helm-charts.txt
Diese Methode erfordert nur einen Internetzugang auf der Sprungmaschine, um das Offline-Paket herunterzuladen. Sobald das Paket verfügbar ist, können Sie es ohne Internetverbindung in Ihre OCI-konforme Registrierung hochladen.
This method may also require additional space on the machine to un-tar and upload to your registry. In addition, this method may take longer than the mirroring approach.
Voraussetzungen für die Hydratisierung der Registrierung
Um die Registrierung zu unterstützen, benötigen Sie Folgendes:
- Eine VM mit einer Linux-Distribution ist der Ausführung des Skripts auf einem Laptop vorzuziehen;
- Die Möglichkeit, das Offlinepaket herunterzuladen und zu kopieren oder anderweitig zur VM weiterzugeben;
- Helm 3.8 oder neuer, authentifiziert mit der privaten Registrierung;
- Podman installiert, konfiguriert und mit der privaten Registrierung authentifiziert;
- 150 GiB freier Datenträgerspeicher für Podman unter
/var/lib/containers
zum lokalen Laden der Container, bevor sie per Push in die Remote-Registrierung übertragen werden. Sie können den Standardpfad ändern, indem Sie den Ort des graphRoot-Pfads in der Ausgabe des Befehlspodman info
aktualisieren. - Set the
TMP_DIR
environment variable as described in the official Podman documentation. as.tar.gz
Installieren von Podman und Helm
Sie müssen sicherstellen, dass Podman und Helm auf der Maschine installiert und authentifiziert sind, von der Sie die Automation Suite-Container-Images und -Charts in Ihre Registrierung hochladen möchten.
- Informationen zum Herunterladen der Podman-Binärdateien finden Sie in der offiziellen Dokumentation.
- Informationen zur Authentifizierung bei der Podman-Registrierung finden Sie in der offiziellen Dokumentation. Alternativ können Sie den folgenden Befehl verwenden, indem Sie die Beispielanmeldeinformationen durch Ihre tatsächlichen Registrierungsanmeldeinformationen ersetzen:
podman login my.registry.io:443 --username "admin" --password "secret"
podman login my.registry.io:443 --username "admin" --password "secret" - Informationen zum Herunterladen der Helm-Binärdateien finden Sie in der offiziellen Dokumentation.
- Informationen zum Authentifizieren der Helm-Registrierung finden Sie in der offiziellen Dokumentation. Alternativ können Sie den folgenden Befehl verwenden, indem Sie die Beispielanmeldeinformationen durch Ihre tatsächlichen Registrierungsanmeldeinformationen ersetzen:
helm registry login my.registry.io:443 --username "admin" --password "secret"
helm registry login my.registry.io:443 --username "admin" --password "secret"
Herunterladen von as.tar.gz
as.tar.gz
finden Sie unter Herunterladen von Installationspaketen.
Herunterladen der optionalen Document Understanding-Pakete
Informationen zum Herunterladen optionaler Document Understanding-Pakete finden Sie in der Document Understanding-Dokumentation.
Herunterladen von hydrate-registry.sh
hydrate-registry.sh
finden Sie unter Herunterladen der Installationspakete.
Hochladen der Automation Suite-Images in die Registrierung
hydrate-registry.sh
.
hydrate-registry.sh
erfordert keine ausgehende Konnektivität außer zu den Zielregistern.
hydrate-registry.sh
führt keine Authentifizierung bei der Registrierung durch. Es wird davon ausgegangen, dass Sie sich bereits bei der Registrierung authentifiziert haben.
Markieren |
Beschreibung |
---|---|
|
Obligatorisch. Pfad zum Offlinepaket. |
|
Obligatorisch. Übergeben Sie die URL für die Zielregistrierung. |
|
Der Speicherort, der zum Entpacken des Offlinepakets verwendet werden soll. Er kann entweder
/var/lib/containers oder ein benutzerdefinierter Speicherort sein. Stellen Sie sicher, dass Sie über mindestens 100 GiB Speicherplatz verfügen. Es werden 256 GiB Speicher empfohlen.
|
-
Stellen Sie sicher, dass die erforderlichen Berechtigungen zum Ausführen des Shell-Skripts verfügbar sind, indem Sie den folgenden Befehl ausführen:
chmod +x mirror-registry.sh
chmod +x mirror-registry.sh -
Upload the Automation Suite images to your registry by running the following command:
./hydrate-registry.sh --target-registry-url my.registry.io:443 --offline-bundle-path ./as.tar.gz --extract-path /extract/to/path
./hydrate-registry.sh --target-registry-url my.registry.io:443 --offline-bundle-path ./as.tar.gz --extract-path /extract/to/path
./hydrate-registry.sh --target-registry-url my.registry.io:443/myproject --offline-bundle-path ./as.tar.gz --extract-path /extract/to/path
./hydrate-registry.sh --target-registry-url my.registry.io:443/myproject --offline-bundle-path ./as.tar.gz --extract-path /extract/to/path