Managing igroups

Tasks to manage igroups

You can use the command-line interface or FilerView to

Create igroups
Destroy igroups
Add initiators (through their node names) to igroups
Remove initiators (through their node names) from igroups
Display all the initiators in an igroup
Set the operating system type (ostype) for an igroup

Creating an igroup

To create an igroup, complete the following step.

Step	Action
1	Enter the following command: *igroup create -i [-t ostype] initiator_group* [node_name ...]** `-i` indicates that it is an iSCSI igroup. `-t` ostype indicates the operating system of the host. The values are default, solaris, windows, hpux, aix, or linux. Use default if you are using another operating system. initiator_group is the name of the igroup you specify. node_name is an iSCSI node name. Example `igroup create -i -t windows win-group0 iqn.1991-05.com.microsoft:eng1` Result You created an igroup called win-group0 that contains the node name of the Windows host associated with that node name.

Step

Action

Enter the following command:

igroup create -i [-t ostype] initiator_group [node_name ...]

-i indicates that it is an iSCSI igroup.

-t ostype indicates the operating system of the host. The values are default, solaris, windows, hpux, aix, or linux. Use default if you are using another operating system.

initiator_group is the name of the igroup you specify.

node_name is an iSCSI node name.

Example

igroup create -i -t windows win-group0 iqn.1991-05.com.microsoft:eng1

Result

You created an igroup called win-group0 that contains the node name of the Windows host associated with that node name.

Destroying an igroup

To destroy one or more existing igroups, complete the following step.

Step	Action
1	If you want to...	Then enter this command...
	Remove LUNs mapped to an igroup before deleting the igroup	lun unmap lun-path igroup Example `lun unmap /vol/vol2/qtree/LUN10 win-group5`
	Delete one or more igroups	*igroup destroy `igroup` [igroup,...]* Example `igroup destroy win-group5`
	Remove all LUN maps for an igroup and delete the igroup with one command	*igroup destroy -f igroup* [igroup ...]** Example `igroup destroy -f win-group5`

Adding an initiator

To add an initiator to an igroup, complete the following step.

Step	Action
1	Enter the following command: igroup add igroup iscsi_nodename Caution When adding initiators to an igroup, ensure that each initiator sees, at most, one LUN at a given LUN ID. Example `igroup add win-group2 iqn.1991-05.com.microsoft:eng2` Result `You added the host associated with node name iqn.1991-05.com.microsoft:eng2 to the initiator group win-group2.`

Step

Action

Enter the following command:

igroup add igroup iscsi_nodename

Caution
When adding initiators to an igroup, ensure that each initiator sees, at most, one LUN at a given LUN ID.

Example

igroup add win-group2 iqn.1991-05.com.microsoft:eng2

Result

You added the host associated with node name iqn.1991-05.com.microsoft:eng2 to the initiator group win-group2.

Removing an initiator

To remove an initiator from an igroup, complete the following step.

Step	Action
1	Enter the following command: igroup remove igroup node_name Example `igroup remove win-group1 iqn.1991-05.com.microsoft:eng1`

Displaying initiators

To display all the initiators in the specified igroup, complete the following step.

Step	Action
1	Enter the following command: *igroup show [igroup]* Example `igroup show win-group3`

Setting the ostype

To set the operating system type (ostype) for an igroup to one of the values (default, solaris, windows, hpux, aix, or linux), complete the following step.

Step	Action
1	Enter the following command. igroup set igroup ostype Example `igroup set win-group3 windows`

Getting command- line syntax help

To get command-line syntax help, complete the following step.

Step	Action
1	Enter the following command: igroup help subcommand