Qlogic SANsurfer iSCSI HBA Manager User Manual

SANsurfer iSCSI HBA Manager

User’s Guide

Management Tool for

QLogic iSCSI Host Bus Adapters

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.

S

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.

3. SANsurfer iSCSI HBA Manager Overview sec-

tion updated and expanded to include new fea­tures and support for Windows Server 2008.

2. System Overview and 4. System Requirements

sections combined into one section.

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.

6. Getting Started section updated and expanded.

Added support for Windows Server 2008.

1 Introduction

2 SANsurfer iSCSI HBA Manager Overview

3 System Requirements and Installation Checklist

4 Installing SANsurfer iSCSI HBA Manager

5 Getting Started

Page ii IS0054602-00 B

S

SANsurfer iSCSI HBA Manager User’s Guide

Management Tool for QLogic iSCSI Host Bus Adapters

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.

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.

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

Moved Appendix C Contacting QLogic information
to 1 Introduction.

—

6 Performing Diagnostics

7 Troubleshooting

“Technical Support” on page 1-4

Added index entries. Index

IS0054602-00 B Page iii

SANsurfer iSCSI HBA Manager User’s Guide
Management Tool for QLogic iSCSI Host Bus Adapters

Notes

S

Page iv IS0054602-00 B

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

IS0054602-00 B Page v

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

S

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

Page vi IS0054602-00 B

A

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

SANsurfer iSCSI HBA Manager User’s Guide

Management Tool for QLogic iSCSI Host Bus Adapters

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

IS0054602-00 B Page vii

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

S

Page viii IS0054602-00 B

SANsurfer iSCSI HBA Manager User’s Guide

A

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

IS0054602-00 B Page ix

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

S

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

Page x IS0054602-00 B

1 Introduction

The SANsurfer iSCSI HBA Manager User’s Guide describes SANsurfer® iSCSI
HBA Manager, a component of the QLogic

HBA Manager is a comprehensive tool for configuration and management of
QLogic SANsurfer iSCSI host bus adapters (HBAs) used in storage area networks
(SANs).

NOTE:

Throughout this guide, HBA and adapter are used interchangeably, as are
the terms target and device.

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.

®

SANsurfer tool. SANsurfer iSCSI

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.

IS0054602-00 B 1-1

1 – Introduction
What’s in This Guide

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

 5 Getting Started describes how to customize SANsurfer iSCSI HBA

 6 Performing Diagnostics provides procedures for pinging targets, viewing

 7 Troubleshooting presents common troubleshooting questions and

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

S

and uninstall SANsurfer iSCSI HBA Manager.

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.

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

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.

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:

NOTE:

Notes provide additional information.

CAUTION!

Cautions indicate that failure to follow instructions might result in damage to
data or equipment.

 Tex t i n 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
example:

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

user interface and remote agent.

. For

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

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

1-2 IS0054602-00 B

A

1 – Introduction

License Agreements

 Tex t i n 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.

 Tex t 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

 Press CTRL+SHIFT+T.

 Tex t 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.

Part Number

or Name

IS0054501-00
Rev C

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

and then press ENTER.

Table 1-1. Related Documents

Title

Quick Start Guide: iSCSI HBA Installation (PDF).

Release notes SANsurfer iSCSI HBA Manager Release Notes provide details

SN0054621-00
Rev. E

License Agreements

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

QLogic Software End User License Agreement.

IS0054602-00 B 1-3

about modifications made since the previous version. Separate
release notes are provided for each operating system.

SANsurfer iSCSI HBA CLI User’s Guide provides interactive menu

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

1 – Introduction
Technical Support

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
may choose Electronic-based Training or schedule an intensive “hands-on”
Certification course.

S

, you

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

[e-mail]

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:

Web http://support.qlogic.com

North America Contact Information

E-mail [e-mail]

Phone [phone]

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.

.

.

1-4 IS0054602-00 B

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

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

®

Linux, and Solaris
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.

SPARC® operating systems. Because the tool supports

®

2000, Windows

®

Linux®, SLES

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

IS0054602-00 B 2-1

2 – SANsurfer iSCSI HBA Manager Overview
Features

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.

S

 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-2 IS0054602-00 B

A

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

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

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

 Perform read/write buffer tests.

2 – SANsurfer iSCSI HBA Manager Overview

Features

and a target.

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

an HBA port.

 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.

IS0054602-00 B 2-3

2 – SANsurfer iSCSI HBA Manager Overview
Features

 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.

S

2-4 IS0054602-00 B

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.

IS0054602-00 B 3-1

3 – System Requirements and Installation Checklist
Installation Checklist

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.

S

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 a cc es s 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.

).

3-2 IS0054602-00 B

3 – System Requirements and Installation Checklist

A

Installation Checklist

Verification: Verify that the HBAs recognize target devices by using the

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

 Windows: On supported Windows systems, 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.

 Linux: On supported Linux systems, 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.

 Solaris: On supported Solaris systems, open /var/adm/messages to

view which target devices are configured on which HBAs.

Step 4: Install and Run SANsurfer iSCSI HBA Manager

For complete installation instructions, see section 4 Installing SANsurfer iSCSI

HBA Manager.

SANsurfer iSCSI HBA Manager runs as both a tool with standalone (non-agent
mode) access to local system QLogic iSCSI HBAs and as a client/server tool. The
client tool runs on a hardware platform that supports Java™ and agents running
on each system that has QLogic HBAs.

If you are using SANsurfer iSCSI HBA Manager on a host system where HBAs
are installed, install the SANsurfer iSCSI HBA Manager tool (the user interface) on
the local host. Installing the SANsurfer iSCSI HBA Manager agent on the local
host is optional.

When it is installed on the local system, the agent is used instead of the non-agent
mode.

Remote Procedure Calls (RPCs)

SANsurfer iSCSI HBA Manager, uses remote procedure calls (RPCs) as follows:

 In Windows, the RPC service (ONC/RPC Portmapper) required by

SANsurfer iSCSI HBA Manager is installed automatically.

 In Linux, the appropriate RPC libraries must be installed by the Linux

distribution. For information about installing RPC services before installing
SANsurfer iSCSI HBA Manager, see the Linux distribution documentation.

 In Solaris SPARC, the /usr/sbin/rpcbind process is required for RPC

communication of the remote agent.

IS0054602-00 B 3-3

3 – System Requirements and Installation Checklist
System Requirements

Step 5: Configure the Disks in the Operating System

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

System Requirements

For optimum performance, SANsurfer iSCSI HBA Manager requires the hardware
and software listed in this section:

 “Hardware Requirements” on page 3-4
 “Software Requirements” on page 3-5
 “Supported QLogic HBAs” on page 3-6

Hardware Requirements

The minimum hardware requirements are as follows:

S

 QLogic QLA4xxx iSCSI to PCI-X host bus adapters, see “Supported QLogic

HBAs” on page 3-6.

 Single-processor or multiprocessor server or workstation:

 Pentium

Server 2003, Windows Server 2008, Windows Vista, Red Hat Linux,
SUSE Linux, or Solaris x86.

 Sun™ Ultra™ 60 for Solaris SPARC.

 iSCSI devices, such as disks. SANsurfer iSCSI HBA Manager supports

most iSCSI devices. For a complete list of devices, see the QLogic SAN

Interoperability Guide, which can be downloaded from the QLogic Web site

(you will be asked to provide your e-mail address):

http://connect.qlogic.com/interopguide/Interoperability.asp

 64 MB of physical RAM are required to run SANsurfer iSCSI HBA Manager;

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

 Video card capable of 256 colors (16K colors recommended) and a

minimum screen resolution of 1024 x 768 pixels are required.

 Approximately 100 MB of disk space.

®

III with 450 MHz or greater for Windows 2000, Windows

 About 150 MB of disk space.

3-4 IS0054602-00 B

A

Software Requirements

The minimum software requirements and conditions are as follows:

 One of the following operating systems:

 Windows 2000 Server or Advanced Server SP4+ (IA32)
 Windows 2000 Server or Advanced Server SP4+ (x64)
 Windows XP Professional (IA32)
 Windows XP Professional (x64)
 Windows Server 2003 Standard Edition or Enterprise Edition SP1

(IA32)

 Windows Server 2003 Standard Edition or Enterprise Edition SP1

(x64)

 Windows Server 2003 Standard Edition or Enterprise Edition, Release

2 (IA32)

 Windows Server 2003 Standard Edition or Enterprise Edition, Release

2 (x64)

 Windows Server 2008 Standard Edition or Enterprise Edition
 Windows Vista (IA32)
 Windows Vista (x64)
 RHEL 3.0, 4.0, 5.0 (IA32)
 RHEL 3.0, 4.0, 5.0 (x64)
 RHEL 4.0, 5.0 (PPC)
 SLES 9.0, 10.0 (IA32)
 SLES 9.0, 10.0 (x64)
 SLES 9.0, 10.0 (PPC)
 Solaris SPARC 9, 10
 Solaris x86 9, 10 (IA32)
 Solaris x86 9, 10 (x64)

3 – System Requirements and Installation Checklist

System Requirements

 QLogic QLA4xxx drivers (such as QLA4010C drivers), as appropriate for

your HBA.

 Common desktop environment (CDE) to run SANsurfer iSCSI HBA Manager

user interface on Solaris systems.

 TCP/IP protocol for remote management on all systems. It is not required for

local management.

 Administrative privileges to install and to perform management functions.

 Adobe

 To view the help system, Internet Explorer

Communicator

IS0054602-00 B 3-5

®

Reader® (version 2.1 or later) to view documentation.

®

(version 6.0 or later), Netscape

®

(version 8.1 or later), or Firefox® (version 2.0 or later).

3 – System Requirements and Installation Checklist
System Requirements

NOTE:

Use the Java runtime environment that is packaged with SANsurfer iSCSI
HBA Manager.

Supported QLogic HBAs

The QLogic iSCSI HBAs are collectively referred to as the QLA4xxx HBA, unless
otherwise noted. For a detailed list of supported QLogic HBAs, see the SANsurfer

HBA Support Matrix (Fibre Channel & iSCSI) on the SANsurfer CD-ROM.

S

3-6 IS0054602-00 B

4 Installing SANsurfer iSCSI

HBA Manager

Installing SANsurfer iSCSI HBA Manager consists of installing the SANsurfer
iSCSI HBA Manager user interface, a platform-specific agent, and help
components, as appropriate.

NOTE:

Before installing SANsurfer iSCSI HBA Manager, read and follow the
instructions in the documents listed in “Related Documents” on page 1-3, as
applicable.

This section provides the following information:

 “Initial Installation” on page 4-1
 “Web- and CD-based Installation Updates” on page 4-17
 “Uninstalling SANsurfer” on page 4-24

Initial Installation

You can install the SANsurfer tool (which includes SANsurfer iSCSI HBA
Manager) using the files from the QLogic Web site or from the SANsurfer
CD-ROM.

The following information applies:

 Install the same version of SANsurfer on all systems in the network.

 Before installing SANsurfer, uninstall any previous versions of the SANsurfer

