Étape 3 : Déplacement des données d’organisation depuis une version autonome d’Identity 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 '<restored & upgraded identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<restored & upgraded 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.

  • Si vous migrez un locataire autonome vers une organisation Automation Suite pour tous les locataires, vous pouvez exécuter la commande une fois pour toutes les migrations. Cependant, si vous migrez plusieurs locataires autonomes vers une seule organisation Automation Suite, vous devez exécuter la commande séparément pour chaque locataire, car vous devrez peut-être résoudre des conflits d’utilisateurs entre les locataires. L'exemple suivant montre comment exécuter la commande séparément pour chaque locataire :

    ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant1' -d 'orgId1'
    ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant2' -d 'orgId1'
    ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant3' -d 'orgId1'

    Pour obtenir des instructions sur la façon de résoudre les conflits d'utilisateurs lors de la migration de plusieurs locataires autonomes vers une seule organisation Automation Suite, consultez la section Résolution des conflits d'utilisateurs.

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

  ./UiPath.OrganizationMigrationApp migrate -m -r -i '<restored & upgraded identity database connection of the standalone product>' -j '<identity database connection of Automation Suite>' -o '<restored & upgraded 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.

  • Si vous migrez un locataire autonome vers une organisation Automation Suite pour tous les locataires, vous pouvez exécuter la commande une fois pour toutes les migrations. Cependant, si vous migrez plusieurs locataires autonomes vers une seule organisation Automation Suite, vous devez exécuter la commande séparément pour chaque locataire, car vous devrez peut-être résoudre des conflits d’utilisateurs entre les locataires. L'exemple suivant montre comment exécuter la commande séparément pour chaque locataire :

    ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant1' -d 'orgId1'
    ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant2' -d 'orgId1'
    ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant3' -d 'orgId1'

    Pour obtenir des instructions sur la façon de résoudre les conflits d'utilisateurs lors de la migration de plusieurs locataires autonomes vers une seule organisation Automation Suite, consultez la section Résolution des conflits d'utilisateurs.

  ./UiPath.OrganizationMigrationApp migrate -m -i "<restored & upgraded identity database connection of the standalone product>" -j "<identity database connection of Automation Suite>" -o "<restored & upgraded 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 "<restored & upgraded identity database connection of the standalone product>" -j "<identity database connection of Automation Suite>" -o "<restored & upgraded 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 restaurée et mise à niveau 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 restaurée et mise à niveau 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