Durchführen der Migration eines einzelnen Mandanten

Verwenden Sie das uipathctl-Migrationstool, um Daten zwischen Automation Suite-Clustern auf EKS/AKS zu migrieren.

Sie können das UiPath Automation Cloud-Migrationstool™ verwenden, um Entitäten automatisch von Ihrem eigenständigen Orchestrator zum Orchestrator-Dienst in der Automation Suite zu migrieren.

Auf dieser Seite finden Sie Details zum Typ der zu migrierenden Entitäten, die Anforderungen für die Migration vom eigenständigen Orchestrator zur Automation Suite, das spezifische Migrationsverfahren und alle Vorgänge, die nach der Migration erforderlich sein können.

Zu migrierende Entitäten

Wenn Sie das Automation Cloud-Migrationstool ausführen, werden automatisch die folgenden Entitäten in der Automation Suite erstellt, um Ihrem eigenständigen Orchestrator zu entsprechen:

Entität	Migriert	Nicht migriert
Einstellungen	Ja, mit Ausnahmen (siehe rechts).	Einige lokale Einstellungen, die dem Mandanten auf dem gelesenen Pfad offengelegt werden, können in der Cloud nicht geändert werden, z. B. das Hostlogo und die Farbe. Kennwörter in der Tabelle „Einstellungen“ können nicht exportiert werden, da die API die Werte aus der Antwort entfernt. Infolgedessen werden keine Kennwörter migriert. Dies betrifft E-Mail-Warnungen (SMTP-Kennwort) und externe Feeds mit Standardauthentifizierung.
Pakete	Migriert alle Pakete und alle Paketversionen. Wenn ein Paketfeed extern ist und mit grundlegender Authentifizierung konfiguriert ist, müssen die Anmeldeinformationen nach Abschluss der Migration eingegeben werden.	Wenn ein Paketfeed extern ist und nicht über das Internet zugänglich ist, werden Entitäten, die auf diese Pakete angewiesen sind, nicht migriert.
Bibliotheken	Nur Feeds auf Mandantenebene.	Wenn sich ein Bibliotheksfeed auf Hostebene oder extern befindet und nicht über das Internet zugänglich ist, werden Entitäten, die auf diese Bibliotheken angewiesen sind, nicht migriert.
Kalender	Ja	Keine Angabe
Maschinen	Ja, aber wenn nicht genügend Lizenzen für die Zuweisung von Plätzen vorhanden sind, wird die Maschine importiert, wobei alle Plätze auf 0 festgelegt sind.	Maschinenschlüssel werden nicht migriert.
Ordner	Ja. Sie können alle Ordner in einem Massenauftrag sowie einzelne Ordner migrieren.	Persönliche Arbeitsbereichsordner werden nicht migriert.
Umgebungen	Ja, für klassische Ordner.	Nicht zutreffend für moderne Ordner.
Roboter (klassisch)	Ja, aber wenn nicht genügend Lizenzen für die Robotererstellung vorhanden sind, wird der Roboter während des Imports übersprungen.	Wird übersprungen, wenn es nicht mehr genug Lizenzen gibt; ein Fehler wird jeweils protokolliert wird.
Roboter (modern)	Moderne Roboter werden migriert, wenn der Benutzer, mit dem sie verknüpft sind, in der Automation Suite vorhanden ist und dieselbe E-Mail-Adresse hat.	– Wenn der Benutzer in der Automation Suite nicht vorhanden ist, schlägt diese spezifische Robotermigration fehl. – Wird übersprungen, wenn die Lizenzen ausgehen, und für jede wird ein Fehler protokolliert.
Umgebungszuordnungen	Die Zuordnung der Roboter-Umgebung wird migriert.	Keine Angabe
Prozesse	Prozesse werden migriert. Das Tool bezeichnet sie mitunter als Releases.	Keine Angabe
Warteschlangen	Ja	Keine Angabe
Auslöser	Trigger werden migriert, sind aber alle deaktiviert.
Assets	- Asset-Typen Boolesch, Text und Integer werden vollständig unterstützt. – Anmeldeinformationsassets werden ebenfalls migriert, aber es wird ein Dummy-Kennwort verwendet, da Kennwörter nicht vom Tool migriert werden können. Nach der Migration müssen Sie die Kennwörter für jedes Anmeldeinformations-Asset manuell aktualisieren. Anmeldeinformationsassets werden dem Standard-Anmeldeinformationsspeicher in der Automation Suite zugewiesen. – Auch pro Roboter werden migriert, aber wenn der Roboter nicht migriert wurde, wird dieser Wert übersprungen und eine Importwarnung wird protokolliert.	Asset-Werte pro Benutzer in modernen Ordnern werden nicht unterstützt. Das Asset wird mit dem Standardwert importiert oder übersprungen, wenn keiner festgelegt ist.
Maschinenzuordnungen	Roboter-Maschinen-Zuordnungen werden migriert.	Keine Angabe

Entitäten, die nicht migriert werden

Die folgenden Entitäten werden nicht vom Tool migriert:

