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

Chapter 6

Troubleshooting

Troubleshooting the iSCSI Software Initiator Installation

If you have attempted to install the iSCSI Software Initiator, but you suspect there is a problem, first review

“Verifying the Installation” on page 35, to ensure the HP-UX iSCSI Software Initiator has been installed

successfully. If the HP-UX iSCSI Software Initiator installation has failed, follow the techniques below to

troubleshoot the issue.

1. Verify that the HP-UX system you are attempting to install the iSCSI Software Initiator on is running an

OS release that is supported by the iSCSI Software Initiator.

2. Review the HP-UX iSCSI Software Initiator Release Notes to obtain a list of required patches.

3. Review “Locating and Installing the iSCSI Software Initiator” on page 31, to ensure the iSCSI Software

Initiator has been successfully downloaded and the installation instructions have been followed.

4. If there is an issue with locating the iSCSI Software Initiator, or downloading it from the HP Software

Depot, see Software Depot frequently asked questions at:

http://www.software.hp.com/portal/swdepot/faqcategory.do

or contact SW Depot Customer Service at:

http://www.software.hp.com/portal/swdepot/feedback.do

for further assistance.

5. Review the logfile /var/adm/sw/swagent.log for errors encountered during the installation. Typical

causes of installation errors are:

— Lack of disk space on the "/" (root), "/var" (if /var is a separate file system) and "/stand" (boot) file

systems. Make sure the disk space estimated for the iSCSI Software Initiator (displayed in the

/var/adm/sw/swagent.log file) is available before retrying the installation.

— A solution for some errors may be suggested in the /var/adm/sw/swagent.log file. If so, follow those

instructions to rectify the problem.

6. If there are kernel build errors, ensure that the steps (1) and (2) above have been followed. One of the

causes for build failure is a lack of disk space in the "/stand" (boot) filesystem. Increase the disk space in

the "/stand" (boot) filesystem and retry the installation. If you still have build errors, contact HP

support for assistance.

7. Review the /etc/rc.log file and search for "HP-UX iSCSI" to find the output of the iSCSI start-up script:

/sbin/rc2.d/S532iscsi. Make sure there were no errors, while the iSCSI Software Initiator was

initializing, during system start-up. If the following errors are seen, the iSCSI Software Initiator

installation has not completed successfully:

iscsiutil: iSCSI stack is not loaded

iscsiutil: (/dev/iscsi) Wrong device file

iscsiutil: (/dev/isw) Wrong device file

8. Verify that the entries listed in “Kernel Build” on page 34, are present in the /stand/system file.

9. Verify that the files listed in “iSCSI Software Initiator Components” on page 32, are installed in the

correct directories on the HP-UX system.

10. Verify that there are no kernel build errors (see step 5 for details).

11. If the problem is still not resolved, try installing the iSCSI Software Initiator again.