移行の前提条件

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

.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 をダウンロードしてインストールしてください。

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\`""