Qlogic SANsurfer iSCSI HBA Manager User manual

Brand: Qlogic

Model: SANsurfer iSCSI HBA Manager

Type: User manual

IS0054602-00 B

SANsurfer iSCSI HBA Manager

User’s Guide

Management Tool for

QLogic iSCSI Host Bus Adapters

Page ii IS0054602-00 B

SANsurfer iSCSI HBA Manager User’s Guide

Management Tool for QLogic iSCSI 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.

Document Revision History

Revision A, July 27, 2004

Revision B, October 17, 2008

Changes Sections Affected

Revision B Changes:

Converted to new user’s guide template. All

Modified guide title and subtitle. Title page, page headers

Updated most screen shots. All

1. Introduction section updated and expanded to

include new material such as documentation con-

ventions used in the guide, intended audience,

location of license agreements, and how to obtain

technical support.

1 Introduction

3. SANsurfer iSCSI HBA Manager Overview sec-

tion updated and expanded to include new fea-

tures and support for Windows Server 2008.

2 SANsurfer iSCSI HBA Manager Overview

2. System Overview and 4. System Requirements

sections combined into one section.

3 System Requirements and Installation Checklist

5. Installing SANsurfer iSCSI HBA Manager sec-

tion updated and expanded to include installation

using a command line interface, and instructions

for updating SANsurfer iSCSI HBA Manager from

the Web or CD. Removed obsolete information

regarding SANsurfer Control iX, updated installa-

tion configurations table, and removed obsolete

Windows NT and NetWare agent information.

4 Installing SANsurfer iSCSI HBA Manager

6. Getting Started section updated and expanded.

Added support for Windows Server 2008.

5 Getting Started

SANsurfer iSCSI HBA Manager User’s Guide

Management Tool for QLogic iSCSI Host Bus Adapters

IS0054602-00 B Page iii

Removed the following sections that were included

in rev. A of the user’s guide. Information from these

sections is now in the SANsurfer iSCSI HBA Man-

ager help system:

7. Setting Up Connections

8. Monitoring the Connections

9. Displaying Host, HBA Port, Device, and LUN

Information

11. Updating the HBA

—

10. Performing Diagnostics section expanded to

include procedures for viewing IPv6 logs and set-

ting diagnostic test parameters for running loop-

back and read/write buffer tests.

6 Performing Diagnostics

12. Troubleshooting section expanded to include a

list of troubleshooting tools, procedures for verify-

ing that the HBA driver and iqlremote are installed,

using debug to trace user interface and agent

activity, and retrieving records such as the HBA

core dump, Flash NVRAM, and HBA crash.

7 Troubleshooting

Added Windows 2008 support to FAQ table. A Frequently Asked Questions

Moved Appendix C Contacting QLogic information

to 1 Introduction.

“Technical Support” on page 1-4

Added index entries. Index

Page iv IS0054602-00 B

SANsurfer iSCSI HBA Manager User’s Guide

Management Tool for QLogic iSCSI Host Bus Adapters

Notes

IS0054602-00 B Page v

Table of Contents

1 Introduction

Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

What’s in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

Typographic Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

Related Documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

License Agreements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4

Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4

Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4

Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4

2 SANsurfer iSCSI HBA Manager Overview

General Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

Asset Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

Configuration Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

HBA State and Target Session Connection State Monitoring . . . . . . . 2-3

Additional Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

3 System Requirements and Installation Checklist

Installation Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

Step 1: Collect the Hardware and Software. . . . . . . . . . . . . . . . . . . . . 3-1

Required Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

Required Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2

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

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

Step 4: Install and Run SANsurfer iSCSI HBA Manager. . . . . . . . . . . 3-3

Remote Procedure Calls (RPCs) . . . . . . . . . . . . . . . . . . . . . . . . 3-3

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

Page vi IS0054602-00 B

SANsurfer iSCSI HBA Manager User’s Guide

Management Tool for QLogic iSCSI Host Bus Adapters

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4

Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4

Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5

Supported QLogic HBAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6

4 Installing SANsurfer iSCSI HBA Manager

Initial Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

Installation Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2

Installation Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

