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 the Cell Management Tool Reference in the vCloud Director Administrator's Guide. 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.
  • If this cell will be accessible to vCloud Director clients while it is being upgraded, use the /opt/vmware/vcloud-director/bin/vmware-vcd-cell command to turn on the cell maintenance message.
    [root@cell1 /opt/vmware/vcloud-director/bin]# ./vmware-vcd-cell maintenance
    This command causes the cell to respond to all requests with a maintenance message. If you use a load balancer or similar tool to make the cell inaccessible during the upgrade, you do not need to turn on the cell maintenance message.


  1. Log in to the target server as root.
  2. Use the cell management tool to gracefully shut down the cell.
    1. 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
    2. 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.
    3. 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

      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.