tool (for example, QMS 1.0 or QMS 2.0 (QMSJ)).

 Installing and running SANsurfer Control iX and the SANsurfer iSCSI HBA

Manager user interface (interface only, not the agent) on the same system is
supported. When using only the SANsurfer iSCSI HBA Manager user
interface, this system monitors QLA4xxx HBAs on remote systems on the
same network.

IS0054602-00 B 4-1

4 – Installing SANsurfer iSCSI HBA Manager
Initial Installation

This section on initial installation includes the following information:

 “Installation Configurations” on page 4-2
 “Installation Instructions” on page 4-3
 “Installation Instructions Using CLI” on page 4-15

Installation Configurations

SANsurfer iSCSI HBA Manager supports both standalone and networked
configurations, as shown in Tab le 4 -1 . Install the software appropriate for your
configuration.

Table 4-1. Configuration Option Installation Requirements

Configuration Software Requirements

Standalone System:

S

This system monitors QLA4xxx HBAs locally.

Networked System:

This system monitors QLA4xxx HBAs locally and
on remote systems on the same network.

This system monitors QLA4xxx HBAs only on
remote systems on the same network.

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

 SANsurfer iSCSI HBA Manager user interface

 Optionally, one of the following:

 SANsurfer iSCSI Windows Agent

 SANsurfer iSCSI Linux Agent

 SANsurfer iSCSI Solaris Agent

 SANsurfer iSCSI HBA Manager user interface

 Optionally, one of the following:

 SANsurfer iSCSI Windows Agent

 SANsurfer iSCSI Linux Agent

 SANsurfer iSCSI Solaris Agent

NOTE: Remote systems must have an agent
installed.

SANsurfer iSCSI HBA Manager user interface

One of the following:

 SANsurfer iSCSI Windows Agent

 SANsurfer iSCSI Linux Agent

 SANsurfer iSCSI Solaris Agent

4-2 IS0054602-00 B

A

Installation Instructions

NOTE:

This section assumes that you may be installing all SANsurfer components
on any of the supported operating systems.

The SANsurfer installer is a self-extracting program that installs the SANsurfer
tools, including SANsurfer iSCSI HBA Manager.

Perform the following steps to install SANsurfer iSCSI HBA Manager on this
system.

Step 1: Download the Installation

To start the installation, download the SANsurfer iSCSI HBA Manager installer.

To download the Installer from the SANsurfer CD-ROM:

1. On the CD-ROM home page, click the button that represents your operating
system.

4 – Installing SANsurfer iSCSI HBA Manager

Initial Installation

2. Accept the SANsurfer software license agreement by clicking I Accept.

3. Select the link for your specific operating system.

4. Click the Management Tools local link.

5. Under Management Tools, select the SANsurfer iSCSI HBA Manager link
for your platform.

6. On the File Download Security dialog box, click Save to save the SANsurfer
iSCSI HBA Manager installer to a location on your hard drive.

To download the Installer from the QLogic Web site:

1. Open the QLogic home page (http://www.qlogic.com

2. Click the Downloads tab to open the Driver Downloads / Documentation
page.

).

IS0054602-00 B 4-3

4 – Installing SANsurfer iSCSI HBA Manager
Initial Installation

3. Go to the table under QLogic Models, as shown in Figure 4-1.

Figure 4-1 QLogic Driver Downloads / Documentation Page

S

4. Choose your download options as follows:

a. In first column, select iSCSI HBAs.

b. In the second column, select your HBA model number.

c. In the third column, select your operating system type.

d. Click Go.

The download page for the selected HBA and operating system opens.

5. In the Management Tools table under Name, click SANsurfer iSCSI HBA
Manager.

6. Accept the End User Software License Agreement by clicking Agree.

7. On the File Download–Security Warning dialog box, click Save to save the
iSCSI HBA Manager installer to a location on your hard drive.

Step 2: Start the Installation File

To select and start the installation file:

 For a supported Windows system, locate the folder where you downloaded

the installation file, and then double-click the
<installation_filename>.exe file.

 For a supported Linux or Solaris system:

1. Open a shell.

2. Change to the directory where you downloaded the SANsurfer

installation file.

4-4 IS0054602-00 B

A

3. To ensure that the SANsurfer installer file is executable and to start the

installation, type the following, and then press ENTER.

sh ./<installation_filename>.bin

Step 3: Follow the Installation Wizard

To use the installation wizard:

When the installation wizard begins, the Introduction dialog box (Figure 4-2)
opens.

4 – Installing SANsurfer iSCSI HBA Manager

Initial Installation

Figure 4-2 Installation Wizard: Introduction

1. Read the introductory information, and then click Next.

IS0054602-00 B 4-5

4 – Installing SANsurfer iSCSI HBA Manager
Initial Installation

The Important Information dialog box (Figure 4-3) opens.

S

Figure 4-3 Installation Wizard: Important Information

2. Read the important information, and then click Next.

This same information is provided in the readme.txt file, that will be
available following installation in the following locations:

 On supported Windows systems:

Program Files\QLogic Corporation\SANsurfer

 On supported Linux and Solaris systems:

opt/QLogic_Corporation/SANsurfer

4-6 IS0054602-00 B

A

4 – Installing SANsurfer iSCSI HBA Manager

Initial Installation

The Choose Product Features dialog box (Figure 4-4) opens.

Figure 4-4 Installation Wizard: Choose Product Features

NOTE:

Except for the agents that are installed, the feature options are the
same for supported Windows, Linux, and Solaris systems.

 Windows agents are installed on a supported Windows system.

 Linux agents are installed on a supported Linux system.

 Solaris agents are installed on a supported Solaris system.

SANsurfer supports SANsurfer iSCSI HBA Manager and other tools.

Install only the tools appropriate for your configuration. In addition,
SANsurfer iSCSI HBA Manager supports both standalone and network
configurations (see “Installation Configurations” on page 4-2).

3. Select one of the following pre-configured installation sets, and then click
Next:

 Select iSCSI GUI and Agent to install the SANsurfer iSCSI HBA

Manager user interface, including the iSCSI (Windows, Linux, or
Solaris) agent.

IS0054602-00 B 4-7

4 – Installing SANsurfer iSCSI HBA Manager
Initial Installation

 Select iSCSI GUI to install the SANsurfer iSCSI HBA Manager user

interface only. The manager agent is not installed.

 Select iSCSI Windows Agent to install only the SANsurfer iSCSI HBA

Manager agent for a supported Windows system.

 Select Custom to choose which components to install.

4. If you selected Custom in the previous step, in the Choose Product
Components dialog box (Figure 4-5), select the components you want to
install, and then click Next.

S

Figure 4-5 Installation Wizard: Choose Product Features

4-8 IS0054602-00 B

A

4 – Installing SANsurfer iSCSI HBA Manager

Initial Installation

The Choose Install Folder dialog box (Figure 4-6) opens.

Figure 4-6 Installation Wizard: Choose Install Folder

5. Do one of the following:

 To accept the destination location shown in the dialog box

(recommended), click Next.

The default location for a Windows system is:

C:\Program Files\QLogic Corporation\SANsurfer

The default location for a Linux or Solaris system is:

/opt/QLogic_Corporation/SANsurfer

 To select a different location:

a. Click Choose and browse to the location of your choice. The

Choose Install Folder dialog box re-opens.

b. Click Next.

 If you selected a different location and want to re-select the default

location:

a. Click Restore Default Folder.

b. Click Next.

IS0054602-00 B 4-9

4 – Installing SANsurfer iSCSI HBA Manager
Initial Installation

If a version of SANsurfer iSCSI HBA Manager already exists on the system,
the Previous SANsurfer Install Detected dialog box (Figure 4-7) opens.

Figure 4-7 Installation Wizard: Previous SANsurfer Install Detected

S

Because the new version is not compatible with the older version, the
installation procedure prompts you to uninstall the old version.

6. To uninstall the old version of SANsurfer iSCSI HBA Manager:

a. Exit the SANsurfer tool before proceeding.

b. If you want to uninstall the previous install, click Yes. The previous

version is uninstalled. If the previously installed version resides in the
same directory as the currently selected directory, the previous version
is overwritten.

c. If you do not want to uninstall the previous version, click No.

NOTE:

Installation of SANsurfer stops while the previous version is
uninstalled. After the old version of the tool is removed, the installation
continues.

4-10 IS0054602-00 B

A

4 – Installing SANsurfer iSCSI HBA Manager

Initial Installation

If you are installing the SANsurfer iSCSI HBA Manager user interface on a
Windows system, the Select Shortcut Profile dialog box (Figure 4-8) opens.

Figure 4-8 Installation Wizard: Select Shortcut Profile

The shortcut profile determines the type of user to which the shortcuts
appear. Available shortcuts include:

 The SANsurfer icon on the desktop (if you select it in Step 8).

 QLogic Management Suite (SANsurfer and SANsurfer Uninstaller),

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

7. To select the shortcut profile, click one of the following, and then click Next:

 All Users Profile if you want the tool shortcuts available to all users.

 Current Users Profile (default) if you want the tool shortcuts available

only to the current user.

IS0054602-00 B 4-11

4 – Installing SANsurfer iSCSI HBA Manager
Initial Installation

If you are installing the SANsurfer iSCSI HBA Manager user interface on a
Windows system, the Create Desktop Icon Selection dialog box (Figure 4-9)
opens.

S

Figure 4-9 Installation Wizard: Create Desktop Icon Selection

8. If you want the SANsurfer icon to appear on the desktop, select the Create
Desktop Icon check box (default), and then click Next.

NOTE:

If you select the Create Desktop Icon check box, the SANsurfer icon
appears on the desktop for either the current user profile or all user
profiles, depending upon your selection in Step 7.

4-12 IS0054602-00 B

A

4 – Installing SANsurfer iSCSI HBA Manager

Initial Installation

The Pre-Installation Summary dialog box (Figure 4-10) opens.

Figure 4-10 Installation Wizard: Pre-Installation Summary

The pre-installation summary shows you all the choices you made in
previous steps.

9. Review the information. If you want to go back and change any settings,
click Previous. When you are ready to continue, click Install.

IS0054602-00 B 4-13

4 – Installing SANsurfer iSCSI HBA Manager
Initial Installation

The Installing SANsurfer dialog box (Figure 4-11) opens.

S

Figure 4-11 Installation Wizard: Installing SANsurfer

Various windows inform you that the installation is progressing.

4-14 IS0054602-00 B

A

4 – Installing SANsurfer iSCSI HBA Manager

Initial Installation

After the installation is complete, the Install Complete dialog box
(Figure 4-12) opens.

Figure 4-12 Installation Wizard: Install Complete

10. To close the installation wizard, click Done.

To customize SANsurfer iSCSI HBA Manager and set your security
parameters, see 5 Getting Started.

Installation Instructions Using CLI

SANsurfer provides the ability to install the tool and its components as an
unattended command line installation. Unattended installation is available with all
default options. These commands are specific to the SANsurfer iSCSI HBA
Manager standalone package only, and do not apply to the combined packages
with FC (Fibre Channel) and switch components.

