You can upgrade the vCloud Director appliance from version 9.7 to version 10.0 or upgrade vCloud Director 10.0 to a patch release.

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

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

Prerequisites

Take a snapshot of the primary vCloud Director appliance.
  1. Log in to the vCenter Server instance on which resides the primary vCloud Director appliance of your database high availability cluster.
  2. Navigate to the primary vCloud Director appliance, right-click it, and click Power > Shut Down Guest OS.
  3. Right-click the appliance and click Snapshots > Take Snapshot. Enter a name and, optionally, a description for the snapshot, and click OK.
  4. Right-click the vCloud Director appliance and click Power > Power On.
  5. Verify that all nodes in your database high availability configuration are in a good state. See Check the Status of a Database High Availability Cluster.
  6. Review the Database Upgrade Utility Reference topic.

Procedure

  1. In a Web browser, log in to the appliance management user interface of a vCloud 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. Download the update package to an appliance.
    vCloud Director is distributed as an executable file with a name of the form VMware_vCloud_Director_v.v.v.v- nnnnnnnn_update. tar.gz, where v. v. v. v represents the product version and nnnnnnnn the build number. For example, VMware_vCloud_Director_10.0.0.4424-14420378_update.tar.gz.
  3. Create the local-update-package directory in which to extract the update package.
    mkdir /tmp/local-update-package
  4. Extract the update package in the newly created directory.
     tar -zxf VMware_vCloud_Director_v.v.v.v-nnnnnnnn_update.tar.gz \
    				-C /tmp/local-update-package
  5. Set the local-update-package directory as the update repository.
    vamicli	update --repo file:///tmp/local-update-package
  6. Check for updates to verify that you established correctly the repository.
    vamicli update --check
    The upgrade release appears as an Available Update.
  7. Shut down vCloud Director by running the following command:
    /opt/vmware/vcloud-director/bin/cell-management-tool -u <admin username> cell --shutdown
  8. Apply the available upgrade.
    vamicli update --install latest
  9. Repeat Step 2 to Step 8 on each appliance.
  10. From the primary appliance, back up the vCloud Director appliance embedded database.
    /opt/vmware/appliance/bin/create-db-backup
  11. From any appliance, run the vCloud Director database upgrade utility.
    /opt/vmware/vcloud-director/bin/upgrade
  12. Reboot each vCloud Director appliance.
    shutdown -r now

What to do next