Verwenden des Migrationstools für Automation Cloud

Das Automation Cloud-Migrationstool ist eine Desktopanwendung zur Vereinfachung des Migrationsprozesses von einer Bereitstellungsoption zu einer anderen. Das Tool automatisiert verschiedene Migrationsschritte und erleichtert den Wechsel vom eigenständigen oder Automation Suite-Orchestrator zur Automation Cloud, Automation Cloud – Öffentlicher Sektor oder Automation Suite.

Die Anweisungen auf dieser Seite gelten für die Migration Ihres lokalen Orchestrators, entweder eigenständig oder über die Automation Suite, zur Automation Cloud.

Hinweis:

Beim Planen Ihres Upgrades oder Ihrer Migration wird empfohlen, dass Sie die Best Practices befolgen.

Das Automation Cloud-Migrationstool wird unabhängig betrieben und unterliegt nicht unserem standardmäßigen Produktlebenszyklus.

Anforderungen

Zur Verwendung des Migrationstools müssen die folgenden Kriterien erfüllt sein:

Die Version Ihres eigenständigen Orchestrators muss unterstützt werden. Spezifische Versionsdetails finden Sie in unserer Dokumentation zum Produktlebenszyklus.
Sie müssen über eine Pro-, Pro Trial- oder Enterprise-Lizenz in der Automation Cloud verfügen. Sie können das Tool während eines Pro Trial zur Evaluierung verwenden, aber es können einige Einschränkungen gelten, z. B. für Mandanten- und Roboterlizenzen. Weitere Informationen finden Sie in unserer Dokumentation zur Lizenzierung.

Voraussetzungen

Bevor Sie das Automation Cloud-Migrationstool öffnen, treffen Sie die folgenden Vorbereitungen:

Überprüfen Sie, ob der Enterprise- oder Enterprise-Test-Lizenzierungsplan in der Automation Cloud aktiv ist (Admin > Lizenzen).
Stellen Sie sicher, dass Sie über ausreichende Roboterlizenzen in der Automation Cloud 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.
Sie benötigen Administrator-Anmeldeinformationen für den lokalen Orchestrator und die Berechtigung zum Anzeigen für alle migrierten Entitäten. Wenn Sie für einige Entitäten nicht über die Berechtigung zum Anzeigen verfügen, werden diese Entitäten nicht migriert.
Sie müssen ein Organisationsadministrator in der Automation Cloud sein, um das Tool als externe Anwendung zu registrieren.
Die Maschine, auf der das Automation Cloud-Migrationstool ausgeführt wird, muss die folgenden Anforderungen erfüllen:
1. Sie kann sich mit dem lokalen Orchestrator verbinden;
2. Sie kann auf die Automation Cloud zugreifen (verfügt über einen Internetzugang und einen unterstützten Browser);
3. Sie wird unter Windows ausgeführt;
4. .NET Core Desktop Runtime für x64 ist installiert.
Laden Sie das Migrationstool auf eine Maschine herunter, die die Anforderungen von Schritt 5 erfüllt.

Vom Migrationstool migrierte Entitäten

Beim Verwenden des Migrationstools werden die folgenden Entitäten automatisch in der Automation Cloud erstellt, um Ihr Orchestrator-Setup widerzuspiegeln:

