Qlogic SANsurfer FC HBA Manager User manual

SN0054651-00 G
SANsurfer FC HBA Manager
User’s Guide
Management Tool for
QLogic FC and FCoE Adapters

ii SN0054651-00 G
S
SANsurfer FC HBA Manager User’s Guide
Management Tool for QLogic FC and FCoE Adapters
Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no
responsibility for its use, nor for any infringements of patents or other rights of third parties which may result from its
use. QLogic Corporation reserves the right to change product specifications at any time without notice. Applications
described in this document for any of these products are for illustrative purposes only. QLogic Corporation makes no
representation nor warranty that such applications are suitable for the specified use without further testing or
modification. QLogic Corporation assumes no responsibility for any errors that may appear in this document.
QLA, QLogic, QLogic Simplify, the QLogic logo, and SANsurfer are registered trademarks of QLogic
Corporation.
Apple, Mac OS, Macintosh, and Power Mac are registered trademarks, and Finder, Tiger, Leopard, and Safari
are trademarks of Apple, Inc., registered in the U.S. and other countries.
EMC and CLARiiON are registered trademarks of EMC Corporation.
Firefox is a registered trademark of the Mozilla Foundation.
InstallAnywhere and the InstallAnywhere logo are trademarks or registered trademarks of Zero G Software, Inc.
Intel and Pentium are trademarks of Intel Corporation in the U.S. and other countries.
JasperReports is a trademark of JasperSoft, Inc. in the United States and other countries.
Linux is a registered trademark of Linus Torvalds.
Microsoft, Excel, Internet Explorer, Windows, Windows 2000, Windows Server 2003, Windows XP Professional,
Windows Vista, and Windows Server 2008 operating systems are registered trademarks of Microsoft
Corporation in the United States and other countries.
Netscape and Netscape Communicator are registered trademarks of Netscape Communications Corporation in
the United States and other countries.
Novell, NetWare, and SUSE are registered trademarks of Novell, Inc.
Power PC is a registered trademark of International Business Machines Corporation in the United States, other
countries, or both.
Red Hat and Enterprise Linux are registered trademarks of Red Hat, Inc. in the United States and other
countries.
Sun, Solaris, Java, JVM, JavaScript, JDK (Java SE Development Kit), and Ultra are trademarks of Sun
Microsystems, Inc., in the United States and other countries.
SPARC is a registered trademark of SPARC International, Inc. Products bearing SPARC trademarks are based
on an architecture developed by Sun Microsystems, Inc.
StuffIt is a registered trademark of Smith Micro Software, Inc.
VMware is a registered trademark of VMware, Inc.
All other brand and product names are trademarks or registered trademarks of their respective owners.
Document Revision History
Revision A, February 2008
Revision B, June 2008
Revision C, November 2008
Revision D, December 2008
Revision E, January 2009
Revision F, February 2009
Revision G, July 2009

SANsurfer FC HBA Manager User’s Guide
Management Tool for QLogic FC and FCoE Adapters
SN0054651-00 G iii
S
Changes Sections Affected
Revision B changes:
General edits. Most
Modified guide subtitle. Management Tool for QLogic FC and FCoE Adapt-
ers
Modified product overview and features descrip-
tions. 1 SANsurfer FC HBA Manager Overview, “Fea- tures” on page 1-2
Added VMware ESX to the software requirements. “Software Requirements” on page 3-2
Modified system overview introductory text. 2 System Overview
Added support for QLE8042 converged network
adapter (CNA). 1 Introduction, “Related Documents” on page 1-4, “Hardware Requirements” on page 3-1, “Sup-
ported QLogic Adapters” on page 3-4
Removed support for combo installation. “Initial Installation” on page 4-1, “Uninstalling SAN-
surfer” on page 4-27
Excluded Windows Vista and Windows 2008
Server from Windows shortcut profile and desktop
icon creation.
“Installation Instructions” on page 4-3
Updated toolbar to show Stats button renamed
Monitor.“Toolbar Buttons” on page 5-7
Added FCoE engine icon. “Adapter Icons and Text” on page 5-9
Changed “Linux Only” to “Linux Failover Driver
Only.” “Specifying the Adapter Driver Settings” on page 5-29
Modified diagnostics introductory text. 6 Performing Diagnostics
Changed 23xx/24xx to 2xxx to indicate all sup-
ported 2000 series QLogic HBAs. “Finding the Adapter Port You Want to Test” on
page 6-2
Added definitions of CNA, Enhanced Ethernet, and
FCoE. Glossary
Revision C changes:
Added note on downloading service packs from
the website. page 1-2
Added descriptions of advanced features. “Advanced Features” on page 1-4
Updated “Available Driver Features by Operating
System.” Table 2-1
Moved wrongly placed NOTE from NetWare to
Linux topic. page 2-12

