Use the fail-tasks command of the cell management tool to generate a list of tasks running on a quiesced cell that you can force to complete immediately with a status of failure.

When you quiesce a cell using the cell-management-tool -q command, running tasks should terminate gracefully within a few minutes. If tasks continue to run on a cell that has been quiesced, the superuser can force those tasks to exit with failure so that system maintenance can begin.

To generate a list of running tasks that can be forced to fail, use a command line with the following form:

cell-management-tool fail-tasks -m "message"

Cell Management Tool Options and Arguments, fail-tasks Subcommand

Command

Argument

Description

--help (-h)

None

Provides a summary of available commands in this category.

--message (-m)

Message text.

Message text to place in task completion status.

This example generates a list of tasks running on this cell that are candidates for forced failure and requests confirmation that the tasks should be forced to fail.

[root@cell1 /opt/vmware/vcloud-director/bin]# ./cell-management-tool fail-tasks -m "administrative shutdown"
Operation: IMPORT_SINGLETON_VAPP, Start time: 12/16/13 6:41 PM, Username: system, Organization: org1
Would you like to fail the tasks listed above? 

Type y to fail the task with a failure status of administrative shutdown. Type n to allow the task to continue running.

Note

If multiple tasks are returned in the response, you must decide to fail all of them or take no action. You cannot choose a subset of tasks to fail.