Entität	Migriert	Nicht migriert
Einstellungen	Ja, mit Ausnahmen.	Einige lokale Einstellungen, z. B. Kennwörter und bestimmte Einstellungen von Mandanten
Pakete	Alle Pakete und Paketversionen.	Entitäten, die externe Paketfeeds nutzen, die eine Authentifizierung erfordern. Die Authentifizierung ist nach Abschluss der Migration für externe Paketfeeds erforderlich, die mit der Standardauthentifizierung konfiguriert sind
Bibliotheken	Nur Feeds auf Mandantenebene.	Entitäten, die Bibliotheken mit Konfigurationen auf Hostebene oder nicht zugängliche externe Bibliotheken nutzen
Kalender	Ja	Keine Angabe
Maschinen	Ja Hinweis: Potenzielle Einschränkungen bei Zuweisungen von Maschinenslots aufgrund fehlender Lizenzen.	Maschinenschlüssel
Ordner	Ja	Ordner des persönlichen Arbeitsbereichs.
Umgebungen	Ja, für klassische Ordner.	Keine Angabe (für moderne Ordner)
Roboter (klassisch)	Ja Hinweis: Potenzielle Einschränkungen bei der Robotererstellung aufgrund fehlender Lizenzen.	Wird übersprungen, wenn die Lizenzen ausgehen, wobei ein Fehler für jeden übersprungenen Roboter protokolliert wird.
Roboter (modern)	Ja Hinweis: Wenn bestimmte Bedingungen erfüllt sind, werden Roboter einem lokalen Benutzer zugeordnet, der eine E-Mail-Adresse hat, mit der er bereits zur Automation Cloud eingeladen wurde und die einem Benutzer zugeordnet ist.	Wird übersprungen, wenn die Lizenzen ausgehen, wobei ein Fehler für jeden übersprungenen Roboter protokolliert wird. Schlägt fehl, wenn ein Benutzer in der Automation Cloud nicht vorhanden ist.
Umgebungszuordnungen	Die Roboter-Umgebungs-Zuordnung	Keine Angabe
Prozesse	Ja Hinweis: Das Migrationstool bezeichnet Prozesse mitunter als Releases.	Keine Angabe
Warteschlangen	Ja	Keine Angabe
Auslöser	Ja, aber sie werden als deaktiviert eingestellt.	Keine Angabe
Assets	Bestimmte Asset-Typen werden vollständig unterstützt, mit einigen Besonderheiten bei Anmeldeinformations-Assets.	Asset-Werte pro Benutzer in modernen Ordnern
Ordner-Feeds	Ja	Keine Angabe

Vom Migrationstool nicht migrierte Entitäten

Die folgenden Entitäten werden nicht vom Tool migriert:

Benutzer- und Roboterkonten
Rollenzuweisungen
Warteschlangenelemente
Aktionskataloge
Webhooks
Test-Entitäten (Testsätze, Testfälle, Testausführungen, Testzeitpläne, Testdatenwarteschlangen)
Speicher-Buckets
Protokolle

Registrieren des Migrationstools als externe Anwendung

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

Um das Automation Cloud-Migrationstool als externe Anwendung zu registrieren, führen Sie die folgenden Schritte aus:

Fügen Sie das Tool als neue externe Anwendung hinzu, indem Sie die Anweisungen zum Hinzufügen einer externen Anwendung befolgen. Stellen Sie sicher, dass Sie die folgende Konfiguration verwenden:
- 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/
Speichern Sie die Anwendungs-ID für die spätere Verwendung.

Ausführen des Migrationstools

Das Migrationstool kann jeweils einen Mandanten gleichzeitig migrieren. Sie können das Tool für jeden Ihrer Mandanten ausführen. Bei jeder Ausführung führt das Tool die folgenden Vorgänge aus:

Stellt eine Verbindung mit Ihrem On-Premises Orchestrator her, um Entitäten für den angegebenen Mandanten zu exportieren.
Stellt eine Verbindung mit der Automation Cloud zum Importieren und Erstellen der migrierten Entitäten im Orchestrator her.

Weitere Informationen zu Entitäten, die einer Migration unterliegen, finden Sie unter Vom Migrationstool migrierte Entitäten.

Extrahieren Sie die .zip-Datei, die Sie für das Tool heruntergeladen haben, und führen Sie dann das .exe-Tool aus.
Wählen Sie für die Aktivierungsmethode Lokale MSI-Datei aus.
Geben Sie die Informationen ein, damit das Tool eine Verbindung mit Ihrem lokalen Orchestrator herstellen kann.

