Q-Logic 5200, 5202 User Manual

0
Simplify
SANbox 5200 Series
Switch Management User’s Guide
Firmware Version 4.2
59056-02 A Page i
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.
QLogic, SANbox, SANsurfer, SANblade, SANsurfer Switch Manager, and SANsurfer Management Suite are trademarks or registered trademarks of QLogic Corporation.
Java and Solaris are registered trademarks of Sun Microsystems, Inc.
Gnome is a trademark of the GNOME Foundation Corporation. Linux is a registered trademark of Linus Torvalds. Microsoft, Windows NT, Windows 2000, Windows 2003, and Internet Explorer are trademarks of Microsoft
Corporation. Netscape Navigator and Mozilla are registered trademarks of Netscape Communications Corporation. Red Hat is a registered trademark of Red Hat Software Inc. All other brand and product names are trademarks or registered trademarks of their respective owners.
0
Document Revision History
Release, Revision A, September 2004
© 2000–2005 QLogic Corporation
First Printed: May 2001
All Rights Reserved Worldwide.
Printed in U.S.A.
Page ii 59056-02 A

Table of Contents

Section 1 Introduction
1.1 Intended Audience ............................................................................................. 1-1
1.2 Related Materials ............................................................................................... 1-1
1.3 JDOM License.................................................................................................... 1-2
1.4 Technical Support............................................................................................... 1-3
1.4.1 Availability.................................................................................................. 1-3
1.4.2 Training......................................................................................................1-3
1.4.3 Contact Information ................................................................................... 1-3
Section 2 Using SANsurfer Switch Manager
2.1 Installing the Management Application............................................................... 2-1
2.1.1 SANsurfer Switch Manager ....................................................................... 2-2
2.1.2 SANsurfer Management Suite................................................................... 2-3
2.1.2.1 SMS Installation for Windows........................................................... 2-3
2.1.2.2 SMS Installation for Linux................................................................. 2-5
2.1.2.3 SMS Installation for Solaris...............................................................2-6
2.2 Starting SANsurfer Switch Manager................................................................... 2-8
2.3 Exiting SANsurfer Switch Manager .................................................................. 2-10
2.4 Uninstalling SANsurfer Switch Manager .......................................................... 2-12
2.4.1 SMS Uninstall.......................................................................................... 2-12
2.4.2 Standalone Uninstall................................................................................2-13
2.5 Changing the Encryption Key for the Default Fabric View File......................... 2-13
2.6 Saving and Opening Fabric View Files ............................................................ 2-14
2.7 Setting SANsurfer Switch Manager Preferences ............................................. 2-14
2.8 Using Online Help ............................................................................................ 2-16
2.9 Viewing Software Version and Copyright Information ...................................... 2-16
2.10 SANsurfer Switch Manager User Interface ...................................................... 2-17
2.10.1 Menu Bars ............................................................................................... 2-18
2.10.1.1 Topology Display Menu .................................................................. 2-18
2.10.1.2 Faceplate Display Menu ................................................................. 2-19
2.10.1.3 Topology Display Shortcut Keys..................................................... 2-20
2.10.1.4 Faceplate Display Shortcut Keys.................................................... 2-21
2.10.2 Tool Bar ................................................................................................... 2-23
2.10.3 Fabric Tree .............................................................................................. 2-24
2.10.4 Graphic Window ...................................................................................... 2-25
2.10.5 Data Window and Tabs............................................................................ 2-25
59056-02 A Page iii
2.10.6 Working Status Indicator.......................................................................... 2-25
2.11 Using the Topology Display.............................................................................. 2-26
2.11.1 Switch and Link Status ............................................................................ 2-26
2.11.2 Working with Switches and Links ............................................................ 2-27
2.11.2.1 Selecting Switches and Links ......................................................... 2-27
2.11.2.2 Arranging Switches in the Display .................................................. 2-27
2.11.2.3 Opening the Faceplate Display and Topology Popup Menus......... 2-28
2.11.3 Topology Data Windows.......................................................................... 2-28
2.12 Using the Faceplate Display............................................................................. 2-29
2.12.1 Port Views and Status ............................................................................. 2-30
2.12.2 Working with Ports...................................................................................2-30
2.12.2.1 Selecting Ports................................................................................2-30
2.12.2.2 Opening the Faceplate Popup Menu.............................................. 2-31
2.12.3 Faceplate Data Windows......................................................................... 2-31
0
Section 3 Managing Fabrics
3.1 Fabric Security ................................................................................................... 3-1
3.1.1 User Account Security............................................................................... 3-1
3.1.2 Fabric Services.......................................................................................... 3-2
3.1.2.1 Enabling SNMP Configuration.......................................................... 3-2
3.1.2.2 Enabling In-band Management ........................................................3-2
3.2 Fabric Tracker .................................................................................................... 3-3
3.2.1 Saving a Version Snapshot ....................................................................... 3-3
3.2.2 Viewing and Comparing Version Snapshots.............................................. 3-3
3.2.3 Exporting Version Snapshots to a File....................................................... 3-4
3.3 Managing the Fabric Database .......................................................................... 3-4
3.3.1 Adding a Fabric ......................................................................................... 3-5
3.3.2 Removing a Fabric .................................................................................... 3-6
3.3.3 Opening a Fabric View File ....................................................................... 3-6
3.3.4 Saving a Fabric View File.......................................................................... 3-6
3.3.5 Rediscovering a Fabric.............................................................................. 3-6
3.3.6 Deleting Switches and Links...................................................................... 3-7
3.3.7 Adding a New Switch to a Fabric............................................................... 3-7
3.3.8 Replacing a Failed Switch ......................................................................... 3-8
3.4 Displaying Fabric Information.............................................................................3-9
3.4.1 Fabric Status............................................................................................ 3-10
3.4.2 Displaying the Event Browser.................................................................. 3-11
3.4.2.1 Filtering the Event Browser ............................................................3-13
3.4.2.2 Sorting the Event Browser.............................................................. 3-14
3.4.2.3 Saving the Event Browser to a File ................................................ 3-14
Page iv 59056-02 A
SANbox 5200 Series Switch Management
0
3.4.3 Devices Data Window ............................................................................. 3-15
3.4.4 Active Zone Set Data Window................................................................. 3-16
3.4.5 Link Data Window.................................................................................... 3-17
3.5 Working with Device Information and Nicknames............................................ 3-17
3.5.1 Displaying Detailed Device Information................................................... 3-17
3.5.2 Exporting Device Information to a File..................................................... 3-18
3.5.3 Managing Device Port Nicknames .......................................................... 3-18
3.5.3.1 Creating a Nickname ...................................................................... 3-18
3.5.3.2 Editing a Nickname......................................................................... 3-19
3.5.3.3 Deleting a Nickname ...................................................................... 3-19
3.5.3.4 Exporting Nicknames to a File........................................................ 3-19
3.5.3.5 Importing a Nicknames File ............................................................ 3-20
3.6 Zoning a Fabric ................................................................................................ 3-20
3.6.1 Zoning Concepts ..................................................................................... 3-20
3.6.1.1 Zones.............................................................................................. 3-21
3.6.1.2 Aliases ............................................................................................ 3-22
3.6.1.3 Zone Sets ....................................................................................... 3-22
3.6.1.4 Zoning Database ............................................................................ 3-23
3.6.2 Using the Zoning Wizard ......................................................................... 3-24
3.6.3 Managing the Zoning Database .............................................................. 3-24
3.6.3.1 Editing the Zoning Database .......................................................... 3-25
3.6.3.2 Configuring the Zoning Database................................................... 3-28
3.6.3.3 Saving the Zoning Database to a File............................................. 3-29
3.6.3.4 Restoring the Zoning Database from a File.................................... 3-29
3.6.3.5 Restoring the Default Zoning Database..........................................3-30
3.6.3.6 Removing All Zoning Definitions..................................................... 3-30
3.6.4 Managing Zone Sets ............................................................................... 3-31
3.6.4.1 Creating a Zone Set .......................................................................3-31
3.6.4.2 Activating and Deactivating a Zone Set.......................................... 3-32
3.6.4.3 Copying a Zone to a Zone Set........................................................ 3-32
3.6.4.4 Removing a Zone from a Zone Set or from All Zone Sets.............. 3-32
3.6.4.5 Removing a Zone Set..................................................................... 3-33
3.6.5 Managing Zones...................................................................................... 3-33
3.6.5.1 Creating a Zone in a Zone Set .......................................................3-34
3.6.5.2 Adding Zone Members ................................................................... 3-35
3.6.5.3 Renaming a Zone or a Zone Set .................................................... 3-36
3.6.5.4 Removing a Zone Member ............................................................. 3-36
3.6.5.5 Removing a Zone from a Zone Set ................................................ 3-36
3.6.5.6 Removing a Zone from All Zone Sets............................................. 3-36
User’s Guide
59056-02 A Page v
3.6.5.7 Changing Zone Types .................................................................... 3-37
3.6.6 Managing Aliases .................................................................................... 3-37
3.6.6.1 Creating an Alias ............................................................................ 3-37
3.6.6.2 Adding a Member to an Alias ......................................................... 3-38
3.6.6.3 Removing an Alias from All Zones ................................................. 3-38
3.6.7 Merging Fabrics and Zoning.................................................................... 3-39
3.6.7.1 Zone Merge Failure ........................................................................ 3-39
3.6.7.2 Zone Merge Failure Recovery ........................................................ 3-40
0
Section 4 Managing Switches
4.1 Managing User Accounts ................................................................................... 4-2
4.1.1 Creating User Accounts............................................................................. 4-3
4.1.2 Removing a User Account.........................................................................4-4
4.1.3 Changing a User Account Password......................................................... 4-5
4.1.4 Modifying a User Account..........................................................................4-6
4.2 Displaying Switch Information ............................................................................ 4-7
4.2.1 Devices Data Window ............................................................................... 4-8
4.2.2 Switch Data Window.................................................................................. 4-8
4.2.3 Port Statistics Data Window .................................................................... 4-11
4.2.4 Port Information Data Window................................................................. 4-11
4.2.5 Configured Zonesets Data Windows....................................................... 4-12
4.3 Configuring Port Threshold Alarms .................................................................. 4-13
4.4 Paging a Switch................................................................................................ 4-14
4.5 Setting the Date/Time and Enabling NTP Client .............................................. 4-15
4.6 Resetting a Switch............................................................................................ 4-15
4.7 Configuring a Switch ........................................................................................ 4-17
4.7.1 Using the Configuration Wizard............................................................... 4-17
4.7.2 Switch Properties..................................................................................... 4-17
4.7.2.1 Symbolic Name .............................................................................. 4-18
4.7.2.2 Switch Administrative States........................................................... 4-18
4.7.2.3 Domain ID and Domain ID Lock ..................................................... 4-19
4.7.2.4 Fabric Device Management Interface............................................. 4-20
4.7.2.5 Broadcast Support.......................................................................... 4-21
4.7.2.6 In-band Management .....................................................................4-21
4.7.2.7 Interop Mode for Zoning ................................................................. 4-21
4.7.2.8 Legacy Port Address Format.......................................................... 4-22
4.7.2.9 Timeout Values ............................................................................... 4-22
4.7.3 Network Properties.................................................................................. 4-23
4.7.3.1 IP Configuration.............................................................................. 4-24
4.7.3.2 Remote Logging ............................................................................. 4-25
Page vi 59056-02 A
SANbox 5200 Series Switch Management
0
4.7.3.3 NTP Client ...................................................................................... 4-25
4.7.4 SNMP Properties..................................................................................... 4-26
4.7.4.1 SNMP Configuration....................................................................... 4-27
4.7.4.2 SNMP Trap Configuration...............................................................4-28
4.8 Archiving a Switch............................................................................................ 4-29
4.9 Restoring a Switch ........................................................................................... 4-29
4.10 Restoring the Factory Default Configuration .................................................... 4-31
4.11 Downloading a Support File ............................................................................. 4-33
4.12 Upgrading the Switch Using License Keys....................................................... 4-34
4.13 Installing Firmware ........................................................................................... 4-35
4.14 Displaying Hardware Status ............................................................................. 4-36
User’s Guide
Section 5 Managing Ports
5.1 Displaying Port Information ................................................................................ 5-1
5.1.1 Monitoring Port Status ............................................................................... 5-2
5.1.1.1 Displaying Port Types....................................................................... 5-2
5.1.1.2 Displaying Port Operational States................................................... 5-3
5.1.1.3 Displaying Port Speeds .................................................................... 5-3
5.1.1.4 Displaying Transceiver Media Status................................................ 5-4
5.1.2 Port Statistics Data Window ...................................................................... 5-5
5.1.3 Port Information Data Window...................................................................5-8
5.2 Configuring Ports.............................................................................................. 5-10
5.2.1 Changing Port Administrative States....................................................... 5-11
5.2.2 Changing Port Speeds ............................................................................ 5-12
5.2.3 Changing Port Types ............................................................................... 5-12
5.2.4 I/O Stream Guard .................................................................................... 5-13
5.2.5 Scan Device ............................................................................................ 5-13
5.2.6 Changing Port Symbolic Name ............................................................... 5-14
5.3 Using the Extended Credits Wizard ................................................................. 5-14
5.4 Resetting a Port................................................................................................ 5-15
5.5 Testing Ports..................................................................................................... 5-16
5.6 Graphing Port Performance ............................................................................. 5-18
5.6.1 Starting SANsurfer Performance Viewer ................................................. 5-19
5.6.2 Exiting SANsurfer Performance Viewer................................................... 5-19
5.6.3 Saving and Opening Performance View Files......................................... 5-20
5.6.4 Changing the Default Performance View File Encryption Key ................ 5-21
5.6.5 Setting SANsurfer Performance Viewer Preferences.............................. 5-21
5.6.6 Setting the Polling Frequency.................................................................. 5-22
5.6.7 Displaying Graphs ................................................................................... 5-22
5.6.7.1 Arranging Graphs in the Display..................................................... 5-23
59056-02 A Page vii
5.6.7.2 Customizing Graphs ....................................................................... 5-23
5.6.7.3 Rescaling a Selected Graph........................................................... 5-25
5.6.8 Printing Graphs........................................................................................5-25
5.6.9 Saving Graph Statistics to a File.............................................................. 5-25
0
Appendix A Command Line Interface
A.1 Logging On to a Switch ......................................................................................A-1
A.2 User Accounts....................................................................................................A-2
A.3 Working with Switch Configurations...................................................................A-3
A.3.1 Modifying a Configuration..........................................................................A-3
A.3.2 Backing up and Restoring Switch Configurations......................................A-4
A.4 Commands .........................................................................................................A-6
Admin Command.......................................................................................A-8
Alias Command .........................................................................................A-9
Config Command.....................................................................................A-11
Create Support Command.......................................................................A-14
Date Command .......................................................................................A-16
Feature Command...................................................................................A-17
Firmware Install Command......................................................................A-18
Hardreset Command ...............................................................................A-19
Help Command........................................................................................A-20
History Command....................................................................................A-21
Hotreset Command .................................................................................A-22
Image Command.....................................................................................A-23
Lip Command ..........................................................................................A-26
Passwd Command ..................................................................................A-27
Ping Command........................................................................................A-28
Ps Command...........................................................................................A-29
Quit Command ........................................................................................A-30
Reset Command......................................................................................A-31
Set Command..........................................................................................A-37
Set Config Command ..............................................................................A-39
Set Log Command...................................................................................A-51
Set Port Command..................................................................................A-54
Set Setup Command ...............................................................................A-56
Show Command......................................................................................A-61
Show Config Command...........................................................................A-76
Show Log Command...............................................................................A-80
Show Perf Command ..............................................................................A-83
Show Setup Command............................................................................A-86
Page viii 59056-02 A
SANbox 5200 Series Switch Management
0
Shutdown Command...............................................................................A-89
Test Command ........................................................................................A-90
Uptime Command....................................................................................A-93
User Command .......................................................................................A-94
Whoami Command..................................................................................A-97
Zone Command.......................................................................................A-98
Zoneset Command................................................................................A-102
Zoning Command..................................................................................A-104
User’s Guide
Glossary
Index

