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 upgrade the database only once. After the database has been upgraded, vCloud Director servers cannot connect to it until they, too, have been upgraded.

Important

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

Verify that no vCloud Director servers are using the database. 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 is registered to this installation of vCloud Director, it displays this 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 to vShield Manager version 5.0 or later versions.

See Upgrade vShield Manager.

2

Respond to the database upgrade prompt.

Welcome to the vCloud Director upgrade utility

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]: y

Option

Action

Continue the upgrade.

Type y.

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

Type n.

The database upgrade tool runs and displays progress messages.


Examining database at URL: jdbc:oracle:thin:@10.26.50.54:1521/orcl
Applying 1 upgrade batches
Executing upgrade batch:
Executing SQL statements from file: cc-tool-uninstall-graceful.sql
......................................
Executing SQL statements from file: Upgrade.sql []
......................................
Executing SQL statements from file: Upgrade_Data.sql []
......................................
Executing SQL statements from file: NewInstall_Indexes.sql []
......................................
Executing SQL statements from file: Upgrade_UUID.sql []
......................................
Executing SQL statements from file: NewInstall_Funcs.sql []
......................................

Successfully applied upgrade batch:
Running 2 upgrade tasks
Successfully ran upgrade task
Successfully ran upgrade task
Applying 1 upgrade batches
Executing upgrade batch: cleanup
Executing SQL statements from file: NewInstall_Funcs.sql []
......................................
Executing SQL statements from file: Upgrade_UUID_Clean.sql []
......................................
Executing SQL statements from file: Upgrade_Clean.sql []
......................................

Successfully applied upgrade batch: cleanup
Database upgrade complete
++++++++++++++++++++++++++++++++
3

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

These steps are optional and 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 has been 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).