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.

About this task

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.

Prerequisites

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

Procedure

  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.
    1. 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.

    2. (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

Results

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  ]