Step 1: Download the Installation . . . . . . . . . . . . . . . . . . . . . . . . 4-3

Step 2: Start the Installation File . . . . . . . . . . . . . . . . . . . . . . . . . 4-4

Step 3: Follow the Installation Wizard. . . . . . . . . . . . . . . . . . . . . 4-5

Installation Instructions Using CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15

Standalone Installer Command Lines . . . . . . . . . . . . . . . . . . . . . 4-15

Web- and CD-based Installation Updates . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17

Updating SANsurfer by Web Update. . . . . . . . . . . . . . . . . . . . . . . . . . 4-17

Network Does Not Use Proxy Settings. . . . . . . . . . . . . . . . . . . . 4-18

Network Requires Proxy Settings. . . . . . . . . . . . . . . . . . . . . . . . 4-18

Updating SANsurfer by Package Update . . . . . . . . . . . . . . . . . . . . . . 4-21

Uninstalling SANsurfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24

5 Getting Started

Starting SANsurfer iSCSI HBA Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

Starting SANsurfer iSCSI HBA Manager on Windows . . . . . . . . . . . . 5-1

Starting SANsurfer iSCSI HBA Manager on Linux or Solaris . . . . . . . 5-2

SANsurfer iSCSI HBA Manager Main Window . . . . . . . . . . . . . . . . . . . . . . 5-3

HBA Tree. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5

Host Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5

HBA Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5

HBA Port Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6

Device Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6

LUN Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7

Exiting SANsurfer iSCSI HBA Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7

Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7

Viewing the Help System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8

What’s in the Help System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9

Specifying the Help Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9

Viewing SANsurfer iSCSI HBA Manager Information . . . . . . . . . . . . . 5-10

IS0054602-00 B Page vii

SANsurfer iSCSI HBA Manager User’s Guide

Management Tool for QLogic iSCSI Host Bus Adapters

Setting Up SANsurfer iSCSI HBA Manager . . . . . . . . . . . . . . . . . . . . . . . . . 5-11

Setting SANsurfer iSCSI HBA Manager Security . . . . . . . . . . . . . . . . 5-11

Specifying Whether iSCSI Names or iSCSI Alias Names Appear

in the HBA Tree. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14

Setting the Options for Retrieving Host Status Alarms and

Refreshing the Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15

Specifying the Polling Intervals to Retrieve Host Status

Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16

Specifying the HBA Polling Interval . . . . . . . . . . . . . . . . . . . . . . 5-17

Specifying the Host Polling Interval . . . . . . . . . . . . . . . . . . . . . . 5-18

Specifying Whether the Configuration Refreshes When

Host and Target Status Alarms Occur . . . . . . . . . . . . . . . . . . . 5-19

Specifying Whether the Host Refresh Prompt Appears . . . . . . . 5-20

Refreshing the Configuration Immediately . . . . . . . . . . . . . . . . . 5-21

6 Performing Diagnostics

General Information for the HBA Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2

Pinging Targets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

Ping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

Pinging IPv4 and IPv6 Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4

Viewing Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6

Viewing the ARP Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6

Viewing the Connection Error Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8

Viewing the IPv6 Destination Cache Log . . . . . . . . . . . . . . . . . . . . . . 6-10

Viewing the IPv6 Neighbor Cache Log . . . . . . . . . . . . . . . . . . . . . . . . 6-11

Viewing the IPv6 Router List Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13

Viewing the IPv6 Local Prefix List Log . . . . . . . . . . . . . . . . . . . . . . . . 6-14

Setting Diagnostic Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16

Running a Loopback Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16

Running a Read/Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-18

Tracing User and Agent Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-21

7 Troubleshooting

Troubleshooting Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1

Windows Event Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1

SANsurfer iSCSI HBA Manager Tools. . . . . . . . . . . . . . . . . . . . . . . . . 7-2

Troubleshooting Problems and Solutions. . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

Installation Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3

User Interface and Remote Agent Issues . . . . . . . . . . . . . . . . . . . . . . 7-4

Functional Issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9

Page viii IS0054602-00 B

SANsurfer iSCSI HBA Manager User’s Guide

Management Tool for QLogic iSCSI Host Bus Adapters

