Schritt 5: Zusammenführen von Organisationen in der Automation Suite

Eingabe des Migrationstools

Wenn Sie das Tool UiPath.OrganizationMigrationApp ausführen, müssen Sie die folgenden Details angeben:

• Die Liste der Organisations-IDs für das eigenständige Produkt
• Die Liste der Organisations-IDs für die Automation Suite

Weitere Informationen finden Sie unter Migrationstool-Parameter.

Hinweis:

Stellen Sie sicher, dass Sie dieselben Organisations-IDs verwenden wie die in Schritt 1: Verschieben der Identity-Organisationsdaten von der eigenständigen Bereitstellung in die Automation Suite identifizierten.

für Linux

Hinweis:

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

Um Organisationen in der Automation Suite zusammenzuführen, führen Sie den folgenden Befehl aus:

./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s '<list of tenant IDs of the standalone product separated by comma, e.g. tenantID1,tenantID2>' -d '<list of organization IDs of Automation Suite separated by comma, e.g. orgID1,orgID2>'

Hinweis:

• Stellen Sie sicher, dass Sie TrustServerCertificate=True für Quell- sowie für Ziel-SQL-Verbindungen in der Eingabe hinzufügen.
• Wenn Sie mehrere Organisationspaare zusammenführen möchten, stellen Sie sicher, dass die Organisations-ID-Sequence für das eigenständige Produkt und die Organisations-ID-Sequence für die Automation Suite übereinstimmen.
• Wenn Sie einen eigenständigen Mandanten zu einer Automation Suite-Organisation für alle Mandanten migrieren, können Sie den Befehl einmal für alle Migrationen ausführen. Wenn Sie jedoch mehrere eigenständige Mandanten zu einer Automation Suite-Organisation migrieren, müssen Sie den Befehl für jeden Mandanten separat ausführen, da Sie möglicherweise Benutzerkonflikte zwischen den Mandanten auflösen müssen. Das folgende Beispiel zeigt, wie der Befehl für jeden Mandanten separat ausgeführt wird: Zuweisung

./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant1' -d 'orgId1'
./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant2' -d 'orgId1'
./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant3' -d 'orgId1'

Anweisungen zum Beheben von Benutzerkonflikten beim Migrieren mehrerer eigenständiger Mandanten zu einer einzelnen Automation Suite-Organisation finden Sie unter Benutzerkonflikte lösen.

für Windows

Um Organisationen in der Automation Suite zusammenzuführen, führen Sie den folgenden Befehl aus:

./UiPath.OrganizationMigrationApp merge -i "<identity database connection of Automation Suite>" -o "<restored orchestrator DB in Automation Suite connection string>" -s "<list of tenant IDs of the standalone product separated by comma, e.g. tenantID1,tenantID2>" -d "<list of organization IDs of Automation Suite separated by comma, e.g. orgID1,orgID2>"

Hinweis:

• Stellen Sie sicher, dass Sie TrustServerCertificate=True für Quell- sowie für Ziel-SQL-Verbindungszeichenfolgen in der Eingabe hinzufügen.
• Wenn Sie einen eigenständigen Mandanten zu einer Automation Suite-Organisation für alle Mandanten migrieren, können Sie den Befehl einmal für alle Migrationen ausführen. Wenn Sie jedoch mehrere eigenständige Mandanten zu einer Automation Suite-Organisation migrieren, müssen Sie den Befehl für jeden Mandanten separat ausführen, da Sie möglicherweise Benutzerkonflikte zwischen den Mandanten auflösen müssen. Das folgende Beispiel zeigt, wie der Befehl für jeden Mandanten separat ausgeführt wird: Zuweisung

./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant1' -d 'orgId1'
./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant2' -d 'orgId1'
./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant3' -d 'orgId1'

Anweisungen zum Beheben von Benutzerkonflikten beim Migrieren mehrerer eigenständiger Mandanten zu einer einzelnen Automation Suite-Organisation finden Sie unter Benutzerkonflikte lösen.

