You can configure Orchestrator to use a local repository, on which you uploaded the upgrade archive.


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

  • Increase the vRealize Orchestrator virtual machine disk size: Disk1=7 GB, Disk2=10 GB.

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

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


  1. Prepare the local repository for upgrades.
    1. Install and configure a local Web server.
    2. Download the archive from the official VMware download site.
    3. Extract the .ZIP archive to the local repository.
  2. Go to the Virtual Appliance Management Interface (VAMI) at https://orchestrator_server:5480 and log in as root.
  3. On the Update tab, click Settings.
  4. Select the radio button next to the Use Specified Repository option.
  5. Enter the URL address of the local repository by pointing to the Update_Repo directory.


  6. If the local repository requires authentication, enter user name and password.
  7. Click Save Settings.
  8. On the Status page, click Check Updates.
  9. If any updates are available, click Install Updates.
  10. Accept the VMware End-User License Agreement and confirm that you want to install the update.
  11. To complete the update, restart the Orchestrator Appliance.
    1. Log in again to the to the Virtual Appliance Management Interface (VAMI) as root.
  12. (Optional) On the Update tab, verify that the latest version of the Orchestrator Appliance is successfully installed.
  13. Log in to Control Center as root.
  14. 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.
  15. 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.

    If before the upgrade, your Orchestrator used vSphere as an authentication provider and was configured to connect to the vCenter Server fully qualified domain name or IP address, in case you have an external Platform Services Controller, after the upgrade 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. You must also import to Orchestrator manually the certificates of all Platform Services Controllers that share the same vCenter Single Sign-On domain.


You successfully upgraded the Orchestrator Appliance.

What to do next

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