Standalone Installer Command Lines

The generalized command for unattended command line installation is:

<installer filename> -i silent –DSILENT_INSTALL_SET="<install set
ID>"

IS0054602-00 B 4-15

4 – Installing SANsurfer iSCSI HBA Manager
Initial Installation

NOTES:

 If you misspell the install set ID or if the installer program cannot find the

install set, then the installer program installs the default install set, which
is the user interface plus the OS agent.

 To change the destination folder, add the -D parameter to the command

lines as follows:

-DUSER_INSTALL_DIR="d:\Apps\SANsurfer" ** you may need
to escape the \ here \\ **

 To prevent installation of the desktop icon, enter the following command:

-DINSTALL_DESKTOP_ICON="false"

The following are examples of the generalized command for specific operating
systems.

Windows

S

Install SANsurfer iSCSI HBA Manager GUI only (HBA)—no agent:

iSCSI_SANsurfer_5_xx_xx_windows_package.exe -i silent

-DSILENT_INSTALL_SET="SB_iX"

Install iSCSI GUI—and agent:

iSCSI_SANsurfer_5_xx_xx_windows_package.exe -i silent

-DSILENT_INSTALL_SET="SB_iX_WI_A"

Install agent only:

iSCSI_SANsurfer_5_xx_xx_windows_package.exe -i silent

-DSILENT_INSTALL_SET="SBiX_WINA"

Linux

Install SANsurfer iSCSI HBA Manager GUI only (HBA)—no agent:

iSCSI_SANsurfer_5_xx_xx_linux_x86.bin -i silent

-DSILENT_INSTALL_SET="SB_iX"

Install iSCSI GUI—and agent:

iSCSI_SANsurfer_5_xx_xx_linux_x86.bin -i silent

-DSILENT_INSTALL_SET="SB_iX_LX_A"

Install agent only:

iSCSI_SANsurfer_5_xx_xx_linux_x86.bin -i silent

-DSILENT_INSTALL_SET="SBiX_LINA"

4-16 IS0054602-00 B

4 – Installing SANsurfer iSCSI HBA Manager

A

Web- and CD-based Installation Updates

Solaris

Install SANsurfer iSCSI HBA Manager GUI only (HBA)—no agent:

iSCSI_SANsurfer_5_xx_xx_Solaris_x86.bin -i silent

-DSILENT_INSTALL_SET="SB_iX"

Install iSCSI GUI—and agent

iSCSI_SANsurfer_5_xx_xx_Solaris_x86.bin -i silent

-DSILENT_INSTALL_SET="SB_iX_SL_A"

Install agent only:

iSCSI_SANsurfer_5_xx_xx_Solaris_x86.bin -i silent

-DSILENT_INSTALL_SET="SBiX_SOLA"

Web- and CD-based Installation Updates

To always keep SANsurfer iSCSI HBA Manager up to date with the latest version,
SANsurfer provides two possible ways to update an existing installation:

 You can download and install an update directly from the Web. See

“Updating SANsurfer by Web Update” on page 4-17.

 You can browse to an existing update package on your hard drive or on

some form of external media; for example, a CD-ROM, DVD, or other
portable storage device. See “Updating SANsurfer by Package Update” on

page 4-21.

Updating SANsurfer by Web Update

Obtain SANsurfer updates from the QLogic Web site or from service personnel.

CAUTION!

To avoid locked files during the update process, you must exit SANsurfer.

To check for updates:

1. On the SANsurfer iSCSI HBA Manager main window, open the Help menu,
and then click Web Update.

IS0054602-00 B 4-17

4 – Installing SANsurfer iSCSI HBA Manager
Web- and CD-based Installation Updates

The Select Update dialog box (Figure 4-13) opens.

Figure 4-13 Update SANsurfer: Select Update Dialog Box

2. Depending on whether or not your network requires proxy settings, follow
the appropriate procedure.

S

Network Does Not Use Proxy Settings

Follow these steps to update SANsurfer from the QLogic Web site when your
network does not use proxy settings to access the Internet.

To update SANsurfer (network does not use proxy settings):

1. On the Select Update dialog box (Figure 4-13), click From the QLogic
website.

2. Clear the Specify Proxy Settings check box.

3. Click Continue.

4. If updates are available, the Update dialog box (Figure 4-15 on page 4-20)
opens. Otherwise, a message box informs you that there are no updates.

Network Requires Proxy Settings

Follow these steps to update SANsurfer from the QLogic Web site when your
network requires proxy settings to access the Internet.

To update SANsurfer (network requires proxy settings):

1. On the Select Update dialog box (Figure 4-13), click From the QLogic Web
site.

2. Select the Specify Proxy Settings check box.

3. Click Continue.

4-18 IS0054602-00 B

A

4 – Installing SANsurfer iSCSI HBA Manager

Web- and CD-based Installation Updates

The Server Proxy Settings dialog box (Figure 4-14) opens.

Figure 4-14 Update SANsurfer: Server Proxy Settings Dialog Box

4. If you want the HTTP proxy setting to be detected automatically, leave the
dialog box as is, and then click OK to continue.

If you want to specify the server proxy settings, complete the following:

a. Select the Use the following HTTP proxy setting check box.

b. In the Address box, type the HTTP address.

c. In the Port box, type the port ID of the proxy server.

d. In the Login and Password boxes, type your login and password for

the proxy servers that require authentication.

e. To continue, click OK. To exit the dialog box and return to the main

SANsurfer iSCSI HBA Manager window, click Cancel.

IS0054602-00 B 4-19

4 – Installing SANsurfer iSCSI HBA Manager
Web- and CD-based Installation Updates

When your computer accesses the Internet, the Update dialog box
(Figure 4-15) appears.

S

Figure 4-15 Update SANsurfer: Update Dialog Box

The available update information includes:

 Current Updates column lists product updates available for the

current tool version.

 Selected Updates column lists product updates that you select for

installation.

5. To use the Update dialog box, select the current product update packages:

 To select a package, select its entry under Current Updates, and then

click Add>>. The update moves to the Selected Updates list.

 To remove a package, select its entry under Selected Updates, and

then click <<Remove. The selected package returns to the Current
Updates list.

For each update package selected, the following information is shown:

 Status describes the current status of the selected update.
 Size indicates the size of the selected update in MBs.
 Description provides a general description of the update.

4-20 IS0054602-00 B

4 – Installing SANsurfer iSCSI HBA Manager

A

6. When you finish selecting the update packages and are ready to start the
download and installation process, click Update. Follow the instructions to
install the selected package. Or, to discontinue the update process and stop
the installation, click Cancel.

Web- and CD-based Installation Updates

Updating SANsurfer by Package Update

You can update SANsurfer iSCSI HBA Manager by browsing to an existing update
package on your hard drive or some form of external media, such as a CD-ROM,
DVD, or portable storage device.

CAUTION!

To avoid locked files during the update process, you must exit SANsurfer.

To update the existing tool:

1. On the SANsurfer iSCSI HBA Manager main menu, click Help, and then
click Web Update.

The Select Update dialog box (Figure 4-16) opens.

Figure 4-16 Update SANsurfer: Select Update Dialog Box

2. To select a file, click Browse, and then click .

IS0054602-00 B 4-21

4 – Installing SANsurfer iSCSI HBA Manager
Web- and CD-based Installation Updates

The Open dialog box (Figure 4-17) appears.

S

Figure 4-17 Update SANsurfer: Open Dialog Box

3. Select the SANsurfer iSCSI HBA Manager patch update file
web_supported_update_iscsi_hba.txt, which can be located on a
local file system or on a CD, DVD, or portable storage device. To proceed,
click Open. Or, to exit the Open dialog box and return to the Select Update
dialog box, click Cancel.

4-22 IS0054602-00 B

A

4 – Installing SANsurfer iSCSI HBA Manager

Web- and CD-based Installation Updates

After you open the patch update file, the Update dialog box (Figure 4-18)
opens, showing available update information.

Figure 4-18 Update SANsurfer: Update Dialog Box

The available update information includes:

 Current Updates column lists product updates available for the

current tool version.

 Selected Updates column lists product updates that you select for

installation.

4. To use the Update dialog box, select the current product update packages:

 To select a package, select its entry under Current Updates, and then

click Add>>. The update moves to the Selected Updates list.

 To remove a package, select its entry under Selected Updates, and

then click <<Remove. The selected package returns to the Current
Updates list.

For each update package selected, the following information is shown:

 Status describes the current status of the selected update.
 Size indicates the size of the selected update in MBs.
 Description provides a general description of the update.

IS0054602-00 B 4-23

4 – Installing SANsurfer iSCSI HBA Manager
Uninstalling SANsurfer

5. When you finish selecting the update packages and are ready to start the
download and installation process, click Update. Follow the instructions to
install the selected package. To discontinue the update process and stop the
installation, click Cancel.

Uninstalling SANsurfer

Perform the following steps to uninstall from this system either the entire
SANsurfer management toolset, including SANsurfer iSCSI HBA Manager, or
specific features. Be sure to exit all SANsurfer tools before you uninstall any
SANsurfer components.

To uninstall SANsurfer iSCSI HBA Manager:

1. To start the SANsurfer uninstaller from a Windows system, choose one of
the following methods:

 On the Windows Start menu, point to Programs, point to QLogic

Management Suite, and then click SANsurfer Uninstaller.

S

 Use the Add/Remove Programs utility:

a. On the Windows Start menu, point to Settings, and then click

Control Panel.

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

Add/Remove Programs dialog box.

4-24 IS0054602-00 B

A

4 – Installing SANsurfer iSCSI HBA Manager

Uninstalling SANsurfer

Figure 4-19 shows an example of the Add/Remove Programs utility for

Windows.

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

c. In the left column, click Change or Remove Programs (default).

d. Under Currently Installed Programs, select SANsurfer x.x.

e. Click Change/Remove.

To start the SANsurfer uninstaller from a Red Hat/SLES or Solaris
SPARC/x86 system, do one of the following, and then press ENTER.

 On a Red Hat/SLES system, if /usr/local/bin is in the path, type:

SANsurferUninstaller.

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

SANsurferUninstaller.

 On a Red Hat/SLES or Solaris SPARC/x86 system, if none of the

above are in the path, change to the directory where SANsurfer is
installed. The default location is:

/opt/QLogic_Corporation/SANsurfer/UninstallData

IS0054602-00 B 4-25

4 – Installing SANsurfer iSCSI HBA Manager
Uninstalling SANsurfer

Type the following:

./SANsurferUninstaller

The Uninstall SANsurfer dialog box (Figure 4-20) opens.

S

Figure 4-20 Uninstall SANsurfer: Uninstall SANsurfer

2. To continue, click Next.

4-26 IS0054602-00 B

A

4 – Installing SANsurfer iSCSI HBA Manager

Uninstalling SANsurfer

The Uninstall Options dialog box (Figure 4-21) opens.

