Qlogic SANsurfer FC HBA Manager Application User Manual

Q

Simplify

SANsurfer FC HBA Manager Application

User’s Guide for OEMs

Management Application for

SANblade Fibre Channel Host Bus Adapters

FS0054603-00 C Page i

SANsurfer FC HBA Manager Application User’s Guide for OEMs
Management Application for SANblade Fibre Channel Host Bus 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.

No part of this document may be copied nor reproduced by any means, nor translated nor transmitted to any magnetic
medium without the express written consent of QLogic Corporation.

Adobe, Acrobat, and Reader are registered trademarks of Adobe Systems Incorporated.

InstallAnywhere and the InstallAnywhere logo are trademarks or registered trademarks of Zero G Software, Inc.

Linux is a registered trademark of Linus Torvalds.

Microsoft, Windows NT, and Windows are registered trademarks and Windows Server is a trademark of Microsoft
Corporation.

Netscape is a registered trademark and Netscape Communicator is a trademark of Netscape Communications
Corporation.

Novell and NetWare are registered trademarks of Novell, Inc.

QLogic, the QLogic logo, QLA, SANbox, and SANsurfer are registered trademarks and SANblade and SANbox2 are
trademarks of QLogic Corporation.

Red Hat and all Red Hat-based are trademarks or registered trademarks of Red Hat, Inc.

Solaris is a registered trademark of Sun Microsystems, Inc.

SPARC is a registered trademark of SPARC International, Inc. Products bearing SPARC trademarks are based on
an architecture developed by Sun Microsystems, Inc.

SuSE is a registered trademark of SuSE Linux AG.

All other brand and product names are trademarks or registered trademarks of their respective owners.

Q

Document Revision History

Rev. A release, 10/08/02

Rev. B update, 12/19/03

Rev. C update, 11/19/04

Change Document Sections Affected

Product name change from SANblade™ Manager™ User’s Guide for

OEMs to SANsurfer® FC HBA Manager Application User’s Guide for
OEMs.

Product name change from SANblade Manager to SANsurfer FC HBA
Manager.

Updated documentation to match SANsurfer FC HBA Manager
OEMID65 Version v2.0.29.

Added QLogic QLA200 host bus adapter support. All

Revised hardware requirements:

Minimum Pentium III with 450 MHz or greater for all systems
Added Sun Ultra 60 for Solaris
Minimum 128 MB RAM
Minimum 100 MB of disk space

® SPARC®

All

All

All

All

Page ii FS0054603-00 C

Q

SANsurfer FC HBA Manager Application User’s Guide for OEMs

Management Application for SANblade Fibre Channel Host Bus Adapters

Revised software requirements:

Added Windows 2000 SP4 support
Removed Windows 2000 SP1, SP2, and SP3 support
Removed Windows NT support
Added Red Hat Linux, SuSE Linux, and Solaris SPARC support

Revised component level install and uninstall. 5

Added automatic alarm notification by email (SMTP only). 6.11, 8.2.5

Added connecting to the local host when starting SANsurfer FC HBA
Manager from the command line (Windows and Linux only).

Added HBA port level. Includes changes in the HBA tree and dialog
boxes, as well as other application changes.

Added the General Configuration Wizard. 7.2

Added the LUN Masking Wizard. 7.3

Revised target persistent binding. 7.2, 7.7, 7.8

Added displaying an HBA port’s actual data rate and connection mode. 9.3.1

Added support for a common BIOS. 11.3

Added updating the HBA driver (Windows only). 11.6

All

7.1.3

All

FS0054603-00 C Page iii

SANsurfer FC HBA Manager Application User’s Guide for OEMs

0

Management Application for SANblade Fibre Channel Host Bus Adapters

Q

© 2001–2004 QLogic Corporation. All rights reserved worldwide.

QLogic Corporation, 26650 Aliso Viejo Parkway, Aliso Viejo, CA 92656, [phone] or (949) 389-600

Page iv FS0054603-00 C

First Published: March 2001

Printed in U.S.A.

Table of Contents

Section 1 Introduction

Section 2 System Overview

2.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

2.2 Installation Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

2.2.1 Step 1: Collect the Hardware and Software . . . . . . . . . . . . . . . . . . . . . 2-2

2.2.1.1 Required Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

2.2.1.2 Required Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

2.2.2 Step 2: Install the Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

2.2.3 Step 3: Install the Enhanced Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

2.2.4 Step 4: Install and Run the SANsurfer FC HBA Manager . . . . . . . . . . 2-4

2.2.5 Step 5: Configure the Disks in the Operating System . . . . . . . . . . . . . 2-4

2.2.6 Step 6: Install the IP Communications Driver . . . . . . . . . . . . . . . . . . . 2-4

2.3 Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5

2.3.1 Linux Enhanced Driver Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5

2.3.1.1 Basic Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5

2.3.1.2 Configuration Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5

2.3.2 NetWare Enhanced Driver Configuration Parameters . . . . . . . . . . . . . 2-5

2.4 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5

2.4.1 Troubleshooting Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5

2.4.1.1 Windows Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6

2.4.1.2 Linux Messages File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6

2.4.1.3 Solaris Messages File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6

2.4.1.4 SANsurfer FC HBA Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7

2.4.2 Known Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7

2.4.2.1 ConfigRequired Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7

Section 3 SANsurfer FC HBA Manager Overview

3.1 What is SANsurfer FC HBA Manager?. . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

3.2 Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

Section 4 System Requirements

4.1 Hardware Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

4.2 Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2

4.3 Supported QLogic HBAs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

FS0054603-00 C Page v

SANsurfer FC HBA Manager Application User’s Guide for OEMs
Management Application for SANblade Fibre Channel Host Bus Adapters

Q

Section 5 Installing SANsurfer FC HBA Manager

5.1 Initial Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

5.1.1 Installation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2

5.1.2 Installation Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3

5.2 Uninstalling the SANsurfer Application . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14

Section 6 Getting Started

6.1 Starting the SANsurfer FC HBA Manager GUI . . . . . . . . . . . . . . . . . . . . . 6-1

6.1.1 Starting SANsurfer FC HBA Manager on Windows 2000/Windows

Server 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2

6.1.2 Starting SANsurfer on Red Hat/SuSE Linux or Solaris SPARC . . . . . 6-2

6.2 SANsurfer FC HBA Manager Main Window . . . . . . . . . . . . . . . . . . . . . . . 6-3

6.3 Exiting the SANsurfer FC HBA Manager GUI. . . . . . . . . . . . . . . . . . . . . . 6-6

6.4 Getting Help with the SANsurfer FC HBA Manager GUI . . . . . . . . . . . . . 6-7

6.4.1 Viewing Online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7

6.4.2 Specifying the Browser Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7

6.4.3 Viewing SANsurfer FC HBA Manager Software Information . . . . . . . . 6-8

6.5 Setting SANsurfer FC HBA Manager Security . . . . . . . . . . . . . . . . . . . . . 6-8

6.6 Setting the Warning Display Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10

6.7 Setting the Configuration Change Alarm Option. . . . . . . . . . . . . . . . . . . . 6-11

6.8 Specifying the Polling Interval. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13

6.9 Setting the Event Log Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-14

6.10 Setting the Alarm Log Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15

6.11 Setting Up Automatic Alarm Notification by Email . . . . . . . . . . . . . . . . . . 6-16

6.12 Specifying the HBA Driver Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-17

6.13 Refreshing the Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-19

Section 7 Setting Up Connections

7.1 Connecting to Hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

7.1.1 Manually Connecting to a Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

7.1.2 Auto Connecting to All Hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3

7.1.3 Connecting to Hosts Using a Host Group File . . . . . . . . . . . . . . . . . . . 7-5

7.1.3.1 Creating a Host Group File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5

7.1.3.2 Using a Host Group File to Connect to Hosts . . . . . . . . . . . . . . . . . 7-6

7.1.4 Connecting to Hosts Automatically when Starting the SANsurfer FC

HBA Manager GUI from the Command Line . . . . . . . . . . . . . . . . . . . . 7-6

7.1.4.1 Connecting on Windows 2000/Windows Server 2003 . . . . . . . . . . . 7-7

7.1.4.2 Connecting on Red Hat/SuSE Linux or Solaris SPARC . . . . . . . . . 7-7

7.1.5 Disconnecting from a Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8

Page vi FS0054603-00 C

SANsurfer FC HBA Manager Application User’s Guide for OEMs

Q

7.2 Configuring HBA Ports Using the General Configuration Wizard. . . . . . . 7-9

7.3 Configuring LUN Masking Using the LUN Masking Wizard . . . . . . . . . . . 7-21

7.4 Configuring Fibre Channel Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-27

7.4.1 Configuring Device Paths for this Host . . . . . . . . . . . . . . . . . . . . . . . . 7-30

7.4.1.1 Configuring, Unconfiguring, and Inversing the Configuration of

All Device Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-30

7.4.1.2 Configuring Individual Device Paths . . . . . . . . . . . . . . . . . . . . . . . . 7-31

7.4.2 Configuring LUN Masking for this Host . . . . . . . . . . . . . . . . . . . . . . . . 7-31

7.4.2.1 Enabling and Disabling All LUNs on this Host . . . . . . . . . . . . . . . . . 7-32

7.5 Configuring LUNs for a Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-32

7.5.1 Configure LUN Masking for this Device . . . . . . . . . . . . . . . . . . . . . . . . 7-34

7.5.1.1 Enabling and Disabling LUN Masking on All LUNs . . . . . . . . . . . . . 7-34

7.5.1.2 Enabling and Disabling LUN Masking on Individual LUNs . . . . . . . 7-35

7.6 Viewing HBA Port and Device Information . . . . . . . . . . . . . . . . . . . . . . . . 7-35

7.6.1 Viewing HBA Port Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-35

7.6.2 Viewing Device Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-37

7.7 Binding Target Devices Attached to the HBA Port Using the Fibre

Channel Port Configuration Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . 7-38

7.8 Binding Target Devices Using the Target Persistent Binding

Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-40

7.9 Deleting Persistent Configuration Data. . . . . . . . . . . . . . . . . . . . . . . . . . . 7-43

7.9.1 Deleting HBA Port Persistent Configuration Data . . . . . . . . . . . . . . . . 7-43

7.9.2 Deleting Device Persistent Configuration Data . . . . . . . . . . . . . . . . . . 7-44

7.10 Viewing a Saved Host Configuration from a File (.qlc) . . . . . . . . . . . . . . . 7-45

7.10.1 Saving the Host Configuration to a File . . . . . . . . . . . . . . . . . . . . . . . . 7-45

7.10.2 Viewing the Host Configuration from a File . . . . . . . . . . . . . . . . . . . . . 7-46

7.11 Viewing a Saved Host Configuration from a Text File (.txt) . . . . . . . . . . . 7-48

7.11.1 Saving the Host Configuration to a Text File . . . . . . . . . . . . . . . . . . . . 7-48

7.11.2 Viewing the Host Configuration from a Text File . . . . . . . . . . . . . . . . . 7-49

7.12 Printing a Host Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-50

7.13 Comparing Host Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-50

Management Application for SANblade Fibre Channel Host Bus Adapters

SANsurfer FC HBA Manager

Section 8 Monitoring the Connections

8.1 Viewing and Managing the Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1

8.1.1 Viewing the Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1

8.1.2 Clearing the Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-3

8.1.3 Exporting the Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4

8.1.4 Printing the Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5

8.2 Viewing and Managing the Alarm Log . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-6

8.2.1 Viewing the Alarm Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-7

FS0054603-00 C Page vii

SANsurfer FC HBA Manager Application User’s Guide for OEMs
Management Application for SANblade Fibre Channel Host Bus Adapters

8.2.2 Clearing the Alarm Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-10

8.2.3 Exporting the Alarm Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-11

8.2.4 Printing the Alarm Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-12

8.2.5 Viewing an Alarm Notification Received by Email . . . . . . . . . . . . . . . . 8-13

Q

Section 9 Displaying Host, HBA, HBA Port, Device, and LUN Information

9.1 Displaying Host Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1

9.1.1 Viewing General Host Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2

9.1.2 Viewing Topology Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-3

9.2 Displaying HBA Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4

9.3 Displaying HBA Port Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-5

9.3.1 Viewing General HBA Port Information . . . . . . . . . . . . . . . . . . . . . . . . 9-5

9.3.2 Viewing the Device List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-7

9.3.3 Viewing and Updating HBA Port Statistics . . . . . . . . . . . . . . . . . . . . . . 9-8

9.3.3.1 Viewing HBA Port Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-8

9.3.3.2 Updating HBA Port Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-9

9.3.3.2.1 Updating HBA Port Statistics Manually. . . . . . . . . . . . . . . . . . . . . 9-9

9.3.3.2.2 Updating HBA Port Statistics Automatically . . . . . . . . . . . . . . . . . 9-10

9.3.3.2.3 Resetting HBA Port Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-10

9.3.3.3 Exporting HBA Port Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-11

9.3.4 Viewing Link Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-13

9.4 Displaying Device Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-14

9.4.1 Viewing General Device Information . . . . . . . . . . . . . . . . . . . . . . . . . . 9-15

9.4.2 Viewing the LUN List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-16

9.5 Displaying LUN Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-17

Section 10 Performing Diagnostics

10.1 Preparing for Diagnostic Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2

10.1.1 Finding an HBA Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2

10.1.2 Preparing for the Loopback Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-3

10.1.2.1 Modifying the HBA Settings Connection Options Setting . . . . . . . . 10-4

10.1.2.2 Installing a Loopback Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-4

10.1.3 Preparing for the Read/Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . . 10-5

10.2 Setting the Diagnostic Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 10-6

10.3 Running Diagnostic Tests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-8

10.4 Viewing the Diagnostic Test Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-9

10.4.1 Loopback Test Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-10

10.4.2 Read/Write Buffer Test Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-11

10.5 Preparing for Normal HBA Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-12

Page viii FS0054603-00 C

SANsurfer FC HBA Manager Application User’s Guide for OEMs

Q

Management Application for SANblade Fibre Channel Host Bus Adapters

SANsurfer FC HBA Manager

Section 11 Updating the HBA

11.1 Updating the HBA Port Settings, Advanced HBA Port Settings,

and Boot Device Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1

11.1.1 HBA Port Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-5

11.1.2 Advanced HBA Port Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-8

11.1.3 Boot Device Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-12

11.2 Restoring Default NVRAM Settings from a File . . . . . . . . . . . . . . . . . . . . 11-14

11.3 Updating the Flash BIOS from a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-15

11.4 Updating the FCode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-18

11.5 Saving NVRAM, Flash BIOS, and FCode. . . . . . . . . . . . . . . . . . . . . . . . . 11-20

11.6 Updating the HBA Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-22

Section 12 Troubleshooting

12.1 Troubleshooting Problems and Solutions . . . . . . . . . . . . . . . . . . . . . . . . . 12-1

12.2 Tracing SANsurfer FC HBA Manager GUI and Agent Activity (Debug) . . 12-10

12.2.1 Tracing SANsurfer FC HBA Manager GUI Activity . . . . . . . . . . . . . . . 12-10

12.2.2 Exporting or Saving Agent Activity Logs . . . . . . . . . . . . . . . . . . . . . . . 12-14

12.2.2.1 The Agent Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-14

