You can configure Orchestrator to download the upgrade package from the default VMware repository.


  • Unmount all network file systems. For more information, see the vSphere Virtual Machine Administration documentation.

  • Increase the memory of the Orchestrator Appliance to at least 6 GB. For more information, see the vSphere Virtual Machine Administration documentation.

  • Make sure that the root partition of the Orchestrator Appliance has at least 3 GB of available free space. For more information on increasing the size of a disk partition, see KB 1004071:

  • Take a snapshot of the Orchestrator virtual machine. For more information, see the vSphere Virtual Machine Administration documentation.

  • If you use an external database, back up the database.

  • If you use the preconfigured in Orchestrator PostgreSQL database, back up the database by using the Export Database menu in Control Center.

  • If you use vSphere as an authentication provider an the Platform Services Controller is external to the vCenter Server, you must configure Orchestrator to connect to the fully qualified domain name or IP address of the Platform Services Controller instance that contains the vCenter Single Sign-On.

  • Import to Orchestrator manually the certificates of all Platform Services Controllers that share the same vCenter Single Sign-On domain. For more information, see Import a Trusted Certificate Through Control Center.


  1. Go to the Virtual Appliance Management Interface (VAMI) at https://orchestrator_server:5480 and log in as root.
  2. On the Update tab, click Settings.

    The radio button next to the Use Default Repository option is selected.

  3. On the Status page, click Check Updates.
  4. If any updates are available, click Install Updates.
  5. Accept the VMware End-User License Agreement and confirm that you want to install the update.
  6. To complete the update, restart the Orchestrator Appliance.
    1. Log in again to the to the Virtual Appliance Management Interface (VAMI) as root.
  7. (Optional) On the Update tab, verify that the latest version of the Orchestrator Appliance is successfully installed.
  8. Log in to Control Center as root.
  9. If you plan to create a cluster of Orchestrator instances, reconfigure the hosts settings.
    1. On the Host Settings page in Control Center, click CHANGE.
    2. Enter the host name of the load balancer server instead of the vRealize Orchestrator appliance name.
  10. Reconfigure the authentication.
    1. If before the upgrade, the Orchestrator server was configured to use LDAP or SSO (legacy) as an authentication method, configure vSphere or vRealize Automation as an authentication provider.
    2. If the authentication is already set to vSphere or vRealize Automation, unregister the settings and register them again.


You successfully upgraded the Orchestrator Appliance.

What to do next

Verify that Orchestrator is configured properly at the Validate Configuration page in Control Center.