移行の前提条件

移行を開始する前に、以下の前提条件を満たしていることを確認してください。

.NET ランタイム 6.0

UiPath.OrganizationMigrationApp ツールを実行するには、.NET ランタイム 6.0 以降が必要です。UiPath.OrganizationMigrationApp を実行する前に、.NET ランタイム 6.0 以降をダウンロードしてインストールする必要があります。

Linux

If .NET Runtime 6.0 or later is not present, download and install .NET Runtime for Linux before using UiPath.OrganizationMigrationApp.

RHEL に .NET ランタイム 6.0 をインストールするには、次のコマンドを実行します。

sudo yum install dotnet-sdk-6.0 -y

Windows

The UiPath.OrganizationMigrationApp tool requires .NET Runtime 6.0 at a minimum. If .NET Runtime 6.0 and beyond is not present, download and install .NET Runtime 6.0 for Windows before using UiPath.OrganizationMigrationApp.

Orchestrator バケットの作成設定

正しい CORS ポリシーを使用して Orchestrator バケットが自動的に作成されるようにするには、次のコマンドを実行する必要があります。 コマンドを実行するには、マシンに jq ユーティリティがインストールされている必要があります。

cd <AS install directory>
rm -f values.json && rm -f appsettings.json
kubectl -n uipath get cm orchestrator-customconfig -o jsonpath='{.data.values\.json}' | jq '.' > values.json
jq '.AppSettings' values.json > appsettings.json
jq '.["Storage.CreateBucket.OnTenantCreation.Enabled"] = "true"' appsettings.json > temp.json && mv -f temp.json appsettings.json
./bin/uipathctl config orchestrator update-config --app-settings appsettings.json

jqをインストールするには、以下のいずれかのオプションを使用します。

• オプション 1: 次のコマンドを実行します。

  yum install -y epel-release yum install -y jq
  

• オプション 2: 次のコマンドを実行します。

  shell
  curl https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/j/jq-1.6-2.el7.x86_64.rpm --output /tmp/jq-1.6-2.el7.x86_64.rpm
  yum localinstall /tmp/jq-1.6-2.el7.x86_64.rpm
  

警告:

バケットが正しい CORS ポリシーで自動的に作成されるようにする Orchestrator の設定を有効化しないと、ストレージ バケットからのダウンロードに問題が発生します。CORS ポリシーを手動で更新して対処する必要があります。

設定が有効化されていることを確認するには、次のコマンドを実行します。

kubectl -n uipath get cm orchestrator-customconfig -o jsonpath='{.data.values\.json}' | jq

この設定が有効化されている場合、コマンドは次の応答を返す必要があります。

{
  "AppSettings": {
    "Storage.CreateBucket.OnTenantCreation.Enabled": "true"
  }
}

UiPath.OrganizationMigrationApp

UiPath.OrganizationMigrationApp ツールを使用して、すべてのテナントの Identity データをスタンドアロンから Automation Suite に移動し、組織を結合するなどの操作を実行できます。

To download UiPath.OrganizationMigrationApp, see Downloading the installation packages.

To see which UiPath.OrganizationMigrationApp version is compatible with your environment, see Compatibility matrix.

Microsoft SQL Server を管理するためのツール

Microsoft SQL Server を管理するために、SQL Server Management Studio (SSMS) または同様のツールをダウンロードしてインストールする必要があります。このツールを使用して、Orchestrator データベースを Automation Suite SQL Server インスタンスまたは別の SQL Server インスタンスに復元できます。

1. SQL Server Management Studio をダウンロードしてインストールします。
2. スタンドアロン SQL の接続文字列を使用してスタンドアロン SQL Server にログインします。
3. ソースとターゲットのデータベースに対してポート 1433 を開きます。

接続文字列パスワードに含まれる特殊文字のエスケープ ルール

In most instances, connection passwords are encapsulated within a single quotation mark ('). However, when the password includes special characters such as ``` or $, a different approach is required.

In these cases, the password must be formatted as \"`", replacing ` with the actual password. Moreover, you must also adhere to the escape rules as detailed in the following table:

ADUC の元の形式	PowerShell のエスケープした文字列の形式
cn=James $ Smith	"cn=James $ Smith"`
cn=Sally Wilson + Jones	"cn=Sally Wilson \+ Jones"
cn=William O'Brian	"cn=William O'Brian"
cn=William OBrian`	"cn=William O``Brian"
cn=Richard #West	"cn=Richard #West"
cn=Roy Johnson$	"cn=Roy Johnson$"

例

Assume that the original password is 7'8:<=XMe$y[@vC?_4ZeY8c-~y'W!1dU4gnczuf'/p>j<I. Adhering to the special character escape rules, it becomes: Password=\"7'8:<=XMe$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\"`.

宛先接続文字列にパスワードを設定した完全なコマンドは、次のようになります。

./UiPath.OrganizationMigrationApp.exe migrate -a -m -s "Server=tcp:abc.com,1433;Initial Catalog=UiPath_20230531;Persist Security Info=False;User ID=username;Password=asiodhyf;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;" -d "Server=tcp:cde.net,1433;Initial Catalog=AutomationSuite_Platform;Persist Security Info=False;User Id=[e-mail];Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`""