5.1

Displaying the Maintenance Message During an Upgrade
If you anticipate a lengthy upgrade process and want to have the system display a maintenance message while
the upgrade is underway, verify that at least one cell remains accessible while the others are being upgraded.
Run the /opt/vmware/vcloud-director/bin/vmware-vcd-cell command on that cell to turn on the cell
maintenance message.
[root@cell1 /opt/vmware/vcloud-director/bin]# ./vmware-vcd-cell maintenance
You can run this command on a cell before or after it has been upgraded. When you are ready to upgrade the
cell or return an upgraded cell to service, run the following command on the cell to turn off the maintenance
message.
[root@cell1 /opt/vmware/vcloud-director/bin]# ./vmware-vcd-cell stop
This chapter includes the following topics:
n
“Use the Cell Management Tool to Quiesce and Shut Down a Server,” on page 35
n
“Upgrade vCloud Director Software on Any Member of a Server Group,” on page 42
n
“Upgrade the vCloud Director Database,” on page 44
n
“Upgrade vShield Manager,” on page 46
n
“Upgrade vCenter, ESX/ESXi Hosts, and vShield Edge Appliances,” on page 47
n
“Changes to Upgraded Networks,” on page 48
Use the Cell Management Tool to Quiesce and Shut Down a Server
Before you upgrade a vCloud Director server, use the cell management tool to quiesce and shut down
vCloud Director services on the server's cell.
vCloud Director creates a task object to track and manage each asynchronous operation that a user requests.
Information about all running and recently completed tasks is stored in the vCloud Director database. Because
a database upgrade invalidates this task information, you must be sure that no tasks are running when you
begin the upgrade process.
With the cell management tool, you can suspend the task scheduler so that new tasks cannot be started, then
check the status of all active tasks. You can wait for running tasks to finish or log in to vCloud Director as a
system administrator and cancel them. See “Cell Management Tool Reference,” on page 36. When no tasks
are running, you can use the cell management tool to stop vCloud Director services.
Prerequisites
n
Verify that you have superuser credentials for the target server.
n
Verify that you have vCloud Director system administrator credentials.
Procedure
1 Log in to the target server as root.
Chapter 3 Upgrading vCloud Director
VMware, Inc. 35