HP 3PAR OS 3.1.3 Command Line Interface Reference

19 Promote Commands
promotegroupsv
DESCRIPTION
The promotegroupsv command copies the differences of snapshots back to their base volumes,
allowing you to revert the base volumes to an earlier point in time.
SYNTAX
promotesv [options] <virtual_copy_name>[:<target_vvname>]...
AUTHORITY
• Super, Edit
• Any role granted the svgrp_promote right.
OPTIONS
–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.
-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.
–halt
Cancels an ongoing snapshot promotion. Marks the RW parent volume with the cpf status, that
can be cleaned up using the promotevvcopy (see “promotevvcopy” (page 212)) command or by
issuing a new instance of the promotesv/promotegroupsv command. This option cannot be
used in conjunction with any other option.
-online
Indicates that the promote operation will be executed while the target volumes are online, with
vlun exports. Each 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. To halt a promote started
with the online option, use the canceltask command. The -rcp ,-halt, and -prioptions
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>[:<target_vvname>]...
Specifies the names of the virtual copy volumes to be promoted, using up to 31 characters in
length. Currently, vvset is not supported. If a RW target_vvnameis supplied, then the target vv
will be treated as the RW parent volume to be rolled back. If the target_vvname is not supplied,
then the virtual copy volume will be promoted to its base.
208 Promote Commands