- Überblick
- Anforderungen
- Installation
- Fragen und Antworten: Bereitstellungsvorlagen
- Konfigurieren der Maschinen
- Konfigurieren des externen Objektspeichers
- Konfigurieren des Lastausgleichs
- Konfigurieren des DNS
- Konfigurieren von Microsoft SQL-Servern
- Konfigurieren der Zertifikate
- HA-fähige Online-Produktionsinstallation mit mehreren Knoten
- HA-fähige Offline-Produktionsinstallation mit mehreren Knoten
- Herunterladen der Installationspakete
- install-uipath.sh-Parameter
- Aktivieren eines High Availability Add-ons für den Cluster
- Document Understanding-Konfigurationsdatei
- Hinzufügen eines dedizierten Agent-Knotens mit GPU-Unterstützung
- Verbinden einer Task Mining-Anwendung
- Hinzufügen eines dedizierten Agent-Knotens für Task Mining
- Hinzufügen eines dedizierten Agentenknotens für Automation Suite-Roboter
- Nach der Installation
- Clusterverwaltung
- Überwachung und Warnungen
- Migration und Upgrade
- Migrationsoptionen
- 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
- Step 6: Migrating standalone Insights
- Schritt 7: Löschen des Standardmandanten
- B) Migration von einzelnen Mandanten
- Produktspezifische Konfiguration
- 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
- Automatisches Bereinigen von Longhorn-Snapshots
- Deaktivieren von NIC-Prüfsummen-Offloading
- 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
- Automation Hub und Apps können mit Proxy-Setup nicht gestartet werden
- Fehler beim Hoch- oder Herunterladen von Daten im Objektspeicher
- Die Größenänderung eines PVC bewirkt keine Korrektur von Ceph
- Fehler beim Ändern der PVC-Größe
- 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
- Patch zur Rückgewinnung von Speicherplatz
- Sicherung aufgrund des Fehlers „TooManySnapshots“ fehlgeschlagen
- Alle Longhorn-Replikate sind fehlerhaft
- Festlegen eines Timeout-Intervalls für die Verwaltungsportale
- Aktualisieren Sie die zugrunde liegenden Verzeichnisverbindungen
- 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
- Secret nicht im UiPath-Namespace gefunden
- ArgoCD wechselt nach der ersten Installation in den Status „In Bearbeitung“.
- Unerwartete Inkonsistenz; fsck manuell ausführen
- MongoDB-Pods in „CrashLoopBackOff“ oder ausstehende PVC-Bereitstellung nach Löschung
- MongoDB-Pod kann nicht von 4.4.4-ent auf 5.0.7-ent aktualisiert werden
- Fehlerhafte Dienste nach Clusterwiederherstellung oder Rollback
- Pods stecken in Init:0/X
- Prometheus im Status „Crash Loop Backoff“ mit Out-of-Memory-Fehler (OOM).
- 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
- Verwenden des Automation Suite-Diagnosetools
- Verwenden des Automation Suite Support Bundle-Tools
- Erkunden von Protokollen
HA-fähige Offline-Produktionsinstallation mit mehreren Knoten
Sie müssen die Voraussetzungen für Hardware und Software erfüllen, bevor Sie mit der Installation fortfahren. Siehe Hardware- und Softwareanforderungen.
Sie können ein dediziertes Skript verwenden, um die Installationsvoraussetzungen und die Bereitschaft der Infrastruktur zu überprüfen. Siehe Validieren der Voraussetzungen.
Für eine reibungslose Installation halten Sie sich an unsere empfohlenen Vorgehensweisen. Siehe .
Der Installationsvorgang umfasst die folgenden grundlegenden Schritte:
Schritt |
Beschreibung |
---|---|
Schritt 1: Herunterladen der Installationspakete |
Sie müssen diesen Schritt von einer Linux- oder Windows-Maschine aus durchführen, die Zugriff auf das Internet und auf die Offline-Maschinen hat, auf denen Sie die Automation Suite bereitstellen möchten. Während die Installationspakete fertig heruntergeladen werden, können Sie einige der nächsten Schritte ausführen. |
Schritt 2: Konfigurieren der Installation |
Führen Sie das interaktive Installationsprogramm aus, um die Installationsoptionen zu konfigurieren. Dieses Tool sammelt Eingaben für die gängigsten Installationsoptionen und generiert eine Konfigurationsdatei, die während der Installation verwendet wird. (Optional) Konfigurieren Sie erweiterte Installationsoptionen. Das interaktive Installationsprogramm bietet ein Standardprogramm mit einer begrenzten Anzahl von Konfigurationsoptionen. Bearbeiten Sie die Konfigurationsdatei, um die installierten Produkte anzupassen, separate SQL-Server für bestimmte Produkte einzurichten und vieles mehr. |
Schritt 3: Kopieren der Installationsdateien auf alle Maschinen |
Kopieren Sie auf der ersten Maschine die heruntergeladenen Dateien in den Installationsordner, der vom interaktiven Installationsprogramm in Schritt 2 erstellt wurde. Kopieren Sie auf die anderen Clustermaschinen den gesamten Installationsordner von der ersten Maschine in denselben Ordnerpfad auf jeder Maschine. |
Schritt 4: Ausführen der Installation |
Erstellen Sie den Cluster und verbinden Sie alle Maschinen. Installieren Sie den Rest der Suite von der ersten Maschine. |
Schritt 5: Abschließen der Installation |
Schritt 5: Sie haben die Installation erfolgreich abgeschlossen und können mit den Schritten nach der Installation fortfahren. Sie können nun auf den neu erstellten Cluster und die Suite zugreifen, Zertifikate aktualisieren, die Größe des PVC ändern und vieles mehr. |
RHEL-Kernel-Version kernel-4.18.0-477.10.1.el8_8 ist von einem Problem betroffen, das die Installation oder Verwaltung des Automation Suite-Clusters unterbricht. Stellen Sie sicher, dass keiner der Automation Suite-Knoten vor oder nach der Installation diese Kernel-Version verwendet. Sie können die Kernel-Version aktualisieren, indem Sie den folgenden Befehl ausführen:
dnf install -y kernel kernel-tools kernel-tools-libs
dnf install -y kernel kernel-tools kernel-tools-libs
Schritt 1: Herunterladen der Installationspakete und Übertragen aller Dateien auf die erste Maschine
Diese Maschine kann mit Linux oder Windows laufen. Die Befehle in diesem Handbuch gelten für ein RHEL-basiertes Betriebssystem. Nutzen Sie bei Windows oder anderen Betriebssystemen Befehle, die diesen Umgebungen entsprechenden.
Das Automation Suite-Installationsprogramm ist ein Wrapper mehrerer Pakete, der auch einige Abhängigkeiten mit Hilfe des Red Hat Package Managers (RPM) installiert. Es bietet eine interaktive Erfahrung, die Sie bei der Konfiguration externer Ressourcen wie SQL und anderen Installationsoptionen unterstützt.
AUF DER SEPARATEN MASCHINE MIT INTERNETZUGANG
In diesem Abschnitt wird erläutert, wie Sie die erforderlichen Dateien zum Starten des Installationsvorgangs erhalten.
Führen Sie die folgenden Schritte aus:
- Überprüfen Sie, ob alle Dateien mit Internetzugang auf den Computer heruntergeladen wurden;
- Erstellen Sie den Zielordner auf der Maschine;
- Kopieren Sie die Dateien von der Onlinemaschine auf die Zielmaschine.
AUF ALLEN MASCHINEN IM CLUSTER
Erstellen Sie die Installationsordner, indem Sie den folgenden Befehl ausführen:
sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 777 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp
sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 777 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp
mkdir -p /opt/UiPathAutomationSuite/
ist nicht erforderlich, wenn Sie das Skript configureUiPathDisks.sh
verwenden.
AUF DER SEPARATEN MASCHINE MIT INTERNETZUGANG
Kopieren Sie die Dateien in den ersten Knoten, indem Sie die folgenden Schritte ausführen:
- From the machine with internet access, copy the files to the installation folder on the target machine, and the offline bundle(s) to the
/uipath/tmp
folder:scp ~/installUiPathAS.sh ~/sf-installer.zip ~/sf-infra.tar.gz <username>@<node dns>:/uipath/tmp scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/
scp ~/installUiPathAS.sh ~/sf-installer.zip ~/sf-infra.tar.gz <username>@<node dns>:/uipath/tmp scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/ - (Optional) Um Document Understanding zu verwenden, kopieren Sie das folgende Paket in den Ordner
/uipath/tmp
:scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/
scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/Warnung: Wenn Sie diesen optionalen Schritt überspringen, ist kein Zugriff auf die Document Understanding-Dienste möglich. - (Optional) Um Computer Vision zu verwenden, kopieren Sie das folgende Paket in den Ordner
/uipath/tmp
:scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/
scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/Warnung: Wenn Sie diesen optionalen Schritt überspringen, ist kein Zugriff auf die Computer Vision-Dienste möglich.
Ausführen des interaktiven Assistenten mit mehreren Knoten im Offlinemodus
Führen Sie das interaktive Installationsprogramm aus, um die Installationsoptionen zu konfigurieren. Das Tool sammelt Eingaben für die gängigsten Installationsoptionen und generiert eine Konfigurationsdatei. Hochverfügbarkeit ist standardmäßig aktiviert, aber Sie können sie mit der erweiterten Konfiguration deaktivieren.
Führen Sie die folgenden Schritte aus, um die Automation Suite zu installieren:
Dieser Schritt ist optional.
Sie können die Datei für erweiterte Konfigurationen konfigurieren. Sie können zusätzliche Produkte aktivieren, eines der Standardprodukte deaktivieren sowie Ihre SQL-DBs und deren jeweilige Verbindungszeichenfolgen und Zertifikate konfigurieren. Beim HA-fähigen Produktionsmodus mit mehreren Knoten ist die Hochverfügbarkeit standardmäßig aktiviert, kann aber bei Bedarf auch deaktiviert werden.
Für die erweiterte Konfiguration können Sie die folgenden Anweisungen heranziehen: Erweiterte Installation.
cluster_config.json
von der ersten Maschine im Cluster, auf der die Konfiguration durchgeführt wurde, auf alle anderen Maschinen.
AUF DER ERSTEN MASCHINE IM CLUSTER
Es gibt zwei Arten von Maschinen: Server und Agent.
- Server – Maschinen, auf denen die Kubernetes-Infrastruktur (d. h. apiserver, etcd) ausgeführt wird. Diese Komponenten verwalten den gesamten Cluster.
- Agent – Eine einfache Maschine, die zum Ausführen von Workloads verwendet wird.
Der HA-fähige Produktionsmodus mit mehreren Knoten erfordert mindestens 3 Servermaschinen. Die Installation von Task Mining erfordert das Hinzufügen einer zusätzlichen Maschine, die als Agent verwendet wird.
- Für eine HA-fähige Produktionsinstallation mit mehreren Knoten benötigen Sie einen Lastausgleich. Stellen Sie sicher, dass einer erstellt wurde und der Datenverkehr zwischen den Knoten verteilt ist. Der Domänenname des Lastausgleichs muss in der Datei
cluster_config.json
verwendet werden. - Sie benötigen mindestens einen Serverknoten und für HA (Hochverfügbarkeit) mindestens drei Serverknoten. Die Anzahl der Serverknoten muss ungerade sein.
Lesen Sie vor dem Ausführen der Installation die Lizenzvereinbarung.
Um die Lizenzvereinbarung zu akzeptieren, wählen Sie eine der folgenden Methoden:
- Option 1 (Umgebungsvariable) – Legen Sie die Umgebungsvariable
LICENSE_AGREEMENT
auf accept fest, indem Sie den folgenden Befehl ausführen:export LICENSE_AGREEMENT=accept
- Option 2 (Inline-Parameter) – Alternativ können Sie
--accept-license-agreement
an jede Ausführung voninstall-uipath.sh
anfügen.
Hochladen der Offlinepakete bei Verwendung einer internen Docker-Registrierung
Sobald alle Knoten verbunden sind und Sie eine interne Docker-Registrierung verwenden, laden Sie Ihre Offlinepakete hoch, indem Sie den folgenden Befehl auf dem ersten Knoten ausführen:
./configureUiPathAS.sh registry upload --offline-bundle /opt/UiPathAutomationSuite/sf.tar.gz --offline-tmp-folder /uipath/tmp
./configureUiPathAS.sh registry upload --offline-bundle /opt/UiPathAutomationSuite/sf.tar.gz --offline-tmp-folder /uipath/tmp
Beenden der Installation auf dem ersten Knoten
Sobald alle Knoten verbunden sind, wechseln Sie zum ersten Server, um die Installation der Automation Suite abzuschließen:
-
Überprüfen Sie, ob die Knoten ordnungsgemäß hinzugefügt wurden, indem Sie den folgenden Befehl ausführen:
sudo su export KUBECONFIG=/etc/rancher/rke2/rke2.yaml PATH=$PATH:/var/lib/rancher/rke2/bin kubectl get nodes
sudo su export KUBECONFIG=/etc/rancher/rke2/rke2.yaml PATH=$PATH:/var/lib/rancher/rke2/bin kubectl get nodes -
Wenn Sie mehr als einen Knoten in der Liste sehen, hat alles funktioniert.
-
Schließen Sie die Installation ab, indem Sie den folgenden Befehl ausführen:
./install-uipath.sh -i ./cluster_config.json -o ./output.json -f -s --install-type offline --offline-bundle /opt/UiPathAutomationSuite/sf.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement
./install-uipath.sh -i ./cluster_config.json -o ./output.json -f -s --install-type offline --offline-bundle /opt/UiPathAutomationSuite/sf.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement
Das ist der zeitaufwendigste Vorgang. Rechnen Sie mit ca. 2 Stunden.
Laden der optionalen Pakete
-
Um das optionale Document Understanding-Bundle zu laden, führen Sie den folgenden Befehl aus:
./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"
./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" -
Um das optionale Computer Vision-Paket zu laden, führen Sie den folgenden Befehl aus:
./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"
./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"
Abschließen einer AI Center-Installation
Wenn das AI Center einen externen Orchestrator erfordert, führen Sie den folgenden Befehl aus, um die Installation abzuschließen:
./configureUiPathAS.sh aicenter configure --installation-token <identity token>
./configureUiPathAS.sh aicenter configure --installation-token <identity token>
Bei der Installation werden selbstsignierte Zertifikate in Ihrem Namen erstellt. Die Azure-Bereitstellungsvorlage bietet Ihnen jedoch auch die Möglichkeit, zum Zeitpunkt der Installation ein von der Zertifizierungsstelle ausgestelltes Serverzertifikat bereitzustellen, anstatt ein automatisch generiertes, selbstsigniertes Zertifikat zu verwenden.
Selbstsignierte Zertifikate laufen in 90 Tagen ab und Sie müssen sie durch Zertifikate ersetzen, die von einer vertrauenswürdigen Zertifizierungsstelle signiert wurden, sobald die Installation abgeschlossen ist. Wenn Sie die Zertifikate nicht aktualisieren, funktioniert die Installation nach 90 Tagen nicht mehr.
Anweisungen finden Sie unter Verwalten von Zertifikaten.
Informationen zum Zugriff auf den neu erstellten Cluster und die Suite finden Sie unter Zugreifen auf die Automation Suite.
Informationen zum Ändern der PVC-Größe finden Sie unter Ändern der PVC-Größe.
- Überblick
- Schritt 1: Herunterladen der Installationspakete und Übertragen aller Dateien auf die erste Maschine
- Schritt 1.1: Herunterladen des Installationspakets
- Schritt 1.2: Übertragen aller heruntergeladenen Dateien auf die erste Maschine
- Schritt 2: Konfigurieren der Installation
- Schritt 2.1: Standardkonfiguration
- Schritt 2.2: Erweiterte Konfiguration (optional)
- Schritt 3: Kopieren der Installationsdateien auf alle anderen Cluster-Maschinen
- Schritt 4: Ausführen der Installation
- Schritt 4.1: Akzeptieren der Lizenzvereinbarung
- Schritt 4.2: Erstellen und Verbinden aller Maschinen mit dem Cluster
- Schritt 4.3: Fertigstellen der Installation der Suite
- Schritt 5: Abschließen der Installation
- Aktualisieren der Zertifikate
- Zugreifen auf die Automation Suite
- Ändern der PVC-Größe