5.1

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 -p Pa55w0rd 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 -p Pa55w0rd 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 -p Pa55w0rd cell --shutdown
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.
Cell Management Tool Reference
The cell management tool is a command-line utility that you can use to manage a cell and its SSL certificates,
and to export tables from the vCloud Director database. Superuser or system administrator credentials are
required for some operations.
The cell management tool is installed in /opt/vmware/vcloud-director/bin/cell-management-tool.
Listing Available Commands
To list the available cell management tool commands, use the following command line.
cell-management-tool -h
Example: Cell Management Tool Usage Help
[root@cell1 /opt/vmware/vcloud-director/bin]# ./cell-management-tool -h
usage: cell-management-tool
-h,--help print this message
-p,--password <arg> administrator password
-u,--username <arg> administrator username
Available commands:
cell - Manipulates the Cell and core components
dbextract - Exports the data from the given set of tables
certificates - Reconfigures the SSL certificates for the cell
generate-certs - Generates self-signed SSL certificates for use with vCD cell
recover-password - Change a forgotten System Administrator password. Database credentials are
vCloud Director Installation and Upgrade Guide
36 VMware, Inc.