Hinweis: Stellen Sie sicher, dass Ihre angegebenen Anmeldeinformationen für ein Administratorkonto vorgesehen sind, das auch Berechtigungen zum Anzeigen für alle Entitäten hat, die Sie migrieren möchten.
Klicken Sie auf Export starten, um eine Verbindung mit Ihrer Quellumgebung herzustellen und die Setup-Informationen herunterzuladen. 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.
Klicken Sie auf Start, um zum ersten Bildschirm des Migrationstools zurückzukehren.
Für die Aktivierungsmethode wählen Sie diesmal Verbindung mit Automation Cloud herstellen aus.

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

Feld	Details
Clientanwendungs-ID	Der Wert Anwendungs-ID, der der Registrierung der externen Anwendung in der Automation Cloud zugeordnet ist. Diesen Wert finden Sie unter Admin > Seite Externe Anwendungen.
Nom de l’organisation	Der organisationsspezifische Teil Ihrer Automation Cloud-URL. Organisationsadministratoren finden diese Informationen im Feld URL unter Administrator > Organisationseinstellungen. Hinweis: Sie müssen nicht die vollständige URL angeben, sondern nur den bearbeitbaren Teil, der für Ihre Organisation spezifisch ist. Wenn die URL z. B. `https://cloud.uipath.com/myOrgName` ist, fügen Sie dem Feld `myOrgName` hinzu.
Name des Mandanten (Tenant Name)	Der genaue Name des Automation Cloud-Mandanten, in dem Sie die migrierten Informationen hinzufügen möchten. Die migrierten Daten sind im Orchestrator-Dienst sichtbar, der diesem Mandanten zugeordnet ist.

Wählen Sie Import starten aus, um eine Verbindung mit der Automation Cloud herzustellen und mit der Migration der Informationen zum Ziel-Orchestrator-Dienst zu beginnen.
Der Import beginnt und kann eine Weile dauern.
Um mithilfe von OAuth eine Verbindung mit der Automation Cloud herzustellen, muss sich ein Benutzer mit den entsprechenden Berechtigungen für die Scopes bei der Automation Cloud anmelden, die beim Registrieren der externen Anwendung hinzugefügt wurden. Dabei wird ein neues Fenster mit einer Erfolgsmeldung geöffnet, wenn der OAuth-Flow erfolgreich war.

Nach Abschluss werden in der Importzusammenfassung alle Entitäten aufgelistet, die erfolgreich in den Orchestrator-Dienst in der Automation Cloud importiert wurden.
Alles, was nicht importiert wurde, wird als Fehler aufgeführt; Teilimporte werden als Warnungen aufgeführt. Sie können auf Bericht anzeigen klicken, um weitere Informationen darüber zu erhalten, bei welchen Entitäten ein Fehler oder eine Warnung auftrat.
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 Automation Cloud-Migrationstool nicht alle Daten migrieren kann, müssen Sie einige letzte Aufgaben manuell ausführen.

Wählen Sie in der Automation Cloud den Mandanten aus, der das Importziel war, und öffnen Sie den Orchestrator. Ü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.
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 sie aktualisieren müssen, um die entsprechende Anzahl von Lizenzen zuzuweisen.
Laden Sie manuell alle Bibliotheksfeeds hoch, die das Tool nicht migriert hat.
Wenn Roboter beim Export oder Import übersprungen wurden, erstellen Sie sie manuell.
Erstellen Sie Webhooks, Aufgabenkataloge, Anmeldeinformationsspeicher oder andere Informationen, die das Tool nicht migriert. Der Abschnitt Vom Migrationstool migrierte Entitäten enthält auch eine Liste der Entitäten, die das Tool nicht migriert.
Verbinden Sie Roboter manuell mit dem Cloud Orchestrator-Dienst.
Aktivieren Sie Trigger nach Bedarf manuell.
Ü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: