SANsurfer iSCSI HBA Manager User's Guide - QLogic

SANsurfer iSCSI HBA ManagerUser’s GuideManagement Tool forQLogic iSCSI Host Bus AdaptersIS0054602-00 B

SSANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersRemoved the following sections that were includedin rev. A of the user’s guide. Information from thesesections is now in the SANsurfer iSCSI HBA Managerhelp system:7. Setting Up Connections8. Monitoring the Connections9. Displaying Host, HBA Port, Device, and LUNInformation11. Updating the HBA10. Performing Diagnostics section expanded toinclude procedures for viewing IPv6 logs and settingdiagnostic test parameters for running loopbackand read/write buffer tests.12. Troubleshooting section expanded to include alist of troubleshooting tools, procedures for verifyingthat the HBA driver and iqlremote are installed,using debug to trace user interface and agentactivity, and retrieving records such as the HBAcore dump, Flash NVRAM, and HBA crash.Added Windows 2008 support to FAQ table.Moved Appendix C Contacting QLogic informationto 1 Introduction.Added index entries.—6 Performing Diagnostics7 TroubleshootingA Frequently Asked Questions“Technical Support” on page 1-4IndexIS0054602-00 BPage iii

SANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersSNotesPage ivIS0054602-00 B

Table of Contents1 IntroductionIntended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1What’s in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1Typographic Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3License Agreements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-42 SANsurfer iSCSI HBA Manager OverviewGeneral Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1Asset Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2Configuration Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3HBA State and Target Session Connection State Monitoring . . . . . . . 2-3Additional Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-33 System Requirements and Installation ChecklistInstallation Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1Step 1: Collect the Hardware and Software. . . . . . . . . . . . . . . . . . . . . 3-1Required Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1Required Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2Step 2: Install the Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2Step 3: Install the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2Step 4: Install and Run SANsurfer iSCSI HBA Manager . . . . . . . . . . . 3-3Remote Procedure Calls (RPCs) . . . . . . . . . . . . . . . . . . . . . . . . 3-3Step 5: Configure the Disks in the Operating System . . . . . . . . . . . . . 3-4IS0054602-00 BPage v

SANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersSSystem Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5Supported QLogic HBAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-64 Installing SANsurfer iSCSI HBA ManagerInitial Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1Installation Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2Installation Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3Step 1: Download the Installation . . . . . . . . . . . . . . . . . . . . . . . . 4-3Step 2: Start the Installation File . . . . . . . . . . . . . . . . . . . . . . . . . 4-4Step 3: Follow the Installation Wizard. . . . . . . . . . . . . . . . . . . . . 4-5Installation Instructions Using CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15Standalone Installer Command Lines . . . . . . . . . . . . . . . . . . . . . 4-15Web- and CD-based Installation Updates . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17Updating SANsurfer by Web Update. . . . . . . . . . . . . . . . . . . . . . . . . . 4-17Network Does Not Use Proxy Settings. . . . . . . . . . . . . . . . . . . . 4-18Network Requires Proxy Settings. . . . . . . . . . . . . . . . . . . . . . . . 4-18Updating SANsurfer by Package Update . . . . . . . . . . . . . . . . . . . . . . 4-21Uninstalling SANsurfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-245 Getting StartedStarting SANsurfer iSCSI HBA Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1Starting SANsurfer iSCSI HBA Manager on Windows . . . . . . . . . . . . 5-1Starting SANsurfer iSCSI HBA Manager on Linux or Solaris . . . . . . . 5-2SANsurfer iSCSI HBA Manager Main Window . . . . . . . . . . . . . . . . . . . . . . 5-3HBA Tree. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5Host Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5HBA Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5HBA Port Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6Device Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6LUN Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7Exiting SANsurfer iSCSI HBA Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7Viewing the Help System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8What’s in the Help System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9Specifying the Help Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9Viewing SANsurfer iSCSI HBA Manager Information . . . . . . . . . . . . . 5-10Page viIS0054602-00 B

ASANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersSetting Up SANsurfer iSCSI HBA Manager . . . . . . . . . . . . . . . . . . . . . . . . . 5-11Setting SANsurfer iSCSI HBA Manager Security . . . . . . . . . . . . . . . . 5-11Specifying Whether iSCSI Names or iSCSI Alias Names Appearin the HBA Tree. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14Setting the Options for Retrieving Host Status Alarms andRefreshing the Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15Specifying the Polling Intervals to Retrieve Host StatusAlarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16Specifying the HBA Polling Interval . . . . . . . . . . . . . . . . . . . . . . 5-17Specifying the Host Polling Interval . . . . . . . . . . . . . . . . . . . . . . 5-18Specifying Whether the Configuration Refreshes WhenHost and Target Status Alarms Occur . . . . . . . . . . . . . . . . . . . 5-19Specifying Whether the Host Refresh Prompt Appears . . . . . . . 5-20Refreshing the Configuration Immediately . . . . . . . . . . . . . . . . . 5-216 Performing DiagnosticsGeneral Information for the HBA Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2Pinging Targets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3Ping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3Pinging IPv4 and IPv6 Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4Viewing Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6Viewing the ARP Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6Viewing the Connection Error Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8Viewing the IPv6 Destination Cache Log . . . . . . . . . . . . . . . . . . . . . . 6-10Viewing the IPv6 Neighbor Cache Log . . . . . . . . . . . . . . . . . . . . . . . . 6-11Viewing the IPv6 Router List Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13Viewing the IPv6 Local Prefix List Log . . . . . . . . . . . . . . . . . . . . . . . . 6-14Setting Diagnostic Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16Running a Loopback Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16Running a Read/Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-18Tracing User and Agent Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-217 TroubleshootingTroubleshooting Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1Windows Event Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1SANsurfer iSCSI HBA Manager Tools. . . . . . . . . . . . . . . . . . . . . . . . . 7-2Troubleshooting Problems and Solutions. . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2Installation Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3User Interface and Remote Agent Issues . . . . . . . . . . . . . . . . . . . . . . 7-4Functional Issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9IS0054602-00 B Page vii

SANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersSVerifying That the HBA Driver is Installed . . . . . . . . . . . . . . . . . . . . . . . . . . 7-12Verifying That iqlremote is Installed and Running . . . . . . . . . . . . . . . . . . . . 7-13Using Debug to Trace User Interface and Agent Activity . . . . . . . . . . . . . . . 7-14Tracing User Interface Activity for Windows OS . . . . . . . . . . . . . . . . . 7-15Saving Agent Activity Logs for Windows OS. . . . . . . . . . . . . . . . . . . . 7-19Tracing User Interface Activity for UNIX OS . . . . . . . . . . . . . . . . . . . . 7-20Saving Agent Activity Logs for UNIX OS. . . . . . . . . . . . . . . . . . . . . . . 7-22Retrieving Records. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-22Retrieving the HBA Core Dump Record . . . . . . . . . . . . . . . . . . . . . . . 7-23Retrieving the Flash NVRAM Record . . . . . . . . . . . . . . . . . . . . . . . . . 7-26Retrieving the HBA Crash Record. . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-29AFrequently Asked QuestionsGlossaryIndexPage viiiIS0054602-00 B

SANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersS6-7 IPv6 Destination Cache Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-106-8 Neighbor Cache Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-126-9 IPv6 Router List Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-136-10 IPv6 Prefix List Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-156-11 Advanced Page (Diagnostics): Loopback Test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-176-12 Advanced Page (Diagnostics): Read/Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . 6-196-13 Diagnostics Options Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-217-1 Windows: Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-147-2 local.properties in Notepad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-167-3 Command Prompt Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-177-4 “Command Prompt” Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-187-5 Apply Properties to Shortcut Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-187-6 SANsurfer.exe in Console Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-197-7 local.properties in Notepad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-217-8 HBA Utilities Page (HBA Options) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-247-9 Save FW Coredump Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-257-10 HBA Utilities Page (HBA Options) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-277-11 Save FW Flash & NVRAM Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-287-12 HBA Utilities Page (HBA Options) for QLA4010x . . . . . . . . . . . . . . . . . . . . . . . . . . 7-307-13 Save Crash Record Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-31List of TablesTablePage1-1 Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-34-1 Configuration Option Installation Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27-1 Troubleshooting: Installation Issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-37-2 Troubleshooting: User Interface and Remote Agent Issues. . . . . . . . . . . . . . . . . . . 7-47-3 Troubleshooting: Functional Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9A-1 Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1Page xIS0054602-00 B

1 IntroductionThe SANsurfer iSCSI HBA Manager User’s Guide describes SANsurfer ® iSCSIHBA Manager, a component of the QLogic ® SANsurfer tool. SANsurfer iSCSIHBA Manager is a comprehensive tool for configuration and management ofQLogic SANsurfer iSCSI host bus adapters (HBAs) used in storage area networks(SANs).NOTE:Throughout this guide, HBA and adapter are used interchangeably, as arethe terms target and device.Intended AudienceThe information in this guide is intended for OEMs, field service personnel, andcustomers who are installing and using QLogic hardware and SANsurfer iSCSIHBA Manager. Users should be familiar with the hardware installation and theoperating systems where HBAs are installed.What’s in This GuideThis guide contains the basic information you need to get started with theSANsurfer iSCSI HBA Manager user interface (UI). For detailed information aboutthe features and functionality not covered in this guide, refer to the help system(see “What’s in the Help System” on page 5-9).This introductory section specifies the intended audience, explains thetypographic conventions used, lists related documents, refers you to the QLogiclicense agreements, and provides technical support and contact information.The remainder of the user's guide contains the following chapters and appendix:• 2 SANsurfer iSCSI HBA Manager Overview provides a general productoverview and describes in detail its features.• 3 System Requirements and Installation Checklist lists the hardware andsoftware requirements needed for optimum SANsurfer iSCSI HBA Managerperformance, and provides a checklist for installation.IS0054602-00 B 1-1

1 – IntroductionWhat’s in This GuideS• 4 Installing SANsurfer iSCSI HBA Manager describes how to install, update,and uninstall SANsurfer iSCSI HBA Manager.• 5 Getting Started describes how to customize SANsurfer iSCSI HBAManager. It includes starting and exiting the SANsurfer iSCSI HBA Manageruser interface, getting help, setting security, and setting the options thatactivate each time you start SANsurfer iSCSI HBA Manager.• 6 Performing Diagnostics provides procedures for pinging targets, viewingvarious logs, and setting up and running loopback and read/write buffertests.• 7 Troubleshooting presents common troubleshooting questions andanswers. It also provides the procedures for tracing the SANsurfer iSCSIHBA Manager user interface and agent activity (if directed to do so by yourauthorized service provider), and for retrieving records such as the HBAcore dump, Flash NVRAM, and HBA crash.• Appendix A Frequently Asked Questions lists and provides the answers tofrequently asked questions about SANsurfer iSCSI HBA Manager.• Glossary lists common hardware, software, and iSCSI terms that are used inSANsurfer iSCSI HBA Manager.In addition, at the end of this guide is an index to help you easily locate theinformation you need.Typographic ConventionsThis guide uses the following documentation conventions:NOTE:Notes provide additional information.CAUTION!Cautions indicate that failure to follow instructions might result in damage todata or equipment.• Text in blue font indicates a hyperlink (jump) to a figure, table, or section inthis guide, and links to Web sites are shown in underlined blue. Forexample:Table 9-2 lists problems related to the SANsurfer iSCSI HBA Manageruser interface and remote agent. See “Pinging Targets” on page 6-2.For more information, visit www.qlogic.com.1-2 IS0054602-00 B

A1 – IntroductionLicense Agreements• Text in bold font indicates SANsurfer iSCSI HBA Manager user interfaceelements such as a menu items, buttons, check boxes, or column headings.For example: Click the Start button, point to Programs, point to Accessories, andthen click Command Prompt. Under Notification Options, select the Warning Alarms check box.• Text in sans serif font indicates a file name, directory path, keyboard key,or command line text. For example: To connect to a group of hosts listed in a host group file (.hst), typeSANsurfer -g path and then press ENTER. Press CTRL+SHIFT+T.• Text in italics indicates emphasis, terms, document titles, or help topic titles.For example: For a complete listing of license agreements, refer to the QLogicSoftware End User License Agreement. For details, see Displaying HBA Information in the help system.Related DocumentsTable 1-1 lists other documents you may find helpful when installing or usingSANsurfer iSCSI HBA Manager.Table 1-1. Related DocumentsPart Numberor NameIS0054501-00Rev Creadme.txtRelease notesSN0054621-00Rev. ETitleQuick Start Guide: iSCSI HBA Installation (PDF).SANsurfer notes included with SANsurfer iSCSI HBA Manager.SANsurfer iSCSI HBA Manager Release Notes provide detailsabout modifications made since the previous version. Separaterelease notes are provided for each operating system.SANsurfer iSCSI HBA CLI User’s Guide provides interactive menuand non-interactive mode options for the command line interface.License AgreementsFor a complete listing of all license agreements affecting this product, refer to theQLogic Software End User License Agreement.IS0054602-00 B 1-3

1 – IntroductionTechnical SupportSTechnical SupportAvailabilityCustomers should contact their authorized maintenance provider for technicalsupport of their QLogic switch products. QLogic-direct customers may contactQLogic Technical Support; others will be redirected to their authorizedmaintenance provider.For the latest firmware and software updates, visit the QLogic support Web sitelisted in Contact Information.QLogic Technical Support for products under warranty is available during localstandard working hours, excluding QLogic Observed Holidays.TrainingQLogic offers certification training for the technical professional for both theQLogic iSCSI HBAs and switches. From the training link at www.qlogic.com, youmay choose Electronic-based Training or schedule an intensive “hands-on”Certification course.Technical Certification courses include installation, maintenance, andtroubleshooting QLogic SAN products. Upon demonstrating knowledge using liveequipment, QLogic awards a certificate identifying the student as a CertifiedProfessional. The training professionals at QLogic may be reached by e-mail attech.training@qlogic.com.Contact InformationPlease feel free to contact your QLogic approved reseller or QLogic TechnicalSupport at any phase of integration for assistance. QLogic Technical Support canbe reached by the following methods:Webhttp://support.qlogic.comNorth America Contact InformationE-mailsupport@qlogic.comPhone (952) 932-4040Support contact information for other regions of the world is available at theQLogic Web site: http://support.qlogic.comThe QLogic knowledge database contains troubleshooting information for theQLogic HBAs. Access the database from the QLogic Web site, www.qlogic.com.Click the Support tab, and then use the search engine at the top of the page tolook for specific troubleshooting information.1-4 IS0054602-00 B

2 SANsurfer iSCSI HBAManager OverviewThis section provides a general overview of the SANsurfer iSCSI HBA Managerproduct, and describes its features in detail.General OverviewFeaturesQLogic’s SANsurfer iSCSI HBA Manager is a user-based interface tool thatconfigures and manages both QLogic iSCSI host bus adapters and their attacheddevices within a storage area network (SAN) environment. In addition:• SANsurfer iSCSI HBA Manager works with the Windows ® 2000, WindowsServer 2003, Windows Server 2008, Windows Vista, Red Hat ® Linux ® , SLESLinux, and Solaris ® SPARC ® operating systems. Because the tool supportsmultiple operating systems, it provides control of heterogeneousenvironments.• SANsurfer iSCSI HBA Manager is a client/server tool. The networkingcapability of the tool provides centralized management and configuration ofthe entire SAN.SANsurfer iSCSI HBA Manager offers the features described in these sections:• “Asset Management” on page 2-2• “Configuration Management” on page 2-2• “Statistics” on page 2-3• “Diagnostics” on page 2-3• “HBA State and Target Session Connection State Monitoring” on page 2-3• “Additional Features” on page 2-3IS0054602-00 B 2-1

2 – SANsurfer iSCSI HBA Manager OverviewFeaturesSAsset ManagementSANsurfer iSCSI HBA Manager allows you to connect to and disconnect fromlocal and remote hosts. It provides information about connected hosts and theirattached QLogic iSCSI HBAs, including connected devices and LUNs. Additionalfeatures include:• HBA-level alias support for simple, user-friendly name identification.• Automatic iSCSI agent discovery.Configuration ManagementSANsurfer iSCSI HBA Manager allows you to configure local and remote systems.With SANsurfer iSCSI HBA Manager, you can:• Configure QLogic iSCSI HBAs, HBA ports, and attached iSCSI targets usinga configuration wizard.• Configure HBA port boot settings (BIOS and FCode) and boot targets,including acquiring boot targets via DHCP.• Clone all or parts of a pre-saved HBA configuration for HBA replacement,quick configuration duplication on multiple HBA ports across multiple hosts,or to ensure consistent configurations.• Save port network, boot, and target configuration settings without card reset.• Display LUN properties.• Update HBA firmware, driver, ROM, BIOS, and FCode.• Update BIOS boot targets.• Restore factory defaults, fully or selectively.• Update multiple HBA ports to a specific configuration at the same time.• Display target redirection information.• Ability to display and log into multiple Internet Storage Names Service(iSNS) target portals to the same target.• Ability to retrieve and display all discovered target portals from a SendTarget discovery.• Ability to easily duplicate target portal connections to a target for multipleconnections.• Ability to select which target portals to log into from a discovered targets listacquired from Send Target discovery and iSNS discovery.2-2 IS0054602-00 B

A2 – SANsurfer iSCSI HBA Manager OverviewFeaturesStatisticsDiagnosticsSANsurfer iSCSI HBA Manager provides statistics for each HBA. These statisticscan be collected automatically or on request, and can be reset at any time.SANsurfer iSCSI HBA Manager provides diagnostics that enable you to test theHBAs and connected devices. Use the SANsurfer iSCSI HBA Managerdiagnostics to:• Ping a target, which verifies that there is connectivity between an HBA portand a target.• View the address resolution protocol (ARP) cache, which keeps a record ofhost port connections with other hardware (such as targets) on the network.• View the connection error log, which lists the 100 latest connection errors foran HBA port.• Perform read/write buffer tests.• Perform internal and external loopback tests.• View the IPv6 logs for information and assistance with IPv6 configurations: Destination Cache Neighbor Cache Router List Prefix List• Retrieve HBA diagnostics information.HBA State and Target Session Connection State MonitoringSANsurfer iSCSI HBA Manager monitors connected QLogic iSCSI HBAs and theirtargets and informs you of their state. For HBAs, the state color indicates bad(red), unknown (blue), warning (yellow), or good (green).Additional FeaturesAdditional SANsurfer iSCSI HBA Manager features allow you to:• Save host configuration to a text file.• Save and load detailed host configuration of the iSCSI HBAs and connectedtargets to and from a binary file for later offline viewing.• Specify hexadecimal CHAP secrets.• View detailed host configuration differences of the iSCSI HBAs andconnected targets from a prior saved configuration.• View Vendor Private Data (VPD) on iSCSI HBAs for available data, ifprovided by the OEM/manufacturer.IS0054602-00 B 2-3

2 – SANsurfer iSCSI HBA Manager OverviewFeaturesS• Configure, test, check status, and diagnose connections to IPv6 iSCSItargets on IPv6 enabled HBA cards, for example the QLE406xC cards.• Automatically check for SANsurfer iSCSI HBA Manager updates.• Manually check for SANsurfer iSCSI HBA Manager updates.• Manage iSCSI and Fibre Channel HBAs and Fibre Channel switches. Eachtool appears on its own tab in the HBA tree.NOTE:IPv6 features, as well as some other features, are not available and appeardimmed if one of the following applies:• You are using inbox/ioctl module drivers with Red Hat 4 and 5 and SLES10. (To obtain the driver version string, use the modinfo qla4xxxcommand at the UNIX prompt. If you are using the inbox/ioctl moduledrivers, its version string contains a d.)• You do not have ACB (Alternate Control Block) support with the properhardware configuration, drivers, and firmware.You can access these features if you have the correct hardwareconfiguration and download the latest drivers and firmware from the QLogicWeb site.2-4 IS0054602-00 B

3 System Requirements andInstallation ChecklistSANsurfer iSCSI HBA Manager is a collection of device drivers and managementsoftware for controlling, configuring, and managing devices in a SAN environmentthat uses QLogic iSCSI HBAs. Use the following Installation Checklist to help youinstall all hardware and software properly and in the correct order. To see a list ofthe required hardware and software, refer to the “System Requirements” onpage 3-4.Installation ChecklistThis section describes the installation process step-by-step. Depending on thefeatures you require, your configuration may not require all steps.• Step 1: Collect the Hardware and Software• Step 2: Install the Hardware• Step 3: Install the Driver• Step 4: Install and Run SANsurfer iSCSI HBA Manager• Step 5: Configure the Disks in the Operating SystemStep 1: Collect the Hardware and SoftwareRequired HardwareCollect the required hardware and software as listed in these sections.Collect the required hardware (see also “Hardware Requirements” on page 3-4).In all cases, some combination of the following is required:• QLogic iSCSI.• HBA target devices such as disks, tape devices, RAID subsystems, iSCSIrouters, and so on.• Connectivity hardware such as cables, hubs, switches, and so on.IS0054602-00 B 3-1