Verifying That the HBA Driver is Installed . . . . . . . . . . . . . . . . . . . . . . . . . . 7-12

Verifying That iqlremote is Installed and Running . . . . . . . . . . . . . . . . . . . . 7-13

Using Debug to Trace User Interface and Agent Activity . . . . . . . . . . . . . . . 7-14

Tracing User Interface Activity for Windows OS . . . . . . . . . . . . . . . . . 7-15

Saving Agent Activity Logs for Windows OS. . . . . . . . . . . . . . . . . . . . 7-19

Tracing User Interface Activity for UNIX OS . . . . . . . . . . . . . . . . . . . . 7-20

Saving Agent Activity Logs for UNIX OS. . . . . . . . . . . . . . . . . . . . . . . 7-22

Retrieving Records. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-22

Retrieving the HBA Core Dump Record . . . . . . . . . . . . . . . . . . . . . . . 7-23

Retrieving the Flash NVRAM Record . . . . . . . . . . . . . . . . . . . . . . . . . 7-26

Retrieving the HBA Crash Record. . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-29

A Frequently Asked Questions

Glossary

Index

IS0054602-00 B Page ix

SANsurfer iSCSI HBA Manager User’s Guide

Management Tool for QLogic iSCSI Host Bus Adapters

List of Figures

Figure Page

4-1 QLogic Driver Downloads / Documentation Page . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4

4-2 Installation Wizard: Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5

4-3 Installation Wizard: Important Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6

4-4 Installation Wizard: Choose Product Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7

4-5 Installation Wizard: Choose Product Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8

4-6 Installation Wizard: Choose Install Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9

4-7 Installation Wizard: Previous SANsurfer Install Detected . . . . . . . . . . . . . . . . . . . . 4-10

4-8 Installation Wizard: Select Shortcut Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11

4-9 Installation Wizard: Create Desktop Icon Selection . . . . . . . . . . . . . . . . . . . . . . . . . 4-12

4-10 Installation Wizard: Pre-Installation Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13

4-11 Installation Wizard: Installing SANsurfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14

4-12 Installation Wizard: Install Complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15

4-13 Update SANsurfer: Select Update Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18

4-14 Update SANsurfer: Server Proxy Settings Dialog Box. . . . . . . . . . . . . . . . . . . . . . . 4-19

4-15 Update SANsurfer: Update Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20

4-16 Update SANsurfer: Select Update Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21

4-17 Update SANsurfer: Open Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-22

4-18 Update SANsurfer: Update Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23

4-19 Uninstall SANsurfer: Add/Remove Programs Dialog Box . . . . . . . . . . . . . . . . . . . . 4-25

4-20 Uninstall SANsurfer: Uninstall SANsurfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-26

4-21 Uninstall SANsurfer: Uninstall Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27

4-22 Uninstall SANsurfer: Choose Product Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-28

4-23 Uninstall SANsurfer: Feature Removal In-progress . . . . . . . . . . . . . . . . . . . . . . . . . 4-29

4-24 Uninstall SANsurfer: Uninstall Complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-30

5-1 SANsurfer Desktop Icon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

5-2 SANsurfer iSCSI HBA Manager Main Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4

5-3 Help Window Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8

5-4 Browser Location Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9

5-5 About SANsurfer iSCSI HBA Manager Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10

5-6 Security Page (Host) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13

5-7 HBA Tree Naming Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14

5-8 Application Options: Tree View Naming Preference . . . . . . . . . . . . . . . . . . . . . . . . 5-15

5-9 Polling Setting Dialog Box (HBA). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17

5-10 Host Polling Setting Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18

5-11 Application Options: Update Behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19

5-12 Application Options: Prompting Behavior. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20

5-13 iSCSI Configuration Change Confirmation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21

6-1 Diagnostics Page: HBA Port Info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2

6-2 Ping Page (Diagnostics). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

6-3 Ping Status Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5

6-4 Logs Page (Diagnostics) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7

6-5 ARP Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7

6-6 Connection Error Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8

Page x IS0054602-00 B

SANsurfer iSCSI HBA Manager User’s Guide

Management Tool for QLogic iSCSI Host Bus Adapters

6-7 IPv6 Destination Cache Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10

6-8 Neighbor Cache Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12

