Verwenden des Migrationstools für Automation Cloud

Das Automation Cloud-Migrationstool ist eine Desktopanwendung, die den Migrationsprozess von einer Bereitstellungsoption zu einer anderen vereinfachen soll. 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^TM.

Bei der Planung Ihrer Migration vom On-Premises Orchestrator zur Automation Cloud^TM ist es ratsam, die folgenden Schritte auszuführen:

Aktualisieren Sie auf eine unterstützte On-Premises Orchestrator-Version.
Migrieren Sie von klassischen zu modernen Ordnern, da klassische Ordner in der Automation Cloud^TM Einschränkungen haben.
Führen Sie das Migrationstool aus, um vom On-Premises Orchestrator zur Automation Cloud^TM zu migrieren.

Hinweis:

Auch wenn andere Abfolgen technisch möglich sind, ist das der gängigste Ansatz.
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^TM aktiv ist (Admin > Lizenzen).
Stellen Sie sicher, dass Sie über ausreichend viele Roboterlizenzen verfügen, die der Anzahl der migrierten Roboter entspricht (Administrator > Lizenzen > Roboter und Dienste). Das Tool migriert Roboter, solange Lizenzen verfügbar sind. Danach beginnt es, Roboter zu überspringen.
Sie benötigen Administrator-Anmeldeinformationen für den lokalen Orchestrator
Stellen Sie sicher, dass Sie über die Berechtigung zum Anzeigen für alle migrierten Entitäten verfügen. 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. Kann auf die Automation Cloud^TM 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 des vorherigen Schritts erfüllt.

Vom Migrationstool migrierte Entitäten

Beim Verwenden des Migrationstools werden die folgenden Entitäten automatisch in der Automation Cloud^TM 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 Hinweis: Die Authentifizierung ist nach Abschluss der Migration für externe Paketfeeds erforderlich, die mit grundlegender Authentifizierung 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^TM 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^TM 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

Das Migrationstool migriert die folgenden Entitäten nicht:

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^TM verbinden, um die migrierten Entitäten zu erstellen. Es verwendet dafür den OAuth-Flow und muss daher 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 unter 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^TM her, um die migrierten Entitäten im Orchestrator zu importieren und zu erstellen.

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.
Um Ihre Exportumgebung auszuwählen, führen Sie einen der folgenden Schritte aus:
- Wählen Sie Lokale MSI aus, wenn Sie vom eigenständigen Orchestrator migrieren.
- Wählen Sie Automation Suite aus, um eine Verbindung mit der externen Anwendung herzustellen, und füllen Sie das Exporteingabeformular aus, wenn Sie vom Automation Suite-Orchestrator migrieren.
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.
Wählen Sie Export starten aus, 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.
Wählen Sie Start aus, um zum ersten Bildschirm des Migrationstools zurückzukehren.
Für die Aktivierungsmethode wählen Sie diesmal Verbindung mit Automation Cloud^{TM herstellen}aus.

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

Feld	Details
Clientanwendungs-ID	Der Wert Anwendungs-ID , der mit der Registrierung der externen Anwendung in der Automation Cloud^TM verknüpft ist. Diesen Wert finden Sie unter Admin > Seite Externe Anwendungen.
Nom de l’organisation	Der organisationsspezifische Teil Ihrer Automation Cloud^TM -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^TM- 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^{TM 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^TM herzustellen, muss sich ein Benutzer mit den entsprechenden Berechtigungen für die Scopes bei der Automation Cloud^TM anmelden, die Sie beim Registrieren der externen Anwendung hinzugefügt haben. 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^TM 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.
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^TM 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: