HP-UX iSCSI Software Initiator Support Guide, HP-UX 11i v1 and 11i v2, July 2005

Chapter 5

Management

The iscsiutil tool

The iscsiutil command is a management and diagnostic tool used with the iSCSI Software Initiator.

The iscsiutil tool provides a command line interface to:

— Configure the iSCSI Software Initiator related parameters.

— Display statistics for the interface driver, connection processing, session processing, and the discovery

sequence.

— Execute diagnostic functionality.

Device files are automatically created to access the iSCSI transport and interface drivers.

The device file to interface to the iSCSI transport driver is /dev/iscsi, which is created during installation.

The iSCSI transport driver defines iSCSI session management common to all iSCSI interface drivers.

The iSCSI transport driver defines interfaces with the SCSI services layer.

NOTE For a complete list of options supported by the iscsiutil tool, review the iscsiutil manpage

on an HP-UX system that has the iSCSI Software Initiator installed on it. From the command

line enter:

# man iscsiutil

iscsiutil Command Utilization

Most command sequences require root or super user permission.

NOTE The parameters enclosed within [ ] are optional. The parameters enclosed within < > are

mandatory.

Configuration with iscsiutil

To add an iSCSI discovery target IP address or a target portal group tag to the kernel registry, use:

# iscsiutil [/dev/iscsi] -a -I <ip-address> [-P <tcp-port>][-M <portal-grp-tag>]

The iSCSI target will be probed during ioscan processing using the static scanning technique described

in “Device Discovery” on page 25.

<ip-address> The ip_address specified can be an IPv4 formatted address or a DNS host name. The

bracketed [ ] parameters are optional.

<tcp-port> A TCP port may be specified for the iSCSI target. If no port is specified, the default iSCSI

port (3260) will be used.

<portal-grp-tag> The target portal group tag may be specified (a value from 0 to 65535 inclusive);

otherwise, a default value of 1 will be used.

To Delete an iSCSI discovery target IP address from the kernel registry, use: