Étape 1 : Déplacement des données d'organisation Identity d'installation autonome vers Automation Suite

Les versions autonome et d'Automation Suite doivent être identiques, sinon la migration échouera en raison de problèmes de conflit de schéma de base de données. Si vous rencontrez un problème de compatibilité, assurez-vous de mettre à niveau vos installations autonomes et Automation Suite vers la dernière version.

pour Linux

Remarque :

Assurez-vous de télécharger et d'installer .NET Runtime 6.0 avant d'exécuter UiPath.OrganizationMigrationApp. Pour plus de détails, consultez Prérequis de la migration.

Pour télécharger UiPath.OrganizationMigrationApp, consultez Prérequis de la migration.

Exécution de l'outil

Remarque :

Veillez à bien suivre les instructions générales d’échappement de l’outil Shell de votre choix. Dans Bash, par exemple, vous devez ajouter \ avant les caractères spéciaux.

L'outil UiPath.OrganizationMigrationApp prend en charge les paramètres suivants :

Nom du paramètre	Nom court	Description
Connexion à la base de données Identity du produit autonome	i	La connexion à la base de données Identity du produit autonome. Si Identity et Orchestrator partagent la même base de données, utilisez la chaîne de connexion de cette base de données.
Connexion à la base de données d'identité d' Automation Suite	j	La connexion à la base de données d'identité d' Automation Suite .
Connexion à la base de données Orchestrator du produit autonome	o	La connexion à la base de données Orchestrator du produit autonome. Si Identity et Orchestrator partagent la même base de données, utilisez la chaîne de connexion de cette base de données.
Liste des ID d’organisation du produit autonome	s	La liste des ID d’organisation pour le produit autonome à fusionner. Vous devez utiliser le format suivant : orgId1,orgId2,...,orgId5. La taille de la liste des ID d’organisation doit être la même pour le produit autonome et pour Automation Suite. Pour obtenir une liste des ID d’organisation pour le produit autonome, exécutez la commande suivante sur la base de données autonome et utilisez GlobalId avec le nom de partition/organisation associé sur la base de données restaurée : SELECT * FROM [identity].[Partitions]
Liste des ID d’organisation d’Automation Suite	d	La liste des ID d'organisation pour Automation Suite. Vous devez utiliser le format suivant : orgId1,orgId2,...,orgId5. La taille de la liste des ID d’organisation doit être la même pour le produit autonome et pour Automation Suite. Pour obtenir la liste des ID d’organisation pour Automation Suite, exécutez la commande suivante sur la base de données AutomationSuite_Platform du serveur SQL d’Automation Suite : SELECT * FROM [identity].[Partitions]
Restaurer (Rollback)	r	Le paramètre utilisé pour annuler une modification.
URL d’Automation Suite	p	L'URL d'Automation Suite. Par exemple, https://ci-asaks5380983.devtest-ascloudgen-ea.infra.uipath-dev.com/
Clé secrète de client S2S OMS	c	La clé secrète du client utilisée pour appeler l’API OMS afin de créer le locataire. Pour obtenir la clé secrète du client S2S OMS à partir de la clé secrète Kubernetes, exécutez la commande suivante : kubectl get secret identity-client-oms -n uipath -o "jsonpath={.data.OMSS2SClient\.ClientSecret}" | base64 -d

Voici quelques opérations courantes qu’il vous faudra peut-être effectuer :

• Pour déplacer les Données d'identité de tous les locataires d'une version autonome vers Automation Suite , extrayez le fichier et exécutez la commande suivante :

  ./UiPath.OrganizationMigrationApp migrate -m -i '<identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<orchestrator database connection of the standalone product>' -s '<list of organization IDs of the standalone product>' -d '<list of organization IDs of Automation Suite>' -p '<URL of Automation Suite>' -c '<OMS S2S client secret>'

  Remarque :

  Assurez-vous d'ajouter TrustServerCertificate=True pour toutes les connexions SQL dans l'entrée.