6-9 IPv6 Router List Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13

6-10 IPv6 Prefix List Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15

6-11 Advanced Page (Diagnostics): Loopback Test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-17

6-12 Advanced Page (Diagnostics): Read/Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . 6-19

6-13 Diagnostics Options Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-21

7-1 Windows: Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-14

7-2 local.properties in Notepad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-16

7-3 Command Prompt Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-17

7-4 “Command Prompt” Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-18

7-5 Apply Properties to Shortcut Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-18

7-6 SANsurfer.exe in Console Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-19

7-7 local.properties in Notepad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-21

7-8 HBA Utilities Page (HBA Options) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-24

7-9 Save FW Coredump Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-25

7-10 HBA Utilities Page (HBA Options) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-27

7-11 Save FW Flash & NVRAM Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-28

7-12 HBA Utilities Page (HBA Options) for QLA4010x . . . . . . . . . . . . . . . . . . . . . . . . . . 7-30

7-13 Save Crash Record Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-31

List of Tables

Table Page

1-1 Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

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

7-1 Troubleshooting: Installation Issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3

7-2 Troubleshooting: User Interface and Remote Agent Issues. . . . . . . . . . . . . . . . . . . 7-4

7-3 Troubleshooting: Functional Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9

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

IS0054602-00 B 1-1

1 Introduction

The SANsurfer iSCSI HBA Manager User’s Guide describes SANsurfer

iSCSI

HBA Manager, a component of the QLogic

SANsurfer tool. SANsurfer iSCSI

HBA Manager is a comprehensive tool for configuration and management of

QLogic SANsurfer iSCSI host bus adapters (HBAs) used in storage area networks

(SANs).

Intended Audience

The information in this guide is intended for OEMs, field service personnel, and

customers who are installing and using QLogic hardware and SANsurfer iSCSI

HBA Manager. Users should be familiar with the hardware installation and the

operating systems where HBAs are installed.

What’s in This Guide

This guide contains the basic information you need to get started with the

SANsurfer iSCSI HBA Manager user interface (UI). For detailed information about

the features and functionality not covered in this guide, refer to the help system

(see “What’s in the Help System” on page 5-9).

This introductory section specifies the intended audience, explains the

typographic conventions used, lists related documents, refers you to the QLogic

license agreements, and provides technical support and contact information.

The remainder of the user's guide contains the following chapters and appendix:

 2 SANsurfer iSCSI HBA Manager Overview provides a general product

overview and describes in detail its features.

 3 System Requirements and Installation Checklist lists the hardware and

software requirements needed for optimum SANsurfer iSCSI HBA Manager

performance, and provides a checklist for installation.

NOTE:

Throughout this guide, HBA and adapter are used interchangeably, as are

the terms target and device.

1 – Introduction

What’s in This Guide

1-2 IS0054602-00 B

 4 Installing SANsurfer iSCSI HBA Manager describes how to install, update,

and uninstall SANsurfer iSCSI HBA Manager.

 5 Getting Started describes how to customize SANsurfer iSCSI HBA

Manager. It includes starting and exiting the SANsurfer iSCSI HBA Manager

user interface, getting help, setting security, and setting the options that

activate each time you start SANsurfer iSCSI HBA Manager.

 6 Performing Diagnostics provides procedures for pinging targets, viewing

various logs, and setting up and running loopback and read/write buffer

tests.

 7 Troubleshooting presents common troubleshooting questions and

answers. It also provides the procedures for tracing the SANsurfer iSCSI

HBA Manager user interface and agent activity (if directed to do so by your

authorized service provider), and for retrieving records such as the HBA

core dump, Flash NVRAM, and HBA crash.

 Appendix A Frequently Asked Questions lists and provides the answers to

frequently asked questions about SANsurfer iSCSI HBA Manager.

 Glossary lists common hardware, software, and iSCSI terms that are used in

SANsurfer iSCSI HBA Manager.

In addition, at the end of this guide is an index to help you easily locate the

information you need.

Typographic Conventions

This guide uses the following documentation conventions:

 Text in blue font indicates a hyperlink (jump) to a figure, table, or section in

this guide, and links to Web sites are shown in underlined blue

