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

Verify that you have a valid license key to use the version of 
the vCloud Director software to which you are upgrading.

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

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).
Starting vmware-vcd-watchdog:                              [  OK  ]
Starting vmware-vcd-cell                                   [  OK  ]