Erwartungen zusammenführen

Benutzer

Hinweis:

Nur Benutzer, die ursprünglich aus dem eigenständigen Orchestrator stammen, haben nach der Migration zur Automation Suite Zugriff auf den Orchestrator.

Die folgende Tabelle bietet einen Einblick in mehrere Migrationsszenarien und deren Auswirkungen auf Benutzer:

Bedingung	Hat der Quellbenutzer eine E-Mail-Adresse?	Hat der Zielbenutzer eine E-Mail-Adresse?	Ist die E-Mail-Adresse des Quellbenutzers mit der des Zielbenutzers identisch?	Ist der Quellbenutzername mit dem Zielbenutzernamen identisch?	Ergebnis
1	✅	✅	❌	❌	Der Quellbenutzer wird in die Zielorganisation verschoben; Der Zielorganisationsbenutzer hat Zugriff auf den eigenständigen Orchestrator.
2	✅	✅	❌	✅	Der Quellbenutzer wird in die Zielorganisation verschoben; der Benutzer der Zielorganisation Zugriff auf den eigenständigen Orchestrator hat. Nach der Zusammenführung haben zwei Benutzer denselben Benutzernamen und müssen die E-Mail-Adresse verwenden, um sich anzumelden.
3	✅	✅	✅	✅ oder ❌	Der Quellbenutzer wird mit dem Zielbenutzer zusammengeführt; Der Zielbenutzer hat Zugriff auf den eigenständigen Orchestrator.
4	❌	❌	Keine Angabe	❌	Der Quellbenutzer wird in die Zielorganisation verschoben; Der Zielorganisationsbenutzer hat Zugriff auf den eigenständigen Orchestrator.
5	❌	❌	Keine Angabe	✅	Der Quellbenutzer wird mit dem Zielbenutzer zusammengeführt; Der Zielbenutzer hat Zugriff auf den eigenständigen Orchestrator.
6	✅	❌	Keine Angabe	❌	Der Quellbenutzer wird in die Zielorganisation verschoben; Der Zielorganisationsbenutzer hat Zugriff auf den eigenständigen Orchestrator.
7	✅	❌	Keine Angabe	✅	Sie müssen die E-Mail-Adresse für den Zielbenutzer manuell konfigurieren oder den Zielbenutzer entfernen. Wenn Sie die E-Mail-Adresse konfigurieren, wird der Quellbenutzer mit dem Zielbenutzer zusammengeführt, und der Zielbenutzer hat Zugriff auf den eigenständigen Orchestrator. Wenn Sie den Zielbenutzer entfernen, wird der Quellbenutzer in die Zielorganisation verschoben, und der Zielorganisationsbenutzer hat Zugriff auf den eigenständigen Orchestrator.
8	❌	✅	Keine Angabe	❌	Der Quellbenutzer wird in die Zielorganisation verschoben, und der Benutzer der Zielorganisation hat Zugriff auf den eigenständigen Orchestrator.
9	❌	✅	Keine Angabe	✅	Sie müssen die E-Mail-Adresse für den Zielbenutzer so konfigurieren, dass sie leer ist, oder den Zielbenutzer entfernen. Wenn Sie die E-Mail-Adresse als leer konfigurieren, wird der Quellbenutzer mit dem Zielbenutzer zusammengeführt, und der Zielbenutzer hat Zugriff auf den eigenständigen Orchestrator. Wenn Sie den Zielbenutzer entfernen, wird der Quellbenutzer in die Zielorganisation verschoben, und der Zielorganisationsbenutzer hat Zugriff auf den eigenständigen Orchestrator.

Roboterbenutzer

Wenn der Benutzername des Quell- und Zielroboters identisch ist, wird der Benutzer des Quellroboters an die Benutzer-ID angehängt und er wird zur Zielorganisation verschoben.

