Creating LUNs with the lun setup program

On the filer 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/linux) [image]:

Example

solaris

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

Specify the name of the LUN 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/vol1/ and want to create a LUN called lun0, you would enter, /vol/vol1/lun0.

Caution
Do not create LUNs in /vol/vol0. This is the root volume used for filer administration.

Result

lun0 is created in the root of /vol/vol1 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]: 

Example

Enter

Caution
If you choose n, space reservation is disabled. This might cause writes to the filer to fail, which can cause data corruption. NetApp strongly recommends 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 usable disk space 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

GB Solaris 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 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[]: 

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 will be 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.

Specify which protocol will be used by the hosts in the igroup by responding to the next prompt:

Type of initiator group solaris-igroup3 (FCP/iSCSI)[FCP]: 

Result

The initiators in this igroup use the FCP protocol.

Add the WWPNs of the hosts that will be in the igroup by responding to the next prompt:

    A Fibre Channel Protocol (FCP) initiator group is a collection of 

    initiator port names. Each port name (WWPN) is 16 hexadecimal digits,

    separated (only) by optional colon (:) characters. You can separate 

    port names by commas. Enter `?' to display a list of connected 

    initiators. Hit ENTER when you are done adding port names to this 

    group. 

Enter comma separated portnames: 

Example 1a

?

Result

The following output is a sample 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 1b

Enter a WWPN, for example, 10: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 Host.

Specify the operating system type 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, or default.

OS type of initiator group "solaris-igroup3" (default/solaris/windows) 
[default]:

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 "solaris-igroup3".

LUN ID at which initiator group "solaris-igroup3" sees "/vol/vol1/lun0" [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 HBA installation and setup guide for your host for information about valid LUN ID numbers.

Note
Network Appliance recommends 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/vol1/q0/lun0

OS Type                 : solaris

Size                    : 5g (5368709120)

Comment                 : 5 GB Solaris LUN for finance records

Initiator Group         : solaris-igroup3

Initiator Group Type    : FCP

Initiator Group Members : 10:00:00:00:c9:2b:cc:51

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 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]