You can use the VMware Update Repository to upgrade the VMware Cloud Director appliance from version 9.7 to version 10.0 and later or apply patches.

Note: You can use the VMware Update Repository only to upgrade VMware Cloud Director to the most recent VMware Cloud Director version. Only the most recent version is available in the VMware Update Repository. If you want to upgrade VMware Cloud Director to a different version, see Upgrade the VMware Cloud Director Appliance by Using an Update Package.

During the upgrade of the VMware Cloud Director appliance deployment, the VMware Cloud Director service stops working and some downtime can be expected. The downtime depends on the time you need to upgrade each VMware Cloud Director appliance and to run the VMware Cloud Director database upgrade script. The number of working cells in the VMware Cloud Director server group reduces until you stop the VMware Cloud Director service on the last VMware Cloud Director appliance. A properly configured load balancer in front of the VMware Cloud Director HTTP endpoints should stop routing traffic to the cells that are stopped.

After you apply the upgrade to every VMware Cloud Director appliance and the database upgrade is complete, you must reboot each VMware Cloud Director appliance.

Prerequisites

  • Take a snapshot of the primary VMware Cloud Director appliance.
    1. When upgrading from version 10.1 or later or when patching, if the automatic failover in case of a primary database service failure is enabled, change the failover mode to Manual for the duration of the upgrade. After the upgrade, you can set the failover mode to Automatic. See Automatic Failover of the VMware Cloud Director Appliance.
    2. Log in to the vCenter Server instance on which resides the primary VMware Cloud Director appliance of your database high availability cluster.
    3. Navigate to the primary VMware Cloud Director appliance, right-click it, and click Power > Shut Down Guest OS.
    4. Right-click the appliance and click Snapshots > Take Snapshot. Enter a name and, optionally, a description for the snapshot, and click OK.
    5. Right-click the VMware Cloud Director appliance and click Power > Power On.
    6. Verify that all nodes in your database high availability configuration are in a good state. See View the VMware Cloud Director Appliance Cluster Health and Failover Mode.
  • Verify that the VMware Cloud Director appliance has access to https://vapp-updates.vmware.com.

Procedure

  1. In a Web browser, log in to the appliance management user interface of a VMware Cloud Director appliance instance to identify the primary appliance, https://appliance_ip_address:5480.
    Make a note of the primary appliance name. You must use the primary appliance when backing up the database.
  2. Reset the update repository to point to the VMware Update Repository.
    vamicli update --repo ""
  3. Check for updates to verify that the VMware Update Repository has the desired upgrade.
    By default the vamicli command points to the VMware Update Repository.
    vamicli update --check
    The upgrade release appears as an Available Update.
  4. Shut down VMware Cloud Director by running the following command:
    /opt/vmware/vcloud-director/bin/cell-management-tool -u <admin username> cell --shutdown
  5. Apply the available upgrade.
    vamicli update --install latest
  6. Repeat Step 3 to Step 5 on each appliance.
  7. From the primary appliance, back up the VMware Cloud Director appliance embedded database.
    /opt/vmware/appliance/bin/create-db-backup
  8. From any appliance, run the VMware Cloud Director database upgrade utility.
    /opt/vmware/vcloud-director/bin/upgrade
  9. Reboot each VMware Cloud Director appliance.
    shutdown -r now

What to do next

If there is a vamicli update --install latest command failure, see Installing the Latest Update of VMware Cloud Director Fails.