Table of Contents


Our configuration at the start of this process is Cloud Director 10.1 installed and successfully running on the VMware appliance with embedded postgres DB. By the end of this process we will be running Cloud Director on the same VM just upgraded version. It’s highly advise a clone is created prior to any work being performed as this is a highly complex process. If you run multiple cells then we suggest you remove all additional cells and perform this work on a single cell, then simply deploy new cells once the primary is successfully working. This method assumes isolation from direct access to download updates, due to this the article is written around creating ISOs, mounting CDs, etc. More information about Cloud Director 10.2.2 can be found in the release notes.

Interoperability Matrix

Our Versions: vCenter 6.7 U3, Cloud Director 10.1.1, NSX 6.4.10, vROPs 8.5, ESXi 6.5/6.7 U3 Look up your information on the VMware Product Interoperability Matrix

Create an original restore point.

  1. Create a clone of the Cloud Director VM.
  2. Create a snapshot of the Cloud Director VM.

Upgrade Cloud Director from 10.1.1 to 10.2.2

  1. Download Cloud Director gz file “VMware Cloud Director 10.2.2 - Virtual Appliance update package” from VMware. This file will be in the following naming convention: VMware_Cloud_Director_vv.v.v.vvvv-nnnnnnnn_update.tar.gz
  2. After downloading the update package create an iso out of the file, we recommend folder2iso, and mount it as a CDROM.
  3. If you have multiple cells then use your favorite browser log into your VAMI interface at https://appliance_ip_address:5480 to determine which cell is the current primary, you need to use the primary appliance when you do the database backup/upgrade later in this process. While we do not run multiple cells the best procedure we have found would be to remove all additional nodes except the primary and upgrade the primary node. Then re-install all additional nodes from a fresh ISO.
  4. After downloading the update package and create an iso out of the file and mount it as a CDROM.
  5. Log into the appliance via SSH and insure the directory /mnt/cdrom exists, if not create it by running: mkdir /mnt/cdrom
  6. Mount the CDROM.
    mount /dev/cdrom /mnt/cdrom
  7. Create a new director to hold the update content.
    mkdir /tmp/local-update-package
  8. Extract the package in the newly created directory.
    tar -zxf /mnt/cdrom/VMware_Cloud_Director_10.1.1.4916-16288798_update.tar.gz  -C /tmp/local-update-package
  9. We now need to configure the update repository to use this directory.
    vamicli	update --repo file:///tmp/local-update-package
  10. Test to ensure the update directory is being read correctly. If it is then you should be presented with the release version.
    vamicli update --check
  11. Check the cell status to ensure no jobs are running.
    /opt/vmware/vcloud-director/bin/cell-management-tool -u administrator cell –status
  12. Quiesce the cell to prevent new jobs from running and complete existing jobs.
    /opt/vmware/vcloud-director/bin/cell-management-tool -u administrator cell -q true
  13. Shutdown vCloud Director management cell.
    /opt/vmware/vcloud-director/bin/cell-management-tool -u administrator cell –status
    /opt/vmware/vcloud-director/bin/cell-management-tool -u administrator cell –shutdown

    NOTE: If there are queued jobs then you can override the wait by running: service vmware-vcd stop

  14. Apply the upgrade to the cell.
    vamicli update --install latest
  15. On the primary appliance we noted above run the DB backup process.
  16. Now lets upgrade the Cloud Director database utility.
  17. When prompted with “Do you wish to upgrade the product now? [Y/N]” enter Y
  18. When prompted with “Enter [Y] after the backup is complete.” enter Y
  19. When prompted with “Start it now? [y/n]” enter N
  20. Reboot the Cloud Director appliance.
    shutdown -r now
  21. Once the appliance is done rebooting log into your web interface and ensure everything is working as expected. NOTE If you run into a problem not being able to access /provider URL then you might have to ensure the URL you are supplying the browser is allowed. Cloud Director 10 is explicit in the URLs that it will accept as source. You can look at this article here if you need to modify your URLs called Troubleshoot Failed Access to the vCloud Director User Interface.

Cloud Director 10.2.2

Backout/Rollback Plan

  1. Power off the original appliance and then proceed to next step.
  2. Revert to the snapshot created at the beginning of this process. Confirm the snapshot allowed the configuration to come back online, if it does not then proceed to next step.
  3. Restore the clone that was created at the beginning of this process. Confirm the clone allowed the configuration to come back online, if it does not then proceed to next step.
  4. Build a new Cloud Director appliance VM and restore the database backup that was created towards the end of the process. Confirm the backup allowed the configuration to come back online.