HP 3PAR OS 3.1.3 CLI Administrator's Manual

• The retention time can be set in hours or days. The minimum retention time is 1 hour and the
maximum retention time is 43800 hours (1,825 days or 5 years). The default is 336 hours
(14 days). The vvMaxRetentionTime system parameter determines the maximum retention.
This parameter can be set with the setsys command.
• The maximum retention time for a volume in a domain can be set during domain creation with
the createdomain command, or applied to an existing domain with the setdomain
command.
• If the volume belongs to a domain, then the volume retention time cannot exceed the domain's
maximum retention time.
• A volume with remaining retention time cannot be removed until the end of the retention period.
You can use the -retain option to set volume retention times while issuung the following
commands:
• createvv
• setvv
• createsv
• creategroupsv
To create a virtual volume that cannot be deleted for a specified number of hours, issue the
createvv -retain <time> d|D|h|H <CPG_name> -snp_cpg <CPG_name> <user_CPG>
<VV_name> <VV_size g|G|t|T> command, where:
• -retain <time> d|D|h|H specifies that the volume cannot be removed from the system
for the specified number of hours or days. The value for <time> must be a positive integer
in the range of 1 hour to 43,800 hours (1,825 days). The value for <time> can be specified
in days with d|D or hours with h|H. For example, 14d specifies 14 days.
• <CPG_name> is the name of the CPG from which the volume will draw its snapshot space
and administration space.
• <user_CPG> is the name of the CPG from which the created virtual volume will draw its user
space.
• <VV_name> is the name of the volume being created. The name can be up to 31 characters.
• <VV_size g|G|t|T> is the size of the volume in MB, GB, or TB. If g|G|t|T is not specified,
VV_size is the number of MBs. For example, 50g specifies 50 GBs.
Removing Virtual Volumes
To remove virtual volumes, issue the removevv <VV_name> or removevv <pattern> command,
where:
• <VV_name> represents the names of the virtual volumes to be removed.
• <pattern> represents the name of the pattern according to which virtual volumes are to be
removed.
For a complete list of options available for the removevv command, see the HP 3PAR Command
Line Interface Reference and the HP 3PAR CLI Help.
Validating and Repairing Virtual Volumes
To verify that virtual volumes are valid, and to repair virtual volumes corrupted by an uncontrolled
system shutdown, issue the checkvv {-y|-n} <VV_name> command, where:
• {-y|-n} specifies that if validity errors are found they are to be corrected (-y), or left
unmodified (-n). If this option is not specified, errors are not corrected.
• <VV_name> represents the name of the virtual volume to be validated and repaired.
96 Managing CPGs and Virtual Volumes