Management of a volume copy operation when it is in progress

Checking the status of a volume copy operation

You can use the following command syntax to check the status of one or more volume copy operations:

vol copy status [ operation_number ]

This command displays the status for a specified volume copy operation. If you do not specify the operation number, the command displays the status of all volume copy operations in progress. In the command output, the operations are differentiated from one another with unique volume copy operation numbers, ranging from 0 to 3. For more information about volume copy operation numbers, see "Results of the vol copy start command."

Where to enter the vol copy status command

If you start a volume copy operation from the filer's console, you can enter the vol copy status command only through rsh when the copy operation is in progress. This is because you do not have access to the filer prompt on the console when the filer is copying the volume.

If data is being copied between two filers, you can enter this command through an rsh connection to either filer. The operation numbers displayed on the source filer and the destination filer are different because the reading and the writing are considered two different operations.

Example of a vol copy status command

The following example illustrates a vol copy start command that copies the vol0 volume to the vol1 volume on the same filer:

vol copy start -S vol0 vol1
Copy Volume: vol0 on machine 127.0.0.1 to Volume: vol1
Reading the dump stream
VOLCOPY: Starting on volume 1.
This dump contains 257 blocks
10:04 pm : volcopy restore 1 : begun.
10:04 pm : volcopy restore 1 : 5 % done. Estimate 3 minutes 
remaining.
.
.
.
10:04 pm : volcopy restore 1 : 95% done. Estimate 1 minutes 
remaining.

Before the filer prompt is displayed again, you can use the vol copy status command on a trusted host of the filer, as shown in the following example:

rsh toaster vol copy status
10:04 pm : volcopy dump 0 : 99 % done. Estimate 1 minutes remaining.
10:04 pm : volcopy restore 1 : 99 % done. Estimate 1 minutes 
remaining.
No operation 2 in progress.
No operation 3 in progress.

In this example, volume copy operation 0, shown as volcopy dump 0 in the display, is for reading the data from the vol0 volume; volume copy operation 1, shown as volcopy restore 1 in the display, is for writing the data to the vol1 volume.

Aborting a volume copy operation

To stop a volume copy operation, use the following command syntax:

vol copy abort [ operation_number ]

The operation_number parameter specifies the volume copy operation to be aborted. You can obtain the operation number from the vol copy status output.


Caution: If you specify no operation number in the command, the filer aborts all volume copy operations. It does not display a help string for the vol copy abort command.


If data is being copied between two filers, you can execute this command on either filer.

If you start the volume copying operation from the filer console, you can enter the vol copy abort command only through rsh because you do not have access to the filer prompt on the console during the copying.


Caution: An incomplete volume copy operation leaves unusable data in the destination volume.


Controlling the speed of a volume copy operation

You can control the speed of a volume copy operation in two ways.

Displaying the default speed for copying a volume

Before starting the vol copy start command, you can verify the default speed for all volume copy operations using the following command:

options vol.copy.throttle

It displays the value (1 through 10) to be used by all volume copy operations. The value of the vol.copy.throttle option was set at 10 at the factory.

Example of controlling the speed of copying a volume

The following example illustrates changing the speed of all volume copy operations in progress to one-tenth of full speed through rsh:

rsh toaster vol copy throttle 1
volcopy operation 0: Throttle adjusted from 100% to 10%. 
volcopy operation 1: Throttle adjusted from 100% to 10%. 

Copyright © 1999, Network Appliance, Inc. All rights reserved.

Part No. 210-02334
File: volcopy4.htm
Last updated: 02/24/99 12:17:12