iv SN0054651-00 G
S
SANsurfer FC HBA Manager User’s Guide
Management Tool for QLogic FC and FCoE Adapters
Removed all references to QLdirect. page 2-8, page 7-9
Changed required processor speed from 450 Mhz
to 1Ghz or higher. “Hardware Requirements” on page 3-1
Updated the browser requirements for viewing the
help system. “Software Requirements” on page 3-2
Corrected Mac OS software requirements. page 3-3
Added QLE2564 to list of supported HBAs. “Supported QLogic Adapters” on page 3-4
Removed instructions to install the application from
CD-ROM since the CD no longer includes the
installation package.
“Installation Instructions” on page 4-3
Added VMware ESX Server Silent Installation Pro-
cedures. “Installation Instructions for VMware ESX 3.5” on page 4-20
Updated the procedures for using application help. “Viewing the Help System” on page 5-13
Corrected NOTE to show that the loopback is dis-
abled on all Linux inbox drivers. “Preparing for Diagnostic Testing” on page 6-2
Removed the “Reports” chapter, which is covered
in the application help.
Added keyboard shortcut to launch the Agent
(qlremote) Update Wizard. page B-2
Edited multiple definitions for consistency and
added the following new definitions: DCBX, Echo
diagnostic test, LIP, NPIV, QoS, and T11.
Glossary
Revision D changes:
Updated Linux and Solaris steps for downloading
an installation package. page 4-5
Added parenthetical statement to second bulleted
item that notes the feature limitation. page 6-1
Revision E changes:
Applied new page template and formats. entire manual
Revision F changes:
Updated text and screens to show updated naming
conventions and QLogic logo. entire manual
Revision G changes:
Added reference to QLE81xx Converged Net-
work Adapter Installation Quick Start Guide Related Materials

SANsurfer FC HBA Manager User’s Guide
Management Tool for QLogic FC and FCoE Adapters
SN0054651-00 G v
S
Added install Agent only command installation
instructions and note for CLI command samples. “Installation Instructions Using CLI” on page 4-17
Added installation-related trouble-shooting issues. “Installation Issues” on page 7-4

vi SN0054651-00 G
S
SANsurfer FC HBA Manager User’s Guide
Management Tool for QLogic FC and FCoE Adapters

SN0054651-00 G Preliminary vii
Table of Contents
Preface
What’s in this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
Related Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
License Agreements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi
Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi
Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi
Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi
Contact Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii
1 SANsurfer FC HBA Manager Overview
Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Advanced Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
2 System Overview
Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Single-Ported (Non-failover) Configuration . . . . . . . . . . . . . . . . . . . . . 2-2
Simple Failover Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
SAN or Cluster Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
RAID Configuration and LUN Masking . . . . . . . . . . . . . . . . . . . . . . . . 2-5
Installation Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
Step 1: Collect the Hardware and Software. . . . . . . . . . . . . . . . . . . . . 2-7
Step 2: Install the Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
Step 3: Install the Enhanced Driver . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
Step 4: Install any RAID Filter Drivers . . . . . . . . . . . . . . . . . . . . . . . . 2-10
Step 5: Install and Run SANsurfer FC HBA Manager . . . . . . . . . . . . 2-11
Step 6: Configure the Disks in the Operating System . . . . . . . . . . . . 2-12
Step 7: Install the IP Communications Driver . . . . . . . . . . . . . . . . . . . 2-12
Non-Windows Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Linux Enhanced Driver Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Macintosh Basic Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
NetWare Enhanced Driver Configuration Parameters. . . . . . . . . . . . . 2-13

