To upgrade vCloud Director to a new version, install the new version on each server in the vCloud Director server group, upgrade the vCloud Director database, and restart vCloud Director services.

Important:

This upgrade procedure assumes that you are upgrading a vCloud Director installation that includes releases of VMware vSphere ® and VMware NSX ™ that are also compatible with vCloud Director 8.10. Before you begin this procedure, refer to the VMware Product Interoperability Matrixes at http://partnerweb.vmware.com/comp_guide/sim/interop_matrix.php for information about the versions of other VMware products that are compatible with the version of vCloud Director that you are currently running and also with vCloud Director 8.10. If you plan to upgrade your installation's vSphere or NSX components as part of the upgrade to vCloud Director 8.10., it is important to upgrade those components in the order and using the procedures documented here.

After you upgrade a vCloud Director server, you must also upgrade its vCloud Director database. The database stores information about the runtime state of the server, including the state of all vCloud Director tasks it is running. To ensure that no invalid task information remains in the database after an upgrade, you must ensure that no tasks are active on the server before you begin the upgrade.

The upgrade also preserves the following artifacts, which are not stored in the vCloud Director database:

  • Local and global properties files are copied to the new installation.
  • Microsoft sysprep files used for guest customization are copied to the new installation.

Unless you use a load balancer to distribute client requests across members of your vCloud Director server group (see Using a Load Balancer to Reduce Service Downtime), the upgrade requires sufficient vCloud Director downtime to upgrade the database and at least one server.

Upgrading a vCloud Director Server Group

  1. Disable user access to vCloud Director. You can also display a maintenance message while the upgrade is underway. See Displaying the Maintenance Message During an Upgrade.
  2. Use the cell management tool to quiesce all cells in the server group and shut down vCloud Director services on each server. See the Cell Management Tool Reference in the vCloud Director Administrator's Guide.
  3. Upgrade vCloud Director software on all members of the server group. See Upgrade vCloud Director Software on Any Member of a Server Group. You can upgrade the servers individually or in parallel, but you must not restart vCloud Director services on any upgraded member of the group before you upgrade the vCloud Director database.
  4. Upgrade the vCloud Director database. See Upgrade the vCloud Director Database.
  5. Restart vCloud Director on the upgraded servers. See Start or Stop vCloud Director Services.
  6. Enable user access to vCloud Director.
  7. (Optional) Upgrade each associated NSX Manager. See Upgrade Each NSX Manager That Is Associated with an Attached vCenter Server System.
  8. (Optional) Upgrade each associated vCenter Server system and its ESXi hosts. See Upgrade vCenter Server Systems, Hosts, and NSX Edges.
Note: After completing the upgrade, if you have the vCloud Director Web Console open in a browser, log out and clear your browser cache before logging back in to the Web Console.

Using a Load Balancer to Reduce Service Downtime

If you are using a load balancer or other tool that can force requests to go to specific servers, you can upgrade a subset of the server group while keeping existing services available on the remaining subset. This approach reduces vCloud Director service downtime to the length of time required to upgrade the vCloud Director database. Users might experience some degradation of performance during the upgrade, but in-progress tasks continue to run as long as any subset of the server group is operational. Console sessions might be interrupted, but you can restart them.

  1. Use the load balancer to redirect vCloud Director requests to a subset of the servers in the group. Follow the procedures recommended by your load balancer.
  2. Use the cell management tool to quiesce the cells that are no longer handling requests and shut down vCloud Director services on those servers.
    Note: Console sessions routed through a server's console proxy are interrupted when the server shuts down. Clients can refresh the console window to recover.
    See the Cell Management Tool Reference in the vCloud Director Administrator's Guide.
  3. Upgrade vCloud Director software on the members of the server group on which you have stopped vCloud Director, but do not restart those services. See Upgrade vCloud Director Software on Any Member of a Server Group.
  4. Use the cell management tool to quiesce the cells that you have not yet upgraded and shut down vCloud Director services on those servers.
  5. Upgrade the vCloud Director database. See Upgrade the vCloud Director Database.
  6. Restart vCloud Director on the upgraded servers. See Start or Stop vCloud Director Services.
  7. (Optional) Upgrade each associated NSX Manager. See Upgrade Each NSX Manager That Is Associated with an Attached vCenter Server System.
  8. (Optional) Upgrade each associated vCenter Server system and its ESXi hosts. See Upgrade vCenter Server Systems, Hosts, and NSX Edges.
  9. Use the load balancer to redirect vCloud Director requests to the upgraded servers.
  10. Upgrade vCloud Director software on the remaining servers in the group, and restart vCloud Director on those servers as the upgrades complete. See Upgrade vCloud Director Software on Any Member of a Server Group.

Displaying the Maintenance Message During an Upgrade

If you anticipate a lengthy upgrade process and want to have the system display a maintenance message while the upgrade is underway, verify that at least one cell remains accessible while the others are being upgraded. Run the /opt/vmware/vcloud-director/bin/vmware-vcd-cell command on that cell to turn on the cell maintenance message.
[root@cell1 /opt/vmware/vcloud-director/bin]# ./vmware-vcd-cell maintenance

When you are ready to return an upgraded cell to service, run the following command on the cell to turn off the maintenance message.

[root@cell1 /opt/vmware/vcloud-director/bin]# service vmware-vcd restart