Command Reference Guide

19 Promote Commands
promotesv
DESCRIPTION
The promotesv command copies the differences of a snapshot back to its base volume, allowing
you to revert the base volume to an earlier point in time.
SYNTAX
promotesv [options] <virtual_copy_name | VV_set>
AUTHORITY
• Super, Edit
• Any role granted the sv_promote right.
OPTIONS
-target
Copy the differences of the virtual copy to the specified RW parent in the same VV family tree.
The default is to copy the differences to the base volume. This option cannot be used with the
-halt option.
–rcp
Allows the promote operation to proceed even if the RW parent volume is currently in a Remote
Copy volume group, if that group has not been started. If the Remote Copy group has been started,
this command fails. This option cannot be used in conjunction with the –halt option.
–halt
Cancels an ongoing snapshot promotion. Marks the RW parent volume with the cpf status, which
can be cleaned up using the promotevvcopy (see “promotevvcopy” (page 227)) command or by
issuing a new instance of the promotesv command. This option cannot be used in conjunction
with any other option.
-pri <high|med|low>
Specifies the priority of the copy operation when it is started. This option allows the user to control
the overall speed of a particular task. If this option is not specified, the promotesv operation is
started with a default priority of medium. High priority indicates that the operation will complete
faster. Low priority indicates that the operation will run slower than the default priority task. This
option can not be used with -halt option.
SPECIFIERS
<virtual_copy_name | VV_set>
Specifies the name of the virtual copy volume or set of virtual copy volumes to be promoted, using
up to 31 characters in length. The virtual volume set name must start with set:.
RESTRICTIONS
• The virtual copy and its base volume must not be exported.
• Only one promote operation is allowed at a time within a VV family tree.
promotesv 225