Figure 4-21 Uninstall SANsurfer: Uninstall Options

3. Choose whether to uninstall the entire SANsurfer tool or specific features,
and then click Next:

 Click Complete Uninstall to remove all features and components of

the SANsurfer tool that were installed by InstallAnywhere. (Files and
folders created after the installation are not removed.)

 Click Uninstall Specific Features to uninstall specific features of the

SANsurfer tool that were installed by InstallAnywhere.

IS0054602-00 B 4-27

4 – Installing SANsurfer iSCSI HBA Manager
Uninstalling SANsurfer

The Choose Product Features dialog box (Figure 4-22) opens.

S

Figure 4-22 Uninstall SANsurfer: Choose Product Features

The dialog box differs, depending on whether you are using SANsurfer
iSCSI HBA Manager on a Windows, Linux, or Solaris system.

4. Clear the check boxes for features that you want to uninstall. (Check boxes
that are selected remain installed.) Select from the following components (all
components may not appear and the order of components may vary).

 For a Windows system:

 iSCSI GUI (SANsurfer iSCSI HBA Manager)
 Help
 iSCSI Windows Agent

 For a Linux system:

 iSCSI GUI (SANsurfer iSCSI HBA Manager)
 Help
 iSCSI Linux Agent

 For a Solaris system:

 iSCSI GUI (SANsurfer iSCSI HBA Manager)
 Help
 iSCSI Solaris Agent

4-28 IS0054602-00 B

A

4 – Installing SANsurfer iSCSI HBA Manager

Uninstalling SANsurfer

5. Click Uninstall.

The Uninstall SANsurfer dialog box (Figure 4-23) lists the components that
are being uninstalled.

Figure 4-23 Uninstall SANsurfer: Feature Removal In-progress

A message box asks you to wait the while the uninstaller removes the
components.

IS0054602-00 B 4-29

4 – Installing SANsurfer iSCSI HBA Manager
Uninstalling SANsurfer

The Uninstall Complete dialog box (Figure 4-24) informs you that the
uninstall is finished.

S

Figure 4-24 Uninstall SANsurfer: Uninstall Complete

6. To exit the installation wizard, click Done.

7. If any components were not successfully uninstalled, manually remove
them.

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

 For Windows:

Program Files\QLogic Corporation\SANsurfer

 For Linux and Solaris:

/opt/QLogic_Corporation/SANsurfer

8. Reboot the system.

4-30 IS0054602-00 B

5 Getting Started

This section includes the procedures for starting and exiting the SANsurfer iSCSI
HBA Manager user interface, and customizing the tool options and policies. It
provides information on:

 “Starting SANsurfer iSCSI HBA Manager” on page 5-1
 “SANsurfer iSCSI HBA Manager Main Window” on page 5-3
 “Exiting SANsurfer iSCSI HBA Manager” on page 5-7
 “Getting Help” on page 5-7
 “Setting Up SANsurfer iSCSI HBA Manager” on page 5-11

Starting SANsurfer iSCSI HBA Manager

The SANsurfer iSCSI HBA Manager user interface startup procedures differ
depending upon the operating system. This section tells you how to start
SANsurfer iSCSI HBA Manager on the following systems:

 For Windows 2000, Windows Server 2003, Windows Server 2008, Windows

XP, and Windows Vista, see page 5-1

 For Red Hat/SLES Linux and Solaris SPARC, see page 5-2

Starting SANsurfer iSCSI HBA Manager on Windows

Supported Windows operating system versions include Windows 2000, Windows
Server 2003, Windows Server 2008, Windows XP, and Windows Vista.

To start SANsurfer iSCSI HBA Manager on Windows:

Do one of the following:

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

during installation).

Figure 5-1 SANsurfer Desktop Icon

IS0054602-00 B 5-1

5 – Getting Started
Starting SANsurfer iSCSI HBA Manager

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

Suite, and then click SANsurfer.

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

 Type in the SANsurfer program file name (SANsurfer.EXE),

including all the paths, and then click OK.

 Click Browse, find and select the program in the Browse dialog box,

and then click Open.

After the SANsurfer user interface opens, click the iSCSI HBA tab to select the
SANsurfer iSCSI HBA Manager tool. (For details about the contents of the main
window, see “SANsurfer iSCSI HBA Manager Main Window” on page 5-3.)

For information about connecting to hosts, see Setting Up Connections:

Connecting to Hosts in the help system.

S

Starting SANsurfer iSCSI HBA Manager on Linux or Solaris

Supported Linux operating system versions include Red Hat and SLES;
supported Solaris operating system versions include SPARC/x86.

To start SANsurfer iSCSI HBA Manager on Linux or Solaris:

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

2. Open a command terminal.

3. On a Red Hat/SLES system, if /usr/local/bin is in the path, type
SANsurfer, and then press ENTER:

On a Solaris SPARC system, if /usr/bin is in the path, type SANsurfer,
and then press ENTER.

4. If neither of the preceding are in the path for a Red Hat/SLES Linux or
Solaris SPARC/x86 system:

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

location is: /opt/QLogic_Corporation/SANsurfer.

b. Type ./SANsurfer, and then press ENTER.

5. After the SANsurfer user interface opens, click the iSCSI HBA tab to select
the SANsurfer iSCSI HBA Manager tool. (For details about the contents of
the main window, see “SANsurfer iSCSI HBA Manager Main Window” on

page 5-3.)

For information about connecting to hosts, see Setting Up Connections:

Connecting to Hosts in the help system.

5-2 IS0054602-00 B

5 – Getting Started

A

SANsurfer iSCSI HBA Manager Main Window

SANsurfer iSCSI HBA Manager Main Window

The HBA Manager supports the following tools:

 The iSCSI HBA tab opens SANsurfer iSCSI HBA Manager.
 The FC HBA tab opens SANsurfer FC (Fibre Channel) HBA Manager.
 The Switch tab opens SANsurfer Switch Manager.

A tab appears only when the specific SANsurfer tool is installed on the system.
The title bar identifies the currently-active tool.

To view the SANsurfer iSCSI HBA Manager main window, go to the left pane
(system tree pane) of the SANsurfer window, and then click the iSCSI HBA tab.
The title bar shows SANsurfer iSCSI HBA Manager.

After you connect to hosts (see the Connecting to Hosts topics in the help
system), the SANsurfer iSCSI HBA Manager main window (Figure 5-2) opens.

IS0054602-00 B 5-3

5 – Getting Started

Title BarTool Tab Menu Bar Toolbar

HBA Tree

Status Bar

System Tree

Content Pane

Tabbed Pages

Pane

SANsurfer iSCSI HBA Manager Main Window

S

Figure 5-2 SANsurfer iSCSI HBA Manager Main Window

The window contains the following components:

 The title bar identifies the currently active tool selected by the tool tab.

 Tool tabs activate a specific tool (iSCSI HBA Manager, FC HBA Manager, or

Switch Manager).

 The menu bar contains the commands for using SANsurfer iSCSI HBA

Manager.

 The toolbar contains buttons for commonly-used functions for SANsurfer

iSCSI HBA Manager.

5-4 IS0054602-00 B

A

HBA Tree

5 – Getting Started

SANsurfer iSCSI HBA Manager Main Window

 The HBA tree in the system tree pane shows the presence and status of

hosts, HBAs, and devices. For details, see “HBA Tree” on page 5-5.

 Tabbed pages in the content pane contain settings for similar kinds of

operations.

 The status bar shows informative messages about system operations. For

example, if you change the HBA port configuration and then click Save
HBA, the status bar flashes “Current Operation: Saving Configuration” until
the save is complete.

The HBA tree, in the left pane (system tree pane) of the SANsurfer window, shows
the hosts with their connected HBAs, HBA ports, devices, and LUNs.

 When you select an item in the HBA tree, the status bar shows the same

information.

 If an HBA is connected to a target, click the HBA to list all the devices

connected to it. Devices are listed by their target iSCSI name or target iSCSI
alias name.

Additionally, each target may have LUNs connected to it. If a target is connected
to a LUN, click the target to list all the connected LUNs.

The HBA tree contains the following visual indicators:

 Host Icons and Text
 HBA Icons and Text
 HBA Port Icons and Text
 Device Icons and Text
 LUN Icons and Text

Host Icons and Text

The HBA tree shows the host name or IP address.

Example:

The host icon is:

connection between the user interface and the agent is active for this host.

HBA Icons and Text

The HBA tree shows HBA instance number: HBA Model number: HBA Status.

hostname 10.3.13.90

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

IS0054602-00 B 5-5

5 – Getting Started
SANsurfer iSCSI HBA Manager Main Window

The HBA icons are:

Good

Warning

Unknown

Bad

HBA Port Icons and Text

The HBA tree shows:

 Either the HBA port iSCSI name or HBA port iSCSI alias name (see

“Specifying Whether iSCSI Names or iSCSI Alias Names Appear in the HBA
Tree” on page 5-14).

 HBA port state shows either Link Down, Unknown, Warning, or Good.

S

For information about the HBA port state referenced in the dialog boxes and its
correspondence with the HBA icons, see the help topic, Monitoring the HBA Port

State.

Examples:

Port 0: iqn.2000-04.com.qlogic:qla4010.fs10352a00378 AdapterPort
Svr_1_HBA_5

The HBA Port icons are:

Device Icons and Text

The HBA tree shows information about devices such as:

Good

Virtual

Warning

Link Down

Unknown

 Target iSCSI name or target iSCSI alias name

 Target state indicating the session connection status of the devices:

bad/failed, unknown/no active, good.

5-6 IS0054602-00 B

A

For information about the target state referenced in the dialog boxes and its
correspondence with the device icons, see the help topic, Monitoring the Target

State.

Examples:

The device icons are:

LUN Icons and Text

The HBA tree shows the LUN number (LUN n).

5 – Getting Started

Exiting SANsurfer iSCSI HBA Manager

Device (ipn.qlogic.3.0)

Device (target_3_0)

Device good session connection

Device unknown/no active session connection

Device bad/failed session connection

Example:

LUN (LUN 1)

The LUN icon is:

LUN

Exiting SANsurfer iSCSI HBA Manager

To exit SANsurfer iSCSI HBA Manager, do one of the following:

 On the SANsurfer iSCSI HBA Manager main window, open the File menu

and click Exit.

 Click the Close button in the upper right corner of the window.

Getting Help

This section provides information about:

 “Viewing the Help System” on page 5-8
 “Specifying the Help Browser” on page 5-9
 “Viewing SANsurfer iSCSI HBA Manager Information” on page 5-10

IS0054602-00 B 5-7

5 – Getting Started
Getting Help

Viewing the Help System

The SANsurfer iSCSI HBA Manager help system provides quick access to
information about performing tasks and completing dialog boxes. To view the help
system from the SANsurfer iSCSI HBA Manager main window, open the Help
menu and click Browse Contents, or press the F1 key. Figure 5-3 shows an
example of the initial help window in Internet Explorer.

S

Figure 5-3 Help Window Example