Figures

Figure Page
2-1 Initial Startup Dialog.......................................................................................................2-9
2-2 SANsurfer Switch Manager Window............................................................................ 2-10
2-3 Save Default Fabric View File Dialog...........................................................................2-11
2-4 Load Default Fabric File Dialog.................................................................................... 2-11
2-5 Preferences Dialog – SANsurfer Switch Manager ....................................................... 2-15
2-6 SANsurfer Switch Manager Display Elements............................................................. 2-17
2-7 Topology Display Menu................................................................................................2-18
2-8 Faceplate Display Menu............................................................................................... 2-19
2-9 Fabric Tree................................................................................................................... 2-24
2-10 Topology Display..........................................................................................................2-26
2-11 Faceplate Display......................................................................................................... 2-29
3-1 Fabric Version Snapshot Analysis Dialog ...................................................................... 3-4
3-2 Add a New Fabric Dialog ............................................................................................... 3-5
3-3 Events Browser............................................................................................................ 3-11
3-4 Filter Events Dialog...................................................................................................... 3-13
3-5 Active Zone Set Data Window ..................................................................................... 3-16
3-6 Detailed Devices Display Dialog .................................................................................. 3-17
3-7 Edit Zoning Dialog........................................................................................................ 3-25
3-8 Zoning Config Dialog....................................................................................................3-28
4-1 User Account Administration Dialog – Add Account ...................................................... 4-3
4-2 User Account Administration Dialog – Remove Account ............................................... 4-4
4-3 User Account Administration Dialog – Change Password ............................................. 4-5
4-4 User Account Administration Dialog - Modify Account................................................... 4-6
4-5 Faceplate Display - Switch Information..........................................................................4-7
4-6 Configured Zonesets Data Window ............................................................................. 4-12
4-7 Port Threshold Alarm Configuration Dialog.................................................................. 4-13
4-8 Port Threshold Alarm Example .................................................................................... 4-14
4-9 Switch Properties Dialog.............................................................................................. 4-18
4-10 Network Properties Dialog ........................................................................................... 4-23
59056-02 A Page ix
4-11 SNMP Properties Dialog .............................................................................................. 4-26
4-12 Restore Dialogs – Full and Selective ........................................................................... 4-30
4-13 Features License Key Dialog ....................................................................................... 4-34
4-14 Add License Key Dialog............................................................................................... 4-34
4-15 Hardware Status LEDs................................................................................................. 4-36
5-1 Faceplate Display – Port Information............................................................................. 5-1
5-2 Port Properties Dialog.................................................................................................. 5-10
5-3 Designate Donor Ports................................................................................................. 5-15
5-4 Port Loopback Test Dialog........................................................................................... 5-16
5-5 Fabric View Graphs...................................................................................................... 5-18
5-6 Save Default Performance View File Dialog ................................................................ 5-20
5-7 Load Default View File Dialog...................................................................................... 5-20
5-8 Preferences – SANsurfer Performance Viewer............................................................ 5-21
5-9 Default Graph Options Dialog ...................................................................................... 5-23
0
Page x 59056-02 A
SANbox 5200 Series Switch Management
0
User’s Guide

