Prérequis de la migration

Avant de commencer la migration, assurez-vous que vous remplissez les conditions préalables suivantes :

Runtime .NET 6.0

.NET Runtime 6.0 ou version ultérieure est requis pour exécuter l'outil UiPath.OrganizationMigrationApp. Vous devez le télécharger et l'installer avant d'exécuter UiPath.OrganizationMigrationApp.

Linux

Si .NET Runtime 6.0 ou version ultérieure n'est pas présent, téléchargez et installez .NET Runtime pour Linux avant d'utiliser UiPath.OrganizationMigrationApp.

Pour installer .NET Runtime 6.0 sur RHEL, exécutez la commande suivante :

sudo yum install dotnet-sdk-6.0 -y

Windows

L'outil UiPath.OrganizationMigrationApp nécessite .NET Runtime 6.0 au minimum. Si .NET Runtime 6.0 et ultérieur n'est pas présent, téléchargez et installez .NET Runtime 6.0 pour Windows avant d'utiliser UiPath.OrganizationMigrationApp.

Paramètre de création de compartiments Orchestrator

Pour vous assurer que les compartiments Orchestrator sont automatiquement créés avec la stratégie CORS correcte, vous devez exécuter la commande suivante. La commande nécessite l'installation de l'utilitaire jq sur votre machine.

rm -f values.json && rm -f appsettings.json
kubectl -n uipath get cm orchestrator-customconfig -o jsonpath='{.data.values\.json}' | jq '.' > values.json
jq '.AppSettings' values.json > appsettings.json
jq '.["Storage.CreateBucket.OnTenantCreation.Enabled"] = "true"' appsettings.json > temp.json && mv -f temp.json appsettings.json
uipathctl config orchestrator update-config --app-settings appsettings.json

Pour installer jq, utilisez l’une des options suivantes :

• Option 1 : exécutez la commande suivante :

  yum install -y epel-release yum install -y jq

• Option 2 : exécutez les commandes suivantes :

  shell
  curl https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/j/jq-1.6-2.el7.x86_64.rpm --output /tmp/jq-1.6-2.el7.x86_64.rpm
  yum localinstall /tmp/jq-1.6-2.el7.x86_64.rpm

Avertissement : si vous n'activez pas le paramètre Orchestrator qui garantit que les compartiments sont automatiquement créés avec la stratégie CORS correcte, cela provoquera des problèmes de téléchargement à partir de compartiments de stockage, auxquels vous devez remédier en effectuant des mises à jour manuelles de la stratégie CORS.

Pour confirmer que le paramètre a été activé, exécutez la commande suivante :

kubectl -n uipath get cm orchestrator-customconfig -o jsonpath='{.data.values\.json}' | jq

Si le paramètre a été activé, la commande doit renvoyer la réponse suivante :

{
  "AppSettings": {
    "Storage.CreateBucket.OnTenantCreation.Enabled": "true"
  }
}

UiPath. ApplicationMigrationOrganisation (OrganizationMigrationApp)

L'outil UiPath.OrganizationMigrationApp vous aide à effectuer des opérations telles que le déplacement des données d'identité de tous les locataires d'organisations autonomes vers Automation Suite et à fusionner des organisations.

Pour télécharger UiPath.OrganizationMigrationApp, consultez Téléchargement des packages d'installation.

Pour voir quelle version de UiPath.OrganizationMigrationApp est compatible avec votre environnement, consultez Matrice de compatibilité (Compatibility matrix).

Outil de gestion de Microsoft SQL Server

Vous devez télécharger et installer SQL Server Management Studio (SSMS) ou un outil similaire de gestion de Microsoft SQL Server. Cet outil vous aide à restaurer la base de données Orchestrator sur l'instance SQL Server d'Automation Suite ou sur une autre instance SQL Server.

1. Téléchargez et installez SQL Server Management Studio.

2. Connectez-vous au serveur SQL autonome à l'aide de la chaîne de connexion SQL autonome.

3. Ouvrez le port 1433 pour la base de données source et cible.

Règles d’échappement de caractères spéciaux pour les mots de passe de la chaîne de connexion

Dans la plupart des cas, les mots de passe de connexion sont encapsulés par un guillemet unique ('). Cependant, lorsque le mot de passe inclut des caractères spéciaux tels que ` ou $, il est nécessaire de procéder différemment.

Dans ces cas, le mot de passe doit être formaté en tant que \`"<password>\`", en remplaçant <password> par le mot de passe réel. De plus, vous devez également respecter les règles d’échappement comme détaillé dans la table suivante :

Format d’origine dans ADuC	Format échappé dans la chaîne PowerShell
cn=James $ Smith	"cn=James `$ Smith"
cn=Sally Wilson + Jones	"cn=Sally Wilson \+ Jones"
cn=William O'Brian	"cn=William O'Brian"
cn=William O`Brian	"cn=William O``Brian"
cn=Richard #West	"cn=Richard #West"
cn=Roy Johnson$	"cn=Roy Johnson$"

Exemple

Supposons que le mot de passe d’origine est 7'8:<=XMe$y[@vC?_4ZeY8c-~y'W!1dU4gnczuf'/p>j<I. En respectant les règles d’échappement des caractères spéciaux, elle devient : Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`".

La commande complète, avec le mot de passe configuré dans la chaîne de connexion de destination, ressemble à ce qui suit :

./UiPath.OrganizationMigrationApp.exe migrate -a -m -s "Server=tcp:abc.com,1433;Initial Catalog=UiPath_20230531;Persist Security Info=False;User ID=username;Password=asiodhyf;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;" -d "Server=tcp:cde.net,1433;Initial Catalog=AutomationSuite_Platform;Persist Security Info=False;User Id=[e-mail];Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`""

Remarque : assurez-vous que la commande n’est exécutée que sur une machine disposant d’un accès autorisé à la base de données RDS.

Administrator group configuration requirement

Before starting the migration, you must add the Administrator group in every tenant.

If you are performing an organization merge and the Administrator group is not added in all tenants, you can lock yourself out of the Orchestrator instance after the merge completes.

Adding the Administrator group in each tenant ensures that administrative access is preserved throughout the migration and merge process.