手順

手順の概要については、以下をご覧ください。各手順については、次のページで詳しく説明しています。

1. Automation Suite 環境または新しい AI Center 環境で同じ名前のテナントを作成します。
2. 最初のマシン (ソース マシンとも呼ばれる) で storage-cred.json ファイルを生成します。
3. 2 番目のマシンで storage-creds.json ファイルを生成します。
4. スクリプトを実行するマシンを設定します。
5. 移行スクリプトを実行します。

ステップ 1

移行するすべてのテナントに対して、対応するテナントを Automation Suite 環境または新しい AI Center 環境で作成します。

ステップ 2

この手順は、新しい環境に移行する最初のマシンで実行する必要があります。

1. SSH を使用して、移行するマシンに接続します。
2. 以下のコマンドを実行して、storage-cred.json ファイルを生成します。

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

   3 番目のマシンから実行する場合は、以下のコマンドを実行します。

   ./get-credentials.sh {PUBLIC_IP_REPLICATED_MACHINE}

   上記のスクリプトを実行後に以下のエラー メッセージが表示される場合は、bash -1 コマンドを実行し、上記のスクリプトを再実行してください。

   

以降の手順では、生成されたファイル (storage-creds.json) が使用されます。ファイルの内容をコピーして、ローカルに保存してください。

ステップ 3

この手順は、Automation Suite 環境で実行される 2 番目のマシンで実行する必要があります。

1. Automation Suite マシンでポート 22 を開きます。
2. SSH を使用して Automation Suite マシンに接続します。
3. 以下のコマンドを実行します。

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

4. 以下のコマンドを実行して、資格情報ファイルをダウンロードします。

   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

以降の手順では、生成されたファイル (storage-creds-sf.json) が使用されます。ファイルの内容をコピーして、ローカルに保存してください。

手順 4

以下の手順を実行する前に、Automation Suite 環境で同じ名前のテナントを手動で作成します。どのテナントを移行する必要がある場合でも、対応するテナントを Automation Suite にも作成する必要があります。

この手順は、スクリプトを実行するマシンで実行する必要があります。

1. 以下のコマンドを実行して、移行スクリプトをダウンロードします。パブリック Git リポジトリからスクリプトがダウンロードされます。

   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. SOURCE_CREDENTIAL_FILE ファイルの内容を、storage-creds.json の内容に置き換えます (手順 2 を参照)。
3. TARGE_CREDENTIAL_FILE ファイルの内容を、storage-creds-sf.json の内容に置き換えます (手順 3 を参照)。
4. 以下のコマンドを実行して、ベース ディレクトリに移動します。

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

5. input.json ファイル内の詳細を置き換えます。参照しやすいように、資格情報は input.json ファイル内で TO-BE-REPLACED とマークされています。

以下に、各フィールドの説明を含む JSON ファイルのサンプルを示します。

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

参照用にサンプル値が入力されたサンプル input.json ファイル:

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

注: SRC_TENANT_ID は以下の手順で取得できます。

• AI Center アプリケーションのホーム ページで、UiPath のロゴをクリックします。
• ブラウザーを右クリックし、検査に移動します。検査ウィンドウが開いたら、[ネットワーク] タブでプロジェクトの API 呼び出しを確認します。[プレビュー] セクションにテナント ID が表示されます。
• スクリプトを実行するマシンに、Automation Suite マシンのオブジェクト ストレージの DNS を追加します。これは、Automation Suite 環境が作成されたパイプラインの [拡張機能] タブで確認できます。

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

手順 5

Usage ディレクトリ内の sfmigration がダウンロードされたフォルダーに移動して、以下のコマンドを実行します。

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