After you upgrade your vRealize Automation from version 6.x to version 7.2, you can migrate your existing external Orchestrator 6.x installed on Windows to the Orchestrator server that is built into vRealize Automation 7.2.
About this task
If you have a distributed vRealize Automation environment with multiple vRealize Automation Appliance nodes, perform the migration procedure only on the primary vRealize Automation node.
Upgrade your vRealize Automation from version 6.x to version 7.2.
Stop the Orchestrator server service of the external Orchestrator.
Back up the database, including the database schema, of the external Orchestrator server.Note:
If you plan to use the source Orchestrator environment until the new one is fully configured, create a copy of the source database. Otherwise, you can configure the target Orchestrator to use the same database but in that case the source Orchestrator environment will no longer work because the database schema is upgraded to the version of the target Orchestrator.
- Download the migration tool from the target Orchestrator server.
- Log in to the vRealize Automation Appliance over SSH as root.
- Download the migration-tool.zip archive that is located in the /var/lib/vco/downloads directory.
- Export the Orchestrator configuration from the source Orchestrator server.
- Set the
PATHenvironment variable by pointing it to the bin folder of the Java JRE installed with Orchestrator.
- Upload the migration tool to the Windows server, on which the external Orchestrator is installed.
- Unzip the downloaded archive and place the folder in the Orchestrator install folder.
The default path to the Orchestrator install folder in a Windows-based installation is C:\Program Files\VMware\Orchestrator.
- Run the Windows command prompt as administrator and navigate to the bin folder in the Orchestrator install folder.
By default, the path to the bin folder is C:\Program Files\VMware\Orchestrator\migration-cli\bin.
- Run the export command from the command line.
C:\Program Files\VMware\Orchestrator\migration-cli\bin\vro-migrate.bat export
This command combines the VMware vRealize Orchestrator configuration files and plug-ins into an export archive.
The archive is created in the same folder as the migration-cli folder.
- Set the
- Migrate the exported configuration to the Orchestrator server that is built into vRealize Automation 7.2.
- Upload the exported configuration file to the /usr/lib/vco/tools/configuration-cli/bin directory on the vRealize Automation Appliance.
- Under the /usr/lib/vco/tools/configuration-cli/bin directory, change the ownership of the exported Orchestrator configuration file.
chown vco:vco orchestrator-config-export-orchestrator_ip_address-date_hour.zip
- Import the Orchestrator configuration file to the built-in vRealize Orchestrator server, by running the vro-configure script with the import command.
./vro-configure.sh import --skipDatabaseSettings --skipLicense --skipSettings --skipSslCertificate --notForceImportPlugins --notRemoveMissingPlugins --skipTrustStore --path orchestrator-config-export-orchestrator_appliance_ip-date_hour.zip
- Migrate the database to the internal PostgreSQL database, by running the vro-configure script with the db-migrate command.
./vro-configure.sh db-migrate --sourceJdbcUrl JDBC_connection_URL --sourceDbUsername database_user --sourceDbPassword database_user_passwordNote:
Enclose passwords that contain special characters in quotation marks.
The JDBC_connection_URL depends on the type of database that you use.
You have successfully migrated an external vRealize Orchestrator 6.x installed on Windows to a vRealize Orchestrator instance embedded in vRealize Automation 7.2.
What to do next
Set up the built-in vRealize Orchestrator server. See Configure the Built-In vRealize Orchestrator Server.