viii SN0054651-00 G
SANsurfer FC HBA Manager User’s Guide
Management Tool for QLogic FC and FCoE Adapters S
3 System Requirements
Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Supported QLogic Adapters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
4 Installing SANsurfer FC HBA Manager
Initial Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Installation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Installation Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Installation Instructions Using CLI. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17
Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18
Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18
Solaris. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19
Installation Instructions for VMware ESX 3.5 . . . . . . . . . . . . . . . . . . . 4-20
Web- and CD-Based Installation Updates . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21
Updating SANsurfer by Web Update. . . . . . . . . . . . . . . . . . . . . . . . . . 4-21
Network Does Not Use Proxy Settings. . . . . . . . . . . . . . . . . . . . 4-22
Network Requires Proxy Settings. . . . . . . . . . . . . . . . . . . . . . . . 4-22
Updating SANsurfer by Package Update . . . . . . . . . . . . . . . . . . . . . . 4-24
Uninstalling SANsurfer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27
5 Getting Started
Starting SANsurfer FC HBA Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
Starting SANsurfer FC HBA Manager on Windows. . . . . . . . . . . . . . . 5-2
Starting SANsurfer FC HBA Manager on Linux or Solaris. . . . . . . . . . 5-3
Starting SANsurfer FC HBA Manager on Macintosh. . . . . . . . . . . . . . 5-3
Connecting to Hosts Automatically (Windows CLI). . . . . . . . . . . . . . . 5-3
Connecting to Hosts Automatically (Linux, Solaris, or Macintosh CLI) 5-4
SANsurfer FC HBA Manager Main Window. . . . . . . . . . . . . . . . . . . . . . . . . 5-5
Toolbar Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
Host Icons and Text. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9
Adapter Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9
Adapter Port Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10
Device Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11
LUN Icons and Text. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
Exiting SANsurfer FC HBA Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
Viewing the Help System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13
Specifying the Help Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14
Viewing SANsurfer FC HBA Manager Tool Information . . . . . . . . . . . 5-15

SN0054651-00 G ix
SANsurfer FC HBA Manager User’s Guide
Management Tool for QLogic FC and FCoE Adapters
A
Setting SANsurfer FC HBA Manager Security. . . . . . . . . . . . . . . . . . . . . . . 5-16
Setting the Warning Display Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18
Setting the Configuration Change Option. . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
Setting Application Event Log Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20
Setting the HBA Event Log Option. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21
Setting Up Automatic Notification by E-mail. . . . . . . . . . . . . . . . . . . . . . . . . 5-23
Setting the Configuration Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24
Forbidden Sharing of Devices or LUNs. . . . . . . . . . . . . . . . . . . . . . . . 5-28
Specifying the Adapter Driver Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-29
Refreshing the Host Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-32
6 Performing Diagnostics
Running Loopback and Read/Write Buffer Diagnostic Tests . . . . . . . . . . . . 6-1
Preparing for Diagnostic Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
Finding the Adapter Port You Want to Test. . . . . . . . . . . . . . . . . 6-2
Preparing for the Loopback Test. . . . . . . . . . . . . . . . . . . . . . . . . 6-3
Preparing for the Read/Write Buffer Test . . . . . . . . . . . . . . . . . . 6-5
Running the Loopback Test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6
Running the Read/Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6
Viewing Adapter Port Transceiver Details . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8
Media Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8
Diagnostic Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9
Details Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10
7 Troubleshooting
Troubleshooting Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1
Windows Event Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1
Linux Messages File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
Solaris Messages File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3
SANsurfer FC HBA Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3
Troubleshooting Problems and Solutions. . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3
Installation Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4
User Interface and Remote Agent Issues . . . . . . . . . . . . . . . . . . . . . . 7-5
Functional Issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8
Verifying that the Adapter Driver is Installed . . . . . . . . . . . . . . . . . . . . . . . . 7-11
Verifying that qlremote is Installed and Running . . . . . . . . . . . . . . . . . . . . . 7-13
Tracing SANsurfer FC HBA Manager and Agent Activity (Debug). . . . . . . . 7-15
Tracing SANsurfer FC HBA Manager User Interface Activity . . . . . . . 7-15

