Migrieren zur eigenständigen oder zur Automation Suite-Umgebung

Hinweis: Ein klassisches Upgrade auf AI Center 2022.4 von 2020.10 oder 2021.4 gibt es nicht. Stattdessen müssen Sie AI Center 2022.4 eigenständig oder als Teil einer neuen Automation Suite-Installation installieren; Sie können Ihre Arbeit aus der vorherigen Umgebung migrieren. Dieses Migrationsskript funktioniert für beide Installationstypen – für eine eigenständige AI Center-Umgebung oder eine Automation Suite-Umgebung.

Um ein Upgrade für AI Center 2021.10 durchzuführen, befolgen Sie die Verfahren auf der Seite Aktualisieren des AI Center.

Überblick

Gehen Sie wie folgt vor, um von 2021.4 oder 2020.10 zu 2022.4 zu migrieren. Dazu ist eine Neuinstallation und eine Migration anstelle eines Upgrades erforderlich.

Verwenden Sie die folgenden Schritte, um die AI Center-Mandantendaten zur eigenständigen AI Center-Umgebung oder zur Automation Suite-Umgebung zu migrieren. Dieses Verfahren bietet Migrationsunterstützung für Folgendes:

• Datenbank
• Datasets
• ML-Pakete
  Hinweis: Das abrufbare Paket für Document Understanding muss vor der Bereitstellung und dem Training der migrierten DU ML-Pakete ausgeführt werden.

  Stellen Sie bei einer Air-Gap-Installation sicher, dass die Modelle mit derselben Hauptversion zu Ihren vorgefertigten Modellen hinzugefügt werden. Weitere Informationen zum Installieren von Modellen offline finden Sie unter Offlineinstallation von ML-Paketen.

Voraussetzungen

Stellen Sie sicher, dass das AI Center in beiden Umgebungen in Betrieb ist.

Darüber hinaus müssen die folgenden Voraussetzungen auf der Maschine erfüllt sein, auf der das Migrationsskript ausgeführt wird:

• Eine Linux-Maschine mit den folgenden installierten Abhängigkeiten: aws s3, s3cmd, jq, zip. Die Maschine kann eine der AI Center-Maschinen oder eine neue sein. Weitere Informationen finden Sie in den folgenden Beispielen.

Installieren von AWS S3-, s3cmd-, jq- und ZIP-Abhängigkeiten

Hinweis: Führen Sie bei nicht erfüllten Abhängigkeiten die folgenden Befehle ohne Pakete aus:

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

• Installieren Sie das MS SQL-Dienstprogramm von hier. Dazu können Sie die folgenden Befehle ausführen:

  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

• Konnektivität mit beiden AI Center-Instanzen.
• Konnektivität mit beiden Orchestrator-Instanzen (falls die Instanzen nicht identisch sind).
• Konnektivität mit SQL-Servern (falls die Instanzen nicht identisch sind).
• Möglichkeit, auf beide AI Center-Instanzen zuzugreifen.

Verfahren

Schritt 1: Erstellen eines Mandanten mit demselben Namen in der Automation Suite oder der neuen AI Center-Umgebung

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: Generieren der Storage-creds.json-Datei auf der ersten Maschine (auch Quellmaschine genannt)

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

Hinweis: Bei der Ausführung auf einer dritten Maschine müssen Sie den folgenden Befehl ausführen:

./get-credentials.sh {PUBLIC_IP_REPLICATED_MACHINE}

Hinweis: Wenn nach der Ausführung des obigen Skripts die untenstehende Fehlermeldung angezeigt wird, führen Sie den Befehl bash -l aus und versuchen Sie, das obige Skript erneut auszuführen.

Die in Schritt 2 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: Generieren der Storage-creds.json-Datei auf der zweiten Maschine

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 in Schritt 4 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: Konfigurieren der Maschine, die das Skript ausführt

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 dem ö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 TARGET_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/

Ersetzen Sie die Details in der input.json-Datei (Datei bereits im Verzeichnis vorhanden). Zur leichteren Referenz werden die Anmeldeinformationen in der input.json-Datei als TO-BE-REPLACED markiert.

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

Beispiel einer input.json-Datei mit ausgefüllten Beispielwerten für die Referenz (Bitte beachten Sie, dass der folgende Screenshot für die Migration von der Einzelquelldatenbank zur Einzelzieldatenbank dient)

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

Beispiel einer input.json-Datei mit ausgefüllten Beispielwerten für die Referenz (Bitte beachten Sie, dass der folgende Screenshot für die Migration von der Mehrquelldatenbank zur Einzelzieldatenbank dient)

{
        "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 kann wie folgt abgerufen werden:

1. Klicken Sie auf das UiPath-Logo auf der Startseite der AI Center-Anwendung.
2. 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 ist im Abschnitt „Vorschau“ zu sehen, wie im folgenden Screenshot.
   
   

   

   
   
3. 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: Ausführen des Migrationsskripts

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

Fehlersuche und ‑behebung

Erstellen von Mandanten

Der Mandant muss in der Automation Suite-Umgebung erstellt werden, bevor das Migrationsskript ausgeführt wird.

Erneutes Ausführen der Migration

Das Migrationsskript ist dazu gedacht, Datasets und ML-Pakete nur einmal zu migrieren. In seltenen Fällen werden zusätzliche Datasets oder ML-Pakete in der Quellumgebung hinzugefügt, nachdem die Migration abgeschlossen ist; in diesem Fall muss die Migration erneut durchgeführt werden. Führen Sie die folgenden Befehle in der Zieldatenbank aus, bevor Sie die Migration erneut ausführen:

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',...);

HINWEIS: 'T1','T2',… in der obigen Abfrage sind die Mandanten-UUIDs in der Zielumgebung. Dies sind die DESTINATION_TENANT_ID, die in der input.json-Datei erwähnt werden, die während der Ausführung des Migrationsskripts /mastermigrationscript.sh input.json übergeben wurde.

Sie können die Migration dann mit den folgenden Befehlen erneut ausführen:

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

Geklonte Pakete

Nach der Migration werden geklonte ML-Pakete, die in der Quellumgebung vorhanden sind, in der Automation Suite-Umgebung als VALIDATION_FAILED markiert. Diese Pakete müssen in der Zielumgebung erneut geklont werden, sobald die Migration abgeschlossen ist.

Hinweis: In diesem Fall beziehen sich geklonte Pakete auf die Pakete von UiPath und Open-Source-Paketen.