Tables

Table Page
2-1 Topology Display Menu Shortcut Keys ........................................................................ 2-20
2-2 Faceplate Display Shortcut Keys ................................................................................. 2-21
2-3 Tool Bar Buttons .......................................................................................................... 2-23
3-1 Topology Display Switch and Status Icons .................................................................. 3-10
3-2 Severity Levels............................................................................................................. 3-12
3-3 Devices Data Window Entries...................................................................................... 3-15
3-4 Edit Zoning Dialog Tool Bar Buttons and Icons ........................................................... 3-26
4-1 Factory User Accounts...................................................................................................4-2
4-2 Switch Data Window Entries.......................................................................................... 4-8
4-3 Switch Resets .............................................................................................................. 4-16
4-4 Switch Administrative States........................................................................................4-19
4-5 Timeout Values ............................................................................................................ 4-22
4-6 IP Configuration Parameters........................................................................................ 4-24
4-7 SNMP Configuration Parameters................................................................................. 4-27
4-8 SNMP Trap Configuration Parameters ........................................................................ 4-28
4-9 Factory Default Configuration Settings ........................................................................ 4-31
5-1 Port Types...................................................................................................................... 5-2
5-2 Port Operational States.................................................................................................. 5-3
5-3 Port Speeds ...................................................................................................................5-3
5-4 Port Transceiver Media View ......................................................................................... 5-4
5-5 Port Statistics Data Window Entries............................................................................... 5-5
5-6 Port Information Data Window Entries........................................................................... 5-8
5-7 Port Administrative States............................................................................................ 5-11
5-8 Port Speeds .................................................................................................................5-12
5-9 Port Types.................................................................................................................... 5-12
A-1 Command-Line Completion ...........................................................................................A-6
A-2 Commands Listed by Authority Level.............................................................................A-7
A-3 Switch Configuration Defaults ......................................................................................A-32
A-4 Port Configuration Defaults..........................................................................................A-33
A-5 Port Threshold Alarm Configuration Defaults...............................................................A-34
A-6 Zoning Configuration Defaults......................................................................................A-34
A-7 SNMP Configuration Defaults ......................................................................................A-35
A-8 System Configuration Defaults.....................................................................................A-36
A-9 Set Config Port Parameters .........................................................................................A-39
A-10 Set Config Switch Parameters .....................................................................................A-42
A-11 Set Config Threshold Parameters................................................................................A-45
A-12 Set Config Zoning Parameters.....................................................................................A-46
A-13 SNMP Configuration Settings ......................................................................................A-56
A-14 System Configuration Settings.....................................................................................A-57
A-15 Show Port Parameters.................................................................................................A-63
A-16 Switch Operational Parameters ...................................................................................A-66
A-17 Zoning Database Limits .............................................................................................A-105
59056-02 A Page xi
Notes
0
Page xii 59056-02 A
Section 1
Introduction
This manual describes the switch management tools which include the SANsurfer Switch Manager application (version 4.02) and the Command Line Interface (CLI) for the SANbox 5200 Series Fibre Channel switches (firmware version 4.2). This includes the model 5200 switch and the model 5202 switch with dual replaceable power supplies. The SANbox 5200 Series switches are 20 port non-blocking Fibre Channel switches. This manual defines the features, components, and performance characteristics of the SANbox 5200 Series switches. The SANsurfer Switch Manager application is the primary focus of this manual which is organized as follows:
Section 1 describes the intended audience for this manual, related
materials, and technical support.
Section 2 describes how to use SANsurfer Switch Manager, its menus, and
its displays.
Section 3 describes fabric management tasks.
Section 4 describes switch management tasks.
Section 5 describes port and device management tasks.
Appendix A describes the command line interface.
A glossary of terms and an index are also provided.
1.1

