lun resize

Changes the size of the LUN to the input value size.

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

This command resizes a LUN. You can resize a LUN that is mapped and online. However, to prevent any potential problems, take the LUN offline before resizing it.

When you reduce the size of the LUN, the data in the LUN could be truncated. You will receive an error message if you reduce the size of the LUN. To avoid this error message, use the force parameter.

When you increase the size of a LUN, the maximum resize size is based on the initial geometry of the LUN and the currently available space in the volume. You will receive an error message if you exceed this limit. The lun show -instance command reports the "Maximum Resize Size" for a LUN based on the initial geometry. The lun maxsize command reports the maximum LUN size based on the available space. The maximum size of the LUN is the smaller of the two limits issued by the lun show -instance command or the lun maxsize command.

Parameters

-vserver <Vserver Name> - Vserver Name

Specifies the Vserver.

{ -path <path> - LUN Path

Specifies the path of the LUN that you want to resize. Examples of correct LUN paths are /vol/vol1/lun1 and /vol/vol1/qtree1/lun1.

| -volume <volume name> - Volume Name

Specifies the volume that contains the LUN that you want to resize.

[-qtree <qtree name>] - Qtree Name

Specifies the qtree that contains the LUN that you want to resize.

-lun <text>} - LUN Name

Specifies the LUN name that you want to resize.

[-force | -f [true]] - Force Reduce LUN Size

Overrides any warnings if you are reducing the size of the LUN. If you use this parameter without a value, it is set to true, and the command does not prompt you when reducing the size of a LUN would produce warnings. If you do not use this parameter, the command displays an error if reducing the size of a LUN would create a problem.

[-size <size>] - New Size

Specifies the new size of the LUN.

c (1 byte)
w (2 bytes)
B (512 bytes)
k (1024 bytes)
M (k*k bytes)
G (k*m bytes)
T (m*m bytes)

Examples

 cluster1::> lun resize -vserver vs1 -path /vol/vol1/lun1 -size 500M -force

Resizes LUN /vol/vol1/lun1 on Vserver vs1 to 500M, overriding all warnings.

cluster1::> lun resize -vserver vs1 -path /vol/vol1/lun1 -size +5m

cluster1::> lun show -vserver vs1 -volume vol1
Vserver   Path                            State   Mapped   Type        Size
--------- ------------------------------- ------- -------- -------- --------
vs1
          /vol/vol1/lun1                  online  mapped   linux        15MB

Adds 5M of space to LUN /vol/vol1/lun1 for a total of 15MB.

cluster1::> lun resize -vserver vs1 -path /vol/vol1/lun1 -size -10m

Error: command failed: Reducing LUN size without coordination with the host system 
       may cause permanent data loss or corruption. Use the force flag to allow 
       LUN size reduction.

cluster1::> lun resize -path /vol/vol1/lun1 -size -5m -f

cluster1::> lun show -vserver vs1 -volume vol1
Vserver   Path                            State   Mapped   Type        Size
--------- ------------------------------- ------- -------- -------- --------
vs1
          /vol/vol1/lun1                  online  mapped   linux        10MB