xSN0054651-00 G
SANsurfer FC HBA Manager User’s Guide
Management Tool for QLogic FC and FCoE Adapters S
Exporting or Saving Agent Activity Logs . . . . . . . . . . . . . . . . . . . . . . . 7-20
Agent Logs by Operating System. . . . . . . . . . . . . . . . . . . . . . . . 7-20
Exporting or Saving the Agent Logs. . . . . . . . . . . . . . . . . . . . . . 7-20
A Frequently Asked Questions
B Shortcut Keys
Glossary
Index
List of Figures
Figure Page
2-1 Single-Ported (Non-failover) Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
2-2 Simple Failover Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
2-3 SAN or Cluster Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
2-4 RAID Configuration and LUN Masking. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
4-1 SANsurfer Download Selections (Example). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
4-2 Install SANsurfer: Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
4-3 Install SANsurfer: Important Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
4-4 Install SANsurfer: Choose Product Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
4-5 Macintosh Installation: Choose Product Features . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
4-6 Install SANsurfer: Choose Install Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
4-7 Previous SANsurfer Install Detected Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
4-8 Install SANsurfer: Select Shortcut Profile (Windows Only) . . . . . . . . . . . . . . . . . . . 4-11
4-9 Install SANsurfer: Create Desktop Icon Selection (Windows Only). . . . . . . . . . . . . 4-12
4-10 Install SANsurfer: Pre-Installation Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13
4-11 Install SANsurfer: Installing SANsurfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14
4-12 Install SANsurfer: Novell NetWare Disk Selection . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14
4-13 Install SANsurfer: Default QLogic Failover Enable/Disable . . . . . . . . . . . . . . . . . . . 4-15
4-14 Install SANsurfer: Launch SANsurfer Application . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16
4-15 Install SANsurfer: Install Complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17
4-16 Update SANsurfer: Select Update Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21
4-17 Update SANsurfer: Server Proxy Settings Dialog Box. . . . . . . . . . . . . . . . . . . . . . . 4-22
4-18 Update SANsurfer: Update Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23
4-19 Update SANsurfer: Select Update Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24
4-20 Update SANsurfer: Open Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-25
4-21 Update SANsurfer: Update Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-26
4-22 Uninstall SANsurfer: Add/Remove Programs (Windows 2000) . . . . . . . . . . . . . . . . 4-28
4-23 Uninstall SANsurfer: Uninstall SANsurfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29
4-24 Uninstall SANsurfer: Uninstall Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-30
4-25 Uninstall SANsurfer: Choose Product Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31
4-26 Uninstall SANsurfer: Uninstall SANsurfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-32
4-27 Uninstall SANsurfer: Uninstall Complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-33