Benutzername des Quellroboters	Benutzername des Zielroboters	Benutzername des Quellroboters verschoben
SameRobot	SameRobot	sameRobot_47a26d4a-2180-4fdd-8e1e-2379300a1162

Gruppen

Wenn die Namen der Quell- und Zielrobotergruppe identisch sind, wird dem Quellroboterbenutzer ein String angehängt und er wird in die Zielorganisation verschoben.

Name der Quellgruppe	Name der Zielgruppe	Benutzername der Quellgruppe verschoben
gleicheGruppe	gleicheGruppe	sameGroup_db39a5c6-f73c-4011-b40e-4ea620fe3d01

Einstellungen

Wenn Quelleinstellungen und Zieleinstellungen denselben Namen haben, wird der Einstellungswert des Ziels verwendet.

Aktivieren von Insights nach dem Zusammenführen von Organisationen

Wenn Sie Insights migrieren, melden Sie sich nach Abschluss der Zusammenführung bei jeder Organisation an und aktivieren Sie Insights für jeden Mandanten, für den Insights zuvor in der eigenständigen Umgebung (MSI) aktiviert war.

Dieser Schritt ist erforderlich, da in der Insights-Datenbank, die die Automation Suite nach der Migration verwendet, Insights bereits aktiviert ist. Wenn Sie diesen Schritt überspringen, kann die Automation Suite in einen Zustand wechseln, in dem Insights für einen Mandanten aktiviert zu sein scheint, die Plattform aber die entsprechende Insights-Instanz nicht registriert hat.

Hinweis:

Aktivieren Sie Insights in jedem Mandanten, bevor Sie die Verbindungszeichenfolge aktualisieren. Dadurch wird sichergestellt, dass Insights korrekt mit der migrierten Datenbank verknüpft ist, und Konfigurationsinkonsistenzen vermieden werden.

Wenn die Zusammenführung der Organisation fehlgeschlagen ist

Wenn die Zusammenführung der Organisation fehlgeschlagen ist, überprüfen Sie die Protokolle. Führen Sie je nachdem, ob die Identitäts- oder die Orchestrator-Migration fehlgeschlagen ist, die folgenden Schritte aus:

Fehlgeschlagene Identitätsmigration

Wenn die Identitätsmigration fehlgeschlagen ist, können Sie einfach den Fehler beheben und den Befehl zur Organisationszusammenführung erneut ausführen. Dadurch werden alle Änderungen rückgängig gemacht, da wir eine Transaktion für Vorgänge für Identity festgelegt haben.

Fehlgeschlagene Orchestrator-Migration

Wenn die Migration des Orchestrators fehlschlägt, wurde die Orchestrator-Datenbank zurückgesetzt, aber die Identity-Datenbank wurde nicht zurückgesetzt. Daher müssen Sie die Sicherung der Identity-Datenbank wiederherstellen und die Verbindungszeichenfolge ersetzen, um die neue Datenbank zu verwenden. Führen Sie nach dem Beheben des Fehlers den Befehl zum Zusammenführen der Organisation erneut aus.

Wenn die Migration des Orchestrators fehlgeschlagen ist, führen Sie die folgenden Schritte aus:

1. Stellen Sie die Sicherung der Identitätsdatenbank wieder her.

   1. Klicken Sie mit der rechten Maustaste auf das Datenbankverzeichnis und wählen Sie Datenebenen-Anwendung importieren aus.

      

   2. Wählen Sie die Sicherungsdatenbankdatei aus.

      

   3. Geben Sie den Namen der Sicherungsdatenbank ein.

      

   4. Warten Sie, bis der Prozess abgeschlossen ist.

   

2. Ersetzen Sie die Identitätsverbindungszeichenfolge.

   `"platform": {
       "sql_connection_str": "<dotnet connection string>",   (added line)
       "enabled": true, 
   },`
   

3. Beheben Sie den Fehler, und verwenden Sie die neue Plattformverbindungszeichenfolge, um den Zusammenführungsbefehl erneut auszuführen.