- Überblick
- Anforderungen
- Installation
- Voraussetzungsprüfungen
- Herunterladen der Installationspakete
- uipathctl-Cluster
- uipathctl-Clusterwartung
- uipathctl cluster maintenance disable
- uipathctl cluster maintenance enable
- uipathctl cluster maintenance is-enabled
- uipathctl cluster migration
- uipathctl cluster migration export
- uipathctl cluster migration import
- uipathctl cluster migration run
- uipathctl-Cluster-Upgrade
- uipathctl config
- uipathctl config add-host-admin
- uipathctl config additional-ca-certificates
- uipathctl config additional-ca-certificates get
- uipathctl config additional-ca-certificates update
- uipathctl config-Warnungen
- uipathctl config Alerts add-email
- uipathctl config alerts remove-email
- uipathctl config alerts update-email
- uipathctl config argocd
- uipathctl config argocd ca-certificates
- uipathctl config argocd ca-certificates get
- uipathctl config argocd ca-certificates update
- uipathctl config argocd generate-dex-config
- uipathctl config argocd generate-rbac
- uipathctl config argocd registry
- uipathctl config argocd registry get
- uipathctl config argocd registry update
- uipathctl config enable-basic-auth
- uipathctl config Orchestrator
- uipathctl config Orchestrator get-config
- uipathctl config orchestrator update-config
- uipathctl config saml-certificates get
- uipathctl config saml-certificates rotate
- uipathctl config saml-certificates update
- uipathctl config tls-certificates
- uipathctl config tls-certificates get
- uipathctl config tls-certificates update
- uipathctl config token-signing-certificates
- uipathctl config token-signing-certificates get
- uipathctl config token-signing-certificates rotate
- uipathctl config token-signing-certificates update
- UiPathctl-Zustand
- Uipathctl-Gesundheitspaket
- Uipathctl-Zustandsprüfung
- uipathctl health diagnose
- uipathctl health test
- uipathctl-Manifest
- uipathctl manifest apply
- uipathctl manifest diff
- uipathctl manifest get
- uipathctl manifest get-revision
- uipathctl Manifest list-applications
- uipathctl manifest list-revisions
- uipathctl manifest render
- uipathctl-Voraussetzung
- uipathctl prereq create
- uipathctl prereq run
- „uipathctl“-Ressource
- uipathctl-Ressourcenbericht
- uipathctl-Snapshot
- uipathctl-Snapshot-Sicherung
- uipathctl snapshot backup create
- uipathctl snapshot backup disable
- uipathctl snapshot backup enable
- uipathctl snapshot delete
- uipathctl snapshot list
- uipathctl snapshot restore
- uipathctl snapshot restore create
- uipathctl snapshot restore delete
- uipathctl snapshot restore history
- uipathctl snapshot restore logs
- uipathctl-Version
- Nach der Installation
- Migration und Upgrade
- Aktualisieren der Automation Suite auf EKS/AKS
- 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
- Überwachung und Warnungen
- Clusterverwaltung
- 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
- Fehlersuche und ‑behebung
Schritt 1: Verschieben der Identitätsorganisationsdaten von einer eigenständigen in die Automation Suite
Die eigenständige Version und die Automation Suite -Versionen müssen identisch sein, andernfalls schlägt die Migration aufgrund von Problemen mit Datenbankschemakonflikten fehl. Wenn ein Kompatibilitätsfehler auftritt, stellen Sie sicher, dass Sie Ihre eigenständigen und Automation Suite Installationen auf die neueste Version aktualisieren.
Bevor Sie beginnen, sollten Sie Folgendes beachten:
-
Stellen Sie sicher, dass Sie .NET Runtime 6.0 herunterladen und installieren, bevor Sie UiPath.OrganizationMigrationApp ausführen. Weitere Informationen finden Sie unter Migrationsvoraussetzungen.
-
Informationen zum Herunterladen von UiPath.OrganizationMigrationApp finden Sie unter Migrationsvoraussetzungen.
\
vor Sonderzeichen hinzufügen.
In diesem Abschnitt werden einige gängige Vorgänge beschrieben, die Sie möglicherweise mit dem Uipath.Organization.Migration.App-Tool ausführen müssen. Weitere Informationen zu den Parametern, die das Uipath.Organization.Migration.App-Tool unterstützt, finden Sie unter Migrationstool-Parameter.
-
Um die Identitätsdaten aller Mandanten von der eigenständigen Installation in die Automation Suite zu verschieben, extrahieren Sie die Datei und führen Sie den folgenden Befehl aus:
./UiPath.OrganizationMigrationApp migrate -m -i '<identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<orchestrator database connection of the standalone product>' -s '<list of organization IDs of the standalone product>' -d '<list of organization IDs of Automation Suite>' -p '<URL of Automation Suite>' -c '<OMS S2S client secret>'
./UiPath.OrganizationMigrationApp migrate -m -i '<identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<orchestrator database connection of the standalone product>' -s '<list of organization IDs of the standalone product>' -d '<list of organization IDs of Automation Suite>' -p '<URL of Automation Suite>' -c '<OMS S2S client secret>'Hinweis:-
Stellen Sie sicher, dass Sie
TrustServerCertificate=True
für alle SQL-Verbindungen in der Eingabe hinzufügen. -
Das Format des automatisch generierten Mandantennamens ist
tenant_xxxxxxxx
, wobeixxxxxxxx
die ersten acht Zeichen der Automation Suite-Organisations-ID darstellt. Dies ist der Mandant, zu dem Sie die eigenständigen Produkte migrieren.
-
-
Wenn der Vorgang zwischendurch fehlgeschlagen ist, machen Sie die Änderung rückgängig, indem Sie den folgenden Befehl ausführen:
./UiPath.OrganizationMigrationApp migrate -m -r -i '<identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<orchestrator database connection of the standalone product>' -s '<list of organization IDs of the standalone product>' -d '<list of organization IDs of Automation Suite>' -p '<URL of Automation Suite>' -c '<OMS S2S client secret>'
./UiPath.OrganizationMigrationApp migrate -m -r -i '<identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<orchestrator database connection of the standalone product>' -s '<list of organization IDs of the standalone product>' -d '<list of organization IDs of Automation Suite>' -p '<URL of Automation Suite>' -c '<OMS S2S client secret>' -
Beheben Sie das Problem gemäß der Fehlermeldung und versuchen Sie erneut, die Identitätsdaten aller Mandanten von der eigenständigen Bereitstellung in die Automation Suite zu verschieben. Sehen Sie sich zum Beispiel die folgenden Fehlermeldungen an und was sie bedeuten:
-
Die folgende Fehlermeldung bedeutet, dass der Mandant bereits erstellt wurde und das Programm die Mandantenerstellung überspringen würde. Sie müssen nichts tun.
Call to API Service failed for Method=POST, StatusCode=Conflict on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/organization/api/organization/0dad76a9-7d44-447a-84d6-ce713a5324d8/tenants Http Response Content:{"StatusCode":409,"StatusDescription":"Conflict","ErrorCode":1002,"Message":"Found duplicated tenant with requested Id b26f486f-a585-4420-83fd-f2741385b3c8 under organization 0dad76a9-7d44-447a-84d6-ce713a5324d8 (1002)"}
Call to API Service failed for Method=POST, StatusCode=Conflict on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/organization/api/organization/0dad76a9-7d44-447a-84d6-ce713a5324d8/tenants Http Response Content:{"StatusCode":409,"StatusDescription":"Conflict","ErrorCode":1002,"Message":"Found duplicated tenant with requested Id b26f486f-a585-4420-83fd-f2741385b3c8 under organization 0dad76a9-7d44-447a-84d6-ce713a5324d8 (1002)"} -
Die folgende Fehlermeldung bedeutet, dass die Automation Suite-URL nicht gültig ist. Stellen Sie sicher, dass Sie die richtige Automation Suite-URL angeben.
Unhandled exception. UiPath.IdentityServer.PartitionMerge.PartitionMergeException: Can not create tenant ID with target organiztion ID 0dad76a9-7d44-447a-84d6-ce713a5324d8, tenant name tenant_0dad76a9, platform url https://ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com. ---> System.Net.Http.HttpRequestException: No such host is known. (ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com:443) ---> System.Net.Sockets.SocketException (11001): No such host is known.
Unhandled exception. UiPath.IdentityServer.PartitionMerge.PartitionMergeException: Can not create tenant ID with target organiztion ID 0dad76a9-7d44-447a-84d6-ce713a5324d8, tenant name tenant_0dad76a9, platform url https://ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com. ---> System.Net.Http.HttpRequestException: No such host is known. (ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com:443) ---> System.Net.Sockets.SocketException (11001): No such host is known. -
Die folgende Fehlermeldung bedeutet, dass der geheime Schlüssel des OMS S2S-Clients nicht gültig ist. Stellen Sie sicher, dass Sie den richtigen geheimen Schlüssel des OMS S2S-Clients angeben.
Call to API Service failed for Method=POST, StatusCode=BadRequest on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/identity_/connect/token Http Response Content:{"error":"invalid_client"}
Call to API Service failed for Method=POST, StatusCode=BadRequest on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/identity_/connect/token Http Response Content:{"error":"invalid_client"}
-
Bevor Sie beginnen, sollten Sie die folgenden Aspekte berücksichtigen:
-
Sie müssen .NET Runtime 6.0 herunterladen und installieren, bevor Sie UiPath.OrganizationMigrationApp ausführen. Weitere Informationen finden Sie unter Migrationsvoraussetzungen.
-
Informationen zum Herunterladen von UiPath.OrganizationMigrationApp finden Sie unter Migrationsvoraussetzungen.
$
durch \`$
ersetzen. Weitere Richtlinien zum Escapen von Sonderzeichen in Kennwörtern von Verbindungszeichenfolgen finden Sie unter Escape-Regeln für Sonderzeichen bei Kennwörtern von Verbindungszeichenfolgen.
In diesem Abschnitt werden einige gängige Vorgänge beschrieben, die Sie möglicherweise mit dem Uipath.Organization.Migration.App-Tool ausführen müssen. Weitere Informationen zu den Parametern, die das Uipath.Organization.Migration.App-Tool unterstützt, finden Sie unter Migrationstool-Parameter.
-
Um die Identitätsdaten aller Mandanten von der eigenständigen Installation in die Automation Suite zu verschieben, extrahieren Sie die Datei und führen Sie den folgenden Befehl aus.Hinweis:
-
Stellen Sie sicher, dass Sie
TrustServerCertificate=True
für sowohl Quell- als auch Ziel-SQL-Verbindungseingaben hinzufügen. -
Nach dem Ausführen des folgenden Befehls wird ein neuer Mandant mit dem Namen
tenant_xxxxxx
erstellt, wobeixxxxxx
die ersten sechs Zeichen oder die Organisations-ID darstellt. Dies ist der Mandant, zu dem Sie die eigenständigen Produkte migrieren.
./UiPath.OrganizationMigrationApp migrate -m -i "<identity database connection of the standalone product>" -j "<identity database connection of Automation Suite>" -o "<orchestrator database connection of the standalone product>" -s "<list of organization IDs of the standalone product>" -d "<list of organization IDs of Automation Suite>" -p "<URL of Automation Suite>" -c "<OMS S2S client secret>"
./UiPath.OrganizationMigrationApp migrate -m -i "<identity database connection of the standalone product>" -j "<identity database connection of Automation Suite>" -o "<orchestrator database connection of the standalone product>" -s "<list of organization IDs of the standalone product>" -d "<list of organization IDs of Automation Suite>" -p "<URL of Automation Suite>" -c "<OMS S2S client secret>" -
-
Wenn der Vorgang zwischendurch fehlgeschlagen ist, machen Sie die Änderung rückgängig, indem Sie den folgenden Befehl ausführen:
./UiPath.OrganizationMigrationApp migrate -m -r -i "<identity database connection of the standalone product>" -j "<identity database connection of Automation Suite>" -o "<orchestrator database connection of the standalone product>" -s "<list of organization IDs of the standalone product>" -d "<list of organization IDs of Automation Suite>" -p "<URL of Automation Suite>" -c "<OMS S2S client secret>"
./UiPath.OrganizationMigrationApp migrate -m -r -i "<identity database connection of the standalone product>" -j "<identity database connection of Automation Suite>" -o "<orchestrator database connection of the standalone product>" -s "<list of organization IDs of the standalone product>" -d "<list of organization IDs of Automation Suite>" -p "<URL of Automation Suite>" -c "<OMS S2S client secret>" -
Beheben Sie das Problem basierend auf der Fehlermeldung und versuchen Sie erneut, die Identitätsdaten aller Mandanten von der eigenständigen Bereitstellung in die Automation Suite zu verschieben. Sehen Sie sich zum Beispiel die folgenden Fehlermeldungen an und was sie bedeuten:
-
Die folgende Fehlermeldung bedeutet, dass der Mandant bereits erstellt wurde und das Programm die Mandantenerstellung überspringen würde. Sie müssen nichts tun.
Call to API Service failed for Method=POST, StatusCode=Conflict on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/organization/api/organization/0dad76a9-7d44-447a-84d6-ce713a5324d8/tenants Http Response Content:{"StatusCode":409,"StatusDescription":"Conflict","ErrorCode":1002,"Message":"Found duplicated tenant with requested Id b26f486f-a585-4420-83fd-f2741385b3c8 under organization 0dad76a9-7d44-447a-84d6-ce713a5324d8 (1002)"}
Call to API Service failed for Method=POST, StatusCode=Conflict on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/organization/api/organization/0dad76a9-7d44-447a-84d6-ce713a5324d8/tenants Http Response Content:{"StatusCode":409,"StatusDescription":"Conflict","ErrorCode":1002,"Message":"Found duplicated tenant with requested Id b26f486f-a585-4420-83fd-f2741385b3c8 under organization 0dad76a9-7d44-447a-84d6-ce713a5324d8 (1002)"} -
Die folgende Fehlermeldung bedeutet, dass die Automation Suite-URL nicht gültig ist. Stellen Sie sicher, dass Sie die richtige Automation Suite-URL angeben.
Unhandled exception. UiPath.IdentityServer.PartitionMerge.PartitionMergeException: Can not create tenant ID with target organiztion ID 0dad76a9-7d44-447a-84d6-ce713a5324d8, tenant name tenant_0dad76a9, platform url https://ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com. ---> System.Net.Http.HttpRequestException: No such host is known. (ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com:443) ---> System.Net.Sockets.SocketException (11001): No such host is known.
Unhandled exception. UiPath.IdentityServer.PartitionMerge.PartitionMergeException: Can not create tenant ID with target organiztion ID 0dad76a9-7d44-447a-84d6-ce713a5324d8, tenant name tenant_0dad76a9, platform url https://ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com. ---> System.Net.Http.HttpRequestException: No such host is known. (ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com:443) ---> System.Net.Sockets.SocketException (11001): No such host is known. -
Die folgende Fehlermeldung bedeutet, dass der geheime Schlüssel des OMS S2S-Clients nicht gültig ist. Stellen Sie sicher, dass Sie den richtigen geheimen Schlüssel des OMS S2S-Clients angeben.
Call to API Service failed for Method=POST, StatusCode=BadRequest on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/identity_/connect/token Http Response Content:{"error":"invalid_client"}
Call to API Service failed for Method=POST, StatusCode=BadRequest on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/identity_/connect/token Http Response Content:{"error":"invalid_client"}
-
In der folgenden Tabelle werden die Parameter beschrieben, die das Uipath.Organization.Migration.App-Tool unterstützt. Sie können diese Parameter unter Linux und Windows verwenden.
Parametername |
Kurzname |
Beschreibung |
---|---|---|
Identity-Datenbankverbindung des eigenständigen Produkts |
|
Die Identity-Datenbankverbindung des eigenständigen Produkts. Wenn Identity und Orchestrator dieselbe Datenbank verwenden, verwenden Sie die Verbindungszeichenfolge dieser Datenbank. |
Identitätsdatenbankverbindung der Automation Suite |
| Die Identitätsdatenbankverbindung der Automation Suite . |
Orchestrator-Datenbankverbindung des eigenständigen Produkts |
| Die Orchestrator-Datenbankverbindung des eigenständigen Produkts. Wenn Identity und Orchestrator dieselbe Datenbank verwenden, verwenden Sie die Verbindungszeichenfolge dieser Datenbank. |
Liste der Organisations-IDs des eigenständigen Produkts | s |
Die Liste der Organisations-IDs für das eigenständige Produkt, das zusammengeführt werden soll. Sie müssen das folgende Format verwenden:
orgId1,orgId2,...,orgId5 .
Die Größe der Organisations-ID-Liste muss für das eigenständige Produkt und die Automation Suite gleich sein. Um eine Liste der Organisations-IDs für das eigenständige Produkt abzurufen, führen Sie den folgenden Befehl für die eigenständige Datenbank aus und verwenden Sie
GlobalId mit dem zugehörigen Partitions-/Organisationsnamen in der wiederhergestellten Datenbank:
|
Liste der Organisations-IDs der Automation Suite | d |
Die Liste der Organisations-IDs für die Automation Suite. Verwenden Sie das folgende Format:
orgId1,orgId2,...,orgId5 .
Die Größe der Organisations-ID-Liste muss für das eigenständige Produkt und die Automation Suite gleich sein. Um eine Liste der Organisations-IDs für die Automation Suite abzurufen, führen Sie den folgenden Befehl für die
AutomationSuite_Platform -Datenbank auf dem Automation Suite-SQL-Server aus:
|
Rollback |
| Der Parameter, mit dem eine Änderung rückgängig gemacht wird. |
URL der Automation Suite |
|
Die URL der Automation Suite. Beispiel:
https://ci-asaks5380983.devtest-ascloudgen-ea.infra.uipath-dev.com/ . |
Geheimer Clientschlüssel OMS S2S |
|
Der geheime Clientschlüssel, der zum Aufrufen der OMS-API zum Erstellen des Mandanten verwendet wird. Um den geheimen Schlüssel des OMS S2S-Clients aus dem geheimen Kubernetes-Schlüssel abzurufen, führen Sie den folgenden Befehl aus:
|