Skip to main content
SANtricity commands

Initialize thin volume

Contributors netapp-driley

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.

Note

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

volume

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.

existingRepositoryLabel

This parameter replaces the repository volume by the candidate volume specified.

  • The value specified is an existing repository volume user label. The volume specified must be an unused repository volume with the name in the proper form.

  • If the newly specified repository volume is on a different disk pool, the thin volume will change ownership to that pool.

  • The old repository volume will be deleted by default.

If the existing repository volume name contains special characters or consists only of numbers, you must enclose the volume name in double quotation marks (" ").

diskPool

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 capacity parameter to create a new repository volume with the specified capacity.

capacity

The size that you want to set for the repository volume that you are creating. Size is defined in units of bytes, KB, MB, GB, or TB.

The minimum physical capacity is 4 GB.

The maximum physical capacity is 257 TB.

You must use this parameter with the diskPool parameter to create a new repository volume with the specified capacity.

retainRepositoryMembers

If this parameter is set to TRUE, the old repository is retained. By default, the old repository is deleted. This parameter is ignored if the existing repository is reused.

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.

Note

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.