Utiliser l’outil de migration vers Automation Cloud

The Automation Cloud Migration Tool is a desktop application designed to simplify the process of migration from one deployment option to another. The tool automates various migration steps, making it easier to transition either your standalone or Automation Suite Orchestrator to Automation Cloud, Automation Cloud Public Sector, or Automation Suite.

Instructions on this page apply for migrating your on-premises Orchestrator, either standalone or via Automation Suite, to Automation Cloud^TM.

When planning your migration from on-premises Orchestrator to Automation Cloud^TM, it is advisable that you take the following steps:

Effectuez une mise à niveau vers une version locale d’Orchestrator prise en charge.
Migrate from classic to modern folders, as classic folders have restrictions in Automation Cloud^TM.
Run the migration tool to migrate from on-premises Orchestrator to Automation Cloud^TM.

Remarque :

Bien que d'autres séquences soient techniquement possibles, il s'agit de la stratégie la plus courante.
L’outil de migration Automation Cloud fonctionne indépendamment et ne s’aligne pas sur notre cycle de vie du produit standard.

Prérequis

Vous devez répondre aux critères suivants afin d'utiliser l'outil de migration :

Votre version autonome d’Orchestrator doit être prise en charge. Pour plus de détails concernant une version spécifique, consultez notre documentation relative au cycle de vie du produit.
Vous devez disposer d’une licence Pro, Pro Trial ou Enterprise dans Automation Cloud. Bien que vous puissiez utiliser l’outil dans le cadre d’un essai Pro Trial à des fins d’évaluation, certaines limitations peuvent s’appliquer, telles que des restrictions de licence de locataire et de Robot. Pour plus d’informations, consultez notre documentation sur l’attribution de licence.

Prérequis

Avant d'ouvrir l'outil de migration Automation Cloud, procédez aux préparatifs suivants :

Check that the Enterprise or Enterprise Trial licensing plan is active in Automation Cloud^TM (Admin > Licenses).
Make sure you have sufficient robot licenses to match the number of robots being migrated (Admin > Licenses > Robots & Services). The tool migrates robots as long as there are licenses available, after which it starts to skip robots.
Make sure you have administrator credentials for the on-premises Orchestrator
Make sure you have View permission for all entities being migrated. If you do not have the View permission for some entities, those entities will not be migrated.
Veillez à disposez des droits d’administrateur de l’organisation dans Automation Cloud pour enregistrer l’outil en tant qu’application externe.
Veillez à ce que la machine sur laquelle vous exécutez l'outil de migration Automation Cloud réponde aux exigences suivantes :
1. Can connect to the on-premises Orchestrator;
2. Can access Automation Cloud^TM (has internet access and a supported browser);
3. Runs the Windows operating system;
4. Has .NET Core Desktop Runtime for x64 installed.
Download the migration tool on the machine that meets the requirements in the previous step.

Entités migrées par l'outil de migration

When using the migration tool, the following entities are automatically created in Automation Cloud^TM to mirror your Orchestrator setup:

Entité	Migré	Non migré
Paramètres	Yes, with exceptions	Certains paramètres locaux, tels que les mots de passe et certains paramètres exposés aux locataires
Paquets	All packages and package versions	Entities that rely on external package feeds requiring authentication Remarque : Authentication is required after migration is completed for external package feeds configured with basic authentication
Bibliothèques	Tenant-level feeds only	Entities that rely on libraries with host-level configurations or inaccessible external libraries
Calendriers	Oui (Yes)	S/O
Machines	Oui (Yes) Remarque : Potential machine slot assignments limitations due to missing licenses	Clés de machine
Dossiers	Oui (Yes)	Personal workspace folders
Environnements (Environments)	Oui, pour les dossiers classiques.	S/O (pour les dossiers modernes)
Robots (classiques)	Oui (Yes) Remarque : Potential robot creation limitations due to missing licenses	Skipped when licenses run out, with an error logged for each skipped robot
Robots (modernes)	Oui (Yes) Remarque : If certain conditions are met, robots are associated with an on-premises user that has an email address, and that same email was already invited to Automation Cloud^TM and is associated to a user.	Skipped when licenses run out, with an error logged for each skipped robot Fails if a user in Automation Cloud^TM does not exist
Associations d'environnement	La cartographie de l'environnement de Robot	S/O
Processus (Processes)	Oui (Yes) Remarque : The migration tool may refer to processes as releases	S/O
Files d'attente (Queues)	Oui (Yes)	S/O
Déclencheurs (Triggers)	Yes, but they are set as disabled	S/O
Actifs	Certain asset types are fully supported, with some considerations for credential assets	Les valeurs d'actif par utilisateur dans les dossiers modernes
Flux de dossier	Oui (Yes)	S/O

Entités non migrées par l’outil de migration

The migration tool does not migrate the following entities:

