5.5

2 Use the cell management tool to gracefully shut down the cell.
a Retrieve the current job status.
The following cell-management-tool command supplies system administrator credentials and
returns the count of running jobs.
[root@cell1 /opt/vmware/vcloud-
director/bin]# ./cell-management-tool -u administrator cell --status
Job count = 3
Is Active = true
b Stop the task scheduler to quiesce the cell.
Use a cell-management-tool command of the following form.
[root@cell1 /opt/vmware/vcloud-
director/bin]# ./cell-management-tool -u administrator cell --quiesce true
This command prevents new jobs from being started. Existing jobs continue to run until they finish
or are cancelled. To cancel a job, use the vCloud Director Web Console or the REST API.
c When the Job count value is 0 and the Is Active value is false, it is safe to shut down the cell.
Use a cell-management-tool command of the following form.
[root@cell1 /opt/vmware/vcloud-
director/bin]# ./cell-management-tool -u administrator cell --shutdown
NOTE You can supply the vCloud Director system administrator password on the cell-
management-tool command line, but it is more secure to omit the password. This causes the cell-
management-tool to prompt for the password, which it does not display on the screen as you type.
Console sessions routed through a server's console proxy are interrupted when the server shuts
down. If other members of the server group are still active, clients can refresh the console window
to recover.
What to do next
After the cell management tool stops vCloud Director services on this server, you can upgrade the server's
vCloud Director software or complete other maintenance that the server requires.
Upgrade vCloud Director Software on Any Member of a Server Group
The vCloud Director installer verifies that the target server meets all upgrade prerequisites and upgrades
the vCloud Director software on the server.
vCloud Director software is distributed as a Linux executable file named vmware-vcloud-director-5.5.0-
nnnnnn.bin, where nnnnnn represents a build number. After the upgrade is installed on a member of a
server group, you must run a tool that upgrades the vCloud Director database that the group uses before
you can restart vCloud Director services on the upgraded server.
Prerequisites
n
Verify that you have superuser credentials for the target server.
n
To have the installer verify the digital signature of the installation file, download and install the
VMware public key on the target server. If you already verified the digital signature of the installation
file, you do not need to verify it again during installation. See “Download and Install the VMware
Public Key,” on page 22.
n
Use the cell management tool to quiesce and shut down vCloud Director services on the server's cell.
vCloud Director Installation and Upgrade Guide
36 VMware, Inc.