HP-UX iSCSI Software Initiator Support Guide (Edition 7)

6 Troubleshooting
This chapter contains information on:
• “Troubleshooting the iSCSI Software Initiator Installation” (page 32)
• “Troubleshooting Undetected Target Devices” (page 33)
• “Troubleshooting issues with iswd daemon” (page 34)
• “Diagnostics” (page 35)
6.1 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” (page 17), 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” (page 16), 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” (page 17), are present in the /stand/system
file.
32 Troubleshooting