Symantec logo

Managing tasks with vxtask

You can use the vxtask command to administer operations on VxVM tasks that are running on the system. Operations include listing tasks, modifying the state of a task (pausing, resuming, aborting) and modifying the rate of progress of a task.

VxVM tasks represent long-term operations in progress on the system. Every task gives information on the time the operation started, the size and progress of the operation, and the state and rate of progress of the operation. The administrator can change the state of a task, giving coarse-grained control over the progress of the operation. For those operations that support it, the rate of progress of the task can be changed, giving more fine-grained control over the task.

New tasks take time to be set up, and so may not be immediately available for use after a command is invoked. Any script that operates on tasks may need to poll for the existence of a new task.

See the vxtask(1M) manual page.

vxtask operations

The vxtask command supports the following operations:

abort Causes the specified task to cease operation. In most cases, the operations "back out" as if an I/O error occurred, reversing what has been done so far to the largest extent possible.

list Lists tasks running on the system in one-line summaries. The -l option prints tasks in long format. The -h option prints tasks hierarchically, with child tasks following the parent tasks. By default, all tasks running on the system are printed. If a taskid argument is supplied, the output is limited to those tasks whose taskid or task tag match taskid. The remaining arguments are used to filter tasks and limit the tasks actually listed.

monitor Prints information continuously about a task or group of tasks as task information changes. This allows you to track the progression of tasks. Specifying -l causes a long listing to be printed. By default, short one-line listings are printed. In addition to printing task information when a task state changes, output is also generated when the task completes. When this occurs, the state of the task is printed as EXITED.

pause Puts a running task in the paused state, causing it to suspend operation.

resume Causes a paused task to continue operation.

set Changes modifiable parameters of a task. Currently, there is only one modifiable parameter, slow[=iodelay], which can be used to reduce the impact that copy operations have on system performance. If slow is specified, this introduces a delay between such operations with a default value for iodelay of 250 milliseconds. The larger the value of iodelay that is specified, the slower is the progress of the task and the fewer system resources that it consumes in a given time. (The slow attribute is also accepted by the vxplex, vxvol and vxrecover commands.)

Using the vxtask command

To list all tasks currently running on the system, use the following command:

# vxtask list

To print tasks hierarchically, with child tasks following the parent tasks, specify the -h option, as follows:

# vxtask -h list

To trace all tasks in the disk group, foodg, that are currently paused, as well as any tasks with the tag sysstart, use the following command:

# vxtask -g foodg -p -i sysstart list

Use the vxtask -p list command lists all paused tasks, and use vxtask resume to continue execution (the task may be specified by its ID or by its tag):

# vxtask -p list

# vxtask resume 167

To monitor all tasks with the tag myoperation, use the following command:

# vxtask monitor myoperation

To cause all tasks tagged with recovall to exit, use the following command:

# vxtask abort recovall

This command causes VxVM to attempt to reverse the progress of the operation so far. For example, the vxtask command can be used to monitor and modify the progress of the Online Relayout feature.

See "Controlling the progress of a relayout" on page 309.