Comptes utilisateur et robot
Attributions de rôle
Éléments de file d'attente
Catalogues d'actions
Webhooks
Entités de test (ensembles de test, cas de test, exécutions de test, planifications de test, files d'attente de données de test)
Compartiments de stockage
Journaux (Logs)

Enregistrement de l’outil de migration en tant qu’application externe

The migration tool must connect to the Orchestrator service API in Automation Cloud^TM to create the migrated entities. It uses the OAuth flow for this and, therefore, must be registered as an external application.

Afin d'enregistrer l'outil de migration Automation Cloud en tant qu'application externe, procédez comme suit :

Add the tool as a new external application by following the instructions in Adding an external application. Make sure to use the following configuration:
- Type : Non confidentiel
- Ressources (Resources) : API Orchestrator
- Étendues utilisateur : OR.Folders, OR.Settings, OR.Robots, OR.Machines, OR.Execution, OR.Assets, OR.Users, OR.Jobs, et OR.Queues.
- URL de redirection (Redirect URL) : http://127.0.0.1:8888/auth/
Enregistrez l'ID d'application (Application ID) pour une utilisation ultérieure.

Exécuter l’outil de migration

L’outil de migration peut migrer un locataire à la fois. Vous pouvez exécuter l’outil pour chacun de vos locataires. À chaque exécution, l’outil effectue les opérations suivantes :

se connecte à votre Orchestrator local pour exporter des entités pour le locataire donné ;
Connects to Automation Cloud^TM to import and create the migrated entities in Orchestrator.

Pour plus d’informations sur les entités sujettes à la migration, consultez la section Entités migrées par l’outil de migration.

Extract the .zip file you downloaded for the tool, and then run the .exe tool.
To choose your export environment, take one of the following steps:
- Sélectionnez MSI local si vous migrez depuis l’installation autonome d’Orchestrator.
- Sélectionnez Automation Suite pour vous connecter à l’application externe et remplir le formulaire d’entrée d’exportation si vous migrez depuis Automation Suite Orchestrator.
Remplissez les informations pour permettre à l’outil de se connecter à votre version locale Orchestrator.

Remarque : assurez-vous que les informations d’identification que vous fournissez concernent un compte administrateur qui dispose également des autorisations de Consultation (View) pour toutes les entités que vous souhaitez migrer.
Select Start Export to connect to your source environment and download the setup information. The export begins and may take a while to complete.

Une fois terminé, le récapitulatif de l’exportation répertorie toutes les entités qui ont été exportées avec succès. Vous pouvez sélectionnez Ouvrir le fichier (Open File) pour afficher le fichier local créé pour le résumé de l’exportation, qui comprend quelques détails supplémentaires.
Select Home to return to the first screen of the migration tool.
For the activation method, this time choose Connect to Automation Cloud^TM.

Fill in the information to allow the tool to connect to Automation Cloud^TM to upload the setup information.

Champ	Détails (Details)
ID d’application client	The Application ID value associated with the external application registration in Automation Cloud^TM. Vous pouvez trouver cette valeur sur la page Admin > Applications externes (External Applications).
Nom de l’organisation	The organization-specific part of your Automation Cloud^TM URL. Organization administrators can find this information in the URL field in Admin > Organization Settings. Remarque : Vous n’avez pas besoin d’inclure l’URL complète, mais uniquement la partie modifiable, qui est spécifique à votre organisation. Par exemple, si l’URL est `https://cloud.uipath.com/myOrgName`, ajoutez `myOrgName` au champ.
Nom du locataire	The exact name of the Automation Cloud^TM tenant where you want to add the migrated information. The migrated data will be visible in the Orchestrator service associated to that tenant.

Select Start Import to connect to Automation Cloud^TM and start to migrate the information to the target Orchestrator service.

L’importation commence et peut prendre un certain temps.

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

When finished, the import summary lists all entities that were successfully imported into the Orchestrator service in Automation Cloud^TM.

Anything that was not imported is listed as an error and partial imports are listed as warnings. You can select View Report for more details about exactly which entities encountered an error or warning.
Lorsque vous êtes prêt, sélectionnez Terminé (Done) pour fermer l’outil.

Astuce : Si nécessaire, vous pouvez réexécuter l'outil pour migrer les données pour des locataires supplémentaires.

Tâches post-migration

Dans la mesure où l'outil de migration d'Automation Cloud ne peut pas migrer toutes les données, vous devrez effectuer certaines tâches finales manuellement.

In Automation Cloud^TM, select the tenant that was the import target, and open Orchestrator. Check that folders and entities were successfully migrated. You can use the import summary to check the specific items that had warnings or errors.
Affectez des licences de robot et de service pour Orchestrator. Les machines sont créées et sous licence tant que les licences disponibles existent, mais une fois les licences épuisées, les machines continuent d'être créées sans licences ; vous devez donc les mettre à jour afin de pouvoir affecter le nombre adéquat de licences.
Téléchargez manuellement tous les flux de bibliothèque que l'outil n'a pas migré.
Si des robots ont été ignorés lors de l'exportation ou de l'importation, créez-les manuellement.
Créez des webhooks, des catalogues de tâches, des magasins d’informations d’identification ou les autres informations que l’outil ne migre pas. La section Entités migrées par l’outil de migration comprend également une liste des éléments que l’outil ne migre pas.
Connectez manuellement les robots au service Cloud Orchestrator.
Activez manuellement les déclencheurs si nécessaire.
Vérifiez tous les emplacements dans Orchestrator où un mot de passe est requis et ajoutez-le : Robots, Paramètres et Actifs d'identifiants.

Obtenir de l’aide

Si vous avez besoin d'aide pour un problème rencontré lors de l'exportation, de l'importation ou après l'importation, ouvrez un ticket d'assistance et incluez-y les fichiers suivants :

Fichier de journal (situé dans le sous-dossier des journaux)
Fichier de rapport d'exportation (situé dans le sous-dossier MigrationAssets)
Fichier de rapport d'importation (situé dans le sous-dossier MigrationAssets)

Outre les fichiers précédents, il serait utile de connaître les éléments suivants :