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 une 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 une version ultérieure 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.

cd <AS install directory>
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
./bin/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 :

La non-activation du paramètre Orchestrator qui garantit la création automatique de compartiments avec la stratégie CORS correcte provoque des problèmes lors du téléchargement à partir des compartiments de stockage, que vous devez résoudre 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\`""

Exigence de configuration du groupe d'administrateurs

Avant de commencer la migration, vous devez ajouter le groupe Administrateur dans chaque locataire.

Si vous effectuez une fusion d'organisation et que le groupe Administrator n'est pas ajouté dans tous les locataires, vous pouvez vous verrouiller vous-même l'accès à l'instance Orchestrator une fois la fusion terminée.

L'ajout du groupe Administrateur dans chaque locataire garantit que l'accès administratif est conservé pendant le processus de migration et de fusion.

Script de migration de Test Manager

Le script de migration de Test Manager (testmanager_migrator.sh) vous aide à effectuer plusieurs opérations automatiques pour migrer diverses configurations et fichiers, tels que :

• Exécutez les opérations kubectl , telles que la mise à jour des clés secrètes et des cartes de configuration.
• Effectuez des synchronisations ArgoCD via la CLI.
• Remplacez les paramètres de configuration et redémarrez les déploiements.
• Ajoutez des fichiers de stockage au magasin d'objets Ceph.
• Restaurez et mettez à jour le DataEncryptionKey dans les clés secrètes Kubernetes de l’instance MSI.
• Synchronisez Test Manager dans ArgoCD.
• Migrez des dossiers ou des fichiers d'un magasin de fichiers Windows vers le magasin d'objets de destination, en créant la hiérarchie de répertoire requise dans le compartiment défini par les clés secrètes Kubernetes.

Configuration requise pour exécuter le script de migration de Test Manager

Afin d'exécuter correctement le script de migration de Test Manager, vous devez vous assurer que vous répondez aux exigences environnementales suivantes :

• Configurez kubectl avec une connexion au cluster Automation Suite.
  Important :

  Assurez-vous que kubeconfig est défini comme variable d'environnement.

• Installez l'utilitaire jq à l'aide de la commande suivante yum install jq.
• Installez la CLI argocd . Consultez la page Installation d’Argo CD pour plus d’informations.
• Installez rclone. Consultez la documentation RClone pour en savoir plus.
  Remarque :

  La version minimale requise pour rclone est la 1.56.0.

Remarque :

Si votre identité est gérée dans Azure, assurez-vous d'exécuter le script à l'aide d'une machine Azure.

Commandes courantes des scripts de migration de Test Manager

Consultez les commandes suivantes que vous pouvez effectuer à l’aide du script de migration de Test Manager :

 ./testmanager_migrator.sh -d -y \
  -k \"enc key value\" \
  -s blobstoragefolder
    -k|--encryption-key
        The value of the encryption key that will override the key generated during installation.
    -s|--storage-folder
        The location of the storage folder on the local disk.
    -is-|--use-incluster-storage
        Use in cluster Ceph object store.
    -d|--dry-run
        Do not update Test Manager with the new values
    -y|--accept-all
        Do not prompt for confirmation of actions