Utiliser l’outil de migration vers Automation Cloud

L'outil de migration d'Automation Cloud est une application de bureau conçue afin de simplifier le processus de migration entre deux options de déploiement. L'outil permet d'automatiser différentes étapes de migration, ce qui facilite la transition de votre Orchestrator autonome ou Automation Suite vers Automation Cloud, Automation Cloud Public Secteur ou Automation Suite.

Les instructions de cette page s'appliquent à la migration de votre Orchestrator local, que ce soit en version locale ou via Automation Suite, vers Automation Cloud.

When planning your migration from on-premises Orchestrator to Automation Cloud, it is advisable that you adhere to the following sequence:

Upgrade to a supported on-premises Orchestrator version.
Migrate from classic to modern folders, as classic folders have restrictions in Automation Cloud.
Run the migration tool to migrate from on-premises Orchestrator to Automation Cloud.

Remarque :

While other sequences are technically possible, this is the most common approach.

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 :

Vérifiez que le plan de licence Enterprise ou Enterprise Trial est actif dans Automation Cloud (Admin > Licences).
Assurez-vous que vous disposez de suffisamment de licences de Robot dans Automation Cloud pour correspondre au nombre de Robots en cours de migration ( Admin > Licences (Licenses) > Robots & Services). L'outil ne migre les Robots que tant qu'il y a des licences disponibles, après quoi il commencera à ignorer les Robots.
Veillez à disposer d’informations d’identification d’administrateur pour la version Orchestrator locale et l’accès Consultation (View) pour toutes les entités en cours de migration. Si vous ne disposez pas de l’autorisation Consultation (View) pour certaines entités, ces entités ne seront pas migrées.
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. peut se connecter à l’Orchestrator local ;
2. peut accéder à Automation Cloud (a accès à Internet et un navigateur pris en charge) ;
3. exécute le système d’exploitation Windows ;
4. dispose d’une installation de .NET Core Desktop Runtime x64.
Téléchargez l'outil de migration sur la machine qui répond aux exigences spécifiées à l'étape 5.

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

Lors de l'utilisation de l'outil de migration, les entités suivantes seront automatiquement créées dans Automation Cloud afin de refléter votre configuration Orchestrator :

Entité	Migré	Non migré
Paramètres	Oui, sauf exceptions.	Certains paramètres locaux, tels que les mots de passe et certains paramètres exposés aux locataires
Paquets	Tous les packages et versions de package.	Entités reposant sur des flux de packages externes nécessitant une authentification. L'authentification est requise une fois la migration terminée pour les flux de package externe configurés avec une authentification de base
Bibliothèques	Flux au niveau du locataire uniquement.	Entités reposant sur des bibliothèques avec des configurations au niveau de l'hôte ou des bibliothèques externes inaccessibles.
Calendriers	Oui (Yes)	S/O
Machines	Oui (Yes) Remarque : Potentielles limitations des affectations d'emplacements de machine en raison de licences manquantes.	Clés de machine
Dossiers	Oui (Yes)	Dossiers de l’espace de travail personnel.
Environnements (Environments)	Oui, pour les dossiers classiques.	S/O (pour les dossiers modernes)
Robots (classiques)	Oui (Yes) Remarque : Potentielles limitations de la création des Robots en raison de licences manquantes.	Ignoré lorsque les licences sont épuisées, avec une erreur enregistrée pour chaque Robot ignoré.
Robots (modernes)	Oui (Yes) Remarque : Si certaines conditions sont remplies, si les Robots sont associés à un utilisateur local disposant d’une adresse e-mail et si ce même e-mail est associé à un utilisateur et a déjà été utilisé pour une invitation à Automation Cloud.	Ignoré lorsque les licences sont épuisées, avec une erreur enregistrée pour chaque Robot ignoré. Échoue si un utilisateur n’existe pas dans Automation Cloud.
Associations d'environnement	La cartographie de l'environnement de Robot	S/O
Processus (Processes)	Oui (Yes) Remarque : L'outil de migration peut appeler les Processus des Versions.	S/O
Files d'attente (Queues)	Oui (Yes)	S/O
Déclencheurs (Triggers)	Oui, mais ils sont désactivés.	S/O
Actifs	Certains types de ressources sont entièrement pris en charge, avec une prise en compte des ressources d’identification.	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

Les entités suivantes ne sont pas migrées par l’outil :

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

L’outil de migration doit se connecter à l’API du service Orchestrator dans Automation Cloud pour créer les entités migrées. Il utilise pour cela le flux OAuth et doit donc être enregistré dans Automation Cloud en tant qu’application externe.

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

Ajoutez l'outil en tant que nouvelle application externe en suivant les instructions d'ajout d'une application externe. Veillez à bien utiliser la configuration suivante :
- 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é ;
se connecte à Automation Cloud pour importer et créer les entités migrées dans Orchestrator.

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

Décompressez le fichier .zip que vous avez téléchargé pour l’outil, puis exécutez l’outil .exe.
To choose your export environment:
- Select On-premises MSI, if you migrate from standalone Orchestrator.
- Select Automation Suite to connect to the external application and fill in the export input form, if you migrate from 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.
Cliquez sur Démarrer l’exportation (Start Export) pour vous connecter à votre version autonome Orchestrator et télécharger les informations de configuration. L’exportation commence et peut prendre un certain temps.

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.
Cliquez sur Accueil pour revenir au premier écran de l'outil de migration.
Pour la méthode d'activation, choisissez cette fois Se connecter à Automation Cloud (Connect to Automation Cloud).

Remplissez les informations pour permettre à l’outil de se connecter à Automation Cloud pour télécharger les informations de configuration.

Champ	Détails (Details)
ID d’application client	La valeur ID d’application associée à l’enregistrement d’application externe dans Automation Cloud. Vous pouvez trouver cette valeur sur la page Admin > Applications externes (External Applications).
Nom de l’organisation	La partie spécifique à l'organisation de votre URL Automation Cloud. Les administrateurs de l'organisation peuvent trouver ces informations dans le champ URL sous Admin > Paramètres de l'organisation (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	Le nom exact du locataire Automation Cloud auquel vous souhaitez ajouter les informations migrées. Les données migrées seront visibles dans le service Orchestrator associé à ce locataire.

Sélectionnez Démarrer l’importation (Start Import) pour vous connecter à Automation Cloud et commencer à migrer les informations vers le service Orchestrator cible.
L’importation commence et peut prendre un certain temps.
Pour se connecter à Automation Cloud à l’aide d’OAuth, un utilisateur disposant des autorisations adéquates pour les étendues ajoutées lors de l’enregistrement de l’application externe doit se connecter à Automation Cloud. Lorsqu’il procède, une nouvelle fenêtre s’ouvre, affichant un message de réussite si le flux OAuth a réussi.

Une fois terminé, le résumé de l’importation répertorie toutes les entités qui ont été importées avec succès dans le service Orchestrator dans Automation Cloud.
Tout ce qui n'a pas été importé est répertorié comme erreur et les importations partielles sont répertoriées sous forme d'avertissements. Vous pouvez cliquer sur Afficher le rapport (View Report) pour plus de détails sur les entités exactes qui ont rencontré une erreur ou un avertissement.
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.

Dans Automation Cloud, sélectionnez le locataire qui était la cible d’importation, puis ouvrez Orchestrator. Vérifiez que les dossiers et les entités ont été migrés avec succès. Vous pouvez utiliser le récapitulatif d’importation pour vérifier les éléments spécifiques qui ont émis des avertissements ou des erreurs.
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 :