ONTAP 9.14.1 commands

lun igroup add

Add initiators to an initiator group

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


This command adds initiators to an existing initiator group (igroup). You can add an initiator to an initiator group only if there are no LUN mapping conflicts. Mapping conflicts occur when an initiator is already paired with a LUN. If you attempt to run this command and there are LUN mapping conflicts, the command returns an error.

An initiator cannot be a member of two igroups of different OS types. For example, if you have an initiator that belongs to a Solaris igroup, the command does not allow you to add this initiator to an AIX igroup.

When you add FCP initiators, you can specify an alias instead of the initiator’s World Wide Port Name (WWPN) or the iSCSI Qualified name (IQN).


-vserver <Vserver Name> - Vserver Name

Specifies the Vserver.

-igroup <text> - Igroup Name

Specifies the initiator group to which you want to add a new initiator.

[-initiator <text>,…​] - Initiators

Specifies the initiator that you want to add. You can specify the WWPN, IQN, or alias of the initiator.

[-child-igroups <text>,…​] - Child Igroups

Specifies the child initiator groups you want to add. The initiator group inherits the initiators of any child igroups. An initiator group can have either initiators or child initiator groups, but not both simultaneously. Initiator groups can be nested to match host cluster hierarchies. If the host cluster then changes, initiators only need to be updated in the child igroups and the parent igroups inherit the changes.


cluster1::> lun igroup add -vserver vs1 -igroup ig1 -initiator iqn.1992-08.com.mv.mvinitiator

Adds the initiator iqn.1992-08.com.mv.mvinitiator to the initiator group ig1 on Vserver vs1.

Top of Page