To upgrade vCloud Director to a new version, you shut down the vCloud Director services on all cells in the server group, install the new version on each server, upgrade the vCloud Director database, and restart the vCloud Director cells.
If your existing vCloud Director server group consists of vCloud Director installations on Linux, you can use the vCloud Director installer for Linux to upgrade your environment. As an alternative, you can migrate your environment to vCloud Director 9.7 appliance. See Migrating to vCloud Director Appliance.
If your existing vCloud Director server group consists of vCloud Director 9.5 appliance deployments, you can only migrate your environment to vCloud Director 9.7 appliance. You use the vCloud Director installer for Linux to upgrade the existing environment only as part of the migration workflow. See Migrating to vCloud Director Appliance.
You can either Perform an Orchestrated Upgrade of a vCloud Director Installation or Manually Upgrade a vCloud Director Installation. With the orchestrated upgrade, you run a single command which upgrades all cells in the server group and the database. With the manual upgrade, you upgrade each cell and the database in a sequence.
- Oracle databases are unsupported. If your existing vCloud Director installation uses an Oracle database, see the Workflow for Upgrading a vCloud Director Installation with an Oracle Database.
- Enabling and disabling ESXi hosts is unsupported. Before starting the upgrade, you must enable all ESXi hosts. You can put ESXi hosts in maintenance mode by using the vSphere Web Client.
- vCloud Director uses Java with an improved LDAP support. If you are using an LDAPS server, to avoid LDAP login failures, you must verify that you have a properly constructed certificate. For information, see the Java 8 Release Changes at https://www.java.com.
- The database software you are currently using for the vCloud Director database.
If your existing vCloud Director installation uses an Oracle database, see the Workflow for Upgrading a vCloud Director Installation with an Oracle Database.
- The VMware vSphere ® release you are currently using.
- The VMware NSX® release that you are currently using.
For information about upgrade paths and compatibility of vCloud Director with other VMware products and with third-party databases, refer to the VMware Product Interoperability Matrices at http://partnerweb.vmware.com/comp_guide/sim/interop_matrix.php. If you plan to upgrade vSphere or NSX components as part of the vCloud Director upgrade, you must upgrade them After you Upgrade or Migrate vCloud Director.
After you upgrade at least one vCloud Director server, you can upgrade the 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 verify that no tasks are active on any 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 support are copied to the new installation.
The upgrade requires sufficient vCloud Director downtime to upgrade all servers in the server group and the database. If you are using a load balancer, you can configure it to a return a message, for example, The system is offline for upgrade.
Workflow for Upgrading a vCloud Director Installation with an Oracle Database
Before upgrading a vCloud Director installation that uses an Oracle database, you must migrate the database to PostgreSQL from vCloud Director version 9.1.
- If your current vCloud Director version is earlier than 9.1, upgrade to version 9.1.
For information about upgrading vCloud Director to version 9.1, see the vCloud Director Installation, Configuration, and Upgrade Guide 9.1.
- When your vCloud Director installation is of version 9.1, migrate the Oracle database to a PostreSQL database.
For information about migrating to a PostgreSQL database, see the cell management tool reference in the vCloud Director Administrator's Guide documentation.
- Upgrade your vCloud Director installation from version 9.1. You can either Perform an Orchestrated Upgrade of a vCloud Director Installation or Manually Upgrade a vCloud Director Installation.