You can migrate your cluster of vRealize Orchestrator 6.x instances installed on Windows to a cluster of vRealize Orchestrator Virtual Appliances version 7.1 or 7.2.

Prerequisites

  • Stop the Orchestrator server service of the Orchestrator 6.x instances in the cluster.

  • Back up the database, including the database schema, of the external Orchestrator server.

  • Deploy an Orchestrator node on the target version. For more information, see Download and Deploy the Orchestrator Appliance.

Procedure

  1. Download the migration tool from the target Orchestrator server.
    1. Log in to Control Center as root.
    2. Open the Export/Import Configuration page and click the Migrate Configuration tab.
    3. Download the migration tool as specified in the description, or download it directly from https://orchestrator_server_IP_or_DNS_name:8283/vco-controlcenter/api/server/migration-tool.
  2. Export the Orchestrator configuration from one of the source Orchestrator server nodes.
    1. Set the PATH environment variable by pointing it to the bin folder of the Java JRE installed with Orchestrator.
    2. Upload the migration tool to the Windows server, on which the source Orchestrator is installed.
    3. 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.

    4. Run the Windows command prompt as administrator and navigate to the bin folder under the Orchestrator install folder.

      By default, the path to the bin folder is C:\Program Files\VMware\Orchestrator\migration-cli\bin.

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

  3. Import the configuration to the target Orchestrator server.
    1. Open Export/Import Configuration in Control Center and click the Migrate Configuration tab.
    2. Browse to the exported configuration file and click Import.
    3. Select the type of files that you want to import.

      Option

      Description

      Migrate database settings

      Uses the database of the vRealize Orchestrator 6.x cluster.

      Migrate plug-ins

      Migrates all plug-ins that are not included in the Orchestrator platform.

      Migrate legacy plug-in configurations

      Migrates the configuration of plug-ins that is stored in the Orchestrator_install_folder\app-server\conf\plugins folder.

      Migrate trusted certificates

      Migrates all certificates from the trust store of the vRealize Orchestrator 6.x cluster.

    4. Click Finish Migration.

      A message indicates that the migration completed successfully.

  4. Reconfigure the Orchestrator cluster.
    1. Open the advanced Orchestrator Cluster Management page, at https://your_orchestrator_server_IP_or_DNS_name:8283/vco-controlcenter/#/control-app/ha?remove-nodes.
    2. Select the check boxes next to the Orchestrator 6.x nodes and click Remove.
    3. Verify that Orchestrator is configured properly at the Validate Configuration page in Control Center.

      You can ignore the Orchestrator cluster is in inconsistent state warning, which disappears when you start the Orchestrator server service.

    4. If a licensing error appears, configure an appropriate licensing provider on the Licensing page in Control Center.
  5. From the Startup Options page in Control Center, start the Orchestrator server service of the target Orchestrator server.
    1. On the Startup Options page, make sure that the Active Configuration Fingerprint string and the Pending Configuration Fingerprint string match.
      Note:

      You might need to refresh the Startup Options page several times until the two strings match.

Results

You have successfully migrated a vRealize Orchestrator 6.x cluster to a cluster of Orchestrator Virtual Appliances on version 7.1 or 7.2.

What to do next

  • Log in to the Orchestrator client and verify whether the configurations of all installed plug-ins are correct.

  • Add more nodes to the target Orchestrator cluster. For more information, see Configure an Orchestrator Cluster.