B) Migration à locataire unique

Astuce :

Il s'agit de l'une des deux façons de migrer votre Orchestrator autonome vers Automation Suite.

Pour plus d'informations, voir Options de migration.

L'outil peut migrer soit vers Automation Cloud, soit vers Automation Suite, mais cette page décrit le processus de migration vers Automation Suite. Pour obtenir des instructions sur la migration vers Automation Cloud, consultez plutôt la documentation Automation Cloud.

Vous pouvez utiliser l'outil de migration UiPath Automation Cloud™ pour migrer automatiquement des entités de votre Orchestrator autonome vers le service Orchestrator de Automation Suite.

Remarque :

Vous ne pouvez utiliser l'outil de migration Automation Cloud que si :

• votre version autonome d'Orchestrator est 2019.10.x, 2020.10.x, 2021.4.x,, 2021.10.x ou version ultérieure.
• votre version d'Automation Suite est 2021.10.x ou une version ultérieure.

Entités en cours de migration

Lorsque vous exécutez l'outil de migration Automation Cloud, il crée automatiquement les entités suivantes dans Automation Suite pour correspondre à votre configuration Orchestrator autonome :

Entité	Migré	Non migré
Paramètres	Oui, sauf exceptions (voir à droite).	Certains paramètres exposés au locataire sur le chemin de lecture ne peuvent pas être modifiés dans Automation Suite, comme le logo et la couleur de l'hôte. Les mots de passe du tableau Paramètres (Settings) ne peuvent pas être exportés car l'API supprime les valeurs de la réponse. Par conséquent, aucun mot de passe ne sera migré. Cela affecte les alertes par e-mail (mot de passe SMTP) et les flux externes avec authentification de base.
Paquets	Migre tous les packages et toutes les versions de package. Si un flux de packages est externe et configuré avec une authentification de base, les informations d'identification devront être saisies une fois la migration terminée.	Si un flux de packages est externe et n'est pas accessible sur Internet, les entités qui reposent sur ces packages ne sont pas migrées.
Bibliothèques	Flux au niveau du locataire uniquement.	Si un flux de bibliothèque se trouve au niveau de l'hôte ou est externe et non accessible sur Internet, les entités qui dépendent de ces bibliothèques ne sont pas migrées.
Calendriers	Oui (Yes)	S/O
Machines	Oui, mais s'il n'y a pas assez de licences pour prendre en charge les attributions d'emplacements de machine, la machine sera importée avec tous les emplacements définis sur 0.	Les clés de machine ne sont pas migrées.
Dossiers	Oui (Yes)	Les dossiers de l'espace de travail personnel ne sont pas migrés.
Environnements (Environments)	Oui, pour les dossiers classiques.	N/A pour les dossiers modernes.
Robots (classiques)	Oui, mais s'il n'y a pas assez de licences pour permettre la création du robot, le robot est ignoré lors de l'importation.	Ignoré lorsque les licences s'épuisent et qu'une erreur est consignée pour chacune d'entre elles.
Robots (modernes)	Les robots modernes sont migrés si l'utilisateur auquel ils sont associés existe dans Automation Suite et possède la même adresse e-mail.	Si l'utilisateur n'existe pas dans Automation Suite, cette migration de Robot spécifique échoue. Ignoré lorsque les licences s'épuisent et qu'une erreur est consignée pour chacune d'entre elles.
Associations d'environnement	La cartographie de l'environnement de robot est migrée.	S/O
Processus (Processes)	Les processus sont migrés. L'outil peut les appeler Versions.	S/O
Files d'attente (Queues)	Oui (Yes)	S/O
Déclencheurs (Triggers)	Les déclencheurs sont migrés, mais sont tous définis comme désactivés.
Actifs	Les types d'actifs Booléen, Texte et Entier sont entièrement pris en charge. Les actifs dʹidentifiants sont également migrés, mais un mot de passe factice est utilisé car les mots de passe ne peuvent pas être migrés par l'outil. Vous devrez mettre à jour manuellement les mots de passe pour chaque ressource dʹidentifiants après la migration. Les ressources d'informations d'identification sont affectées au magasin d'informations d'identification par défaut dans Automation Suite. Les valeurs par robot sont également migrées, mais si le robot n'a pas été migré, cette valeur est ignorée et un avertissement d'importation est consigné.	Les valeurs d'actif par utilisateur dans les dossiers modernes ne sont pas prises en charge. L'actif est importé avec la valeur par défaut ou ignoré si aucune n'est définie.
Associations de machines	Les mappages robot-machine sont migrés.	S/O

Entités non migrées

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

• Flux de dossier
• Utilisateurs
• É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)
• Journaux (Logs)

Prérequis

Avant d'ouvrir l'outil, effectuez les préparatifs suivants :

