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 Test Cloud, Test Cloud dédié, Test Cloud pour le secteur public ou Test Cloud pour la version locale.

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

Remarque :

La disponibilité des fonctionnalités dépend de la plate-forme cloud que vous utilisez. Pour de plus amples informations, consultez la page Disponibilité des fonctionnalités.

Avant de commencer

Lorsque vous planifiez votre migration depuis On-Premises Orchestrator vers une plateforme cloud, il est conseillé de suivre les étapes suivantes :

1. Effectuez une mise à niveau vers une version locale d’Orchestrator prise en charge.
2. Faites migrer les dossiers classiques vers des dossiers modernes, car les dossiers classiques ont des restrictions dans les plateformes cloud, ce qui signifie qu’ils n’existent pas dans les plateformes cloud UiPath.
3. Exécutez l’outil de migration pour migrer de la version locale d’Orchestrator vers la plate-forme Cloud souhaitée.
   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 avez besoin d’une licence active pour une plate-forme cloud. Pour de plus amples informations, consultez notre documentation sur l' attribution de licence .
• Pour les licences Flex, vous avez besoin 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 de plus amples 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 :

1. Selon votre plate-forme cloud, vérifiez que le plan de licence Enterprise ou Enterprise Trial est actif (Admin > Licences).
2. Assurez-vous que vous disposez de suffisamment de licences de Robot pour correspondre au nombre de Robots en cours de migration (Admin > Licences > Robots et services). L'outil migre les Robots tant qu'il y a des licences disponibles, après quoi il commencera à ignorer les Robots.
3. Assurez-vous de disposer d'informations d'identification d'administrateur pour l'environnement à partir duquel vous effectuez la migration.
4. Veillez à disposer de l’autorisation Consultation pour toutes les entités en cours de migration. Si vous ne disposez pas de l’autorisation Consultation pour certaines entités, ces entités ne seront pas migrées.
5. Veillez à disposez des droits d’administrateur de l’organisation dans Automation Cloud pour enregistrer l’outil en tant qu’application externe.
6. 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 à une version autonome d'Orchestrator, à Orchestrator dans une plateforme cloud ou à Orchestrator dans Automation Suite.
   2. peut accéder à la plate - forme cloud ;
   3. Exécute le système d'exploitation Windows.
7. Téléchargez l’outil de migration sur la machine qui répond aux exigences spécifiées à l’étape précédente.

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

Lors de l'utilisation de l'outil de migration, les entités suivantes, comme décrit dans le tableau, sont automatiquement créées sur la plate-forme cloud pour 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 Remarque : 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 Échoue si le mappage de compte Robot est utilisé.
Dossiers	Oui (Yes) Remarque : vous pouvez choisir de migrer tous les dossiers en bloc, ainsi que des dossiers individuels.	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 à une plate-forme cloud UiPath.	Ignoré lorsque les licences sont épuisées, avec une erreur enregistrée pour chaque Robot ignoré. Échoue si un utilisateur d’une plate-forme cloud UiPath n’existe pas. Échoue si le mappage de compte Robot est utilisé.
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	Échoue si un utilisateur d’une plate-forme cloud UiPath n’existe pas. Échoue si le mappage de compte Robot est utilisé.
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

L’outil de migration ne migre pas les entités suivantes :

• 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)
• Tâches

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

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

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

1. Ajoutez l’outil en tant que nouvelle application externe en suivant les instructions dans 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/
2. 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 à la plate-forme cloud pour importer et créer les entités migrées dans Orchestrator.

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

1. Décompressez le fichier .zip que vous avez téléchargé pour l’outil, puis exécutez l’outil .exe .

2. Pour choisir votre environnement d’exportation, effectuez l’une des étapes suivantes :

   • 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.
   

3. 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 pour toutes les entités que vous souhaitez migrer.

4. Sélectionnez Démarrer l’exportation 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.

   

5. Sélectionnez Accueil pour revenir au premier écran de l'outil de migration.

6. Pour la méthode d'activation, choisissez cette fois Se connecter à Automation Cloud (Connect to Automation Cloud).

7. Remplissez les informations pour permettre à l’outil de se connecter à la plate-forme cloud pour télécharger les informations de configuration. Le tableau suivant décrit les champs nécessaires pour se connecter à la plate-forme cloud.

   

Champ	Détails (Details)
ID d’application client	La valeur ID d'application associée à l'enregistrement d'application externe dans la plate-forme 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 de plate-forme cloud. Les administrateurs de l'organisation peuvent trouver ces informations dans le champ URL sous Admin > Paramètres de l'organisation . 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 de la plate-forme cloud auquel vous souhaitez ajouter les informations migrées. Les données migrées seront visibles dans le service Orchestrator associé à ce locataire.

8. Sélectionnez **Démarrer l'importation** pour vous connecter à la plate-forme cloud et commencer à migrer les informations vers le service Orchestrator cible.

L’importation commence et peut prendre un certain temps.

Pour se connecter à la plate-forme 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 à l’offre 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 sur la plate-forme 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 sélectionner Afficher le rapport pour plus de détails sur les entités exactes qui ont rencontré une erreur ou un avertissement. 9. Lorsque vous êtes prêt, sélectionnez Terminé 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.

1. Dans la plate-forme 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.
2. 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.
3. Téléchargez manuellement tous les flux de bibliothèque que l'outil n'a pas migré.
4. Si des robots ont été ignorés lors de l'exportation ou de l'importation, créez-les manuellement.
5. 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.
6. Connectez manuellement les robots au service Cloud Orchestrator.
7. Activez manuellement les déclencheurs si nécessaire.
8. 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 :

• La version de votre Orchestrator local ;
• Votre organisation de plate-forme cloud et les noms de vos locataires.