SANtricity 11.8 Commands ( CA08871-194 ～ 196 )
Set read-only snapshot volume to read/write volume
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 Series
This command applies to any individual storage system, including the HB2100/HB2200/HB2300, HB5100/HB5200, AB6100 and AB3100 series, as long as all SMcli packages are installed.
Roles
To execute this command on an HB2100/HB2200/HB2300, HB5100/HB5200, AB6100, or AB3100 storage system, 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 |
|---|---|
|
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 ([ ]). |
|
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:
The name of an existing repository volume is comprised of two parts:
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:
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. |
|
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.
