HP 3PAR OS 3.1.3 Command Line Interface Reference

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 <vvname>
Copy the differences of the virtual copy to the specified RW parent in the same virtual volume
family tree. The default is to copy the differences to the base volume. This option cannot be used
in conjunction 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 212)) 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 cannot be used with -halt option.
-online
Indicates that the promote operation will be executed while the target volume is online, with vlun
exports. The specified virtual copy and its base volume must be the same size. The base volume
is the only possible target of online promote, and is the default target. To halt a promote started
with the online option, use the canceltask command. The -rcp, –halt, and -pri options
cannot be combined with the —online option. . Note that OS support is required for the VLUN
data to abruptly transition to the snapshot data.
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:.
210 Promote Commands