12.2.2.2 Exporting or Saving the Agent Logs . . . . . . . . . . . . . . . . . . . . . . . . 12-14

Appendix A Frequently Asked Questions

Appendix B Glossary

Appendix C Technical Support

C.1 Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1

C.2 Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1

C.3 Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1

Appendix D Contacting QLogic

FS0054603-00 C Page ix

SANsurfer FC HBA Manager Application User’s Guide for OEMs
Management Application for SANblade Fibre Channel Host Bus Adapters

Q

Figures

Figure Page

5-1 Installation Introduction Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4

5-2 Important Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5

5-3 Choose Product Features Dialog Box (Sample) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6

5-4 Choose Product Components Dialog Box (Sample) . . . . . . . . . . . . . . . . . . . . . . . . . 5-7

5-5 Choose Install Folder Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8

5-6 Select Shortcut Profile Dialog Box (Windows 2000/Windows Server 2003) . . . . . . . 5-9

5-7 Create Desktop Icon Selection Dialog Box (Windows 2000/Windows Server 2003) 5-10

5-8 Pre-Installation Summary Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11

5-9 Installing SANsurfer Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12

5-10 Novell NetWare Disk Selection Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12

5-11 Install Complete Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13

5-12 Add/Remove Programs Dialog Box (Windows 2000) . . . . . . . . . . . . . . . . . . . . . . . . 5-14

5-13 Uninstall SANsurfer Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15

5-14 Uninstall Options Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16

5-15 Choose Product Features Dialog Box (Sample) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17

5-16 Uninstall Component List Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18

5-17 Uninstall Complete Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18

6-1 SANsurfer Icon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2

6-2 SANsurfer FC HBA Manager Main Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

6-3 Browser Location Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7

6-4 About SANsurfer FC HBA Manager Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8

6-5 Security Tabbed Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9

6-6 Options Dialog Box—Warning Displays Section . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10

6-7 Options Dialog Box—Configuration Change Alarm Section . . . . . . . . . . . . . . . . . . . 6-11

6-8 Polling Setting Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13

6-9 Options Dialog Box—Event Log Section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-14

6-10 Options Dialog Box— Alarm Log Section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15

6-11 Email Settings Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16

6-12 HBA Driver Settings Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-18

7-1 Connect to Host Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3

7-2 Broadcast Settings Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4

7-3 HBA Port Selection Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-10

7-4 HBA Port Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-11

7-5 HBA Port Connection Settings Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-13

7-6 Target Persistent Binding Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-15

7-7 Confirm Changes Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-17

7-8 HBA Port Configuration Status Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-19

Page x FS0054603-00 C

SANsurfer FC HBA Manager Application User’s Guide for OEMs

Q

7-9 Finish Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-20

7-10 Device Selection Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-21

7-11 LUN Masking Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-22

7-12 Confirm Changes Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-24

7-13 LUN Masking Configuration Status Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-25

7-14 Finish Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-26

7-15 Fibre Channel Port Configuration Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-27

7-16 LUN Configuration Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-33

7-17 HBA Port Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-35

7-18 Device Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-37

7-19 Fibre Channel Port Configuration Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-39

7-20 Target Persistent Binding Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-41

7-21 Fibre Persistent Configuration Editor for HBA Ports . . . . . . . . . . . . . . . . . . . . . . . . . 7-43

7-22 Fibre Persistent Configuration Editor for Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-44

7-23 Virtual Host Configuration from a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-47

7-24 Host Configuration Text File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-49

7-25 Differences Between Offline Host and Online Host Dialog Box . . . . . . . . . . . . . . . . 7-51

7-26 Changed Components Comparison . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-52

8-1 Event Log Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2

8-2 Event Details Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-3

8-3 Export Event Log—File Name and Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4

8-4 Export Event Log— Sample Output File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5

8-5 HBA Tree with Alarms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-6

8-6 Alarm Log Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-8

8-7 Alarm Details Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-9

8-8 Export Alarm Log—File Name and Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-11

8-9 Export Alarm Log—Sample Output File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-12

8-10 Email Alarm Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-13

9-1 Host Information Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2

9-2 Topology Tabbed Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-3

9-3 HBA Information Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4

9-4 HBA Port Information Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-5

9-5 Device List Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-7

9-6 HBA Port Statistics Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-8

9-7 Statistics Sampling Rate Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-10

9-8 Export HBA Port Statistics—File Name and Location . . . . . . . . . . . . . . . . . . . . . . . . 9-11

9-9 Export HBA Port Statistics— Sample Output File . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-12

9-10 Link Status Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-13

9-11 Device Information Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-15

Management Application for SANblade Fibre Channel Host Bus Adapters

SANsurfer FC HBA Manager

FS0054603-00 C Page xi

SANsurfer FC HBA Manager Application User’s Guide for OEMs
Management Application for SANblade Fibre Channel Host Bus Adapters

9-12 LUN List Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-16

9-13 LUN Information Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-17

10-1 Diagnostics Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-6

10-2 Diagnostic Test Results Section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-9

10-3 Diagnostic Test Results— Loopback Test Failed . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-10

10-4 Diagnostic Test Results— Read/Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . . . . . 10-11

10-5 Data Miscompare Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-12

11-1 Settings Tabbed Page (HBA Port Settings) Sample . . . . . . . . . . . . . . . . . . . . . . . . . 11-2

11-2 Settings Tabbed Page—Multiple HBA Ports Selected . . . . . . . . . . . . . . . . . . . . . . . 11-3

11-3 Settings Tabbed Page (HBA Port Settings) for QLA2xxx HBAs . . . . . . . . . . . . . . . . 11-5

11-4 Settings Tabbed Page (HBA Port Settings) for QLA200 HBAs . . . . . . . . . . . . . . . . . 11-6

11-5 Settings Tabbed Page (Advanced HBA Port Settings) for QLA2xxx HBAs . . . . . . . 11-8

11-6 Settings Tabbed Page (Advanced HBA Port Settings) for QLA200 HBAs . . . . . . . . 11-9

11-7 Settings Tabbed Page (Boot Device Selection) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-12

11-8 Utilities Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-14

11-9 Utilities Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-16

