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

The migration transfers a clustered vRealize Orchestrator 7.x configuration to your Automation Orchestrator 8.x environment. The migration involves overwriting all existing elements in your Automation 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


  • Migration is supported for embedded vRealize Orchestrator 7.3 or later.
  • Configure a Automation Orchestrator cluster in your target VMware Aria Automation 8.x environment. See Configure a vRealize Orchestrator Cluster in Installing and Configuring VMware vRealize Orchestrator.
  • Back up the target VMware Aria Automation environment.
  • Verify that SSH access is enabled on the source vRealize Automation instance and target VMware Aria Automation environment.
  • Verify that the source vRealize Automation database is accessible from the target VMware Aria Automation environment.


  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 Automation 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 Automation 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.


You have migrated your clustered vRealize Orchestrator deployment.