1. Assurez-vous que vous disposez de suffisamment de licences de Robot dans Automation Suite 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.
2. Vous devez disposer d'informations d'identification d'administrateur pour l'installation d'Orchestrator autonome et d'autorisations Consultation (View) 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 sont pas migrées.
3. Vous devez être un administrateur d'organisation dans Automation Suite.
4. Pour exécuter l'outil, vous avez besoin d'une machine qui :
   1. peut se connecter à Orchestrator autonome et à Automation Suite (dispose d'un accès Internet)
   2. possède le système d'exploitation Windows
   3. .NET Core Desktop Runtime x64 installé.
5. Téléchargez l'outil sur la machine mentionnée ci-dessus à partir de ce lien.
6. Enregistrez l'outil en tant qu'application externe dans l'organisation Automation Suite cible.

Enregistrement de l'outil en tant qu'application externe

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

1. Suivez ces instructions pour ajouter l'outil en tant que nouvelle application externe avec les spécificités suivantes :
   • Type : Non confidentiel
   • Ressources (Resources) : API Orchestrator
   • Portées utilisateur (User scopes) : 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écution de l'outil

L'outil peut migrer un locataire à la fois. Vous pouvez exécuter l'outil plusieurs fois pour chacun de vos locataires.

À chaque exécution, l'outil :

1. se connecte à votre Orchestrator autonome pour exporter des entités pour le locataire donné.

2. se connecte à Automation Suite pour importer et créer les entités migrées dans le service Orchestrator.

Pour plus d'informations sur les entités sujettes à la migration, consultez Entités en cours de migration.

Pour exécuter l'outil :

1. Décompressez le fichier ZIP que vous avez téléchargé pour l'outil, puis exécutez l'outil EXE.
2. Pour la méthode d'activation, choisissez Se connecter à On-Premises (Connect to On-Premises) :
   
   

   

   
   
3. Remplissez les informations pour permettre à l'outil de se connecter à votre version autonome Orchestrator :
   
   

   

   
   

   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.
4. Cliquez sur Démarrer l'exportation (Start Export) pour vous connecter à l'Orchestrator local 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 cliquer sur 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. Cliquez sur Accueil (Home) pour revenir au premier écran.
6. Pour la méthode d'activation, choisissez cette fois Se connecter à Automation Suite (Connect to Automation Suite).
7. Remplissez les informations pour permettre à l'outil de se connecter à Automation Suite pour télécharger les informations de configuration :
   
   

   

   
   

   Champ	Détails (Details)
   URL d’Automation Suite	L'URL où Automation Suite est hébergée, comprenant le protocole et se terminant par une barre oblique (/). Vous pouvez récupérer cette URL dans la barre d'adresse de votre navigateur lorsque vous êtes dans Automation Suite, mais n'incluez pas la partie de l'URL commençant par le nom de l'organisation. Par exemple, si l'URL de votre navigateur est https://mySite.com/docs/Migration/orchestrator_/?tid=34&fid=82, docs étant le nom de l'organisation, vous devez spécifier uniquement https://mySite.com/ dans ce champ.
   ID d’application client	La valeur ID d'application (Application ID) associée à l'enregistrement d'application externe dans Automation Suite. 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 Suite. Les administrateurs de l'organisation peuvent trouver ces informations dans le champ Nom de l'organisation (Organization Name) sous Admin > Paramètres de l'organisation (Organization Settings). 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://mySite.com/ myOrgName, ajoutez myOrgName au champ.
   Nom du locataire	Le nom exact du locataire Automation Suite auquel vous souhaitez ajouter les informations migrées. Les données migrées seront visibles dans le locataire Orchestrator spécifié.

8. Cliquez sur Démarrer l'importation (Start Import) pour vous connecter à Automation Suite et commencer à migrer les informations vers le locataire Orchestrator cible.
   L'importation commence et peut prendre un certain temps :

   
   

   

   
   

   Pour se connecter à Automation Suite à 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 Suite. 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 locataire Orchestrator dans Automation Suite :

   
   

   

   
   

   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.
9. Lorsque vous êtes prêt, cliquez sur 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

Étant donné que l'outil ne peut pas tout migrer, vous devez effectuer manuellement certaines tâches finales pour obtenir la même configuration que celle que vous aviez dans votre Orchestrator autonome.

1. Dans Automation Suite, connectez-vous à l'organisation du locataire qui était la cible de l'importation, puis ouvrez Orchestrator.
2. 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.

3. Affectez des licences de robot et de service pour Orchestrator.

   Lors de l'importation, les machines sont créées et licenciées tant que les licences disponibles existent. Une fois les licences épuisées, les machines continuent d'être créées sans licences, vous devez donc mettre à jour ces machines pour allouer le nombre de licences adéquat.

   Remarque : Si vous avez migré sans activer votre licence Automation Suite, à ce stade, vous devez l'activer pour continuer la configuration.
4. Téléchargez manuellement tous les flux de bibliothèque que l'outil n'a pas migré.
5. Si des robots ont été ignorés lors de l'exportation ou de l'importation, créez-les manuellement.
6. 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 en cours de migration (Entities Being Migrated) comprend également une liste des éléments que l'outil ne migre pas.

7. Connectez manuellement les robots au service Orchestrator de Automation Suite.
8. Activez manuellement les déclencheurs si nécessaire.

   Pendant que l'outil migre les déclencheurs, ils sont tous désactivés ; vous devez les activer manuellement.

9. 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)

En plus de ces fichiers, il serait utile de savoir :

• La version de votre Orchestrator autonome
• Votre organisation Automation Suite et les noms de vos locataires.