. For

example:

 Table 9-2 lists problems related to the SANsurfer iSCSI HBA Manager

user interface and remote agent.

 See “Pinging Targets” on page 6-2.

 For more information, visit www.qlogic.com.

NOTE:

Notes provide additional information.

CAUTION!

Cautions indicate that failure to follow instructions might result in damage to

data or equipment.

1 – Introduction

License Agreements

IS0054602-00 B 1-3

 Text in bold font indicates SANsurfer iSCSI HBA Manager user interface

elements such as a menu items, buttons, check boxes, or column headings.

For example:

 Click the Start button, point to Programs, point to Accessories, and

then click Command Prompt.

 Under Notification Options, select the Warning Alarms check box.

 Text i n sans serif font indicates a file name, directory path, keyboard key,

or command line text. For example:

 To connect to a group of hosts listed in a host group file (.hst), type

SANsurfer -g path

and then press ENTER.

 Press CTRL+SHIFT+T.

 Text i n italics indicates emphasis, terms, document titles, or help topic titles.

For example:

 For a complete listing of license agreements, refer to the QLogic

Software End User License Agreement.

 For details, see Displaying HBA Information in the help system.

Related Documents

Table 1-1 lists other documents you may find helpful when installing or using

SANsurfer iSCSI HBA Manager.

License Agreements

For a complete listing of all license agreements affecting this product, refer to the

QLogic Software End User License Agreement.

Table 1-1. Related Documents

Part Number

or Name

Title

IS0054501-00

Rev C

Quick Start Guide: iSCSI HBA Installation (PDF).

readme.txt SANsurfer notes included with SANsurfer iSCSI HBA Manager.

Release notes SANsurfer iSCSI HBA Manager Release Notes provide details

about modifications made since the previous version. Separate

release notes are provided for each operating system.

SN0054621-00

Rev. E

SANsurfer iSCSI HBA CLI User’s Guide provides interactive menu

and non-interactive mode options for the command line interface.

1 – Introduction

Technical Support

1-4 IS0054602-00 B

Technical Support

Customers should contact their authorized maintenance provider for technical

support of their QLogic switch products. QLogic-direct customers may contact

QLogic Technical Support; others will be redirected to their authorized

maintenance provider.

For the latest firmware and software updates, visit the QLogic support Web site

listed in Contact Information.

Availability

QLogic Technical Support for products under warranty is available during local

standard working hours, excluding QLogic Observed Holidays.

Training

QLogic offers certification training for the technical professional for both the

QLogic iSCSI HBAs and switches. From the training link at www.qlogic.com

, you

may choose Electronic-based Training or schedule an intensive “hands-on”

Certification course.

Technical Certification courses include installation, maintenance, and

troubleshooting QLogic SAN products. Upon demonstrating knowledge using live

equipment, QLogic awards a certificate identifying the student as a Certified

Professional. The training professionals at QLogic may be reached by e-mail at

[email protected]

Contact Information

Please feel free to contact your QLogic approved reseller or QLogic Technical

Support at any phase of integration for assistance. QLogic Technical Support can

be reached by the following methods:

Support contact information for other regions of the world is available at the

QLogic Web site: http://support.qlogic.com

The QLogic knowledge database contains troubleshooting information for the

QLogic HBAs. Access the database from the QLogic Web site, www.qlogic.com

Click the Support tab, and then use the search engine at the top of the page to

look for specific troubleshooting information.

Web http://support.qlogic.com

North America Contact Information

E-mail [email protected]

Phone (952) 932-4040

IS0054602-00 B 2-1

2 SANsurfer iSCSI HBA

Manager Overview

This section provides a general overview of the SANsurfer iSCSI HBA Manager

product, and describes its features in detail.

General Overview

QLogic’s SANsurfer iSCSI HBA Manager is a user-based interface tool that

configures and manages both QLogic iSCSI host bus adapters and their attached

devices within a storage area network (SAN) environment. In addition:

 SANsurfer iSCSI HBA Manager works with the Windows

2000, Windows

Server 2003, Windows Server 2008, Windows Vista, Red Hat

Linux

, SLES

