Use the fail-tasks command of the cell management tool to update the completion status associated with tasks that were running when the cell was deliberately shut down. You cannot use the fail-tasks command unless all cells have been shut down.
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 shut down the cell, which forces any running tasks to fail. After a shutdown that forced running tasks to fail, the superuser can run cell-management-tool fail-tasks to update the completion status of those tasks. Updating a task's completion status in this way is optional but helps maintain the integrity of system logs by clearly identifying failures caused by an administrative action.
cell-management-tool -u sysadmin-username cell --status-verbose
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. |
Fail Tasks Running on the Cell
[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 update the task with a completion status of administrative shutdown. Type n to allow the task to continue running.