Migrer vers l'environnement autonome ou Automation Suite

Remarque : une mise à niveau classique vers AI Center 2021.10 n'est pas disponible. À la place, vous devez installer une version d'AI Center 2021.10 autonome ou effectuer une nouvelle installation d'Automation Suite. Vous pourrez ensuite migrer votre travail depuis l'environnement précédent. Ce script de migration fonctionne pour les deux types d'installations, AI Center autonome ou l'environnement Automation Suite.

Vue d'ensemble (Overview)

Utilisez cette procédure pour migrer de 2021.4 ou 2020.10 vers 2021.10. Pour ce faire, une nouvelle installation et une migration sont nécessaires au lieu d'une mise à niveau.

Utilisez les étapes suivantes pour migrer les données du locataire AI Center vers l'environnement autonome AI Center ou l'environnement Automation Suite. Cette procédure offre une prise en charge de la migration pour les éléments suivants :

• Base de donnés
• Jeux de données
• Paquets ML
  Remarque : le bundle à la demande Document Understanding doit être exécuté avant le déploiement et la formation des paquets DU ML migrés.

  En cas d'installation physiquement isolée, assurez-vous que les modèles avec la même version majeure sont ajoutés à vos modèles prêts à l'emploi. Pour plus d'informations sur l'installation de modèles hors ligne, consultez Installation hors ligne de paquets ML.

Prérequis

Assurez-vous qu'AI Center est opérationnel dans les deux environnements.

De plus, les conditions préalables suivantes doivent être remplies sur la machine sur laquelle le script de migration s'exécute :

• Une machine Linux avec les dépendances suivantes installées : aws s3, s3cmd, jq, zip. La machine peut être l'une des machines AI Center ou une nouvelle. Pour plus d'informations, consultez l'exemple ci-dessous.

Installation des dépendances aws s3, s3cmd, jq, zip

Remarque : si des dépendances sont non satisfaites, exécutez les commandes suivantes sans packages :

sudo susudo apt install -y jq awscli s3cmd zip gitsudo apt --fix-broken installsudo apt install -y jq awscli s3cmd zip

• Installez l'utilitaire MS SQL ici. Vous pouvez le faire en exécutant les commandes suivantes :

  sudo su
  curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -curl https://packages.microsoft.com/config/ubuntu/16.04/prod.list | sudo tee /etc/apt/sources.list.d/msprod.listsudo apt-get update 
  sudo apt-get install mssql-tools unixodbc-devsudo apt-get update 
  sudo apt-get install mssql-toolsecho 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profileecho 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
  source ~/.bashrc

• Connectivité avec les deux instances AI Center.
• Connectivité avec les deux instances d'Orchestrator (au cas où les instances ne seraient pas identiques).
• Connectivité avec les serveurs SQL (au cas où les instances ne seraient pas les mêmes).
• Possibilité d'accéder aux deux instances AI Center.

Procédure

Étape 1 : créer un locataire portant le même nom dans l'environnement Automation Suite

Créez un locataire correspondant dans l'environnement Automation Suite pour chaque locataire que vous souhaitez migrer.

Étape 2 : générer le fichier Storage-creds.json sur la première machine (également appelée machine source)

Cette étape doit être exécutée sur la première machine, celle que vous souhaitez migrer vers le nouvel environnement.

1. Connectez-vous à la machine que vous souhaitez migrer en utilisant SSH.
2. Générez le fichier storage-creds.json en exécutant la commande ci-dessous :

   wget https://raw.githubusercontent.com/UiPath/ai-customer-scripts/stable/platform/sfmigration/storagemigration/get-credentials.sh
   chmod 777 get-credentials.sh
   ./get-credentials.sh

Remarque : si vous exécutez à partir d'une troisième machine, assurez-vous d'exécuter la commande suivante :

./get-credentials.sh {PUBLIC_IP_REPLICATED_MACHINE}

Remarque : si le message d'erreur ci-dessous s'affiche après l'exécution du script ci-dessus, exécutez la commande bash -l et essayez à nouveau d'exécuter le script ci-dessus

