Qlogic SANsurfer iSCSI HBA Manager User manual

Type
User manual
IS0054602-00 B
SANsurfer iSCSI HBA Manager
Users Guide
Management Tool for
QLogic iSCSI Host Bus Adapters
Page ii IS0054602-00 B
S
SANsurfer iSCSI HBA Manager User’s Guide
Management Tool for QLogic iSCSI Host Bus Adapters
Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no
responsibility for its use, nor for any infringements of patents or other rights of third parties which may result from its
use. QLogic Corporation reserves the right to change product specifications at any time without notice. Applications
described in this document for any of these products are for illustrative purposes only. QLogic Corporation makes no
representation nor warranty that such applications are suitable for the specified use without further testing or
modification. QLogic Corporation assumes no responsibility for any errors that may appear in this document.
Document Revision History
Revision A, July 27, 2004
Revision B, October 17, 2008
Changes Sections Affected
Revision B Changes:
Converted to new user’s guide template. All
Modified guide title and subtitle. Title page, page headers
Updated most screen shots. All
1. Introduction section updated and expanded to
include new material such as documentation con-
ventions used in the guide, intended audience,
location of license agreements, and how to obtain
technical support.
1 Introduction
3. SANsurfer iSCSI HBA Manager Overview sec-
tion updated and expanded to include new fea-
tures and support for Windows Server 2008.
2 SANsurfer iSCSI HBA Manager Overview
2. System Overview and 4. System Requirements
sections combined into one section.
3 System Requirements and Installation Checklist
5. Installing SANsurfer iSCSI HBA Manager sec-
tion updated and expanded to include installation
using a command line interface, and instructions
for updating SANsurfer iSCSI HBA Manager from
the Web or CD. Removed obsolete information
regarding SANsurfer Control iX, updated installa-
tion configurations table, and removed obsolete
Windows NT and NetWare agent information.
4 Installing SANsurfer iSCSI HBA Manager
6. Getting Started section updated and expanded.
Added support for Windows Server 2008.
5 Getting Started
SANsurfer iSCSI HBA Manager User’s Guide
Management Tool for QLogic iSCSI Host Bus Adapters
IS0054602-00 B Page iii
S
Removed the following sections that were included
in rev. A of the user’s guide. Information from these
sections is now in the SANsurfer iSCSI HBA Man-
ager help system:
7. Setting Up Connections
8. Monitoring the Connections
9. Displaying Host, HBA Port, Device, and LUN
Information
11. Updating the HBA
10. Performing Diagnostics section expanded to
include procedures for viewing IPv6 logs and set-
ting diagnostic test parameters for running loop-
back and read/write buffer tests.
6 Performing Diagnostics
12. Troubleshooting section expanded to include a
list of troubleshooting tools, procedures for verify-
ing that the HBA driver and iqlremote are installed,
using debug to trace user interface and agent
activity, and retrieving records such as the HBA
core dump, Flash NVRAM, and HBA crash.
7 Troubleshooting
Added Windows 2008 support to FAQ table. A Frequently Asked Questions
Moved Appendix C Contacting QLogic information
to 1 Introduction.
“Technical Support” on page 1-4
Added index entries. Index
Page iv IS0054602-00 B
S
SANsurfer iSCSI HBA Manager User’s Guide
Management Tool for QLogic iSCSI Host Bus Adapters
Notes
IS0054602-00 B Page v
Table of Contents
1 Introduction
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
What’s in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Typographic Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Related Documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
License Agreements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
2 SANsurfer iSCSI HBA Manager Overview
General Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Asset Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Configuration Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
HBA State and Target Session Connection State Monitoring . . . . . . . 2-3
Additional Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
3 System Requirements and Installation Checklist
Installation Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Step 1: Collect the Hardware and Software. . . . . . . . . . . . . . . . . . . . . 3-1
Required Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Required Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Step 2: Install the Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Step 3: Install the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Step 4: Install and Run SANsurfer iSCSI HBA Manager. . . . . . . . . . . 3-3
Remote Procedure Calls (RPCs) . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Step 5: Configure the Disks in the Operating System . . . . . . . . . . . . . 3-4
Page vi IS0054602-00 B
SANsurfer iSCSI HBA Manager User’s Guide
Management Tool for QLogic iSCSI Host Bus Adapters
S
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
Supported QLogic HBAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
4 Installing SANsurfer iSCSI HBA Manager
Initial Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Installation Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Installation Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Step 1: Download the Installation . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Step 2: Start the Installation File . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
Step 3: Follow the Installation Wizard. . . . . . . . . . . . . . . . . . . . . 4-5
Installation Instructions Using CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15
Standalone Installer Command Lines . . . . . . . . . . . . . . . . . . . . . 4-15
Web- and CD-based Installation Updates . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17
Updating SANsurfer by Web Update. . . . . . . . . . . . . . . . . . . . . . . . . . 4-17
Network Does Not Use Proxy Settings. . . . . . . . . . . . . . . . . . . . 4-18
Network Requires Proxy Settings. . . . . . . . . . . . . . . . . . . . . . . . 4-18
Updating SANsurfer by Package Update . . . . . . . . . . . . . . . . . . . . . . 4-21
Uninstalling SANsurfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24
5 Getting Started
Starting SANsurfer iSCSI HBA Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
Starting SANsurfer iSCSI HBA Manager on Windows . . . . . . . . . . . . 5-1
Starting SANsurfer iSCSI HBA Manager on Linux or Solaris . . . . . . . 5-2
SANsurfer iSCSI HBA Manager Main Window . . . . . . . . . . . . . . . . . . . . . . 5-3
HBA Tree. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
Host Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
HBA Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
HBA Port Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
Device Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
LUN Icons and Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
Exiting SANsurfer iSCSI HBA Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
Viewing the Help System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
What’s in the Help System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9
Specifying the Help Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9
Viewing SANsurfer iSCSI HBA Manager Information . . . . . . . . . . . . . 5-10
IS0054602-00 B Page vii
SANsurfer iSCSI HBA Manager User’s Guide
Management Tool for QLogic iSCSI Host Bus Adapters
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
7 Troubleshooting
Troubleshooting Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1
Windows Event Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1
SANsurfer iSCSI HBA Manager Tools. . . . . . . . . . . . . . . . . . . . . . . . . 7-2
Troubleshooting Problems and Solutions. . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
Installation Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3
User Interface and Remote Agent Issues . . . . . . . . . . . . . . . . . . . . . . 7-4
Functional Issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9
Page viii IS0054602-00 B
SANsurfer iSCSI HBA Manager User’s Guide
Management Tool for QLogic iSCSI Host Bus Adapters
S
Verifying That the HBA Driver is Installed . . . . . . . . . . . . . . . . . . . . . . . . . . 7-12
Verifying That iqlremote is Installed and Running . . . . . . . . . . . . . . . . . . . . 7-13
Using Debug to Trace User Interface and Agent Activity . . . . . . . . . . . . . . . 7-14
Tracing User Interface Activity for Windows OS . . . . . . . . . . . . . . . . . 7-15
Saving Agent Activity Logs for Windows OS. . . . . . . . . . . . . . . . . . . . 7-19
Tracing User Interface Activity for UNIX OS . . . . . . . . . . . . . . . . . . . . 7-20
Saving Agent Activity Logs for UNIX OS. . . . . . . . . . . . . . . . . . . . . . . 7-22
Retrieving Records. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-22
Retrieving the HBA Core Dump Record . . . . . . . . . . . . . . . . . . . . . . . 7-23
Retrieving the Flash NVRAM Record . . . . . . . . . . . . . . . . . . . . . . . . . 7-26
Retrieving the HBA Crash Record. . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-29
A Frequently Asked Questions
Glossary
Index
IS0054602-00 B Page ix
SANsurfer iSCSI HBA Manager User’s Guide
Management Tool for QLogic iSCSI Host Bus Adapters
A
List of Figures
Figure Page
4-1 QLogic Driver Downloads / Documentation Page . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
4-2 Installation Wizard: Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
4-3 Installation Wizard: Important Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
4-4 Installation Wizard: Choose Product Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
4-5 Installation Wizard: Choose Product Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8
4-6 Installation Wizard: Choose Install Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
4-7 Installation Wizard: Previous SANsurfer Install Detected . . . . . . . . . . . . . . . . . . . . 4-10
4-8 Installation Wizard: Select Shortcut Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
4-9 Installation Wizard: Create Desktop Icon Selection . . . . . . . . . . . . . . . . . . . . . . . . . 4-12
4-10 Installation Wizard: Pre-Installation Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13
4-11 Installation Wizard: Installing SANsurfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14
4-12 Installation Wizard: Install Complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15
4-13 Update SANsurfer: Select Update Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18
4-14 Update SANsurfer: Server Proxy Settings Dialog Box. . . . . . . . . . . . . . . . . . . . . . . 4-19
4-15 Update SANsurfer: Update Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20
4-16 Update SANsurfer: Select Update Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21
4-17 Update SANsurfer: Open Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-22
4-18 Update SANsurfer: Update Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23
4-19 Uninstall SANsurfer: Add/Remove Programs Dialog Box . . . . . . . . . . . . . . . . . . . . 4-25
4-20 Uninstall SANsurfer: Uninstall SANsurfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-26
4-21 Uninstall SANsurfer: Uninstall Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27
4-22 Uninstall SANsurfer: Choose Product Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-28
4-23 Uninstall SANsurfer: Feature Removal In-progress . . . . . . . . . . . . . . . . . . . . . . . . . 4-29
4-24 Uninstall SANsurfer: Uninstall Complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-30
5-1 SANsurfer Desktop Icon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
5-2 SANsurfer iSCSI HBA Manager Main Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4
5-3 Help Window Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
5-4 Browser Location Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9
5-5 About SANsurfer iSCSI HBA Manager Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10
5-6 Security Page (Host) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13
5-7 HBA Tree Naming Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14
5-8 Application Options: Tree View Naming Preference . . . . . . . . . . . . . . . . . . . . . . . . 5-15
5-9 Polling Setting Dialog Box (HBA). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
5-10 Host Polling Setting Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18
5-11 Application Options: Update Behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
5-12 Application Options: Prompting Behavior. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20
5-13 iSCSI Configuration Change Confirmation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21
6-1 Diagnostics Page: HBA Port Info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
6-2 Ping Page (Diagnostics). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3
6-3 Ping Status Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5
6-4 Logs Page (Diagnostics) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7
6-5 ARP Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7
6-6 Connection Error Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8
Page x IS0054602-00 B
SANsurfer iSCSI HBA Manager User’s Guide
Management Tool for QLogic iSCSI Host Bus Adapters
S
6-7 IPv6 Destination Cache Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10
6-8 Neighbor Cache Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12
6-9 IPv6 Router List Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13
6-10 IPv6 Prefix List Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15
6-11 Advanced Page (Diagnostics): Loopback Test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-17
6-12 Advanced Page (Diagnostics): Read/Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . 6-19
6-13 Diagnostics Options Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-21
7-1 Windows: Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-14
7-2 local.properties in Notepad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-16
7-3 Command Prompt Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-17
7-4 “Command Prompt” Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-18
7-5 Apply Properties to Shortcut Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-18
7-6 SANsurfer.exe in Console Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-19
7-7 local.properties in Notepad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-21
7-8 HBA Utilities Page (HBA Options) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-24
7-9 Save FW Coredump Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-25
7-10 HBA Utilities Page (HBA Options) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-27
7-11 Save FW Flash & NVRAM Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-28
7-12 HBA Utilities Page (HBA Options) for QLA4010x . . . . . . . . . . . . . . . . . . . . . . . . . . 7-30
7-13 Save Crash Record Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-31
List of Tables
Table Page
1-1 Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
4-1 Configuration Option Installation Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
7-1 Troubleshooting: Installation Issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3
7-2 Troubleshooting: User Interface and Remote Agent Issues. . . . . . . . . . . . . . . . . . . 7-4
7-3 Troubleshooting: Functional Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9
A-1 Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
IS0054602-00 B 1-1
1 Introduction
The SANsurfer iSCSI HBA Manager User’s Guide describes SANsurfer
®
iSCSI
HBA Manager, a component of the QLogic
®
SANsurfer tool. SANsurfer iSCSI
HBA Manager is a comprehensive tool for configuration and management of
QLogic SANsurfer iSCSI host bus adapters (HBAs) used in storage area networks
(SANs).
Intended Audience
The information in this guide is intended for OEMs, field service personnel, and
customers who are installing and using QLogic hardware and SANsurfer iSCSI
HBA Manager. Users should be familiar with the hardware installation and the
operating systems where HBAs are installed.
What’s in This Guide
This guide contains the basic information you need to get started with the
SANsurfer iSCSI HBA Manager user interface (UI). For detailed information about
the features and functionality not covered in this guide, refer to the help system
(see “What’s in the Help System” on page 5-9).
This introductory section specifies the intended audience, explains the
typographic conventions used, lists related documents, refers you to the QLogic
license agreements, and provides technical support and contact information.
The remainder of the user's guide contains the following chapters and appendix:
2 SANsurfer iSCSI HBA Manager Overview provides a general product
overview and describes in detail its features.
3 System Requirements and Installation Checklist lists the hardware and
software requirements needed for optimum SANsurfer iSCSI HBA Manager
performance, and provides a checklist for installation.
NOTE:
Throughout this guide, HBA and adapter are used interchangeably, as are
the terms target and device.
1 – Introduction
What’s in This Guide
1-2 IS0054602-00 B
S
4 Installing SANsurfer iSCSI HBA Manager describes how to install, update,
and uninstall SANsurfer iSCSI HBA Manager.
5 Getting Started describes how to customize SANsurfer iSCSI HBA
Manager. It includes starting and exiting the SANsurfer iSCSI HBA Manager
user interface, getting help, setting security, and setting the options that
activate each time you start SANsurfer iSCSI HBA Manager.
6 Performing Diagnostics provides procedures for pinging targets, viewing
various logs, and setting up and running loopback and read/write buffer
tests.
7 Troubleshooting presents common troubleshooting questions and
answers. It also provides the procedures for tracing the SANsurfer iSCSI
HBA Manager user interface and agent activity (if directed to do so by your
authorized service provider), and for retrieving records such as the HBA
core dump, Flash NVRAM, and HBA crash.
Appendix A Frequently Asked Questions lists and provides the answers to
frequently asked questions about SANsurfer iSCSI HBA Manager.
Glossary lists common hardware, software, and iSCSI terms that are used in
SANsurfer iSCSI HBA Manager.
In addition, at the end of this guide is an index to help you easily locate the
information you need.
Typographic Conventions
This guide uses the following documentation conventions:
Text in blue font indicates a hyperlink (jump) to a figure, table, or section in
this guide, and links to Web sites are shown in underlined blue
. For
example:
Table 9-2 lists problems related to the SANsurfer iSCSI HBA Manager
user interface and remote agent.
See “Pinging Targets” on page 6-2.
For more information, visit www.qlogic.com.
NOTE:
Notes provide additional information.
CAUTION!
Cautions indicate that failure to follow instructions might result in damage to
data or equipment.
1 – Introduction
License Agreements
IS0054602-00 B 1-3
A
Text in bold font indicates SANsurfer iSCSI HBA Manager user interface
elements such as a menu items, buttons, check boxes, or column headings.
For example:
Click the Start button, point to Programs, point to Accessories, and
then click Command Prompt.
Under Notification Options, select the Warning Alarms check box.
Text i n sans serif font indicates a file name, directory path, keyboard key,
or command line text. For example:
To connect to a group of hosts listed in a host group file (.hst), type
SANsurfer -g path
and then press ENTER.
Press CTRL+SHIFT+T.
Text i n italics indicates emphasis, terms, document titles, or help topic titles.
For example:
For a complete listing of license agreements, refer to the QLogic
Software End User License Agreement.
For details, see Displaying HBA Information in the help system.
Related Documents
Table 1-1 lists other documents you may find helpful when installing or using
SANsurfer iSCSI HBA Manager.
License Agreements
For a complete listing of all license agreements affecting this product, refer to the
QLogic Software End User License Agreement.
Table 1-1. Related Documents
Part Number
or Name
Title
IS0054501-00
Rev C
Quick Start Guide: iSCSI HBA Installation (PDF).
readme.txt SANsurfer notes included with SANsurfer iSCSI HBA Manager.
Release notes SANsurfer iSCSI HBA Manager Release Notes provide details
about modifications made since the previous version. Separate
release notes are provided for each operating system.
SN0054621-00
Rev. E
SANsurfer iSCSI HBA CLI User’s Guide provides interactive menu
and non-interactive mode options for the command line interface.
1 – Introduction
Technical Support
1-4 IS0054602-00 B
S
Technical Support
Customers should contact their authorized maintenance provider for technical
support of their QLogic switch products. QLogic-direct customers may contact
QLogic Technical Support; others will be redirected to their authorized
maintenance provider.
For the latest firmware and software updates, visit the QLogic support Web site
listed in Contact Information.
Availability
QLogic Technical Support for products under warranty is available during local
standard working hours, excluding QLogic Observed Holidays.
Training
QLogic offers certification training for the technical professional for both the
QLogic iSCSI HBAs and switches. From the training link at www.qlogic.com
, you
may choose Electronic-based Training or schedule an intensive “hands-on”
Certification course.
Technical Certification courses include installation, maintenance, and
troubleshooting QLogic SAN products. Upon demonstrating knowledge using live
equipment, QLogic awards a certificate identifying the student as a Certified
Professional. The training professionals at QLogic may be reached by e-mail at
.
Contact Information
Please feel free to contact your QLogic approved reseller or QLogic Technical
Support at any phase of integration for assistance. QLogic Technical Support can
be reached by the following methods:
Support contact information for other regions of the world is available at the
QLogic Web site: http://support.qlogic.com
The QLogic knowledge database contains troubleshooting information for the
QLogic HBAs. Access the database from the QLogic Web site, www.qlogic.com
.
Click the Support tab, and then use the search engine at the top of the page to
look for specific troubleshooting information.
Web http://support.qlogic.com
North America Contact Information
Phone (952) 932-4040
IS0054602-00 B 2-1
2 SANsurfer iSCSI HBA
Manager Overview
This section provides a general overview of the SANsurfer iSCSI HBA Manager
product, and describes its features in detail.
General Overview
QLogic’s SANsurfer iSCSI HBA Manager is a user-based interface tool that
configures and manages both QLogic iSCSI host bus adapters and their attached
devices within a storage area network (SAN) environment. In addition:
SANsurfer iSCSI HBA Manager works with the Windows
®
2000, Windows
Server 2003, Windows Server 2008, Windows Vista, Red Hat
®
Linux
®
, SLES
Linux, and Solaris
®
SPARC
®
operating systems. Because the tool supports
multiple operating systems, it provides control of heterogeneous
environments.
SANsurfer iSCSI HBA Manager is a client/server tool. The networking
capability of the tool provides centralized management and configuration of
the entire SAN.
Features
SANsurfer iSCSI HBA Manager offers the features described in these sections:
“Asset Management” on page 2-2
“Configuration Management” on page 2-2
“Statistics” on page 2-3
“Diagnostics” on page 2-3
“HBA State and Target Session Connection State Monitoring” on page 2-3
“Additional Features” on page 2-3
2 – SANsurfer iSCSI HBA Manager Overview
Features
2-2 IS0054602-00 B
S
Asset Management
SANsurfer iSCSI HBA Manager allows you to connect to and disconnect from
local and remote hosts. It provides information about connected hosts and their
attached QLogic iSCSI HBAs, including connected devices and LUNs. Additional
features include:
HBA-level alias support for simple, user-friendly name identification.
Automatic iSCSI agent discovery.
Configuration Management
SANsurfer iSCSI HBA Manager allows you to configure local and remote systems.
With SANsurfer iSCSI HBA Manager, you can:
Configure QLogic iSCSI HBAs, HBA ports, and attached iSCSI targets using
a configuration wizard.
Configure HBA port boot settings (BIOS and FCode) and boot targets,
including acquiring boot targets via DHCP.
Clone all or parts of a pre-saved HBA configuration for HBA replacement,
quick configuration duplication on multiple HBA ports across multiple hosts,
or to ensure consistent configurations.
Save port network, boot, and target configuration settings without card reset.
Display LUN properties.
Update HBA firmware, driver, ROM, BIOS, and FCode.
Update BIOS boot targets.
Restore factory defaults, fully or selectively.
Update multiple HBA ports to a specific configuration at the same time.
Display target redirection information.
Ability to display and log into multiple Internet Storage Names Service
(iSNS) target portals to the same target.
Ability to retrieve and display all discovered target portals from a Send
Target discovery.
Ability to easily duplicate target portal connections to a target for multiple
connections.
Ability to select which target portals to log into from a discovered targets list
acquired from Send Target discovery and iSNS discovery.
2 – SANsurfer iSCSI HBA Manager Overview
Features
IS0054602-00 B 2-3
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
and a target.
View the address resolution protocol (ARP) cache, which keeps a record of
host port connections with other hardware (such as targets) on the network.
View the connection error log, which lists the 100 latest connection errors for
an HBA port.
Perform read/write buffer tests.
Perform internal and external loopback tests.
View the IPv6 logs for information and assistance with IPv6 configurations:
Destination Cache
Neighbor Cache
Router List
Prefix List
Retrieve HBA diagnostics information.
HBA State and Target Session Connection State Monitoring
SANsurfer iSCSI HBA Manager monitors connected QLogic iSCSI HBAs and their
targets and informs you of their state. For HBAs, the state color indicates bad
(red), unknown (blue), warning (yellow), or good (green).
Additional Features
Additional SANsurfer iSCSI HBA Manager features allow you to:
Save host configuration to a text file.
Save and load detailed host configuration of the iSCSI HBAs and connected
targets to and from a binary file for later offline viewing.
Specify hexadecimal CHAP secrets.
View detailed host configuration differences of the iSCSI HBAs and
connected targets from a prior saved configuration.
View Vendor Private Data (VPD) on iSCSI HBAs for available data, if
provided by the OEM/manufacturer.
2 – SANsurfer iSCSI HBA Manager Overview
Features
2-4 IS0054602-00 B
S
Configure, test, check status, and diagnose connections to IPv6 iSCSI
targets on IPv6 enabled HBA cards, for example the QLE406xC cards.
Automatically check for SANsurfer iSCSI HBA Manager updates.
Manually check for SANsurfer iSCSI HBA Manager updates.
Manage iSCSI and Fibre Channel HBAs and Fibre Channel switches. Each
tool appears on its own tab in the HBA tree.
NOTE:
IPv6 features, as well as some other features, are not available and appear
dimmed if one of the following applies:
You are using inbox/ioctl module drivers with Red Hat 4 and 5 and SLES
10. (To obtain the driver version string, use the modinfo qla4xxx
command at the UNIX prompt. If you are using the inbox/ioctl module
drivers, its version string contains a d.)
You do not have ACB (Alternate Control Block) support with the proper
hardware configuration, drivers, and firmware.
You can access these features if you have the correct hardware
configuration and download the latest drivers and firmware from the QLogic
Web site.
IS0054602-00 B 3-1
3 System Requirements and
Installation Checklist
SANsurfer iSCSI HBA Manager is a collection of device drivers and management
software for controlling, configuring, and managing devices in a SAN environment
that uses QLogic iSCSI HBAs. Use the following Installation Checklist to help you
install all hardware and software properly and in the correct order. To see a list of
the required hardware and software, refer to the “System Requirements” on
page 3-4.
Installation Checklist
This section describes the installation process step-by-step. Depending on the
features you require, your configuration may not require all steps.
Step 1: Collect the Hardware and Software
Step 2: Install the Hardware
Step 3: Install the Driver
Step 4: Install and Run SANsurfer iSCSI HBA Manager
Step 5: Configure the Disks in the Operating System
Step 1: Collect the Hardware and Software
Collect the required hardware and software as listed in these sections.
Required Hardware
Collect the required hardware (see also “Hardware Requirements” on page 3-4).
In all cases, some combination of the following is required:
QLogic iSCSI.
HBA target devices such as disks, tape devices, RAID subsystems, iSCSI
routers, and so on.
Connectivity hardware such as cables, hubs, switches, and so on.
3 – System Requirements and Installation Checklist
Installation Checklist
3-2 IS0054602-00 B
S
Required Software
Collect the required software (see also “Software Requirements” on page 3-5):
QLogic iSCSI HBA drivers
SANsurfer iSCSI HBA Manager
QLogic Fast!UTIL, iSCSI HBA BIOS Utility
For basic operation, you will need both of the following:
QLogic iSCSI HBA drivers
SANsurfer iSCSI HBA Manager or QLogic Fast!UTIL
To discover and connect to iSCSI devices, you will need one of the following:
SANsurfer iSCSI HBA Manager
QLogic Fast!UTIL
SANsurfer iSCSI HBA Manager is a management utility that enables you to view,
manage, and diagnose QLogic HBAs. SANsurfer iSCSI HBA Manager also
configures QLogic iSCSI HBAs and target devices on the HBAs.
Step 2: Install the Hardware
Refer to hardware installation guides to install HBAs in host systems (see
“Related Documents” on page 1-3). Cable target devices through the combination
of hubs and switches in your configuration.
Verification: Before installing the device driver, verify the presence of HBAs at
power up using the QLogic Fast!UTIL utility.
To acc ess Fast!UTIL, type ALT+Q or CTRL+Q during power up.
Fast!UTIL allows you to perform basic HBA configuration. Fast!UTIL can verify
device connectivity.
Step 3: Install the Driver
Refer to the appropriate software installation guide (see “Related Documents” on
page 1-3) and readme.txt file to install a device driver on host systems.
NOTE:
Some operating systems come from the operating system manufacturer
with a QLogic miniport device driver. To ensure support for the latest
QLogic HBA and SANsurfer tool features, install the most current device
driver. The most current device driver versions can be found at the
QLogic Web site (www.qlogic.com
).
Connections to iSCSI targets must be configured with SANsurfer iSCSI
HBA Manager or QLogic Fast!UTIL in order for them to be visible to the
operating system.
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46
  • Page 47 47
  • Page 48 48
  • Page 49 49
  • Page 50 50
  • Page 51 51
  • Page 52 52
  • Page 53 53
  • Page 54 54
  • Page 55 55
  • Page 56 56
  • Page 57 57
  • Page 58 58
  • Page 59 59
  • Page 60 60
  • Page 61 61
  • Page 62 62
  • Page 63 63
  • Page 64 64
  • Page 65 65
  • Page 66 66
  • Page 67 67
  • Page 68 68
  • Page 69 69
  • Page 70 70
  • Page 71 71
  • Page 72 72
  • Page 73 73
  • Page 74 74
  • Page 75 75
  • Page 76 76
  • Page 77 77
  • Page 78 78
  • Page 79 79
  • Page 80 80
  • Page 81 81
  • Page 82 82
  • Page 83 83
  • Page 84 84
  • Page 85 85
  • Page 86 86
  • Page 87 87
  • Page 88 88
  • Page 89 89
  • Page 90 90
  • Page 91 91
  • Page 92 92
  • Page 93 93
  • Page 94 94
  • Page 95 95
  • Page 96 96
  • Page 97 97
  • Page 98 98
  • Page 99 99
  • Page 100 100
  • Page 101 101
  • Page 102 102
  • Page 103 103
  • Page 104 104
  • Page 105 105
  • Page 106 106
  • Page 107 107
  • Page 108 108
  • Page 109 109
  • Page 110 110
  • Page 111 111
  • Page 112 112
  • Page 113 113
  • Page 114 114
  • Page 115 115
  • Page 116 116
  • Page 117 117
  • Page 118 118
  • Page 119 119
  • Page 120 120
  • Page 121 121
  • Page 122 122
  • Page 123 123
  • Page 124 124
  • Page 125 125
  • Page 126 126
  • Page 127 127
  • Page 128 128
  • Page 129 129
  • Page 130 130
  • Page 131 131
  • Page 132 132
  • Page 133 133
  • Page 134 134
  • Page 135 135
  • Page 136 136
  • Page 137 137
  • Page 138 138
  • Page 139 139
  • Page 140 140
  • Page 141 141
  • Page 142 142
  • Page 143 143
  • Page 144 144
  • Page 145 145
  • Page 146 146
  • Page 147 147
  • Page 148 148
  • Page 149 149
  • Page 150 150

Qlogic SANsurfer iSCSI HBA Manager User manual

Type
User manual

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI