Set read-only snapshot volume to read/write volume

04/25/2022 Contributors

The set snapVolume convertToReadWrite command changes a snapshot volume that is a read-only volume to a snapshot volume that is read/write volume.

Supported Arrays

This command applies to any individual storage array, including the E2700, E5600, E2800, E5700, EF600 and EF300 arrays, as long as all SMcli packages are installed.

Roles

To execute this command on an E2800, E5700, EF600, or EF300 storage array, you must have the Storage Admin role.

Context

You also can use this command to identify a new repository volume for the read/write volume, or to set a full limit warning level for the repository volume.

Syntax

set snapVolume ["snapImageVolumeName"] convertToReadWrite
[(repositoryVolume="repos_xxxx" |
repositoryVolume=(volumeGroupName [capacity=capacityValue])
repositoryVolume=(diskPoolName [capacity=capacityValue))]]
[repositoryFullLimit=percentValue]

Parameters

Parameter Description

Parameter	Description
`snapVolume`	The name of the snapshot volume that you want to change from read-only to read/write. Enclose the snapshot volume identifier in double quotation marks (" ") inside of square brackets ([ ]).
`repositoryVolume`	The name of the repository volume that you want to use for the read/write volume. You have two options for defining the name of a repository volume: Use an existing repository volume: name Create a new repository volume when you run this command The name of an existing repository volume is comprised of two parts: The term "repos" A four-digit numerical identifier that the storage management software assigns to the repository volume name Enclose the name of the existing repository volume in double quotation marks (" "). If you want to create a new repository volume when you run this command you must enter the name of either a volume group or a disk pool in which you want the repository volume. Optionally, you can also define the capacity of the repository volume. If you want to define the capacity you can use these values: An integer value that represents a percentage of the base volume capacity A decimal fraction value that represents a percentage of the base volume capacity A specific size for the repository volume. Size is defined in units of `bytes`, `KB`, `MB`, `GB`, or `TB`. If you do not use the capacity option, the storage management software sets the capacity to 20 percent of the base volume capacity. When you run this command the storage management software creates the repository volume for the snapshot volume.
`repositoryFullLimit`	The percentage of repository volume capacity at which you receive a warning that the snapshot image repository volume is nearing full. Use integer values. For example, a value of 70 means 70 percent. The default value is 75.

snapVolume

The name of the snapshot volume that you want to change from read-only to read/write. Enclose the snapshot volume identifier in double quotation marks (" ") inside of square brackets ([ ]).

repositoryVolume

The name of the repository volume that you want to use for the read/write volume.

You have two options for defining the name of a repository volume:

Use an existing repository volume: name
Create a new repository volume when you run this command

The name of an existing repository volume is comprised of two parts:

The term "repos"
A four-digit numerical identifier that the storage management software assigns to the repository volume name

Enclose the name of the existing repository volume in double quotation marks (" ").

If you want to create a new repository volume when you run this command you must enter the name of either a volume group or a disk pool in which you want the repository volume. Optionally, you can also define the capacity of the repository volume. If you want to define the capacity you can use these values:

An integer value that represents a percentage of the base volume capacity
A decimal fraction value that represents a percentage of the base volume capacity
A specific size for the repository volume. Size is defined in units of bytes, KB, MB, GB, or TB.

If you do not use the capacity option, the storage management software sets the capacity to 20 percent of the base volume capacity.

When you run this command the storage management software creates the repository volume for the snapshot volume.

repositoryFullLimit

The percentage of repository volume capacity at which you receive a warning that the snapshot image repository volume is nearing full. Use integer values. For example, a value of 70 means 70 percent. The default value is 75.

Notes

You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the user label. User labels can have a maximum of 30 characters.

The repository volume name is automatically created by the storage management software and the firmware when you create a new snapshot group. You cannot rename the repository volume because renaming the repository volume will break the linkage with the snapshot images.

A snapshot group repository volume is an expandable volume that is structured as a concatenated collection of up to 16 standard volume entities. Initially, an expandable repository volume has only a single element. The capacity of the expandable repository volume is exactly that of the single element. You can increase the capacity of an expandable repository volume by attaching additional standard volumes to it. The composite expandable repository volume capacity then becomes the sum of the capacities of all of the concatenated standard volumes.

A snapshot group repository volume must satisfy a minimum capacity requirement that is the sum of the following:

32 MB to support fixed overhead for the snapshot group and for copy-on-write processing.
Capacity for rollback processing, which is 1/5000th of the capacity of the base volume.

The minimum capacity is enforcement by the controller firmware and the storage management software.

Minimum firmware level

7.83