- Overview
- Requirements
- Pre-installation
- Preparing the installation
- Installing and configuring the service mesh
- Downloading the installation packages
- Configuring the OCI-compliant registry
- Granting installation permissions
- Installing and configuring the GitOps tool
- Deploying Redis through OperatorHub
- Applying miscellaneous configurations
- Running uipathctl
- Installation
- Post-installation
- Migration and upgrade
- Upgrading Automation Suite
- Migrating standalone products to Automation Suite
- Step 1: Restoring the standalone product database
- Step 2: Updating the schema of the restored product database
- Step 3: Moving the Identity organization data from standalone to Automation Suite
- Step 4: Backing up the platform database in Automation Suite
- Step 5: Merging organizations in Automation Suite
- Step 6: Updating the migrated product connection strings
- Step 7: Migrating standalone Orchestrator
- Step 8: Migrating standalone Insights
- Step 9: Deleting the default tenant
- Performing a single tenant migration
- Migrating between Automation Suite clusters
- Cluster administration
- Product-specific configuration
- Troubleshooting
Automation Suite on OpenShift installation guide
Migrating standalone products to Automation Suite
For migrating your standalone product data to Automation Suite, you can follow one of the two processes available:
You must choose one process to use, you cannot use both.
This page describes the differences between the two options to help you choose which one to use.
To migrate your standalone Orchestrator data to Automation Suite, you can use the UiPath Automation Cloud™ Migration Tool. The tool helps you run a single tenant migration process and copy strictly the entities present in your standalone Orchestrator. The tool retrieves these entities from standalone Orchestrator over API and then writes them in Automation Suite over API.
The tool can migrate to either Automation Cloud or Automation Suite, but this guide describes the process of migrating to Automation Suite. For instructions on migrating to Automation Cloud, see the Automation Cloud documentation instead.
You can only use the Automation Cloud Migration Tool if:
- your standalone Orchestrator version is 2019.10.x, 2020.10.x, 2021.4.x,, 2021.10.x, or later.
- your Automation Suite version is 2021.10.x or later.
Both processes are for moving your data from the standalone installation of Orchestrator to the Orchestrator service in Automation Suite, but there are some differences.
The full installation migration process essentially links your standalone Orchestrator database to Automation Suite, so all the data it includes is available in Automation Suite. You should use this method if, in addition to Orchestrator, you also want to migrate other products and services.
The full migration option ensures high-fidelity data transfer between the standalone product databases and the automatically created Automation Suite databases. If you do not want to use the default Automation Suite databases, you can opt for your own migrated databases provided that you update their connection strings.
The single tenant migration process, on the other hand, uses the Automation Cloud™ Migration Tool to strictly copy the entities present in your standalone Orchestrator. The tool retrieves them from standalone Orchestrator over API and then writes them in Automation Suite over API.
| Full installation migration |
Single tenant migration | |
|---|---|---|
|
Scope |
|
|
|
Outcome |
Orchestrator in Automation Suite contains exactly the same data and is configured in exactly the same way as your standalone Orchestrator. |
All your entities are copied over to Orchestrator, but Orchestrator in Automation Suite uses the default Automation Suite configuration. To get to the same setup you had in your standalone installation, you must perform a first-time configuration of Automation Suite, which you can do at any time - before or after migration. |
|
Prerequisites |
Requires that you upgrade standalone Orchestrator to a version that matches the targeted Automation Suite version. |
Supports direct migration from any supported standalone Orchestrator version 2019.4. |
|
Organization hierarchy |
You have two options:
|
You can migrate your tenants to the same organization, or to several organizations, as needed. |
Although typically you can only use one migration option or the other, this sample scenario describes a use case where you could use both.
If you intend to perform the full migration, the Automation Cloud Migration Tool can support the migration process by allowing you to more easily set up a test environment in Automation Suite with production data that you can use for end-to-end testing.
If you want to first test Automation Suite and would like to do so on your actual Orchestrator data, here is what the full process might look like:
- Deploy Automation Suite in a test or development environment.
-
Migrate partial data from standalone Orchestrator to Automation Suite using the Cloud Migration Tool. See Single tenant migration for instructions.
This allows you to perform a proof-of-concept or trial on a real dataset. At this point, you have your Orchestrator data, but you are using the default Automation Suite and Orchestrator configurations. You can, for example, readily test run a process, but you cannot readily log in with an SSO account.
- With the partial migration complete, validate critical scenarios and use cases and address any issues.
-
Upgrade the test environment for standalone Orchestrator to the desired version.
Follow the instructions in Updating using the Windows installer and make sure to put the environment in read-only mode.
- Perform a test migration to Automation Suite following the Full migration instructions.
- Redirect all test users and robots to the new Automation Suite test environment.
- Address any issues during and after the migration, validate the process end-to-end.
- Deploy Automation Suite in a production environment.
-
Upgrade you production environment for standalone Orchestrator to the desired version.
Follow the instructions in Updating using the Windows installer and make sure to put the environment in read-only mode.
-
Perform the full production migration to Automation Suite following the Full migration instructions.
Important: This overwrites the previously migrated data, which is lost. With this migration, all your custom configurations are applied, and your Orchestrator entities are also migrated. You should see the same information in Automation Suite as you do in your standalone Orchestrator. - Redirect all production users and robots to the new Automation Suite production environment.
If needed, you can discard tenants from standalone Orchestrator that you no longer need (for example, testing tenants). If you do not create an organization and tenant pair for a tenant from your standalone installation, it is not available in Automation Suite. The data for any discarded tenants is still migrated to the new database, but the tenants are not accessible from the user interface.
