É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 tenant 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 nom du locataire Automation Suite est le même que le nom du locataire d'origine dans l'installation autonome d'Orchestrator. Il s’agit du locataire vers lequel vous allez migrer les produits autonomes.

  • Pour migrer plusieurs locataires autonomes vers une seule organisation Automation Suite, indiquez la valeur du paramètre -d en répétant l'ID de l'organisation cible le même nombre de fois que le nombre de locataires autonomes. Dans l'exemple suivant, le résultat de la migration est une organisation Automation Suite qui comprend trois locataires migrés :

    -s 'tenantId1, tenantId2, tenantId3' -d 'orgId1, orgId1, orgId1'

• 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 tenant 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"}

  • Le message d'erreur suivant signifie qu'il existe déjà un locataire dans l'organisation Automation Suite avec le même nom de locataire que le nom de locataire autonome. Pour résoudre le conflit, vous devez modifier le nom du locataire pour le locataire dans l'organisation Automation Suite.

    Source tenant ID: 38f03b05-3aab-422c-844b-bf3668fa54ee, target organization ID: f7d80050-9654-4f44-8a34-3a9e46380dc9, confilict tenant name: test_tenan1
    Source tenant ID: b35020b1-ee9f-4026-abd1-bb721b148e24, target organization ID: f7d80050-9654-4f44-8a34-3a9e46380dc9, confilict tenant name: test_tenant2
    Tenant name conflicts detected. You need to rename the tenant to be a different name than conflict tenant name in target organization to unblock tenant creation.

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.

  • Le nom du locataire Automation Suite est le même que le nom du locataire d'origine dans l'installation autonome d'Orchestrator. Il s’agit du locataire vers lequel vous allez migrer les produits autonomes.

  • Pour migrer plusieurs locataires autonomes vers une seule organisation Automation Suite, indiquez la valeur du paramètre -d en répétant l'ID de l'organisation cible le même nombre de fois que le nombre de locataires autonomes. Dans l'exemple suivant, le résultat de la migration est une organisation Automation Suite qui comprend trois locataires migrés :

    -s 'tenantId1, tenantId2, tenantId3' -d 'orgId1, orgId1, orgId1'

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

  • Le message d'erreur suivant signifie qu'il existe déjà un locataire dans l'organisation Automation Suite avec le même nom de locataire que le nom de locataire autonome. Pour résoudre le conflit, vous devez modifier le nom du locataire pour le locataire dans l'organisation Automation Suite.

    Source tenant ID: 38f03b05-3aab-422c-844b-bf3668fa54ee, target organization ID: f7d80050-9654-4f44-8a34-3a9e46380dc9, confilict tenant name: test_tenan1
    Source tenant ID: b35020b1-ee9f-4026-abd1-bb721b148e24, target organization ID: f7d80050-9654-4f44-8a34-3a9e46380dc9, confilict tenant name: test_tenant2
    Tenant name conflicts detected. You need to rename the tenant to be a different name than conflict tenant name in target organization to unblock tenant creation.

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