Le fichier généré à l'étape 2 (storage-creds.json) sera utilisé dans les étapes suivantes. Assurez-vous de copier et d'enregistrer le contenu du fichier localement.

Étape 3 : générer le fichier Storage-creds.json sur la deuxième machine

Cette étape doit être exécutée sur la deuxième machine, celle qui s'exécute sur l'environnement Automation Suite.

1. Ouvrez le port 22 sur la machine Automation Suite.
2. Connectez-vous à la machine Automation Suite à l'aide de SSH.
3. Exécutez la commande ci-dessous :

   sudo su
   export KUBECONFIG=/etc/rancher/rke2/rke2.yaml PATH=$PATH:/var/lib/rancher/rke2/bin

4. Téléchargez le fichier d'informations d'identification en exécutant la commande ci-dessous :

   wget https://raw.githubusercontent.com/UiPath/ai-customer-scripts/stable/platform/sfmigration/storagemigration/get-credentials-sf.sh
   chmod 777 get-credentials-sf.sh
   ./get-credentials-sf.sh

Le fichier généré à l'étape 4 (storage-creds-sf.json) sera utilisé dans les étapes suivantes. Assurez-vous de copier et d'enregistrer le contenu du fichier localement.

Étape 4 : Configurer la machine exécutant le script

Avant de suivre les étapes ci-dessous, créez manuellement un locataire portant le même nom dans l'environnement Automation Suite. Quel que soit le locataire à migrer, un locataire correspondant doit également être créé dans Automation Suite.

Cette étape doit être exécutée sur la machine exécutant le script.

1. Exécutez la commande ci-dessous pour télécharger le script de migration (ceci téléchargera le script à partir du référentiel git public) :

   sudo su 
   cd ~
   mkdir migration
   cd migration
   git clone https://github.com/UiPath/ai-customer-scripts
   cd ai-customer-scripts
   git checkout stable
   cd platform
   chmod 777 -R sfmigration
   cd ~/migration/ai-customer-scripts/platform/sfmigration/storagemigration/