Linux, and Solaris

SPARC

operating systems. Because the tool supports

multiple operating systems, it provides control of heterogeneous

environments.

 SANsurfer iSCSI HBA Manager is a client/server tool. The networking

capability of the tool provides centralized management and configuration of

the entire SAN.

Features

SANsurfer iSCSI HBA Manager offers the features described in these sections:

 “Asset Management” on page 2-2

 “Configuration Management” on page 2-2

 “Statistics” on page 2-3

 “Diagnostics” on page 2-3

 “HBA State and Target Session Connection State Monitoring” on page 2-3

 “Additional Features” on page 2-3

2 – SANsurfer iSCSI HBA Manager Overview

Features

2-2 IS0054602-00 B

Asset Management

SANsurfer iSCSI HBA Manager allows you to connect to and disconnect from

local and remote hosts. It provides information about connected hosts and their

attached QLogic iSCSI HBAs, including connected devices and LUNs. Additional

features include:

 HBA-level alias support for simple, user-friendly name identification.

 Automatic iSCSI agent discovery.

Configuration Management

SANsurfer iSCSI HBA Manager allows you to configure local and remote systems.

With SANsurfer iSCSI HBA Manager, you can:

 Configure QLogic iSCSI HBAs, HBA ports, and attached iSCSI targets using

a configuration wizard.

 Configure HBA port boot settings (BIOS and FCode) and boot targets,

including acquiring boot targets via DHCP.

 Clone all or parts of a pre-saved HBA configuration for HBA replacement,

quick configuration duplication on multiple HBA ports across multiple hosts,

or to ensure consistent configurations.

 Save port network, boot, and target configuration settings without card reset.

 Display LUN properties.

 Update HBA firmware, driver, ROM, BIOS, and FCode.

 Update BIOS boot targets.

 Restore factory defaults, fully or selectively.

 Update multiple HBA ports to a specific configuration at the same time.

 Display target redirection information.

 Ability to display and log into multiple Internet Storage Names Service

(iSNS) target portals to the same target.

 Ability to retrieve and display all discovered target portals from a Send

Target discovery.

 Ability to easily duplicate target portal connections to a target for multiple

connections.

 Ability to select which target portals to log into from a discovered targets list

acquired from Send Target discovery and iSNS discovery.

2 – SANsurfer iSCSI HBA Manager Overview

Features

IS0054602-00 B 2-3

Statistics

SANsurfer iSCSI HBA Manager provides statistics for each HBA. These statistics

can be collected automatically or on request, and can be reset at any time.

Diagnostics

SANsurfer iSCSI HBA Manager provides diagnostics that enable you to test the

HBAs and connected devices. Use the SANsurfer iSCSI HBA Manager

diagnostics to:

 Ping a target, which verifies that there is connectivity between an HBA port

and a target.

 View the address resolution protocol (ARP) cache, which keeps a record of

host port connections with other hardware (such as targets) on the network.

 View the connection error log, which lists the 100 latest connection errors for

an HBA port.

 Perform read/write buffer tests.

 Perform internal and external loopback tests.

 View the IPv6 logs for information and assistance with IPv6 configurations:

 Destination Cache

 Neighbor Cache

 Router List

 Prefix List

 Retrieve HBA diagnostics information.

HBA State and Target Session Connection State Monitoring

SANsurfer iSCSI HBA Manager monitors connected QLogic iSCSI HBAs and their

targets and informs you of their state. For HBAs, the state color indicates bad

(red), unknown (blue), warning (yellow), or good (green).

Additional Features

Additional SANsurfer iSCSI HBA Manager features allow you to:

 Save host configuration to a text file.

 Save and load detailed host configuration of the iSCSI HBAs and connected

targets to and from a binary file for later offline viewing.

 Specify hexadecimal CHAP secrets.

 View detailed host configuration differences of the iSCSI HBAs and

connected targets from a prior saved configuration.

 View Vendor Private Data (VPD) on iSCSI HBAs for available data, if

provided by the OEM/manufacturer.

2 – SANsurfer iSCSI HBA Manager Overview

Features

2-4 IS0054602-00 B

 Configure, test, check status, and diagnose connections to IPv6 iSCSI