If the help window does not open, you may need to set the browser location (see

“Specifying the Help Browser” on page 5-9). Note that this help system appears

best using the Internet Explorer browser.

The help system’s left pane contains the following tabs:

 Click the Contents button to show a structured presentation of Help topics.

In Contents view, the following icons are associated with topics:

 A book icon indicates a major grouping containing subordinate

topics. Click a book icon to “open” the book and see individual
topics that belong to that group.

 A topic icon indicates a Help topic.

5-8 IS0054602-00 B

A

 Click the Index button to show an alphabetic listing of keywords associated

with the help topics. Scroll through the listing to find keywords, and then
choose from one or more topics associated with that keyword.

 Click the Search button to quickly find a topic containing one or more words.

To begin your search, click the first letter of the word you want to find.

What’s in the Help System

The SANsurfer iSCSI HBA Manager help system contains the following
information:

 Setting Up Connections provides procedures for connecting to hosts,

configuring iSCSI HBAs, and configuring connected devices.

 Monitoring the Connections explains how SANsurfer iSCSI HBA Manager

monitors connected HBAs and their targets and informs you of their state.

 Displaying Host, HBA, HBA Port, Device, and LUN Information covers

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

 Updating the HBA covers updating the HBA firmware, driver, ROM, and

BIOS.

5 – Getting Started

Getting Help

Specifying the Help Browser

Follow these steps to specify the Web browser (Internet Explorer or Firefox, for
example) that SANsurfer iSCSI HBA Manager launches when you open the help
system (see “Viewing the Help System” on page 5-8):

To specify a browser:

1. On the SANsurfer iSCSI HBA Manager main window, open the Help menu,
and then click Set Browser Location. The Browser Location dialog box
opens (Figure 5-4).

Figure 5-4 Browser Location Dialog Box

2. In the Browser Location box, type the location of the browser program file.
Be sure to specify the path and file name.

IS0054602-00 B 5-9

5 – Getting Started
Getting Help

If you do not know the location, click Browse to open a file selection dialog
box and select the browser program file. The Browser Location dialog box
shows the new browser path and file name.

3. When you finish choosing your browser, do one of the following:

 To save the browser location to the SANsurfer iSCSI HBA Manager

configuration file, click OK.

 To close the Browser Location dialog box without making changes,

click Cancel.

Viewing SANsurfer iSCSI HBA Manager Information

The About box shows the product version number and QLogic copyright
information.

To view information about SANsurfer iSCSI HBA Manager:

1. On the SANsurfer iSCSI HBA Manager main window Help menu, click
About.

S

The About SANsurfer iSCSI HBA Manager window opens (Figure 5-5).

Figure 5-5 About SANsurfer iSCSI HBA Manager Window

5-10 IS0054602-00 B

5 – Getting Started

A

This window provides the following information:

 High Availability Edition version number.

 Copyright information.

2. To close the About window and return to the SANsurfer iSCSI HBA Manager
main window, click OK.

Setting Up SANsurfer iSCSI HBA Manager

Setting Up SANsurfer iSCSI HBA Manager

Some of the basic set up you may want to perform for SANsurfer iSCSI HBA
Manager includes the following:

 “Setting SANsurfer iSCSI HBA Manager Security” on page 5-11

 “Specifying Whether iSCSI Names or iSCSI Alias Names Appear in the HBA

Tree” on page 5-14

 “Setting the Options for Retrieving Host Status Alarms and Refreshing the

Configuration” on page 5-15 includes information about:

 “Specifying the Polling Intervals to Retrieve Host Status Alarms” on

page 5-16

 “Specifying Whether the Configuration Refreshes When Host and

Target Status Alarms Occur” on page 5-19

 “Specifying Whether the Host Refresh Prompt Appears” on page 5-20

 “Refreshing the Configuration Immediately” on page 5-21

Setting SANsurfer iSCSI HBA Manager Security

SANsurfer iSCSI HBA Manager security ensures that HBA configuration changes
require password authorization. SANsurfer iSCSI HBA Manager prompts for the
password any time you click Save to change the following HBA configuration:

 HBA driver
 HBA firmware
 HBA BIOS
 HBA ROM
 HBA port configuration
 Target configuration
 Target authentication (CHAP)
 Password (when you want it changed)

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

IS0054602-00 B 5-11

5 – Getting Started
Setting Up SANsurfer iSCSI HBA Manager

Windows 2000/Windows Server 2003. The login name (username) must

be attached to an account that the agent is running on and that must be in the
administrator group.

Red Hat/SLES Linux and Solaris SPARC. The login name (user name)

must be attached to an account that the agent is running on and that must be in
the adm or root group.

NOTES:

 The default SANsurfer iSCSI HBA Manager access password is config.

To ensure that security is not compromised, change this password after
installation.

 The HBA ROM password differs and cannot be modified using these

procedures.

To set the access password for a host:

S

1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select the
host.

2. Click the Security tab.

5-12 IS0054602-00 B

A

5 – Getting Started

Setting Up SANsurfer iSCSI HBA Manager

The Security page (Figure 5-6) opens, and the host name appears at the top
of the page.

Figure 5-6 Security Page (Host)

3. Under Host Access are the system login and password that you use to
access the machine. To verify that you have administrator or root privileges
for the selected host:

a. In the Login box, type your login name.

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

4. Under Application Access, you can change your password. To modify the
SANsurfer iSCSI HBA Manager access password:

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

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

c. In the Verify New Password box, confirm the new password by typing

it again.

5. To update the tool access password, click Apply. To clear the typed entries
in the Security page text boxes, click Clear Fields.

IS0054602-00 B 5-13

5 – Getting Started

HBA Tree with
HBA Port iSCSI
Alias Names and
Target iSCSI
Alias Names

HBA Tree with
HBA iSCSI Names
and Target
iSCSI Names

Setting Up SANsurfer iSCSI HBA Manager

Specifying Whether iSCSI Names or iSCSI Alias Names
Appear in the HBA Tree

You can specify whether the iSCSI name or the iSCSI alias name appears in the
HBA tree. After you specify whether the iSCSI name or the iSCSI alias name is
shown, your selection becomes the default. You can set the default from the HBA
tree or from the Options dialog box.

In Figure 5-7, the sample HBA tree on the left shows HBA iSCSI names and target
iSCSI names. The sample HBA tree on the right shows HBA port iSCSI alias
names and target iSCSI alias names.

S

5-14 IS0054602-00 B

Figure 5-7 HBA Tree Naming Examples

To set the iSCSI name default from the HBA tree:

1. To set the default iSCSI name or iSCSI alias name to appear in the HBA
tree, right-click in the HBA tree to open a shortcut menu.

2. Depending on what is currently set, the last shortcut menu option toggles
between Tree Naming: iSCSI Name and Tree Naming: iSCSI Alias:

 If the HBA and target iSCSI names currently appear in the HBA tree,

the menu shows Tree Naming: iSCSI Alias. Click Tree Naming:
iSCSI Alias to show the iSCSI alias names.

 If the HBA and target iSCSI alias names appear in the HBA tree, the

menu shows Tree Naming: iSCSI Name. Click Tree Naming: iSCSI

Name to show the iSCSI names.

To set the iSCSI name default from the Preferences dialog box:

1. On the Settings menu, click Application Options.

A

5 – Getting Started

Setting Up SANsurfer iSCSI HBA Manager

The Application Options dialog box (Figure 5-8) opens.

Figure 5-8 Application Options: Tree View Naming Preference

2. Under Tree Viewing Naming Preference, select one of the following Tree
Naming options:

 Click Alias if you want the HBA port and target iSCSI alias names to

show in the tree.

 Click Name if you want the HBA port and target iSCSI names to show

in the tree.

3. To save your changes, click OK. To close this dialog box without making any
changes, click Cancel.

For information about configuring HBA port iSCSI names and HBA port iSCSI
alias names, see the help topic, Configuring the HBA Port iSCSI Name and Port

Alias Name.

For information about target iSCSI names and target iSCSI alias names, see the
help topic, Configuring Targets.

Setting the Options for Retrieving Host Status Alarms and
Refreshing the Configuration

Polling intervals determine how frequently the SANsurfer iSCSI HBA Manager
monitors the connected HBAs (and their targets) and updates the iSCSI HBA
Manager interface configuration based on their state. The iSCSI HBA Manager
allows you to:

IS0054602-00 B 5-15

5 – Getting Started
Setting Up SANsurfer iSCSI HBA Manager

 Set the HBA polling and host polling intervals to retrieve host status alarms

(see “Specifying the Polling Intervals to Retrieve Host Status Alarms” on

page 5-16).

 Specify whether host status alarms and target status alarms refresh the

configuration (see “Specifying Whether the Configuration Refreshes When

Host and Target Status Alarms Occur” on page 5-19).

 Specify whether a message appears when a host configuration change is

detected (see “Specifying Whether the Host Refresh Prompt Appears” on

page 5-20).

To refresh the configuration immediately:

Choose one of the following options:

 On the toolbar, click Refresh.
 On the View menu, click Refresh.
 Press F5.

For more information, see “Refreshing the Configuration Immediately” on

page 5-21.

S

Specifying the Polling Intervals to Retrieve Host Status Alarms

Polling intervals determine how frequently SANsurfer iSCSI HBA Manager
monitors the connected HBAs (and their targets), and updates the iSCSI HBA
Manager user interface configuration based on their state. There are two types of
polling: HBA Polling. and Host Polling.

HBA Polling. HBA polling occurs at an interval that you specify. During HBA

polling, the agent checks for changes to the HBA settings and targets. When the
agent detects a change, a host status alarm is sent to all SANsurfer iSCSI HBA
Manager interfaces currently connected with the agent.

If you set the preferences to update behavior (see “Specifying Whether the

Configuration Refreshes When Host and Target Status Alarms Occur” on
page 5-19, then the SANsurfer iSCSI HBA Manager user interface retrieves the

latest information from the agent.

Because alarms may not be detected by the interfaces, Host Polling. is also
available to ensure that the user interfaces receive the configuration changes.

Host Polling. Host polling permits host status alarms, not received by the

SANsurfer iSCSI HBA Manager user interface, to be detected. Host polling occurs
at an interval that you specify and can be disabled.

During host polling, the interface asks the agent if anything has changed since the
last time it received an update. If not, the interface waits until the next poll or
alarm.

5-16 IS0054602-00 B

A

If something has changed and the SANsurfer iSCSI HBA Manager update
behavior configuration is set to update when the poll or host status alarms occur
(see “Specifying Whether the Configuration Refreshes When Host and Target

Status Alarms Occur” on page 5-19), theSANsurfer iSCSI HBA Manager user

interface then retrieves the latest information from the agent.

Specifying the HBA Polling Interval

The HBA polling interval is the length of elapsed time between polling events to
HBAs on a host.

To set the HBA polling interval:

1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select the
HBA port (or HBA, device, or LUN connected to the host).

2. Do one of the following:

 On the Host menu, click HBA Poll Interval.

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

to the host) in the HBA tree, and then on the shortcut menu, click HBA
Poll Interval.

