É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 :

Assurez-vous de suivre les instructions générales d'échappement de l'outil Shell de votre choix. Par exemple, dans Bash, 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 d'identités du produit autonome	i	La connexion à la base de données d'identités 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 .
Orchestrator database connection of the standalone product	o	The Orchestrator database connection of the standalone product. If Identity and Orchestrator share the same database, then use the connection string of that database.
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 pour le produit autonome et Automation Suite doit être la même. 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	The list of organization IDs for Automation Suite. You must use the following format: orgId1,orgId2,...,orgId5. La taille de la liste des ID d'organisation pour le produit autonome et Automation Suite doit être la même. Pour obtenir une 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	The URL of Automation Suite. For example, https://ci-asaks5380983.devtest-ascloudgen-ea.infra.uipath-dev.com/
Clé secrète de client OMS S2S	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 OMS S2S à 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 que vous devrez 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 et essayez de déplacer à nouveau les données d'identité de tous les locataires des installations autonomes vers Automation Suite. Par exemple, consultez les messages d'erreur suivants et ce qu'ils signifient :

  • Le message d'erreur suivant signifie que le locataire est déjà créé et que le programme ignorera la création du locataire. 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. Assurez-vous de fournir l'URL Automation Suite correcte.

    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 OMS S2S n'est pas valide. Assurez-vous de fournir la clé secrète de client OMS S2S correcte.

    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 que vous devrez 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.