Follow the upgrade path and choose an upgrade method for the currently installed VMware Cloud Director Availability version. After following the prerequisites, choose a source repository for the upgrade files then perform the upgrade.

Note:
  • vSphere DR and migration between vCenter Server sites requires upgraded versions in both sites
    Upgrade both sites to version 4.5, then the tenant site must re-pair with the provider site. For example:
    VMware Cloud Director Availability 4.4 VMware Cloud Director Availability 4.5
    On-Premises to Cloud vCenter Replication Appliance 4.4 currently paired to vCenter Replication Management Appliance 4.4. On-Premises to Cloud vCenter Replication Appliance 4.5 re-paired to vCenter Replication Management Appliance 4.5.
    vCenter Replication Management Appliance 4.4 currently paired with vCenter Replication Management Appliance 4.4 vCenter Replication Management Appliance 4.5 paired with vCenter Replication Management Appliance 4.5

    After upgrading one of the sites, the existing replications continue to replicate and can be recovered in case of disaster, but the paired site must be upgraded before creating new replications or new pairing and before performing any administrative operations and other day 2 management tasks.

    Prerequisite for re-establishing tenant trust with the provider after upgrade for vSphere DR and migration
    After upgrading both sites to version 4.5, the tenant site must Re-pair with the provider site. For information about re-pairing from the tenant site, see step 3 in Repair sites.
  • Also for vSphere DR and migration, if using a single-sign-on administrator user with custom privileges in vSphere, you must add the StorageViews.View privilege. For information about the required vSphere privileges, see Users Roles Rights and Sessions in the Security Guide.

Upgrade Paths

For on-premises site upgrade to the latest version, use the following upgrade methods, according to the currently installed version.

Current Version Next Version Upgrade Method
4.3.x or 4.4.x 4.5
4.2.x or 4.3.x 4.4.x
4.0.x or 4.1.x 4.2.1*
3.0.x or 3.5.x 4.0
3.0 4.0 You must upgrade only by using the command-line interface, see the legacy Command-Line Upgrading On-Premises procedures.

* To upgrade to the latest version, when performing a two-step upgrade from 4.1.x or from 4.0.x, upgrade to version 4.2.1 as the intermediate upgrade. For more information, see the Upgrade Path of the On-Premises to Cloud Director Replication Appliance in the VMware Product Interoperability Matrix.

Important:
  • Before upgrading the On-Premises to Cloud Director Replication Appliance:
    • Ensure that you have not manually enabled the Photon repository of the appliance.

      To verify for enabled repositories, open an SSH connection to the appliance, log in by using the root user credentials and run the following command:

      yum -v repolist all | grep enabled
      When no repository is active, the command returns no result and you can proceed with the upgrade.
    • Ensure that you have not installed any packages or third-party software or made any manual modifications of yum configuration files.
  • To complete the upgrade sequence, see Post-Upgrade Configuration.
  • Attempting to upgrade from version 4.0.x directly to version 4.3 appears to proceed with the upgrade while performing no upgrade. The /var/log/upgrade.log file shows Direct upgrades from 4.0.x are not supported! Upgrade to latest from 4.2 code line first and then you'll be able to upgrade to later versions.

Upgrade Repository

To upgrade VMware Cloud Director Availability, you can configure the appliance to download the upgrade files from one of the following source repositories.

Repository Description
An ISO image Use an upgrade ISO file mounted in the virtual appliance CD-ROM drive for environments without an external Internet access.
A specified repository To upgrade multiple appliances or after deploying the appliances in different datastores, specify a repository as a content source:
  • You can specify a local repository where you can upload the upgrade files, for environments where the network restricts the online Internet access to the appliances.
  • Alternatively, with available Internet access, specify https://packages.vmware.com/vcav/4.5/ as an online upgrade repository.
Note: Cannot upgrade by selecting the option Official Online Repository for versions 4.0.x since Apr 2021. To upgrade by using the management interface, either select an ISO image or specify a repository.