• Ordner-Feeds
• Benutzer
• Warteschlangenelemente
• Aktionskataloge
• Webhooks
• Test-Entitäten (Testsätze, Testfälle, Testausführungen, Testzeitpläne, Testdatenwarteschlangen)
• Protokolle

Voraussetzungen

Bevor Sie das Tool öffnen, treffen Sie die folgenden Vorbereitungen:

1. Stellen Sie sicher, dass Sie über ausreichend viele Roboterlizenzen in der Automation Suite verfügen, die der Anzahl der migrierten Roboter entspricht (Admin > Lizenzen > Roboter und Dienste). Das Tool migriert Roboter nur, solange Lizenzen verfügbar sind. Danach beginnt es, Roboter zu überspringen.
2. Sie benötigen Administrator-Anmeldeinformationen für den eigenständigen Orchestrator und Zugriff auf die Ansicht aller zu migrierenden Entitäten. Wenn Sie für einige Entitäten nicht über die Berechtigung zum Anzeigen verfügen, werden diese Entitäten nicht migriert.
3. Sie müssen ein Organisationsadministrator in der Automation Suite sein.
4. Um das Tool auszuführen, benötigen Sie eine Maschine, die:
   1. eine Verbindung mit dem eigenständigen Orchestrator und der Automation Suite (mit Internetzugang) herstellen kann
   2. Windows als Betriebssystem hat
   3. Wenn es sich über einen Proxy mit der Automation Suite verbindet, sind die Variablen HTTP_PROXY, HTTPS_PROXY und NO_PROXY als Systemumgebungsvariablen festgelegt, wobei NO_PROXY die Hosts auflistet, die das Tool direkt erreichen muss, z. B. Ihren eigenständigen Orchestrator. Ohne diese Variablen schlägt der Importschritt fehl.
5. Laden Sie UiPath.AutomationCloudMigrationTool.zip auf die genannte Maschine herunter.
6. Registrieren Sie das Tool als externe Anwendung in der Automation Suite-Zielorganisation.

Registrieren des Tools als externe Anwendung

Das Migrationstool muss sich mit der Orchestrator-Dienst-API in der Automation Suite verbinden, um die migrierten Entitäten zu erstellen. Es verwendet dafür den OAuth-Flow und muss daher in der Automation Suite als externe Anwendung registriert sein.

1. Follow these instructions to add the tool as a new external application with the following specifics:
   • Typ: Nicht vertraulich
   • Ressourcen: Orchestrator-API
   • Benutzer-Scopes: OR.Folders, OR.Settings, OR.Robots, OR.Machines, OR.Execution, OR.Assets, OR.Users, OR.Jobs und OR.Queues.
   • Umleitungs-URL: http://127.0.0.1:8888/auth/
2. Speichern Sie die Anwendungs-ID für die spätere Verwendung.

Ausführen des Tools

Das Tool kann jeweils einen Mandanten gleichzeitig migrieren. Sie können das Tool für jeden Ihrer Mandanten mehrmals ausführen.

Bei jeder Ausführung tut das Tool Folgendes:

1. Stellt eine Verbindung mit Ihrem eigenständigen Orchestrator her, um Entitäten für den angegebenen Mandanten zu exportieren.
2. Stellt eine Verbindung mit der Automation Suite zum Importieren und Erstellen der migrierten Entitäten im Orchestrator-Mandanten her.

For more information about entities that are subject to migration, refer to Entities Being Migrated.

Ausführen des Tools:

1. Extrahieren Sie die ZIP-Datei, die Sie für das Tool heruntergeladen haben, und führen Sie dann die EXE-Datei des Tools aus.

2. Wählen Sie für die Aktivierungsmethode Verbindung mit lokalem Orchestrator herstellen aus:

   

3. Geben Sie die Informationen ein, damit das Tool eine Verbindung mit Ihrem eigenständigen Orchestrator herstellen kann:

   

   Stellen Sie sicher, dass die von Ihnen angegebenen Anmeldeinformationen für ein Administratorkonto vorgesehen sind, das auch Berechtigungen zur Ansicht für alle Entitäten hat, die Sie migrieren möchten.

4. Wählen Sie Export starten aus , um eine Verbindung mit dem eigenständigen Orchestrator herzustellen, und laden Sie die Setup-Informationen herunter. Der Export beginnt und kann eine Weile dauern:

   

   Nach Abschluss listet die Exportzusammenfassung alle Entitäten auf, die erfolgreich exportiert wurden:

   

   Sie können Datei öffnen auswählen, um die lokale Datei anzuzeigen, die für die Exportzusammenfassung erstellt wurde, die einige weitere Details enthält.

5. Wählen Sie Start aus, um zum ersten Bildschirm zurückzukehren.

6. Für die Aktivierungsmethode wählen Sie diesmal Verbindung mit Automation Suite herstellen aus.