11-10 Utilities Tabbed Page (Solaris SPARC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-18

11-11 Utilities Tabbed Page (Save NVRAM, Flash BIOS, and FCode). . . . . . . . . . . . . . . . 11-20

11-12 Utilities Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-22

11-13 Select Driver Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-23

11-14 Server Proxy Settings Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-24

11-15 Driver Update Complete Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-25

12-1 local.properties File (Example) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-10

12-2 SANsurfer.lax File (Example) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-12

12-3 "Command Prompt" Properties Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-13

Q

Table Page

2-1 Driver and Utility Usage by Function. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

5-1 Configuration Option Installation Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2

10-1 Driver Versions that Do Not Require a Loopback Connector . . . . . . . . . . . . . . . . . . 10-3

11-1 HBA Port Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-7

11-2 Advanced HBA Port Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-10

12-1 Troubleshooting Problems and Solutions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-1

A-1 Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

Page xii FS0054603-00 C

Tables

Section 1

Introduction

The SANsurfer FC HBA Manager Application User’s Guide for OEMs describes
SANsurfer® FC HBA Manager, an application that allows you to configure and
manage devices in a storage area network (SAN) environment that uses QLogic®
Fibre Channel host bus adapters (HBAs).

The contents of this user’s guide are described in the following paragraphs:

■ Section 1—Introduction. This section summarizes the contents of this user’s

guide.

■ Section 2—System Overview. This section outlines the hardware and software

installation of devices controlled by SANsurfer FC HBA Manager.

■ Section 3—SANsurfer FC HBA Manager Overview. This section describes

the purpose and scope of the SANsurfer FC HBA Manager.

■ Section 4—System Requirements. This section lists the hardware and

software requirements needed for optimum SANsurfer FC HBA Manager
performance.

■ Section 5—Installing SANsurfer FC HBA Manager. This section discusses

installing and uninstalling SANsurfer FC HBA Manager.

■ Section 6—Getting Started. This section discusses customizing the SANsurfer

FC HBA Manager. It includes starting and exiting the SANsurfer FC HBA
Manager GUI, getting help, setting security, and setting the options that activate
each time you start the SANsurfer FC HBA Manager.

■ Section 7—Setting Up Connections. This section discusses connecting to

hosts, configuring Fibre Channel devices, configuring LUNs, and persistently
binding targets. This includes saving the host configuration to view from a file.

■ Section 8—Monitoring the Connections. SANsurfer FC HBA Manager

continuously monitors connected hosts and informs you of various conditions
and problems through the alarm log and event log. This section discusses
viewing and managing these logs.

■ Section 9—Displaying Host, HBA, HBA Port, Device, and LUN Information.

This section discusses viewing information about hosts, HBAs, HBA ports,
devices, and LUNs.

■ Section 10—Performing Diagnostics. This section discusses setting up,

running, and interpreting loopback and read/write buffer tests.

■ Section 11—Updating the HBA. This section discusses updating NVRAM

settings, the OptionROM (BIOS or FCode), and the HBA driver.

FS0054603-00 C 1-1

1 – Introduction
Related Documents

■ Section 12—Troubleshooting. This section presents common troubleshooting

questions and answers. It also provides the procedures for tracing SANsurfer
FC HBA Manager GUI and agent activity, if directed to do so by technical support.

■ Appendix A—Frequently Asked Questions. This appendix lists and provides

the answers to frequently asked questions about SANsurfer FC HBA Manager.

■ Appendix B—Glossary. This appendix describes common hardware, software,

and Fibre Channel terms used in SANsurfer FC HBA Manager documentation.

■ Appendix C—Technical Support. Customers should contact their authorized

maintenance provider for technical support of their QLogic HBA products. This
section provides information about technical support availability, training, and
contact information.

■ Appendix D—Contacting QLogic. This section presents information about

contacting QLogic.

1.1

Related Documents

Q

Refer to the following documents as appropriate when installing or using SANsurfer
FC HBA Manager:

Part Number Title

CF2251102-00 SANblade 2200 User’s Guide, 1-Gb Fibre Channel to cPCI and SBus

Host Bus Adapters

FC2254601-00 SANblade 2200 Series User’s Guide, 1-Gb Fibre Channel to PCI Host

Bus Adapters

CF2351102-00 SANblade 2300 Series User’s Guide, 2-Gb Fibre Channel to cPCI

and SBus Host Bus Adapters

FC2354602-00 QLA2310 User’s Guide, 2-Gb Fibre Channel to PCI-X Host Bus

Adapters

FC2354603-00 QLA2310F/2310FL User’s Guide, 2-Gb Fibre Channel to PCI-X Host

Bus Adapters

FC5054601-00 QLA2340/2340L User’s Guide, 2-Gb Fibre Channel to PCI-X Host

Bus Adapters

FC5054602-00 QLA2342/2342L User’s Guide, 2-Gb Fibre Channel to PCI-X Host

Bus Adapters

FC2654601-00 QLA2344 User’s Guide, 2-Gb Fibre Channel to PCI-X Host Bus

Adapters

FL0054601-00 QLA200 User’s Guide, 2-Gbps Fibre Channel to PCI-X Host Bus

Adapter

readme.txt SANsurfer FC HBA Manager application notes display during the

SANsurfer FC HBA Manager application installation in the Important
Information dialog box (see section 5.1.2).

1-2 FS0054603-00 C

2.1

Introduction

SANsurfer FC HBA Manager is a collection of device drivers and management
software for controlling, configuring, and managing devices in a storage area
network (SAN) environment that uses QLogic Fibre Channel (FC) host bus adapters
(HBAs). This section summarizes information from various products and contains
an installation checklist.

The contents of this section are summarized in the following paragraphs:

■ Section 2.1—Introduction

■ Section 2.2—Installation Checklist. This section contains an installation

■ Section 2.3—Configuration Parameters. This section lists configuration and

Section 2

System Overview

checklist to help you install all hardware and software properly and in the correct
order.

tuning parameters.

■ Section 2.4—Troubleshooting. This section lists common troubleshooting

tools to help identify the source of a hardware or software problem.

This information is intended for OEMs, field service personnel, and customers who
are installing QLogic hardware and SANsurfer FC HBA Manager software. This
section assumes that users are familiar with hardware installation and operating
systems where HBAs will be installed.

FS0054603-00 C 2-1

2 – System Overview
Installation Checklist

2.2

Installation Checklist

This section describes the installation process step-by-step. Note that your
configuration may not require all steps, depending on the features you require.

2.2.1

Step 1: Collect the Hardware and Software

2.2.1.1

Required Hardware

Collect the required hardware. In all cases, some combination of the following is
required:

■ QLogic HBAs

■ Target devices such as disks, RAID subsystems, etc. Note that tape devices are

displayed as part of the configuration, but are not supported by SANsurfer (no
support for LUN masking or diagnostics).

Q

■ Connectivity hardware such as cables, hubs, fabric switches, etc.

2.2.1.2

Required Software

Collect the required software. Tab le 2 -1 specifies QLogic software products that are
required for the features you want to enable.

Basic operation x x x

Fabric support x x x

Device selection and masking x x x x

Secure device access x

Heterogeneous support x

IP support x

Device/SAN management x

Table 2-1. Driver and Utility Usage by Function

Linux,

Solaris

Enhanced

Driver

Function

Windows

Miniport

NetWare

Enhanced

Driver

Windows,

Linux,

Solaris,

NetWare

SANsurfer

FC HBA

Manager

2-2 FS0054603-00 C

Q

2.2.2

Step 2: Install the Hardware

Refer to hardware installation guides to install HBAs in host systems (see

section 1.1). Cable target devices through the combination of local loops, hubs, and

switches in your configuration.

Verification Before installing the device driver, verify the presence of HBAs at

power up using the QLogic Fast!UTIL FC HBA BIOS utility. Type
ALT+Q or CTRL+Q during power up to enter Fast!UTIL. Fast!UTIL
allows you to perform basic HBA configuration. Fast!UTIL can verify
device connectivity for loop and hub topologies, but does not find
devices on fabric configurations.

2.2.3

Step 3: Install the Enhanced Driver

Refer to the appropriate software installation guide (see section 1.1) and readme.txt
file to install an enhanced device driver on host systems.

2 – System Overview

Installation Checklist

NOTE: Some operating systems, for example, Windows® 2000, come from the

operating system manufacturer with a QLogic miniport device driver. This
device driver is a standard driver and does not contain the extended
features required to run with SANsurfer FC HBA Manager. You must install
the most current device driver to support features such as LUN masking.
The most current device driver versions can be found at the QLogic web
site (support.qlogic.com

Verification Verify that HBAs recognize target devices by using operating system

device configuration utilities, or use SANsurfer FC HBA Manager to
display target devices found on an HBA.

To mask devices or LUNs, do not format devices, assign drive letters, nor save the
disk configuration.

In Windows 2000/Windows Server 2003, use the computer management utility to
view which target devices are configured on which HBAs, and to view and format
devices and LUNs that are found.

In NetWare, use Scan all LUNs and List Storage Adapters commands to view which
target devices are configured on which HBAs. You can use the nwconfig utility or
hdetect utility to view the devices and LUNs that are found.

In Linux, open /var/log/messages to view which target devices are configured on
which HBAs. Entries are also created for each HBA recognized by the driver. Each
entry contains information about target devices and LUNs that are found.

).

In Solaris, open /var/adm/messages to view which target devices are configured on
which HBAs.

FS0054603-00 C 2-3

2 – System Overview
Installation Checklist

2.2.4

Step 4: Install and Run the SANsurfer FC HBA Manager

SANsurfer FC HBA Manager is a management utility to view, manage, and diagnose
QLogic HBAs. SANsurfer FC HBA Manager also configures HBAs, target devices
on HBAs, and LUNs on target devices. To use the target masking and LUN masking
features of SANsurfer FC HBA Manager, you must install SANsurfer FC HBA
Manager. See section 5 for complete installation instructions.

If you do not use any of these features, you can use the miniport driver without
configuring it with SANsurfer FC HBA Manager. In this case, skip to section 2.2.5.

If you are installing SANsurfer FC HBA Manager on a NetWare 6.x operating system,
you must also install IPX/SPX on the server.

SANsurfer FC HBA Manager runs as a client/server application, with the client
application running on a hardware platform that supports Java and agents running
on each system that has QLogic HBAs. If you are using SANsurfer FC HBA Manager
on a host system where HBAs are installed, install the SANsurfer FC HBA Manager
(GUI) on the local host. If you are installing on a Solaris SPARC system, also install
the SANsurfer FC HBA Manager agent on the local host.

Q

NOTE: In SANsurfer FC HBA Manager, remote procedure calls (RPCs) are used.

In Windows, the RPC service (ONC/RPC Portmapper) required by
SANsurfer FC HBA Manager is installed automatically. In Linux, the
appropriate RPC libraries must be installed by the Linux distribution. See
the Linux distribution documentation for information about installing RPC
services before installing SANsurfer FC HBA Manager. In NetWare,
tirpc.nlm and associated files must be loaded for RPC support. These
files are added to the autoexec.ncf file automatically by SANsurfer FC
HBA Manager installation.

2.2.5

Step 5: Configure the Disks in the Operating System

When all hardware and configuration is complete for Fibre Channel subsystems,
use the appropriate operating system utilities to enable devices, assign drive letters
or logical names, initialize file systems, etc., for each device or LUN on the system.

2.2.6

Step 6: Install the IP Communications Driver

Optionally, install the IP communications driver. To use the NDIS driver to enable
IP traffic over the Fibre Channel, install that device driver and its configuration utility.

2-4 FS0054603-00 C

Q

2.3

Configuration Parameters

2.3.1

Linux Enhanced Driver Parameters

2.3.1.1

Basic Parameters

QLogic configuration parameters are stored in the modules.conf file in the
subdirectory /etc. Values of parameters in the file are found in the readme.txt file
associated with the enhanced driver.

2.3.1.2

Configuration Parameter

To maintain backward compatibility, if the configuration cannot be read from
persistent storage, the enhanced driver defaults to the previous operation of
configuring and enabling all devices that are found. Some OEMs indicate that this
is an unacceptable risk when adding a new host to a SAN system and that the
desired operation is to configure no devices instead of all devices. The parameter
value is ConfigRequired=1 (TRUE) in Linux.

2 – System Overview

Troubleshooting

2.3.2

NetWare Enhanced Driver Configuration Parameters

QLogic configuration parameters are stored in the QL2x00.cfg file in the default
DOS directory, C:\Nwserver. Values of parameters in the file are created and saved
by the NetWare agent and not intended for modification or editing.

2.4

Troubleshooting

This section lists troubleshooting tools to help identify the source of a problem in
hardware or software. See section 12 for information about troubleshooting
problems and solutions and for details about tracing SANsurfer FC HBA Manager
GUI and agent activity (debug), as directed by your authorized service provider.
This section also contains a list of known issues related to certain configurations.

2.4.1

Troubleshooting Tools

The following sections explain how to use the Windows event log, Linux messages
file, Solaris messages file, and SANsurfer FC HBA Manager to solve hardware
problems.

FS0054603-00 C 2-5

2 – System Overview
Troubleshooting

2.4.1.1

Windows Event Log

The Windows event log is the main source of information for device driver problems
and events. Device drivers usually indicate only status by logging events in the
system event log. SANsurfer FC HBA Manager agents also use the application
event log to report service errors, etc. For more information, see section 8.1.

The miniport driver logs events for significant driver errors. Due to a limitation of the
Windows miniport driver interface, the miniport can log only two 32-bit values for
any event. Information about interpreting these event codes is in the eventlog.txt
file, which is shipped with the miniport driver.

In addition, the miniport driver can be configured to perform extended event logging
for an HBA, which causes it to log all loop transitions and many minor events.
Extended event logging uses extra overhead and is enabled only in troubleshooting
situations. The extended event logging flag is stored in the HBA NVRAM and can
be modified using Fast!UTIL or SANsurfer FC HBA Manager.

2.4.1.2

Linux Messages File

Q

For Red Hat/SuSE Linux systems, the Linux messages file is the main source of
information for device driver problems and events. Device drivers usually indicate
only status by logging events in the Linux messages file. SANsurfer FC HBA
Manager agents also use the Linux messages file to report service errors, etc. For
more information, see section 8.1.

The Linux agent logs events for significant driver errors. In addition, the Linux agent
can be configured to perform extended event logging for an HBA, which causes it
to log all loop transitions and many minor events. Extended event logging uses extra
overhead and is enabled only in troubleshooting situations. The extended event
logging flag is stored in the HBA NVRAM and can be modified using Fast!UTIL or
SANsurfer FC HBA Manager.

The path for the linux messages file is /var/log/messages.

2.4.1.3

Solaris Messages File

For Solaris SPARC systems, the Solaris messages file is the main source of
information for device driver problems and events. Device drivers usually indicate
only status by logging events in the Solaris messages file. SANsurfer FC HBA
Manager agents also use the Solaris messages file to report service errors, etc. For
more information, see section 8.1.

The Solaris agent logs events for significant driver errors. In addition, the Solaris
agent can be configured to perform extended event logging for an HBA, which
causes it to log all loop transitions and many minor events. Extended event logging
uses extra overhead and is enabled only in troubleshooting situations. The extended

2-6 FS0054603-00 C

Q

event logging flag is stored in the HBA NVRAM and can be modified using Fast!UTIL
or SANsurfer FC HBA Manager.

The path for the Solaris messages file is /var/adm/messages.

2.4.1.4

SANsurfer FC HBA Manager

SANsurfer FC HBA Manager displays target devices on an HBA, loop topology
information, loop error count information, etc. SANsurfer FC HBA Manager displays
target devices on an HBA and is useful for analyzing system configurations.
SANsurfer FC HBA Manager uses a feature of the enhanced miniport driver to find
and display information about devices that are not configured on the local host. This
feature can display information about all potential target devices on a fabric or all
devices on a loop topology, not just those that are configured on the local host.

2.4.2

Known Issues

2.4.2.1

ConfigRequired Parameter

2 – System Overview

Troubleshooting

To maintain backward compatibility with previous versions, if the configuration
cannot be read from the registry, the miniport driver defaults to the previous
operation of configuring and enabling all devices that are found. Some OEMs
indicate that this is an unacceptable risk when adding a new host to a SAN system
and that the desired operation is to configure no devices instead of all devices. A
new parameter was added to miniport registry parameters to indicate that
configuration is required. Find this parameter in special OEM setup files in one of
the following strings, depending on the type of miniport driver:

HKLM\System\CurrentControlSet\Services\ql2200\

Parameters\Devices\DriverParameters

HKLM\System\CurrentControlSet\Services\ql2300\

Parameters\Devices\DriverParameters

The parameter value is ConfigRequired= 0 (FALSE) or ConfigRequired=1 (TRUE).
If the parameter is not found, the default value is ConfigRequired=0. Note that this
parameter is used only when configuration information cannot be read from the
persistent storage.

FS0054603-00 C 2-7

2 – System Overview
Troubleshooting

Notes

Q

2-8 FS0054603-00 C

Section 3

SANsurfer FC HBA Manager Overview

3.1

What is SANsurfer FC HBA Manager?

The QLogic SANsurfer FC HBA Manager is a GUI-based application that configures
and manages QLogic Fibre Channel host bus adapters (HBAs) and attached
devices within a storage area network (SAN) environment. Note the following:

■ SANsurfer FC HBA Manager works with the Windows 2000, Windows Server

2003, Red Hat Linux, SuSE Linux Enterprise Server 8, Solaris SPARC, and
Novell® NetWare® operating systems. Support of multiple operating systems
allows control of heterogeneous environments.

■ SANsurfer FC HBA Manager is a client/server application. The networking

capability of the application allows for centralized management and configuration
of QLogic FC HBAs within the entire SAN.

3.2

Features

The SANsurfer FC HBA Manager has the following features:

■ Asset 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 HBAs with connected storage
devices.

■ 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 HBAs

❑ Configure Fibre Channel 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.

❑ Persistently bind targets

❑ Update the NVRAM, flash BIOS, and HBA driver

FS0054603-00 C 3-1

3 – SANsurfer FC HBA Manager Overview
Features

■ Statistics. SANsurfer FC HBA Manager provides statistics for each HBA port.

These statistics can be collected automatically or on request. They can be reset
at any time. In addition, you can export the statistics to a comma separated
values (CSV) file that can be imported into other applications, for example,
Microsoft® Excel.

■ Diagnostics. SANsurfer FC HBA Manager provides end-to-end diagnostics that

enable you to test the HBAs and the devices to which they are connected.
SANsurfer FC HBA Manager diagnostics allow you to do the following:

❑ Test the link status of each HBA and its attached devices

❑ Perform a loopback test, which is external to the HBA, to evaluate the ports

(transmit and receive transceivers) on the HBA and the error rate

❑ Perform a read/write buffer test, which tests the link between the HBA and its

attached devices

■ Alarm and event notifications. SANsurfer FC HBA Manager provides

asynchronous notification of various conditions and problems through alarms
and events. Alarm information includes severity, time, host, HBA, application,
and description. Event information includes severity, time, and message. In
addition, the alarm and event information can be exported to a CSV file that can
be imported into other applications, for example, Microsoft Excel. Alarm
information can be sent automatically by email to a distribution list.

Q

3-2 FS0054603-00 C

System Requirements

The SANsurfer FC HBA Manager application requires the hardware and software
listed in this section for optimum performance.

4.1

Hardware Requirements

The minimum hardware requirements are as follows:

■ QLogic QLA200/QLA2xxx PCI to Fibre Channel HBAs (see section 4.3)

■ Single-processor or multiprocessor server or workstation:

❑ Pentium III with 450 MHz or greater for Windows 2000, Windows

Server 2003, Red Hat/SuSE Linux, and NetWare

❑ Sun Ultra 60 for Solaris SPARC

■ Fibre Channel devices, such as disks and RAID subsystems

NOTE: Tape devices display as part of the configuration, but are not supported

by SANsurfer FC HBA Manager (no support for LUN masking or
diagnostics).

Section 4

■ 128 MB of physical RAM are required to run SANsurfer FC HBA Manager;

256 MB are recommended. Running with less memory can cause disk swapping,
which severely effects performance.

■ Video card capable of 256 colors and a screen resolution of 800×600 pixels are

required; 16K colors and 1024×768 pixels are recommended.

■ About 100 MB of disk space

FS0054603-00 C 4-1

4 – System Requirements
Software Requirements

4.2

Software Requirements

The minimum software requirements are as follows:

■ One of the following operating systems:

❑ Windows 2000 Server, Advanced Server, or Professional (SP4)

❑ Windows Server 2003 Standard Edition or Enterprise Edition

❑ Red Hat Linux 9 Professional (IA32) (kernel 2.4.20-18.9) or Red Hat

Enterprise Linux Advanced Server (AS) 2.1 or 3.0 (IA32) (kernel 2.4.9.e-8)

❑ SuSE Linux Enterprise Server 8 (SLES) (IA32) (kernel 2.4.19-64GB)

❑ Solaris SPARC v2.6, 2.7, 2.8, or 2.9

❑ Novell NetWare 5.1 (SP4) or 6.x server with IPX/SPX loaded (version 6.5 is

supported only on QLA23xx HBAs)

■ Common desktop environment (CDE) to run SANsurfer FC HBA Manager GUI

Q

■ QLogic QLA2xxx drivers, as appropriate:

❑ Windows 2000
❑ Windows Server 2003
❑ NetWare
❑ Linux
❑ Solaris

■ TCP/IP protocol for Windows 2000/Windows Server 2003 remote management

■ TCP/IP protocol for NetWare remote management

■ Administrative privileges to perform management functions

■ Adobe Acrobat® Reader® (version 2.1 or later) to view documentation

■ Internet Explorer (version 4.0 or later) or Netscape Communicator (version 4.5

or later) to view online help

4-2 FS0054603-00 C

Q

4.3

Supported QLogic HBAs

The QLogic HBAs are collectively referred to as the QLA200/QLA2xxx HBA unless
otherwise noted. The following QLogic HBAs are supported by SANsurfer FC HBA
Manager:

■ QLA200 HBAs

■ QLA22xx HBAs:
❑ QLA2200/33
❑ QLA2200/66
❑ QLA2200L/66
❑ QLA2200F/33
❑ QLA2200F/66
❑ QLA2202F/66
❑ QLA2200G/66
❑ QLA2200GC/66
❑ QLA2200GF/66

4 – System Requirements

Supported QLogic HBAs

■ QLA23xx HBAs:
❑ QLA2310
❑ QLA2310F
❑ QLA2310FL
❑ QLA2340
❑ QLA2340L
❑ QLA2342
❑ QLA2342L
❑ QLA2344

FS0054603-00 C 4-3

4 – System Requirements
Supported QLogic HBAs

Notes

Q

4-4 FS0054603-00 C

Installing SANsurfer FC HBA Manager

Installing the SANsurfer FC HBA Manager consists of installing the SANsurfer FC
HBA Manager GUI, platform-specific agent, and help components, as appropriate.

NOTE: Before installing SANsurfer FC HBA Manager, read and follow the

This section discusses:

■ Initial installation (see section 5.1)

■ Uninstalling the SANsurfer FC HBA Manager application (see section 5.2)

5.1

Initial Installation

You can install the SANsurfer FC HBA Manager using the software from the QLogic
Web site.

■ Be sure to install the same version of the SANsurfer FC HBA Manager on all

systems in the network.

Section 5

instructions in the documents listed in section 1.1, as applicable.

■ If you have a previous version of SANsurfer FC HBA Manager (or SANblade

Manager), uninstall these applications before installing SANsurfer FC HBA
Manager.

FS0054603-00 C 5-1

5 – Installing SANsurfer FC HBA Manager
Initial Installation

5.1.1

Installation Options

SANsurfer FC HBA Manager supports both stand-alone and networked
configurations. Install the software appropriate for your configuration (see table 5-1).

Table 5-1. Configuration Option Installation Requirements

Configuration Software Requirements

Stand-alone system

This Windows 2000/Windows
Server 2003 or Red Hat/SuSE
Linux system monitors
QLA200/QLA2xxx HBAs locally.

Q

SANsurfer FC HBA Manager GUI

This Solaris SPARC system
monitors QLA200/QLA2xxx
HBAs locally.

Networked

This system monitors
QLA200/QLA2xxx HBAs locally
and on remote systems on the
same network.

This system monitors
QLA200/QLA2xxx HBAs only on
remote systems on the same
network.

The QLA200/QLA2xxx HBAs on
this system are remotely
monitored only from other
systems on the same network.

SANsurfer FC HBA Manager GUI
SANsurfer Solaris Agent

SANsurfer FC HBA Manager GUI
Plus one of the following:

SANsurfer Windows NT
SANsurfer Linux Agent
SANsurfer Solaris Agent

SANsurfer FC HBA Manager GUI

One of the following:

SANsurfer Windows NT 4/2000/2003 Agent
SANsurfer Linux Agent
SANsurfer Solaris Agent
SANsurfer NetWare 4.2 Agent
SANsurfer NetWare 5/6.x Agent

® 4/2000/2003 Agent

5-2 FS0054603-00 C

Q

5.1.2

Installation Instructions

SANsurfer installer is a self-extracting program that installs the SANsurfer FC HBA
Manager application and related software.

NOTE: If a previous version of SANsurfer FC HBA Manager (or SANblade

Manager) exists, uninstall it before proceeding.

If you will be installing the SANsurfer FC HBA Manager agent on a NetWare server,
note the following:

■ You cannot install the SANsurfer FC HBA Manager agent directly on a NetWare

server; you must install the agent from a Windows 2000/Windows Server 2003
system connected to the NetWare server.

■ The prerequisites for each NetWare server are as follows:

❑ A Windows 2000/Windows Server 2003 system must be connected to the

NetWare server through the TCP/IP network.

5 – Installing SANsurfer FC HBA Manager

Initial Installation

❑ The Windows 2000/Windows Server 2003 system must have a drive mapped

to the NetWare server system volume (sys:\).

Perform the following steps to install SANsurfer FC HBA Manager on this system
or on the NetWare server connected to this system:

1. Perform the following steps to start the installation.

a. Do the following to access SANsurfer installer from the QLogic Web site:

❑ From the QLogic home page, click Support.

❑ Click Drivers, Software, and Manuals.

❑ From the OEM and ISV approved/recommended drivers and

firmware section, click EMC.

❑ Locate the table that corresponds to your HBA.

❑ In the SANsurfer row of the table (SANsurfer for Windows, SANsurfer for

Linux, or SANsurfer for Solaris), click Download.

❑ The File Download dialog box displays. Click Save. Select a directory

on your system and download the file.

FS0054603-00 C 5-3

5 – Installing SANsurfer FC HBA Manager
Initial Installation

b. Do one of the following to select and start the installation file. install is the

SANsurfer installer file.

❑ For a Windows 2000/Windows Server 2003 system, locate the folder

where you downloaded the install file and double-click the file.

❑ For a Red Hat/SuSE Linux or Solaris SPARC system, do the following:

(1) Open a shell.

(2) Change to the directory where you downloaded the SANsurfer

installer.

(3) Type the following and then press ENTER to ensure that the

SANsurfer installer file is executable and start the installer.

sh ./install.bin

2. InstallAnywhere® prepares to install the SANsurfer FC HBA Manager
application. The installation Introduction dialog box displays (see figure 5-1).
Click Next.

Q

Figure 5-1. Installation Introduction Dialog Box

5-4 FS0054603-00 C

Q

5 – Installing SANsurfer FC HBA Manager

Initial Installation

3. The Important Information dialog box displays (see figure 5-2). Read the
information, then click Next.

Figure 5-2. Important Information Dialog Box

You can find this information in the readme.txt file in the following locations:

❑ Windows 2000/Windows Server 2003: Program Files\QLogic Management

Suite

❑ Red Hat/SuSE Linux and Solaris SPARC:

opt/QLogic_Corporation/SANsurfer

FS0054603-00 C 5-5

5 – Installing SANsurfer FC HBA Manager
Initial Installation

4. The Choose Product Features dialog box displays. See figure 5-3 for a
sample dialog box.

NOTE: Except for the agents that are installed, the feature options are the

same for Windows 2000/Windows Server 2003, Red Hat/SuSE
Linux, and Solaris SPARC systems.

■ Windows agents are installed on a Windows 2000/Windows

Server 2003 system

■ Linux agents are installed on a Red Hat/SuSE Linux system

■ Solaris agents are installed on a Solaris SPARC system

Q

Figure 5-3. Choose Product Features Dialog Box (Sample)

Install only the software appropriate to your configuration. In addition,
SANsurfer FC HBA Manager supports both stand-alone and network
configurations (see section 5.1.1 for details). Do one of the following:

❑ For a Windows 2000/Windows Server 2003 system, select one

preconfigured installation set from the following. Then click Next.

❑ Select SFCHM GUI and Agent to install the SANsurfer FC HBA Manager

GUI, including the SANsurfer FC HBA Manager Windows NT
4/2000/2003 agent.

❑ Select SANsurfer Windows Agent to install only the SANsurfer FC HBA

Manager Windows NT 4/2000/2003 agent.

❑ Select SANsurfer NetWare5/6.x Agent to install only the SANsurfer FC

HBA Manager Novell Netware 5/6.x (and above) agent.

5-6 FS0054603-00 C

Q

5 – Installing SANsurfer FC HBA Manager

Initial Installation

❑ Select SFCHM GUI to install only the SANsurfer FC HBA Manager GUI.

❑ Select SANsurfer NetWare 4.2 Agent to install only the SANsurfer FC

HBA Manager Novell Netware 4.2 agent.

❑ For a Red Hat/SuSE Linux system, select one preconfigured installation set

from the following. Then click Next.

❑ Select SFCHM GUI and Agent to install the SANsurfer FC HBA Manager

GUI, including the SANsurfer FC HBA Manager Linux agent.

❑ Select SFCHM GUI to install only the SANsurfer FC HBA Manager GUI.

❑ Select SANsurfer Linux Agent to install only the SANsurfer FC HBA

Manager Linux agent.

❑ For a Solaris SPARC system, select one preconfigured installation set from

the following. Then click Next.

❑ Select SFCHM GUI and Agent to install the SANsurfer FC HBA Manager

GUI, including the SANsurfer FC HBA Manager Solaris Agent.

❑ Select SFCHM GUI to install only the SANsurfer FC HBA Manager GUI.

❑ Select SANsurfer Solaris Agent to install only the SANsurfer FC HBA

Manager Solaris agent.

❑ Select Custom to create an installation set. The Choose Product

Components dialog box displays (see figure 5-4). The dialog box differs,

depending on whether you are installing on a Windows 2000/Windows
Server 2003, Red Hat/SuSE Linux, or Solaris SPARC system.

Figure 5-4. Choose Product Components Dialog Box (Sample)

FS0054603-00 C 5-7

5 – Installing SANsurfer FC HBA Manager
Initial Installation

Perform the following steps to create a custom set:

a. In the Install Set box, select Custom.

b. Select from the following components:

For a Windows 2000/Windows Server 2003 system:

❑ SANsurfer FC HBA Manager GUI
❑ SANsurfer Windows NT/2000/2003 Agent
❑ SANsurfer NetWare 4.2 Agent
❑ SANsurfer NetWare 5/6.x Agent
❑ Help

For a Red Hat/SuSE Linux system:

❑ SANsurfer FC HBA Manager
❑ SANsurfer Linux Agent
❑ Help

For a Solaris SPARC system:

Q

❑ SANsurfer FC HBA Manager
❑ SANsurfer Solaris Agent
❑ Help

c. Click Next.

5. The Choose Install Folder dialog box displays (see figure 5-5).

Figure 5-5. Choose Install Folder Dialog Box

5-8 FS0054603-00 C

Q

5 – Installing SANsurfer FC HBA Manager

Initial Installation

Do one of the following:

NOTE: For NetWare, select the drive mapped to the NetWare server (always

select a location other than the default).

❑ To select the destination location displayed in the dialog box, click Next

(recommended).

The default location for a Windows 2000/Windows Server 2003 system is:

C:\Program Files\QLogic Corporation\SANsurfer

The default location for a Red Hat/SuSE Linux and Solaris SPARC system is:

/opt/QLogic_Corporation/SANsurfer

❑ To select a different location:

a. Click Choose.
b. Select the desired location.

c. The Choose Install Folder dialog box redisplays. Click Next.

❑ If you selected a different location and want to reselect the default location:

a. Click Restore Default Folder.
b. Click Next.

6. If you are installing the SANsurfer FC HBA Manager GUI on a
Windows 2000/Windows Server 2003 system, the Select Shortcut Profile
dialog box displays (see figure 5-6).

Figure 5-6. Select Shortcut Profile Dialog Box (Windows 2000/Windows Server 2003)

FS0054603-00 C 5-9

5 – Installing SANsurfer FC HBA Manager
Initial Installation

Application shortcuts consist of the following:

❑ The SANsurfer icon on the desktop (if selected in step 7)

❑ QLogic Management Suite (SANsurfer and SANsurfer Uninstaller),

which is accessible when you click the Start button and point to Programs.

Perform the following steps:

a. Do one of the following:

❑ Click All Users Profile if you want the application shortcuts available to

all users.

❑ Click Current Users Profile (default) if you want the application shortcuts

available only to the current user.

b. Click Next.

7. If you are installing the SANsurfer FC HBA Manager GUI on a
Windows 2000/Windows Server 2003 system, the Create Desktop Icon
Selection dialog box displays (see figure 5-7).

Q

Figure 5-7. Create Desktop Icon Selection Dialog Box (Windows 2000/Windows Server 2003)

5-10 FS0054603-00 C

Q

5 – Installing SANsurfer FC HBA Manager

Initial Installation

Do the following:

a. Select the Create Desktop Icon check box (default) if you want the

SANsurfer icon to display on the desktop.

b. Click Next.

NOTE: If you select the Create Desktop Icon check box, the SANsurfer

icon displays for the current user profile or all user profiles,
depending upon your selection in step 6.

8. The Pre-Installation Summary dialog box displays (see figure 5-8). Review
the information. Click Previous if you want to change anything. Click Install to
continue.

Figure 5-8. Pre-Installation Summary Dialog Box

FS0054603-00 C 5-11

5 – Installing SANsurfer FC HBA Manager
Initial Installation

9. The Installing SANsurfer dialog box displays (see figure 5-9). Various screens
inform you that the installation is progressing.

Q

Figure 5-9. Installing SANsurfer Dialog Box

10. If you are installing NetWare, the Novell NetWare Disk Selection dialog box
displays (see figure 5-10).

Figure 5-10. Novell NetWare Disk Selection Dialog Box

5-12 FS0054603-00 C

Q

5 – Installing SANsurfer FC HBA Manager

Initial Installation

A list of the autodetected Windows 2000/Windows Server 2003 drives mapped
to NetWare server system volumes (sys:\) displays.

Perform the following steps to select the Windows 2000/Windows Server 2003
drives on which to install the NetWare agent. Each drive must be mapped to a
NetWare server system volume (sys:\).

a. As appropriate, select one or more autodetected drives. In figure 5-10, for

example, H, N, and Q can be selected; N and Q are selected.

b. If a Windows 2000/Windows Server 2003 drive that you want to select has

not been mapped to the NetWare server system volume, do the following:

❑ Leave the Novell NetWare Disk Selection dialog box open. From the

Exploring window, point to Tools and select Map Network Drive to map

the Windows 2000/Windows Server 2003 drive to the NetWare Server
system volume (sys:\).

❑ From the Novell NetWare Disk Selection dialog box, type the drive letter

in the Enter Drive Letter box and then click Enter Drive Letter. In

figure 5-10, for example, you could type C in the Enter Drive Letter box

and then click Enter Drive Letter.

c. Click Next.

11. The Install Complete dialog box displays (see figure 5-11). Click Done.

Figure 5-11. Install Complete Dialog Box

12. Customize the SANsurfer FC HBA Manager and set your security parameters

(see section 6).

FS0054603-00 C 5-13

5 – Installing SANsurfer FC HBA Manager
Uninstalling the SANsurfer Application

5.2

Uninstalling the SANsurfer Application

Perform the following steps to uninstall the SANsurfer FC HBA Manager or specific
features from this system. Be sure to exit SANsurfer FC HBA Manager before you
uninstall any of the SANsurfer FC HBA Manager application features.

NOTE: If you are uninstalling Netware, note the following.

■ Uninstall the NetWare agent from the Windows 2000/Windows

Server 2003 drive mapped to the Novell NetWare server.

■ The Windows 2000/Windows Server 2003 system must have a drive

mapped to the NetWare server system volume (sys:\).

1. Do one of the following to start the SANsurfer Uninstaller:

From a Windows 2000/Windows Server 2003 system, do one of the following:

❑ Click the Start button, point to Programs, point to QLogic Management

Suite, and then click SANsurfer Uninstaller.

Q

❑ Perform the following steps to use Add/Remove Programs:

a. Click the Start button, point to Settings, and then click Control Panel.

b. Double-click the Add/Remove Programs icon.

c. The Add/Remove Programs dialog box displays (see figure 5-12). Click

the Change or Remove Programs button (default).

Figure 5-12. Add/Remove Programs Dialog Box (Windows 2000)

5-14 FS0054603-00 C

Q

5 – Installing SANsurfer FC HBA Manager

Uninstalling the SANsurfer Application

d. Select SANsurfer FC HBA Manager Vx.x.xx

e. Click Change/Remove.

From a Red Hat/SuSE Linux or Solaris SPARC system, do one of the following
and then press ENTER:

❑ On a Red Hat/SuSE Linux system, if /usr/local/bin is in the path, type:

SANsurferUninstaller

❑ On a Solaris SPARC system, if /usr/bin is in the path, type:

SANsurferUninstaller

❑ On a Red Hat/SuSE Linux or Solaris SPARC system, do the following if none

of the above are in the path:

a. Change to the directory where the SANsurfer application is installed. The

default location is /opt/QLogic_Corporation/SANsurfer
/UninstallData.

b. Type:

./SANsurferUninstaller

2. The Uninstall SANsurfer dialog box displays with SANsurfer FC HBA Manager
Vx.x.xx as the program to be uninstalled (see figure 5-13). Click Next.

Figure 5-13. Uninstall SANsurfer Dialog Box

FS0054603-00 C 5-15

5 – Installing SANsurfer FC HBA Manager
Uninstalling the SANsurfer Application

3. The Uninstall Options dialog box displays (see figure 5-14).

Q

Figure 5-14. Uninstall Options Dialog Box

You can uninstall the entire SANsurfer FC HBA Manager application or specific
features. Do one of the following:

❑ Select Complete Uninstall to remove all features and components of the

SANsurfer FC HBA Manager application that were installed by
InstallAnywhere. This will not affect files and folders created after the
installation.

❑ Select Uninstall Specific Features to remove specific features of the

SANsurfer FC HBA Manager application that were installed by
InstallAnywhere. The Choose Product Components dialog box displays

(see figure 5-15). The dialog box differs, depending on whether you are on

a Windows 2000/Windows Server 2003, Red Hat/SuSE Linux, or Solaris
SPARC system.

5-16 FS0054603-00 C

Q

5 – Installing SANsurfer FC HBA Manager

Uninstalling the SANsurfer Application

Figure 5-15. Choose Product Features Dialog Box (Sample)

a. Clear the check boxes of features that you want to uninstall. (Check boxes

that are selected remain installed). Select from the following components
(all components may not display and the order of the components may
vary):

For a Windows 2000/Windows Server 2003 system:

❑ SANsurfer FC HBA Manager
❑ SANsurfer Windows NT 4/2000/2003 Agent
❑ SANsurfer NetWare 5/6.x Agent
❑ SANsurfer NetWare 4.2 Agent
❑ Help

For a Red Hat/SuSE Linux system:

❑ SANsurfer FC HBA Manager
❑ SANsurfer Linux Agent
❑ Help

For a Solaris SPARC system:

❑ SANsurfer FC HBA Manager GUI
❑ SANsurfer Solaris Agent
❑ Help

b. Click Uninstall.

FS0054603-00 C 5-17

5 – Installing SANsurfer FC HBA Manager
Uninstalling the SANsurfer Application

4. The Uninstall Component List dialog box lists the components to be
uninstalled (see figure 5-16).

Q

Figure 5-16. Uninstall Component List Dialog Box

A message displays asking you to wait the while the uninstaller removes the
components.

5. The Uninstall Complete dialog box informs you that the uninstall is complete

(see figure 5-17). Click Done.

Figure 5-17. Uninstall Complete Dialog Box

5-18 FS0054603-00 C

Q

5 – Installing SANsurfer FC HBA Manager

Uninstalling the SANsurfer Application

6. If any items were not successfully uninstalled, remove them.

Some files and directories remain after uninstalling SANsurfer FC HBA
Manager. These components must be deleted manually from the computer’s
hard disk where SANsurfer FC HBA Manager was installed. The default
locations are:

❑ For Windows 2000/Windows Server 2003:

Program Files\QLogic_Corporation\SANsurfer

❑ For Red Hat/SuSE Linux and Solaris SPARC:

/opt/QLogic_Corporation/SANsurfer

7. If you selected Add/Remove Programs in step 1 to uninstall SANsurfer HBA
Manager from a Windows 2000/Windows Server 2003 system, do the
following:

a. Click Cancel to exit the Add/Remove Programs dialog box.
b. Click the close button to exit the Control Panel.

8. If prompted, reboot the system.

FS0054603-00 C 5-19

5 – Installing SANsurfer FC HBA Manager
Uninstalling the SANsurfer Application

Notes

Q

5-20 FS0054603-00 C

Section 6

Getting Started

This section includes the procedures for starting the SANsurfer FC HBA Manager
GUI, exiting the SANsurfer FC HBA Manager GUI, and customizing the application
options and policies.

This section discusses:

■ Starting the SANsurfer FC HBA Manager GUI (see section 6.1)

■ SANsurfer FC HBA Manager main window (see section 6.2)

■ Exiting the SANsurfer FC HBA Manager GUI (see section 6.3)

■ Getting help (see section 6.4)

■ Setting SANsurfer FC HBA Manager security (see section 6.5)

■ Setting the warning display option (see section 6.6)

■ Setting the configuration change alarm option (see section 6.7)

■ Specifying the polling interval (see section 6.8)

■ Setting the event log options (see section 6.9)

■ Setting the alarm log option (see section 6.10)

■ Setting up automatic alarm notification by email (see section 6.11)

■ Specifying the HBA driver settings (see section 6.12)

■ Refreshing the configuration that displays (see section 6.13)

6.1

Starting the SANsurfer FC HBA Manager GUI

The SANsurfer FC HBA Manager GUI startup procedures differ depending upon
the operating system. This section discusses starting the SANsurfer FC HBA
Manager on the following systems:

■ Windows 2000/Windows Server 2003 (see section 6.1.1)

■ Red Hat/SuSE Linux or Solaris SPARC (see section 6.1.2)

NOTE: For information about connecting to specified hosts automatically when

starting the SANsurfer FC HBA Manager GUI from the command line,

see section 7.1.4.

FS0054603-00 C 6-1

6 – Getting Started
Starting the SANsurfer FC HBA Manager GUI

6.1.1

Starting SANsurfer FC HBA Manager on Windows 2000/
Windows Server 2003

On a Windows 2000/Windows Server 2003 system, do one of the following to start
the SANsurfer FC HBA Manager. When done, the SANsurfer FC HBA Manager
GUI displays (see section 6.2).

■ Double-click the SANsurfer icon on your desktop (if the icon was created during

installation) (see figure 6-1). (If you have an older version of SANsurfer FC HBA
Manager and are upgrading to the current version, the old icon image displays.)

Figure 6-1. SANsurfer Icon

■ Click the Start button, point to Programs, point to QLogic Management Suite,

and then click SANsurfer.

Q

■ Click the Start button, click Run, and then do one of the following:

❑ Type in the name of SANsurfer (SANsurfer.EXE), including all the paths. Click

OK.

❑ Click Browse, then select the program after finding it in the Browse dialog

box. Click Open.

6.1.2

Starting SANsurfer on Red Hat/SuSE Linux or Solaris SPARC

On Red Hat/SuSE Linux and Solaris SPARC systems, perform the following steps
to start the SANsurfer FC HBA Manager. When done, the SANsurfer FC HBA
Manager GUI displays (see section 6.2).

1. Ensure that you are in a graphical user environment.

2. Open a command terminal.

3. Type SANsurfer and then press ENTER.

6-2 FS0054603-00 C

Q

6.2

SANsurfer FC HBA Manager Main Window

When the SANsurfer FC HBA Manager GUI starts, SANsurfer: SANsurfer FC HBA
Manager OEMID65 Version displays in the title bar and FC HBA displays on the

application tab. Connect to the host (see section 7.1). The SANsurfer FC HBA
Manager main window displays (see figure 6-2).

6 – Getting Started

SANsurfer FC HBA Manager Main Window

Title Bar

Menu Bar

Toolbar

Application Tab

HBA Tree

Status Line

Tabbed Pages

Figure 6-2. SANsurfer FC HBA Manager Main Window

The HBA tree displays the hosts with their connected HBAs, HBA ports, devices,
and LUNs. Note the following:

■ The title bar displays SANsurfer and the application that is active (SANsurfer FC

HBA Manager OEMID65 Version) displays.

■ When you select an item in the HBA tree, the status line displays additional

information about the selection.

■ When you hold your cursor over an HBA in the HBA tree for a few seconds,

information about the HBA model displays.

FS0054603-00 C 6-3

6 – Getting Started
SANsurfer FC HBA Manager Main Window

The HBA tree contains the following visual indicators:

Host icons and text. The HBA tree displays the following:

■ Host status: live or offline

■ Host name: host name or IP address

Example:

hostname 10.3.13.90

The icons are:

■ Live (online) host. The blinking heart on the host icon indicates that the

connection between the GUI and the agent is active for this host.

■ Offline host. The configuration was loaded from a file (see section 7.11).

HBA icons and text. The HBA tree displays the following:

■ HBA model (such as, QLA200, QLA2xxx, or QLA2xxx/2xxx)

Q

■ HBA alias (if assigned) (see section 9.2)

■ Loop down: the HBA does not have synchronization (cable disconnected,

connection mode set incorrectly, etc.)

■ HBA status: the most severe displays— bad alarm, loop down, warning alarm,

or good (no alarm). For information about alarms, see section 8.2.

Examples:

HBA QLA2342:MyHBA:Warning

HBA QLA2342::Good

The HBA icons are:

■ Good. No alarm

■ Warning. Warning alarm

■ Loop Down

■ Bad. Bad alarm

■ Offline. HBA on offline host

6-4 FS0054603-00 C

Q

6 – Getting Started

SANsurfer FC HBA Manager Main Window

HBA port icons and text. The HBA tree displays the following information:

■ HBA port number (Port n)

■ HBA port alias (if assigned) (see section 9.3)

■ Beacon flashing: Flash HBA Port Beacon is enabled (see section 10.1.1)

■ HBA status: the most severe displays— bad alarm, loop down, warning alarm,

or good (no alarm). For information about alarms, see section 8.2.

Examples:

Port 0:MyHBAPort:Good, Beacon Flashing

Port 3::Loop Down

The HBA port icons are:

■ Good

■ Warning. Warning alarm

■ Loop Down

■ Bad. Bad alarm

■ Offline. HBA port on offline host

■ Beacon Flashing, Good

■ Beacon Flashing, Warning

■ Loop Down, Beacon Flashing

■ Beacon Flashing, Bad

Device icons and text. The HBA tree displays the following information about disks,
tapes, and SAFTE devices:

■ Device type: disk, tape, or SAFTE (used for enclosure information).

■ Device port ID: port ID of the disk, tape, or SAFTE device.

■ Online/inactive status: a circled red X on the icon indicates an inactive device

(the device is down, the port on device is down or inactive, or the device is not
responding properly to SCSI commands).

■ Diagnostics enabled/disabled for read/write buffer test: a green check mark on

the icon and Diag Enabled in text indicate enabled. See section 10.1.3 for more
information.

FS0054603-00 C 6-5

6 – Getting Started
Exiting the SANsurfer FC HBA Manager GUI

Examples:

Disk (50-06-0E-83-00-00-2B-21):Online, Diag Disabled

Disk (21-00-00-04-CF-92-7A-B1):Online, Diag Enabled

Tape (10-00-00-04-32-72-06-64):Inactive, Diag Disabled

Q

The disk icons are:

■ Disk Online, Diag Enabled

■ Disk Online, Diag Disabled

■ Disk Inactive, Diag Enabled

■ Disk Inactive, Diag Disabled

■ Offline. Disk on offline host

The tape icons are:

■ Tape, Diag Enabled

■ Tape, Diag Disabled

■ Tape Inactive, Diag Enabled

■ Tape Inactive, Diag Disabled

■ Offline. Tape on offline host

The SAFTE device icons are:

■ SAFTE device

■ Offline. SAFTE device on offline host

LUN icons and text. The HBA tree displays the following information:

■ LUN number (LUN n)

Example:

LUN (0)

The LUN icons are:

■ LUN online

■ LUN on offline host

6.3

Exiting the SANsurfer FC HBA Manager GUI

Do one of the following to exit the SANsurfer FC HBA Manager GUI:

■ On the SANsurfer FC HBA Manager main window File menu, select Exit.

■ Press ALT+X.

6-6 FS0054603-00 C

Q

6.4

Getting Help with the SANsurfer FC HBA Manager GUI

Getting Help with the SANsurfer FC HBA Manager GUI

This section discusses:

■ Viewing online help (see section 6.4.1)

■ Specifying the browser location (see section 6.4.2)

■ Viewing SANsurfer FC HBA Manager software information (see section 6.4.3)

6.4.1

Viewing Online Help

On the SANsurfer FC HBA Manager main window Help menu, click Browse
Contents to view the online help. The help window displays.

6.4.2

Specifying the Browser Location

Perform the following steps to specify the location of the browser SANsurfer FC
HBA Manager launches when you select to view the online help (see section 6.4.1):

6 – Getting Started

1. On the SANsurfer FC HBA Manager main window Help menu, click Set
Browser Location. The Browser Location dialog box displays (see

figure 6-3).

Figure 6-3. Browser Location Dialog Box

2. In the Browser Location box, enter the location. Be sure to specify the path
and file name.

If you do not know the location, click Browse to display a file selection dialog.
Select the file. The Browser Location dialog box redisplays.

3. Do one of the following:

❑ Click OK to save the location to the SANsurfer FC HBA Manager

configuration file.

❑ Click Cancel to exit the Browser Location dialog box without making

changes.

FS0054603-00 C 6-7

6 – Getting Started
Setting SANsurfer FC HBA Manager Security

6.4.3

Viewing SANsurfer FC HBA Manager Software Information

To view information about the SANsurfer FC HBA Manager software, on the
SANsurfer FC HBA Manager main window Help menu, click About.

The About SANsurfer FC HBA Manager window displays (see figure 6-4).

Q

Figure 6-4. About SANsurfer FC HBA Manager Window

This window displays the following information:

■ SANsurfer FC HBA Manager version

■ Edition type and version number

■ Copyright information

Click OK to return to the SANsurfer FC HBA Manager main window.

6.5

Setting SANsurfer FC HBA Manager Security

SANsurfer FC HBA Manager security ensures that HBA configuration changes
require password authorization. SANsurfer FC HBA Manager prompts for the
password when you change the following:

■ NVRAM

■ Flash BIOS

■ HBA driver

■ Persistent configuration data

■ Port configuration

6-8 FS0054603-00 C

Q

6 – Getting Started

Setting SANsurfer FC HBA Manager Security

■ LUN configuration

■ Password (when you want it changed)

You can change the SANsurfer FC HBA Manager access password for any host
connected to your system for which you have administrator or root privileges.

NOTE: The default SANsurfer FC HBA Manager access password is config.

Change this password after installation to ensure that security is not
compromised.

Perform the following steps to set the application access password for a host:

1. In the SANsurfer FC HBA Manager main window HBA tree, select the host for
which you want to set the application access password.

2. Click the Security tab. The Security tabbed page displays (see figure 6-5).
The host name displays at the top of the tabbed page.

3. In the Host Access section, do the following to verify that you have administrator
or root privileges for the selected host. These are the system login and password
you use to access the machine.

a. In the Login box, type the login name that has administrator or root privileges

on the host you selected.

b. In the Password box, type the login password for the login name.

FS0054603-00 C 6-9

Figure 6-5. Security Tabbed Page

6 – Getting Started
Setting the Warning Display Option

4. In the Application Access section, do the following to modify the SANsurfer FC
HBA Manager access password:

a. In the Old Password box, type the current password.

b. In the New Password box, type the new password.

c. In the Verify Password box, type the new password again to confirm the

new password.

5. Do one of the following:

❑ Click Apply to update the application access password.

❑ Click Clear Fields to clear the typed entries in the Security tabbed page

text boxes.

6.6

Setting the Warning Display Option

You can configure the SANsurfer FC HBA Manager GUI to display warning dialog
boxes when certain conditions occur. Perform the following steps to set the warning
display option:

Q

1. Do one of the following:

❑ On the SANsurfer FC HBA Manager main window Settings menu, select

Options.

❑ Right-click the HBA tree. From the pop-up menu, click Options.

❑ Press CTRL+SHIFT+O.

The Options dialog box displays (see figure 6-6).

Figure 6-6. Options Dialog Box—Warning Displays Section

6-10 FS0054603-00 C

Q

2. In the Warning Displays section, do one of the following:

❑ Select the Enable Warning Displays check box if you want the warning

dialog boxes to display.

❑ Clear the Enable Warning Displays check box if you do not want the

warning dialog boxes to display. This is the default.

3. Click OK to return to the SANsurfer FC HBA Manager main window.

6.7

Setting the Configuration Change Alarm Option

Setting the Configuration Change Alarm Option

SANsurfer FC HBA Manager tries to keep the devices and the LUNs that the HBA
displays current. When cables are pulled, devices hot plugged into the SAN, or
devices are removed, SANsurfer FC HBA Manager generates a configuration alarm
in the alarm log.

Perform the following steps to set how the SANsurfer FC HBA Manager GUI handles
configuration changes:

6 – Getting Started

1. Do one of the following:

❑ On the SANsurfer FC HBA Manager main window Settings menu, select

Options.

❑ Right-click the HBA tree. From the pop-up menu, click Options.

❑ Press CTRL+SHIFT+O.

The Options dialog box displays (see figure 6-7).

Figure 6-7. Options Dialog Box—Configuration Change Alarm Section

FS0054603-00 C 6-11

6 – Getting Started
Setting the Configuration Change Alarm Option

2. In the Configuration Change Alarm section, do one of the following:

❑ Select Apply Configuration Changes Automatically to have the

SANsurfer FC HBA Manager GUI automatically update to the new
configuration.

If another host has made configuration changes that need to be updated in
this configuration, the configuration change— reloading message displays.
Click OK.

❑ Select Confirm Configuration Change Applies if you want to decide

whether to update to the new configuration.

If a configuration change occurs, the configuration change—refresh
confirmation message displays. Do one of the following:

❑ Click Yes to refresh the configuration.

❑ Click No to not update to the new configuration. The old configuration

continues to display. To update to the current configuration, manually
connect and disconnect the host (see section 7).

Q

❑ Select Ignore Configuration Changes if you want to ignore the

configuration change alarm. The old configuration continues to display. To
update to the current configuration, manually connect and disconnect the
host (see section 7).

3. Click OK to return to the SANsurfer FC HBA Manager main window.

6-12 FS0054603-00 C

Q

6.8

Specifying the Polling Interval

The polling interval is set on a host basis. The polling interval is the length of time
between polls to a connected host to retrieve information. The SANsurfer FC HBA
Manager main window HBA tree refreshes automatically based on this rate.

NOTE: If you want to update the HBA tree immediately, click the Refresh button

on the toolbar.

Perform the following steps to set a host’s polling interval:

1. In the SANsurfer FC HBA Manager main window HBA tree, select the host (or
HBA, HBA port, device, or LUN connected to the host) for which you want to
set the host’s polling interval.

2. Do one of the following:

❑ From the Host menu, select Polling.

❑ Right-click the selected host (or HBA, HBA port, device, or LUN connected

to the host) in the HBA tree. From the pop-up menu, select Polling.

6 – Getting Started

Specifying the Polling Interval

3. The Polling Setting dialog box displays (see figure 6-8). The name of the host
displays in the title bar.

Figure 6-8. Polling Setting Dialog Box

4. In the Interval box, type the polling interval. The range is 1 second to
3600 seconds (1 hour). The default is 30 seconds.

NOTE: The faster the polling rate, the more quickly the SANsurfer FC HBA

Manager GUI receives indications from the connected host.
However, faster polling rates consume more of your system’s CPU
and network resources and slow the system.

5. Click OK to set the interval. Click Cancel to not change the interval setting.

FS0054603-00 C 6-13

6 – Getting Started
Setting the Event Log Options

6.9

Setting the Event Log Options

Perform the following steps to set the number of events the event log can list and
the logging of informational and warning events.

NOTE: See section 8.1 for information about viewing the event log.

1. Do one of the following:

❑ On the SANsurfer FC HBA Manager main window Settings menu, select

Options.

❑ Right-click the HBA tree. From the pop-up menu, click Options.

❑ Press CTRL+SHIFT+O.

The Options dialog box displays (see figure 6-9).

Q

Figure 6-9. Options Dialog Box—Event Log Section

2. In the Event Log section Log Size box, type the number of events the event
log can list. The range is 20 to 200 events. The default is 20 events.

3. If you want to enable logging of informational events, select the Event Log
section Log Informational Events check box.

4. If you want to enable logging of warning events, select the Event Log section
Log Warning Events check box.

5. Click OK to return to the SANsurfer FC HBA Manager main window.

6-14 FS0054603-00 C

Q

6.10

Setting the Alarm Log Option

Perform the following steps to set the number of alarms the alarm log can list.

NOTE: See section 8.2 for information about viewing the alarm log.

1. Do one of the following:

❑ On the SANsurfer FC HBA Manager main window Settings menu, select

Options.

❑ Right-click the HBA tree. From the pop-up menu, click Options.

❑ Press CTRL+SHIFT+O.

The Options dialog box displays (see figure 6-10).

6 – Getting Started

Setting the Alarm Log Option

Figure 6-10. Options Dialog Box—Alarm Log Section

2. In the Alarm Log section Log Size box, type the number of alarms the alarm
log can list. The range is 20 to 200 alarms. The default is 200 alarms.

3. Click OK to return to the SANsurfer FC HBA Manager main window.

FS0054603-00 C 6-15

6 – Getting Started
Setting Up Automatic Alarm Notification by Email

6.11

Setting Up Automatic Alarm Notification by Email

You can automatically send alarm notifications with a copy of the current host
configuration by email to a distribution list, thus enabling the information to be
opened and analyzed from other locations. Alarm notification is available only with
SMTP email servers.

NOTE: For information about viewing alarm notifications received by email, see

section 8.2.5.

Perform the following steps to set up automatic alarm notification by email:

1. Do one of the following:

❑ On the SANsurfer FC HBA Manager main window Settings menu, select

Email.

❑ Press CTRL+SHIFT+M.

The Email Settings dialog box displays (see figure 6-11).

Q

2. In the Server section, do the following:

a. In the Server box, type the host name or an IP address of the SMTP server

accessible on the local network.

b. In the Login box, type the login information.

c. In the Password box, type the password.

3. In the Email Addresses box, enter one or more email addresses to be notified.
List one email address for each line.

6-16 FS0054603-00 C

Figure 6-11. Email Settings Dialog Box

Q

6 – Getting Started

Specifying the HBA Driver Settings

4. In the Notification Options section, do the following:

a. Select the check boxes for the alarm notifications that you want to send. For

detailed information about alarms, see section 8.2.1.

❑ Information Alarms check box
❑ Unknown Alarms check box
❑ Warning Alarms check box
❑ Bad Alarms check box

b. If you want to send the current host configuration, select the Attach Host

Configuration check box.

5. To enable email notification, select the Enable Alarm Notifications over Email
check box.

6. Click Test to verify that email notification is operable. If successful, a message
displays stating that the email was sent successfully. Check the email
addresses for the email.

7. Click OK to accept your modifications. Click Cancel to not modify the email
notification settings.

6.12

Specifying the HBA Driver Settings

Setting the HBA driver parameters involves specifying the following:

■ Group Persistent. Whether only targets configured using SANsurfer FC HBA

Manager are seen by the system

■ Group Binding. Whether the driver binds the target ID using the target’s world

wide port name (WWPN) or port ID

FS0054603-00 C 6-17

6 – Getting Started
Specifying the HBA Driver Settings

Perform the following steps to set the HBA driver parameters:

1. In the SANsurfer FC HBA Manager main window HBA tree, select the HBA.

2. Select the Settings tab. The HBA Driver Settings tabbed page displays (see

figure 6-12).

Q

Figure 6-12. HBA Driver Settings Tabbed Page

The identifying information displays:

❑ Hostname. The name or IP address of the host connected to the HBA
❑ HBA Model. The QLA200/QLA2xxx HBA

3. In the Group: Persistent section, select one of the following to specify whether
only targets configured using SANsurfer FC HBA Manager are seen by the
system:

❑ If you want the system to see all targets at all times whether or not the target

was configured with SANsurfer FC HBA Manager, select the Present
targets that are persistently bound plus any new target(s) found radio

button.

❑ If you want the system to see only targets configured using SANsurfer FC

HBA Manager, select the Present targets that are persistently bound
Only radio button.

6-18 FS0054603-00 C

Q

4. In the Group: Binding section, select one of the following to specify whether the
driver binds the target ID using the target’s world wide port name (WWPN) or
port ID:

❑ If you want the driver to bind the target ID using the target’s WWPN, select

the Bind by World Wide Port Name radio button.

❑ If you want the driver to bind the target using the target’s port ID, select the

Bind by Port ID radio button. LUN masking is disabled. If the target port ID
changes, this target will be considered a newly added target: all existing
persistent data will be deleted and specific features disabled.

6.13

Refreshing the Configuration

The configuration that the SANsurfer FC HBA Manager GUI displays (including
QLogic main window HBA tree) refreshes automatically based on the polling interval

(see section 6.8). If you want to refresh the configuration immediately (you changed

the configuration, for example), do one of the following:

6 – Getting Started

Refreshing the Configuration

■ Click the Refresh button on the toolbar.

■ On the SANsurfer FC HBA Manager main window Host menu, select Refresh.

■ Right-click the HBA tree. From the pop-up menu, click Refresh.

■ Press F5.

FS0054603-00 C 6-19

6 – Getting Started
Refreshing the Configuration

Notes

Q

6-20 FS0054603-00 C

Section 7

Setting Up Connections

You can connect to and configure local and remote systems. This section discusses:

■ Connecting to one or multiple hosts (see section 7.1)

■ Configuring Fibre Channel devices using wizards. Wizards simplify the

configuration process.

❑ Configuring HBA ports and binding target devices using the General

Configuration Wizard (see section 7.2)

❑ Configuring LUN masking using the LUN Masking Wizard (see section 7.3)

■ Configuring Fibre Channel devices without using wizards. This is for advanced

users who want to customize the configuration of the HBAs and their connected
devices. This process contains settings in addition to those available when using
wizards.

❑ Configuring Fibre Channel devices without using wizards (see section 7.4)

❑ Configuring LUNs for a device (see section 7.5)

❑ Viewing HBA port and device information (see section 7.6)

❑ Binding target devices using the Fibre Channel Port Configuration dialog

box (see section 7.7)

❑ Binding target devices using the Target Persistent Binding tabbed page

(see section 7.8)

❑ Deleting persistent configuration data (see section 7.9)

■ Viewing a saved host configuration, printing a host configuration, and comparing

host configurations:

❑ Viewing a saved host configuration from a file (.qlc) (see section 7.10)
❑ Viewing a saved host configuration from a text file (.txt) (see section 7.11)
❑ Printing a host configuration (see section 7.12)
❑ Comparing host configurations (see section 7.13)

FS0054603-00 C 7-1

7 – Setting Up Connections
Connecting to Hosts

7.1

Connecting to Hosts

The SANsurfer FC HBA Manager GUI tries to ensure that a host is not loaded more
than once into the HBA tree. If a host has multiple interfaces (for example, more
than one NIC is installed), the SANsurfer FC HBA Manager GUI will not load the
host more than once in the HBA tree if the host IP address is registered with the
DNS server or local host file.

NOTE: To ensure that a host does not display more than once in the HBA tree,

register each host’s IP address with the DNS server or the local host file.

This section discusses:

■ Connecting to hosts manually (see section 7.1.1)

■ Connecting to hosts automatically (see section 7.1.2)

■ Connecting to hosts using a host group file (see section 7.1.3)

■ Connecting to specified hosts automatically when starting the SANsurfer FC HBA

Manager GUI from the command line (see section 7.1.4)

Q

■ Disconnecting from hosts (see section 7.1.5)

7.1.1

Manually Connecting to a Host

Perform the following steps to manually connect to a host:

1. Do one of the following:

❑ Click the Connect button on the SANsurfer FC HBA Manager main window

toolbar.

❑ On the SANsurfer FC HBA Manager main window Host menu, click

Connect.

❑ Right-click the HBA tree. From the pop-up menu, click Connect.

❑ Press INSERT.

7-2 FS0054603-00 C

Q

7 – Setting Up Connections

Connecting to Hosts

The Connect to Host dialog box displays (see figure 7-1).

Figure 7-1. Connect to Host Dialog Box

2. In the Enter Hostname or IP Address box, do one of the following:

❑ Select localhost to connect to the machine on which you are using the

SANsurfer FC HBA Manager GUI.

❑ Type or select a remote machine. You can use the host name or the

machine’s IP address.

3. Do one of the following:

❑ Click Connect to initiate the connection. If successful, the host and its HBAs

display in the HBA tree. If you entered a new remote host and the connection
was successful, its name is also added to the Enter Hostname or IP
Address box drop-down list.

❑ Click Cancel to abort the connection process and return to the SANsurfer

FC HBA Manager main window.

❑ Click Clear to delete all machines on the list except localhost. (The local

machine cannot be deleted.)

7.1.2

Auto Connecting to All Hosts

The auto-connect feature dynamically connects your machine to all the hosts in the
network that meet the following conditions:

■ The SANsurfer FC HBA Manager agent on the host is running.

■ The host is on the same class C IP address subnet as your machine.

FS0054603-00 C 7-3

7 – Setting Up Connections
Connecting to Hosts

The hosts display in the HBA tree and in the Connect to Host dialog box Enter
Hostname or IP Address box drop-down list. If, for example, the SANsurfer FC
HBA Manager agent on the host stops running, the host no longer displays in the
HBA tree.

NOTE: You must manually connect to a host on a different subnet (see

Perform the following steps to auto connect to all hosts:

1. Do one of the following:

❑ On the SANsurfer FC HBA Manager main window Settings menu, select

Broadcast.

❑ Press CTRL+SHIFT+B.

The Broadcast Settings dialog box displays (see figure 7-2).

Q

section 7.1.1).

Figure 7-2. Broadcast Settings Dialog Box

2. Select the Enable Broadcasting check box.

3. Select the Enable Auto Connect check box.

4. In the Broadcast Interval box, enter the number of seconds between
broadcasts. The range is 30 to 600 seconds, the default is 30 seconds.

5. Click OK to make the changes or Cancel to keep the current values.

To disable auto connecting to all hosts, clear the Enable Auto Connect check box
and click OK.

7-4 FS0054603-00 C

Q

7.1.3

Connecting to Hosts Using a Host Group File

You can connect to a group of hosts using a host group file that you previously
created. This section discusses:

■ Creating a host group file (see section 7.1.3.1)

■ Using a host group file to connect to hosts (see section 7.1.3.2)

7.1.3.1

Creating a Host Group File

Perform the following steps to save the group of hosts that display in the HBA tree
to a host group file:

1. Do one of the following:

❑ On the SANsurfer FC HBA Manager main window Host menu, click Save

Group.

❑ Right-click the HBA tree. From the pop-up menu, click Save Group.

7 – Setting Up Connections

Connecting to Hosts

❑ Press SHIFT+S.

2. The Save dialog box displays. Save the host group file (.hst) in an appropriate
directory. Click Save.

NOTE: You can also create or edit a host group file (.hst) using an editor. The

format of the file is one host name per line, for example:

adsw2ksys2
nt4ssys1
nw51sys7

Do one of the following:

❑ From a Windows 2000/Windows Server 2003 system, open the

Notepad window.

❑ From a Red Hat/SuSE Linux or Solaris SPARC system, open a

terminal and use the vi editor.

FS0054603-00 C 7-5

7 – Setting Up Connections
Connecting to Hosts

7.1.3.2

Q

Using a Host Group File to Connect to Hosts

Perform the following steps to connect to a group of hosts using a previously created
host group file:

1. Do one of the following:

❑ On the SANsurfer FC HBA Manager main window Host menu, click Open

Group.

❑ Right-click the HBA tree. From the pop-up menu, click Open Group.

❑ Press SHIFT+O.

2. The Open dialog box displays. Select the host group file (.hst) that contains
the hosts to which you want to connect. Click Open.

The hosts display in the SANsurfer FC HBA Manager main window HBA tree.

7.1.4

Connecting to Hosts Automatically when Starting the SANsurfer FC HBA
Manager GUI from the Command Line

NOTE: For information about starting SANsurfer FC HBA Manager without

automatically connecting to hosts, see section 6.1.

You can connect to specified hosts automatically when starting the SANsurfer FC
HBA Manager GUI from the command line. You can connect to a single host or a
group of hosts listed in a host group file.

NOTE: For information about creating a host group file, see section 7.1.3.1.

This section discusses connecting from the following systems:

■ Windows 2000/Windows Server 2003 (see section 7.1.4.1)

■ Red Hat/SuSE Linux or Solaris SPARC (see section 7.1.4.2)

7-6 FS0054603-00 C

Q

7.1.4.1

Connecting on Windows 2000/Windows Server 2003

On a Windows 2000/Windows Server 2003 system, perform the following steps to
connect to one or more specified hosts automatically when starting the SANsurfer
FC HBA Manager GUI from the command line. When done, the SANsurfer FC HBA
Manager main window displays with the specified hosts.

1. From a Windows 2000/Windows Server 2003 system, click the Start button,
point to Programs, point to Accessories, and then click Command Prompt.
The Command Prompt window displays.

2. Change to the directory where the SANsurfer application is installed.

3. Do one of the following:

❑ Type the following and then press ENTER to connect to the local host:

SANsurfer -l (the letter L for local)

❑ Type the following and then press ENTER to connect to a single host.

hostname is the host name or IP address:

7 – Setting Up Connections

Connecting to Hosts

SANsurfer -h hostname

For example:

SANsurfer -h adsw2ksys2

❑ Type the following and then press ENTER to connect to a group of hosts

listed in a host group file (.hst). path is the path of the host group file.

SANsurfer -g path

For example:

SANsurfer -g c:\Program Files\QLogic Corporation\
SANsurfer\hostfiles\group1.hst

7.1.4.2

Connecting on Red Hat/SuSE Linux or Solaris SPARC

On a Red Hat/SuSE Linux or Solaris SPARC system, perform the following steps
to connect to specified hosts automatically when starting the SANsurfer FC HBA
Manager GUI from the command line. When done, the SANsurfer FC HBA Manager
main window displays with the specified hosts.

1. Ensure that you are in a graphical user environment.

2. Open a command terminal.

3. Change to the directory where the SANsurfer application is installed.

FS0054603-00 C 7-7

7 – Setting Up Connections
Connecting to Hosts

4. Do one of the following:

❑ Type the following and then press ENTER to connect to the local host:

❑ Type the following and then press ENTER to connect to a single host at start

up. hostname is the host name or IP address:

For example:

❑ Type the following and then press ENTER to connect to the hosts listed in

a group file (.hst) at start up. path is the path of the group file.

For example:

Q

./SANsurfer -l (the letter L for local)

./SANsurfer -h hostname

./SANsurfer -h adsw2ksys2

./SANsurfer -g path

./SANsurfer -g /opt/QLogic Corporation/
SANsurfer/hostfiles/group1.hst

7.1.5

Disconnecting from a Host

Perform the following steps to disconnect from a host:

1. In the SANsurfer FC HBA Manager main window HBA tree, select the host (or
HBA, HBA port, device, or LUN connected to the host) that you want to
disconnect.

2. Do one of the following:

❑ On the Host menu, select Disconnect.

❑ Right-click the host in the HBA tree. From the pop-up menu, select

Disconnect.

❑ Press DELETE.

When the host is disconnected, it no longer displays in the HBA tree. If you are
using the auto-connect feature, the host does not auto connect. If you want to
reconnect to a disconnected host, do so manually (see section 7.1.1).

7-8 FS0054603-00 C

7 – Setting Up Connections

Q

7.2

Configuring HBA Ports Using the General Configuration Wizard

Configuring HBA Ports Using the General Configuration Wizard

Perform the following steps to configure HBA ports (connection option and data
rate) and bind target devices attached to the HBA port using the General
Configuration Wizard.

NOTE: These configuration changes can also be done using the following:

■ You can use the HBA Port Settings option of the HBA port Settings

tabbed page to configure all the FC connection parameters (including
connection option and data rate) for a specified HBA port (see

section 11.1.1).

NOTE: Configuring the connection option is available only on QLA2xxx

HBAs (the feature is not available on QLA200 HBAs).
Configuring the data rate is available only on QLA23xx HBAs
(the feature is not available on QLA22xx HBAs nor QLA200
HBAs).

■ You can also use the Target Persistent Binding tabbed page (see

section 7.8) or the Fibre Channel Port Configuration dialog box (see
section 7.7) to bind targets. For information about deleting persistent

configuration data, see section 7.9.

1. To access the General Configuration Wizard, do one of the following:

❑ If you are starting the SANsurfer FC HBA Manager GUI or if you added an

HBA, a message displays, stating that an unconfigured HBA has been
discovered and asks whether you want to start General Configuration
Wizard. Click Yes.

NOTE: If you do not want this message to automatically display, select the

Do not show this dialog again check box.

❑ From the SANsurfer FC HBA Manager main window HBA tree, right-click

the host (or HBA, HBA port, device, or LUN connected to the host). Do one
of the following:

❑ On the SANsurfer FC HBA Manager main window Wizards menu, select

General Configuration Wizard.

❑ From the pop-up menu, select General Configuration Wizard.

❑ Press CTRL+G.

FS0054603-00 C 7-9

7 – Setting Up Connections
Configuring HBA Ports Using the General Configuration Wizard

The HBA Port Selection dialog box displays (see figure 7-3).

Q

Figure 7-3. HBA Port Selection Dialog Box

NOTE: If you want to sort the existing entries in the table, click the column

heading. A triangle displays in the heading, indicating an ascending
sort (default). Click the triangle for a descending sort.

The dialog box provides:

❑ Information about the HBA port configuration process.

❑ Information about the HBA port:

❑ Select. Whether the HBA port is selected for configuration
❑ HBA. HBA port number and HBA model
❑ Port Name. World wide HBA port name
❑ Data Rate. The HBA port data rate setting
❑ Configured. Whether the HBA port is configured

7-10 FS0054603-00 C

Q

7 – Setting Up Connections

Configuring HBA Ports Using the General Configuration Wizard

Do the following:

a. From the table, select the HBA port that you want to configure. You can

select only one HBA port.

NOTE: When you finish, you will be prompted whether you want to

configure another HBA port.

b. Do one of the following:

❑ Click Next to proceed.

❑ Click Cancel to exit the General Configuration Wizard without making

any changes.

❑ Click Help to display context-sensitive help.

2. If you clicked Next, the HBA Port Information dialog box displays (see

figure 7-4).

Figure 7-4. HBA Port Information Dialog Box

FS0054603-00 C 7-11

7 – Setting Up Connections
Configuring HBA Ports Using the General Configuration Wizard

The dialog box displays the following information:

❑ HBA. HBA port number and HBA model

❑ Node Name. World wide HBA node name

❑ Port Name. World wide HBA port name

❑ Driver Version. Version of the HBA driver on the host that controls the HBA

❑ BIOS Version. BIOS version on the HBA (Windows 2000/Windows

Server 2003, Linux, NetWare, and Solaris)

❑ FCode Version. FCode version on the HBA (Solaris SPARC)

❑ Firmware Version. Version of the HBA firmware on the host that controls

the HBA

Do the following:

a. Verify the information.

b. Do one of the following:

Q

❑ Click Back to return to the previous dialog box.

❑ Click Next to proceed.

❑ Click Cancel to exit the General Configuration Wizard without making

any changes.

❑ Click Help to display context-sensitive help.

7-12 FS0054603-00 C

Q

7 – Setting Up Connections

Configuring HBA Ports Using the General Configuration Wizard

3. If you clicked Next, the HBA Port Connection Settings dialog box displays

(see figure 7-5).

Figure 7-5. HBA Port Connection Settings Dialog Box

The identifying information displays:

❑ Hostname. The name or IP address of the host connected to the HBA
❑ HBA Model. The QLA200/QLA2xxx HBA
❑ Port. HBA port number
❑ Node Name. World wide HBA node name
❑ Port Name. World wide HBA port name
❑ Port ID. Port ID of the HBA port

FS0054603-00 C 7-13

7 – Setting Up Connections
Configuring HBA Ports Using the General Configuration Wizard

Configure the following connection option and data rate FC connection
parameters.

a. In the Connection Options box, select the type of connection (loop or

point-to-point) or connection preference. See section 11.1.1 for details.

NOTE: Configuring the connection option is available only on QLA2xxx

HBAs. This option is not available on QLA200 HBAs, and appears
dimmed on the HBA Port Connection Settings dialog box.

b. In the Data Rate box, select the HBA port data rate. See section 11.1.1 for

details.

NOTE: Configuring the data rate is available only on QLA23xx HBAs. This

option is not available on QLA22xx HBAs nor QLA200 HBAs, and
appears dimmed on the HBA Port Connection Settings dialog
box.

c. Do one of the following:

❑ Click Back to return to the previous dialog box.

Q

❑ Click Next to proceed.

❑ Click Cancel to exit the General Configuration Wizard without making

any changes.

❑ Click Help to display context-sensitive help.

7-14 FS0054603-00 C

Q

7 – Setting Up Connections

Configuring HBA Ports Using the General Configuration Wizard

4. If you clicked Next, the Target Persistent Binding dialog box displays (see

figure 7-6). With target persistent binding, you can bind devices seen by the

operating system.

NOTE: This feature is not supported in Novell NetWare.

Figure 7-6. Target Persistent Binding Dialog Box

NOTE: If you want to sort the existing entries in the table, click the column

heading. A triangle displays in the heading, indicating an ascending
sort (default). Click the triangle for a descending sort.

The identifying information displays:

❑ Hostname. The name or IP address of the host connected to the HBA
❑ HBA Model. The QLA200/QLA2xxx HBA
❑ Port. HBA port number
❑ Node Name. World wide HBA node name
❑ Port Name. World wide HBA port name
❑ Port ID. Port ID of the HBA port

FS0054603-00 C 7-15

7 – Setting Up Connections
Configuring HBA Ports Using the General Configuration Wizard

The target persistent binding information displays:

❑ Bind. Whether target persistent binding is selected
❑ Type. Type of device
❑ Device Info. Device vendor and device product ID
❑ Port Name. World wide device port name
❑ Port ID. Port ID of the device
❑ Target ID. Target ID of the device

Perform the following steps to bind devices attached to HBA ports.

a. Select the Bind check box if you want to configure the port and bind it to the

target ID that you have selected in the Target ID drop-down box. If you do
not want to configure the port, clear the check box. If you clear the check box,
the corresponding port will be unconfigured. (In Solaris SPARC,
unconfigured entries are saved in persistent storage. In Windows
2000/Windows Server 2003, unconfigured entries are not saved in
persistent storage.)

If target persistent binding information was saved in persistent storage and
the machine is restarted, the driver reads the information saved in persistent
storage during start up. SANsurfer FC HBA Manager then reads this
information from the driver and sets the target IDs accordingly.

Q

If no persistent binding information was saved in persistent storage, the
driver assigns target IDs at start up; then SANsurfer FC HBA Manager
reports the target IDs assigned by the driver.

b. Click in the target ID cell. Select an ID from the Target ID drop-down box.

In Solaris SPARC and Red Hat/SuSE Linux, target IDs can be assigned to
configured ports. Valid target ID values are in the range 0–254 (Red
Hat/SuSE Linux) or 0–255 (Solaris SPARC). The IDs are validated before
they are saved. Duplicate target IDs are not allowed.

When you set a target ID for a visible path in Red Hat/SuSE Linux, the same
target ID is set for both hidden and configured paths. When you set a target
ID for a visible path in Solaris SPARC, the same target ID is not set for both
hidden and configured paths.

In Windows 2000/Windows Server 2003, target IDs can be assigned only
to ports that will be configured. Valid target ID values are in the range 0–(n–1),
where n is the number of targets attached to the HBA.

In Solaris SPARC, the target ID cannot be modified if the device has been
selected as a boot device.

Once persistent binding information for the targets is saved, the ports retain
the assigned target IDs across reboots.

7-16 FS0054603-00 C

Q

7 – Setting Up Connections

Configuring HBA Ports Using the General Configuration Wizard

c. Do one of the following:

❑ Click Back to return to the previous dialog box.

❑ Click Next to proceed.

❑ Click Cancel to exit the General Configuration Wizard without making

any changes.

❑ Click Help to display context-sensitive help.

5. If you clicked Next, the Confirm Changes dialog box displays (see figure 7-7).

Figure 7-7. Confirm Changes Dialog Box

The identifying information displays:

❑ Hostname. The name or IP address of the host connected to the HBA
❑ HBA Model. The QLA200/QLA2xxx HBA
❑ Port. HBA port number
❑ Node Name. World wide HBA node name
❑ Port Name. World wide HBA port name
❑ Port ID. Port ID of the HBA port

FS0054603-00 C 7-17

7 – Setting Up Connections
Configuring HBA Ports Using the General Configuration Wizard

The HBA’s settings based on the changes display:

❑ HBA Port Information

❑ HBA. HBA port number and HBA model
❑ Node Name. World wide HBA node name
❑ Port Name. World wide HBA port name

❑ Configuration Options Settings

❑ Connection Options. Type of connection (loop or point-to-point) or

connection preference

❑ Data Rate. For the QLA23xx HBA, the data rate your system can

accommodate

❑ Target Settings

❑ Node Name. World wide HBA node name
❑ Port Name. World wide device port name
❑ Target ID. Target ID of the device

Q

Do the following:

a. Review the changes.

b. To save a list of the changes for reference, click Save Configuration to File.

c. Do one of the following:

❑ Click Back to return to the previous dialog box.

❑ Click Next to proceed.

❑ Click Cancel to exit the General Configuration Wizard without making

any changes.

❑ Click Help to display context-sensitive help.

6. If you clicked Next, the Security Check dialog box displays. In the Enter
Password box, type the password. Click OK.

7-18 FS0054603-00 C

Q

7 – Setting Up Connections

Configuring HBA Ports Using the General Configuration Wizard

7. The HBA Port Configuration Status dialog box displays (see figure 7-8).

Figure 7-8. HBA Port Configuration Status Dialog Box

The identifying information displays:

❑ Hostname. The name or IP address of the host connected to the HBA
❑ HBA Model. The QLA200/QLA2xxx HBA
❑ Port. HBA port number
❑ Node Name. World wide HBA node name
❑ Port Name. World wide HBA port name
❑ Port ID. Port ID of the HBA port

Do the following:

a. Read the information about the changes and the process.

b. Do one of the following:

❑ Click Back to return to the previous dialog box.

❑ Click Next to proceed.

❑ Click Cancel to exit the General Configuration Wizard without making

any changes.

❑ Click Help to display context-sensitive help.

FS0054603-00 C 7-19

7 – Setting Up Connections
Configuring HBA Ports Using the General Configuration Wizard

8. If you clicked Next, the HBA port configuration status message asks whether
you want to configure another HBA port. Click OK to configure another HBA
port; the HBA Port Selection dialog box displays (see step 1). Click Cancel
to proceed to the Finish dialog box.

9. If you clicked Cancel, the Finish dialog box displays (see figure 7-9).

Q

Figure 7-9. Finish Dialog Box

Do one of the following:

❑ Click Back to return to the previous dialog box.

❑ Click Finish to exit the wizard. The changes become effective when the

machine is rebooted. You can reboot the machine now or later.

❑ Click Cancel to exit the General Configuration Wizard without making any

changes.

❑ Click Help to display context-sensitive help.

7-20 FS0054603-00 C

7 – Setting Up Connections

Q

7.3

Configuring LUN Masking Using the LUN Masking Wizard

Configuring LUN Masking Using the LUN Masking Wizard

Use the LUN Masking Wizard to set individual LUNs as masked or unmasked from
the operating system. Enabling a LUN sets the LUN as unmasked; disabling a LUN
sets the LUN as masked.

NOTE: You can also set individual LUNs as masked or unmasked by using the

LUN Configuration dialog box (see section 7.5.1.2).

1. Start the LUN Masking Wizard. From the SANsurfer FC HBA Manager main
window HBA tree, right-click the host (or HBA, HBA port, device, or LUN
connected to the host). Do one of the following:

❑ On the SANsurfer FC HBA Manager main window Wizards menu, click LUN

Masking Wizard.

❑ From the pop-up menu, select LUN Masking Wizard.

❑ Press CTRL+L.

The Device Selection dialog box displays (see figure 7-10).

Figure 7-10. Device Selection Dialog Box

NOTE: If you want to sort the existing entries in the table, click the column

heading. A triangle displays in the heading, indicating an ascending
sort (default). Click the triangle for a descending sort.

FS0054603-00 C 7-21

7 – Setting Up Connections
Configuring LUN Masking Using the LUN Masking Wizard

The dialog box provides:

❑ Information about the LUN masking process.

❑ Device information:

❑ Select. Whether the device is selected for LUN masking configuration
❑ Device Info. Device vendor and device product ID
❑ Node Name. World wide HBA node name
❑ Configured. Whether the device is configured

Do the following:

a. From the table, select the Select check box for device that you want to

configure. You can select only one device at a time.

NOTE: When you finish, you will be prompted whether you want to

configure another device.

b. Do one of the following:

❑ Click Next to proceed.

Q

❑ Click Cancel to exit the LUN Masking Wizard without making any

changes.

❑ Click Help to display context-sensitive help.

2. If you clicked Next, the LUN Masking dialog box displays (see figure 7-11).

7-22 FS0054603-00 C

Figure 7-11. LUN Masking Dialog Box

Q

7 – Setting Up Connections

Configuring LUN Masking Using the LUN Masking Wizard

NOTE: If you want to sort the existing entries in the table, click the column

heading. A triangle displays in the heading, indicating an ascending
sort (default). Click the triangle for a descending sort.

The identifying information displays:

❑ Device Product Vendor. Device manufacturer
❑ Device Product ID. Product ID of the device
❑ Device Product Rev. Device revision level
❑ Device Node Name. World wide node name of the device
❑ Device Port Name. World wide port name of the selected device’s port
❑ Device Port ID. Port ID of the selected device’s port

The LUN list information displays:

❑ Enable. Whether LUN masking is enabled
❑ LUN. LUN number
❑ WWULN. (world wide unique LUN name) World wide name of the LUN

Do the following:

a. From the table, select the Enable check box to enable or disable a specific

LUN. You can select more than one LUN at a time.

b. Do one of the following:

❑ Click Back to return to the previous dialog box.

❑ Click Next to proceed.

❑ Click Cancel to exit the LUN Masking Wizard without making any

changes.

❑ Click Help to display context-sensitive help.

FS0054603-00 C 7-23

7 – Setting Up Connections
Configuring LUN Masking Using the LUN Masking Wizard

3. If you clicked Next, the Confirm Changes dialog box displays (see figure 7-12).

Q

Figure 7-12. Confirm Changes Dialog Box

The identifying information displays:

❑ Device Product Vendor. Device manufacturer
❑ Device Product ID. Product ID of the device
❑ Device Product Rev. Device revision level
❑ Device Node Name. World wide node name of the device
❑ Device Port Name. World wide port name of the selected device’s port
❑ Device Port ID. Port ID of the selected device’s port

The LUN Masking Settings based on the changes display:

❑ Node Name. World wide HBA node name
❑ Port Name. World wide HBA port name
❑ LUN ID. LUN number
❑ Enabled. Whether LUN masking is enabled or disabled

7-24 FS0054603-00 C

Q

7 – Setting Up Connections

Configuring LUN Masking Using the LUN Masking Wizard

Do the following:

a. Review the settings.

b. To save the configuration for reference, click Save Configuration to File.

c. Do one of the following:

❑ Click Back to return to the previous dialog box.

❑ Click Next to proceed.

❑ Click Cancel to exit the LUN Masking Wizard without making any

changes.

❑ Click Help to display context-sensitive help.

4. If you clicked Next, the Security Check dialog box displays. In the Enter
Password box, type the password. Click OK.

5. The LUN Masking Configuration Status dialog box displays (see figure 7-13).

Figure 7-13. LUN Masking Configuration Status Dialog Box

The identifying information displays:

❑ Device Product Vendor. Device manufacturer
❑ Device Product ID. Product ID of the device
❑ Device Product Rev. Device revision level
❑ Device Node Name. World wide node name of the device
❑ Device Port Name. World wide port name of the selected device’s port
❑ Device Port ID. Port ID of the selected device’s port

FS0054603-00 C 7-25

7 – Setting Up Connections
Configuring LUN Masking Using the LUN Masking Wizard

Do the following:

a. Read the information about the changes and the process.

b. Do one of the following:

❑ Click Back to return to the previous dialog box.

❑ Click Next to proceed.

❑ Click Cancel to exit the LUN Masking Wizard without making any

changes.

❑ Click Help to display context-sensitive help.

6. If you clicked Next, the device configuration status message asks whether you
want to configure another device. Click OK to configure another device and
return to the Device Selection dialog box (see step 1). Click Cancel to proceed
to the Finish dialog box.

7. If you clicked Cancel, the Finish dialog box displays (see figure 7-14).

Q

Do one of the following:

❑ Click Back to return to the previous dialog box.

❑ Click Finish to exit the wizard. The changes become effective when the

machine is rebooted. You can reboot the machine now or later.

❑ Click Cancel to exit the LUN Masking Wizard without making any changes.

❑ Click Help to display context-sensitive help.

7-26 FS0054603-00 C

Figure 7-14. Finish Dialog Box

Q

7.4

Configuring Fibre Channel Devices

Perform the following steps to configure Fibre Channel devices:

1. From the SANsurfer FC HBA Manager main window, do the following:

a. In the HBA tree, select the host (or HBA, HBA port, device, or LUN connected

to the host).

b. Do one of the following:

❑ Click the Configure button on the toolbar.

❑ From the Host menu, click Configure.

❑ Right-click the host, HBA, HBA port, device, or LUN in the HBA tree. From

the pop-up menu, select Configure.

❑ Press CTRL+C.

If SANsurfer FC HBA Manager detects an invalid configuration, the detected
invalid device and LUN configuration message displays. Click OK; auto
configure runs automatically.

7 – Setting Up Connections

Configuring Fibre Channel Devices

Invalid configurations include:

❑ A device with contradictory visible paths. Only one path can be visible at a

time.

❑ A LUN with contradictory enabled paths. A configuration is valid when all

paths are enabled or disabled.

The Fibre Channel Port Configuration dialog box displays (see figure 7-15).

Figure 7-15. Fibre Channel Port Configuration Dialog Box

FS0054603-00 C 7-27

7 – Setting Up Connections
Configuring Fibre Channel Devices

The host name displays in the title bar. The table is a two-dimensional view of
the HBAs ports and devices in the machine. The following information displays:

❑ Node Name. World wide device node name

❑ Port Name. World wide device port name

❑ Port ID. Device port ID

❑ HBA Port n (State/Topo/Bind/ID). The HBA port cell in the table represents

a path from the HBA port to the device. The Bind and ID options are not
displayed on Novell NetWare systems.

HBA port cell information consists of the following:

❑ State. The state of the device, which can be Visible, Hidden, or

Unconfigured.

❑ Topo. Short for topology, which is either Fabric (the device is in the fabric)

or Local (the device is on the local loop).

❑ Bind. When this check box is selected, the path is configured and bound

to the target ID. When this check box is cleared, this path is unconfigured.

Q

❑ ID. This drop-down box shows the available target IDs for the target.

In addition, the cell is color-coded as follows to represent path information:

❑ White with Open Eye icon. Path visible to the operating system

❑ Gray with Stop icon. Unconfigured device

❑ White with no icon. No path

2. Select the following, as appropriate, from the Fibre Channel Port
Configuration dialog box:

❑ Configure device paths for this host (see section 7.4.1):

❑ Configuring, unconfiguring, and inversing the configuration of all device

paths (see section 7.4.1.1)

❑ Configuring individual device paths (see section 7.4.1.2)

❑ Configure LUN masking for this host (see section 7.4.2):

❑ Enabling and disabling all LUNs (see section 7.4.2.1)
❑ Configuring LUN masking for a device (see section 7.5)

7-28 FS0054603-00 C

Q

7 – Setting Up Connections

Configuring Fibre Channel Devices

❑ Bind target devices attached to the HBA port (see section 7.7)

❑ Delete persistent configuration data for an HBA port or device (see

section 7.9).

❑ View information (see section 7.6):

❑ HBA port information (see section 7.6.1)
❑ Device information (see section 7.6.2)

❑ Get help. From the Help menu, click Browse Contents. The help text for

the Fibre Channel Port Configuration dialog box displays.

3. The modified configuration set up by SANsurfer FC HBA Manager can be either
applied to the live system for dynamic updates or saved to the system's
persistent configuration data. If the configuration is saved, the HBA's driver
retrieves the data from the persistent configuration data at the next system
bootup and configures the system accordingly.

NOTE: Some older versions of the drivers do not support persistent

configuration data and the application does not save persistent
configuration entries for these drivers.

Do one of the following:

❑ Click Save to save the new configuration. The new configuration is saved

to the persistent configuration data so that it will be used the next time the
system is rebooted. The current boot configuration remains in memory and
redisplays after the save operation completes.

The following messages can display:

❑ If the save was successful, the configuration saved— must reboot

message displays. Click OK. Reboot the system that you configured to
display the new configuration.

❑ If the save failed, the save configuration failed message displays. The

failure is usually caused by communication problems between the GUI
and agent. Click OK.

❑ Click Cancel to not save the configuration changes.

FS0054603-00 C 7-29

7 – Setting Up Connections
Configuring Fibre Channel Devices

7.4.1

Q

Configuring Device Paths for this Host

You can configure device paths for a host as visible, hidden, or unconfigured. Use
the following options as appropriate:

■ Configuring, unconfiguring, and inversing the configuration of all device paths

(see section 7.4.1.1)

■ Configuring individual device paths (see section 7.4.1.2)

NOTE: There must be one visible path for the operating system to see a device.

7.4.1.1

Configuring, Unconfiguring, and Inversing the Configuration of All
Device Paths

Perform the following steps to configure, unconfigure, or inverse the configuration
of all device paths.

1. From the Fibre Channel Port Configuration dialog box Device menu, click
Configure to configure the device paths on this host.

2. Select one of the following:

❑ Select Configure All to configure all unconfigured device paths.

❑ Select unConfigure All to unconfigure all configured device paths.

❑ Select Inverse State to set configured device paths as unconfigured and

unconfigured device paths as configured.

7-30 FS0054603-00 C

Q

7.4.1.2

Configuring Individual Device Paths

Perform the following steps to set device path visibility to the operating system.

NOTE: There must be one visible path for the operating system to see the device.

1. From the Fibre Channel Port Configuration dialog box, right-click in the cell
in the HBA Port n column.

2. From the pop-up menu, select one of the available options:

❑ Select Set Visible to set this path as visible by the operating system during

the boot process.

❑ Select Set Unconfigured to set this path as not visible by the operating

system.

3. If setting the path has caused the LUNs associated with this device to have an
invalid configuration, the modify LUN configuration message displays. When
the problem occurs, it usually results from changing a device to or from the
unconfigured state. You need to modify the LUN configuration for this device
before the configuration can be saved or applied. Click OK.

7 – Setting Up Connections

Configuring Fibre Channel Devices

7.4.2

Configuring LUN Masking for this Host

You can configure LUN masking — set LUNs as masked or unmasked from the
operating system. Enabling a LUN sets the LUN as unmasked; disabling a LUN
sets the LUN as masked.

Use the following options as appropriate:

■ Enabling and disabling all LUNs (see section 7.4.2.1)

■ Configuring LUN paths and LUN masking for a device (see section 7.5)

FS0054603-00 C 7-31

7 – Setting Up Connections
Configuring LUNs for a Device

7.4.2.1

Enabling and Disabling All LUNs on this Host

You can configure LUN masking — setting LUNs masked or unmasked from the
operating system. Enabling a LUN sets the LUN as unmasked; disabling a LUN
sets the LUN as masked.

Perform the following steps to enable or disable all LUNs on this host:

1. From the Fibre Channel Port Configuration dialog box LUNs menu, select
Enable LUNs.

2. Do one of the following:

❑ Select Enable All to configure all LUNs as enabled.

❑ Select Disable All to configure all LUNs as disabled.

❑ Select Inverse State to enable currently disabled LUNs and disable currently

enabled LUNs.

7.5

Configuring LUNs for a Device

Q

Perform the following steps to configure individual LUNs for a selected device:

1. Do one of the following:

❑ In the Fibre Channel Port Configuration dialog box, click in the cell in the

device Node Name, device Port Name, or device Port ID column. From the
Device menu, select Configure LUNs.

❑ In the Fibre Channel Port Configuration dialog box, right-click in the cell

in the device Node Name, device Port Name, or device Port ID column. From
the pop-up menu, select Configure LUNs.

❑ In the Fibre Channel Port Configuration dialog box, double-click in the

cell in the device Node Name, device Port Name, or device Port ID column.
From the pop-up menu, select Configure LUNs.

The following messages can display:

❑ If SANsurfer FC HBA Manager detects an invalid LUN configuration, the

detected invalid LUN configuration message displays. Invalid LUN
configurations include a LUN with contradictory enabled paths. All paths
must be enabled or disabled.

Click OK; auto configure runs automatically.

❑ If SANsurfer FC HBA Manager detects an invalid SAN fabric configuration,

the detected invalid SAN fabric message displays. Change this configuration
before continuing; it is beyond the scope of SANsurfer FC HBA Manager to
configure the SAN fabric. Click OK to continue.

7-32 FS0054603-00 C