Automation Suite
2023.10
false
Step 1: Moving the Identity organization data from standalone to Automation Suite - Automation Suite 2023.10
Banner background image
logo
Automation Suite on Linux Installation Guide
Last updated Feb 13, 2024

Step 1: Moving the Identity organization data from standalone to Automation Suite

The standalone and Automation Suite versions must be the same, or else the migration will fail due to database schema conflict issues. If you experience a compatibility failure, make sure to upgrade your standalone and Automation Suite installations to the latest version.

For Linux

Note:

Make sure you download and install .NET Runtime 6.0 before running UiPath.OrganizationMigrationApp. For details, see Migration prerequisites.

To download UiPath.OrganizationMigrationApp, see Migration prerequisites.

Running the tool

Note:

Make sure to follow the general escape instructions for your Shell tool of choice. For instance, in Bash you must add `\` before special characters.

The UiPath.OrganizationMigrationApp tool supports the following parameters:

Parameter name

Short name

Description

Identity database connection of the

standalone product

sThe Identity database connection of the standalone product. If Identity and Orchestrator use thesame database, then use that database’s connection string.
Identity database connection of Automation SuitedThe Identity database connection of Automation Suite.
Rollback

r

Parameper used to roll back a change.

To move the Identity data of all tenants from standalone to Automation Suite, extract the file and run the following command:

Note:
Make sure to add TrustServerCertificate=True for all SQL connections in the input.
./UiPath.OrganizationMigrationApp migrate -a -m -s '<identity DB connection of MSI>' -d '<identity DB connection of Automation Suite>'./UiPath.OrganizationMigrationApp migrate -a -m -s '<identity DB connection of MSI>' -d '<identity DB connection of Automation Suite>'

If the operation failed in the middle, roll back the change by running the following command:

./UiPath.OrganizationMigrationApp migrate -a -m -r -s '<identity DB connection of MSI>' -d '<dentity DB connection of Automation Suite>'./UiPath.OrganizationMigrationApp migrate -a -m -r -s '<identity DB connection of MSI>' -d '<dentity DB connection of Automation Suite>'

Fix the issue based on the error message and try to move the Identity data of all tenants from standalone to Automation Suite again.

For Windows

Note:

Make sure you download and install .NET Runtime 6.0 before running UiPath.OrganizationMigrationApp. For details, see Migration prerequisites.

To download UiPath.OrganizationMigrationApp, see Migration prerequisites.

Running the tool

Note:
To successfully run the UiPath.OrganizationMigrationApp tool, you must escape your SQL password if it contains special characters. For example, replace every instance of $ with \`$.

To move the Identity data of all tenants from standalone to Automation Suite, extract the file and run the following command.

Note:
Make sure to add TrustServerCertificate=True for both source and destination SQL connection inputs.
./UiPath.OrganizationMigrationApp.exe migrate -a -m -s "<identity DB connection of MSI>" -d "<dentity DB connection of Automation Suite>"./UiPath.OrganizationMigrationApp.exe migrate -a -m -s "<identity DB connection of MSI>" -d "<dentity DB connection of Automation Suite>"

If the operation failed in the middle, roll back the change by running the following command:

./UiPath.OrganizationMigrationApp.exe migrate -a -m -r -s "<identity DB connection of MSI>" -d "<dentity DB connection of Automation Suite>"./UiPath.OrganizationMigrationApp.exe migrate -a -m -r -s "<identity DB connection of MSI>" -d "<dentity DB connection of Automation Suite>"

Fix the issue based on the error message and try to move the Identity data of all tenants from standalone to Automation Suite again.

  • For Linux
  • Running the tool
  • For Windows
  • Running the tool
Support and Services icon
Get The Help You Need
UiPath Academy icon
Learning RPA - Automation Courses
UiPath Forum icon
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.