expandvdisksize

The expandvdisksize command expands the size of a VDisk by a given capacity.

Syntax


>>- svctask -- -- expandvdisksize -- --+- -size  disk_size -+--->
                                       '- -rsize  disk_size-'   

>-- --+---------------------------------+-- --+------------+---->
      '- -mdisk --+- mdisk_id_list ---+-'     '- -fmtdisk -'   
                  '- mdisk_name_list -'                        

>-- --+-------------------+--+--------------+-- ---------------->
      '- -unit --+- b --+-'  '- -copy-- id -'      
                 +- kb -+                          
                 +- mb -+                          
                 +- gb -+                          
                 +- tb -+                          
                 '- pb -'                          

>--+- vdisk_name -+--------------------------------------------><
   '- vdisk_id ---'

Parameters

-size disk_size: (Optional) Specifies the capacity by which the virtual disk is expanded. Disk size is used with the value of the unit. All capacities, including changes must be in multiples of 512 bytes. An error occurs if you specify a capacity that is not a multiple of 512, which can only occur when byte units (-unit b) are used. However, an entire extent is reserved even if it is only partially used. The default disk_size unit is megabytes (MB). You cannot specify the -size parameter with the -rsize parameter. You must specify either -size or -rsize. If the VDisk is space-efficient, MDisks cannot be specified.
-rsize disk_size: (Optional) Specifies the capacity by which to increase the real size of a space-efficient VDisk. Specify the disk_size value using an integer. Specify the unit for a disk_size integer using the -unit parameter; the default unit is megabytes (MB). The -rsize value can be greater than, equal to, or less than the size of the VDisk. You cannot specify the -rsize parameter with the -size parameter. You must specify either -size or -rsize.
-copy id: (Optional) Specifies the copy to change the real capacity for. You must also specify the -rsize parameter; you can only modify the real capacity of a VDisk copy. The -copy parameter is required if the specified VDisk is mirrored and only one copy is space-efficient. If the VDisk is mirrored, both copies are space-efficient and -copy is not specified, both copies are modified by the same amount.
-mdisk mdisk_id_list | mdisk_name_list: (Optional) Specifies the list of one or more MDisks to be used as the stripe set. The extents that expand the VDisk come from the specified list of MDisks. All MDisks in the list must be part of the same MDisk group. The -mdisk parameter cannot be used if the specified VDisk is mirrored.
-fmtdisk: (Optional) Specifies that the VDisk be formatted before use. This parameter formats the new extents that have been added to the VDisk as a result of the expandvdisksize command. The expandvdisksize command completes asynchronously if you use this parameter.
-unit b | kb | mb | gb | tb | pb: (Optional) Specifies the disk_size unit for the -size or -rsize parameter. The default value is megabytes (MB).
vdisk_name | vdisk_id: (Required) Specifies the virtual disk to modify, either by ID or by name.

Description

The expandvdisksize command can be used to expand the physical capacity that is allocated to a particular VDisk by the specified amount. The command can also be used to expand the virtual capacity of a space-efficient VDisk without altering the physical capacity that is assigned to the VDisk. To change the capacity of a non-space-efficient VDisk, or the virtual capacity of a space-efficient VDisk, use the -size parameter. To change the real capacity of a space-efficient VDisk, use the -rsize parameter.

The default capacity units are MB.

When a VDisk is expanded, the virtualization policy can change. Its mode becomes striped even if it was previously sequential. See the svctask mkvdisk command for details of the virtualization policies.

To run the expandvdisksize command on a mirrored VDisk, all copies of the VDisk must be synchronized. The command formats all copies of a mirrored VDisk automatically.

An invocation example

To increase the capacity of VDisk1 by 2048 bytes by using extents from two MDisks and to format the new part of the VDisk, enter:

svctask expandvdisksize -size 2048 -unit b -mdisk 
mdisk0:mdisk1 -fmtdisk vdisk1

The resulting output

No feedback

An invocation example

To increase the capacity of VDisk1 by 100 MB using extents from two MDisks, and to format the new part of the VDisk, enter:

svctask expandvdisksize -size 100 -unit mb -mdisk mdisk0:mdisk1 -fmtdisk vdisk1

The resulting output

No feedback

An invocation example

To increase the real capacity of space-efficient VDisk vdisk2 by 100 MB without changing the virtual capacity, and to spread the extents across all MDisks in the MDisk group, enter:

svctask expandvdisksize -rsize 100 -unit mb vdisk2

The resulting output

No feedback

An invocation example

To increase the real capacity of space-efficient VDisk copy id 1 of mirrored VDisk vdisk3 by 100 MB, enter:

svctask expandvdisksize -rsize 100 -unit mb -copy 1 vdisk3

The resulting output

No feedback