/usr/sbin/vxtask – List and administer VERITAS Volume Manager Tasks
The vxtask utility performs basic administrative operations on VERITAS Volume Manager (VxVM) tasks that are running on the system. Operations include listing tasks (subject to filtering), modifying the state of a task (aborting, pausing, resuming), and modifying the rate of progress of a task. VERITAS Volume Manager Tasks represent long-term operations in progress on the system. Every task provides the time the operation started, the size and progress of the operation, and the operation’s state and rate of progress (throttle).
Tasks |
Switches |
| Listing VxVM Tasks | vxtask [-ahlpqr ] [-g dg_name [-g dg_name…]] [[-G dg_name] -v volume [-v volume…]] [-i taskid] list [taskid…] |
| Pausing VxVM Tasks | vxtask pause taskid |
| Resuming VxVM Tasks | vxtask resume taskid |
| Aborting VxVM Tasks | vxtask abort taskid |
| Monitoring VxVM Tasks | vxtask [-c count] [-t time] [-w wait_interval] [-ln ] monitor [taskid[taskid…]] |
| Changing parameters of VxVM Tasks | vxtask [-i taskid] set name=value taskid |
Option |
Description |
| -a | Limits the output to tasks in the aborting state. |
| -g disk group | Limits the listed tasks to diskgroup |
| -G | Distinguishes between volumes with the same name in different diskgroups |
| -h | Prints tasks hierarchically with a task’s child tasks following the parent task |
| -l | Prints tasks in long format. |
| -p | Limits the output to tasks in the paused state. |
| -q | Suppresses printing of column headings. |
| -r | Limits the output to tasks in the running state. |
| -v volume | Limits the output to tasks whose object is volume. |
Listing VxVM Tasks
# vxtask list TASKID PTID TYPE/STATE PCT PROGRESS 184 - RELAYOUT/R 04.50% 0/3276800/147456 RELAYOUT oravol oradg
Print tasks in long format
# vxtask -l list Task: 184 PAUSED Type: RELAYOUT Operation: RELAYOUT Vol oravol Dg oradg Started: Tue Oct 07 20:51:56 2014 Throttle: 0 Throttle time: 0 Progress: 65.04%2131136 of 3276800 Blocks Work time: 2 minutes, 33 seconds (01:22 remaining)
Print Running Tasks
# vxtask -r list TASKID PTID TYPE/STATE PCT PROGRESS 184 - RELAYOUT/R 65.04% 0/3276800/2131136 RELAYOUT oravol oradg
Print paused tasks
# vxtask -p list TASKID PTID TYPE/STATE PCT PROGRESS 184 - RELAYOUT/P 65.04% 0/3276800/2131136 RELAYOUT oravol oradg
Suppress printing of column headings
# vxtask -q list
184 - RELAYOUT/P 65.04% 0/3276800/2131136 RELAYOUT oravol oradg
Pause specified tasks in running state
# vxtask -r list TASKID PTID TYPE/STATE PCT PROGRESS 184 - RELAYOUT/R 04.50% 0/3276800/147456 RELAYOUT oravol oradg # vxtask pause 184 # vxtask -p list - List paused tasks TASKID PTID TYPE/STATE PCT PROGRESS 184 - RELAYOUT/P 65.04% 0/3276800/2131136 RELAYOUT oravol oradg
Resume specified paused tasks
# vxtask -p list - List paused tasks
TASKID PTID TYPE/STATE PCT PROGRESS
184 - RELAYOUT/P 65.04% 0/3276800/2131136 RELAYOUT oravol oradg
# vxtask resume 184
Abort any specified tasks
# vxtask abort 184
Monitoring VxVM Tasks
One line summary (Count=10, Exit_time=60s
# vxtask -c 10 -t 60 monitor TASKID PTID TYPE/STATE PCT PROGRESS 210 - RELAYOUT/R 21.30% 0/3276800/698112 RELAYOUT oravol oradg 210 - RELAYOUT/R 21.43% 0/3276800/702208 RELAYOUT oravol oradg 210 - RELAYOUT/R 21.49% 0/3276800/704256 RELAYOUT oravol oradg 210 - RELAYOUT/R 21.55% 0/3276800/706304 RELAYOUT oravol oradg 210 - RELAYOUT/R 21.62% 0/3276800/708352 RELAYOUT oravol oradg 210 - RELAYOUT/R 21.68% 0/3276800/710400 RELAYOUT oravol oradg 210 - RELAYOUT/R 21.74% 0/3276800/712448 RELAYOUT oravol oradg 210 - RELAYOUT/R 21.80% 0/3276800/714496 RELAYOUT oravol oradg 210 - RELAYOUT/R 21.87% 0/3276800/716544 RELAYOUT oravol oradg 210 - RELAYOUT/R 21.93% 0/3276800/718592 RELAYOUT oravol oradg
Long listing (count=3)
# vxtask -c 3 -l monitor 210 Task: 210 RUNNING Type: RELAYOUT Operation: RELAYOUT Vol oravol Dg oradg Started: Tue Oct 07 21:35:14 2014 Throttle: 0 Throttle time: 0 Progress: 56.17%1840448 of 3276800 Blocks Work time: 30 seconds (0:23 remaining) Task: 210 RUNNING Type: RELAYOUT Operation: RELAYOUT Vol oravol Dg oradg Started: Tue Oct 07 21:35:14 2014 Throttle: 0 Throttle time: 0 Progress: 56.23%1842496 of 3276800 Blocks Work time: 30 seconds (0:23 remaining) Task: 210 RUNNING Type: RELAYOUT Operation: RELAYOUT Vol oravol Dg oradg Started: Tue Oct 07 21:35:14 2014 Throttle: 0 Throttle time: 0 Progress: 56.29%1844544 of 3276800 Blocks Work time: 30 seconds (0:23 remaining)