5 – Getting Started

Setting Up SANsurfer iSCSI HBA Manager

The Polling Setting dialog box (Figure 5-9) opens, and shows the name of
the host in the title bar.

Figure 5-9 Polling Setting Dialog Box (HBA)

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

4. To set the polling interval, click OK. To close the Polling Setting dialog box
without changing the polling interval, click Cancel.

IS0054602-00 B 5-17

5 – Getting Started
Setting Up SANsurfer iSCSI HBA Manager

NOTES:

 You cannot disable HBA polling.

 The faster the polling rate, the more quickly the SANsurfer iSCSI HBA

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

Specifying the Host Polling Interval

The host polling interval is the length of elapsed time between polling events to a
connected host agent. Host polling detects host status alarms that are received by
the SANsurfer iSCSI HBA Manager user interface.

To set the host polling interval:

1. In the SANsurfer iSCSI HBA Manager main window HBA tree, select the
host (or HBA, device, or LUN connected to the host).

S

2. Do one of the following:

 On the Host menu, click Host Poll Interval.

 Right-click the selected host (or HBA, device, or LUN connected to the

host) in the HBA tree. On the shortcut menu, click Host Poll Interval.

The Host Polling Setting dialog box (Figure 5-10) opens, and shows the
name of the host in the title bar.

Figure 5-10 Host Polling Setting Dialog Box

3. In the Interval box, type the host polling interval. The range is 0 seconds to
1800000 seconds (500 hours). The default is 120 seconds. To disable host
polling, type 0.

4. To set the host polling interval, click OK. To close the Host Polling Setting
dialog box without changing the interval setting, click Cancel.

5-18 IS0054602-00 B

5 – Getting Started

A

Setting Up SANsurfer iSCSI HBA Manager

Specifying Whether the Configuration Refreshes When Host and Target Status
Alarms Occur

You can specify whether or not the SANsurfer iSCSI HBA Manager user interface
configuration refreshes each time your system receives a host status alarm or
target status alarm.

To specify whether the configuration refreshes:

1. On the Settings menu, click Application Options.

The Application Options dialog box (Figure 5-11) opens.

Figure 5-11 Application Options: Update Behavior

2. Under Update Behavior from the Host Status Alarms, select the following
options:

 If you want to refresh the configuration when the host receives a host

status alarm or a target status alarm, select both the Enable All

Updates from Host Alarms check box and the Enable Updates from
Target Status Alarms check box.

 If you want to refresh the configuration when the host receives a host

status alarm but not a target status alarm, select only the Enable All
Updates from Host Alarms check box.

 If you do not want the configuration to refresh when the host receives a

host status alarm nor a target status alarm, clear the Enable All
Updates from Host Alarms check box.

IS0054602-00 B 5-19

5 – Getting Started
Setting Up SANsurfer iSCSI HBA Manager

When you clear the Enable All Updates from Host Alarms check
box, the Enable Updates from Target Status Alarms check box is
unavailable.

3. To save your changes to the update behavior, click OK. To close the
Application Options dialog box without saving any changes, click Cancel.

Specifying Whether the Host Refresh Prompt Appears

You can determine whether the iSCSI configuration change message appears
when the host configuration has changed.

To specify whether host refresh prompt appears:

1. On the Settings menu, click Application Options.

The Application Options dialog box (Figure 5-12) opens.

S

Figure 5-12 Application Options: Prompting Behavior

2. Enable or disable the prompt for host refresh:

 To cause the iSCSI configuration change message to appear when a

host configuration has changed:

a. Under Prompting Behavior, select the Enable Prompt to

5-20 IS0054602-00 B

Accept Host Refresh check box.

A

5 – Getting Started

Setting Up SANsurfer iSCSI HBA Manager

When the host configuration changes, the following confirmation
message (Figure 5-13) appears.

Figure 5-13 iSCSI Configuration Change Confirmation

b. To refresh the configuration, click Yes. To continue to show the

current configuration, click No.

 To prevent the iSCSI configuration change message from appearing

when a host configuration has changed, clear the Enable Prompt to
Accept Host Refresh check box. When host status alarms occur, the
configuration refreshes if it is set to update (see “Specifying Whether

the Configuration Refreshes When Host and Target Status Alarms
Occur” on page 5-19).

3. To save your options changes, click OK. To close the Application Options
dialog box without making any changes, click Cancel.

Refreshing the Configuration Immediately

The configuration shown in the SANsurfer iSCSI HBA Manager user interface
refreshes based on the polling intervals (see “Specifying the Polling Intervals to

Retrieve Host Status Alarms” on page 5-16) and whether the configuration is set

to update when host status alarms occur (see“Specifying Whether the

Configuration Refreshes When Host and Target Status Alarms Occur” on
page 5-19).

To refresh the configuration immediately:

Do one of the following:

 On the toolbar, click Refresh.

 On the SANsurfer iSCSI HBA Manager main window View menu, click

Refresh.

 Press F5.

NOTE:

Selecting Refresh forces the agent to poll the HBA immediately and update
the SANsurfer iSCSI HBA Manager configuration with the latest HBA
information.

IS0054602-00 B 5-21

5 – Getting Started
Setting Up SANsurfer iSCSI HBA Manager

Notes

S

5-22 IS0054602-00 B

6 Performing Diagnostics

The following sections describe the diagnostic tools available for managing iSCSI
HBAs:

 “General Information for the HBA Port” on page 6-2 explains the information

that appears on top of the Diagnostics page for the HBA port.

 “Pinging Targets” on page 6-3 provides the steps to verify that there is

connectivity between the HBA port and the target.

 “Viewing Logs” on page 6-6 shows you how to view the ARP log, connection

error log, destination cache log, neighbor cache log, and router list log.

 “Setting Diagnostic Test Parameters” on page 6-16 provides information on

setting up and running the loopback and read/write buffer tests.

 “Tracing User and Agent Activity” on page 6-21 provides the steps for

completing the Diagnostic Options dialog box.

NOTE:

Some IPv6 features, such as the IPv6 Router List log, Destination Cache
log, and so on, are not available and appear dimmed if:

 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.)

 The card does not support IPv6; for example, QLA405x cards do not

support IPv6, but QLE406x cards do support IPv6.

 The IPv6 addresses are not enabled on the Port Options page, Network

sub-page.

 You are using an older driver. For example, some QLogic iSCSI drivers

shipped with the operating system are older drivers that do not have
support for QLA406x cards.

If you are using a QLE406x iSCSI HBA and download the standard drivers
and latest firmware from the QLogic Web site, you can access the IPv6
features.

IS0054602-00 B 6-1

6 – Performing Diagnostics

Green background

Yellow background

Blue background

Red background

General Information for the HBA Port

General Information for the HBA Port

The top portion of the Diagnostics page for an HBA port provides general
information about the port, as shown in Figure 6-1.

Figure 6-1 Diagnostics Page: HBA Port Info

HBA port-identifying information on the top of the Diagnostics page includes the
following:

S

HBA Model HBA instance number and HBA model.

State The HBA port state. For details about the HBA port state

and its correspondence with the HBA icons, see the help
topic, Monitoring the HBA Port State.

 : Good, indicating that the HBA

port is operational and ready.

 : Warning, indicating that the HBA

port is not in an operational state.

 : Unknown, indicating that the HBA

port is processing an operation. The state remains
unknown until the operation is complete. After the
operation is complete, the state changes to green,
yellow, or red based on the results of the operation.

 : Bad, indicating that the HBA port is

not available.

HBA iSCSI Name HBA port iSCSI name. The QLogic manufacturing default

name or a name that you assign.

iSCSI Port Alias
Name

HBA port iSCSI alias name. Symbolic name you assign to
the HBA port for identification purposes.

IPv4 Address IP address of the HBA port.

6-2 IS0054602-00 B

A

Pinging Targets

Pinging a target is an attempt by the HBA port to contact the targeted device. If the
ping is successful, it verifies that there is connectivity between the HBA port and
the target.

Ping Page

To access the Ping page:

1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select the
HBA port.

2. Click the Diagnostics tab to bring the Diagnostics page to the front.

The top portion of the Diagnostics page contains the HBA port-identifying
information; for details, see “General Information for the HBA Port” on

page 6-2.

3. On the Diagnostics page, click the Ping tab.

6 – Performing Diagnostics

Pinging Targets

The Ping page opens within the Diagnostics page (Figure 6-2).

Figure 6-2 Ping Page (Diagnostics)

IS0054602-00 B 6-3

6 – Performing Diagnostics
Pinging Targets

The Ping page shows the following ping diagnostic information:

IPv4 Address Select to enter IPv4 address of the target.

IPv6 Address Select to enter IPv6 address of the target.

S

IPv6 source
address

Number of
packet(s) (1-10000)

Packet size Minimum packet size is 32. Maximum packet size varies

Port address from which the ping originates. This address
could be the Auto Address, meaning the firmware
determined the address of the HBA. Alternatively, it can
be a Link Local Address, Source Address 1 (a routable
address), or Source Address 2 (a routable address) that
you determine.

Number of packets to test.

by path MTU size. If the path MTU size is 1500, then the
maximum size that succeeds is 1452 for IPv6 and 1472
for IPv4. If the path MTU is set for Jumbo frames and the
MTU is 9000, then the maximum size that succeeds is
8952 for IPv6 and 8972 for IPv4.

Pinging IPv4 and IPv6 Targets

SANsurfer iSCSI HBA Manager allows you to ping targets on IPv4 and IPv6.

To ping an IPv4 target:

1. On the Ping page (Figure 6-2 on page 6-3), click IPv4 Address, and then
type the IP address in the IP boxes.

2. In the Number of packet(s) box, type the number of packets you want to
send. Valid values range from 1–10000. The default is 1.

3. In the Packet size box, type the size of the packets you want to send. Valid
values range from 32–64000. The default is 32.

4. Click Start Testing.

The status bar shows the HBA name and Current Operation: Ping diag.

5. If you want to stop testing before it is complete, click Stop Testing.

6-4 IS0054602-00 B

A

6 – Performing Diagnostics

Pinging Targets

When the test is complete, the Ping Status dialog box (Figure 6-3) informs
you of the results.

Figure 6-3 Ping Status Dialog Box

6. To close the dialog box, click OK.

To ping an IPv6 address:

1. On the Ping page (Figure 6-2 on page 6-3), click IPv6 Address, and then
type the IP address in the IP box.

2. In the IPv6 source address list, select the IP address source. Or, to let
SANsurfer iSCSI HBA Manager determine the source address, select Auto
Address.

3. In the Number of packets box, type the number of packets you want to
send. Valid values range from 1–10000. The default is 1.

4. In the Packet size box, type the size of the packets you want to send. Valid
values range from 32–64000. The default is 32.

5. Click Start Testing.

The status bar shows the HBA name and Current Operation: Ping diag.

6. If you want to stop testing before it is complete, click Stop Testing.

When the test is complete, the Ping Status dialog box (Figure 6-3 on page

6-5) informs you of the results.