2. Remplacez le contenu du fichier SOURCE_CREDENTIAL_FILE par le contenu de storage-creds.json (voir l'étape 3).
3. Remplacez le contenu du fichier TARGET_CREDENTIAL_FILE par le contenu de storage-creds-sf.json (voir l'étape 3).
4. Accédez au répertoire de base en exécutant la commande suivante :

   cd ~/migration/ai-customer-scripts/platform/sfmigration/

Remplacez les détails dans le fichier input.json (fichier déjà présent dans le répertoire). Pour simplifier la référence, les informations d'identification sont marquées comme TO-BE-REPLACED dans le fichier input.json.

L'exemple de fichier JSON avec la description de chaque champ est mentionné ci-dessous.

{
"SRC_AIC_INSTALLATION_VERSION": "TO-BE-REPLACED", // Values can be : 20.10 OR 21.4
"SRC_SERVER": "TO-BE-REPLACED",   // Replicated SQL Server host
"SRC_PKGMANAGER_DB_NAME": "TO-BE-REPLACED", // Replicated SQL Server Pkgmanager DB name
"SRC_PKGMANAGER_DB_SCHEMA": "ai_pkgmanager", // Replicated SQL Server Pkgmanager DB schema, Note : Please check schema in case of multiple dbs in replicated
"SRC_PKGMANAGER_DB_USERNAME": "TO-BE-REPLACED", // Replicated SQL Server Pkgmanager DB Username
"SRC_PKGMANAGER_DB_PASSWORD": "TO-BE-REPLACED",  // Replicated SQL Server Pkgmanager DB Password
"SRC_TRAINER_DB_NAME": "TO-BE-REPLACED", // Replicated SQL Server AI-Trainer DB Name
"SRC_TRAINER_DB_SCHEMA": "ai_trainer", // Replicated SQL Server AI-Trainer DB Schema, Note : Please check schema in case of multiple dbs in replicated
"SRC_TRAINER_DB_USERNAME": "TO-BE-REPLACED", // Replicated SQL Server AI-Trainer DB Username
"SRC_TRAINER_DB_PASSWORD": "TO-BE-REPLACED",// Replicated SQL Server AI-Trainer DB Password
"DESTINATION_SERVER": "TO-BE-REPLACED", // Destination SQL Server host i.e ServiceFabric SQL Server host
"DESTINATION_DB_NAME": "TO-BE-REPLACED", // Destination SQL Server DB Name
"DESTINATION_PKGMANAGER_DB_SCHEMA": "ai_pkgmanager", 
"DESTINATION_TRAINER_DB_SCHEMA": "ai_trainer",
"DESTINATION_DB_USERNAME": "TO-BE-REPLACED", // Destination SQL Server Username
"DESTINATION_DB_PASSWORD": "TO-BE-REPLACED", // Destination SQL Server Password
"TENANT_MAP": [
{
"SRC_TENANT_ID": "TO-BE-REPLACED", // Source Tenant Id i.e tenant UUID in replicated environment
"DESTINATION_TENANT_ID": "TO-BE-REPLACED", // Destination Tenant Id i.e Tenant UUID in the destination environment
"DESTINATION_ACCOUNT_ID": "TO-BE-REPLACED" // Destination Account UUID Id , host if Migrating to ServiceFabric standalone environment otherwise provide the actual Account UUID
}
]

Exemple de fichier input.json avec des exemples de valeurs remplis pour référence (veuillez noter que la capture d'écran ci-dessous concerne la migration d'une base de données source unique vers une base de données de destination unique)

{
        "SRC_AIC_INSTALLATION_VERSION": "20.10",
        "SRC_SERVER": "sankar-sf-migration1sqlserver.database.windows.net",
        "SRC_PKGMANAGER_DB_NAME": "aifabric",
        "SRC_PKGMANAGER_DB_SCHEMA": "ai_pkgmanager",
        "SRC_PKGMANAGER_DB_USERNAME": "test",
        "SRC_PKGMANAGER_DB_PASSWORD": "test",
        "SRC_TRAINER_DB_NAME": "aifabric",
        "SRC_TRAINER_DB_SCHEMA": "ai_trainer",
        "SRC_TRAINER_DB_USERNAME": "test",
        "SRC_TRAINER_DB_PASSWORD": "test",
        "DESTINATION_SERVER": "sfdev2290542-9a5254d2-sql.database.windows.net",
        "DESTINATION_DB_NAME": "AutomationSuite_AICenter",
        "DESTINATION_PKGMANAGER_DB_SCHEMA": "ai_pkgmanager",
        "DESTINATION_TRAINER_DB_SCHEMA": "ai_trainer",
        "DESTINATION_DB_USERNAME": "test",
        "DESTINATION_DB_PASSWORD": "test",
        "TENANT_MAP": [
                {
                        "SRC_TENANT_ID": "d1eb428c-e188-46bf-a1dd-8908f90b4084",
                        "DESTINATION_TENANT_ID": "03527165-b242-4b98-834f-2eb3e5957223",
                        "DESTINATION_ACCOUNT_ID": "8cd64e27-12f4-427c-a575-dd4f2ea82551"
                }
        ]
}

Exemple de fichier input.json avec des valeurs d'exemple remplies pour référence (veuillez noter que la capture d'écran ci-dessous concerne la migration d'une base de données multi-sources vers une base de données de destination unique)

{
        "SRC_AIC_INSTALLATION_VERSION": "20.10",
        "SRC_SERVER": "sankar-sf-migration1sqlserver.database.windows.net",
        "SRC_PKGMANAGER_DB_NAME": "aifabric_pkgmanager",
        "SRC_PKGMANAGER_DB_SCHEMA": "ai_pkgmanager",
        "SRC_PKGMANAGER_DB_USERNAME": "test_1",
        "SRC_PKGMANAGER_DB_PASSWORD": "test_1",
        "SRC_TRAINER_DB_NAME": "aifabric_trainer",
        "SRC_TRAINER_DB_SCHEMA": "ai_trainer",
        "SRC_TRAINER_DB_USERNAME": "test_2",
        "SRC_TRAINER_DB_PASSWORD": "test_2",
        "DESTINATION_SERVER": "sfdev2290542-9a5254d2-sql.database.windows.net",
        "DESTINATION_DB_NAME": "AutomationSuite_AICenter",
        "DESTINATION_PKGMANAGER_DB_SCHEMA": "ai_pkgmanager",
        "DESTINATION_TRAINER_DB_SCHEMA": "ai_trainer",
        "DESTINATION_DB_USERNAME": "test",
        "DESTINATION_DB_PASSWORD": "test",
        "TENANT_MAP": [
                {
                        "SRC_TENANT_ID": "d1eb428c-e188-46bf-a1dd-8908f90b4084",
                        "DESTINATION_TENANT_ID": "03527165-b242-4b98-834f-2eb3e5957223",
                        "DESTINATION_ACCOUNT_ID": "8cd64e27-12f4-427c-a575-dd4f2ea82551"
                }
        ]
}

SRC_TENANT_ID peut être obtenu en suivant les étapes ci-dessous :

1. Cliquez sur le logo UiPath sur la page d'accueil de l'application AI Center.
2. Faites un clic droit sur le navigateur et accédez à inspecter (inspect). Une fois la fenêtre d'inspection ouverte, vérifiez l'onglet réseau pour les appels d'API de projets (projects API call). L'identifiant du locataire peut être vu dans la section Aperçu comme dans la capture d'écran ci-dessous.
   
   

   

   
   
3. Ajoutez le DNS du stockage d'objets de la machine Automation Suite dans le script d'exécution de la machine. Cela se trouve dans l'onglet d'extension du pipeline à partir duquel l'environnement Automation Suite a été créé.

   sudo bash -c "echo "LB_IP objectstore.DNS_NAME" >> /etc/hosts"

Étape 5 : Exécuter le script de migration

Accédez au dossier où le sfmigration est téléchargé dans le répertoire Usage : Exécutez la commande suivante :

cd ~/migration/ai-customer-scripts/platform/sfmigration/
 
 ./mastermigrationscript.sh input.json

Résolution des problèmes

Création de locataires

Le locataire doit être créé dans l'environnement Automation Suite avant d'exécuter le script de migration.

Relancer la migration

Le script de migration est destiné à migrer les ensembles de données et les paquets ML une seule fois. En de rares occasions, des ensembles de données ou des paquets ML supplémentaires ont été ajoutés dans l'environnement source une fois la migration terminée ; dans ce cas, la migration doit être réexécutée. Exécutez les commandes suivantes dans la base de données de destination avant de relancer la migration :

delete from [ai_pkgmanager].[ml_package_versions_temp];
delete from [ai_pkgmanager].[projects] where tenant_id in ('T1','T2',...);
delete from [ai_pkgmanager].[ml_packages] where tenant_id in ('T1','T2',...);
delete from [ai_pkgmanager].[ml_package_versions] where tenant_id in ('T1','T2',...);
delete from [ai_trainer].[datasets] where tenant_id in ('T1','T2',...);

REMARQUE : 'T1', 'T2',... dans la requête ci-dessus sont les UUID du locataire dans l'environnement de destination. Il s'agit des DESTINATION_TENANT_ID, comme mentionné dans le fichier input.json transmis lors de l'exécution du script de migration ./mastermigrationscript.sh input.json

Vous pouvez ensuite relancer la migration à l'aide des commandes suivantes :

cd ~/migration/ai-customer-scripts/platform/sfmigration/
 
./mastermigrationscript.sh input.json

Packages clonés

Après la migration, les paquets ML clonés présents dans l'environnement source seront marqués comme VALIDATION_FAILED dans l'environnement Automation Suite. Ces packages doivent être à nouveau clonés dans l'environnement de destination une fois la migration terminée.

Remarque : dans ce cas, les packages clonés font référence aux packages de UiPath et Open-Source Packages.