Configuring the HP-UX iSCSI initiator

A successful configuration of the HP-UX iSCSI initiator includes having an understanding of the HP requirements and following specific steps.

1. Add the path for the iscsiutil executable program and other iSCSI executable programs to the root path.

   # PATH=$PATH:/opt/iscsi/bin

   Note: Add the previous string to the /.profile file to avoid manually updating the PATH environment variable each time.
2. Display the iSCSI initiator name that was configured.

   #iscsiutil -l
   Initiator Name             : iqn.2001-04.com.hp.stor:svcio
   Initiator Alias            :
   Authentication Method      : None
   CHAP Method                : CHAP_UNI
   Initiator CHAP Name        :
   CHAP Secret                :
   NAS Hostname               :
   NAS Secret                 :
   Radius Server Hostname     :
   Header Digest              : None, CRC32C (default)
   Data Digest                : None, CRC32C (default)
   SLP Scope list for iSLPD   :

3. Change the iSCSI initiator name.

   iscsiutil -i -N <initiator name in iqn or eui format>

   Notes:

   1. Confirm the initiator name change by using the iscsiutil -l command.
   2. You must use standard iSCSI naming conventions; otherwise, HP-UX does not recognize the system hosts.
4. Add a discovery target with the iscsiutil -a -I <IP> command.

   # iscsiutil -a -I 192.168.1.149
   
   Target address "192.168.1.149:3260,1" has been successfully added.

   Note: HP-UX iSCSI software initiator does not support IPv6 addresses. Do not configure IPv6 addresses as a target IP.
5. Display the discovery targets by using the iscsiutil -p -D command.

   # iscsiutil -pD

   You see the following output:

   Discovery Target Information
   ----------------------------
   
   Target # 1
   ---------
           IP Address                : 192.168.1.149
           iSCSI TCP Port            : 3260
           iSCSI Portal Group Tag    : 1
   
     User Configured:
     ----------------
   
           Authenticaton Method      : None
           CHAP Method               : CHAP_UNI
           Initiator CHAP Name       :
           CHAP Secret               :
           Header Digest             : None, CRC32C (default)
           Data Digest               : None, CRC32C (default)

6. Discover the operational target devices and create device special files.

   # /usr/sbin/ioscan -NH 64000
   
   H/W Path                 Class        Description
   ==================================================
   64000/0x0                usbmsvbus    USB Mass Storage
   64000/0x0/0x0            escsi_ctlr   USB Mass Storage Virt Ctlr
   64000/0x0/0x0.0x0        tgtpath      usb target served by usb_ms_scsi driver
   64000/0x0/0x0.0x0.0x0    lunpath      LUN path for disk9
   64000/0x2                iscsi        iSCSI Virtual Root
   64000/0x2/0x0            escsi_ctlr   iSCSI Virtual Controller
   64000/0x2/0x0.0x10       tgtpath      iscsi target served by isvctlr driver
   64000/0x2/0x0.0x10.0x0   lunpath      LUN path for disk586
   64000/0xfa00             esvroot      Escsi virtual root
   64000/0xfa00/0x0         disk         HP      DG146BABCF
   64000/0xfa00/0x1         disk         HP      DG146BABCF
   64000/0xfa00/0x2         disk         HP      DG146BABCF
   64000/0xfa00/0x3         disk         HP      DG146BABCF
   64000/0xfa00/0x4         disk         TEAC    DVD-ROM DW-224EV
   64000/0xfa00/0xae        disk         IBM     2145

7. Display the operational targets by using the iscsiutil command.

   # iscsiutil -pO

   You see the following output:

   Operational Target Information
   ------------------------------
   Target # 1
   -----------
           Target Name              : iqn.1986-03.com.ibm:2145.LodestHP99.node1
           Target Alias             :
           No. of Target Addresses  : 1
   
   Target Address # 1
   -------------------
           IP Address               : 192.168.1.149
           iSCSI TCP Port           : 3260
           iSCSI Portal Group Tag   : 1
     User Configured:
     ----------------
           Authenticaton Method     : None
           CHAP Method              : CHAP_UNI
           Initiator CHAP Name      :
           CHAP Secret              :
           Header Digest            : None,CRC32C (default)
           Data Digest              : None,CRC32C (default)

8. Display all the LUNs that are exported by using the ioscan command.

   # ioscan -kfnC disk

   You see the following output:

   Class     I  H/W Path        Driver S/W State   H/W Type     Description
   =======================================================================
   disk      0  0/1/1/0.0.0.0.0  sdisk   CLAIMED     DEVICE       HP  DG146BABCF
                               /dev/dsk/c0t0d0   /dev/rdsk/c0t0d0
   disk      1  0/1/1/0.0.0.1.0  sdisk   CLAIMED     DEVICE       HP  DG146BABCF
                               /dev/dsk/c0t1d0   /dev/rdsk/c0t1d0
   disk      3  0/1/1/0.0.0.2.0  sdisk   CLAIMED     DEVICE       HP  DG146BABCF
                               /dev/dsk/c0t2d0   /dev/rdsk/c0t2d0
   disk      2  0/1/1/0.0.0.3.0  sdisk   CLAIMED     DEVICE       HP  DG146BABCF
   disk    485  255/0/16.0.0.0   sdisk   CLAIMED     DEVICE       IBM  2076
                               /dev/dsk/c15t0d0  /dev/rdsk/c15t0d0
   disk      8  255/1/0.0.0      sdisk   CLAIMED     DEVICE       TEAC DVD-ROM 
   DW-224EV /dev/dsk/c1t0d0    /dev/rdsk/c1t0d0

9. Check the disk information.

   diskinfo -v <disk>

10. Remove the iSCSI disk out-of-service logoff from the HP-UX iSCSI initiator.

    iscsiutil -d -I <ip>