Procédure

Pour obtenir un aperçu de la procédure, consultez les étapes ci-dessous. Chaque étape est détaillée dans les pages suivantes.

1. Créer un locataire portant le même nom dans Automation Suite ou dans le nouvel environnement AI Center.
2. Générer le fichier storage-cred.json sur la première machine (également appelée machine source)
3. Générer le fichier storage-creds.json sur la deuxième machine
4. Configurer la machine exécutant le script
5. Exécuter le script de migration.

Étape 1

Créez un locataire correspondant dans Automation Suite ou dans le nouvel environnement AI Center pour chaque locataire que vous souhaitez migrer.

Étape 2

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-cred.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

   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}

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

   

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

Étape 3 :

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é (storage-creds-sf.json) sera utilisé dans les étapes suivantes. Assurez-vous de copier et d'enregistrer le contenu du fichier localement.

Étape 4

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. Cela téléchargera le script à partir d'un 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 TARGE_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/

5. Remplacez les détails dans le fichier input.json. 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 valeurs d'échantillon remplies pour référence :

{
        "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"
                }
        ]
}

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

• Cliquez sur le logo UiPath® sur la page d’accueil de l’application AI Center .
• 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’ID de locataire est visible dans la section Aperçu (Preview Section).
• 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

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