AI Center
2021.10
バナーの背景画像
AI Center インストール ガイド
最終更新日 2024年3月11日

スタンドアロンまたは Automation Suite 環境に移行する

注: AI Center 2021.10 へのクラシック アップグレードは利用できません。代わりに、AI Center™ スタンドアロン 2021.10 をインストールするか、新しい Automation Suite インストールの一部としてインストールして、以前の環境から作業を移行できます。この移行スクリプトは、どちらの種類のインストール (AI Center スタンドアロンと Automation Suite 環境) にも使用できます。

概要

v2021.4 または v2020.10 から v2021.10 に移行するには、以下の手順を実行します。このためには、アップグレードではなく、新規インストールと移行が必要になります。

以下の手順を実行して、AI Center™ テナントのデータを AI Center スタンドアロン環境または Automation Suite 環境に移行します。この手順では、以下の移行をサポートします。

  • データベース
  • データセット
  • ML パッケージ
    注: 移行した DU ML パッケージをデプロイおよびトレーニングする前に、Document Understanding オンデマンド バンドルを実行する必要があります。

    エアギャップ インストールの場合は、すぐに使えるモデルに同じメジャー バージョンのモデルが追加されていることを確認してください。モデルをオフラインでインストールする方法について詳しくは、「ML パッケージのオフライン インストール」をご覧ください。

前提条件

AI Center™ が両方の環境で起動し、実行されていることを確認します。

また、移行スクリプトを実行するマシンで、以下の前提条件が満たされている必要があります。

  • 次の依存関係がインストールされた Linux マシン: aws s3s3cmdjqzip。マシンは、いずれかの AI Center マシンまたは新しいマシンを使用できます。詳しくは、以下の例をご覧ください。

aws s3、s3cmd、jq、zip の依存関係をインストールする

注: 依存関係が満たされていない場合は、パッケージなしで以下のコマンドを実行してください。
sudo susudo apt install -y jq awscli s3cmd zip gitsudo apt --fix-broken installsudo apt install -y jq awscli s3cmd zipsudo susudo apt install -y jq awscli s3cmd zip gitsudo apt --fix-broken installsudo apt install -y jq awscli s3cmd zip
  • こちらから MS SQL ユーティリティをインストールします。それには、以下のコマンドを実行します。
    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 ~/.bashrcsudo 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
  • 両方の AI Center™ インスタンスとの接続。
  • 両方の Orchestrator インスタンスとの接続 (インスタンスが同じでない場合)。
  • SQL Server との接続 (インスタンスが同じでない場合)。
  • 両方の AI Center インスタンスにアクセスできる。

手順

手順 1: Automation Suite 環境または新しい AI Center 環境で同じ名前のテナントを作成する

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

手順 2: 最初のマシン (ソース マシンとも呼ばれる) で Storage-creds.json ファイルを生成する

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

  1. SSH を使用して、移行するマシンに接続します。
  2. 以下のコマンドを実行して、storage-creds.json ファイルを生成します。
    wget https://raw.githubusercontent.com/UiPath/ai-customer-scripts/stable/platform/sfmigration/storagemigration/get-credentials.sh
    chmod 777 get-credentials.sh
    ./get-credentials.shwget 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}./get-credentials.sh {PUBLIC_IP_REPLICATED_MACHINE}
: 上記のスクリプトを実行後に以下のエラー メッセージが表示される場合は、bash -l コマンドを実行し、上記のスクリプトを再実行してください。


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

手順 3: 2 番目のマシン で Storage-creds.json ファイルを生成する

この手順は、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/binsudo 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.shwget 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
以降の手順では、手順 4 で生成されたファイル (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/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. TARGET_CREDENTIAL_FILE ファイルの内容を、storage-creds-sf.json の内容に置き換えます (手順 3 を参照)。
  4. 以下のコマンドを実行して、ベース ディレクトリに移動します。
    cd ~/migration/ai-customer-scripts/platform/sfmigration/cd ~/migration/ai-customer-scripts/platform/sfmigration/
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
}
]{
"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 ファイルのサンプル (以下のスクリーンショットは、単一のソース DB から単一のターゲット DB への移行を示しています)
{
        "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_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"
                }
        ]
}
参照用のサンプル値が入力された input.json ファイルのサンプル (以下のスクリーンショットは、複数のソース DB から単一のターゲット DB への移行を示しています)
{
        "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_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 は、以下の手順で取得できます。

  1. AI Center™ アプリケーションのホーム ページで、UiPath のロゴをクリックします。
  2. ブラウザーを右クリックし、検査に移動します。検査ウィンドウが開いたら、[ネットワーク] タブでプロジェクトの API 呼び出しを確認します。以下のスクリーンショットに示すように、[プレビュー] セクションにテナント ID が表示されます。


  3. スクリプトを実行するマシンに、Automation Suite マシンのオブジェクト ストレージの DNS を追加します。これは、Automation Suite 環境が作成されたパイプラインの [拡張機能] タブで確認できます。
    sudo bash -c "echo "LB_IP objectstore.DNS_NAME" >> /etc/hosts"sudo bash -c "echo "LB_IP objectstore.DNS_NAME" >> /etc/hosts"

手順 5: 移行スクリプトを実行する

Usage ディレクトリ内の sfmigration がダウンロードされたフォルダーに移動して、以下のコマンドを実行します。
cd ~/migration/ai-customer-scripts/platform/sfmigration/
 
 ./mastermigrationscript.sh input.jsoncd ~/migration/ai-customer-scripts/platform/sfmigration/
 
 ./mastermigrationscript.sh input.json

トラブルシューティング

テナントを作成する

移行スクリプトを実行する前に、Automation Suite 環境でテナントを作成する必要があります。

移行を再実行する

この移行スクリプトは、データセットと ML パッケージを一度だけ移行するためのものです。まれに、移行完了後にソース環境にデータセットや ML パッケージが追加されることがあります。その場合は、移行を再実行する必要があります。移行を再実行する前に、ターゲット データベースで以下のコマンドを実行します。

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',...);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',...);
注: 上記のクエリの 'T1','T2',... は、ターゲット環境のテナント UUID です。これらは、移行スクリプト ./mastermigrationscript.sh input.json の実行中に渡された input.json ファイルに記述されている DESTINATION_TENANT_ID です。

その後、以下のコマンドを使用して移行を再実行できます。

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

複製されたパッケージ

移行後、ソース環境内に存在する複製された ML パッケージは、Automation Suite 環境で VALIDATION_FAILED とマークされます。移行が完了したら、これらのパッケージをターゲット環境で再び複製する必要があります。
注: この場合、複製されたパッケージは、UiPath のパッケージとオープンソース パッケージを指します。

Was this page helpful?

サポートを受ける
RPA について学ぶ - オートメーション コース
UiPath コミュニティ フォーラム
UiPath ロゴ (白)
信頼とセキュリティ
© 2005-2024 UiPath. All rights reserved.