August 8th, 2003.


Post install instructions

By default, the UNH iSCSI Initiator is started and immediately
looks for an iSCSI target to attach to. The following steps
are needed to configure the system after installation to 
attach to an iSCSI target.


Directory Structure overview.
----------------------------

The UNH iSCSI Package uses the following directories:


/opt/unh/iscsi/
                 bin		- Commands and utilities
                 logs		- Log files
                 modules	- Kernel modules (indexed by kernel version)
                 dev 		- Device files
                 conf		- Configuration files
                 src		- UNH iSCSI Source

                /etc/init.d/unh_iscsi  ( System startup script )

                /usr/share/doc/unh_iscsi<RPM_version>


CONFIGURATION
-------------


You may want to include /opt/unh/iscsi/bin in the root path.


File system setup
-----------------


At /opt/unh/iscsi/conf, there are two sample files: fstab.iscsi.sample and 
target.sample. 

The fstab.iscsi.sample indicates the format for iSCSI mount 
entries similar to fstab(5).

The target.sample is how to connect to a target iSCSI target.

For example, if you are connecting to a target whose nickname is TARGET_1,

* Copy target.sample to TARGET_1 and make necessary changes.

  - At the minimum, the following need to be defined by the user.
    --> Fully qualified Target name
    --> Fully qualified Initiator name
    --> Target IP Address
    --> Target Port Number

   For more details please refer to the target.sample script for
   documentation.

* Make it executable [chmod +x /opt/unh/iscsi/conf/TARGET_1 ]

* Copy the fstab.iscsi.sample to /opt/unh/iscsi/conf/fstab.iscsi 

* Edit /opt/unh/iscsi/conf/fstab.iscsi entries with the following format

  TARGET_1:<lun>:<part>

  Where <part> is a disk partition containing a file system,
  and <lun> in the lun (or SCSI ID ) of a SCSI disk.
  
* Restart the UNH iSCSI subsystem

  sh /etc/init.d/unh_iscsi restart

NOTE:
----
It is recommended that the user follow this method than using the
iscsi_config and iscsi_manage utilities directly.

DEVICE FILES
------------
The iscsi_config will create the following device entries..

/opt/unh/iscsi/dev/<target_no>/l<lun>p<part>

For example, a disk for target=0, lun=1 will have

/opt/unh/iscsi/dev/0/l0  l0p1 l0p2 l0p3 .... l0p15 entries. 

These files are created and removed by iscsi_config and the user 
SHOULD NOT tamper with these files. They represent physical
devices generally found at /dev/sd{X}<p>.


LOGS
----
To avoid verbose reporting of errors on the console, a log file will be
created with verbose error messages by the UNH startup/shutdown script,
/etc/init.d/unh_iscsi. The location of the file is,
/opt/unh/iscsi/logs/unh_iscsi_boot.log


Man Pages
---------
iscsi_manage(8) and iscsi_config(8) .