lun igroup create

Create a new initiator group

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

Description

This command creates a new initiator group (igroup). Use igroups to control which hosts have access to specific LUNs. When you bind an igroup to a port set, a host in the igroup can access the LUNs only by connecting to the target ports in the port set.

When you create an igroup, you can add multiple existing initiators by specifying them in a list, separating them with commas. Later, you can add or remove initiators from the initiator group. Use the lun igroup add command to add initiators. Use the lun igroup remove command to remove an initiator. Unless the -initiator option is supplied, no initiators are added to a new igroup.

You can also bind a port set to an initiator when you create an initiator group. You can modify the port set binding of an initiator group by using the lun igroup bind command or the lun igroup unbind command.

The name you assign to an igroup is independent of the name of the host that is used by the host operating system, host files, or Domain Name Service (DNS). If you name an igroup aix1, for example, it is not mapped to the actual IP host name (DNS name) of the host.

Parameters

-vserver <Vserver Name> - Vserver Name
Specifies the Vserver.
-igroup <text> - Igroup Name
Specifies the name of the new initiator group. An initiator group name is a case-sensitive name that must contain one to 96 characters. Spaces are not allowed.
Note: It might be useful to provide meaningful names for igroups, ones that describe the hosts that can access the LUNs mapped to them.
{ [-protocol <protocol_enum>] - Protocol
Specifies if the initiator group protocol is fcp, iscsi, or mixed.
| [-fcp | -f [true]] - FCP
Specifies FCP as the protocol type of the new igroup.
| [-iscsi | -i [true]]} - iSCSI
Specifies iSCSI as the protocol type of the new igroup.
-ostype | -t {solaris|windows|hpux|aix|linux|netware|vmware|openvms|xen|hyper_v} - OS Type
Specifies the operating system type for the new initiator group. The operating system type indicates the type of host operating system used by all of the initiators in the igroup. All initiators in an igroup must be of the same operating system type. The operating system types of initiators are
  • solaris
  • windows
  • hpux
  • aix
  • linux
  • netware
  • vmware
  • openvms
  • xen
  • hyper_v
[-portset | -a <text>] - Portset Binding Igroup
Specifies that a port set is bound to the initiator.
-initiator <text>, ... - Initiators
Specifies the initiators that are attached to the new initiator group. By default, no initiators are added to the new igroup.

Examples

cluster1::> lun igroup create -vserver vs1 -igroup ig1 -protocol mixed -ostype linux -initiator iqn.2001-04.com.example:abc123