Migrate a Standalone vRealize Orchestrator 7.x to an External vRealize Orchestrator 8.0

You can migrate an external standalone vRealize Orchestrator 7.x instance to a vRealize Orchestrator 8.0 environment. Migration is supported only for vRealize Orchestrator 7.x instances authenticated with vSphere.

Important: Upgrading vRealize Orchestrator 7.x or earlier to vRealize Orchestrator 8.0 is not supported.

The migration transfers an external standalone vRealize Orchestrator 7.x configuration to your vRealize Orchestrator 8.0 environment. The migration involves overwriting all existing elements in your vRealize Orchestrator 8.0 environment, such as workflows, actions, configuration and resource elements, packages, tasks, policies, certificates, plug-ins, and so on.

Note: Migration of clustered vRealize Orchestrator 7.x deployments to vRealize Orchestrator 8.0 is not supported. You can migrate the primary node of your clustered deployment by stopping the services of the replica nodes before you run the migration script.

service vco-server stop
service vco-configurator stop

In vRealize Orchestrator 8.0, you perform the migration by using the vro-migrate script bundled with the vRealize Orchestrator Appliance.

Note: The migration script stops the vRealize Orchestrator services automatically.

Prerequisites

• Migration is supported for vRealize Orchestrator 7.3 or later.
• Download and deploy a vRealize Orchestrator 8.0 environment. See Download and Deploy the vRealize Orchestrator Appliance.
• Configure the authentication provider of your target vRealize Orchestrator environment. The authentication provider of the source vRealize Orchestrator instance is not migrated. See Configuring a Standalone vRealize Orchestrator Server.
• Back up the target vRealize Orchestrator environment.
• Verify that SSH access is enabled on the source vRealize Orchestrator instance and target vRealize Orchestrator environment. See Enable or Disable SSH Access to the vRealize Orchestrator Appliance.
• Verify that the source vRealize Orchestrator database is accessible from the target vRealize Orchestrator environment.

Procedure

1. Log in to the vRealize Orchestrator Appliance command line of your target environment over SSH as root.
2. To start the migration, run the vro-migrate script.
3. Follow the command prompts to provide the fully qualified domain name (FQDN) and credentials of the source vRealize Orchestrator instance.
4. (Optional) To follow the migration progress, access the migration log:
   1. Log in to your target vRealize Orchestrator Appliance command line over a separate SSH session as root.
   2. Run the tail -f /var/log/vro-migration.log command.
5. (Optional) If you want to access your source vRealize Orchestrator 7.x environment after migration, restart the vco-server and vco-configurator services on the source system.

Results

The migration process begins. You receive a notification on the target vRealize Orchestrator Appliance when the migration finishes.