|
APIs in Category: igroup |
API version 1.4 |
igroup-add |
| igroup-add | [top] |
Adds initiator to an existing initiator group.
Input Name Range Type Description initiator string
Initiator to add. initiator-group-name string
Name of initiator group.
Errno Description VDISK_ERROR_NO_SUCH_INITGROUP VDISK_ERROR_NOT_VALID_FC_WWN VDISK_ERROR_NOT_VALID_ISCSI_NAME VDISK_ERROR_INITGROUP_HAS_NODE VDISK_ERROR_LUN_MAPPING_CONFLICT VDISK_ERROR_INITGROUP_TOO_MANY_NODENAMES
| igroup-create | [top] |
Creates a new initiator group.
Input Name Range Type Description initiator-group-name string
Name of initiator group. initiator-group-type string
Type of the initiator group, currently only "iscsi" and "fcp" are supported. os-type string
optional
OS type of the initiators within the group. The type applies to all initiators within the group and governs the finer details of SCSI protocol interaction with these initiators. Valid arguments are "default", "solaris", "windows", "hpux", "aix" and "linux". If not specified, "default" is used.
Errno Description EINVALIDINPUTERROR VDISK_ERROR_INITGROUP_INVALID_ATTR_OS_TYPE_VALUE VDISK_ERROR_INITGROUP_EXISTS VDISK_ERROR_INITGROUP_MISSING_ARGS VDISK_ERROR_INITGROUP_INVALID_ATTR_TYPE
| igroup-destroy | [top] |
Destroys an existing initiator group. By default a group cannot be destroyed if there are existing lun maps defined for that group. This behaviour can be overridden with the use of force option set to "true" which will destroy the initiator group and any associated lun maps.
Input Name Range Type Description force boolean
optional
Forcibly destroy the initiator group, even if there are existing lun maps. Best practice is to attempt to unmap all the luns associated with a group before destroying it. initiator-group-name string
Name of initiator group.
Errno Description VDISK_ERROR_NO_SUCH_INITGROUP VDISK_ERROR_INITGROUP_MAPS_EXIST
| igroup-list-info | [top] |
Get information for initiator group(s).
Input Name Range Type Description initiator-group-name string
optional
Name of initiator group. If specified, only information for that group is returned. If not specified, information for all inititor groups are returned. Output Name Range Type Description initiator-groups initiator-group-info[]
List of initiator groups.
Errno Description VDISK_ERROR_NO_SUCH_INITGROUP
| igroup-lookup-lun | [top] |
Find the path to the lun mapped at a given lun-id for a given initiator group.
Input Name Range Type Description initiator-group-name string
Name of initiator group to search. lun-id integer
Lun-id (Logical Unit Number) to search for. Output Name Range Type Description path string
Path to the lun.
Errno Description VDISK_ERROR_NO_SUCH_INITGROUP VDISK_ERROR_NO_SUCH_LUNMAP
| igroup-remove | [top] |
Removes node(s) from an initiator group. The operation is prohibited if there are existing lun maps defined for that group. The force option set to "true" can be used to forcibly remove the node regardless of mappings.
Input Name Range Type Description force boolean
optional
Forcibly remove the initiator even if there are existing LUNs mapped to this initiator group. Best practice is to attempt to unmap all the luns associated with a group before removing the initiator. initiator string
Initiator to remove. initiator-group-name string
Name of initiator group.
Errno Description VDISK_ERROR_NO_SUCH_INITGROUP VDISK_ERROR_INITGROUP_MAPS_EXIST VDISK_ERROR_NOT_VALID_FC_WWN VDISK_ERROR_NOT_VALID_ISCSI_NAME VDISK_ERROR_NODE_NOT_IN_INITGROUP
| igroup-set-attribute | [top] |
Sets an attribute for an initiator group.
Input Name Range Type Description attribute string
Name of the attribute, Currently supported attributes are: use_partner ostype throttle_reserve throttle_borrow initiator-group-name string
Name of initiator group. value string
Value for the attribute. The valid values for "use_partner" are true or false The valid values for "ostype" are "default", "solaris", "windows", "hpux", "aix" and "linux". The valid values for "throttle_reserve" are 0-99 The valid values for "throttle_borrow" are true or false
Errno Description VDISK_ERROR_NO_SUCH_INITGROUP VDISK_ERROR_INITGROUP_MISSING_ARGS VDISK_ERROR_INITGROUP_INVALID_ATTR_TYPE VDISK_ERROR_IGROUP_NOT_THROTTLED VDISK_ERROR_IGROUP_ALREADY_THROTTLED VDISK_ERROR_THROTTLE_TOO_MUCH VDISK_ERROR_THROTTLE_BEING_DELETED VDISK_ERROR_NO_ISCSI_THROTTLES VDISK_ERROR_INITGROUP_INVALID_ATTR_MODE_VALUE VDISK_ERROR_INITGROUP_INVALID_ATTR_MODE_CONFIG
| Element definition: initiator-group-info | [top] |
Information about an initiator group.
Name Range Type Description initiator-group-name string
Name of this initiator group. initiator-group-os-type string
OS type of the initiator group Possible values:aix, default, hpux, linux, solaris, windows initiator-group-throttle-borrow boolean
Boolean value to indicate that the igroups throttle reserve may be exceeded if the igroup attempts to use more than it has reserved. initiator-group-throttle-reserve integer
Percentage of filer SCSI command blocks reserved for this initiator group's exclusive usage. initiator-group-type string
Type of the initiators in this group. Current supported types are "iscsi" and "fcp". initiators initiator-info[]
List of initiators belonging to this group. lun-id integer
LUN identifier to which the LUN is mapped at the host
| Element definition: initiator-info | [top] |
Information about one initiator.
Name Range Type Description initiator-group-use-partner boolean
optional
Boolean value to indicate if this initiator group is configured for its luns to require the use of host multi-pathing software for correct cluster failover operation. This value is optional and is only returned for FCP initiator groups on clustered filers. initiator-group-vsa-enabled boolean
Boolean value to indicate if this initiator group has VSA enabled or disabled. initiator-name string
Name of the initiator.