You can migrate a clustered vRealize Orchestrator deployment that is embedded in a vRealize Automation 7.x environment to an embedded vRealize Orchestrator 8.x environment.

The migration transfers a clustered vRealize Orchestrator 7.x configuration to your vRealize Orchestrator 8.x environment. The migration involves overwriting all existing elements in your vRealize Orchestrator 8.x environment.

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 of the primary node automatically. Before you run the migration script, stop the services of the replica nodes of your clustered 7.x deployment.
service vco-server stop
service vco-configurator stop

Prerequisites

  • Migration is supported for embedded vRealize Orchestrator 7.3 or later.
  • Configure a vRealize Orchestrator cluster in your target vRealize Automation 8.x environment. See Configure a vRealize Orchestrator Cluster in Installing and Configuring VMware vRealize Orchestrator.
  • Back up the target vRealize Automation environment.
  • Verify that SSH access is enabled on the source vRealize Automation instance and target vRealize Automation environment.
  • Verify that the source vRealize Automation database is accessible from the target vRealize Automation 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.
    The migration process begins. You receive a notification on the target vRealize Orchestrator appliance when the migration finishes.
  5. (Optional) If you want to access your vRealize Orchestrator 7.x environment after migration, log in to the source vRealize Orchestrator appliance and restart the vco-server and vco-configurator services.

Results

You have migrated your clustered vRealize Orchestrator deployment.