7. To close the dialog box, click OK.

IS0054602-00 B 6-5

6 – Performing Diagnostics
Viewing Logs

Viewing Logs

SANsurfer iSCSI HBA Manager provides several types of information logs. The
following sections tell you how to access each log:

 “Viewing the ARP Log” on page 6-6
 “Viewing the Connection Error Log” on page 6-8
 “Viewing the IPv6 Destination Cache Log” on page 6-10
 “Viewing the IPv6 Neighbor Cache Log” on page 6-11
 “Viewing the IPv6 Router List Log” on page 6-13
 “Viewing the IPv6 Local Prefix List Log” on page 6-14

Viewing the ARP Log

The address resolution protocol (ARP) cache keeps a record of host port
connections with other hardware (such as targets) on the network. The IP
address/MAC address pairs are dynamic entries that are removed after 10
minutes.

To view the ARP log:

S

1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select the
HBA port.

2. Click the Diagnostics tab to bring the Diagnostics page to the front.

The top portion of the Diagnostics page contains the HBA port-identifying
information; for details, see “General Information for the HBA Port” on

page 6-2.

3. On the Diagnostics page, click the Logs tab.

6-6 IS0054602-00 B

A

6 – Performing Diagnostics

Viewing Logs

The Logs page opens within the Diagnostics page (Figure 6-4).

Figure 6-4 Logs Page (Diagnostics)

4. On the Logs page, click Display ARP Table.

5. The ARP Log opens (Figure 6-5).

Figure 6-5 ARP Log

For the HBA port that you selected, the ARP log shows the HBA port
connections with remote network hardware:

IS0054602-00 B 6-7

6 – Performing Diagnostics
Viewing Logs

 IP Address is the IP address of the hardware on the remote network.

 MAC Address is the MAC address of the hardware on the remote

network.

6. If you want to refresh the log information immediately, click Refresh.

7. To exit the log, click Close.

Viewing the Connection Error Log

The connection error log for IPv4 and IPv6 lists the 100 latest connection errors
for this HBA port.

To view the connection error log:

1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select the
HBA port.

2. Click the Diagnostics tab to bring the Diagnostics page to the front.

The top portion of the Diagnostics page contains the HBA port-identifying
information; for details, see “General Information for the HBA Port” on

page 6-2.

S

3. On the Diagnostics page, click the Logs tab.

The Logs page opens within the Diagnostics page (see Figure 6-4 on page

6-7).

4. On the Logs page, click Display Connection Errors.

The Connection Error Log opens (Figure 6-6).

Figure 6-6 Connection Error Log

6-8 IS0054602-00 B

A

6 – Performing Diagnostics

Viewing Logs

NOTE:

If text in any column is truncated, move the cursor over it to reveal the
entire text in a tool tip next to the cursor.

For the HBA port that you selected, the connection error log shows the
following information:

Delta Time The number of seconds between the current

timestamp and the previous timestamp.

Timestamp

Target ID The device ID as defined by the QLogic tool.

Original State The state of the HBA and target connection.

Entry Type The error or information category for the original

Error Type The error (sense) message and its hex value for the

Detail Code The detailed error (sense) information with its hex

Number of
Consecutive
Errors

a

If you have ACB support, the date-time stamp is in 12 hour format. If you do not have ACB
support, the date-time format is in seconds since the last HBA reset. To activate ACB support,
download the standard drivers and latest firmware from the QLogic Web site.

For more detailed information, see the ISP4xxx Firmware Interface

Specification (see “Related Documents” on page 1-3).

a

The time that elapsed since the last HBA reset.

state.

entry type.

value for the error type.

Number of times this detail error code has occurred
consecutively.

5. If you want to refresh the log information immediately, click Refresh.

6. To export the contents of the connection error log to a file:

a. Click Export to File.

b. In the Export Connection Error Log To File dialog box, enter a path and

file name for the file.

c. Click Export Log To File.

7. To exit the connection error log, click Close.

IS0054602-00 B 6-9

6 – Performing Diagnostics
Viewing Logs

Viewing the IPv6 Destination Cache Log

The IPv6 destination cache contains the IP address, next hop IP address, and
path MTU information for both local and remote destinations. For multicast and
on-link unicast destinations, the next hop IP address always matches the
destination IP address.

For unicast destinations that are off-link, the next hop IP address is the IP address
of the router.

To view the destination cache log:

1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select the
HBA port.

2. Click the Diagnostics tab to bring the Diagnostics page to the front.

The top portion of the Diagnostics page contains the HBA port-identifying
information; for details, see “General Information for the HBA Port” on

page 6-2.

3. On the Diagnostics page, click the Logs tab.

S

The Logs page opens within the Diagnostics page (see Figure 6-4 on page

6-7).

4. On the Logs page, click Display Destination Cache.

The IPv6 Destination Cache log opens (Figure 6-7).

Figure 6-7 IPv6 Destination Cache Log

NOTE:

If text in any column is truncated, move the cursor over it to reveal the
entire text in a tool tip next to the cursor.

6-10 IS0054602-00 B

A

6 – Performing Diagnostics

Viewing Logs

For the HBA port that you selected, the destination cache log shows the
following information:

Last Update Time The date-time stamp of the last destination cache

entry. The date-time stamp is in 12 hour format.

Destination IP The destination IP address of an IPv6 iSCSI target.

Next Hop IP The IPv6 IP address of the next hop from the iSCSI

HBA port. If the iSCSI target is on the local subnet,
then this address is the same as the destination IP
address. If the iSCSI target is not on the local subnet,
then this address is the first router/gateway address in
the path to the iSCSI target.

Path MTU The path MTU between the HBA port and the iSCSI

target. The value is generally zero, except when an
oversized ICMPv6 packet message is received.

Flags Local valid entry=0x5; remote valid entry=0x1.

5. If you want to refresh the log information immediately, click Refresh.

6. To exit the log, click Close.

Viewing the IPv6 Neighbor Cache Log

The IPv6 Neighbor Cache contains the IP address, MAC address, and other
information about devices on the local link. This cache is similar to the IPv4 ARP
cache (see “Viewing the ARP Log” on page 6-6). It provides mapping between
unicast IP addresses and their associated MAC addresses.

To view the neighbor cache log:

1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select the
HBA port.

2. Click the Diagnostics tab to bring the Diagnostics page to the front.

The top portion of the Diagnostics page contains the HBA port-identifying
information; for details, see “General Information for the HBA Port” on

page 6-2.

3. On the Diagnostics page, click the Logs tab.

The Logs page opens within the Diagnostics page (see Figure 6-4 on page

6-7).

4. On the Logs page, click Display Neighbor Cache.

IS0054602-00 B 6-11

6 – Performing Diagnostics
Viewing Logs

The IPv6 Neighbor Cache log opens (Figure 6-7).

NOTE:

S

Figure 6-8 Neighbor Cache Log

If text in any column is truncated, move the cursor over it to reveal the
entire text in a tool tip next to the cursor.

For the HBA port that you selected, the neighbor cache log shows the
following information:

Last Update Time The date-time stamp of the last neighbor cache entry.

The date-time stamp is in 12 hour format.

Neighbor IP The neighbor IP address of an IPv6 device (iSCSI

target, router, and so on).

Neighbor MAC
Address

State The current state of this cache entry. Possible values

The MAC address associated with this entry.

include the following:

 0x0: Invalid entry.
 0x1: Incomplete entry, does not have MAC address.
 0x2: Stale, the reachable time has expired.
 0x3: Delay, the HBA port is currently waiting (5

seconds) before sending a neighbor solicitation
message.

 0x4: Probe, reachability confirmation is in progress.
 0x5: Reachable, the entry is currently reachable.

Flags Router entry=0x1; non-router entry=0x0.

6-12 IS0054602-00 B

A

5. If you want to refresh the log information immediately, click Refresh.

6. To exit the log, click Close.

Viewing the IPv6 Router List Log

The IPv6 Router List log includes both the active default router (shown in the IPv6
section of the Port Network page) and a short list of other routers that advertised
themselves as being capable of acting as a default router. The active default
router always appears first in the list.

To view the router list log:

1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select the
HBA port.

2. Click the Diagnostics tab to bring the Diagnostics page to the front.

The top portion of the Diagnostics page contains the HBA port-identifying
information; for details, see “General Information for the HBA Port” on

page 6-2.

6 – Performing Diagnostics

Viewing Logs

3. On the Diagnostics page, click the Logs tab.

The Logs page opens within the Diagnostics page (see Figure 6-4 on page

6-7).

4. On the Logs page, click Display Router List.

The IPv6 Router List dialog box opens (Figure 6-9).

Figure 6-9 IPv6 Router List Log

For the HBA port that you selected, the router list log shows the following
information:

IS0054602-00 B 6-13

6 – Performing Diagnostics
Viewing Logs

Last Update Time The date-time stamp of the last router list entry. The

Router IP Address The IP address of the router.

Router Lifetime The length of time, in minutes and seconds, that the

Flags Valid entry=0x1; non-valid entry=0x0.

For more detailed information, refer to the ISP4xxx Firmware Interface

Specification (see “Related Documents” on page 1-3).

NOTE:

S

date-time stamp is in 12 hour format.

router can be used as the default router for this entry.

If text in any column is truncated, move the cursor over it to reveal the
entire text in a tool tip next to the cursor.

5. If you want to refresh the log information immediately, click Refresh.

6. To exit the log, click Close.

Viewing the IPv6 Local Prefix List Log

The IPv6 Local Prefix List contains prefix information obtained from router
advertisements. Destination IP addresses containing these prefixes can be
reached directly, without going through and intermediate router.

To view the prefix list log:

1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select the
HBA port.

2. Click the Diagnostics tab to bring the Diagnostics page to the front.

The top portion of the Diagnostics page contains the HBA port-identifying
information; for details, see “General Information for the HBA Port” on

page 6-2.

3. On the Diagnostics page, click the Logs tab.

The Logs page opens within the Diagnostics page (see Figure 6-4 on page

6-7).

4. On the Logs page, click Display Prefix List.

6-14 IS0054602-00 B

A

6 – Performing Diagnostics

Viewing Logs

The IPv6 Prefix List dialog box opens (Figure 6-9).

Figure 6-10 IPv6 Prefix List Log

For the HBA port that you selected, the prefix list log shows the following
information.

Last Update Time The date-time stamp of the last router list entry. The

date-time stamp is in 12 hour format.

Prefix The local prefix of this entry.

Prefix Length The length of the local prefix for this entry.

Prefix Preferred
Lifetime

Prefix Valid
Lifetime

Flags Valid entry=0x1; non-valid entry=0x0.

For more detailed information, refer to the ISP4xxx Firmware Interface

Specification (see “Related Documents” on page 1-3).

NOTE:

If text in any column is truncated, move the cursor over it to reveal the
entire text in a tool tip next to the cursor.

5. If you want to refresh the log information immediately, click Refresh.

6. To exit the log, click Close.

The length in time that an address remains in the
preferred state in hours, minutes, and seconds.