3 – System Requirements and Installation ChecklistInstallation ChecklistSRequired SoftwareCollect the required software (see also “Software Requirements” on page 3-5):• QLogic iSCSI HBA drivers• SANsurfer iSCSI HBA Manager• QLogic Fast!UTIL, iSCSI HBA BIOS UtilityFor basic operation, you will need both of the following:• QLogic iSCSI HBA drivers• SANsurfer iSCSI HBA Manager or QLogic Fast!UTILTo discover and connect to iSCSI devices, you will need one of the following:• SANsurfer iSCSI HBA Manager• QLogic Fast!UTILSANsurfer iSCSI HBA Manager is a management utility that enables you to view,manage, and diagnose QLogic HBAs. SANsurfer iSCSI HBA Manager alsoconfigures QLogic iSCSI HBAs and target devices on the HBAs.Step 2: Install the HardwareRefer to hardware installation guides to install HBAs in host systems (see“Related Documents” on page 1-3). Cable target devices through the combinationof hubs and switches in your configuration.Verification: Before installing the device driver, verify the presence of HBAs atpower up using the QLogic Fast!UTIL utility.To access Fast!UTIL, type ALT+Q or CTRL+Q during power up.Fast!UTIL allows you to perform basic HBA configuration. Fast!UTIL can verifydevice connectivity.Step 3: Install the DriverRefer to the appropriate software installation guide (see “Related Documents” onpage 1-3) and readme.txt file to install a device driver on host systems.NOTE:• Some operating systems come from the operating system manufacturerwith a QLogic miniport device driver. To ensure support for the latestQLogic HBA and SANsurfer tool features, install the most current devicedriver. The most current device driver versions can be found at theQLogic Web site (www.qlogic.com).• Connections to iSCSI targets must be configured with SANsurfer iSCSIHBA Manager or QLogic Fast!UTIL in order for them to be visible to theoperating system.3-2 IS0054602-00 B

A3 – System Requirements and Installation ChecklistInstallation ChecklistVerification: Verify that the HBAs recognize target devices by using theoperating system device configuration utilities, or use SANsurfer iSCSI HBAManager to display target devices found on an HBA.• Windows: On supported Windows systems, use the computer managementutility to view which target devices are configured on which HBAs, and toview and format devices and LUNs that are found.• Linux: On supported Linux systems, open /var/log/messages to viewwhich target devices are configured on which HBAs. Entries are also createdfor each HBA recognized by the driver. Each entry contains informationabout target devices and LUNs that are found.• Solaris: On supported Solaris systems, open /var/adm/messages toview which target devices are configured on which HBAs.Step 4: Install and Run SANsurfer iSCSI HBA ManagerFor complete installation instructions, see section 4 Installing SANsurfer iSCSIHBA Manager.SANsurfer iSCSI HBA Manager runs as both a tool with standalone (non-agentmode) access to local system QLogic iSCSI HBAs and as a client/server tool. Theclient tool runs on a hardware platform that supports Java and agents runningon each system that has QLogic HBAs.If you are using SANsurfer iSCSI HBA Manager on a host system where HBAsare installed, install the SANsurfer iSCSI HBA Manager tool (the user interface) onthe local host. Installing the SANsurfer iSCSI HBA Manager agent on the localhost is optional.When it is installed on the local system, the agent is used instead of the non-agentmode.Remote Procedure Calls (RPCs)SANsurfer iSCSI HBA Manager, uses remote procedure calls (RPCs) as follows:• In Windows, the RPC service (ONC/RPC Portmapper) required bySANsurfer iSCSI HBA Manager is installed automatically.• In Linux, the appropriate RPC libraries must be installed by the Linuxdistribution. For information about installing RPC services before installingSANsurfer iSCSI HBA Manager, see the Linux distribution documentation.• In Solaris SPARC, the /usr/sbin/rpcbind process is required for RPCcommunication of the remote agent.IS0054602-00 B 3-3

3 – System Requirements and Installation ChecklistSystem RequirementsSStep 5: Configure the Disks in the Operating SystemWhen all hardware and configuration is complete for iSCSI subsystems, use theappropriate operating system utilities to enable devices, assign drive letters orlogical names, initialize file systems, and so on, for each device or LUN on thesystem.System RequirementsFor optimum performance, SANsurfer iSCSI HBA Manager requires the hardwareand software listed in this section:• “Hardware Requirements” on page 3-4• “Software Requirements” on page 3-5• “Supported QLogic HBAs” on page 3-6Hardware RequirementsThe minimum hardware requirements are as follows:• QLogic QLA4xxx iSCSI to PCI-X host bus adapters, see “Supported QLogicHBAs” on page 3-6.• Single-processor or multiprocessor server or workstation: Pentium ® III with 450 MHz or greater for Windows 2000, WindowsServer 2003, Windows Server 2008, Windows Vista, Red Hat Linux,SUSE Linux, or Solaris x86. Sun Ultra 60 for Solaris SPARC.• iSCSI devices, such as disks. SANsurfer iSCSI HBA Manager supportsmost iSCSI devices. For a complete list of devices, see the QLogic SANInteroperability Guide, which can be downloaded from the QLogic Web site(you will be asked to provide your e-mail address):http://connect.qlogic.com/interopguide/Interoperability.asp• 64 MB of physical RAM are required to run SANsurfer iSCSI HBA Manager;256 MB are recommended. Running with less memory can cause diskswapping, which severely effects performance.• Video card capable of 256 colors (16K colors recommended) and aminimum screen resolution of 1024 x 768 pixels are required.• Approximately 100 MB of disk space.• About 150 MB of disk space.3-4 IS0054602-00 B

A3 – System Requirements and Installation ChecklistSystem RequirementsSoftware RequirementsThe minimum software requirements and conditions are as follows:• One of the following operating systems: Windows 2000 Server or Advanced Server SP4+ (IA32) Windows 2000 Server or Advanced Server SP4+ (x64) Windows XP Professional (IA32) Windows XP Professional (x64) Windows Server 2003 Standard Edition or Enterprise Edition SP1(IA32) Windows Server 2003 Standard Edition or Enterprise Edition SP1(x64) Windows Server 2003 Standard Edition or Enterprise Edition, Release2 (IA32) Windows Server 2003 Standard Edition or Enterprise Edition, Release2 (x64) Windows Server 2008 Standard Edition or Enterprise Edition Windows Vista (IA32) Windows Vista (x64) RHEL 3.0, 4.0, 5.0 (IA32) RHEL 3.0, 4.0, 5.0 (x64) RHEL 4.0, 5.0 (PPC) SLES 9.0, 10.0 (IA32) SLES 9.0, 10.0 (x64) SLES 9.0, 10.0 (PPC) Solaris SPARC 9, 10 Solaris x86 9, 10 (IA32) Solaris x86 9, 10 (x64)• QLogic QLA4xxx drivers (such as QLA4010C drivers), as appropriate foryour HBA.• Common desktop environment (CDE) to run SANsurfer iSCSI HBA Manageruser interface on Solaris systems.• TCP/IP protocol for remote management on all systems. It is not required forlocal management.• Administrative privileges to install and to perform management functions.• Adobe ® Reader ® (version 2.1 or later) to view documentation.• To view the help system, Internet Explorer ® (version 6.0 or later), NetscapeCommunicator ® (version 8.1 or later), or Firefox ® (version 2.0 or later).IS0054602-00 B 3-5

3 – System Requirements and Installation ChecklistSystem RequirementsSNOTE:Use the Java runtime environment that is packaged with SANsurfer iSCSIHBA Manager.Supported QLogic HBAsThe QLogic iSCSI HBAs are collectively referred to as the QLA4xxx HBA, unlessotherwise noted. For a detailed list of supported QLogic HBAs, see the SANsurferHBA Support Matrix (Fibre Channel & iSCSI) on the SANsurfer CD-ROM.3-6 IS0054602-00 B

4 Installing SANsurfer iSCSIHBA ManagerInstalling SANsurfer iSCSI HBA Manager consists of installing the SANsurferiSCSI HBA Manager user interface, a platform-specific agent, and helpcomponents, as appropriate.NOTE:Before installing SANsurfer iSCSI HBA Manager, read and follow theinstructions in the documents listed in “Related Documents” on page 1-3, asapplicable.This section provides the following information:• “Initial Installation” on page 4-1• “Web- and CD-based Installation Updates” on page 4-17• “Uninstalling SANsurfer” on page 4-24Initial InstallationYou can install the SANsurfer tool (which includes SANsurfer iSCSI HBAManager) using the files from the QLogic Web site or from the SANsurferCD-ROM.The following information applies:• Install the same version of SANsurfer on all systems in the network.• Before installing SANsurfer, uninstall any previous versions of the SANsurfertool (for example, QMS 1.0 or QMS 2.0 (QMSJ)).• Installing and running SANsurfer Control iX and the SANsurfer iSCSI HBAManager user interface (interface only, not the agent) on the same system issupported. When using only the SANsurfer iSCSI HBA Manager userinterface, this system monitors QLA4xxx HBAs on remote systems on thesame network.IS0054602-00 B 4-1

4 – Installing SANsurfer iSCSI HBA ManagerInitial InstallationSThis section on initial installation includes the following information:• “Installation Configurations” on page 4-2• “Installation Instructions” on page 4-3• “Installation Instructions Using CLI” on page 4-15Installation ConfigurationsSANsurfer iSCSI HBA Manager supports both standalone and networkedconfigurations, as shown in Table 4-1. Install the software appropriate for yourconfiguration.Table 4-1. Configuration Option Installation RequirementsConfigurationSoftware RequirementsStandalone System:This system monitors QLA4xxx HBAs locally.• SANsurfer iSCSI HBA Manager user interface• Optionally, one of the following: SANsurfer iSCSI Windows Agent SANsurfer iSCSI Linux Agent SANsurfer iSCSI Solaris AgentNetworked System:This system monitors QLA4xxx HBAs locally andon remote systems on the same network.This system monitors QLA4xxx HBAs only onremote systems on the same network.The QLA4xxx HBAs on this system are remotelymonitored only from other systems on the samenetwork.• SANsurfer iSCSI HBA Manager user interface• Optionally, one of the following: SANsurfer iSCSI Windows Agent SANsurfer iSCSI Linux Agent SANsurfer iSCSI Solaris AgentNOTE: Remote systems must have an agentinstalled.SANsurfer iSCSI HBA Manager user interfaceOne of the following:• SANsurfer iSCSI Windows Agent• SANsurfer iSCSI Linux Agent• SANsurfer iSCSI Solaris Agent4-2 IS0054602-00 B