7. Geben Sie die Informationen ein, damit das Tool eine Verbindung mit der Automation Suite herstellen kann, um die Setup-Informationen hochzuladen:

   

   Feld	Details
   Organisations-URL	Die URL Ihrer Automation Suite-Organisation. Organisationsadministratoren finden den Organisationsnamen unter Admin > Organisationseinstellungen. Geben Sie zum Beispiel https://mySite.com/myOrgName ein.
   Anwendungs-ID	Der Wert Anwendungs-ID der Registrierung der externen Anwendung in der Automation Suite. Diesen Wert finden Sie unter Administrator > Seite Externe Anwendungen.
   Name des Mandanten (Tenant Name)	Der genaue Name des Automation Suite-Mandanten, in dem Sie die migrierten Informationen hinzufügen möchten. Die migrierten Daten sind im angegebenen Orchestrator-Mandanten sichtbar.
   Identitäts-URL (optional)	Die Identitätsendpunkt-URL für Ihre Automation Suite-Organisation. Geben Sie zum Beispiel https://mySite.com/myOrgName/identity_ ein.

8. Wählen Sie Import starten aus , um eine Verbindung mit der Automation Suite herzustellen und mit der Migration der Informationen zum Ziel-Orchestrator-Mandanten zu beginnen.

   Der Import beginnt und kann eine Weile dauern:

   

   To connect to Automation Suite using OAuth, a user with the adequate permissions for the scopes added when you registered the external application must log in to Automation Suite. When they do, a new window opens with a success message if the OAuth flow was successful:

   

   Nach Abschluss werden in der Importzusammenfassung alle Entitäten aufgelistet, die erfolgreich in den Orchestrator-Mandanten in der Automation Suite importiert wurden:

   

   Alles, was nicht importiert wurde, wird als Fehler aufgeführt; Teilimporte werden als Warnungen aufgeführt. Sie können Bericht anzeigen auswählen, um weitere Informationen darüber zu erhalten, bei welchen Entitäten ein Fehler oder eine Warnung auftrat.

9. Wenn Sie fertig sind, wählen Sie Fertig aus, um das Tool zu schließen.

   Tipp:

   Bei Bedarf können Sie das Tool erneut ausführen, um Daten für zusätzliche Mandanten zu migrieren.

Aufgaben nach der Migration

Da das Tool nicht alles migrieren kann, müssen Sie einige letzte Aufgaben manuell ausführen, um das gleiche Setup wie in Ihrem eigenständigen Orchestrator zu erhalten.

1. Melden Sie sich in der Automation Suite bei der Organisation des Mandanten an, der das Importziel war, und öffnen Sie dann den Orchestrator.

2. Überprüfen Sie, ob Ordner und Entitäten erfolgreich migriert wurden.

   Sie können die Importzusammenfassung verwenden, um diejenigen Elemente zu überprüfen, die Warnungen oder Fehler hatten.

3. Weisen Sie Roboter- und Dienstlizenzen für den Orchestrator zu.

   Maschinen werden erstellt und lizenziert, solange verfügbare Lizenzen vorhanden sind. Sind keine Lizenzen mehr vorhanden, werden jedoch weiterhin Maschinen ohne Lizenzen erstellt, weshalb Sie solche Maschinen aktualisieren müssen, um die entsprechende Anzahl von Lizenzen zuzuweisen.

   Hinweis:

   Wenn Sie ohne Aktivierung Ihrer Automation Suite-Lizenz migriert haben, müssen Sie sie an diesem Punkt aktivieren, um mit dem Setup fortzufahren.

4. Laden Sie manuell alle Bibliotheksfeeds hoch, die das Tool nicht migriert hat.

5. Wenn Roboter beim Export oder Import übersprungen wurden, erstellen Sie sie manuell.

6. Erstellen Sie alle Webhooks, Aufgabenkataloge, Anmeldeinformationsspeicher oder andere Informationen, die das Tool nicht migriert.

   The section Entities being migrated includes a list of what the tool does not migrate.

7. Verbinden Sie Roboter manuell mit dem Automation Suite-Orchestrator-Dienst.

8. Aktivieren Sie Trigger nach Bedarf manuell.

   Während das Tool Trigger migriert, sind alle deaktiviert; Sie müssen sie manuell aktivieren.

9. Überprüfen Sie alle Stellen im Orchestrator, an denen ein Kennwort erforderlich ist, und fügen Sie es hinzu: Roboter, Einstellungen und Anmeldeinformationsassets.

Hilfe erhalten

Wenn Sie Unterstützung bei einem Problem benötigen, das beim Export, Importieren oder nach dem Import aufgetreten ist, öffnen Sie ein Support-Ticket und fügen Sie die folgenden Dateien an:

• Protokolldatei (im Unterordner Protokolle)
• Export-Berichtsdatei (im Unterordner MigrationAssets)
• Import-Berichtsdatei (im Unterordner MigrationAssets)

Zusätzlich zu diesen Dateien sind die folgenden Informationen hilfreich:

• Die Version Ihres eigenständigen Orchestrators
• Die Namen Ihrer Automation Suite-Organisation und Ihrer Mandanten