移行の前提条件

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

.NET ランタイム 6.0

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

Linux

.NET ランタイム 6.0 以降が存在しない場合は、UiPath.OrganizationMigrationApp を使用する前に、Linux 用の .NET ランタイムをダウンロードしてインストールしてください。

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

sudo yum install dotnet-sdk-6.0 -y

Windows

UiPath.OrganizationMigrationApp ツールには、.NET ランタイム 6.0 以降が必要です。.NET ランタイム 6.0 以降が存在しない場合は、UiPath.OrganizationMigrationApp を使用する前に Windows 用の .NET ランタイム 6.0 をダウンロードしてインストールしてください。

Docker/Podman

移行プロセスを完了するには、プライベート レジストリで認証された Docker または Podman クライアントを使用する必要があります。これにより、移行ツールを MSI データベースで実行できるようになり、Automation Suite データベースとの互換性が確保されます。

Docker

• Docker バイナリをダウンロードするには、 Docker Engine のインストールの公式ドキュメントをご覧ください。
• Docker レジストリに対する認証を行うには、 docker login の公式ドキュメントをご覧ください。または、次のコマンドを使用して、資格情報のサンプルを実際のレジストリ資格情報に置き換えることもできます。

  docker login my.registry.io:443 --username "admin" --password "secret"

Podman

• Podman バイナリをダウンロードするには、 公式の Podman インストール手順をご覧ください。
• Podman レジストリに対する認証を行うには、 Podman ログインの公式ドキュメントをご覧ください。または、次のコマンドを使用して、資格情報のサンプルを実際のレジストリ資格情報に置き換えることもできます。

  podman login my.registry.io:443 --username "admin" --password "secret"

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 に移動し、組織を結合するなどの操作を実行できます。

UiPath.OrganizationMigrationApp をダウンロードするには、「インストール パッケージをダウンロードする」をご覧ください。

お使いの環境に対応している UiPath.OrganizationMigrationApp のバージョンを確認するには、「 相互運用性マトリクス」をご覧ください。

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 を開きます。

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

ほとんどの場合、接続パスワードは単一引用符 (') で囲みます。ただし、パスワードに ` や $ などの特殊文字が含まれている場合は、別の方法が必要です。

このような場合、パスワードは \`"<password>\`" とフォーマットする必要があります。ここで、<password> は実際のパスワードに置き換えてください。さらに、次の表に示すエスケープ ルールにも従う必要があります。

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 O`Brian	"cn=William O``Brian"
cn=Richard #West	"cn=Richard #West"
cn=Roy Johnson$	"cn=Roy Johnson$"

例

元のパスワードが 7'8:<=XMe$y[@vC?_4ZeY8c-~y'W!1dU4gnczuf'/p>j<I であるとします。特殊文字のエスケープ ルール規則に従うと、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\`""