Description
This command creates a new empty LUN of a specific size. You cannot create a LUN in path that already exists. You must specify the LUN at a qtree root directory in the lun_path. A LUN can only exist at the root of a qtree. You can not create LUNs in the Vserver root volume.
You might find it useful to provide a meaningful path name for the LUN. For example, you might choose a name that describes how the LUN is used, such as the name of the application, the type of data that it stores, or the user accessing the data. Examples are /vol/database/lun0, /vol/finance/lun1, and /vol/bill/lun2.
For clustered storage system configurations, it is recommended that you distribute LUNs across the cluster.
When you can create a LUN, the size of the LUN could be larger than what you specified. The system generates a message if the size of the LUN is different from what you specified.
By default, when you create a LUN, it is online and it is space-reserved. Use the lun offline command to take a LUN offline. When you set space reserved to false, the LUN is thinly provisioned.
Note:
When you thinly provision a LUN, write operations to that LUN might fail due to insufficient disk space. As a result, the host application or operating system might crash.
Note:
When you create a LUN from a file, that file cannot be deleted without deleting the LUN itself.
Note:
This command is not supported for a Vserver with Infinite Volume.
Parameters
-vserver <vserver name> - Vserver Name
Specifies the Vserver.
{
-path <path> - LUN Path
Specifies the path of the new LUN.
The LUN path cannot contain any files.
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 new LUN.
[-qtree <text>] - Qtree Name
Specifies the qtree that contains the new LUN.
-lun <text>
} - LUN Name
Specifies the new LUN name. A LUN name is a case-sensitive name and has the following requirements:
- Must contain one to 255 characters. Spaces are not allowed.
- Can contain the letters A through Z, a through z, numbers 0 through 9, hyphen (-), underscore (_), right bracket (}), left bracket ({) and period (.).
- Must start with a letter or number.
{
-size | -s <size> - LUN Size
Specifies the size of the LUN in bytes. You can specify a one-character multiplier suffix:
- c (1 byte)
- w (2 bytes)
- B (512 bytes)
- k (1024 bytes)
- M (k*k bytes)
- G (k*m bytes)
- T (m*m bytes)
|
-file-path | -f <text>
} - File Path
Creates a LUN using the file path as the source.
[-prefix-size | -P <size>] - Prefix Size (privilege: advanced)
Specifies the size of the prefix stream for the new LUN.
-ostype | -t <os_enum> - OS Type
Specifies the OS type for the new LUN. The OS types are:
- aix - the LUN stores AIX data.
- hpux - the LUN stores HP-UX data.
- hyper_v - the LUN stores Windows Server 2008 or Windows Server 2012 Hyper-V data
- linux - the LUN stores a Linux raw disk without a partition table.
- netware - the LUN stores NetWare data.
- openvms - the LUN store Open-VMS data
- solaris - the LUN stores Solaris raw disk in a single-slice partition.
- solaris_efi - the LUN stores Solaris_EFI data.
- vmware - the LUN stores VMware data
- windows - the LUN stores a raw disk type in a single-partition Windows disk using the Master Boot Record (MBR) partitioning style.
- windows_gpt - the LUN stores Windows data using the GUID Partition Type (GPT) partitioning style.
- windows_2008 - the LUN stores Windows data for Windows 2008 and 2012 systems.
- xen - the LUN stores Xen data
[-space-reserve {enabled|disabled}] - Space Reservation
Specifies whether the space reservation setting is enabled or disabled for the new LUN. If you set the parameter to enabled, the LUN is space-reserved. If you set the parameter to disable, the LUN is thinly provisioned. The default is enabled.
[-class {regular|protocol-endpoint|vvol}] - Class
Specifies the class of the new LUN. The class types are:
- regular - the LUN is for normal blocks protocol access. This is the default value.
- protocol-endpoint - the LUN is a vvol protocol endpoint.
- vvol - the LUN is a vvol data LUN.
[-qos-policy-group <text>] - QoS Policy Group
This optionally specifies which QoS policy group to apply to the lun. This policy group defines measurable service level objectives (SLOs) that apply to the storage objects with which the policy group is associated. If you do not assign a policy group to a lun, the system will not monitor and control the traffic to it.
Note:
If you specify this parameter for a LUN that you want to create from a file and that file belongs to a QoS policy group, Data ONTAP adds the LUN to the specified policy group and removes the file from its policy group. Both the file and the LUN that you created from the file cannot belong to QoS policy groups.
