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

Exécution de l'outil de migration sur Linux

Avant de commencer, tenez compte des points suivants :

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

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.

Cette section décrit certaines opérations courantes que vous devrez peut-être effectuer à l’aide de l’outil Uipath.Organization.Migration.App. Pour plus de détails sur les paramètres pris en charge par l’outil Uipath.Organization.Migration.App, consultez la section Paramètres de l’outil de migration.

• 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.
  • Le format du nom de locataire généré automatiquement est tenant_xxxxxxxx, où xxxxxxxx désigne les huit premiers caractères de l’ID de l’organisation Automation Suite. Il s’agit du locataire vers lequel vous allez migrer les produits autonomes.
• 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"}

Exécution de l'outil de migration sur Windows

Avant de commencer, tenez compte des aspects suivants :

• Vous devez télécharger et installer .NET Runtime 6.0 avant d’exécuter UiPath.OrganizationMigrationApp. Pour en savoir plus, consultez Prérequis de la migration.

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

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.

Cette section décrit certaines opérations courantes que vous devrez peut-être effectuer à l’aide de l’outil Uipath.Organization.Migration.App. Pour plus de détails sur les paramètres pris en charge par l’outil Uipath.Organization.Migration.App, consultez la section Paramètres de l’outil de migration.

• 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.
  • Après avoir exécuté la commande suivante, un nouveau locataire nommé tenant_xxxxxx sera créé, où xxxxxx désigne les six premiers caractères ou l’ID de l’organisation. Il s’agit du locataire vers lequel vous allez migrer les produits autonomes.

  ./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>"

• 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 vous basant sur le message d’erreur, puis essayez de déplacer à nouveau les données 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"}

Paramètres de l’outil de migration

Le tableau suivant décrit les paramètres pris en charge par l’outil Uipath.Organization.Migration.App. Vous pouvez utiliser ces paramètres sur Linux et Windows.

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