Initialize thin volume
The start volume initialize
command initializes or re-initializes a thin volume.
Supported Arrays
This command applies to any individual storage array, including the E4000, E2700, E5600, E2800, E5700, EF600 and EF300 arrays, as long as all SMcli packages are installed.
Roles
To execute this command on an E4000, E2800, E5700, EF600, or EF300 storage array, you must have the Storage Admin role.
Context
The action depends on the parameters used:
-
Used without any of the optional parameters, this command deletes the data on the thin volume. The repository volume capacity is not affected.
-
Used with any of the optional parameters, this command cause reinitialization and repository volume actions.
Initializing a thin volume starts a long-running operation that you cannot stop. |
Syntax
start volume [volumeName] initialize
[existingRepositoryLabel=existingRepositoryName]
[diskPool=diskPoolName capacity=capacityValue]
[retainRepositoryMembers=(TRUE|FALSE)]
Parameter
Parameter | Description |
---|---|
|
The name of the volume on which you are starting the initialization. Enclose the volume name in square brackets ([ ]). If the volume name contains special characters or numbers, you must enclose the volume name in double quotation marks (" ") inside square brackets. |
|
This parameter replaces the repository volume by the candidate volume specified.
If the existing repository volume name contains special characters or consists only of numbers, you must enclose the volume name in double quotation marks (" "). |
|
The name of the disk pool in which you want to create a new repository volume with the specified capacity. If the disk pool name contains special characters or consists only of numbers, you must enclose the disk pool name in double quotation marks (" "). You must use this parameter with the |
|
The size that you want to set for the repository volume that you are creating. Size is defined in units of The minimum physical capacity is 4 GB. The maximum physical capacity is 257 TB. You must use this parameter with the |
|
If this parameter is set to |
Notes
If you do not specify a volume with the volume
parameter, this command resets the metadata in the repository and, in effect, causes the thin volume to appear empty to the host. If you specify a volume with the volume
parameter, that volume is either replaced by a newly created volume or by an existing volume if you specify one with the existingRepositoryLabel
parameter. If you specify an existing volume with the existingRepositoryLabel
parameter that is in a different disk pool, the thin volume will change ownership to the new disk pool.
The volume parameters of the thin volume, such as virtual capacity, quota and warning threshold, retain their previous values after you reinitialize the thin volume.
Immediate Availability Format (IAF) does not apply to volumes greater than 64 TB. |
The following table lists the capacity limits for a thin volume.
Type of Capacity | Size |
---|---|
Minimum virtual capacity |
32 MB |
Maximum virtual capacity |
256 TB |
Minimum physical capacity |
4 GB |
Maximum physical capacity |
257 TB |
Thin volumes support all of the operations that standard volumes do with the following exceptions:
-
You cannot change the segment size of a thin volume.
-
You cannot enable the pre-read redundancy check for a thin volume.
-
You cannot use a thin volume as the target volume in a volume copy.
-
You cannot use a thin volume in a Synchronous Mirroring operation.
If you want to change a thin volume to a standard volume, use the volume copy operation to create a copy of the thin volume. The target of a volume copy is always a standard volume.
Minimum firmware level
7.83
8.30 increases the maximum capacity of a thin volume to 256 TB.