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.

für Linux

Hinweis:

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.

Ausführen des Tools

Hinweis:

Stellen Sie sicher, dass Sie die allgemeinen Escape-Anweisungen für das Shell-Tool Ihrer Wahl befolgen. In Bash müssen Sie beispielsweise \ vor Sonderzeichen hinzufügen.

Das UiPath.OrganizationMigrationApp-Tool unterstützt die folgenden Parameter:

Parametername	Kurzname	Beschreibung
Identitätsdatenbankverbindung des eigenständigen Produkts	i	Die Identitätsdatenbankverbindung des eigenständigen Produkts. Wenn Identity und Orchestrator dieselbe Datenbank verwenden, verwenden Sie die Verbindungszeichenfolge dieser Datenbank.
Identitätsdatenbankverbindung der Automation Suite	j	Die Identitätsdatenbankverbindung der Automation Suite .
Orchestrator database connection of the standalone product	o	The Orchestrator database connection of the standalone product. If Identity and Orchestrator share the same database, then use the connection string of that database.
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: SELECT * FROM [identity].[Partitions]
Liste der Organisations-IDs der Automation Suite	d	The list of organization IDs for Automation Suite. You must use the following 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: SELECT * FROM [identity].[Partitions]
Rollback	r	Der Parameter, mit dem eine Änderung rückgängig gemacht wird.
URL der Automation Suite	p	The URL of Automation Suite. For example, https://ci-asaks5380983.devtest-ascloudgen-ea.infra.uipath-dev.com/
OMS S2S-Clientgeheimschlüssel	c	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: kubectl get secret identity-client-oms -n uipath -o "jsonpath={.data.OMSS2SClient\.ClientSecret}" | base64 -d

Hier sind einige gängige Vorgänge, die Sie möglicherweise ausführen müssen:

• 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>'

  Hinweis:

  Stellen Sie sicher, dass Sie TrustServerCertificate=True für alle SQL-Verbindungen in der Eingabe hinzufügen.
• 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>'

• 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 beispielsweise die folgenden Fehlermeldungen und ihre Bedeutung an:

  • 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)"}

  • 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.

  • 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"}

für Windows

Hinweis:

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.

Ausführen des Tools

Hinweis:

Um das UiPath.OrganizationMigrationApp-Tool erfolgreich auszuführen, müssen Sie Ihr SQL-Kennwort im Escape-Format angeben, wenn es Sonderzeichen enthält. Zum Beispiel müssen Sie jedes Vorkommen von $ 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.

Hier sind einige gängige Vorgänge, die Sie möglicherweise ausführen müssen:

• 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.

  ./UiPath.OrganizationMigrationApp.exe migrate -a -m -s "<identity DB connection of MSI>" -d "<dentity DB connection of Automation Suite>"

• Wenn der Vorgang zwischendurch fehlgeschlagen ist, machen Sie die Änderung rückgängig, indem Sie den folgenden Befehl ausführen:

  ./UiPath.OrganizationMigrationApp.exe migrate -a -m -r -s "<identity DB connection of MSI>" -d "<dentity DB connection of Automation Suite>"

• Beheben Sie das Problem basierend auf der Fehlermeldung, und versuchen Sie erneut, die Identitätsdaten aller Mandanten von eigenständig in die Automation Suite zu verschieben.

• After running the previous command, a new tenant named tenant_xxxxxxxx is created, where xxxxxxxx are random characters. This is the tenant to which you will migrate the standalone products.