After you upgrade a server in your vCloud Director server group, you must upgrade the group's vCloud Director database before you restart vCloud Director services on the server.

All servers in a vCloud Director server group share the same database, so regardless of how many servers you are upgrading, you need to upgrade the database only once. After the database is upgraded, vCloud Director servers cannot connect to it until they, too, are upgraded.

Important

Back up your existing database before you upgrade it. Use the procedures that your database software vendor recommends.

Verify that all vCloud Director cells are inactive. See Use the Cell Management Tool to Quiesce and Shut Down a Server

1

Open a console, shell, or terminal window, and type the following command to run the database upgrade script.

/opt/vmware/vcloud-director/bin/upgrade
Important

If the database upgrade script detects that an incompatible version of vShield Manager or NSX Manager is registered to this installation of vCloud Director, it displays a warning message and cancels the upgrade.

One or more vShield Manager servers registered to this vCloud 
Director installation are not supported by the version of vCloud Director
you are upgrading to. Upgrade canceled, please follow the procedures in
the vShield Manager Upgrade Guide to upgrade those unsupported vShield 
Manager servers.
2

Respond to the database upgrade prompts.

a

Confirm that you want to continue with the database upgrade.

Welcome to the vCloud Director upgrade utility

This product is intended for use only by service providers under the
terms and conditions of the VMware Service Provider Partner (VSPP)
Program. If you are a member of the VSPP Program, please locate your
license key before proceeding. If you are not a member of this program,
do not proceed with this upgrade. Upgrading without a proper key will
invalidate your support contract.

This utility will apply several updates to the database. Please
ensure you have created a backup of your database prior to continuing.

Do you wish to upgrade the product now? [Y/N]:

Take one of the following actions:

Option

Action

Continue the upgrade.

Type y.

Exit to the shell without making any changes in the current vCloud Director database.

Type n.

b

(Optional) Wait for cells to become inactive, if necessary.

If the database upgrade tool detects that any cells are still active, it prompts you to continue with the upgrade or exit.

Found active cell. Name: "cell-01", IP Address: 10.150.151.190, Identifier: a2eb...
Do you wish to upgrade the database while cells are still active? [Y/N]

If you see this prompt, type n to exit to the shell, then wait five minutes and restart the database upgrade tool. If the database upgrade tool continues to warn you about cells that are still active, return to the procedure in Use the Cell Management Tool to Quiesce and Shut Down a Server and ensure that all cells have become inactive.

After you have responded to all prompts, the database upgrade tool runs and displays progress messages.

Executing upgrade task: Start UpdateStatementManager
...[3]
Successfully ran upgrade task
Executing upgrade task: ...
.......... Successfully ran upgrade task
...
Executing upgrade task: Stop UpdateStatementManager
...[3]
...
Successfully ran upgrade task
3

(Optional) Rebuild the database indexes and update the database statistics.

These procedures can lead to better database performance after the upgrade.

Do you wish to rebuild the database indexes? This may take several minutes. [Y/N] y
Rebuilding database indexes

...
Do you wish to update the database statistics? This may take several minutes. [Y/N] y
Updating database statistics
...

After the database is upgraded, the upgrade script offers to start vCloud Director services on this host.


Would you like to start the vCloud Director service now? If you choose not
to start it now, you can manually start it at any time using this command:
    service vmware-vcd start
Start it now? [y/n]:y
Starting the vCloud Director service (this may take a moment).