You can update the vCloud Director appliance with patches that might be related to product functionality and security improvements.

During the patch 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 patch 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 patch to every vCloud Director appliance and the database upgrade is complete, you must restart the vCloud Director services across the server group to bring it online again.

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 name when upgrading 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_9.7.0.4248-13560441_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 patch 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. From the primary appliance, back up the vCloud Director appliance embedded database.
    Note: If you are upgrading from vCloud Director 9.7.0.1 to a later version, manually back up the truststore file located at /opt/vmware/vcloud-director/etc/truststore.
    /opt/vmware/appliance/bin/create-db-backup
  9. Apply the available patch.
    vamicli update --install latest
  10. Repeat Step 2 to Step 7 and Step 9 on each appliance.
  11. From any appliance, run the vCloud Director database upgrade script.
    /opt/vmware/vcloud-director/bin/upgrade
  12. Start the vCloud Director services on each appliance.
    service vmware-vcd start