Storage Foundation 7.4.1 Administrator's Guide - Linux

Controlling the progress of a relayout

You can use the vxtask command to stop (pause) the relayout temporarily, or to cancel it (abort). If you specify a task tag to vxassist when you start the relayout, you can use this tag to specify the task to vxtask. For example, to pause the relayout operation that is tagged as myconv, enter:

# vxtask pause myconv

To resume the operation, use the vxtask command as follows:

# vxtask resume myconv

For relayout operations that have not been stopped using the vxtask pause command (for example, the vxtask abort command was used to stop the task, the transformation process died, or there was an I/O failure), resume the relayout by specifying the start keyword to vxrelayout, as follows:

# vxrelayout -g mydg -o bg start vol04

If you use the vxrelayout start command to restart a relayout that you previously suspended using the vxtask pause command, a new untagged task is created to complete the operation. You cannot then use the original task tag to control the relayout.

The -o bg option restarts the relayout in the background. You can also specify the slow and iosize option modifiers to control the speed of the relayout and the size of each region that is copied. For example, the following command inserts a delay of 1000 milliseconds (1 second) between copying each 10 MB region:

# vxrelayout -g mydg -o bg,slow=1000,iosize=10m start vol04

The default delay and region size values are 250 milliseconds and 1 MB respectively.

To reverse the direction of relayout operation that is stopped, specify the reverse keyword to vxrelayout as follows:

# vxrelayout -g mydg -o bg reverse vol04

This undoes changes made to the volume so far, and returns it to its original layout.

If you cancel a relayout using vxtask abort, the direction of the conversion is also reversed, and the volume is returned to its original configuration.

See the vxrelayout(1M) manual page.

See the vxtask(1M) manual page.