- Overview
- Requirements
- Installation
- Post-installation
- Migration and upgrade
- Upgrading Automation Suite on EKS/AKS
- Step 1: Moving the Identity organization data from standalone to Automation Suite
- Step 2: Restoring the standalone product database
- Step 3: Backing up the platform database in Automation Suite
- Step 4: Merging organizations in Automation Suite
- Step 5: Updating the migrated product connection strings
- Step 6: Migrating standalone Orchestrator
- Step 7: Migrating standalone Insights
- Step 8: Deleting the default tenant
- B) Single tenant migration
- Migrating from Automation Suite on Linux to Automation Suite on EKS/AKS
- Monitoring and alerting
- Cluster administration
- Product-specific configuration
- Using the Orchestrator Configurator Tool
- Configuring Orchestrator parameters
- Orchestrator appSettings
- Configuring appSettings
- Configuring the maximum request size
- Overriding cluster-level storage configuration
- Configuring credential stores
- Configuring encryption key per tenant
- Cleaning up the Orchestrator database
- Troubleshooting
- The backup setup does not work due to a failure to connect to Azure Government
- Pods in the uipath namespace stuck when enabling custom node taints
- Unable to launch Automation Hub and Apps with proxy setup
- Pods cannot communicate with FQDN in a proxy environment
- Test Automation SQL connection string is ignored
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.
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.
