Verfahren

Eine Übersicht über das Verfahren finden Sie in den folgenden Schritten. Jeder Schritt wird auf den folgenden Seiten beschrieben.

1. Erstellen Sie einen Mandanten mit demselben Namen in der Umgebung der Automation Suite bzw. des neuen AI Center.
2. Generieren der storage-cred.json-Datei auf der ersten Maschine (auch „Quellmaschine“ genannt).
3. Generieren der storage-creds.json-Datei auf der zweiten Maschine.
4. Konfigurieren der Maschine, die das Skript ausführt.
5. Führen Sie das Migrationsskript aus.

Schritt 1

Erstellen Sie einen entsprechenden Mandanten in der Automation Suite oder der neuen AI Center-Umgebung für jeden Mandanten, den Sie migrieren möchten.

Schritt 2

Dieser Schritt muss auf der ersten Maschine ausgeführt werden, also derjenigen, die in die neue Umgebung migriert werden soll.

1. Verbinden Sie sich per SSH mit der Maschine, die Sie migrieren möchten.
2. Generieren Sie die storage-cred.json-Datei, indem Sie den folgenden Befehl ausführen:

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

   Wenn Sie von einer dritten Maschine aus arbeiten, müssen Sie den folgenden Befehl ausführen:

   ./get-credentials.sh {PUBLIC_IP_REPLICATED_MACHINE}

   Wenn die folgende Fehlermeldung nach dem Ausführen des obigen Skripts angezeigt wird, führen Sie den Befehl bash -1 aus, und versuchen Sie erneut, das obige Skript auszuführen.

   

Die generierte Datei (storage-creds.json) wird in weiteren Schritten verwendet. Stellen Sie sicher, dass Sie den Inhalt der Datei lokal kopieren und speichern.

Schritt 3

Dieser Schritt muss auf der zweiten Maschine ausgeführt werden, der in der Automation Suite-Umgebung ausgeführt wird.

1. Öffnen Sie Port 22 auf der Automation Suite-Maschine.
2. Stellen Sie die Verbindung mit SSH mit der Automation Suite-Maschine her.
3. Führen Sie den folgenden Befehl aus:

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

4. Laden Sie die Anmeldeinformationsdatei herunter, indem Sie den folgenden Befehl ausführen:

   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

Die generierte Datei (storage-creds-sf.json) wird in weiteren Schritten verwendet. Stellen Sie sicher, dass Sie den Inhalt der Datei lokal kopieren und speichern.

Schritt 4

Bevor Sie die folgenden Schritte ausführen, erstellen Sie manuell einen Mandanten mit demselben Namen in der Automation Suite-Umgebung. Unabhängig davon, welcher Mandant migriert werden soll, muss auch ein entsprechender Mandant in der Automation Suite erstellt werden.

Dieser Schritt muss auf der Maschine ausgeführt werden, die das Skript ausführt.

1. Führen Sie den folgenden Befehl aus, um das Migrationsskript herunterzuladen. Dadurch wird das Skript aus einem öffentlichen Git-Repository heruntergeladen:

   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. Ersetzen Sie den Inhalt in der Datei SOURCE_CREDENTIAL_FILE durch den Inhalt aus storage-creds.json (siehe Schritt 2).
3. Ersetzen Sie den Inhalt in der Datei TARGE_CREDENTIAL_FILE durch den Inhalt aus storage-creds-sf.json (siehe Schritt 3).
4. Gehen Sie in das Basisverzeichnis, indem Sie den folgenden Befehl ausführen:

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

5. Ersetzen Sie die Angaben in der Datei input.json. Zur besseren Orientierung sind die Anmeldeinformationen in der Datei input.json als TO-BE-REPLACED gekennzeichnet.

Die JSON-Beispieldatei mit Beschreibung der einzelnen Felder wird unten erwähnt:

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

Beispieldatei input.json mit ausgefüllten Beispielwerten als Referenz:

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

Hinweis: SRC_TENANT_ID erhalten Sie, indem Sie die folgenden Schritte ausführen:

• Klicken Sie auf das UiPath-Logo auf der Startseite der AI Center-Anwendung.
• Klicken Sie mit der rechten Maustaste auf den Browser und gehen Sie zu „Überprüfen“. Sobald das Fenster „Überprüfen“ geöffnet ist, überprüfen Sie die Registerkarte „Netzwerk“ auf Projekt-API-Aufrufe. Die Mandanten-ID wird im Vorschau-Abschnitt angezeigt.
• Fügen Sie das DNS des Objektspeichers der Automation Suite-Maschine in das Skript zur Ausführung der Maschine ein. Dies finden Sie auf der Registerkarte „Erweiterung“ der Pipeline, aus der die Automation Suite-Umgebung erstellt wurde.

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

Schritt 5

Gehen Sie zu dem Ordner, in den sfmigration in das Nutzungsverzeichnis heruntergeladen wird: Führen Sie den folgenden Befehl aus:

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