The length in time that an address remains in the valid
state in hours, minutes, and seconds.

IS0054602-00 B 6-15

6 – Performing Diagnostics
Setting Diagnostic Test Parameters

Setting Diagnostic Test Parameters

SANsurfer iSCSI HBA Manager offers two diagnostic tests: loopback and
read/write buffer. You can access the testing functions on the Advanced page of
the Diagnostics page for an HBA port. To set the parameters and run these tests,
see the following sections:

 “Running a Loopback Test” on page 6-16
 “Running a Read/Write Buffer Test” on page 6-18

Running a Loopback Test

There are two kinds of loopback tests: internal and external. Internal loopback
testing is available for all HBAs and external loopback testing is available for the
405x and 406x series HBAs, but not for 4010 HBAs.

The external loopback test is a more complete test, but requires disconnecting the
network cable to plug in a loopback mechanism (see External Loopback Test.).
Use the external loopback test if possible. Use the internal loopback test if no
loopback mechanism is available.

S

Both types of loopback test are at the port level.

Internal Loopback Test. The internal loopback test generates a

communication signal within the HBA board and does not test the final circuitry
that goes to the cable. This test is convenient to run because it is not necessary to
unplug the network cables.

External Loopback Test. The external loopback test sends a communication

signal to the cable and off the HBA board, and a loopback cable carries the signal
back to the board. When running the external loopback test for an HBA with a
copper interface, you can use the Media Conversion or the Wrap Plug option.
When using Media Conversion, you must use a media converter and an optical
loopback cable. When using Wrap Plug, you must use a wrap plug cable. When
running the external loopback test for an HBA with an optical interface, you need
an optical loopback cable only. The Media Conversion and Wrap Plug options
are unavailable for HBAs with an optical interface.

To set loopback test configurations:

1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select the
HBA port.

2. Click the Diagnostics tab to bring the Diagnostics page to the front.

The top portion of the Diagnostics page contains the HBA port-identifying
information; for details, see “General Information for the HBA Port” on

page 6-2.

3. On the Diagnostics page, click the Advanced tab.

6-16 IS0054602-00 B

A

6 – Performing Diagnostics

Setting Diagnostic Test Parameters

The Advanced page opens within the Diagnostics page (Figure 6-11).

Figure 6-11 Advanced Page (Diagnostics): Loopback Test

The Advanced page shows the test configuration options on the top portion
and the test results on the bottom portion.

4. Under Test Configuration, click either Internal Loopback Test or External
Loopback Test.

5. If you are running an external loopback test on an HBA with a copper
interface, select one of the following options:

 If you have a media converter and an optical loopback cable, click

Media Conversion.

 If you have a wrap plug cable, click Wrap Plug.

NOTE:

If you are testing an HBA with an optical interface, Media Conversion
and Wrap Plug are unavailable.

IS0054602-00 B 6-17

6 – Performing Diagnostics
Setting Diagnostic Test Parameters

6. In the Num Of Tests (1-10000) box, enter the number of tests you want to
run. The testing session stops when the tests are complete. The valid range
is between 1 and 10,000.

7. In the Test Increment (1-10000) box, enter the number of iterations you
want to run before a test is complete. The valid range is between 1 and
10,000, and must be less than or equal to the value in the Num of Tests
box.

For example, if the Num of Tests box contains 100 and the Test Increment
box contains 10, then 100 tests are run in ten passes of ten iterations each.

8. From the On Error list, specify how to handle errors during testing. (This
selection applies whether you enter a value in the Num of Tests box or
select Test Continuously.)

 Select Ignore to disregard errors and continue the test sequence.
 Select Stop to halt the test sequence when an error is encountered.
 Select Loop to test until the failure is cleared.

9. If you want to repeat the tests until you click Stop Testing to halt the
process, select the Test Continuously check box.

S

10. To start the testing process, click Start Testing.

The Internal (or External) Loopback Results area of the Advanced page
shows the HBA Name and the number of Loopback Success and
Loopback Failure attempts.

The status bar indicates the loopback test status.

11. If you want to stop testing before the test process is complete, click Stop

Testing.

Running a Read/Write Buffer Test

The read/write buffer test sends specified data through the SCSI Write Buffer
command to a target device (disk or tape). It then reads the data back through the
SCSI Read Buffer command and compares the data for errors. The test also
compares the link status of the device before and after the read/write buffer test. If
errors occur, the test indicates a broken or unreliable link between the HBA port
and the device.

To set read/write buffer test configurations:

1. On the SANsurfer iSCSI HBA Manager main window HBA tree, select the
HBA port.

2. Click the Diagnostics tab to bring the Diagnostics page to the front.

The top portion of the Diagnostics page contains the HBA port-identifying
information; for details, see “General Information for the HBA Port” on

page 6-2.

6-18 IS0054602-00 B

A

6 – Performing Diagnostics

Setting Diagnostic Test Parameters

3. On the Diagnostics page, click the Advanced tab.

The Advanced page opens within the Diagnostics page (Figure 6-12).

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

The Advanced page shows the test configuration options on the top portion
and the test results on the bottom portion.

4. Under Test Configuration, click Read/Write Buffer Test.

5. From the Data Pattern list, select either a data byte or compliant data
pattern:

 Select Customized Pattern (optional) to specify your own eight-byte

pattern. Type the data in hexadecimal format (0-FF) into the eight
Customized Pattern boxes.

 Select Random to randomly generate an eight-byte data pattern.

6. From the Data Size list, select the data size; the number of bytes to transfer
per test per iteration when the test is run. Valid values are 8, 16, 32, 64.

7. In the Num Of Tests (1-10000) box, type the number of tests you want to
run. The testing session stops when the tests are complete. The valid range
is between 1 and 10,000.

IS0054602-00 B 6-19

6 – Performing Diagnostics
Setting Diagnostic Test Parameters

8. In the Test Increment (1-10000) box, enter the number of iterations you
want to run before a test is complete. The valid range is between 1 and
10,000, and must be less than or equal to the value in the Num of Tests
box.

For example, if the Num of Tests box contains 100 and the Test Increment
box contains 15, then 100 tests are run in seven passes. The first six passes
run 15 tests each; the seventh pass runs 10 tests (6 x 15 + 10 = 100).

NOTE:

The test runs this number of passes before it stops on an error (if you
select Stop in Step 9), or stops when you select to stop testing (if you
select Test Continuously in Step 10)

9. From the On Error list, specify how to handle errors during testing. (This
selection applies whether you enter a value in the Num of Tests box or
select Test Continuously.)

S

 Select Ignore to disregard errors and continue the test sequence.
 Select Stop to halt the test sequence when an error is encountered.
 Select Loop to use the same data pattern and test until the failure is

cleared.

10. If you want to repeat the tests until you click Stop Testing to halt the
process, select the Test Continuously check box.

11. To test specific targets that you select from the Read/Write Buffer Test
Results section, select the Test Selected Targets Only check box. To test
all targets, clear this check box.

12. To start the testing process, click Start Testing.

The status bar indicates the read/write buffer test status.

13. If you want to stop testing before the test process is complete, click Stop
Testing.

When the test is complete, the results are shown under Read/Write Buffer
Test Results on the Advanced page.

6-20 IS0054602-00 B

A

Tracing User and Agent Activity

To trace activity in SANsurfer iSCSI HBA Manager, you can either use the
manual methods described in “Using Debug to Trace User Interface and

Agent Activity” on page 7-14, or use the new, simple option in the user

interface to trace activity in the user interface, agent, non-agent JNI (JNI
Corporation’s JNIC-1560 HBA), and iSDMAPI (QLogic’s proprietary
application programming interface to manage QLA4xxx adapters).

To trace activity:

1. On the Settings menu, click Diagnostics Options.

The Diagnostic Options dialog box opens (Figure 6-13).

6 – Performing Diagnostics

Tracing User and Agent Activity

Figure 6-13 Diagnostics Options Dialog Box

IS0054602-00 B 6-21

6 – Performing Diagnostics
Tracing User and Agent Activity

2. To allow user interface diagnostic logging information to be saved to a file,
follow these steps:

a. Under SANsurfer GUI Diagnostic Preferences, select the Enable

GUI diagnostic logging to a file check box.

b. For Logging Level, select one of the following levels of logging:

 None
 Error Level
 Warning Level
 Event Level
 Spawn Level
 Trace Level
 Connection Level
 Memory Level
 Configuration Level
 Low Level
 All Levels

S

c. Select the Log data only at specified level check box to log only at

the level selected under Logging Level. To log data at multiple levels,
clear this check box.

d. In the Log File Size box, enter the maximum size in KB of the logging

file. The default is 3000 KB; enter 0 (zero) to specify unlimited size.

e. In the Log File Name box, enter a file name with which the log will be

saved in the SANsurfer iSCSI HBA Manager installation folder. The
default file name is troutput.txt.

f. To save these changes to the SANsurfer iSCSI HBA Manager user

interface diagnostic preferences, click Apply.

3. To allow agent and non-agent/JNI diagnostic logging information to be saved
to a file, follow these steps:

a. Under SANsurfer Agent & Non-Agent/JNI Diagnostic Preferences,

select the Enable agent logging to a file check box.

b. From the Hostname list, select a host name.

c. For Logging Level, select one of the following levels of logging:

 Error Level
 Warning Level
 Info Level
 Debug Level
 All Levels

6-22 IS0054602-00 B

A

6 – Performing Diagnostics

Tracing User and Agent Activity

d. Select the Log data only at specified level check box to log only at

the level selected under Logging Level. To log data at multiple levels,
clear this check box.

e. In the Log File Size box, enter the maximum size in KB of the logging

file. The default is 1000 KB; enter 0 (zero) to specify unlimited size.

f. In the Log File Name box, enter a file name with which the log will be

saved in the /tmp folder. The default file name is iSCSI_Agent.log.

g. To save these changes to the SANsurfer iSCSI HBA Manager agent

and non-agent diagnostic preferences, click Apply.

4. To allow driver API (iSDMAPI) logging information to be saved to a file,
follow these steps:

a. Under SANsurfer Agent & Non-Agent/JNI Diagnostic Preferences,

select the Enable Driver API (iSDMAPI) logging to a file check box.

b. For Logging Level, select one of the following levels of logging:

 Error Level
 Warning Level
 Event Level
 Trace Level
 All Levels

c. Select the Log data only at specified level check box to log only at

the level selected under Logging Level. To log data at multiple levels,
clear this check box.

d. In the Log File Size box, enter the maximum size in KB of the logging

file. The default is 2000 KB; enter 0 (zero) to specify unlimited size.

e. In the Log File Name box, enter a file name with which the log will be

saved in the /tmp folder. The default file name is
isdmapi_agentdebug.log.

f. To save these changes to the SANsurfer iSCSI HBA Manager driver

API diagnostic logging options, click Apply.

5. When you are through modifying the diagnostic options, click Close.

IS0054602-00 B 6-23

6 – Performing Diagnostics
Tracing User and Agent Activity

Notes

S

6-24 IS0054602-00 B