SN0054651-00 G xi
SANsurfer FC HBA Manager User’s Guide
Management Tool for QLogic FC and FCoE Adapters
A
5-1 SANsurfer Icon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
5-2 SANsurfer FC HBA Manager Main Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
5-3 Browser Location Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14
5-4 About SANsurfer FC HBA Manager Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15
5-5 Security Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
5-6 Options Dialog Box: Warning Displays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18
5-7 Options Dialog Box: Configuration Change . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
5-8 Options Dialog Box: App Event Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21
5-9 Options Dialog Box: HBA Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-22
5-10 Email Settings Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-23
5-11 Policy Settings Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25
5-12 Shared Device Found Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28
5-13 Shared Components Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-29
5-14 Settings Page (Adapter Driver) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30
5-15 Settings Page (Linux Failover Driver Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-31
6-1 Transceiver Details Page: General Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8
6-2 Transceiver Details Page: Details Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10
7-1 Windows: Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-13
7-2 Local.properties File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-16
7-3 Agent.properties File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-16
7-4 SANsurfer.lax File Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-18
7-5 “Command Prompt” Properties Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-19
List of Tables
Table Page
2-1 Available Driver Features by Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
4-1 Configuration Option Installation Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
5-1 Traffic Signals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
5-2 Toolbar Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
6-1 Driver Versions That Do Not Require a Loopback Connector . . . . . . . . . . . . . . . . . 6-4
7-1 Troubleshooting: Installation Issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4
7-2 Troubleshooting: User Interface and Remote Agent Issues. . . . . . . . . . . . . . . . . . . 7-5
7-3 Troubleshooting: Functional Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9
A-1 Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
B-1 Shortcut Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1

xii SN0054651-00 G
SANsurfer FC HBA Manager User’s Guide
Management Tool for QLogic FC and FCoE Adapters S

SN0054651-00 G xiii
Preface
The SANsurfer FC HBA Manager User’s Guide describes the SANsurfer FC HBA
Manager tool, used to configure and manage QLogic SANsurfer Fibre Channel
(FC) host bus adapters (HBAs) and Fibre Channel over Ethernet (FCoE)
converged network adapters (CNAs) within storage area networks (SANs).
What’s in this Guide
This guide contains the basic information you need to get started with the
graphical user interface (GUI)-based SANsurfer FC HBA Manager management
tool.
This preface explains the typographic conventions used in this guide, lists related
documents, specifies the intended audience, refers you to the QLogic license
agreements, and provides technical support and contact information.
The remainder of the user's guide contains the following sections and appendices:
Section 1 SANsurfer FC HBA Manager Overview describes the features of
SANsurfer FC HBA Manager.
Section 2 System Overview outlines the hardware and software installation
of devices controlled by SANsurfer FC HBA Manager.
Section 3 System Requirements lists the hardware and software
requirements needed for optimum SANsurfer FC HBA Manager
performance.
Section 4 Installing SANsurfer FC HBA Manager describes how to install
and uninstall SANsurfer FC HBA Manager.
NOTE:
Throughout this guide, HBA and adapter are used interchangeably, as are
the terms target and device.
NOTE:
For detailed information about the features and functionality not covered in
this guide, refer to the help system (see “Getting Help” on page 5-12).

xiv SN0054651-00 G
S
Section 5 Getting Started describes how to customize the SANsurfer FC
HBA Manager. It includes starting and exiting the SANsurfer FC HBA
Manager user interface, getting help, setting security, and setting the options
that activate each time you start SANsurfer FC HBA Manager.
Section 6 Performing Diagnostics provides details for setting up, running,
and interpreting loopback and read/write buffer tests, as well as viewing
adapter port SFF-DMI information.
Section 7 Troubleshooting presents common troubleshooting questions and
answers. It also provides the procedures for tracing the SANsurfer FC HBA
Manager user interface and agent activity, if directed to do so by your
authorized service provider.
Appendix A Frequently Asked Questions lists and provides the answers to
frequently asked questions about SANsurfer FC HBA Manager.
Appendix B Shortcut Keys lists keyboard combinations used to perform
tasks in SANsurfer FC HBA Manager.
Glossary lists common hardware, software, and FC terms that are used in
SANsurfer FC HBA Manager.
In addition, at the end of this guide is a index to help you easily locate information.
Intended Audience
This guide is for system administrators who are responsible for installing,
configuring, and managing QLogic adapters using the SANsurfer FC HBA
Manager.
Related Materials
For additional help installing or using the SANsurfer FC HBA Manager, refer to the
following related documents:
QLE81xx Converged Network Adapter Installation Quick Start Guide, part
number FE0254501-00
QLogic 2Gb–8Gb FC HBA Quick Start Guide, part number FC0054505-00
readme.txt - SANsurfer notes included with SANsurfer FC HBA Manager
SANsurfer FC HBA Manager Release Notes - Details about the modifications
since the previous version. There are separate release notes based on the
operating system
QLE8042, QLE8042-SR Converged Network Adapter Installation Quick
Start Guide, part number FE0154501-00

SN0054651-00 G xv
A
Documentation Conventions
This guide uses the following documentation conventions:
NOTE: provides additional information.
CAUTION! indicates the presence of a hazard that has the potential of
causing damage to data or equipment.
WARNING!! indicates the presence of a hazard that has the potential of
causing personal injury.
Text in blue font indicates a hyperlink (jump) to a figure, table, or section in
this guide, and links to Web sites are shown in underlined blue. For
example:
Table 9-2 lists problems related to the user interface and remote agent.
See “Installation Checklist” on page 3-6.
For more information, visit www.qlogic.com.
Text in bold font indicates user interface elements such as a menu items,
buttons, check boxes, or column headings. For example:
Click the Start button, point to Programs, point to Accessories, and
then click Command Prompt.
Under Notification Options, select the Warning Alarms check box.
Text in Courier font indicates a file name, directory path, or command line
text. For example:
To connect to a group of hosts listed in a host group file (.hst), type
SANsurfer -g path and then press ENTER.
Enter the following command: sh ./install.bin
Key names and key strokes are indicated with UPPERCASE:
Press CTRL+P.
Press the UP ARROW key.

xvi SN0054651-00 G
S
Text in italics indicates terms, emphasis, variables, or document titles. For
example:
For a complete listing of license agreements, refer to the QLogic
Software End User License Agreement.
What are shortcut keys?
QLA2xxx (where xxx is 440, 460, 462).
Topic titles between quotation marks identify related topics either within this
manual or in the online help, which is also referred to as the help system
throughout this document.
License Agreements
Refer to the QLogic Software End User License Agreement for a complete listing
of all license agreements affecting this product.
Technical Support
Customers should contact their authorized maintenance provider for technical
support of their QLogic switch products. QLogic-direct customers may contact
QLogic Technical Support; others will be redirected to their authorized
maintenance provider.
Visit the QLogic support Web site listed in Contact Information for the latest
firmware and software updates.
Availability
QLogic Technical Support for products under warranty is available during local
standard working hours excluding QLogic Observed Holidays.
Training QLogic offers training for technical professionals for all iSCSI, InfiniBand, and
Fibre Channel products. From the main QLogic web page at www.qlogic.com,
click the Education and Resources tab at the top, then click the Education &
Training tab on the left. The QLogic Global Training Portal offers online courses,
certification exams, and scheduling of in-person training.
Technical Certification courses include installation, maintenance and
troubleshooting QLogic SAN products. Upon demonstrating knowledge using live
equipment, QLogic awards a certificate identifying the student as a Certified
Professional. The training professionals at QLogic may be reached by e-mail at
[email protected].

SN0054651-00 G xvii
A
Contact Information
Please feel free to contact your QLogic approved reseller or QLogic Technical
Support at any phase of integration for assistance. QLogic Technical Support can
be reached by the following methods:
The QLogic knowledge database contains troubleshooting information for the
QLogic adapters. Access the data base from the QLogic Support Web page,
http://support.qlogic.com. Use the Support Center search engine to look for
specific troubleshooting information.
Web http://support.qlogic.com
Email [e-mail]

xviii SN0054651-00 G
S
Notes

SN0054651-00 G 1-1
1SANsurfer FC HBA
Manager Overview
QLogic SANsurfer FC HBA Manager is a collection of device drivers and
GUI-based device management tools for configuring and managing QLogic Fibre
Channel (FC) and Fibre Channel over Ethernet (FCoE) adapters.
Environments
SANsurfer FC HBA Manager is a client/server tool supported on multiple
operating systems.
SANsurfer FC HBA Manager allows control of heterogeneous environments
by supporting multiple operating systems, including:
Windows®XP Professional, Windows 2000, Windows Server®2003,
Windows Vista®, Windows Server 2008
Red Hat®Linux®Advance Server, Novell SUSE®Linux Enterprise
Server (SLES)
Solaris®SPARC®, Solaris x86
Novell®NetWare®
Mac OS®X
VMware®ESX
NOTE:
Throughout this guide, the term Windows refers to all supported versions of
the Microsoft Windows operating system, including Windows XP
Professional, Windows 2000, Windows Server 2003, Windows Vista, and
Windows Server 2008, unless otherwise specified.

SANsurfer FC HBA Manager Overview
Features
1-2 SN0054651-00 G
S
SANsurfer FC HBA Manager is a client/server tool. The networking
capability of the tool allows for centralized management and configuration of
QLogic Fibre Channel adapters and converged network adapters within the
entire SAN. For scripting capabilities, use the SANsurfer Command Line
Interface (CLI) tool.
Features
SANsurfer FC HBA Manager provides the following features:
Automatic update management. To easily keep SANsurfer FC HBA
Manager up-to-date at all times by monitoring the tool version number,
enable the Application Version Check feature on the Schedule Task dialog
box (see “Scheduling Tasks” in the help system). You can perform tool
updates (apply updates) from the Web, as well as from an external media
location (CD). Java™ Web Start is also available, which automatically
downloads, caches, and runs the given updates for the SANsurfer FC HBA
Manager tool.
Adapter asset and inventory management. SANsurfer FC HBA Manager
allows you to connect to and disconnect from local and remote hosts. It also
provides information about connected hosts and their attached QLogic
adapters with connected storage devices. Also, the current SAN
configuration is rendered in an easy-to-view two-dimensional drawing for a
specific host.
SAN configuration management. SANsurfer FC HBA Manager allows you
to configure local and remote systems. With SANsurfer FC HBA Manager
you can:
Configure QLogic Fibre Channel adapters and converged network
adapters.
Configure FC target devices.
Compare hosts—This feature allows you to view the differences
between the current host and any saved host configuration, so you
know what has changed in the SAN.
Configure LUNs for a device (load balancing).
Configure LUN path failover.
NOTE:
For specific OS service packs (SPs) and updates, refer to the
descriptions where this software version is posted on the QLogic
website http://support.qlogic.com/support/drivers_software.aspx.