Fibrechannel Utilities RPM
-----------------------------

The fibrechannel utilities RPM contains various user utilities
to manage the QLA driver or provide information on disks and
adapters that are in the system.

To install this RPM:

rpm -ivh fibreutils-<version>.ia64.rpm

To uninstall this RPM:

rpm -e fibreutils

Files contained within this RPM:

All the following user utilities are located in the
/opt/hp/hp_fibreutils directory:

scsi_info

shows inquiry information for a specific SCSI device

lssd

lists all sd* devices with instance, channel, bus, and LUN
information as well as SCSI product ID, firmware level and
FC port WWID information

lssg

list all sg* devices with instance, channel, bus and LUN
information as well as SCSI product ID, firmware level and
FC port WWID information

adapter_info

lists useful information about QLA adapters in the system

probe-luns

forces the SCSI midlayer module (scsi_mod.o) to rescan
LUNs 0-32 for targets attached to QLA FC adapters

hp_rescan

forces the QLA FC adapters and the SCSI midlayer (scsi_mod.o) to
rescan for LUNs on all adapters or a particular adapter instance

hp_system_info

gathers information on the current system and
packages it together in a compressed tar file

All these files have links into the /usr/sbin directory
so that they can be invoked anywhere.

Starting probe-luns at System Boot Time

There are some cases, specifically if a device is not in the
the SCSI blacklist or device list, where a probe has to be
forced at a specific host, channel, id, lun to find a LUN.
Running the probe-luns command at system boot can solve this
problem.  If you need to start probe-luns at system boot, the
appropriate code can be installed with the pbl_inst.sh script in the
/opt/hp/hp_fibreutils/pbl directory.  To install the probe-luns
startup code, execute the following commands:

	# cd /opt/hp/hp_fibreutils/pbl
	# ./pbl_inst.sh -i

To uninstall the probe-luns startup code, execute the following
command:

	# cd /opt/hp/hp_fibreutils/pbl
	# ./pbl_inst.sh -u

NOTE: If you are not having issues seeing your devices, do not
      run probe-luns at system boot!

The following QLogic EFI utilities are included with this RPM:

EFI Utility    1.35
EFI Driver     1.42
RISC Firmware  3.03.150

These utilties are used to

1. Change NVRAM settings on QLogic adapters from the EFI boot prompt.
2. Load a new version of the EFI driver onto the adapter cards so the ia64
   EFI firmware will recognize LUNs presented by QLogic adapters

The files are located:

for Red Hat distributions: /boot/efi/efi/qla2x00
for SuSE distributions: /boot/efi/qla2x00

The documentation for the EFI Utilities can be found in /opt/hp/hp_fiberutils.
