Manual Pages


Table of Contents

NAME

portset - Commands for managing portsets

SYNOPSIS

portset command argument ...

DESCRIPTION

The portset family of commands manages the portsets. These commands can be used to create new portsets and to show, modify, or destroy existing ones.

Portsets are a collection of ports that can be associated with an igroup. Portsets are used to limit the ports that can be used by the initiators in the igroup to access a target lun. To associate/disassociate an igroup to/from a portset, use the igroup bind and igroup unbind commands.

USAGE

portset add portset_name port ...

Adds port(s) to an existing portset.

If the port string is specified in the nodename:slotletter format, then only that specific port will be added to the portset. The example mynode:9a shows this syntax. If the port string is specified by only the slotletter format, then both the local and partner ports will be added to the portset. The example 9a shows this syntax.

portset create { -f | -i } portset_name [ port ... ]

Creates a new portset.

If the -f option is given, an FCP portset is created. If the -i option is given, an iSCSI portset is created. NOTE: currently only FCP portsets are supported.

The maximum length of the portset_name string is 95 characters. All printable ASCII characters are permitted.

If no ports are supplied, then an empty portset will be created. The maximum length of the port string is 63 characters. If the port string is specified in the nodename:slotletter format, then only that specific port will be added when the portset is created. The example mynode:9a shows this syntax. If the port string is specified by only the slotletter format, then the port will be added from both the local and partner node when the portset is created. The example 9a shows this syntax.

portset destroy [ -f ] portset_name ...

Destroys existing portset(s). By default a portset cannot be destroyed if it is bound to an igroup. This behavior can be overridden with the use of -f option which will unbind the portset from the igroup and then destroy the portset.

portset help sub_command

Displays the help information for the given sub_command.

portset remove [ -f ] portset_name port ...

Removes port(s) from a portset.

The operation is prohibited if removing the port from the portset leaves the set empty while still bound to an igroup. The -f option can be used to force remove the port.

If the port string is specified in the nodename:slotletter format, then only that specific port will be removed from the portset. The example mynode:9a shows this syntax. If the port string is specified by only the slotletter format, then both the local and partner ports of that name will be removed from the portset. The example 9a shows this syntax.

portset show [ portset_name ]

Displays the ports in a portset. If no portset_name is specified, the members of all portsets are displayed.

SEE ALSO

na_igroup(1), na_fcp(1), na_iscsi(1), na_lun(1), na_san(1)


Table of Contents