184 Alphabetical list of commands
set task
Description
Changes parameters for a
TakeSnapshot
,
ReplicateVolume
, or
VolumeCopy task
. For
these types of tasks, you can change parameters other than name, type, or associated volumes. If
you change the parameters for a running task, the changes will take effect the next time the task
runs.
If you want to change parameters for a
ResetSnapshot
task or the name, type, or associated
volumes for another type of task, create a new task to replace the existing one.
Syntax
set task
[snapshot-prefix
prefix
]
[retention-count
#
]
[dest-vdisk
vdisk
]
[dest-prefix
prefix
]
[modified-snapshot yes|no]
[replication-mode new-snapshot|last-snapshot]
name
Parameters
snapshot-prefix
prefix
Optional. A label to identify snapshots created by this task. Snapshot names have the format
prefix
_s
#
, where
#
starts at
001
.
retention-count
#
Optional. For a
TakeSnapshot
task, the number of snapshots created by this task to retain, from 1
to the licensed limit. When a new snapshot exceeds this limit, the oldest snapshot with the same
prefix is deleted. If you reduce a task’s retention count, excess snapshots will be removed the next
time the task runs.
For a
ReplicateVolume
task, the number of replication images created by this task to retain, from
2 to 32. When a new image exceeds this limit, the oldest image with the same prefix is deleted. This
parameter applies to the primary volume only; for the secondary volume, images will accumulate
until either the secondary vdisk’s space limit is reached or the maximum number of images is
reached, after which the oldest image will be deleted as new images are created.
dest-vdisk
vdisk
Optional. Name or serial number of the destination vdisk for the volume copy. For vdisk syntax, see
Command syntax
on page 22.
dest-prefix
prefix
Optional. A label to identify the volume copy created by this task. Copy names have the format
prefix
_c
#
, where
#
starts at
001
.
modified-snapshot yes|no
Optional. For a
VolumeCopy
task, specifies whether to include or exclude modified write data from
the snapshot in the copy. This parameter applies only when the source volume is a snapshot; it is
ignored if the source volume is a master volume.
•
yes
: Include modified snapshot data.
•
no
: Exclude modified snapshot data.
If this parameter is omitted for a snapshot, modified snapshot data is excluded.
replication-mode new-snapshot|last-snapshot
Optional. Specifies whether to replicate a new snapshot of the volume to the remote system, or to
replicate the last (most recent existing) snapshot of the volume to the remote system.
•
new-snapshot
: Replicate a new snapshot.
•
last-snapshot
: Replicate the most recent existing snapshot.
If this parameter is omitted, a new snapshot is replicated.
name
Name of the task to change.
Summary of Contents for P2000 G3
Page 1: ...HP P2000 G3 MSA System CLI Reference Guide Part number 500912 009 First edition February 2014 ...
Page 14: ...14 About this guide ...
Page 30: ...30 Categorical list of commands ...
Page 199: ...HP P2000 G3 MSA System CLI Reference Guide 199 See also set cache parameters show volumes ...
Page 294: ...294 Alphabetical list of commands See also set volume set vdisk ...
Page 498: ...498 XML API basetype properties PROPERTY name mrc version type uint8 0 PROPERTY OBJECT ...
Page 524: ...524 Glossary ...
Page 532: ...532 Index ...