targets on IPv6 enabled HBA cards, for example the QLE406xC cards.

 Automatically check for SANsurfer iSCSI HBA Manager updates.

 Manually check for SANsurfer iSCSI HBA Manager updates.

 Manage iSCSI and Fibre Channel HBAs and Fibre Channel switches. Each

tool appears on its own tab in the HBA tree.

NOTE:

IPv6 features, as well as some other features, are not available and appear

dimmed if one of the following applies:

 You are using inbox/ioctl module drivers with Red Hat 4 and 5 and SLES

10. (To obtain the driver version string, use the modinfo qla4xxx

command at the UNIX prompt. If you are using the inbox/ioctl module

drivers, its version string contains a d.)

 You do not have ACB (Alternate Control Block) support with the proper

hardware configuration, drivers, and firmware.

You can access these features if you have the correct hardware

configuration and download the latest drivers and firmware from the QLogic

Web site.

IS0054602-00 B 3-1

3 System Requirements and

Installation Checklist

SANsurfer iSCSI HBA Manager is a collection of device drivers and management

software for controlling, configuring, and managing devices in a SAN environment

that uses QLogic iSCSI HBAs. Use the following Installation Checklist to help you

install all hardware and software properly and in the correct order. To see a list of

the required hardware and software, refer to the “System Requirements” on

page 3-4.

Installation Checklist

This section describes the installation process step-by-step. Depending on the

features you require, your configuration may not require all steps.

 Step 1: Collect the Hardware and Software

 Step 2: Install the Hardware

 Step 3: Install the Driver

 Step 4: Install and Run SANsurfer iSCSI HBA Manager

 Step 5: Configure the Disks in the Operating System

Step 1: Collect the Hardware and Software

Collect the required hardware and software as listed in these sections.

Required Hardware

Collect the required hardware (see also “Hardware Requirements” on page 3-4).

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

 QLogic iSCSI.

 HBA target devices such as disks, tape devices, RAID subsystems, iSCSI

routers, and so on.

 Connectivity hardware such as cables, hubs, switches, and so on.

3 – System Requirements and Installation Checklist

Installation Checklist

3-2 IS0054602-00 B

Required Software

Collect the required software (see also “Software Requirements” on page 3-5):

 QLogic iSCSI HBA drivers

 SANsurfer iSCSI HBA Manager

 QLogic Fast!UTIL, iSCSI HBA BIOS Utility

For basic operation, you will need both of the following:

 QLogic iSCSI HBA drivers

 SANsurfer iSCSI HBA Manager or QLogic Fast!UTIL

To discover and connect to iSCSI devices, you will need one of the following:

 SANsurfer iSCSI HBA Manager

 QLogic Fast!UTIL

SANsurfer iSCSI HBA Manager is a management utility that enables you to view,

manage, and diagnose QLogic HBAs. SANsurfer iSCSI HBA Manager also

configures QLogic iSCSI HBAs and target devices on the HBAs.

Step 2: Install the Hardware

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

“Related Documents” on page 1-3). Cable target devices through the combination

of 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 utility.

To acc ess Fast!UTIL, type ALT+Q or CTRL+Q during power up.

Fast!UTIL allows you to perform basic HBA configuration. Fast!UTIL can verify

device connectivity.

Step 3: Install the Driver

Refer to the appropriate software installation guide (see “Related Documents” on

page 1-3) and readme.txt file to install a device driver on host systems.

NOTE:

 Some operating systems come from the operating system manufacturer

with a QLogic miniport device driver. To ensure support for the latest

QLogic HBA and SANsurfer tool features, install the most current device

driver. The most current device driver versions can be found at the

QLogic Web site (www.qlogic.com

 Connections to iSCSI targets must be configured with SANsurfer iSCSI

HBA Manager or QLogic Fast!UTIL in order for them to be visible to the

operating system.

Page is loading ...

Qlogic SANsurfer iSCSI HBA Manager User manual

Qlogic SANsurfer iSCSI HBA Manager User manual

Qlogic SANsurfer iSCSI HBA Manager User manual

Related papers

Other documents