HPlogo HP-UX iSCSI Software Initiator Support Guide: HP-UX 11i v1 & 11i v2 > Chapter 6 Troubleshooting

Troubleshooting the iSCSI Software Initiator Installation
» 

Technical documentation

Complete book in PDF

 » Table of Contents

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

If you have attempted to install the iSCSI Software Initiator, but you suspect there is a problem, first review “Verifying the Installation”, 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”, 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”, are present in the /stand/system file.

  9. Verify that the files listed in “iSCSI Software Initiator Components”, 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.



Chapter 6 Troubleshooting
  		 


Troubleshooting Undetected Target Devices