Creating LUNs with the lun setup program

On the storage system command line, enter the following command.

lun setup

Result

The lun setup program displays the following instructions. Press Enter to continue or n to terminate the program.

  This setup will take you through the steps needed to create LUNs

  and to make them accessible by initiators. You can type ^C (Control-C)

  at any time to abort the setup and no unconfirmed changes will be made 

  to the system.

Do you want to create a LUN? [y]:

Specify the operating system that will be accessing the LUN by responding to the next prompt:

OS type of LUN (image/solaris/windows/hpux/aix/linux/netware/vmware) [image]:

Example

windows

For information about specifying the ostype of the LUN, see The host operating system type.

Specify the name of the LUN and where it will be located by responding to the next prompt:

    A LUN path must be absolute. A LUN can only reside in a volume

    or qtree root. For example, to create a LUN with the name "lun0" 

    in the qtree root /vol/vol/q0, specify the path as "/vol/vol1/q0/lun0".

Enter LUN path: 

Example

If you previously created /vol/finance/ and want to create a LUN called records, you enter /vol/finance/records.

Note
Do not create LUNs in the root volume because it is used for system administration.

Result

A LUN called records is created in the root of /vol/finance if you accept the configuration information later in this program.

Specify whether you want the LUN created with space reservations enabled by responding to the prompt:

    A LUN can be created with or without space reservations being enabled.

    Space reservation guarantees that data writes to that LUN will never fail.

Do you want the LUN to be space reserved? [y]: 

Caution
If you choose n, space reservation is disabled. This might cause write operations to the storage system to fail, which can cause data corruption. It is strongly recommended that you enable space reservations.

Specify the size of the LUN by responding to the next prompt:

    Size for a LUN is specified in bytes. You can use single-character

    multiplier suffixes: b(sectors), k(KB), m(MB), g(GB) or t(TB).

Enter LUN size: 

Example

5g

Result

A LUN with 5 GB of raw disk space is created if you accept the configuration information later in this program. The amount of disk space usable by the host varies, depending on the operating system type and the application using the LUN.

Create a comment or a brief description about the LUN by responding to the next prompt:

    You can add a comment string to describe the contents of the LUN.

    Please type a string (without quotes), or hit ENTER if you don't 

    want to supply a comment.

Enter comment string:

Example

5 GB Windows LUN for finance records

If you choose not to provide a comment at this time, you can add a comment later with the lun comment command or fill in the description field by using FilerView.

Create or use an igroup by responding to the next prompt:

    The LUN will be accessible to an initiator group. You can use an

    existing group name, or supply a new name to create a new initiator

    group. Enter `?' to see existing initiator group names.

Name of initiator group[win_host5_group1]: 

Result

If you have already created one or more igroups, you can enter ? to list them. The last igroup you used appears as the default. If you press Enter, that igroup is used.

If you have not created any igroups, enter a name of the igroup you want to create now. For information about naming an igroup, see The name of the igroup.

If you entered a new igroup name, specify which protocol will be used by the hosts in the igroup by responding to the next prompt:

Type of initiator group win_host5_group2 (FCP/iSCSI)[FCP]:

Example

iscsi

Result

The initiators in this igroup use the iSCSI protocol. Be sure to specify fcp or iscsi as needed.

If you specified an iSCSI igroup, add the iSCSI node names of the initiators that can access LUNs in the igroup by responding to the next prompt:

Enter comma separated nodenames:

Example

iqn.1991-05.com.microsoft:host5.domain.com

If you specified an FCP igroup, add the WWPNs of the hosts that will be in the igroup by responding to the next prompt:

Enter comma separated portnames: 

Example a

Enter ? to display initiators that are logged in to the storage system.

Result

The following output is an example of what is displayed:

Initiators connected on adapter 4a

Portname                             Group

10:00:00:00:c9:2b:cc:51

10:00:00:00:c9:2b:dd:62

10:00:00:00:c9:2b:ee:5d

Adapter 4b is running on behalf of the partner.

Initiators connected on adapter 5a:

      None connected.

Enter comma separated portnames: 

Example b

Enter a WWPN, for example, 10:00:00:00:c9:2b:cc:51.

Result

The initiator identified by this WWPN is added to the igroup that you specified in Step 7. You are prompted for more port names until you press Enter.

For information about how to determine which WWPN is associated with a host, see How hosts are identified.

If you entered a new igroup name, specify the operating system type that the initiators in the igroup use to access LUNs by responding to the next prompt:

The initiator group has an associated OS type. The following are 

currently supported: solaris, windows, hpux, aix, linux, netware, vmware or 
default.

OS type of initiator group "win_host5_group2"[windows]:

For information about specifying the ostype of an igroup, see About igroups.

Specify the LUN ID that the host will map to the LUN by responding to the next prompt:

    The LUN will be accessible to all the initiators in the 

    initiator group. Enter `?' to display LUNs already in use 

    by one or more initiators in group "win_host5_group2".

LUN ID at which initiator group "win_host5_group2" 

sees "/vol/finance/records" [0]:

Result

If you press Enter to accept the default, Data ONTAP issues the lowest valid unallocated LUN ID to map it to the initiator, starting with zero. Alternatively, you can enter any valid number. See the Host Attach Kit or Host Support Kit documentation, or host operating system documentation, for information about valid LUN ID numbers.

Note
It is recommended that you accept the default value for the LUN ID.

After you press Enter, the lun setup program displays the information you entered:

LUN Path                : /vol/finance/records

OS Type                 : windows

Size                    : 5g (5368709120)

Comment                 : 5 GB Windows LUN for finance records

Initiator Group         : win_host5_group2

Initiator Group Type    : iSCSI

Initiator Group Members : iqn.1991-05.com.microsoft:host5.domain.com

Mapped to LUN-ID        : 0

Commit the configuration information you entered by responding to the next prompt:

Do you want to accept this configuration? [y]

Result

If you press Enter, which is the default, the LUNs are mapped to the specified igroup. All changes are committed to the system, and Ctrl-C cannot undo these changes. The LUN is created and mapped. If you want to modify the LUN, its mapping, or any of its attributes, you need to use individual commands or FilerView.

Either continue creating LUNs or terminate the program by responding to the next prompt:

Do you want to create another LUN? [n]