• Si l'opération a échoué au milieu, annulez la modification en exécutant la commande suivante :

  ./UiPath.OrganizationMigrationApp migrate -m -r -i '<identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<orchestrator database connection of the standalone product>' -s '<list of organization IDs of the standalone product>' -d '<list of organization IDs of Automation Suite>' -p '<URL of Automation Suite>' -c '<OMS S2S client secret>'

• Résolvez le problème en fonction du message d’erreur, puis essayez de déplacer à nouveau les données d’Identity de tous les locataires depuis les installations autonomes vers Automation Suite. Par exemple, découvrez ce que signifient les messages d’erreur suivants :

  • Le message d’erreur suivant signifie que le locataire a déjà été créé et que le programme va ignorer sa création. Vous n’avez rien à faire.

    Call to API Service failed for Method=POST, StatusCode=Conflict on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/organization/api/organization/0dad76a9-7d44-447a-84d6-ce713a5324d8/tenants
    	Http Response Content:{"StatusCode":409,"StatusDescription":"Conflict","ErrorCode":1002,"Message":"Found duplicated tenant with requested Id b26f486f-a585-4420-83fd-f2741385b3c8 under organization 0dad76a9-7d44-447a-84d6-ce713a5324d8 (1002)"}

  • Le message d’erreur suivant signifie que l’URL d’Automation Suite n’est pas valide. Veillez à fournir l’URL correcte d’Automation Suite.

    Unhandled exception. UiPath.IdentityServer.PartitionMerge.PartitionMergeException: Can not create tenant ID with target organiztion ID 0dad76a9-7d44-447a-84d6-ce713a5324d8, tenant name tenant_0dad76a9, platform url https://ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com.
    	 ---> System.Net.Http.HttpRequestException: No such host is known. (ci-asaks5379291.devtest-ascloud.infra.uipath-dev.com:443)
    	 ---> System.Net.Sockets.SocketException (11001): No such host is known.

  • Le message d’erreur suivant signifie que la clé secrète du client S2S OMS n’est pas valide. Veillez à fournir correctement la clé secrète du client S2S OMS.

    Call to API Service failed for Method=POST, StatusCode=BadRequest on url=https://ci-asaks5379291.devtest-ascloudgen-ea.infra.uipath-dev.com/identity_/connect/token
    	Http Response Content:{"error":"invalid_client"}

pour Windows

Remarque :

Assurez-vous de télécharger et d'installer .NET Runtime 6.0 avant d'exécuter UiPath.OrganizationMigrationApp. Pour plus de détails, consultez Prérequis de la migration.

Pour télécharger UiPath.OrganizationMigrationApp, consultez Prérequis de la migration.

Exécution de l'outil

Remarque :

Pour exécuter correctement l’outil UiPath.OrganizationMigrationApp, vous devez échapper votre mot de passe SQL s’il contient des caractères spéciaux. Par exemple, remplacez chaque instance de $ par \`$. Pour plus d’instructions sur la façon d’échapper les caractères spéciaux dans les mots de passe de chaîne de connexion, veuillez consulter les Règles d’échappement de caractères spéciaux pour les mots de passe de chaîne de connexion.

Voici quelques opérations courantes qu’il vous faudra peut-être effectuer :

• Pour déplacer les Données d'identité de tous les locataires d'une version autonome vers Automation Suite , extrayez le fichier et exécutez la commande suivante.

  Remarque :

  Assurez-vous d'ajouter TrustServerCertificate=True pour les entrées de connexion SQL source et de destination.

  ./UiPath.OrganizationMigrationApp.exe migrate -a -m -s "<identity DB connection of MSI>" -d "<dentity DB connection of Automation Suite>"

• Si l'opération a échoué au milieu, annulez la modification en exécutant la commande suivante :

  ./UiPath.OrganizationMigrationApp.exe migrate -a -m -r -s "<identity DB connection of MSI>" -d "<dentity DB connection of Automation Suite>"

• Résolvez le problème en fonction du message d'erreur et essayez à nouveau de déplacer les données d'identité de tous les locataires d'installations autonomes vers Automation Suite .

• After running the previous command, a new tenant named tenant_xxxxxxxx is created, where xxxxxxxx are random characters. This is the tenant to which you will migrate the standalone products.