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. When no tasks are running, you can use the cell management tool to stop vCloud Director services.

Verify that you have superuser credentials for the target server.

Verify that you have vCloud Director system administrator credentials.


Log in to the target server as root.


Use the cell management tool to gracefully shut down the cell.


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

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.


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

After the cell management tool stops vCloud Director services on this server, you can upgrade the server's vCloud Director software.