Intended Audience

This manual introduces the switch management products and explains their installation and use. It is intended for users responsible for installing and using switch management tools.
1.2

Related Materials

Refer to the following manuals for information about switch hardware and installation.
SANbox 5200 Series Fibre Channel Switch Installation Guide, publication
number 59055-02 Rev. A.
59056-02 A 1-1
1 – Introduction JDOM License
1.3

JDOM License

This product includes software developed by the JDOM Project (http://www.jdom.org/). Copyright (C) 2000-2002 Brett McLaughlin & Jason Hunter. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this
2. Redistributions in binary form must reproduce the above copyright notice,
3. The name "JDOM" must not be used to endorse or promote products
4. Products derived from this software may not be called "JDOM", nor may
0
list of conditions, and the following disclaimer.
this list of conditions, and the disclaimer that follows these conditions in the documentation and/or other materials provided with the distribution.
derived from this software without prior written permission. For written permission, please contact license@jdom.org.
"JDOM" appear in their name, without prior written permission from the JDOM Project Management (pm@jdom.org).
In addition, we request (but do not require) that you include in the end-user documentation provided with the redistribution and/or in the software itself an acknowledgement equivalent to the following: "This product includes software developed by the JDOM Project (http://www.jdom.org/)."
Alternatively, the acknowledgment may be graphical using the logos available at http://www.jdom.org/images/logos.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
This software consists of voluntary contributions made by many individuals on behalf of the JDOM Project and was originally created by Brett McLaughlin <brett@jdom.org> and Jason Hunter <jhunter@jdom.org>. For more information on the JDOM Project, please see <http://www.jdom.org/>.
1-2 59056-02 A
0
1.4

Technical Support

Customers should contact their authorized maintenance provider for technical support of their QLogic switch products. QLogic-direct customers may contact QLogic Technical Support; others will be redirected to their authorized maintenance provider.
Visit the QLogic support Web site listed in Contact Information for the latest firmware and software updates.
1.4.1

Availability

QLogic Technical Support is available from 7:00 AM to 7:00 PM Central Standard Time, Monday through Friday, excluding QLogic-observed holidays.
1.4.2

Training

QLogic offers certification training for the technical professional for both the SANblade™ HBAs and the SANbox 5200 Series switches. From the training link at www.qlogic.com, you may choose Electronic-Based Training or schedule an intensive "hands-on" Certification course.
1 – Introduction
Technical Support
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 email at tech.training@qlogic.com
1.4.3

Contact Information

Telephone: +1 952-932-4040
Fax: +1 952-932-4018
Email: Technical Service Technical Training
QLogic Web Site: www.qlogic.com
Technical Support Web Site: support.qlogic.comt
support@qlogic.com tech.training@qlogic.com
59056-02 A 1-3
1 – Introduction Technical Support
Notes
0
1-4 59056-02 A
Section 2
Using SANsurfer Switch Manager
This section describes how to use the SANsurfer Switch Manager application and its menus. The following topics are covered:
Installing the Management Application
Starting SANsurfer Switch Manager
Exiting SANsurfer Switch Manager
Uninstalling SANsurfer Switch Manager
Changing the Encryption Key for the Default Fabric View File
Saving and Opening Fabric View Files
Setting SANsurfer Switch Manager Preferences
Using Online Help
Viewing Software Version and Copyright Information
SANsurfer Switch Manager User Interface
Using the Topology Display
Using the Faceplate Display
2.1

Installing the Management Application

You can manage the switch using SANsurfer Switch Manager as a standalone application or as a part of SANsurfer Management Suite™. SANsurfer Management Suite is QLogic’s integrated fabric management application, managing both HBAs and switches.
If your switch was shipped with a SANsurfer Switch Manager Disk, refer to
”SANsurfer Switch Manager” on page 2-2 for instructions on how to install
SANsurfer Switch Manager.
If your switch was shipped with a SANsurfer Management Suite Disk, refer
to ”SANsurfer Management Suite” on page 2-3 for instructions on how to install and upgrade SANsurfer Management Suite.
Refer to the SANbox 5200 Series Switch Management User’s Guide for more information about using, exiting, and uninstalling SANsurfer Management Suite and SANsurfer Switch Manager.
59056-02 A 2-1
2 – Using SANsurfer Switch Manager Installing the Management Application
2.1.1

SANsurfer Switch Manager

You can install SANsurfer Switch Manager on a Windows, Linux, or Solaris workstation. To install SANsurfer Switch Manager from the SANsurfer Switch Manager disk, close all programs currently running, and insert the SANsurfer Switch Manager Installation Disk into the management workstation CD-ROM drive.
For a Windows workstation:
1. Using Windows Explorer, double-click the drive letter which contains the SANsurfer Switch Manager Installation Disk.
2. Double click the Switch_Manager folder, then double click the Windows folder.
3. Double click the executable file and follow the SANsurfer Switch Manager installation instructions.
For a Linux workstation:
0
1. If a file browser does not open, double-click the CD-ROM icon to open the browser. Double click the Switch_Manager folder, then double click the Linux folder. If there is no CD-ROM icon, do the following:
a. Open an xterm or other terminal window.
b. Mount the CD-ROM. From a shell prompt, enter the following
command:
mount /mnt/cdrom
c. Change directory to location of the install program:
cd /mnt/cdrom/Switch_Manager/Linux
2. Enter the following command to make the install file executable:
chmod +x Linux_4.02.xx_xxxx.bin
3. Execute the install program and follow the installation instructions:
./Linux_4.02.xx_xxxx.bin
For a Solaris workstation:
1. Open a terminal window. If the disk isn’t already mounted, enter the following command:
volcheck
2. Move to the directory on the disk that contains the executable. Enter the following command:
cd /cdrom/cdrom0/Switch_Manager/solaris
2-2 59056-02 A
0
3. Add the package and follow the SANsurfer Switch Manager installation instructions. Enter the following command:
pkgadd -d sol_pkg
2.1.2

SANsurfer Management Suite

The following instructions describe how to install SANsurfer Management Suite and upgrade SANsurfer Switch Manager. You can install SANsurfer Management Suite (SMS) on a Windows, Linux, or Solaris workstation. Choose the instructions for your workstation:
SMS Installation for Windows
SMS Installation for Linux
SMS Installation for Solaris
2.1.2.1
SMS Installation for Windows
Close all programs currently running, and insert the SANsurfer Management Suite Installation Disk into the management workstation CD-ROM drive.
2 – Using SANsurfer Switch Manager
Installing the Management Application
1. If the SANsurfer Management Suite start page does not open in your default browser, do the following:
a. Using Windows Explorer, double-click the drive letter which contains
the SANsurfer Management Suite Disk.
b. Locate and double-click the Start_Here.htm file to open the SANsurfer
Management Suite start page in your default browser.
2. On the SANsurfer Management Suite start page, click the SANbox Switch Software button.
3. On the SANbox Switch Software page, scroll to the SANbox 5200 Series Series area.
4. In the Operating System column, click the Win NT/2000 link.
5. Click the SANsurfer Management Software link to open the File Download dialog.
6. You can run the installation file from the CD-ROM or download the installation file to your hard drive. Choose one of the following:
Open the installation file from the CD-ROM and follow the SANsurfer
Switch Manager installation instructions.
Specify a location in which to save the
sansurfer_windows_install.exe file, and click the Save button. Double-click the saved sansurfer_windows_install.exe file and follow the installation instructions.
59056-02 A 2-3
2 – Using SANsurfer Switch Manager Installing the Management Application
7. When the installation is complete, start SANsurfer Management Suite using the SANsurfer file from the SANsurfer Management Suite installation directory. You can also start SANsurfer Management Suite by clicking the SANsurfer icon (if installed) on the desktop or from the Start menu. In SMS, Click the Switch tab in the left pane. From the Help menu, select About ... and make note of the version number. Close SANsurfer Management Suite.
8. To ensure you are using the most recent version of SANsurfer Switch Manager, visit the QLogic support web page and go to Drivers, Software and
Manuals.
a. Select your switch model from the pull-down menu. Locate the
description for SANsurfer Switch Manager for Windows under "Management Software".
b. If the release version number (4.02.xx) is greater than what is currently
installed, download the new version and proceed to step 9. Otherwise, no upgrade is needed and the SMS installation is complete.
9. To start the installer, open the zip file and run the SANsurferSwitchMgr_Windows_4.02.xx.exe file.
0
10. When prompted for an installation directory, click the Choose button and select the same folder as the SANsurfer Management Suite installation in
step 6. The default SMS installation directory is C:\Program Files\QLogic
Corporation\SANsurfer. Click the Next button.
11. When prompted for the location in which to create the program icons, click the In an Existing Group radio button, then specify the same group that was used for the SMS installation. The default SMS group is "QLogic Management Suite". Click the Next button.
12. Click the Install button to the start the installation. When the installation is complete, click the Done button.
13. In the SMS install directory, enter the following command to execute the chglax.bat file. If prompted to overwrite an existing file, enter Y to do so.
chglax.bat
14. Restart SANsurfer Switch Manager from SANsurfer Management suite as you did in step 7 and confirm that the new version is running.
2-4 59056-02 A
0
2.1.2.2
SMS Installation for Linux
Close all programs currently running, and insert the SANsurfer Management Suite Installation Disk into the management workstation CD-ROM drive.
1. If a file browser dialog opens showing icons for the contents of the CD-ROM, double-click the Start_Here.htm file to open the SANsurfer Management Suite start page. If a file browser does not open, double-click the CD-ROM icon to open the browser. If there is no CD-ROM icon, do the following:
a. Open an xterm or other terminal window.
b. Mount the CD-ROM. From a shell prompt, enter the following
command:
mount /mnt/cdrom
c. Execute your web browser to view the Start_Here.htm document
using one of the following commands:
mozilla file:/mnt/cdrom/Start_Here.htm
2 – Using SANsurfer Switch Manager
Installing the Management Application
or
netscape file:/mnt/cdrom/Start_Here.htm
d. The SANsurfer Management Suite start page opens in your browser.
2. On the SANsurfer Management Suite start page, click the SANbox Switch Software button.
3. On the SANbox Switch Software page, scroll to the SANbox 5200 Series Series area.
4. In the Operating System column, click the Linux link.
5. Click the SANsurfer Management Software link to open the File Download dialog.
6. Enter a path name to save the sansurfer_linux_install.bin file, and click the Save button.
7. Open a terminal window for the directory in which the sansurfer_linux_install.bin file was saved, and make the file executable.
chmod +x sansurfer_linux_install.bin
8. Execute the install program and follow the installation instructions
./sansurfer_linux_install.bin
9. When the installation is complete, start SANsurfer Management Suite using the SANsurfer file in the installation directory. Click the Switch tab from the left pane to open SANsurfer Switch Manager. From the Help menu, select About ... and make note of the release version number. Close SANsurfer Management Suite.
59056-02 A 2-5
2 – Using SANsurfer Switch Manager Installing the Management Application
10. To ensure that you are using the most recent version of SANsurfer Switch Manager, visit the QLogic support web page and go to Drivers, Software and
Manuals.
a. Select your switch model from the pull-down menu. Locate the
description for SANsurfer Switch Manager for Linux under "Management Software".
b. If the release version number (4.02.xx) is greater than what is currently
installed on your workstation, down load the new version and proceed to step 11. Otherwise, no upgrade is needed and the SMS installation is complete.
11. From the tar.gz file, extract the SANsurferSwitchMgr_Linux_4.02.xx.bin file and make the file executable.
chmod +x sansurferswitchmgr_linux_4.02.xx.bin
12. Execute the install program and follow the installation instructions.
./sansurferswitchmgr_linux_4.02.xx.bin
13. When prompted for an installation directory, click the Choose button and select the same folder as the SANsurfer Management Suite installation in
step 9. The default SMS installation directory is
/opt/QLogic_Corporation/SANsurfer.
0
14. Enter the following script command from the installation directory:
./chglax
15. Start SANsurfer Switch Manager from SANsurfer Management suite as you did in step 9 and confirm that the new version is running.
2.1.2.3
SMS Installation for Solaris
To install the SANsurfer Switch Manager application on Solaris from the SANsurfer Management Suite CD-ROM, do the following:
1. Insert the SANsurfer Management Suite Disk into the management workstation CD-ROM drive. If the SANsurfer Management Suite start page does not open in your default browser, do the following:
a. Right-click the Workspace Menu.
b. Select File, then select File Manager.
c. In File Manager, double-click the CD-ROM folder, and then
double-click the Sansurfer folder.
d. In the Sansurfer folder, double-click the Start_Here.htm file to open
the SANsurfer Management Suite start page in your default browser.
2. On the SANsurfer Management Suite start page, click the SANbox Switch Software button.
2-6 59056-02 A
0
2 – Using SANsurfer Switch Manager
Installing the Management Application
3. On the SANbox Switch Software page, scroll to the SANbox 5200 Series Series area.
4. In the Operating System column, click the Solaris SPARC link.
5. Click the SANsurfer Management Software link to open the Save As dialog.
6. Enter a path name to save the sansurfer_solaris_install.bin file and click the Save button.
7. Open a terminal window for the directory in which the sansurfer_solaris_install.bin file was saved, and enter the following:
chmod +x sansurfer_solaris_install.bin
8. Execute the install program and follow the installation instructions:
./sansurfer_solaris_install.bin
9. When the installation is complete, start SANsurfer Management Suite using the SANsurfer file in the installation directory. Click the Switch tab from the left pane to open SANsurfer Switch Manager. From the Help menu, select About ... and make note of the release version number. Close SANsurfer Management Suite.
10. To ensure that you are using the most recent version of SANsurfer Switch Manager, visit the QLogic support web page and go to Drivers, Software and
Manuals.
a. Select your switch model from the pull-down menu. Locate the
description for SANsurfer Switch Manager for Linux under "Management Software".
b. If the release version number (4.02.xx) is greater than what is currently
installed on your workstation, down load the new version. Otherwise, no upgrade is needed.
11. Open the tar file and save the SANsurferSwitchMgr_QLGCsol_4.02.xx.bin file in a folder and make the file executable.
# chmod +x sansurferswitchmgr_QLGCsol_4.02.xx
12. Install the new SANsurfer Switch Manager package:
# pkgadd -d sansurferswitchmgr_QLGCsol_4.02.xx
13. Change directories to the package location:
# cd /usr/opt/QLGCsol/bin
14. Locate and execute the file sbm_over_sms.sh:
# ./sbm_over_sms.sh
59056-02 A 2-7
2 – Using SANsurfer Switch Manager Starting SANsurfer Switch Manager
15. When prompted for the SMS installation directory, enter d if SMS was installed in it’s default directory (/opt/QLogic_Corporation/SANsurfer). Otherwise, enter the path name for the SMS installation directory. The script will copy the necessary files to the specified installation directory.
16. Restart SANsurfer Switch Manager from SANsurfer Management suite as you did in step 9 and confirm that the new version is running.
2.2

Starting SANsurfer Switch Manager

You can start SANsurfer Switch Manager as a standalone application or from SANsurfer Management Suite.
Note: After the switch is operational, you can also open the SANsurfer
Switch Manager web applet, by entering the switch IP address in an internet browser. If your workstation does not have the Java 2 Run Time Environment program, you will be prompted to download it.
0
To start SANsurfer Switch Manager as a standalone application, do the
following.
1. Start the SANsurfer Switch Manager using one of the following
methods:
For Windows, double-click the SANsurfer Switch Manager
shortcut, or select SANsurfer Switch Manager from Start menu, depending on how you installed the SANsurfer Switch Manager application. From a command line, you can enter the SANsurfer_Switch_Manager command:
<install_directory>SANsurfer_Switch_Manager.exe
For Linux or Solaris, enter the SANsurfer_Switch_Manager
command:
<install_directory>./SANsurfer_Switch_Manager
2. In the Initial Start dialog, click the Open Configuration Wizard button.
When you power up the switch, the Configuration Wizard will recognize the switch and lead you through the configuration process.
2-8 59056-02 A
0
2 – Using SANsurfer Switch Manager
Starting SANsurfer Switch Manager
To start SANsurfer Switch Manager from SANsurfer Management Suite, do
the following.
1. Start the SANsurfer Management Suite application using one of the
following methods:
For Windows, double-click the SANsurfer shortcut, or select
SANsurfer from Start menu, depending on how you installed the SANsurfer application. From a command line, enter the following command:
<install_directory>\SANsurfer.exe
For Linux or Solaris enter the SANsurfer command:
<install_directory>./SANsurfer
2. From the SANsurfer Management Suite home page, click the
SANsurfer Switch Manager button.
3. In the Initial Start dialog, click the Open Configuration Wizard button.
When you power up the switch, the Configuration Wizard will recognize the switch and lead you through the configuration process.
The application opens with the Initial Start dialog shown in Figure 2-1. If you prefer not to see this dialog, check the Don’t show this dialog again box. This has the same effect as disabling the Display Initial Startup Dialog preference. Refer to
”Setting SANsurfer Switch Manager Preferences” on page 2-14 for information
about setting preferences.
Figure 2-1. Initial Startup Dialog
59056-02 A 2-9
2 – Using SANsurfer Switch Manager Exiting SANsurfer Switch Manager
Click the Open Existing Fabric radio button to open the Add a New Fabric
dialog, which prompts you for a fabric name, IP address, account name, and password. Refer to ”Adding a Fabric” on page 3-5.
Click the Open Existing Fabric View File radio button to open the Open
View dialog which prompts you to specify a fabric view file that you saved earlier. Refer to ”Opening a Fabric View File” on page 3-6.
Click the Start Application Without Specifying a Fabric radio button to
open the SANsurfer Switch Manager window shown in Figure 2-2.
Click the Open Configuration Wizard radio button to open the Config
Wizard to configure a switch, add a new switch, replace/restore a switch, or recover or edit an IP configuration of an existing switch.
0
Figure 2-2. SANsurfer Switch Manager Window
2.3

Exiting SANsurfer Switch Manager

To exit a SANsurfer Switch Manager application session, open the File menu and select Exit. If you have not yet defined an encryption key, the Save Default Fabric View File dialog, shown in Figure 2-3, prompts you to save the current fabric view as the default fabric view file. Enter an encryption key in the Default Fabric File Encryption Key field. Re-enter the encryption key in the Re-enter Encryption Key to Confirm field. Click the OK button to save the current set of fabrics to the default fabric view file in the working directory.
2-10 59056-02 A
0
2 – Using SANsurfer Switch Manager
Exiting SANsurfer Switch Manager
Figure 2-3. Save Default Fabric View File Dialog
The encryption key is used to encrypt the sensitive data in the default fabric view file. Refer to ”Changing the Encryption Key for the Default Fabric View File” on
page 2-13 for information about changing this encryption key. If an encryption key
has been defined and the View File Auto Save and Load preferences settings are set to Enable, the current fabric view is automatically saved to your default fabric view file upon exit future SANsurfer Switch Manager sessions.
To prevent SANsurfer Switch Manager from prompting you to save the default fabric view file between SANsurfer Switch Manager sessions, set the View File Auto Save and Load preferences setting to Enable (default). Refer to ”Setting
SANsurfer Switch Manager Preferences” on page 2-14 for more information.
In your next SANsurfer Switch Manager session, the Load Default Fabric File dialog shown in Figure 2-4 prompts you to load the default fabric view file and to specify its encryption key, if there is one. In the Default Fabric File Encryption Key field, enter the encryption key and click the Load View File button. If you do not want to load the default fabric view file, click the Continue Without Loading button to open the SANsurfer Switch Manager with no fabric displayed.
Figure 2-4. Load Default Fabric File Dialog
59056-02 A 2-11
2 – Using SANsurfer Switch Manager Uninstalling SANsurfer Switch Manager
2.4

Uninstalling SANsurfer Switch Manager

The method you use to uninstall SANsurfer Switch Manager depends on how you installed it:
If you installed SANsurfer Switch Manager as part of SANsurfer
Management Suite, you must uninstall SANsurfer Management Suite. Refer to ”SMS Uninstall” on page 2-12.
If you installed SANsurfer Switch Manager as a standalone program, you
must uninstall SANsurfer Switch Manager directly. Refer to ”Standalone
Uninstall” on page 2-13.
2.4.1

SMS Uninstall

A program to uninstall SANsurfer Management Suite was included as part of the SANsurfer Management Suite installation process. Use this method only if you installed SANsurfer Switch Manager as part of SANsurfer Management Suite. The UninstallData folder in the installation directory contains the uninstall program, SANsurferUninstaller.
0
The default installation directories are:
For Windows: C:\Program Files\QLogic_Corporation\SANsurfer
For Linux: /opt/QLogic_Corporation/SANsurfer
For Solaris: /opt/QLogic_Corporation/SANsurfer
To uninstall the SANsurfer Management Suite application, do the following:
For Windows, browse for the uninstall program file or the shortcut/link that
points to the uninstall program file. The uninstall program shortcut is in the same folder as the program shortcut (Start menu, program group, on desktop, or user specified) that is used to start the SANsurfer Management Suite application. Double-click the uninstall program file or shortcut/link, and follow the instructions.
For Linux, execute the link to SANsurferUninstaller.
<install_directory>/UninstallerData/SANsurferUninstaller
For Solaris, enter the following command and follow the instructions:
<install_directory>/UninstallData/SANsurferUninstaller
2-12 59056-02 A
0
2.4.2

Standalone Uninstall

A program to uninstall SANsurfer Switch Manager was included as part of the SANsurfer Switch Manager installation process. Use this method only if you installed SANsurfer Switch Manager as a standalone program. The UninstallerData folder in the Install directory contains the uninstall program, Uninstall Switch_Manager. Also, a shortcut/link to the uninstall program was installed in the installation directory during the SANsurfer Switch Manager installation process.
The default installation directories are:
For Windows: C:\Program Files\QLogic_Corporation\Switch_Manager
For Linux: /opt/QLogic_Corporation/Switch_Manager
For Solaris: /usr/opt/QLGCsol
To uninstall the SANsurfer Switch Manager application, do the following:
For Windows, browse for the uninstall program file or the shortcut/link that
points to the uninstall program file. The uninstall program shortcut is in the same folder as the program shortcut (Start menu, program group, on desktop, or user specified) that is used to start the SANsurfer Switch Manager application. Double-click the uninstall program file or shortcut/link, and follow the instructions to uninstall the SANsurfer Switch Manager application.
2 – Using SANsurfer Switch Manager

Changing the Encryption Key for the Default Fabric View File

For Linux, execute the link to Uninstall_Switch_Manager. If no links were
created during the installation, enter the following command:
<install_directory>UninstallerData/Uninstall_Switch_Manager
For Solaris, enter the following command and follow the instructions to
uninstall the SANsurfer Switch Manager application:
pkgrm QLGCsol
2.5
Changing the Encryption Key for the Default Fabric View File
To change the encryption key for the SANsurfer Switch Manager default fabric view file, do the following:
1. Open the File menu and select Save Default Fabric View File to open the Save Default Fabric View File dialog. Enter an encryption key in the Default Fabric File Encryption Key field.
2. Re-enter the same encryption key in the Re-enter Encryption Key to Confirm field.
3. Click the OK button to save the current set of fabrics to the default fabric view file in the working directory.
59056-02 A 2-13
2 – Using SANsurfer Switch Manager Saving and Opening Fabric View Files
2.6

Saving and Opening Fabric View Files

A fabric view file is one or more fabrics saved to a file. In addition to the SANsurfer Switch Manager default fabric view file, you can save and open your own fabric view files. To save a set of fabrics to a file, do the following:
1. Open the File menu and select Save View As to open the Save View dialog.
2. Enter a name for the fabric view file or click the Browse button to select an existing file. Files are saved in the working directory.
3. Enter a password. When you attempt to open this fabric view file, you will be prompted for this password. If you leave the File Password field blank, no password will be required when attempting to open this fabric view file.
4. Click the OK button to save the view.
To open a fabric view file, do the following:
1. Open the File menu and select Open View File to open the Open View dialog.
0
2. Enter a name for the fabric view file or click the Browse button to select an existing file.
3. If the fabric view file was saved with a password, enter the password and click the OK button.
4. Click the OK button to open the view.
2.7

Setting SANsurfer Switch Manager Preferences

Using the preferences settings, you can:
Change the location of the working directory in which to save files.
Change the location of the browser used to view the online help.
Choose the fabric discovery interval. The fabric discovery interval is how
often the SANsurfer Switch Manager application receives information from the fabric. Choose 30 (default), 45, or 60 seconds. The smaller the interval, the more often the application talks to the switch and thus the greater impact to performance.
Enable (default) or disable the view file auto save and load feature. Refer to
”Exiting SANsurfer Switch Manager” on page 2-10 for more information on
the default fabric view file.
Enable (default) or disable the use of the Initial Start Dialog at the beginning
of a SANsurfer Switch Manager session. Refer to ”Starting SANsurfer
Switch Manager” on page 2-8 for information about the Initial Start Dialog.
After a default fabric view file is created, this setting has no effect.
2-14 59056-02 A
Loading...
+ 238 hidden pages