A4 – Installing SANsurfer iSCSI HBA ManagerInitial InstallationInstallation InstructionsNOTE:This section assumes that you may be installing all SANsurfer componentson any of the supported operating systems.The SANsurfer installer is a self-extracting program that installs the SANsurfertools, including SANsurfer iSCSI HBA Manager.Perform the following steps to install SANsurfer iSCSI HBA Manager on thissystem.Step 1: Download the InstallationTo start the installation, download the SANsurfer iSCSI HBA Manager installer.To download the Installer from the SANsurfer CD-ROM:1. On the CD-ROM home page, click the button that represents your operatingsystem.2. Accept the SANsurfer software license agreement by clicking I Accept.3. Select the link for your specific operating system.4. Click the Management Tools local link.5. Under Management Tools, select the SANsurfer iSCSI HBA Manager linkfor your platform.6. On the File Download Security dialog box, click Save to save the SANsurferiSCSI HBA Manager installer to a location on your hard drive.To download the Installer from the QLogic Web site:1. Open the QLogic home page (http://www.qlogic.com).2. Click the Downloads tab to open the Driver Downloads / Documentationpage.IS0054602-00 B 4-3

4 – Installing SANsurfer iSCSI HBA ManagerInitial InstallationS3. Go to the table under QLogic Models, as shown in Figure 4-1.Figure 4-1 QLogic Driver Downloads / Documentation Page4. Choose your download options as follows:a. In first column, select iSCSI HBAs.b. In the second column, select your HBA model number.c. In the third column, select your operating system type.d. Click Go.The download page for the selected HBA and operating system opens.5. In the Management Tools table under Name, click SANsurfer iSCSI HBAManager.6. Accept the End User Software License Agreement by clicking Agree.7. On the File Download–Security Warning dialog box, click Save to save theiSCSI HBA Manager installer to a location on your hard drive.Step 2: Start the Installation FileTo select and start the installation file:• For a supported Windows system, locate the folder where you downloadedthe installation file, and then double-click the.exe file.• For a supported Linux or Solaris system:1. Open a shell.2. Change to the directory where you downloaded the SANsurferinstallation file.4-4 IS0054602-00 B

A4 – Installing SANsurfer iSCSI HBA ManagerInitial Installation3. To ensure that the SANsurfer installer file is executable and to start theinstallation, type the following, and then press ENTER.Step 3: Follow the Installation Wizardsh ./.binTo use the installation wizard:When the installation wizard begins, the Introduction dialog box (Figure 4-2)opens.Figure 4-2 Installation Wizard: Introduction1. Read the introductory information, and then click Next.IS0054602-00 B 4-5

4 – Installing SANsurfer iSCSI HBA ManagerInitial InstallationSThe Important Information dialog box (Figure 4-3) opens.Figure 4-3 Installation Wizard: Important Information2. Read the important information, and then click Next.This same information is provided in the readme.txt file, that will beavailable following installation in the following locations: On supported Windows systems:Program Files\QLogic Corporation\SANsurferOn supported Linux and Solaris systems:opt/QLogic_Corporation/SANsurfer4-6 IS0054602-00 B

A4 – Installing SANsurfer iSCSI HBA ManagerInitial InstallationThe Choose Product Features dialog box (Figure 4-4) opens.Figure 4-4 Installation Wizard: Choose Product FeaturesNOTE:Except for the agents that are installed, the feature options are thesame for supported Windows, Linux, and Solaris systems.• Windows agents are installed on a supported Windows system.• Linux agents are installed on a supported Linux system.• Solaris agents are installed on a supported Solaris system.SANsurfer supports SANsurfer iSCSI HBA Manager and other tools.Install only the tools appropriate for your configuration. In addition,SANsurfer iSCSI HBA Manager supports both standalone and networkconfigurations (see “Installation Configurations” on page 4-2).3. Select one of the following pre-configured installation sets, and then clickNext:Select iSCSI GUI and Agent to install the SANsurfer iSCSI HBAManager user interface, including the iSCSI (Windows, Linux, orSolaris) agent.IS0054602-00 B 4-7

4 – Installing SANsurfer iSCSI HBA ManagerInitial InstallationS Select iSCSI GUI to install the SANsurfer iSCSI HBA Manager userinterface only. The manager agent is not installed. Select iSCSI Windows Agent to install only the SANsurfer iSCSI HBAManager agent for a supported Windows system. Select Custom to choose which components to install.4. If you selected Custom in the previous step, in the Choose ProductComponents dialog box (Figure 4-5), select the components you want toinstall, and then click Next.Figure 4-5 Installation Wizard: Choose Product Features4-8 IS0054602-00 B

A4 – Installing SANsurfer iSCSI HBA ManagerInitial InstallationThe Choose Install Folder dialog box (Figure 4-6) opens.Figure 4-6 Installation Wizard: Choose Install Folder5. Do one of the following: To accept the destination location shown in the dialog box(recommended), click Next.The default location for a Windows system is:C:\Program Files\QLogic Corporation\SANsurferThe default location for a Linux or Solaris system is:/opt/QLogic_Corporation/SANsurferTo select a different location:a. Click Choose and browse to the location of your choice. TheChoose Install Folder dialog box re-opens.b. Click Next.If you selected a different location and want to re-select the defaultlocation:a. Click Restore Default Folder.b. Click Next.IS0054602-00 B 4-9

4 – Installing SANsurfer iSCSI HBA ManagerInitial InstallationSIf a version of SANsurfer iSCSI HBA Manager already exists on the system,the Previous SANsurfer Install Detected dialog box (Figure 4-7) opens.Figure 4-7 Installation Wizard: Previous SANsurfer Install DetectedBecause the new version is not compatible with the older version, theinstallation procedure prompts you to uninstall the old version.6. To uninstall the old version of SANsurfer iSCSI HBA Manager:a. Exit the SANsurfer tool before proceeding.b. If you want to uninstall the previous install, click Yes. The previousversion is uninstalled. If the previously installed version resides in thesame directory as the currently selected directory, the previous versionis overwritten.c. If you do not want to uninstall the previous version, click No.NOTE:Installation of SANsurfer stops while the previous version isuninstalled. After the old version of the tool is removed, the installationcontinues.4-10 IS0054602-00 B

A4 – Installing SANsurfer iSCSI HBA ManagerInitial InstallationIf you are installing the SANsurfer iSCSI HBA Manager user interface on aWindows system, the Select Shortcut Profile dialog box (Figure 4-8) opens.Figure 4-8 Installation Wizard: Select Shortcut ProfileThe shortcut profile determines the type of user to which the shortcutsappear. Available shortcuts include:• The SANsurfer icon on the desktop (if you select it in Step 8).• QLogic Management Suite (SANsurfer and SANsurfer Uninstaller),which is accessible when you click the Start button and point toPrograms.7. To select the shortcut profile, click one of the following, and then click Next: All Users Profile if you want the tool shortcuts available to all users.Current Users Profile (default) if you want the tool shortcuts availableonly to the current user.IS0054602-00 B 4-11

4 – Installing SANsurfer iSCSI HBA ManagerInitial InstallationSIf you are installing the SANsurfer iSCSI HBA Manager user interface on aWindows system, the Create Desktop Icon Selection dialog box (Figure 4-9)opens.Figure 4-9 Installation Wizard: Create Desktop Icon Selection8. If you want the SANsurfer icon to appear on the desktop, select the CreateDesktop Icon check box (default), and then click Next.NOTE:If you select the Create Desktop Icon check box, the SANsurfer iconappears on the desktop for either the current user profile or all userprofiles, depending upon your selection in Step 7.4-12 IS0054602-00 B

A4 – Installing SANsurfer iSCSI HBA ManagerInitial InstallationThe Pre-Installation Summary dialog box (Figure 4-10) opens.Figure 4-10 Installation Wizard: Pre-Installation SummaryThe pre-installation summary shows you all the choices you made inprevious steps.9. Review the information. If you want to go back and change any settings,click Previous. When you are ready to continue, click Install.IS0054602-00 B 4-13

4 – Installing SANsurfer iSCSI HBA ManagerInitial InstallationSThe Installing SANsurfer dialog box (Figure 4-11) opens.Figure 4-11 Installation Wizard: Installing SANsurferVarious windows inform you that the installation is progressing.4-14 IS0054602-00 B

A4 – Installing SANsurfer iSCSI HBA ManagerInitial InstallationAfter the installation is complete, the Install Complete dialog box(Figure 4-12) opens.Figure 4-12 Installation Wizard: Install Complete10. To close the installation wizard, click Done.To customize SANsurfer iSCSI HBA Manager and set your securityparameters, see 5 Getting Started.Installation Instructions Using CLISANsurfer provides the ability to install the tool and its components as anunattended command line installation. Unattended installation is available with alldefault options. These commands are specific to the SANsurfer iSCSI HBAManager standalone package only, and do not apply to the combined packageswith FC (Fibre Channel) and switch components.Standalone Installer Command LinesThe generalized command for unattended command line installation is: -i silent –DSILENT_INSTALL_SET=""IS0054602-00 B 4-15

4 – Installing SANsurfer iSCSI HBA ManagerInitial InstallationSNOTES:• If you misspell the install set ID or if the installer program cannot find theinstall set, then the installer program installs the default install set, whichis the user interface plus the OS agent.• To change the destination folder, add the -D parameter to the commandlines as follows:-DUSER_INSTALL_DIR="d:\Apps\SANsurfer" ** you may needto escape the \ here \\ **• To prevent installation of the desktop icon, enter the following command:-DINSTALL_DESKTOP_ICON="false"The following are examples of the generalized command for specific operatingsystems.WindowsInstall SANsurfer iSCSI HBA Manager GUI only (HBA)—no agent:iSCSI_SANsurfer_5_xx_xx_windows_package.exe -i silent-DSILENT_INSTALL_SET="SB_iX"Install iSCSI GUI—and agent:iSCSI_SANsurfer_5_xx_xx_windows_package.exe -i silent-DSILENT_INSTALL_SET="SB_iX_WI_A"Install agent only:iSCSI_SANsurfer_5_xx_xx_windows_package.exe -i silent-DSILENT_INSTALL_SET="SBiX_WINA"LinuxInstall SANsurfer iSCSI HBA Manager GUI only (HBA)—no agent:iSCSI_SANsurfer_5_xx_xx_linux_x86.bin -i silent-DSILENT_INSTALL_SET="SB_iX"Install iSCSI GUI—and agent:iSCSI_SANsurfer_5_xx_xx_linux_x86.bin -i silent-DSILENT_INSTALL_SET="SB_iX_LX_A"Install agent only:iSCSI_SANsurfer_5_xx_xx_linux_x86.bin -i silent-DSILENT_INSTALL_SET="SBiX_LINA"4-16 IS0054602-00 B

A4 – Installing SANsurfer iSCSI HBA ManagerWeb- and CD-based Installation UpdatesSolarisInstall SANsurfer iSCSI HBA Manager GUI only (HBA)—no agent:iSCSI_SANsurfer_5_xx_xx_Solaris_x86.bin -i silent-DSILENT_INSTALL_SET="SB_iX"Install iSCSI GUI—and agentiSCSI_SANsurfer_5_xx_xx_Solaris_x86.bin -i silent-DSILENT_INSTALL_SET="SB_iX_SL_A"Install agent only:iSCSI_SANsurfer_5_xx_xx_Solaris_x86.bin -i silent-DSILENT_INSTALL_SET="SBiX_SOLA"Web- and CD-based Installation UpdatesTo always keep SANsurfer iSCSI HBA Manager up to date with the latest version,SANsurfer provides two possible ways to update an existing installation:• You can download and install an update directly from the Web. See“Updating SANsurfer by Web Update” on page 4-17.• You can browse to an existing update package on your hard drive or onsome form of external media; for example, a CD-ROM, DVD, or otherportable storage device. See “Updating SANsurfer by Package Update” onpage 4-21.Updating SANsurfer by Web UpdateObtain SANsurfer updates from the QLogic Web site or from service personnel.CAUTION!To avoid locked files during the update process, you must exit SANsurfer.To check for updates:1. On the SANsurfer iSCSI HBA Manager main window, open the Help menu,and then click Web Update.IS0054602-00 B 4-17

4 – Installing SANsurfer iSCSI HBA ManagerWeb- and CD-based Installation UpdatesSThe Select Update dialog box (Figure 4-13) opens.Figure 4-13 Update SANsurfer: Select Update Dialog Box2. Depending on whether or not your network requires proxy settings, followthe appropriate procedure.Network Does Not Use Proxy SettingsFollow these steps to update SANsurfer from the QLogic Web site when yournetwork does not use proxy settings to access the Internet.To update SANsurfer (network does not use proxy settings):1. On the Select Update dialog box (Figure 4-13), click From the QLogicwebsite.2. Clear the Specify Proxy Settings check box.3. Click Continue.4. If updates are available, the Update dialog box (Figure 4-15 on page 4-20)opens. Otherwise, a message box informs you that there are no updates.Network Requires Proxy SettingsFollow these steps to update SANsurfer from the QLogic Web site when yournetwork requires proxy settings to access the Internet.To update SANsurfer (network requires proxy settings):1. On the Select Update dialog box (Figure 4-13), click From the QLogic Website.2. Select the Specify Proxy Settings check box.3. Click Continue.4-18 IS0054602-00 B

A4 – Installing SANsurfer iSCSI HBA ManagerWeb- and CD-based Installation UpdatesThe Server Proxy Settings dialog box (Figure 4-14) opens.Figure 4-14 Update SANsurfer: Server Proxy Settings Dialog Box4. If you want the HTTP proxy setting to be detected automatically, leave thedialog box as is, and then click OK to continue.If you want to specify the server proxy settings, complete the following:a. Select the Use the following HTTP proxy setting check box.b. In the Address box, type the HTTP address.c. In the Port box, type the port ID of the proxy server.d. In the Login and Password boxes, type your login and password forthe proxy servers that require authentication.e. To continue, click OK. To exit the dialog box and return to the mainSANsurfer iSCSI HBA Manager window, click Cancel.IS0054602-00 B 4-19

4 – Installing SANsurfer iSCSI HBA ManagerWeb- and CD-based Installation UpdatesSWhen your computer accesses the Internet, the Update dialog box(Figure 4-15) appears.Figure 4-15 Update SANsurfer: Update Dialog BoxThe available update information includes:• Current Updates column lists product updates available for thecurrent tool version.• Selected Updates column lists product updates that you select forinstallation.5. To use the Update dialog box, select the current product update packages:• To select a package, select its entry under Current Updates, and thenclick Add>>. The update moves to the Selected Updates list.• To remove a package, select its entry under Selected Updates, andthen click

A4 – Installing SANsurfer iSCSI HBA ManagerWeb- and CD-based Installation Updates6. When you finish selecting the update packages and are ready to start thedownload and installation process, click Update. Follow the instructions toinstall the selected package. Or, to discontinue the update process and stopthe installation, click Cancel.Updating SANsurfer by Package UpdateYou can update SANsurfer iSCSI HBA Manager by browsing to an existing updatepackage on your hard drive or some form of external media, such as a CD-ROM,DVD, or portable storage device.CAUTION!To avoid locked files during the update process, you must exit SANsurfer.To update the existing tool:1. On the SANsurfer iSCSI HBA Manager main menu, click Help, and thenclick Web Update.The Select Update dialog box (Figure 4-16) opens.Figure 4-16 Update SANsurfer: Select Update Dialog Box2. To select a file, click Browse, and then click .IS0054602-00 B 4-21

4 – Installing SANsurfer iSCSI HBA ManagerWeb- and CD-based Installation UpdatesSThe Open dialog box (Figure 4-17) appears.Figure 4-17 Update SANsurfer: Open Dialog Box3. Select the SANsurfer iSCSI HBA Manager patch update fileweb_supported_update_iscsi_hba.txt, which can be located on alocal file system or on a CD, DVD, or portable storage device. To proceed,click Open. Or, to exit the Open dialog box and return to the Select Updatedialog box, click Cancel.4-22 IS0054602-00 B

A4 – Installing SANsurfer iSCSI HBA ManagerWeb- and CD-based Installation UpdatesAfter you open the patch update file, the Update dialog box (Figure 4-18)opens, showing available update information.Figure 4-18 Update SANsurfer: Update Dialog BoxThe available update information includes:• Current Updates column lists product updates available for thecurrent tool version.• Selected Updates column lists product updates that you select forinstallation.4. To use the Update dialog box, select the current product update packages:• To select a package, select its entry under Current Updates, and thenclick Add>>. The update moves to the Selected Updates list.• To remove a package, select its entry under Selected Updates, andthen click

4 – Installing SANsurfer iSCSI HBA ManagerUninstalling SANsurferS5. When you finish selecting the update packages and are ready to start thedownload and installation process, click Update. Follow the instructions toinstall the selected package. To discontinue the update process and stop theinstallation, click Cancel.Uninstalling SANsurferPerform the following steps to uninstall from this system either the entireSANsurfer management toolset, including SANsurfer iSCSI HBA Manager, orspecific features. Be sure to exit all SANsurfer tools before you uninstall anySANsurfer components.To uninstall SANsurfer iSCSI HBA Manager:1. To start the SANsurfer uninstaller from a Windows system, choose one ofthe following methods:• On the Windows Start menu, point to Programs, point to QLogicManagement Suite, and then click SANsurfer Uninstaller.• Use the Add/Remove Programs utility:a. On the Windows Start menu, point to Settings, and then clickControl Panel.b. Double-click the Add/Remove Programs icon to open theAdd/Remove Programs dialog box.4-24 IS0054602-00 B

A4 – Installing SANsurfer iSCSI HBA ManagerUninstalling SANsurferFigure 4-19 shows an example of the Add/Remove Programs utility forWindows.Figure 4-19 Uninstall SANsurfer: Add/Remove Programs Dialog Boxc. In the left column, click Change or Remove Programs (default).d. Under Currently Installed Programs, select SANsurfer x.x.e. Click Change/Remove.To start the SANsurfer uninstaller from a Red Hat/SLES or SolarisSPARC/x86 system, do one of the following, and then press ENTER.• On a Red Hat/SLES system, if /usr/local/bin is in the path, type:SANsurferUninstaller.• On a Solaris SPARC/x86 system, if /usr/bin is in the path, type:SANsurferUninstaller.• On a Red Hat/SLES or Solaris SPARC/x86 system, if none of theabove are in the path, change to the directory where SANsurfer isinstalled. The default location is:/opt/QLogic_Corporation/SANsurfer/UninstallDataIS0054602-00 B 4-25

4 – Installing SANsurfer iSCSI HBA ManagerUninstalling SANsurferSType the following:./SANsurferUninstallerThe Uninstall SANsurfer dialog box (Figure 4-20) opens.Figure 4-20 Uninstall SANsurfer: Uninstall SANsurfer2. To continue, click Next.4-26 IS0054602-00 B

A4 – Installing SANsurfer iSCSI HBA ManagerUninstalling SANsurferThe Uninstall Options dialog box (Figure 4-21) opens.Figure 4-21 Uninstall SANsurfer: Uninstall Options3. Choose whether to uninstall the entire SANsurfer tool or specific features,and then click Next:• Click Complete Uninstall to remove all features and components ofthe SANsurfer tool that were installed by InstallAnywhere. (Files andfolders created after the installation are not removed.)• Click Uninstall Specific Features to uninstall specific features of theSANsurfer tool that were installed by InstallAnywhere.IS0054602-00 B 4-27

4 – Installing SANsurfer iSCSI HBA ManagerUninstalling SANsurferSThe Choose Product Features dialog box (Figure 4-22) opens.Figure 4-22 Uninstall SANsurfer: Choose Product FeaturesThe dialog box differs, depending on whether you are using SANsurferiSCSI HBA Manager on a Windows, Linux, or Solaris system.4. Clear the check boxes for features that you want to uninstall. (Check boxesthat are selected remain installed.) Select from the following components (allcomponents may not appear and the order of components may vary).• For a Windows system: iSCSI GUI (SANsurfer iSCSI HBA Manager) Help iSCSI Windows Agent• For a Linux system: iSCSI GUI (SANsurfer iSCSI HBA Manager) Help iSCSI Linux Agent• For a Solaris system: iSCSI GUI (SANsurfer iSCSI HBA Manager) Help iSCSI Solaris Agent4-28 IS0054602-00 B

A4 – Installing SANsurfer iSCSI HBA ManagerUninstalling SANsurfer5. Click Uninstall.The Uninstall SANsurfer dialog box (Figure 4-23) lists the components thatare being uninstalled.Figure 4-23 Uninstall SANsurfer: Feature Removal In-progressA message box asks you to wait the while the uninstaller removes thecomponents.IS0054602-00 B 4-29

4 – Installing SANsurfer iSCSI HBA ManagerUninstalling SANsurferSThe Uninstall Complete dialog box (Figure 4-24) informs you that theuninstall is finished.Figure 4-24 Uninstall SANsurfer: Uninstall Complete6. To exit the installation wizard, click Done.7. If any components were not successfully uninstalled, manually removethem.Some files and directories remain after uninstalling SANsurfer. Thesecomponents must be deleted manually from the computer's hard disk whereSANsurfer was installed. The default locations are:• For Windows:Program Files\QLogic Corporation\SANsurfer• For Linux and Solaris:/opt/QLogic_Corporation/SANsurfer8. Reboot the system.4-30 IS0054602-00 B

5 Getting StartedThis section includes the procedures for starting and exiting the SANsurfer iSCSIHBA Manager user interface, and customizing the tool options and policies. Itprovides information on:• “Starting SANsurfer iSCSI HBA Manager” on page 5-1• “SANsurfer iSCSI HBA Manager Main Window” on page 5-3• “Exiting SANsurfer iSCSI HBA Manager” on page 5-7• “Getting Help” on page 5-7• “Setting Up SANsurfer iSCSI HBA Manager” on page 5-11Starting SANsurfer iSCSI HBA ManagerThe SANsurfer iSCSI HBA Manager user interface startup procedures differdepending upon the operating system. This section tells you how to startSANsurfer iSCSI HBA Manager on the following systems:• For Windows 2000, Windows Server 2003, Windows Server 2008, WindowsXP, and Windows Vista, see page 5-1• For Red Hat/SLES Linux and Solaris SPARC, see page 5-2Starting SANsurfer iSCSI HBA Manager on WindowsSupported Windows operating system versions include Windows 2000, WindowsServer 2003, Windows Server 2008, Windows XP, and Windows Vista.To start SANsurfer iSCSI HBA Manager on Windows:Do one of the following:• Double-click the SANsurfer icon on your desktop (if the icon was createdduring installation).Figure 5-1 SANsurfer Desktop IconIS0054602-00 B 5-1

5 – Getting StartedStarting SANsurfer iSCSI HBA ManagerS• Click the Start button, point to Programs, point to QLogic ManagementSuite, and then click SANsurfer.• Click the Start button, click Run, and then do one of the following:Type in the SANsurfer program file name (SANsurfer.EXE),including all the paths, and then click OK. Click Browse, find and select the program in the Browse dialog box,and then click Open.After the SANsurfer user interface opens, click the iSCSI HBA tab to select theSANsurfer iSCSI HBA Manager tool. (For details about the contents of the mainwindow, see “SANsurfer iSCSI HBA Manager Main Window” on page 5-3.)For information about connecting to hosts, see Setting Up Connections:Connecting to Hosts in the help system.Starting SANsurfer iSCSI HBA Manager on Linux or SolarisSupported Linux operating system versions include Red Hat and SLES;supported Solaris operating system versions include SPARC/x86.To start SANsurfer iSCSI HBA Manager on Linux or Solaris:1. Ensure that you are in a graphical user environment.2. Open a command terminal.3. On a Red Hat/SLES system, if /usr/local/bin is in the path, typeSANsurfer, and then press ENTER:On a Solaris SPARC system, if /usr/bin is in the path, type SANsurfer,and then press ENTER.4. If neither of the preceding are in the path for a Red Hat/SLES Linux orSolaris SPARC/x86 system:a. Change to the directory where SANsurfer is installed. The defaultlocation is: /opt/QLogic_Corporation/SANsurfer.b. Type ./SANsurfer, and then press ENTER.5. After the SANsurfer user interface opens, click the iSCSI HBA tab to selectthe SANsurfer iSCSI HBA Manager tool. (For details about the contents ofthe main window, see “SANsurfer iSCSI HBA Manager Main Window” onpage 5-3.)For information about connecting to hosts, see Setting Up Connections:Connecting to Hosts in the help system.5-2 IS0054602-00 B

A5 – Getting StartedSANsurfer iSCSI HBA Manager Main WindowSANsurfer iSCSI HBA Manager Main WindowThe HBA Manager supports the following tools:• The iSCSI HBA tab opens SANsurfer iSCSI HBA Manager.• The FC HBA tab opens SANsurfer FC (Fibre Channel) HBA Manager.• The Switch tab opens SANsurfer Switch Manager.A tab appears only when the specific SANsurfer tool is installed on the system.The title bar identifies the currently-active tool.To view the SANsurfer iSCSI HBA Manager main window, go to the left pane(system tree pane) of the SANsurfer window, and then click the iSCSI HBA tab.The title bar shows SANsurfer iSCSI HBA Manager.After you connect to hosts (see the Connecting to Hosts topics in the helpsystem), the SANsurfer iSCSI HBA Manager main window (Figure 5-2) opens.IS0054602-00 B 5-3

5 – Getting StartedSANsurfer iSCSI HBA Manager Main WindowSTool Tab Title Bar Menu Bar ToolbarTabbed PagesContent PaneHBA TreeSystem TreePaneStatus BarFigure 5-2 SANsurfer iSCSI HBA Manager Main WindowThe window contains the following components:• The title bar identifies the currently active tool selected by the tool tab.• Tool tabs activate a specific tool (iSCSI HBA Manager, FC HBA Manager, orSwitch Manager).• The menu bar contains the commands for using SANsurfer iSCSI HBAManager.• The toolbar contains buttons for commonly-used functions for SANsurferiSCSI HBA Manager.5-4 IS0054602-00 B

A5 – Getting StartedSANsurfer iSCSI HBA Manager Main WindowHBA TreeHost Icons and Text• The HBA tree in the system tree pane shows the presence and status ofhosts, HBAs, and devices. For details, see “HBA Tree” on page 5-5.• Tabbed pages in the content pane contain settings for similar kinds ofoperations.• The status bar shows informative messages about system operations. Forexample, if you change the HBA port configuration and then click SaveHBA, the status bar flashes “Current Operation: Saving Configuration” untilthe save is complete.The HBA tree, in the left pane (system tree pane) of the SANsurfer window, showsthe hosts with their connected HBAs, HBA ports, devices, and LUNs.• When you select an item in the HBA tree, the status bar shows the sameinformation.• If an HBA is connected to a target, click the HBA to list all the devicesconnected to it. Devices are listed by their target iSCSI name or target iSCSIalias name.Additionally, each target may have LUNs connected to it. If a target is connectedto a LUN, click the target to list all the connected LUNs.The HBA tree contains the following visual indicators:• Host Icons and Text• HBA Icons and Text• HBA Port Icons and Text• Device Icons and Text• LUN Icons and TextThe HBA tree shows the host name or IP address.Example:hostname 10.3.13.90The host icon is:Live (online) host – The blinking heart on the host icon indicates that theconnection between the user interface and the agent is active for this host.HBA Icons and TextThe HBA tree shows HBA instance number: HBA Model number: HBA Status.IS0054602-00 B 5-5

5 – Getting StartedSANsurfer iSCSI HBA Manager Main WindowSThe HBA icons are:GoodWarningUnknownBadHBA Port Icons and TextThe HBA tree shows:• Either the HBA port iSCSI name or HBA port iSCSI alias name (see“Specifying Whether iSCSI Names or iSCSI Alias Names Appear in the HBATree” on page 5-14).• HBA port state shows either Link Down, Unknown, Warning, or Good.For information about the HBA port state referenced in the dialog boxes and itscorrespondence with the HBA icons, see the help topic, Monitoring the HBA PortState.Examples:Port 0: iqn.2000-04.com.qlogic:qla4010.fs10352a00378 AdapterPortSvr_1_HBA_5The HBA Port icons are:GoodVirtualWarningLink DownUnknownDevice Icons and TextThe HBA tree shows information about devices such as:• Target iSCSI name or target iSCSI alias name• Target state indicating the session connection status of the devices:bad/failed, unknown/no active, good.5-6 IS0054602-00 B

A5 – Getting StartedExiting SANsurfer iSCSI HBA ManagerFor information about the target state referenced in the dialog boxes and itscorrespondence with the device icons, see the help topic, Monitoring the TargetState.Examples:Device (ipn.qlogic.3.0)Device (target_3_0)The device icons are:Device good session connectionDevice unknown/no active session connectionDevice bad/failed session connectionLUN Icons and TextThe HBA tree shows the LUN number (LUN n).Example:LUN (LUN 1)The LUN icon is:LUNExiting SANsurfer iSCSI HBA ManagerGetting HelpTo exit SANsurfer iSCSI HBA Manager, do one of the following:• On the SANsurfer iSCSI HBA Manager main window, open the File menuand click Exit.• Click the Close button in the upper right corner of the window.This section provides information about:• “Viewing the Help System” on page 5-8• “Specifying the Help Browser” on page 5-9• “Viewing SANsurfer iSCSI HBA Manager Information” on page 5-10IS0054602-00 B 5-7

5 – Getting StartedGetting HelpSViewing the Help SystemThe SANsurfer iSCSI HBA Manager help system provides quick access toinformation about performing tasks and completing dialog boxes. To view the helpsystem from the SANsurfer iSCSI HBA Manager main window, open the Helpmenu and click Browse Contents, or press the F1 key. Figure 5-3 shows anexample of the initial help window in Internet Explorer.Figure 5-3 Help Window ExampleIf the help window does not open, you may need to set the browser location (see“Specifying the Help Browser” on page 5-9). Note that this help system appearsbest using the Internet Explorer browser.The help system’s left pane contains the following tabs:• Click the Contents button to show a structured presentation of Help topics.In Contents view, the following icons are associated with topics: A book icon indicates a major grouping containing subordinatetopics. Click a book icon to “open” the booktopics that belong to that group. A topic icon indicates a Help topic.and see individual5-8 IS0054602-00 B

A5 – Getting StartedGetting Help• Click the Index button to show an alphabetic listing of keywords associatedwith the help topics. Scroll through the listing to find keywords, and thenchoose from one or more topics associated with that keyword.• Click the Search button to quickly find a topic containing one or more words.To begin your search, click the first letter of the word you want to find.What’s in the Help SystemThe SANsurfer iSCSI HBA Manager help system contains the followinginformation:• Setting Up Connections provides procedures for connecting to hosts,configuring iSCSI HBAs, and configuring connected devices.• Monitoring the Connections explains how SANsurfer iSCSI HBA Managermonitors connected HBAs and their targets and informs you of their state.• Displaying Host, HBA, HBA Port, Device, and LUN Information coversviewing information about hosts, HBAs, HBA ports, devices, and LUNs.• Updating the HBA covers updating the HBA firmware, driver, ROM, andBIOS.Specifying the Help BrowserFollow these steps to specify the Web browser (Internet Explorer or Firefox, forexample) that SANsurfer iSCSI HBA Manager launches when you open the helpsystem (see “Viewing the Help System” on page 5-8):To specify a browser:1. On the SANsurfer iSCSI HBA Manager main window, open the Help menu,and then click Set Browser Location. The Browser Location dialog boxopens (Figure 5-4).Figure 5-4 Browser Location Dialog Box2. In the Browser Location box, type the location of the browser program file.Be sure to specify the path and file name.IS0054602-00 B 5-9

5 – Getting StartedGetting HelpSIf you do not know the location, click Browse to open a file selection dialogbox and select the browser program file. The Browser Location dialog boxshows the new browser path and file name.3. When you finish choosing your browser, do one of the following:• To save the browser location to the SANsurfer iSCSI HBA Managerconfiguration file, click OK.• To close the Browser Location dialog box without making changes,click Cancel.Viewing SANsurfer iSCSI HBA Manager InformationThe About box shows the product version number and QLogic copyrightinformation.To view information about SANsurfer iSCSI HBA Manager:1. On the SANsurfer iSCSI HBA Manager main window Help menu, clickAbout.The About SANsurfer iSCSI HBA Manager window opens (Figure 5-5).Figure 5-5 About SANsurfer iSCSI HBA Manager Window5-10 IS0054602-00 B

A5 – Getting StartedSetting Up SANsurfer iSCSI HBA ManagerThis window provides the following information:• High Availability Edition version number.• Copyright information.2. To close the About window and return to the SANsurfer iSCSI HBA Managermain window, click OK.Setting Up SANsurfer iSCSI HBA ManagerSome of the basic set up you may want to perform for SANsurfer iSCSI HBAManager includes the following:• “Setting SANsurfer iSCSI HBA Manager Security” on page 5-11• “Specifying Whether iSCSI Names or iSCSI Alias Names Appear in the HBATree” on page 5-14• “Setting the Options for Retrieving Host Status Alarms and Refreshing theConfiguration” on page 5-15 includes information about:“Specifying the Polling Intervals to Retrieve Host Status Alarms” onpage 5-16 “Specifying Whether the Configuration Refreshes When Host andTarget Status Alarms Occur” on page 5-19 “Specifying Whether the Host Refresh Prompt Appears” on page 5-20 “Refreshing the Configuration Immediately” on page 5-21Setting SANsurfer iSCSI HBA Manager SecuritySANsurfer iSCSI HBA Manager security ensures that HBA configuration changesrequire password authorization. SANsurfer iSCSI HBA Manager prompts for thepassword any time you click Save to change the following HBA configuration:• HBA driver• HBA firmware• HBA BIOS• HBA ROM• HBA port configuration• Target configuration• Target authentication (CHAP)• Password (when you want it changed)You can change the SANsurfer iSCSI HBA Manager access password for anyhost connected to your system for which you have administrator or root privileges.IS0054602-00 B 5-11

5 – Getting StartedSetting Up SANsurfer iSCSI HBA ManagerSWindows 2000/Windows Server 2003. The login name (username) mustbe attached to an account that the agent is running on and that must be in theadministrator group.Red Hat/SLES Linux and Solaris SPARC. The login name (user name)must be attached to an account that the agent is running on and that must be inthe adm or root group.NOTES:• The default SANsurfer iSCSI HBA Manager access password is config.To ensure that security is not compromised, change this password afterinstallation.• The HBA ROM password differs and cannot be modified using theseprocedures.To set the access password for a host:1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select thehost.2. Click the Security tab.5-12 IS0054602-00 B

A5 – Getting StartedSetting Up SANsurfer iSCSI HBA ManagerThe Security page (Figure 5-6) opens, and the host name appears at the topof the page.Figure 5-6 Security Page (Host)3. Under Host Access are the system login and password that you use toaccess the machine. To verify that you have administrator or root privilegesfor the selected host:a. In the Login box, type your login name.b. In the Password box, type your login password for the login name.4. Under Application Access, you can change your password. To modify theSANsurfer iSCSI HBA Manager access password:a. In the Current Password box, type the current password.b. In the New Password box, type the new password.c. In the Verify New Password box, confirm the new password by typingit again.5. To update the tool access password, click Apply. To clear the typed entriesin the Security page text boxes, click Clear Fields.IS0054602-00 B 5-13

5 – Getting StartedSetting Up SANsurfer iSCSI HBA ManagerSSpecifying Whether iSCSI Names or iSCSI Alias NamesAppear in the HBA TreeYou can specify whether the iSCSI name or the iSCSI alias name appears in theHBA tree. After you specify whether the iSCSI name or the iSCSI alias name isshown, your selection becomes the default. You can set the default from the HBAtree or from the Options dialog box.In Figure 5-7, the sample HBA tree on the left shows HBA iSCSI names and targetiSCSI names. The sample HBA tree on the right shows HBA port iSCSI aliasnames and target iSCSI alias names.HBA Tree withHBA iSCSI Namesand TargetiSCSI NamesHBA Tree withHBA Port iSCSIAlias Names andTarget iSCSIAlias NamesFigure 5-7 HBA Tree Naming ExamplesTo set the iSCSI name default from the HBA tree:1. To set the default iSCSI name or iSCSI alias name to appear in the HBAtree, right-click in the HBA tree to open a shortcut menu.2. Depending on what is currently set, the last shortcut menu option togglesbetween Tree Naming: iSCSI Name and Tree Naming: iSCSI Alias: If the HBA and target iSCSI names currently appear in the HBA tree,the menu shows Tree Naming: iSCSI Alias. Click Tree Naming:iSCSI Alias to show the iSCSI alias names. If the HBA and target iSCSI alias names appear in the HBA tree, themenu shows Tree Naming: iSCSI Name. Click Tree Naming: iSCSIName to show the iSCSI names.To set the iSCSI name default from the Preferences dialog box:1. On the Settings menu, click Application Options.5-14 IS0054602-00 B

A5 – Getting StartedSetting Up SANsurfer iSCSI HBA ManagerThe Application Options dialog box (Figure 5-8) opens.Figure 5-8 Application Options: Tree View Naming Preference2. Under Tree Viewing Naming Preference, select one of the following TreeNaming options:Click Alias if you want the HBA port and target iSCSI alias names toshow in the tree. Click Name if you want the HBA port and target iSCSI names to showin the tree.3. To save your changes, click OK. To close this dialog box without making anychanges, click Cancel.For information about configuring HBA port iSCSI names and HBA port iSCSIalias names, see the help topic, Configuring the HBA Port iSCSI Name and PortAlias Name.For information about target iSCSI names and target iSCSI alias names, see thehelp topic, Configuring Targets.Setting the Options for Retrieving Host Status Alarms andRefreshing the ConfigurationPolling intervals determine how frequently the SANsurfer iSCSI HBA Managermonitors the connected HBAs (and their targets) and updates the iSCSI HBAManager interface configuration based on their state. The iSCSI HBA Managerallows you to:IS0054602-00 B 5-15

5 – Getting StartedSetting Up SANsurfer iSCSI HBA ManagerS• Set the HBA polling and host polling intervals to retrieve host status alarms(see “Specifying the Polling Intervals to Retrieve Host Status Alarms” onpage 5-16).• Specify whether host status alarms and target status alarms refresh theconfiguration (see “Specifying Whether the Configuration Refreshes WhenHost and Target Status Alarms Occur” on page 5-19).• Specify whether a message appears when a host configuration change isdetected (see “Specifying Whether the Host Refresh Prompt Appears” onpage 5-20).To refresh the configuration immediately:Choose one of the following options:• On the toolbar, click Refresh.• On the View menu, click Refresh.• Press F5.For more information, see “Refreshing the Configuration Immediately” onpage 5-21.Specifying the Polling Intervals to Retrieve Host Status AlarmsPolling intervals determine how frequently SANsurfer iSCSI HBA Managermonitors the connected HBAs (and their targets), and updates the iSCSI HBAManager user interface configuration based on their state. There are two types ofpolling: HBA Polling. and Host Polling.HBA Polling. HBA polling occurs at an interval that you specify. During HBApolling, the agent checks for changes to the HBA settings and targets. When theagent detects a change, a host status alarm is sent to all SANsurfer iSCSI HBAManager interfaces currently connected with the agent.If you set the preferences to update behavior (see “Specifying Whether theConfiguration Refreshes When Host and Target Status Alarms Occur” onpage 5-19, then the SANsurfer iSCSI HBA Manager user interface retrieves thelatest information from the agent.Because alarms may not be detected by the interfaces, Host Polling. is alsoavailable to ensure that the user interfaces receive the configuration changes.Host Polling. Host polling permits host status alarms, not received by theSANsurfer iSCSI HBA Manager user interface, to be detected. Host polling occursat an interval that you specify and can be disabled.During host polling, the interface asks the agent if anything has changed since thelast time it received an update. If not, the interface waits until the next poll oralarm.5-16 IS0054602-00 B

A5 – Getting StartedSetting Up SANsurfer iSCSI HBA ManagerIf something has changed and the SANsurfer iSCSI HBA Manager updatebehavior configuration is set to update when the poll or host status alarms occur(see “Specifying Whether the Configuration Refreshes When Host and TargetStatus Alarms Occur” on page 5-19), theSANsurfer iSCSI HBA Manager userinterface then retrieves the latest information from the agent.Specifying the HBA Polling IntervalThe HBA polling interval is the length of elapsed time between polling events toHBAs on a host.To set the HBA polling interval:1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select theHBA port (or HBA, device, or LUN connected to the host).2. Do one of the following:On the Host menu, click HBA Poll Interval.Right-click the selected HBA port (or HBA, device, or LUN connectedto the host) in the HBA tree, and then on the shortcut menu, click HBAPoll Interval.The Polling Setting dialog box (Figure 5-9) opens, and shows the name ofthe host in the title bar.Figure 5-9 Polling Setting Dialog Box (HBA)3. In the Interval box, type the HBA polling interval. The range is 1 second to3600 seconds (1 hour). The default is 30 seconds.4. To set the polling interval, click OK. To close the Polling Setting dialog boxwithout changing the polling interval, click Cancel.IS0054602-00 B 5-17

5 – Getting StartedSetting Up SANsurfer iSCSI HBA ManagerSNOTES:• You cannot disable HBA polling.• The faster the polling rate, the more quickly the SANsurfer iSCSI HBAManager user interface receives indications from the connected HBAs.However, faster polling rates consume more of your system’s CPU andnetwork resources and slow the system.Specifying the Host Polling IntervalThe host polling interval is the length of elapsed time between polling events to aconnected host agent. Host polling detects host status alarms that are received bythe SANsurfer iSCSI HBA Manager user interface.To set the host polling interval:1. In the SANsurfer iSCSI HBA Manager main window HBA tree, select thehost (or HBA, device, or LUN connected to the host).2. Do one of the following:On the Host menu, click Host Poll Interval.Right-click the selected host (or HBA, device, or LUN connected to thehost) in the HBA tree. On the shortcut menu, click Host Poll Interval.The Host Polling Setting dialog box (Figure 5-10) opens, and shows thename of the host in the title bar.Figure 5-10 Host Polling Setting Dialog Box3. In the Interval box, type the host polling interval. The range is 0 seconds to1800000 seconds (500 hours). The default is 120 seconds. To disable hostpolling, type 0.4. To set the host polling interval, click OK. To close the Host Polling Settingdialog box without changing the interval setting, click Cancel.5-18 IS0054602-00 B

A5 – Getting StartedSetting Up SANsurfer iSCSI HBA ManagerSpecifying Whether the Configuration Refreshes When Host and Target StatusAlarms OccurYou can specify whether or not the SANsurfer iSCSI HBA Manager user interfaceconfiguration refreshes each time your system receives a host status alarm ortarget status alarm.To specify whether the configuration refreshes:1. On the Settings menu, click Application Options.The Application Options dialog box (Figure 5-11) opens.Figure 5-11 Application Options: Update Behavior2. Under Update Behavior from the Host Status Alarms, select the followingoptions:If you want to refresh the configuration when the host receives a hoststatus alarm or a target status alarm, select both the Enable AllUpdates from Host Alarms check box and the Enable Updates fromTarget Status Alarms check box.If you want to refresh the configuration when the host receives a hoststatus alarm but not a target status alarm, select only the Enable AllUpdates from Host Alarms check box.If you do not want the configuration to refresh when the host receives ahost status alarm nor a target status alarm, clear the Enable AllUpdates from Host Alarms check box.IS0054602-00 B 5-19

5 – Getting StartedSetting Up SANsurfer iSCSI HBA ManagerSWhen you clear the Enable All Updates from Host Alarms checkbox, the Enable Updates from Target Status Alarms check box isunavailable.3. To save your changes to the update behavior, click OK. To close theApplication Options dialog box without saving any changes, click Cancel.Specifying Whether the Host Refresh Prompt AppearsYou can determine whether the iSCSI configuration change message appearswhen the host configuration has changed.To specify whether host refresh prompt appears:1. On the Settings menu, click Application Options.The Application Options dialog box (Figure 5-12) opens.Figure 5-12 Application Options: Prompting Behavior2. Enable or disable the prompt for host refresh:To cause the iSCSI configuration change message to appear when ahost configuration has changed:a. Under Prompting Behavior, select the Enable Prompt toAccept Host Refresh check box.5-20 IS0054602-00 B

A5 – Getting StartedSetting Up SANsurfer iSCSI HBA ManagerWhen the host configuration changes, the following confirmationmessage (Figure 5-13) appears.Figure 5-13 iSCSI Configuration Change Confirmationb. To refresh the configuration, click Yes. To continue to show thecurrent configuration, click No.To prevent the iSCSI configuration change message from appearingwhen a host configuration has changed, clear the Enable Prompt toAccept Host Refresh check box. When host status alarms occur, theconfiguration refreshes if it is set to update (see “Specifying Whetherthe Configuration Refreshes When Host and Target Status AlarmsOccur” on page 5-19).3. To save your options changes, click OK. To close the Application Optionsdialog box without making any changes, click Cancel.Refreshing the Configuration ImmediatelyThe configuration shown in the SANsurfer iSCSI HBA Manager user interfacerefreshes based on the polling intervals (see “Specifying the Polling Intervals toRetrieve Host Status Alarms” on page 5-16) and whether the configuration is setto update when host status alarms occur (see“Specifying Whether theConfiguration Refreshes When Host and Target Status Alarms Occur” onpage 5-19).To refresh the configuration immediately:Do one of the following:• On the toolbar, click Refresh.• On the SANsurfer iSCSI HBA Manager main window View menu, clickRefresh.• Press F5.NOTE:Selecting Refresh forces the agent to poll the HBA immediately and updatethe SANsurfer iSCSI HBA Manager configuration with the latest HBAinformation.IS0054602-00 B 5-21

5 – Getting StartedSetting Up SANsurfer iSCSI HBA ManagerSNotes5-22 IS0054602-00 B

6 Performing DiagnosticsThe following sections describe the diagnostic tools available for managing iSCSIHBAs:• “General Information for the HBA Port” on page 6-2 explains the informationthat appears on top of the Diagnostics page for the HBA port.• “Pinging Targets” on page 6-3 provides the steps to verify that there isconnectivity between the HBA port and the target.• “Viewing Logs” on page 6-6 shows you how to view the ARP log, connectionerror log, destination cache log, neighbor cache log, and router list log.• “Setting Diagnostic Test Parameters” on page 6-16 provides information onsetting up and running the loopback and read/write buffer tests.• “Tracing User and Agent Activity” on page 6-21 provides the steps forcompleting the Diagnostic Options dialog box.NOTE:Some IPv6 features, such as the IPv6 Router List log, Destination Cachelog, and so on, are not available and appear dimmed if:• You are using inbox/ioctl module drivers with Red Hat 4 and 5 and SLES10. (To obtain the driver version string, use the modinfo qla4xxxcommand at the UNIX prompt. If you are using the inbox/ioctl moduledrivers, its version string contains a d.)• The card does not support IPv6; for example, QLA405x cards do notsupport IPv6, but QLE406x cards do support IPv6.• The IPv6 addresses are not enabled on the Port Options page, Networksub-page.• You are using an older driver. For example, some QLogic iSCSI driversshipped with the operating system are older drivers that do not havesupport for QLA406x cards.If you are using a QLE406x iSCSI HBA and download the standard driversand latest firmware from the QLogic Web site, you can access the IPv6features.IS0054602-00 B 6-1

6 – Performing DiagnosticsGeneral Information for the HBA PortSGeneral Information for the HBA PortThe top portion of the Diagnostics page for an HBA port provides generalinformation about the port, as shown in Figure 6-1.Figure 6-1 Diagnostics Page: HBA Port InfoHBA port-identifying information on the top of the Diagnostics page includes thefollowing:HBA ModelStateHBA iSCSI NameiSCSI Port AliasNameIPv4 AddressHBA instance number and HBA model.The HBA port state. For details about the HBA port stateand its correspondence with the HBA icons, see the helptopic, Monitoring the HBA Port State.• Green background: Good, indicating that the HBAport is operational and ready.• Yellow background: Warning, indicating that the HBAport is not in an operational state.• Blue background: Unknown, indicating that the HBAport is processing an operation. The state remainsunknown until the operation is complete. After theoperation is complete, the state changes to green,yellow, or red based on the results of the operation.• Red background:Bad, indicating that the HBA port isnot available.HBA port iSCSI name. The QLogic manufacturing defaultname or a name that you assign.HBA port iSCSI alias name. Symbolic name you assign tothe HBA port for identification purposes.IP address of the HBA port.6-2 IS0054602-00 B

A6 – Performing DiagnosticsPinging TargetsPinging TargetsPing PagePinging a target is an attempt by the HBA port to contact the targeted device. If theping is successful, it verifies that there is connectivity between the HBA port andthe target.To access the Ping page:1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select theHBA port.2. Click the Diagnostics tab to bring the Diagnostics page to the front.The top portion of the Diagnostics page contains the HBA port-identifyinginformation; for details, see “General Information for the HBA Port” onpage 6-2.3. On the Diagnostics page, click the Ping tab.The Ping page opens within the Diagnostics page (Figure 6-2).Figure 6-2 Ping Page (Diagnostics)IS0054602-00 B 6-3

6 – Performing DiagnosticsPinging TargetsSThe Ping page shows the following ping diagnostic information:IPv4 AddressIPv6 AddressIPv6 sourceaddressNumber ofpacket(s) (1-10000)Packet sizeSelect to enter IPv4 address of the target.Select to enter IPv6 address of the target.Port address from which the ping originates. This addresscould be the Auto Address, meaning the firmwaredetermined the address of the HBA. Alternatively, it canbe a Link Local Address, Source Address 1 (a routableaddress), or Source Address 2 (a routable address) thatyou determine.Number of packets to test.Minimum packet size is 32. Maximum packet size variesby path MTU size. If the path MTU size is 1500, then themaximum size that succeeds is 1452 for IPv6 and 1472for IPv4. If the path MTU is set for Jumbo frames and theMTU is 9000, then the maximum size that succeeds is8952 for IPv6 and 8972 for IPv4.Pinging IPv4 and IPv6 TargetsSANsurfer iSCSI HBA Manager allows you to ping targets on IPv4 and IPv6.To ping an IPv4 target:1. On the Ping page (Figure 6-2 on page 6-3), click IPv4 Address, and thentype the IP address in the IP boxes.2. In the Number of packet(s) box, type the number of packets you want tosend. Valid values range from 1–10000. The default is 1.3. In the Packet size box, type the size of the packets you want to send. Validvalues range from 32–64000. The default is 32.4. Click Start Testing.The status bar shows the HBA name and Current Operation: Ping diag.5. If you want to stop testing before it is complete, click Stop Testing.6-4 IS0054602-00 B

A6 – Performing DiagnosticsPinging TargetsWhen the test is complete, the Ping Status dialog box (Figure 6-3) informsyou of the results.Figure 6-3 Ping Status Dialog Box6. To close the dialog box, click OK.To ping an IPv6 address:1. On the Ping page (Figure 6-2 on page 6-3), click IPv6 Address, and thentype the IP address in the IP box.2. In the IPv6 source address list, select the IP address source. Or, to letSANsurfer iSCSI HBA Manager determine the source address, select AutoAddress.3. In the Number of packets box, type the number of packets you want tosend. Valid values range from 1–10000. The default is 1.4. In the Packet size box, type the size of the packets you want to send. Validvalues range from 32–64000. The default is 32.5. Click Start Testing.The status bar shows the HBA name and Current Operation: Ping diag.6. If you want to stop testing before it is complete, click Stop Testing.When the test is complete, the Ping Status dialog box (Figure 6-3 on page6-5) informs you of the results.7. To close the dialog box, click OK.IS0054602-00 B 6-5

6 – Performing DiagnosticsViewing LogsSViewing LogsSANsurfer iSCSI HBA Manager provides several types of information logs. Thefollowing sections tell you how to access each log:• “Viewing the ARP Log” on page 6-6• “Viewing the Connection Error Log” on page 6-8• “Viewing the IPv6 Destination Cache Log” on page 6-10• “Viewing the IPv6 Neighbor Cache Log” on page 6-11• “Viewing the IPv6 Router List Log” on page 6-13• “Viewing the IPv6 Local Prefix List Log” on page 6-14Viewing the ARP LogThe address resolution protocol (ARP) cache keeps a record of host portconnections with other hardware (such as targets) on the network. The IPaddress/MAC address pairs are dynamic entries that are removed after 10minutes.To view the ARP log:1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select theHBA port.2. Click the Diagnostics tab to bring the Diagnostics page to the front.The top portion of the Diagnostics page contains the HBA port-identifyinginformation; for details, see “General Information for the HBA Port” onpage 6-2.3. On the Diagnostics page, click the Logs tab.6-6 IS0054602-00 B

A6 – Performing DiagnosticsViewing LogsThe Logs page opens within the Diagnostics page (Figure 6-4).Figure 6-4 Logs Page (Diagnostics)4. On the Logs page, click Display ARP Table.5. The ARP Log opens (Figure 6-5).Figure 6-5 ARP LogFor the HBA port that you selected, the ARP log shows the HBA portconnections with remote network hardware:IS0054602-00 B 6-7

6 – Performing DiagnosticsViewing LogsS• IP Address is the IP address of the hardware on the remote network.• MAC Address is the MAC address of the hardware on the remotenetwork.6. If you want to refresh the log information immediately, click Refresh.7. To exit the log, click Close.Viewing the Connection Error LogThe connection error log for IPv4 and IPv6 lists the 100 latest connection errorsfor this HBA port.To view the connection error log:1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select theHBA port.2. Click the Diagnostics tab to bring the Diagnostics page to the front.The top portion of the Diagnostics page contains the HBA port-identifyinginformation; for details, see “General Information for the HBA Port” onpage 6-2.3. On the Diagnostics page, click the Logs tab.The Logs page opens within the Diagnostics page (see Figure 6-4 on page6-7).4. On the Logs page, click Display Connection Errors.The Connection Error Log opens (Figure 6-6).Figure 6-6 Connection Error Log6-8 IS0054602-00 B

A6 – Performing DiagnosticsViewing LogsNOTE:If text in any column is truncated, move the cursor over it to reveal theentire text in a tool tip next to the cursor.For the HBA port that you selected, the connection error log shows thefollowing information:Delta TimeTimestamp aTarget IDOriginal StateEntry TypeError TypeDetail CodeNumber ofConsecutiveErrorsThe number of seconds between the currenttimestamp and the previous timestamp.The time that elapsed since the last HBA reset.The device ID as defined by the QLogic tool.The state of the HBA and target connection.The error or information category for the originalstate.The error (sense) message and its hex value for theentry type.The detailed error (sense) information with its hexvalue for the error type.Number of times this detail error code has occurredconsecutively.aIf you have ACB support, the date-time stamp is in 12 hour format. If you do not have ACBsupport, the date-time format is in seconds since the last HBA reset. To activate ACB support,download the standard drivers and latest firmware from the QLogic Web site.For more detailed information, see the ISP4xxx Firmware InterfaceSpecification (see “Related Documents” on page 1-3).5. If you want to refresh the log information immediately, click Refresh.6. To export the contents of the connection error log to a file:a. Click Export to File.b. In the Export Connection Error Log To File dialog box, enter a path andfile name for the file.c. Click Export Log To File.7. To exit the connection error log, click Close.IS0054602-00 B 6-9

6 – Performing DiagnosticsViewing LogsSViewing the IPv6 Destination Cache LogThe IPv6 destination cache contains the IP address, next hop IP address, andpath MTU information for both local and remote destinations. For multicast andon-link unicast destinations, the next hop IP address always matches thedestination IP address.For unicast destinations that are off-link, the next hop IP address is the IP addressof the router.To view the destination cache log:1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select theHBA port.2. Click the Diagnostics tab to bring the Diagnostics page to the front.The top portion of the Diagnostics page contains the HBA port-identifyinginformation; for details, see “General Information for the HBA Port” onpage 6-2.3. On the Diagnostics page, click the Logs tab.The Logs page opens within the Diagnostics page (see Figure 6-4 on page6-7).4. On the Logs page, click Display Destination Cache.The IPv6 Destination Cache log opens (Figure 6-7).Figure 6-7 IPv6 Destination Cache LogNOTE:If text in any column is truncated, move the cursor over it to reveal theentire text in a tool tip next to the cursor.6-10 IS0054602-00 B

A6 – Performing DiagnosticsViewing LogsFor the HBA port that you selected, the destination cache log shows thefollowing information:Last Update TimeDestination IPNext Hop IPPath MTUFlagsThe date-time stamp of the last destination cacheentry. The date-time stamp is in 12 hour format.The destination IP address of an IPv6 iSCSI target.The IPv6 IP address of the next hop from the iSCSIHBA port. If the iSCSI target is on the local subnet,then this address is the same as the destination IPaddress. If the iSCSI target is not on the local subnet,then this address is the first router/gateway address inthe path to the iSCSI target.The path MTU between the HBA port and the iSCSItarget. The value is generally zero, except when anoversized ICMPv6 packet message is received.Local valid entry=0x5; remote valid entry=0x1.5. If you want to refresh the log information immediately, click Refresh.6. To exit the log, click Close.Viewing the IPv6 Neighbor Cache LogThe IPv6 Neighbor Cache contains the IP address, MAC address, and otherinformation about devices on the local link. This cache is similar to the IPv4 ARPcache (see “Viewing the ARP Log” on page 6-6). It provides mapping betweenunicast IP addresses and their associated MAC addresses.To view the neighbor cache log:1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select theHBA port.2. Click the Diagnostics tab to bring the Diagnostics page to the front.The top portion of the Diagnostics page contains the HBA port-identifyinginformation; for details, see “General Information for the HBA Port” onpage 6-2.3. On the Diagnostics page, click the Logs tab.The Logs page opens within the Diagnostics page (see Figure 6-4 on page6-7).4. On the Logs page, click Display Neighbor Cache.IS0054602-00 B 6-11

6 – Performing DiagnosticsViewing LogsSThe IPv6 Neighbor Cache log opens (Figure 6-7).Figure 6-8 Neighbor Cache LogNOTE:If text in any column is truncated, move the cursor over it to reveal theentire text in a tool tip next to the cursor.For the HBA port that you selected, the neighbor cache log shows thefollowing information:Last Update TimeNeighbor IPNeighbor MACAddressStateFlagsThe date-time stamp of the last neighbor cache entry.The date-time stamp is in 12 hour format.The neighbor IP address of an IPv6 device (iSCSItarget, router, and so on).The MAC address associated with this entry.The current state of this cache entry. Possible valuesinclude the following:• 0x0: Invalid entry.• 0x1: Incomplete entry, does not have MAC address.• 0x2: Stale, the reachable time has expired.• 0x3: Delay, the HBA port is currently waiting (5seconds) before sending a neighbor solicitationmessage.• 0x4: Probe, reachability confirmation is in progress.• 0x5: Reachable, the entry is currently reachable.Router entry=0x1; non-router entry=0x0.6-12 IS0054602-00 B

A6 – Performing DiagnosticsViewing Logs5. If you want to refresh the log information immediately, click Refresh.6. To exit the log, click Close.Viewing the IPv6 Router List LogThe IPv6 Router List log includes both the active default router (shown in the IPv6section of the Port Network page) and a short list of other routers that advertisedthemselves as being capable of acting as a default router. The active defaultrouter always appears first in the list.To view the router list log:1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select theHBA port.2. Click the Diagnostics tab to bring the Diagnostics page to the front.The top portion of the Diagnostics page contains the HBA port-identifyinginformation; for details, see “General Information for the HBA Port” onpage 6-2.3. On the Diagnostics page, click the Logs tab.The Logs page opens within the Diagnostics page (see Figure 6-4 on page6-7).4. On the Logs page, click Display Router List.The IPv6 Router List dialog box opens (Figure 6-9).Figure 6-9 IPv6 Router List LogFor the HBA port that you selected, the router list log shows the followinginformation:IS0054602-00 B 6-13

6 – Performing DiagnosticsViewing LogsSLast Update TimeThe date-time stamp of the last router list entry. Thedate-time stamp is in 12 hour format.Router IP Address The IP address of the router.Router LifetimeThe length of time, in minutes and seconds, that therouter can be used as the default router for this entry.FlagsValid entry=0x1; non-valid entry=0x0.For more detailed information, refer to the ISP4xxx Firmware InterfaceSpecification (see “Related Documents” on page 1-3).NOTE:If text in any column is truncated, move the cursor over it to reveal theentire text in a tool tip next to the cursor.5. If you want to refresh the log information immediately, click Refresh.6. To exit the log, click Close.Viewing the IPv6 Local Prefix List LogThe IPv6 Local Prefix List contains prefix information obtained from routeradvertisements. Destination IP addresses containing these prefixes can bereached directly, without going through and intermediate router.To view the prefix list log:1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select theHBA port.2. Click the Diagnostics tab to bring the Diagnostics page to the front.The top portion of the Diagnostics page contains the HBA port-identifyinginformation; for details, see “General Information for the HBA Port” onpage 6-2.3. On the Diagnostics page, click the Logs tab.The Logs page opens within the Diagnostics page (see Figure 6-4 on page6-7).4. On the Logs page, click Display Prefix List.6-14 IS0054602-00 B

A6 – Performing DiagnosticsViewing LogsThe IPv6 Prefix List dialog box opens (Figure 6-9).Figure 6-10 IPv6 Prefix List LogFor the HBA port that you selected, the prefix list log shows the followinginformation.Last Update TimePrefixPrefix LengthPrefix PreferredLifetimePrefix ValidLifetimeFlagsThe date-time stamp of the last router list entry. Thedate-time stamp is in 12 hour format.The local prefix of this entry.The length of the local prefix for this entry.The length in time that an address remains in thepreferred state in hours, minutes, and seconds.The length in time that an address remains in the validstate in hours, minutes, and seconds.Valid entry=0x1; non-valid entry=0x0.For more detailed information, refer to the ISP4xxx Firmware InterfaceSpecification (see “Related Documents” on page 1-3).NOTE:If text in any column is truncated, move the cursor over it to reveal theentire text in a tool tip next to the cursor.5. If you want to refresh the log information immediately, click Refresh.6. To exit the log, click Close.IS0054602-00 B 6-15

6 – Performing DiagnosticsSetting Diagnostic Test ParametersSSetting Diagnostic Test ParametersSANsurfer iSCSI HBA Manager offers two diagnostic tests: loopback andread/write buffer. You can access the testing functions on the Advanced page ofthe Diagnostics page for an HBA port. To set the parameters and run these tests,see the following sections:• “Running a Loopback Test” on page 6-16• “Running a Read/Write Buffer Test” on page 6-18Running a Loopback TestThere are two kinds of loopback tests: internal and external. Internal loopbacktesting is available for all HBAs and external loopback testing is available for the405x and 406x series HBAs, but not for 4010 HBAs.The external loopback test is a more complete test, but requires disconnecting thenetwork cable to plug in a loopback mechanism (see External Loopback Test.).Use the external loopback test if possible. Use the internal loopback test if noloopback mechanism is available.Both types of loopback test are at the port level.Internal Loopback Test. The internal loopback test generates acommunication signal within the HBA board and does not test the final circuitrythat goes to the cable. This test is convenient to run because it is not necessary tounplug the network cables.External Loopback Test. The external loopback test sends a communicationsignal to the cable and off the HBA board, and a loopback cable carries the signalback to the board. When running the external loopback test for an HBA with acopper interface, you can use the Media Conversion or the Wrap Plug option.When using Media Conversion, you must use a media converter and an opticalloopback cable. When using Wrap Plug, you must use a wrap plug cable. Whenrunning the external loopback test for an HBA with an optical interface, you needan optical loopback cable only. The Media Conversion and Wrap Plug optionsare unavailable for HBAs with an optical interface.To set loopback test configurations:1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select theHBA port.2. Click the Diagnostics tab to bring the Diagnostics page to the front.The top portion of the Diagnostics page contains the HBA port-identifyinginformation; for details, see “General Information for the HBA Port” onpage 6-2.3. On the Diagnostics page, click the Advanced tab.6-16 IS0054602-00 B

A6 – Performing DiagnosticsSetting Diagnostic Test ParametersThe Advanced page opens within the Diagnostics page (Figure 6-11).Figure 6-11 Advanced Page (Diagnostics): Loopback TestThe Advanced page shows the test configuration options on the top portionand the test results on the bottom portion.4. Under Test Configuration, click either Internal Loopback Test or ExternalLoopback Test.5. If you are running an external loopback test on an HBA with a copperinterface, select one of the following options:• If you have a media converter and an optical loopback cable, clickMedia Conversion.• If you have a wrap plug cable, click Wrap Plug.NOTE:If you are testing an HBA with an optical interface, Media Conversionand Wrap Plug are unavailable.IS0054602-00 B 6-17

6 – Performing DiagnosticsSetting Diagnostic Test ParametersS6. In the Num Of Tests (1-10000) box, enter the number of tests you want torun. The testing session stops when the tests are complete. The valid rangeis between 1 and 10,000.7. In the Test Increment (1-10000) box, enter the number of iterations youwant to run before a test is complete. The valid range is between 1 and10,000, and must be less than or equal to the value in the Num of Testsbox.For example, if the Num of Tests box contains 100 and the Test Incrementbox contains 10, then 100 tests are run in ten passes of ten iterations each.8. From the On Error list, specify how to handle errors during testing. (Thisselection applies whether you enter a value in the Num of Tests box orselect Test Continuously.)• Select Ignore to disregard errors and continue the test sequence.• Select Stop to halt the test sequence when an error is encountered.• Select Loop to test until the failure is cleared.9. If you want to repeat the tests until you click Stop Testing to halt theprocess, select the Test Continuously check box.10. To start the testing process, click Start Testing.The Internal (or External) Loopback Results area of the Advanced pageshows the HBA Name and the number of Loopback Success andLoopback Failure attempts.The status bar indicates the loopback test status.11. If you want to stop testing before the test process is complete, click StopTesting.Running a Read/Write Buffer TestThe read/write buffer test sends specified data through the SCSI Write Buffercommand to a target device (disk or tape). It then reads the data back through theSCSI Read Buffer command and compares the data for errors. The test alsocompares the link status of the device before and after the read/write buffer test. Iferrors occur, the test indicates a broken or unreliable link between the HBA portand the device.To set read/write buffer test configurations:1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select theHBA port.2. Click the Diagnostics tab to bring the Diagnostics page to the front.The top portion of the Diagnostics page contains the HBA port-identifyinginformation; for details, see “General Information for the HBA Port” onpage 6-2.6-18 IS0054602-00 B

A6 – Performing DiagnosticsSetting Diagnostic Test Parameters3. On the Diagnostics page, click the Advanced tab.The Advanced page opens within the Diagnostics page (Figure 6-12).Figure 6-12 Advanced Page (Diagnostics): Read/Write Buffer TestThe Advanced page shows the test configuration options on the top portionand the test results on the bottom portion.4. Under Test Configuration, click Read/Write Buffer Test.5. From the Data Pattern list, select either a data byte or compliant datapattern:• Select Customized Pattern (optional) to specify your own eight-bytepattern. Type the data in hexadecimal format (0-FF) into the eightCustomized Pattern boxes.• Select Random to randomly generate an eight-byte data pattern.6. From the Data Size list, select the data size; the number of bytes to transferper test per iteration when the test is run. Valid values are 8, 16, 32, 64.7. In the Num Of Tests (1-10000) box, type the number of tests you want torun. The testing session stops when the tests are complete. The valid rangeis between 1 and 10,000.IS0054602-00 B 6-19

6 – Performing DiagnosticsSetting Diagnostic Test ParametersS8. In the Test Increment (1-10000) box, enter the number of iterations youwant to run before a test is complete. The valid range is between 1 and10,000, and must be less than or equal to the value in the Num of Testsbox.For example, if the Num of Tests box contains 100 and the Test Incrementbox contains 15, then 100 tests are run in seven passes. The first six passesrun 15 tests each; the seventh pass runs 10 tests (6 x 15 + 10 = 100).NOTE:The test runs this number of passes before it stops on an error (if youselect Stop in Step 9), or stops when you select to stop testing (if youselect Test Continuously in Step 10)9. From the On Error list, specify how to handle errors during testing. (Thisselection applies whether you enter a value in the Num of Tests box orselect Test Continuously.)• Select Ignore to disregard errors and continue the test sequence.• Select Stop to halt the test sequence when an error is encountered.• Select Loop to use the same data pattern and test until the failure iscleared.10. If you want to repeat the tests until you click Stop Testing to halt theprocess, select the Test Continuously check box.11. To test specific targets that you select from the Read/Write Buffer TestResults section, select the Test Selected Targets Only check box. To testall targets, clear this check box.12. To start the testing process, click Start Testing.The status bar indicates the read/write buffer test status.13. If you want to stop testing before the test process is complete, click StopTesting.When the test is complete, the results are shown under Read/Write BufferTest Results on the Advanced page.6-20 IS0054602-00 B

A6 – Performing DiagnosticsTracing User and Agent ActivityTracing User and Agent ActivityTo trace activity in SANsurfer iSCSI HBA Manager, you can either use themanual methods described in “Using Debug to Trace User Interface andAgent Activity” on page 7-14, or use the new, simple option in the userinterface to trace activity in the user interface, agent, non-agent JNI (JNICorporation’s JNIC-1560 HBA), and iSDMAPI (QLogic’s proprietaryapplication programming interface to manage QLA4xxx adapters).To trace activity:1. On the Settings menu, click Diagnostics Options.The Diagnostic Options dialog box opens (Figure 6-13).Figure 6-13 Diagnostics Options Dialog BoxIS0054602-00 B 6-21

6 – Performing DiagnosticsTracing User and Agent ActivityS2. To allow user interface diagnostic logging information to be saved to a file,follow these steps:a. Under SANsurfer GUI Diagnostic Preferences, select the EnableGUI diagnostic logging to a file check box.b. For Logging Level, select one of the following levels of logging: None Error Level Warning Level Event Level Spawn Level Trace Level Connection Level Memory Level Configuration Level Low Level All Levelsc. Select the Log data only at specified level check box to log only atthe level selected under Logging Level. To log data at multiple levels,clear this check box.d. In the Log File Size box, enter the maximum size in KB of the loggingfile. The default is 3000 KB; enter 0 (zero) to specify unlimited size.e. In the Log File Name box, enter a file name with which the log will besaved in the SANsurfer iSCSI HBA Manager installation folder. Thedefault file name is troutput.txt.f. To save these changes to the SANsurfer iSCSI HBA Manager userinterface diagnostic preferences, click Apply.3. To allow agent and non-agent/JNI diagnostic logging information to be savedto a file, follow these steps:a. Under SANsurfer Agent & Non-Agent/JNI Diagnostic Preferences,select the Enable agent logging to a file check box.b. From the Hostname list, select a host name.c. For Logging Level, select one of the following levels of logging: Error Level Warning Level Info Level Debug Level All Levels6-22 IS0054602-00 B

A6 – Performing DiagnosticsTracing User and Agent Activityd. Select the Log data only at specified level check box to log only atthe level selected under Logging Level. To log data at multiple levels,clear this check box.e. In the Log File Size box, enter the maximum size in KB of the loggingfile. The default is 1000 KB; enter 0 (zero) to specify unlimited size.f. In the Log File Name box, enter a file name with which the log will besaved in the /tmp folder. The default file name is iSCSI_Agent.log.g. To save these changes to the SANsurfer iSCSI HBA Manager agentand non-agent diagnostic preferences, click Apply.4. To allow driver API (iSDMAPI) logging information to be saved to a file,follow these steps:a. Under SANsurfer Agent & Non-Agent/JNI Diagnostic Preferences,select the Enable Driver API (iSDMAPI) logging to a file check box.b. For Logging Level, select one of the following levels of logging: Error Level Warning Level Event Level Trace Level All Levelsc. Select the Log data only at specified level check box to log only atthe level selected under Logging Level. To log data at multiple levels,clear this check box.d. In the Log File Size box, enter the maximum size in KB of the loggingfile. The default is 2000 KB; enter 0 (zero) to specify unlimited size.e. In the Log File Name box, enter a file name with which the log will besaved in the /tmp folder. The default file name isisdmapi_agentdebug.log.f. To save these changes to the SANsurfer iSCSI HBA Manager driverAPI diagnostic logging options, click Apply.5. When you are through modifying the diagnostic options, click Close.IS0054602-00 B 6-23

6 – Performing DiagnosticsTracing User and Agent ActivitySNotes6-24 IS0054602-00 B

7 TroubleshootingProblems can occur when installing and using SANsurfer iSCSI HBA Manager.This section provides information that will help you troubleshoot these problems,including the following:• “Troubleshooting Tools” on page 7-1• “Troubleshooting Problems and Solutions” on page 7-2• “Verifying That the HBA Driver is Installed” on page 7-12• “Verifying That iqlremote is Installed and Running” on page 7-13• “Using Debug to Trace User Interface and Agent Activity” on page 7-14 (asdirected by your authorized service provider)• “Retrieving Records” on page 7-22NOTE:The iqlremote agent refers to the SANsurfer iSCSI HBA Manager serveragent (SANsurfer iSCSI Windows Agent, SANsurfer iSCSI Linux Agent,SANsurfer iSCSI Solaris Agent, or SANsurfer iSCSI NetWare 5/6.x Agentwith which the SANsurfer iSCSI HBA Manager user interface (client)connects to manage QLogic QLA2xxx iSCSI HBAs.Troubleshooting ToolsThe following sections explain how to use the Windows event log and SANsurferiSCSI HBA Manager to solve hardware problems.Windows Event LogThe Windows event log is the main source of information for device driverproblems and events. Device drivers usually indicate only status by loggingevents in the system event log. SANsurfer iSCSI HBA Manager agents also usethe event log to report service errors and other problems.The miniport driver logs events for significant driver errors. Due to a limitation ofthe Windows miniport driver interface, the miniport can log only two 32-bit valuesfor any event. Information about interpreting these event codes is in theeventlog.txt file, which is shipped with the miniport driver.IS0054602-00 B 7-1

7 – TroubleshootingTroubleshooting Problems and SolutionsSSANsurfer iSCSI HBA Manager ToolsSANsurfer iSCSI HBA Manager provides the following diagnostic tools formanaging iSCSI HBAs:• Pinging a Target. Pinging verifies the connectivity between an HBA portand a device port.• Viewing the ARP Log. The address resolution protocol (ARP) cache keepsa record of host port connections with other hardware (such as targets) onthe network.• Viewing the Connection Error Log. The connection error log lists the 100latest connection errors for an HBA port, thereby providing details aboutconnection problems with a device.• Read/Write Buffer Test. The read/write buffer test sends specified datathrough the SCSI Write Buffer command to a target device (disk or tape). Itthen reads the data back through the SCSI Read Buffer command andcompares the data for errors. The test also compares the link status of thedevice before the read/write buffer test. If errors occur, the test indicates abroken or unreliable link between the adapter and the device.• Internal Loopback Test. The internal loopback test sends data through theQLA4xxx HBA’s internal wiring. (It sends a message to itself without leavingthe HBA.) This test does not test the QLA4xxx HBA connector.• External Loopback Test. A special loop cable is required for this test. Theexternal loopback test tests the QLA4xxx HBA connector. More specifically,the external loopback test transmits and receives (loopback) the specifieddata and checks for the frame CRC, disparity, and length errors.For details on using these tools, refer to Section 6, Performing Diagnostics.Troubleshooting Problems and SolutionsThis section provides troubleshooting problems and solutions. Refer to theassociated readme.txt file for the latest problems and solutions (see “RelatedDocuments” on page 1-3). Problem categories include:• “Installation Issues” on page 7-3• “User Interface and Remote Agent Issues” on page 7-4• “Functional Issues” on page 7-97-2 IS0054602-00 B

A7 – TroubleshootingTroubleshooting Problems and SolutionsInstallation IssuesTable 7-1 lists problems that can occur when installing SANsurfer iSCSI HBAManager, and provides possible causes and solutions.Table 7-1. Troubleshooting: Installation IssuesProblemInstallation does not run.Installation does not completeor terminates before completion.Installation does not copyfiles.Installation reports that thereis no space available.Cause and SolutionCause: You are not using the correct installation program or the downloadedinstallation file is corrupted.Solution:• If running from CD-ROM, verify that the installation is run from thestart page. If JavaScript is turned on in the browser, the CD-ROMautomatically detects the operating system and presents the appropriateinstallation program.• If the installation program was downloaded, it may be corrupted.Download the program again, this time to a different directory; performthe installation.Cause: There is insufficient disk space or not enough available memory.Solution: The installation detects when there is insufficient disk space.When sufficient disk space is available, continue the installation. Fordisk space and physical RAM requirements, see “Hardware Requirements”on page 3-4 or the readme.txt file.Cause: There is insufficient disk space or not enough available memory.Solution: The installation detects when there is insufficient disk space.When sufficient disk space is available, continue the installation. Fordisk space and physical RAM requirements, see “Hardware Requirements”on page 3-4 or the readme.txt file.Cause: There is insufficient disk space or not enough available memory.Solution: The installation detects when there is insufficient disk space.When sufficient disk space is available, continue the installation. Fordisk space and physical RAM requirements, see “Hardware Requirements”on page 3-4 or the readme.txt file.IS0054602-00 B 7-3

7 – TroubleshootingTroubleshooting Problems and SolutionsSUser Interface and Remote Agent IssuesTable 7-2 lists problems related to the SANsurfer iSCSI HBA Manager userinterface and remote agent, and provides possible causes and solutions.Table 7-2. Troubleshooting: User Interface and Remote Agent IssuesProblemUnable to start the SANsurferiSCSI HBA Manager userinterface using the desktopshortcut (SANsurfer icon).SANsurfer iSCSI HBA Manageruser interface starts, andthen hangs indefinitely.SANsurfer iSCSI HBA Manageruser interface cannotconnect to the local host.Cause and SolutionCause: The desktop shortcut has an invalid path or SANsurfer iSCSIHBA Manager was not completely installed.Solution: Verify that the desktop shortcut points to theSANsurfer.exe file. For Windows, this program is installed by defaultin the following folder:C:\Program Files\QLogic Corporation\SANsurferCause: There is insufficient memory.Solution: For physical RAM requirements, see “Hardware Requirements”on page 3-4 or the readme.txt file.Cause: The iqlremote agent is not installed, the iqlremote agent is notrunning, or an incorrect system name was entered.Solution: Possible solutions include the following:• Verify that the iqlremote agent is installed and running; see “VerifyingThat iqlremote is Installed and Running” on page 7-13.• If typing the host name in the Connect to Host dialog box, verify thatyou are typing the correct name. Refer to the system server informationto check the system name. In the Connect to Host dialog box,select localhost.• The DNS or the local host file may contain an incorrect IP addressfor the host name. Use the Ping command to ping the host nameand verify that the correct IP address is translated from the name.7-4 IS0054602-00 B

A7 – TroubleshootingTroubleshooting Problems and SolutionsTable 7-2. Troubleshooting: User Interface and Remote Agent Issues (Continued)ProblemSANsurfer iSCSI HBA Manageruser interface cannotconnect to a remote host.SANsurfer iSCSI HBA Manageruser interface connectsto the same host more thanonce.Cause and SolutionCause: The iqlremote agent is not installed on the remote system orthe network protocol is not properly configured.Solution:• Verify that the iqlremote agent is installed on the remote host. See“System Requirements” on page 3-4 and “Initial Installation” onpage 4-1 for network requirements. See the SANsurfer iSCSI HBAManager help system for instructions on how to configure and manageremote hosts. Verify that the appropriate network protocol isrunning.• The DNS or the local host file may contain an incorrect IP addressfor the host name. Use the ping command to ping the host name,and then verify that the correct IP address is translated from thename.Cause: The iqlremote agent is not running.Solution: Start the iqlremote agent or reboot the system.Cause: The iSCSI HBAs and iSCSI HBA driver must be installed andoperational before the iqlremote agent will start.Solution: After the HBAs and drivers are successfully installed (see“Verifying That the HBA Driver is Installed” on page 7-12), reinstall theiqlremote agent or reboot the system.Cause: Host IP address does not resolve to a host name.Solution:• If DNS is used, verify that DNS is working properly: Verify that the host on which the user interface is running has acorrect entry for the IP address and host name. Verify that the host on which the agent is running has a correctentry for the IP address and host name.• If DNS is not used, manually edit the local host file on the system onwhich SANsurfer iSCSI HBA Manager is running and add the hostname to IP mapping. For Windows 2000/Windows Server 2003, the location is:\\system32\\drivers\\etc\\hosts For Red Hat/SLES Linux and Solaris SPARC, the location is:/etc/hostsIS0054602-00 B 7-5

7 – TroubleshootingTroubleshooting Problems and SolutionsSTable 7-2. Troubleshooting: User Interface and Remote Agent Issues (Continued)ProblemSANsurfer iSCSI HBA Manageruser interface does notfind or show any HBAs.SANsurfer iSCSI HBA Manageruser interface does notfind or display any devices.SANsurfer iSCSI HBA Manageruser interface reportsthat the HBA device driver isinvalid or incorrect.Unable to find SANsurferiSCSI HBA Manager userinterface help system.Cause and SolutionCause: An iSCSI HBA is not installed.Solution: Install a QLogic QLA4xxx HBA.Cause: The current QLogic iSCSI driver is out of date and does notsupport the installed newer-generation iSCSI card. This is common withdrivers that are shipped with the operating system.Solution: Download the latest version of the QLogic iSCSI driver forour operating system from the QLogic Web site at www.qlogic.com.Cause: The current version of SANsurfer iSCSI HBA Manager is out ofdate and does not support the newer generation iSCSI card installed.Solution: Download the latest version of SANsurfer iSCSI HBA Managerfrom the QLogic Web site at www.qlogic.com.Cause: An iSCSI HBA driver is not installed or an incorrect HBA driveris installed.Solution:• Verify that the iSCSI HBA driver is installed (see “Verifying That theHBA Driver is Installed” on page 7-12).• Verify that the appropriate operating system driver is loaded. Referto the readme.txt file for supported operating system drivers.• Verify that the iqlremote agent is running on the local or remote host.Check agent logs for any problems while querying information (see“Using Debug to Trace User Interface and Agent Activity” onpage 7-14).Cause: The devices were not configured and saved using the SANsurferiSCSI HBA Manager user interface nor Fast!UTIL.Solution: For information about setting up connections to devicesusing the SANsurfer iSCSI HBA Manager user interface, see the helptopic, Configuring Targets.Cause: An incorrect or unsupported operating system driver isinstalled.Solution: Refer to the readme.txt file for a list of supported operatingsystem drivers.Cause: The path to the browser is not correctly specified.Solution: In the SANsurfer iSCSI HBA Manager main window Helpmenu, click Set Browser Location to specify the path (see “Specifyingthe Help Browser” on page 5-9). See “Software Requirements” onpage 3-5 for supported browsers.7-6 IS0054602-00 B

A7 – TroubleshootingTroubleshooting Problems and SolutionsTable 7-2. Troubleshooting: User Interface and Remote Agent Issues (Continued)ProblemSANsurfer iSCSI HBA Manageruser interface does notautomatically refresh.Cause and SolutionCause: There is a disconnect with the iqlremote agent or network communicationhas stopped.Solution:• Verify that the iqlremote agent is installed and running (see “VerifyingThat iqlremote is Installed and Running” on page 7-13).• If DNS is used, verify that DNS is working properly: Verify that the host on which the user interface is running has acorrect entry for the IP address and host name. Verify that the host on which the agent is running has a correctentry for the IP address and host name.• If DNS is not used, manually edit the local host file on the system onwhich SANsurfer iSCSI HBA Manager is running and add the hostname to IP mapping: For supported Windows systems, the location is as follows:\\system32\\drivers\\etc\\hosts For supported Linux and Solaris systems, the location is as follows:/etc/hosts For network requirements, see “System Requirements” onpage 3-4, and “Initial Installation” on page 4-1.Cause: The HBA polling interval is set too high or the host polling intervalis set at too high or disabled.Solution: Set appropriate values (see “Specifying the Polling Intervalsto Retrieve Host Status Alarms” on page 5-16).SANsurfer iSCSI HBA Manageruser interface loses theconnection to a host.Cause: There is a disconnect with the iqlremote agent or network communicationhas stopped.Solution:• Verify that the iqlremote agent is installed and running (see “VerifyingThat iqlremote is Installed and Running” on page 7-13).• Verify that the appropriate network protocol is running.• Verify that the network is operational and that there is network connectivitybetween the system on which the SANsurfer iSCSI HBAManager user interface is running and the system on which theSANsurfer iSCSI HBA Manager server agent is running. For example,on the host on which the SANsurfer iSCSI HBA Manager userinterface is running, use the system ping command to ping the systemon which the SANsurfer iSCSI HBA Manager server agent isrunning.IS0054602-00 B 7-7

7 – TroubleshootingTroubleshooting Problems and SolutionsSTable 7-2. Troubleshooting: User Interface and Remote Agent Issues (Continued)ProblemSANsurfer iSCSI HBA Manageruser interface loses theconnection to an HBA.SANsurfer iSCSI HBA Manageruser interface loses theconnection to a device.SANsurfer iSCSI HBA Manageruser interface crashes.Cause and SolutionCause: There is a disconnect with the iqlremote agent or the operatingsystem driver has lost communication with the HBA.Solution:• Verify that the iqlremote agent is installed and running (see “VerifyingThat iqlremote is Installed and Running” on page 7-13).• Verify that the operating system driver detects the HBA. If the operatingsystem cannot detect the HBA and the preceding steps fail tofix the connection between the driver and the HBA, then try reloadingthe driver or rebooting the operating system.Cause: There is a disconnect or the HBA lost communication with thetarget.Solution:• Verify that the device is operational. For details about connectionproblems with a device, use the connection error log (see “Viewingthe Connection Error Log” on page 6-8).• To verify connectivity between an HBA port and a device port, pingthe target (see “Pinging IPv4 and IPv6 Targets” on page 6-4).• Modify the HBA firmware parameters as necessary. Do one of thefollowing: Review the target configuration parameters (see the help topic,Changing the Target Configuration Parameters) and modify asnecessary. Save. Reset the HBA’s firmware parameters to the factory defaults (seethe help topic, Restoring an HBA’s Firmware Parameters to theFactory Defaults). Then configure the specific device: delete thetarget, save, add the target, and save (see the help topic, ConfiguringSpecific Targets).• If all the above steps fail to fix the connection, try rebooting the operatingsystem.Cause: Another application caused a conflict with SANsurfer iSCSIHBA Manager, insufficient memory, or insufficient disk space.Solution:• Verify that no other application is causing SANsurfer iSCSI HBAManager Manager to crash.• Verify that the disk and system memory requirements are met. Fordisk space and physical RAM requirements, see “HardwareRequirements” on page 3-4 or the readme.txt file.7-8 IS0054602-00 B

A7 – TroubleshootingTroubleshooting Problems and SolutionsFunctional IssuesTable 7-3 lists functional problems that may occur with using SANsurfer iSCSIHBA Manager, and provides possible causes and solutions.Table 7-3. Troubleshooting: Functional IssuesProblemUnable to get host Information.Unable to display HBA Information,HBA Statistics, or TargetInformation (HBA).Unable to run update BIOS.Cause and SolutionCause: The iqlremote agent is not running or installed.Solution: Verify that the iqlremote agent is installed and running (see“Verifying That iqlremote is Installed and Running” on page 7-13).Cause: The iqlremote agent is not running or is not installed.Solution: Verify that the iqlremote agent is installed and running (see“Verifying That iqlremote is Installed and Running” on page 7-13).Cause: An incorrect or no HBA driver is installed.Solution: Install the appropriate HBA driver (see “Verifying That theHBA Driver is Installed” on page 7-12).Cause: The HBA is not installed.Solution: Install the HBA.Cause: This feature is not supported for all operating systems.Solution: Updating the BIOS is available only for supported Windowsand Linux systems. For details, see the help topic, Updating an HBABIOS from a File.IS0054602-00 B 7-9

7 – TroubleshootingTroubleshooting Problems and SolutionsSTable 7-3. Troubleshooting: Functional Issues (Continued)ProblemUnable to change the securitypassword.When using a file choosersdialog box (such as the Opendialog box) to select a file,SANsurfer iSCSI HBA Managerdoes not always respondto double-clicking the directoryor selecting a specific file.Deleted targets reappear afteran HBA reset.Cause and SolutionCause: The login requirements are not met.Solution: Verify that the appropriate account on the host system meetslogin name (user name) requirements. For details, see “Setting SANsurferiSCSI HBA Manager Security” on page 5-11.Cause: For Windows Server 2003, the administrator account passwordis blank.Solution: The administrator account password must not be blank whenchanging the SANsurfer iSCSI HBA Manager security password.Therefore, add a password to the administrator account. This is a WindowsServer 2003 security restriction.Cause: For Red Hat/SLES Linux, the shadow password option must beinstalled on the same system as the SANsurfer iSCSI HBA ManagerLinux agent.Solution: For example, in a Red Hat Linux system, follow these stepsto create an /etc/shadow file:1. Install the shadow-utils rpm package from /RedHat/RPMS/shadow-utilities-20000902-4.i386.rpm.2. To convert the passwords to shadow password format, go to the/etc directory and enter the command pwconv.Cause: This is a current limitation of the Java technology that SANsurferuses.Solution: Click Open to move through the directory or open a specificfile.Cause: SendTargets (with no iSCSI name) are configured and anHBA reset has occurred.Solution: Delete the SendTargets (with no iSCSI name) that wereconfigured during the initial discovery of the target.Cause: Internet Storage Name Service (iSNS) is configured.Solution: After you have completed the discovery process, on the TargetDiscovery Config subpage of the Target Options page, clear theEnable iSNS check box, and then click Save iSNS & Port Settings.(See the help topic, Configuring Target Discovery.)7-10 IS0054602-00 B

A7 – TroubleshootingTroubleshooting Problems and SolutionsTable 7-3. Troubleshooting: Functional Issues (Continued)ProblemTargets do not show the newfirmware values (factorydefaults, updates, nor newfirmware).Unable to modify targets orCHAP entries.Unable to obtain an IPaddress with the Obtain DNSserver address automatically(via DHCP) optionselected (IP address is0.0.0.0) for this HBA.When in DHCP mode, unableto acquire new IP address andnetwork settings via DHCPwhen switching networks.Cause and SolutionCause: Targets keep the firmware values with which they were originallyconfigured.Solution: If you want a target to have the new firmware values, do thefollowing on the Target Settings subpage of the Target Options page:• Manually delete the target, and then click Save Target Setting.• Add the target (the target will automatically be configured with thenew firmware values), and then click Save Target Setting.Cause: HBAs or their connected targets are configured for iSCSI bootusing Fast!UTIL.Solution: Use Fast!UTIL to unconfigure the boot targets and disableboot.Cause: The firmware on an HBAs does not support BIOS and/or containsan older version of firmware.Solution: Ensure that all HBAs have the same firmware that supportsBIOS.Cause: The DHCP server is unavailable.Solution:• Fix the DHCP server as follows:1. Make sure that all links to the server are available (for example,ping the DHCP server to verify its connection status).2. Manually set the IP address and associated network settings(such as subnet mask and gateway) for the HBA.3. Set the HBA to a fixed IP address and enter the associated networksettings.• On supported Windows systems, if the above process does notwork, do the following:1. Disconnect the HBA network link.2. Reconfigure with the new IP address.3. Reconnect the HBA network link.Cause: The DHCP server has a long lease time.Solution: Reset the QLA4xxx HBA. For example, if you type and savea new or change an existing HBA iSCSI alias name, the HBA resetsand a new address is issued.IS0054602-00 B 7-11

7 – TroubleshootingVerifying That the HBA Driver is InstalledSTable 7-3. Troubleshooting: Functional Issues (Continued)ProblemUnable to use the Solaris hotswap feature on QLogicQLA4xxx HBAs.Cause and SolutionCause: Cannot have iqlremote agent running when using the Solarishot swap feature on the HBAs.Solution: Follow these steps. Note that management features areunavailable when iqlremote is not running.1. Stop iqlremote as follows. For supported Windows systems, open the Services window andstop the QLogic Management Suite Java iQAgent service. For Red Hat/SLES Linux and Solaris SPARC, type one of the followingcommands and then press ENTER:/etc/rc3.d/S99iqlremote stoppkill -TERM iqlremote2. Use the hot swap feature.3. When finished using the hot swap feature, restart iqlremote. Do oneof the following: Reboot the system. For supported Windows systems, open the Services window andstart the QLogic Management Suite Java iQAgent service. For Red Hat/SLES Linux and Solaris SPARC, type the followingcommand and then press ENTER:/etc/rc3.d/S99iqlremote startVerifying That the HBA Driver is InstalledIf SANsurfer iSCSI HBA Manager is having trouble connecting to the local host,follow the procedure for your operating system to verify that the HBA driver isinstalled. If the HBA driver is not installed, then install it (see “Step 3: Install theDriver” on page 3-2, or the QLogic Quick Start Guide).If you determine that the HBA driver is installed, then consider the following:• If typing the host name in the Connect to Host dialog box, verify that you aretyping the correct name. Refer to the system server information to check thesystem name. On the Connect to Host dialog box, select localhost.• The DNS or the local host file may contain an incorrect IP address for thehost name. Use the ping command to ping the host name, and then verifythat the correct IP address is translated from the name. If necessary,reinstall the HBA driver.7-12 IS0054602-00 B

A7 – TroubleshootingVerifying That iqlremote is Installed and RunningTo verify that the HBA driver is installed on Windows:1. Right-click the My Computer desktop icon. On the shortcut menu, clickManage.2. In the left pane of the Computer Management window, click DeviceManager. In the right pane, click SCSI and RAID controllers.3. Right-click a QLogic FC Adapter (which is a QLogic FC HBA port). On theshortcut menu, click Properties.4. On the QLogic Fibre Channel Adapter Properties, click the Driver tab.5. On the Driver page, click the Driver Details button.6. On the Driver File Details dialog box, Driver files list, select the driver. Thefile version appears below.7. Repeat the process for each HBA port, as appropriate.To verify that the HBA driver is installed on Netware:1. At the server command prompt, type the following, and then press ENTER:modules q*2. Verify that the QLogic HBA driver is installed.To verify that the HBA driver is installed on Red Hat/SUSE Linux:1. Type the following command, and then press ENTER:lsmod (the letter L)2. Verify that the QLogic HBA driver is installed.To verify that the HBA driver is installed on Solaris SPARC/x86:1. Type the following command, and then press ENTER:modinfo | grep qla2. The entries, if they appear, are the installed QLogic HBA drivers.Verifying That iqlremote is Installed and RunningSeveral problems in SANsurfer iSCSI HBA Manager can be a result of theiqlremote agent not being installed, loaded, or running. To determine if iqlremote isinstalled and running, follow the procedure for your operating system.To verify that iqlremote is installed and running on Windows:1. Open the Computer Management: Services window (Figure 7-1).2. Verify that the QLogic Management Suite Java iQAgent service(iQLManagementAgentJava) is running.IS0054602-00 B 7-13

7 – TroubleshootingUsing Debug to Trace User Interface and Agent ActivityS3. If the service is already started, stop, and then restart the service.Figure 7-1 Windows: ServicesTo verify that iqlremote is installed and running on Red Hat/SUSE Linux:1. Type the following command, and then press ENTER:# ps -ef | grep iqlremote2. If entries appear, iqlremote is loaded.To verify that iqlremote is installed and running on Solaris SPARC:1. Type the following command, and then press ENTER:ps -e | grep iqlremote2. If entries appear, iqlremote is running.Using Debug to Trace User Interface and AgentActivityTechnical support may require additional information to support troubleshootingSANsurfer iSCSI HBA Manager problems. To use debug, you must activate thetrace facility and the iSCSI agent logging facility. After you enable these facilities,attempt to reproduce the problem so that you can capture SANsurfer iSCSI HBAManager user interface and agent activity. After collecting the agent activity logs,you can export them for further study.7-14 IS0054602-00 B

A7 – TroubleshootingUsing Debug to Trace User Interface and Agent ActivityAdditionally, saving the host configuration file makes it easier to diagnose anyproblems you may have. For more information, see the help topic, Saving theHost Configuration to a File.To trace SANsurfer iSCSI HBA Manager user interface and agent activity asdirected by technical support, use the following procedures:• “Tracing User Interface Activity for Windows OS” on page 7-15• “Saving Agent Activity Logs for Windows OS” on page 7-19• “Tracing User Interface Activity for UNIX OS” on page 7-20• “Saving Agent Activity Logs for UNIX OS” on page 7-22Tracing User Interface Activity for Windows OSAs part of the debug procedure on a Windows system, you must enable the userinterface trace facility and activate the iSCSI agent logging facility. After youenable these facilities, attempt to reproduce the problem so that you can captureSANsurfer iSCSI HBA Manager user interface and agent activity. After collectingthe agent activity logs, you can save them for further study.To trace SANsurfer iSCSI HBA Manager user interface activity, you must eitheredit the local.properties file, or use the new Diagnostic Options dialog box(see “Tracing User and Agent Activity” on page 6-21).To edit the local.properties file:1. Locate the local.properties file, which is in the same folder asSANsurfer iSCSI HBA Manager.2. Before making any changes, make a backup of the file.3. Open the file in a text editor and change the following three lines as shown:node.trace.level=900..node.trace.output.datetimeprefix=true..node.trace.output.setlevelonly=false..4. Save the file.IS0054602-00 B 7-15

7 – TroubleshootingUsing Debug to Trace User Interface and Agent ActivitySFigure 7-2 shows an example of the local.properties file edits.Figure 7-2 local.properties in NotepadTip: Increasing the Screen Buffer Size Height When using a Windowssystem, it is convenient to change the height of the screen buffer.To increase screen buffer height:1. Click the Start button, point to Programs, point to Accessories, and thenclick Command Prompt.7-16 IS0054602-00 B

A7 – TroubleshootingUsing Debug to Trace User Interface and Agent ActivityThe Command Prompt window opens (Figure 7-3).Figure 7-3 Command Prompt Window2. Click the icon on the left side of the title bar, and then on the shortcut menu,click Properties.IS0054602-00 B 7-17

7 – TroubleshootingUsing Debug to Trace User Interface and Agent ActivitySThe “Command Prompt“ Properties dialog box opens (Figure 7-4).Figure 7-4 “Command Prompt” Properties3. Click the Layout tab.4. On the Layout page under Screen Buffer Size, type 9999 in the Heightbox, and then click OK.The Apply Properties to Shortcut dialog box opens (Figure 7-5).Figure 7-5 Apply Properties to Shortcut Dialog Box5. Click Modify shortcut that started this window, and then click OK.7-18 IS0054602-00 B

A7 – TroubleshootingUsing Debug to Trace User Interface and Agent ActivityCreating a User Interface Logging File While holding down the CTRL key,select the Windows menu item or shortcut to start SANsurfer iSCSI HBAManager. A new console window opens and shows SANsurfer iSCSI HBAManager user interface activity, as shown in Figure 7-6.Figure 7-6 SANsurfer.exe in Console WindowYou can select text from this console window to copy and paste into a document.This document is the user interface logging file.For more information on saving the agent activity log, see “Saving Agent ActivityLogs for Windows OS” on page 7-19.Saving Agent Activity Logs for Windows OSFor the supported Windows operating systems, save the current agent log byusing the following procedure at the command prompt.To save agent activity logs:1. Activate the iSCSI agent logging facility as follows:a. Open the iSCSIAgent.properties file, located in the SANsurferinstallation directory.b. Change the property iscsi.agent.logging.enabled to true.c. Save the iSCSIAgent.properties file.2. Open a command shell (DOS) window.3. Change to the install directory. For example:cd C:\Program Files\QLogic Corporation\SANsurferIS0054602-00 B 7-19

7 – TroubleshootingUsing Debug to Trace User Interface and Agent ActivityS4. Shutdown the agent by entering the following command:iqlremote –u5. Restart the agent by first entering the following commands in succession:iqlremote –iiqlremote –s6. To view and save the full agent output, use a tool such as DebugView,available at the following URL:www.microsoft.com/technet/sysinternals/Tracing User Interface Activity for UNIX OSAs part of the debug procedure, you must enable the user interface trace facilityand activate iSCSI agent logging facility. When you enable these facilities, attemptto reproduce the problem so that you can capture SANsurfer iSCSI HBA Manageruser interface and agent activity. After collecting the agent activity logs, you cansave them for further study.To trace SANsurfer iSCSI HBA Manager user interface activity, you must edit thelocal.properties file and set the debug environmental variable, as shown inthe following procedures.To edit the local.properties file:1. Locate the local.properties file, which is in the same folder asSANsurfer iSCSI HBA Manager.2. Before making any changes, make a backup of the file.3. Open the file in a text editor and change the following three lines as shown:4. Save the file.node.trace.level=900..node.trace.output.datetimeprefix=true..node.trace.output.setlevelonly=false..7-20 IS0054602-00 B

A7 – TroubleshootingUsing Debug to Trace User Interface and Agent ActivityFigure 7-2 shows an example of the local.properties file edits.Figure 7-7 local.properties in NotepadTo set the debug environment variable:1. Open a UNIX command prompt.2. Set the environment variable, LAX_DEBUG, to true by entering the followingcommand:LAX_DEBUG=true3. To capture the output of user interface logging to a file, start SANsurferiSCSI HBA Manager by entering the following command:SANsurfer | tee >> sansurfergui.logFor more information on saving the agent activity log, see “Saving Agent ActivityLogs for UNIX OS” on page 7-22.IS0054602-00 B 7-21

7 – TroubleshootingRetrieving RecordsSSaving Agent Activity Logs for UNIX OSFor UNIX operating systems, save the current agent log by following thisprocedure at the command prompt.To save agent activity logs:1. Activate the iSCSI agent logging facility as follows:a. Open the iSCSIAgent.properties file, located in the /etcdirectory.b. Change the property iscsi.agent.logging.enabled to true.c. Save the iSCSIAgent.properties file.2. Find the agent processor ID by entering the following command:ps –ef | grep iqlrem3. Stop the agent process by entering the following command:kill 4. Change to the SANsurfer installation directory (most commonly named/opt/QLogic_Corporation/SANsurfer).5. Capture the output of the agent logging to a file and manually start the agentby entering the following command:./iqlremote | tee > agentlog.log6. After you complete testing and stop the manually running agent, restart theagent to run in normal mode by entering the following command:Retrieving Records/etc/rc5.d/S99iqlremote startTo help solve problems that may occur when installing and using SANsurfer iSCSIHBA Manager, you can retrieve for examination the records specified in thefollowing procedures:• “Retrieving the HBA Core Dump Record” on page 7-23• “Retrieving the Flash NVRAM Record” on page 7-26• “Retrieving the HBA Crash Record” on page 7-297-22 IS0054602-00 B

A7 – TroubleshootingRetrieving RecordsRetrieving the HBA Core Dump RecordIf a QLA405x or QLE406x HBA crashes, you can retrieve the HBA core dump ifyou have previously saved the log information to a file.NOTE:You can retrieve a core dump record only if you are using a QLA405x orQLE406x HBA.NOTE:The Retrieve Core Dump Record feature is not available if either of thefollowing is true:• You are using inbox/ioctl module drivers with Red Hat 4 and 5 and SLES10. (To obtain the driver version string, use the modinfo qla4xxxcommand at the UNIX prompt. If you are using the inbox/ioctl moduledrivers, its version string contains a d.)• You do not have ACB (Alternate Control Block) support with the properhardware configuration, drivers, and firmware.However, if you are using HBAs other than QLA4010 and download thestandard drivers and latest firmware from the QLogic Web site, you canaccess the Retrieve Core Dump Record feature.To save the log information to a file:1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select anHBA.2. Click the HBA Options tab to bring that page to the front.3. On the HBA Options page, click the HBA Utilities tab.IS0054602-00 B 7-23

7 – TroubleshootingRetrieving RecordsSThe HBA Utilities page (Figure 7-8) opens within the HBA Options page.Figure 7-8 HBA Utilities Page (HBA Options)7-24 IS0054602-00 B

A7 – TroubleshootingRetrieving RecordsHBA port-identifying information on the top of the HBA Options pageincludes the following:HBA ModelStateSerial NumberHBA Alias NameHBA instance number and HBA model.The HBA port state. For details about the HBA port stateand its correspondence with the HBA icons, see thehelp topic, Monitoring the HBA Port State.• Green background: Good, indicating that the HBAport is operational and ready.• Yellow background: Warning, indicating that theHBA port is not in an operational state.• Blue background: Unknown, indicating that theHBA port is processing an operation. The stateremains unknown until the operation is complete.After the operation is complete, the state changes togreen, yellow, or red based on the results of theoperation.• Red background:Bad, indicating that the HBA portis not available.HBA serial number.HBA port iSCSI alias name. Symbolic name you assignto the HBA port for identification purposes.4. On the HBA Utilities page, click Retrieve Coredump Record.The Save FW Coredump dialog box (Figure 7-9) opens.Figure 7-9 Save FW Coredump Dialog Box5. To save the core dump record, choose one of the following options:• Enter a name and location for the core dump file, or type a file name inthe File box, and then click Save Flash/NVRAM To File.IS0054602-00 B 7-25

7 – TroubleshootingRetrieving RecordsSNOTE:When naming a core dump file, it is helpful to include the HBAinformation, crash date, and crash time.• If you do not know the location, click Browse. The Save dialog boxopens. Select or type a file name in the File Name box, and then clickSave. The Save FW Coredump dialog box re-opens with name youselected in the File box. Click Save Flash/NVRAM To File.6. A message box informs you of the success or failure of the core dump save.To close this message box, click OK.Retrieving the Flash NVRAM RecordIf the HBA crashes, you can retrieve the HBA Flash NVRAM record if youpreviously saved the log information to a file.NOTE:The Retrieve Flash NVRAM Record feature is not available if either of thefollowing is true:• You are using inbox/ioctl module drivers with Red Hat 4 and 5 and SLES10. (To obtain the driver version string, use the modinfo qla4xxxcommand at the UNIX prompt. If you are using the inbox/ioctl moduledrivers, its version string contains a d.)• You do not have ACB (Alternate Control Block) support with the properhardware configuration, drivers, and firmware.However, if you are using HBAs other than QLA4010 and download thestandard drivers and latest firmware from the QLogic Web site, you canaccess the Retrieve Flash NVRAM Record feature.To save the log information to a file:1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select anHBA.2. Click the HBA Options tab to bring that page to the front.3. On the HBA Options page, click the HBA Utilities tab.7-26 IS0054602-00 B

A7 – TroubleshootingRetrieving RecordsThe HBA Utilities page (Figure 7-10) opens within the HBA Options page.Figure 7-10 HBA Utilities Page (HBA Options)IS0054602-00 B 7-27

7 – TroubleshootingRetrieving RecordsSHBA port-identifying information on the top of the HBA Options pageincludes the following:HBA ModelStateSerial NumberHBA Alias NameHBA instance number and HBA model.The HBA port state. For details about the HBA port stateand its correspondence with the HBA icons, see thehelp topic, Monitoring the HBA Port State.• Green background: Good, indicating that the HBAport is operational and ready.• Yellow background: Warning, indicating that theHBA port is not in an operational state.• Blue background: Unknown, indicating that theHBA port is processing an operation. The stateremains unknown until the operation is complete.After the operation is complete, the state changes togreen, yellow, or red based on the results of theoperation.• Red background:Bad, indicating that the HBA portis not available.HBA serial number.HBA port iSCSI alias name. Symbolic name you assignto the HBA port for identification purposes.4. On the HBA Utilities page, click Retrieve Flash NVRAM Record.The Save FW Flash & NVRAM dialog box (Figure 7-11) opens.Figure 7-11 Save FW Flash & NVRAM Dialog Box5. To save the Flash and NVRAM record, choose one of the following options:• Enter a name and location for the Flash and NVRAM file, or type a filename in the File box, and then click Save Flash/NVRAM To File.7-28 IS0054602-00 B

A7 – TroubleshootingRetrieving RecordsNOTE:When naming a Flash NVRAM file, it is helpful to include the HBAinformation, crash date, and crash time.• If you do not know the location, click Browse. The Save dialog boxopens. Select or type a file name in the File Name box, and then clickSave. The Save Flash & NVRAM dialog box re-opens with name youselected in the File box. Click Save Flash/NVRAM To File.6. A message box informs you of the success or failure of the core dump save.To close this message box, click OK.Retrieving the HBA Crash RecordIf the QLA4010x HBA crashes, you can retrieve the HBA crash record if you havepreviously saved the log information to a file.NOTE:You can retrieve an HBA crash record only if you are using a QLA4010x.To save the log information to a file:1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select anHBA.2. Click the HBA Options tab to bring that page to the front.3. On the HBA Options page, click the HBA Utilities tab.IS0054602-00 B 7-29

7 – TroubleshootingRetrieving RecordsSThe HBA Utilities page (Figure 7-10) opens within the HBA Options page.Figure 7-12 HBA Utilities Page (HBA Options) for QLA4010xHBA port-identifying information on the top of the HBA Options pageincludes the following:HBA ModelStateHBA instance number and HBA model.The HBA port state. For details about the HBA port stateand its correspondence with the HBA icons, see thehelp topic, Monitoring the HBA Port State.• Green background: Good, indicating that the HBAport is operational and ready.• Yellow background: Warning, indicating that theHBA port is not in an operational state.• Blue background: Unknown, indicating that theHBA port is processing an operation. The stateremains unknown until the operation is complete.After the operation is complete, the state changes togreen, yellow, or red based on the results of theoperation.• Red background:Bad, indicating that the HBA portis not available.7-30 IS0054602-00 B

A7 – TroubleshootingRetrieving RecordsSerial NumberHBA Alias NameHBA serial number.HBA port iSCSI alias name. Symbolic name you assignto the HBA port for identification purposes.4. On the HBA Utilities page, click Retrieve Crash Record.The Save Crash Record dialog box (Figure 7-13) opens.Figure 7-13 Save Crash Record Dialog Box5. To save the crash record, choose one of the following options:• Enter a name and location for the crash file, or type a file name in theFile box, and then click Save.NOTE:When naming a crash file, it is helpful to include the HBA information,crash date, and crash time.• If you do not know the location, click Browse. The Save dialog boxopens. Select or type a file name in the File Name box, and then clickSave. The Save Crash Record dialog box re-opens with name youselected in the File Name box. Click Save.6. A message box informs you of the success or failure of the crash recordsave. To close this message box, click OK.IS0054602-00 B 7-31

7 – TroubleshootingRetrieving RecordsSNotes7-32 IS0054602-00 B

A Frequently AskedQuestionsTable A-1 lists some frequently asked questions (FAQs) about SANsurfer iSCSIHBA Manager. For additional FAQs and other information, visit the QLogicsupport Web site, support.qlogic.com.Table A-1. Frequently Asked QuestionsQuestionOn what platforms does SANsurfer iSCSIHBA Manager run?Can the SANsurfer iSCSI HBA Manageruser interface running on Red Hat/SLESLinux talk to a Windows host running theagent?What does the blinking heart on the connectedhost mean?AnswerThe SANsurfer iSCSI HBA Manager user interface runs onany platform that supports the Java Virtual Machine(JVM) 1.4 specification.The agent runs on the following:• Windows 2000/SP4+(IA32,x64)• Windows XP, Server 2003, Server 2008 (IA32,x64)• Windows Vista• Solaris SPARC 8, 9,10• Solaris (IA32,x64) 10• RHEL 3.0, 4.0(IA32,x64), 5.0(IA32,x64,PPC)• SLES 8.0(IA32), 9.0, 10.0(IA32,x64,PPC)The SANsurfer iSCSI HBA Manager user interface runningon any platform can talk to any other platform running theagent. The SANsurfer iSCSI HBA Manager interfaceallows connections to different platforms at the same time.SANsurfer iSCSI HBA Manager actively pings the agent atthe specified broadcast interval. This allows SANsurferiSCSI HBA Manager to detect agent presence on all platforms(even if agent shutdown notification is not supported).It also allows the detection of agent crashes assoon as possible. During an agent crash, the notificationmay not have been sent to all the connected user interfaces.IS0054602-00 B A-1

A – Frequently Asked QuestionsSTable A-1. Frequently Asked Questions (Continued)QuestionCan SANsurfer iSCSI HBA Manager berun as a Java applet?Does SANsurfer iSCSI HBA Manager supportSNMP?AnswerNo, SANsurfer iSCSI HBA Manager currently does not runas a Java applet.No, SANsurfer iSCSI HBA Manager currently supports onlythe RPC communication layer between the user interfaceand agent.A-2 IS0054602-00 B

GlossaryadapterSee HBA.ACBAlternate Control Block is a subset of theInitFW block of firmware parameters inFlash memory.AL_PAArbitrated loop_physical address, alow-level address on the FC loop.arbitrated loopA non-point-to-point circular topologywhere two or more ports can be interconnected,but only two ports can communicateat one time. All communication ispassed through all ports connected ontothe loop.ARPAddress resolution protocol. An Internetprotocol used for mapping an IP addressto a physical address on an Ethernet LAN.BIOSBasic input/output system. A QLA2xxxHBA's flash PROM contains the code thatallows booting from the HBA at startup.boot codeThe first program to run when a system ispowered on. This is also true for deviceswithin a system, such as FC HBAs.FCode, BIOS, and EFI (enhancedfirmware interface) are all forms of bootcode for specific hardware/operatingsystem environments.Boot code for QLogic FC HBAs is requiredif the computer system is booting from astorage device (boot device) attached tothe QLogic HBA. The primary function ofthe boot code is communication with theexternal boot device before the operatingsystem is up and running. There are alsosecondary functions that can be performedby the boot code, including managing thesetup for the HBA and initializing andtesting the HBA’s ISP.boot deviceThe hard disk that contains the operatingsystem that the BIOS uses to boot fromwhen the computer is started.core dumpThe recorded state of the working memoryof a computer program at a specific time,generally when the program has terminatedabnormally. Core dumps are oftenused to diagnose or debug errors incomputer programs.CRCCyclic Redundancy Check. A CRC is atype of check value designed to catchmost transmission errors.CSV fileComma separated values file.IS0054602-00 BGlossary-1

SANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersSdeviceA computer subsystem, such an HBAcard, which mediates data in a computernetwork. The term “device” is used interchangeablywith “target” and “targetdevice.”DHCPDynamic Host Configuration Protocol isused by networked devices (clients) toobtain various parameters necessary forthe clients to operate in an InternetProtocol (IP) network.driverSoftware that interfaces between the filesystem and a physical data storage deviceor network media.The level structure for Windows drivers isas follows:• Class driver is the highest driver level.There is a separate class for disk,Ethernet, etc. This level handles allgeneric aspects of operations for thatclass.• Port driver is the middle driver level,which handles aspects of the operationspecific to the port type; for example,there is a port driver for SCSI.• Miniport driver is the lowest driverlevel and device specific. This level isusually supplied by the manufactureras a companion to a physical device.• Monolithic driver level combines thefunctions of different driver levels in thesame driver to increase performance.• Adjunct driver level works along sidea driver at the same level to increaseperformance.In NetWare, the required drivers include:• Host Adapter Module (HAM) is thedriver component associated with thehost adapter hardware. It provides thefunctionality to route requests to thebus where a specified device isattached.• Custom Device Module (CDM) is thedrive component associated withstorage devices. It provides thefunctionality to build device-specificcommands from I/O messagesreceived from NetWare's MediaManager.In Red Hat/SUSE Linux, the driver layersinclude:• SCSI Upper Layer is the devicemanagement layer. It handlesdevice-dependent tasks for devices,such as disks and tapes.• SCSI Middle Layer is the SCSI traffichandling layer. It directs requestsbetween the kernel and the SCSI.• SCSI Lower Layer is the SCSI HBAdriver. It communications directly to theSCSI HBA.The structure for Solaris SPARC/x86drivers includes:• Nexus drivers provide bus mappingand translation services to subordinatenexus and leaf devices. These includedrivers for PCI-to-PCI bridges,PCMCIA adapters, and SCSI HBAs.• Leaf drivers provide the traditionalcharacter and block driver interfacesfor reading and writing data to storageand communication devices. Theseinclude drivers for peripheral devices,including QLA2xxx HBAs, disks, tapes,network HBAs, and frame buffers.Glossary-2IS0054602-00 B

ASANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersfabricConsists of cross-connected FC devicesand switches.fabric switchConnects multiple devices from independentFC-arbitrated loops (FC-ALs) andpoint-to-point topologies into a fabric.failover pathSoftware feature that ensures data availabilityand system reliability by assigningalternate path and automatic HBA failoverfor device resources. This feature is availableonly in Windows 2000/WindowsServer 2003/Windows Vista, NovellNetWare, and Red Hat/SUSE Linux.(Windows XP and Windows Server 2008do not support failover.)Fast!UTILQLogic Fast!UTIL iSCSI HBA BIOS utility.FCFibre Channel is a high-speed serial interfacetechnology that supports other higherlayer protocols, such as iSCSI and IP, andis primarily used in SANs. Standardizedunder ANSI in 1994.FCodeA type of boot code. It is designed for useon Sun's SPARC or Macintosh hardwareplatforms. See boot code and Flash.FlashNon-volatile memory where the boot codeis saved. At times, Flash and boot codeare used interchangeably.Flash BIOSA QLA2xxx HBA's flash PROM containsthe code that allows booting from the HBAat startup.HBAHost bus adapter. An HBA is the boardthat interfaces between the host systemand device. HBA is synonymous with hostadapter, adapter, and adapter board. InSANsurfer iSCSI HBA Manager documentation,the term QLA2xxx HBA is used.HBA aliasA user-defined name for an HBA. You mayuse up to 256 characters when creating anHBA alias.HBA iSCSI nameHBA port iSCSI name. The QLogicmanufacturing default name or a namethat you assign.HBA portA port on the HBA.HBA port aliasA user-defined name for an HBA port. Youmay use up to 256 characters whencreating an HBA port alias.HBA port beaconFlashing the HBA port beacon is a featureof SANsurfer iSCSI HBA Manager thatenables you to flash the 23xx/24xx HBA'sLED to locate the HBA in your computer.host bus adapterSee HBA.iFCPInternet Fibre Channel protocol. Agateway-to-gateway protocol for the implementationof a FC fabric in which TCP/IPswitching and routing elements replace FCcomponents. The protocol enables theattachment of existing FC storageproducts to an IP network by supportingthe fabric services required by suchdevices.IS0054602-00 B Glossary-3

SANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersSIOCBI/O control block. An IOCB is a commandstructure in QLogic ISP architecture.ioctlInput/output control. ioctl is a system callfound on Unix/Linux systems, allowing anapplication to control or communicate witha device driver outside the usual read/writeoperations.IPInternet Protocol is a method by whichdata is sent from one computer to anotherover the Internet. IP specifies the format ofpackets, also called datagrams, and theaddressing scheme.iSCSIInternet small computer systems interface.iSDMAPIQLogic’s proprietary application programminginterface to manage QLA4xxxadapters.iSNSInternet Storage Name Service protocolallows automated discovery, management,and configuration of iSCSI and FibreChannel devices (using iFCP gateways)on a TCP/IP network.load balancingA software feature that improves systemperformance by balancing device accessbetween multiple QLA2xxx HBAs formaximum resource efficiency. This featureis available in Windows 2000/WindowsServer 2003/Windows Vista, NovellNetWare, and Red Hat/SUSE Linux.(Windows XP and Windows Server 2008do not support load balancing.)loopbackA diagnostic tool where data is transmittedand received by the QLA2xxx HBA.logical unit numberSee LUN.LUNLogical unit number. A LUN is the smallinteger handle that identifies a portion ofdisk storage. A LUN can consist of a singlephysical disk or many physical disks. Aphysical disk can be broken into multipleLUNs.LUN maskingA software feature that assigns LUNs tospecific servers or hides LUNs fromspecific servers for maximum access andavailability control.MAC addressMedia access control address. A uniquehardware device identifier used in IPaddress assignment.mediaCarriers of information. FC supportsseveral different physical media: copper,multimode optical, and single-modeoptical, which differ mainly in the maximumcable length. All FC protocols aresupported on all media.NASNetwork attached storage. A hard diskstorage device that is set up with its ownnetwork address rather than beingattached directly to the computer that isserving applications or files to networkusers.Glossary-4IS0054602-00 B

ASANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersNICNetwork interface controller. A computercircuit board or card that is installed in acomputer so that it can be connected to anetwork.nonvolatile random access memorySee NVRAM.NVRAMNonvolatile random access memory. HBAconfiguration settings are stored inNVRAM. You can configure HBA settingsor restore them from a file. These settingsare saved in NVRAM and are retainedwhen power is removed.ONCOpen network computing, a remote procedurecall developed by Sun Microsystems.open network computingSee ONC.pathA path to a device is a combination of aQLA2xxx HBA port and a target port. Notethat this is distinct from any internal pathswithin the fabric network. A fabric networkappears to the operating system as anopaque network between the HBA (initiator)and the target port.Because a path is a combination of anHBA and a target port, a path is distinctfrom another path if it is accessed througha different HBA and/or it is accessing adifferent target port. Consequently, whenswitching from one path to another, thedriver might be selecting a different HBA(initiator), a different target port, or both.This makes a difference to the driver whenselecting the proper method of failovernotification. It can make a difference to thetarget device, which might have to takedifferent actions when receiving retries ofthe request from another initiator or on adifferent port.path MTUPath maximum transmission unit. Thesmallest MTU of any of the IP hops of the“path” between a source and destination inan Internet transmission path. The pathMTU is the largest packet size thattraverse this path without sufferingfragmentation.point-to-pointTwo FC nodes directly connected(non-loop).portAccess point in a device where a linkattaches. The four types of ports include:• N_Port is a FC device port thatsupports point-to-point topology.• NL_Port is a FC device port thatsupports loop topology.• F_Port is a port in a fabric where anN_Port can attach.• FL_Port is a port in a fabric where anNL_Port can attach.SANStorage area network, which consists ofmultiple storage units and serversconnected by networking topology.SCSISmall computer system interface. Theoriginal SCSI specification was a hardwarebus specification and a packet-orientedprotocol specification for communicatingon that bus. SCSI over FC uses thepacket-oriented protocol to communicatewith storage devices on the FC.IS0054602-00 B Glossary-5

SANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersSSPIFFISpecification for platform-independentfailover and failback integration. It is acooperative effort that defines a nonvendor-specific failover mechanism.storage area networkSee SAN.sysfsA virtual file system provided by the 2.6Linux kernel. Sysfs exports informationabout devices and drivers from the kerneldevice model to userspace, and is alsoused for configuration.targetDevices, such an HBA card, whichmediate data in a computer network. Theterm device is used interchangeably withtarget and target device. See device.target bindingRefers to the process in which the HBAdriver binds a target ID using a target'sworld wide port name (WWPN) or port ID.This enables the target ID to alwaysconnect to the WWPN or port ID acrossreboots regardless of SAN reconfigurations.Glossary-6IS0054602-00 B

IndexAAbout box 5-10ACBdefinition of Glossary-1support for 2-4, 6-9, 7-23, 7-26access password, requiring 5-11activity logs, agentsaving on UNIX 7-22saving on Windows 6-21, 7-19adapter, definition of Glossary-1Add/Remove Programs utility 4-24address resolution protocol, See ARPaddressesdestination IP 6-11HTTP address (server proxy) 4-19IPv4 HBA port 6-2IPv4 target 6-4IPv6 next hop 6-11IPv6 source 6-4IPv6 target 6-4MAC 6-8neighbor IP 6-12neighbor MAC 6-12pinging IPv4 and IPv6 6-4remote network hardware 6-7, 6-8router IP 6-14administrator or root privileges 5-11Advanced page (Diagnostics) 6-17, 6-19agent activitylogs, saving UNIX 7-22logs, saving Windows 7-19tracing 7-14AL_PA, definition of Glossary-1alarmshost status 5-15refreshing configuration uponoccurrence 5-19retrieving for host 5-16alias name, iSCSI HBA port 6-2Alternate Control Block, See ACBApplication Options dialog boxhost status alarms 5-19prompting behavior 5-20tree view naming preference 5-15arbitrated loop_physical address, definitionof Glossary-1arbitrated loop, definition of Glossary-1ARPdefinition of Glossary-1log, viewing 6-6, 6-7asset management feature 2-2audience, intended 1-1auto address 6-4BBIOS, definition of Glossary-1book icon 5-8boot code, definition of Glossary-1boot device, definition of Glossary-1browserlocation, specifying for help 5-9supported versions 3-5Browser Location dialog box 5-9, 5-10buffer test (read/write), running 6-18IS0054602-00 BIndex-1

SANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersSCCD-ROM, downloading installer from 4-3checking for SANsurfer updates 4-17checklist for installation 3-1Choose Product Features dialog boxfor installation 4-7for uninstallation 4-28choosingfeatures to install 4-7features to uninstall 4-28CLILinux installation using 4-16Solaris installation using 4-17Windows installation using 4-16closing SANsurfer 5-7command line interface, installing using 4-15”Command Prompt” Properties dialogbox 7-18Command Prompt window 7-17Computer ManagementDevice Management window 7-13Services window 7-13configurationmanagement feature 2-2refreshing 5-15refreshing immediately 5-21refreshing when alarm occurs 5-19system, standalone or networked 4-2Connect to Host dialog box 7-12Connection Error Log, viewing 6-8contact information 1-4core dumpdefinition of Glossary-1record, retrieving 7-23crash record, retrieving 7-29CRC (cyclic redundancy check), definitionof Glossary-1creatingdesktop icon 4-12desktop icon (Windows) 4-12user interface logging file (Windows) 7-19CSV file, definition of Glossary-1Ddebug, tracing user interface and agentactivity 7-14DebugView, using to view agent output 7-20default access password 5-12definitions of terms Glossary-1desktop iconcreating (Windows) 4-12starting SANsurfer with 5-1destination cache (IPv6), viewing 6-10destination IP address 6-11devicedefinition of Glossary-2icons and text in HBA tree 5-6DHCPdefinition of Glossary-2server problem, resolving 7-11Diagnostic Options dialog box 6-21diagnostics 6-1feature description 2-3Ping page 6-3target, pinging 6-3test parameters, setting 6-16Diagnostics page 6-3Advanced 6-16, 6-18HBA port information 6-2Logs 6-6 to 6-14disk space requirements 3-4documentation conventions 1-2documents, related 1-3downloadinginstaller from CD-ROM 4-3installer from QLogic Web site 4-3Driver File Details dialog box 7-13driversdefinition of Glossary-2HBA, verifying installation 7-12required 3-5types of, defined Glossary-2Dynamic Host Configuration Protocol, SeeDHCPIndex-2IS0054602-00 B

ASANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersEe-mail, contacting QLogic 1-4enabling refresh from host and targetalarms 5-19eventlog.txt file 7-1exiting SANsurfer 5-7external loopback test 6-16FF1 key, accessing help system 5-8fabric switch, definition of Glossary-3fabric, definition of Glossary-3failover path, definition of Glossary-3FAQs A-1Fast!UTILaccessing utility 3-2definition of Glossary-3FC, definition of Glossary-3FCodeconfiguring HBA port boot settings 2-2definition of Glossary-3updating 2-2features of product 2-1Fibre Channel, definition of Glossary-3Flash BIOS, definition of Glossary-3Flash NVRAM record, retrieving 7-26frequently asked questions A-1functional issues, solutions for 7-9Ggeneral overview 2-1getting started with product 5-1glossary of terms Glossary-1graphics adapter, requirements 3-4H.hst file (host group) 1-3hardware requirements 3-1, 3-4HBA alias, definition of Glossary-3HBA driverinstalling 3-2verifying installation 7-12HBA Options page 7-23, 7-26, 7-29HBA portgeneral information 6-2icons and text 5-6identifying information 6-2pinging target 6-3definition of Glossary-3HBA port alias, definition of Glossary-3HBA port beacon, definition of Glossary-3HBA tree 5-5device icons and text 5-6HBA icons and text 5-5host icons and text 5-5LUN icons and text 5-7port icons and text 5-6specifying names to show 5-14HBA Utilities pagecoredump record, retrieving 7-24crash record, retrieving 7-30Flash NVRAM record, retrieving 7-27HBAscoredump record, retrieving 7-23crash record, retrieving 7-29definition of Glossary-3icons and text 5-5instance number and model 6-2iSCSI port alias name 6-2polling intervals, specifying 5-16, 5-17port IPv4 address 6-2port iSCSI name 6-2port state 6-2state feature 2-3supported versions 3-6Help menu 5-8IS0054602-00 B Index-3

SANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersShelp systembrowser, specifying location 5-9contents of 5-9viewing 5-8hostaccess password, setting 5-13group file (.hst), using 1-3icons and text 5-5refresh prompt 5-20host bus adapter, See HBAhost polling 5-16interval, setting 5-18Host Polling Setting dialog box 5-18host status alarmsrefreshing configuration 5-19retrieving 5-15, 5-16II/O control block, definition of Glossary-4icons in the HBA tree 5-5, 5-6, 5-7iFCP, definition of Glossary-3inbox module drivers 2-4input/output control (ioctl), definitionof Glossary-4input/output control, See ioctlinstallationchecklist 3-1completing 4-15configurations (standalone ornetworked) 4-2default location 4-9file, selecting and starting 4-4issues, solutions for 7-3previous version detected 4-10product features, choosing 4-7required hardware 3-1required software 3-2uninstalling old version 4-10using CLI 4-15using GUI 4-3wizard, installing SANsurfer 4-5installerdownloading from CD-ROM 4-3downloading from QLogic Web site 4-3selecting and starting 4-4intended audience 1-1interface issues, solutions for 7-4internal loopback test 6-16Internet Fibre Channel protocol, definitionof Glossary-3Internet Protocol, definition of Glossary-4Internet small computer systems interface(iSCSI) Glossary-4Internet Storage Name Service, See iSNSintroduction to SANsurfer FC HBAManager 1-1IOCB, definition of Glossary-4ioctldefinition of Glossary-4module drivers 2-4IP addressARP log 6-8destination 6-11neighbor 6-12next hop 6-11router 6-14IP, definition of Glossary-4IPv4address, HBA port 6-2target address 6-4target address, pinging 6-4target, pinging 6-4IPv6address to ping 6-5destination cache, viewing 6-10local prefix list log, viewing 6-14neighbor cache, viewing 6-11router list log, viewing 6-13source address 6-4target address 6-4target address, pinging 6-4target, pinging 6-5IPv6 Destination Cache log 6-10IPv6 Neighbor Cache log 6-12Index-4IS0054602-00 B

ASANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersIPv6 Prefix List dialog box 6-15IPv6 Router List dialog box 6-13iqlremote agentdefined 7-1troubleshooting 7-5 to 7-12verifying installation 7-13iSCSIagent logging, activating 7-15, 7-20name, HBA port 6-2port alias name 6-2iSCSI names vs. alias names in HBAtree 5-14iSCSI, definition of Glossary-4iSCSIAgent.properties 7-19iSDMAPIactivity, tracing 6-21definition of Glossary-4iSNSdefinition of Glossary-4disabling 7-10JJava runtime environment, requirementfor 3-6JNI activity, tracing 6-21JNIC-1560 HBA 6-21Lleft pane of SANsurfer window 5-5license agreements 1-3LinuxCLI installation on 4-16starting SANsurfer on 5-2uninstalling SANsurfer 4-25load balancing, definition of Glossary-4local prefix list log (IPv6), viewing 6-14local.properties file, editing 7-15, 7-20logging file, creating for user interface 7-19logical unit number, definition of Glossary-4logsactivity, saving (UNIX) 7-22activity, saving (Windows) 7-19ARP, viewing 6-6connection error, viewing 6-8IPv6 destination cache, viewing 6-10IPv6 local prefix list log, viewing 6-14IPv6 neighbor cache, viewing 6-11IPv6 router list log, viewing 6-13Logs page (Diagnostics) 6-7, 6-8, 6-10, 6-11,6-13, 6-14loopbackdefinition of Glossary-4tests, internal and external 6-16loopback testsinternal and external 6-16running 6-16LUNdefinition of Glossary-4icons and text 5-7LUN masking, definition of Glossary-4MMAC addressARP log 6-8definition of Glossary-4neighbor 6-12main window, components of 5-3media access control address, See MACaddressmedia conversion, external loopbacktest 6-16media, definition of Glossary-4memory requirement 3-4menu bar 5-4miniport driver log 7-1model number, HBA port 6-2MTU, path, definition of Glossary-5IS0054602-00 B Index-5

SANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersSNNAS, definition of Glossary-4neighborcache (IPv6), viewing 6-11IP address 6-12MAC address 6-12network attached storage, definitionof Glossary-4network interface controller, definitionof Glossary-5networked system configuration 4-2next hop IP address 6-11NIC, definition of Glossary-5non-agent JNI activity, tracing 6-21nonvolatile random access memory, definitionof Glossary-5number of packets 6-4, 6-5NVRAM, definition of Glossary-5OONC, definition of Glossary-5ONC/RPC Portmapper 3-3Open dialog box 4-22open network computing, definitionof Glossary-5operating systems, requirements 3-5overviewproduct 2-1system 3-1Ppacketsnumber of 6-5number to test 6-4size of 6-4, 6-5passwordauthorization, setting security 5-11default 5-12host access, setting 5-13requiring for security 5-11patch update file 4-22path MTUdefinition of Glossary-5IPv6 destination cache log 6-11packet size, Ping page 6-4path, definition of Glossary-5phone number, contacting QLogic 1-4Ping page 6-3, 6-4, 6-5Ping Status dialog box 6-5pingingIPv4 target 6-4IPv6 target 6-5target 6-3point-to-point, definition of Glossary-5pollingHBA 5-16host 5-16polling intervalHBA, setting 5-17host status alarms 5-16host, setting 5-18Polling Setting dialog box 5-17portalias name, iSCSI HBA 6-2definition of Glossary-5HBA, general information about 6-2icons and text 5-6state of HBA 6-2prefix, IPv6 6-15pre-installation summary 4-13problems and solutions 7-2productfeatures offered 2-1features, choosing 4-7information, viewing 5-10overview 2-1prompting behavior, tool options 5-20Index-6IS0054602-00 B

ASANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersQQLogiccontacting 1-4technical support 1-4Web site, downloading installer from 4-3QLxxxx HBAs supported by SANsurfer FCHBA Manager 3-6questions and answers A-1quick start guide 1-3RRAID subsystems 3-1RAM requirement 3-4read/write buffer test, running 6-18readme.txt file 1-3, 4-6, 7-2recordscore dump, retrieving 7-23Flash NVRAM, retrieving 7-26HBA crash, retrieving 7-29Red Hat/SUSE Linux, driverlayers Glossary-2refresh host prompt 5-20refreshing configuration 5-15, 5-21immediately 5-16related documents 1-3release notes 1-3remote agentdefined 7-1issues, solutions for 7-4remote network hardware, finding addressesof 6-7, 6-8remote procedure calls (RPC) 3-3removing SANsurfer 4-24 to 4-30requirementshardware 3-4software 3-5system 3-1, 3-4retrievingFlash NVRAM record 7-26HBA core dump record 7-23HBA crash record 7-29host status alarms 5-15root or administrator privileges 5-11routerIP address 6-14lifetime 6-14list log (IPv6), viewing 6-13RPC (remote procedure calls) 3-3RPC service (ONC/RPC Portmapper) 3-3runningloopback test 6-16read/write buffer test 6-18SSAN, definition of Glossary-5SANsurferinstalling 4-1, 4-3uninstalling 4-24 to 4-30updating 4-17by package update 4-21 to 4-24via Web 4-17 to 4-21SANsurfer icon 4-12SANsurfer.EXE file 5-2Save Crash Record dialog box 7-31Save FW Coredump dialog box 7-25Save FW Flash & NVRAM dialog box 7-28saving browser location 5-10SCSI, definition of Glossary-5securityhost password, setting 5-13setting 5-11Security page 5-13Select Update dialog box 4-18, 4-21Server Proxy Settings dialog box 4-19setting updiagnostic test parameters 6-16SANsurfer iSCSI HBA Manager 5-11shortcutdesktop icon (Windows) 4-12selecting profile 4-11slow system, cause for 5-18software required for SANsurfer FC HBAManager 3-2, 3-5IS0054602-00 B Index-7

SANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus AdaptersSSolarisCLI installation on 4-17SPARC/x86 driver structure Glossary-2starting SANsurfer on 5-2uninstalling SANsurfer 4-25solutions to problems 7-2source address, IPv6 6-4standalone installer command lines 4-15standalone system configuration 4-2startinginstaller 4-4SANsurfer on Linux 5-2SANsurfer on Solaris 5-2SANsurfer on Windows 5-1state, HBA port 6-2statistics feature 2-3status alarms, retrieving host 5-15, 5-16status bar 5-5storage area network, definition of Glossary-5summary, pre-installation 4-13support. See technical supportsysfs, definition of Glossary-6systemoverview 3-1requirements 3-1, 3-4tree pane 5-5system configurations 4-2Ttarget addressIPv6 6-4target binding, definition of Glossary-6targetsdefinition of Glossary-6IPv4 address 6-4pinging 6-3, 6-4session connection state feature 2-3status alarm, refreshing configuration 5-19technical support 1-4availability 1-4contacting QLogic 1-4training 1-4telephone number, contacting QLogic 1-4terms, definitions of Glossary-1test parameters, setting 6-16testing, starting and stopping a ping 6-3title bar 5-4tool tabs 5-4toolbar 5-4tools, diagnostic 7-2topic icon 5-8tracingagent activity 6-21, 7-14iSDMAPI activity 6-21non-agent JNI activity 6-21user interface activity 6-21, 7-14UNIX OS 7-20Windows OS 7-19training, certification 1-4tree naming mode 5-14troubleshooting tools 7-1HBA driver, verifying installation 7-12problems and solutions 7-2functional issues 7-9installation issues 7-3remote agent issues 7-4user interface issues 7-4retrieving records 7-22SANsurfer iSCSI HBA Manager tools 7-2verifying HBA driver is installed 7-12verifying iqlremote installation 7-13Windows event log 7-1UUninstall Complete dialog box 4-30Uninstall Options dialog box 4-27Uninstall SANsurfer dialog box 4-26, 4-29uninstallingold version before installing new 4-10SANsurfer 4-24 to 4-30UNIX, tracing user interface activity 7-20Update dialog box 4-20, 4-23Index-8IS0054602-00 B

ASANsurfer iSCSI HBA Manager User’s GuideManagement Tool for QLogic iSCSI Host Bus Adaptersupdating SANsurfer 4-17by package update 4-21 to 4-24via Web 4-17 to 4-21user interfaceactivity, tracing automatically 6-21activity, tracing with debug 7-14logging file, creating on Windows 7-19main window 5-3trace facility, enabling (UNIX) 7-20trace facility, enabling (Windows) 7-15VverifyingHBA driver installation 7-12iqlremote is installed 7-13version of product, viewing 5-10video card, requirements 3-4viewingARP log 6-6connection error log 6-8help system 5-8IPv6 destination cache log 6-10IPv6 local prefix list log 6-14IPv6 neighbor cache log 6-11IPv6 router list log 6-13WWeb browserspecifying for help 5-9supported versions 3-5web_supported_update_iscsi_hba.txtfile 4-22what’s in the help system 5-9what’s in this guide 1-1Windowsdriver level structure Glossary-2event log 7-1starting SANsurfer on 5-1tracing user interface activity 7-15uninstalling SANsurfer 4-24wrap plug, external loopback test 6-16IS0054602-00 B Index-9

DCorporate Headquarters QLogic Corporation 26650 Aliso Viejo Parkway Aliso Viejo, CA 92656 949.389.6000 www.qlogic.comEurope Headquarters QLogic (UK) LTD. Quatro House Lyon Way, Frimley Camberley Surrey, GU16 7ER UK +44 (0) 1276 804 670© 2008 QLogic Corporation. Specifications are subject to change without notice. All rights reserved worldwide. QLogic, QLA, the QLogic logo, SANbox, and SANblade, and are registeredtrademarks of QLogic Corporation. Adobe and Adobe Reader are registered trademarks of Adobe Systems Incorporated. IBM is a registered trademark of International Business MachinesCorporation. InstallAnywhere and the InstallAnywhere logo are trademarks or registered trademarks of Zero G Software, Inc. Linux is a registered trademark of Linus Torvalds. Macintosh andMac OS are registered trademarks of Apple, Inc. Microsoft, Windows, Windows Server, and Internet Explorer are registered trademarks of Microsoft Corporation. Firefox is a registered trademarkof the Mozilla Foundation. Netscape Communicator is a registered trademark of Netscape Communications Corporation. Pentium is a registered trademark of Intel Corporation. Red Hatis a registered trademark of Red Hat, Inc. SPARC is a registered trademark of SPARC International, Inc. Sun, Java, JVM, Solaris, and Ultra are trademarks or registered trademarks of SunMicrosystems, Inc. SUSE is a trademark of Novell, Inc. All other brand and product names are trademarks or registered trademarks of their respective owners. Information supplied by QLogicCorporation is believed to be accurate and reliable. QLogic Corporation assumes no responsibility for any errors in this brochure. QLogic Corporation reserves the right, without notice, to makechanges in product design or specifications.