How it Works
Q-Logic
Loading...
59022-11 A
User Manual
322 pgs2.1 Mb0
Table of contents
Loading...

Q-Logic 59022-11 A User Manual

Download
0
Simplify
SANbox2-8c/16 Switch Management
User’s Guide
Firmware Version 5.0
59022-11 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.
This product is covered by one or more of the following patents: 6697359; other patents pending.
QLogic, SANsurfer Switch Manager, SANbox, SANbox2, SANsurfer, and SANblade are trademarks or registered trademarks of QLogic Corporation.
Gnome is a trademark of the GNOME Foundation Corporation. Java and Solaris are registered trademarks of Sun Microsystems, Inc. Linux is a registered trademark of Linus Torvalds. Mac OS X and Safari are registered trademarks of Apple Computer, Inc. Microsoft, Windows NT, and Windows 2000, and Internet Explorer are trademarks of Microsoft Corporation. Netscape Navigator and Mozilla are trademarks or 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, February 2005
© 2000–2005 QLogic Corporation
First Printed: May 2001
All Rights Reserved Worldwide.
Printed in U.S.A.
Page ii 59022-11 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 Workstation Requirements................................................................................. 2-2
2.2 Installing the Management Application............................................................... 2-2
2.2.1 SANsurfer Switch Manager ....................................................................... 2-3
2.2.2 SANsurfer Management Suite................................................................... 2-4
2.2.2.1 SMS Installation for Windows........................................................... 2-4
2.2.2.2 SMS Installation for Linux................................................................. 2-6
2.2.2.3 SMS Installation for Solaris...............................................................2-7
2.3 Starting SANsurfer Switch Manager................................................................... 2-9
2.4 Exiting SANsurfer Management Suite.............................................................. 2-12
2.5 Uninstalling SANsurfer Switch Manager .......................................................... 2-13
2.5.1 SMS Uninstall.......................................................................................... 2-14
2.5.2 Standalone Uninstall................................................................................ 2-15
2.6 Changing the Encryption Key for the Default Fabric View File......................... 2-15
2.7 Saving and Opening Fabric View Files ............................................................ 2-16
2.8 Setting SANsurfer Switch Manager Preferences ............................................. 2-16
2.9 Using Online Help ............................................................................................ 2-18
2.10 Viewing Software Version and Copyright Information ...................................... 2-18
59022-11 A Page iii
2.11 SANsurfer Switch Manager User Interface ...................................................... 2-19
2.11.1 Menu Bar................................................................................................. 2-20
2.11.1.1 Topology Display Menu .................................................................. 2-20
2.11.1.2 Faceplate Display Menu ................................................................. 2-21
2.11.1.3 Shortcut Keys ................................................................................. 2-21
2.11.2 Tool Bar ................................................................................................... 2-22
2.11.3 Fabric Tree .............................................................................................. 2-23
2.11.4 Graphic Window ...................................................................................... 2-24
2.11.5 Data Window and Tabs............................................................................ 2-24
2.11.6 Working Status Indicator.......................................................................... 2-24
2.12 Using the Topology Display.............................................................................. 2-25
2.12.1 Switch and Link Status ............................................................................ 2-25
2.12.2 Working with Switches and Links ............................................................ 2-26
2.12.2.1 Selecting Switches and Links ......................................................... 2-26
2.12.2.2 Arranging Switches in the Display .................................................. 2-26
2.12.3 Opening the Faceplate Display and Topology Popup Menus.................. 2-27
2.12.4 Topology Data Windows.......................................................................... 2-27
2.13 Using the Faceplate Display............................................................................. 2-28
2.13.1 Port Views and Status ............................................................................. 2-28
2.13.2 Working with Ports...................................................................................2-29
2.13.2.1 Selecting Ports................................................................................2-29
2.13.2.2 Opening the Faceplate Popup Menu.............................................. 2-30
2.13.3 Faceplate Data Windows......................................................................... 2-31
0
Section 3 Managing Fabrics
3.1 RADIUS Servers ................................................................................................ 3-1
3.1.1 Adding a RADIUS Server .......................................................................... 3-2
3.1.2 Removing a RADIUS Server ..................................................................... 3-4
3.1.3 Editing RADIUS Server Information .......................................................... 3-5
3.1.4 Modifying Authentication Order RADIUS Server Information.................... 3-6
Page iv 59022-11 A
SANbox2-8c/16 Switch Management
0
3.2 Securing a Fabric ............................................................................................... 3-7
3.2.1 Connection Security .................................................................................. 3-7
3.2.2 User Account Security............................................................................... 3-8
3.2.3 Security Consistency Checklist ................................................................. 3-8
3.2.4 Device Security..........................................................................................3-9
3.2.4.1 Edit Security Dialog ........................................................................ 3-10
3.2.4.2 Creating a Security Set................................................................... 3-11
3.2.4.3 Create Security Group Dialog......................................................... 3-12
3.2.4.4 Creating a Security Group .............................................................. 3-13
3.2.4.5 Create Security Group Member Dialog........................................... 3-14
3.2.4.6 Creating a Security Group Member................................................ 3-15
3.2.4.7 Editing the Security Configuration on a Switch............................... 3-16
3.2.4.8 Viewing Properties of a Security Set, Group, or Member............... 3-17
3.2.4.9 Using the Security Config Dialog.................................................... 3-17
3.2.4.10 Archiving a Security Configuration to a File.................................... 3-18
3.2.4.11 Activating a Security Set................................................................. 3-18
3.2.4.12 Deactivating a Security Set ............................................................ 3-18
3.2.4.13 Configured Security Data Window.................................................. 3-19
3.2.4.14 Active Security Data Window..........................................................3-19
3.2.5 Fabric Services........................................................................................ 3-19
3.2.5.1 Enabling SNMP Configuration........................................................ 3-19
3.2.5.2 Enabling In-band Management ......................................................3-20
3.3 Tracking Fabric Firmware and Software Versions............................................ 3-20
3.3.1 Saving a Version Snapshot ..................................................................... 3-20
3.3.2 Viewing and Comparing Version Snapshots............................................3-21
3.3.3 Exporting Version Snapshots to a File..................................................... 3-21
3.4 Managing the Fabric Database ........................................................................ 3-22
3.4.1 Adding a Fabric ....................................................................................... 3-22
3.4.2 Removing a Fabric .................................................................................. 3-23
3.4.3 Opening a Fabric View File ..................................................................... 3-23
3.4.4 Saving a Fabric View File........................................................................ 3-24
3.4.5 Rediscovering a Fabric............................................................................ 3-24
3.4.6 Adding a New Switch to a Fabric............................................................. 3-24
3.4.7 Replacing a Failed Switch ....................................................................... 3-25
3.4.8 Deleting Switches and Links.................................................................... 3-26
User’s Guide
59022-11 A Page v
3.5 Displaying Fabric Information...........................................................................3-26
3.5.1 Fabric Status............................................................................................ 3-27
3.5.2 Displaying the Event Browser.................................................................. 3-28
3.5.2.1 Filtering the Event Browser ............................................................3-30
3.5.2.2 Sorting the Event Browser.............................................................. 3-31
3.5.2.3 Saving the Event Browser to a File ................................................ 3-31
3.5.3 Devices Data Window ............................................................................. 3-32
3.5.4 Active Zone Set Data Window................................................................. 3-33
3.5.5 Link Data Window.................................................................................... 3-34
3.6 Working with Device Information and Nicknames............................................ 3-34
3.6.1 Displaying Detailed Device Information................................................... 3-34
3.6.2 Exporting Device Information to a File..................................................... 3-35
3.6.3 Managing Device Port Nicknames .......................................................... 3-35
3.6.3.1 Creating a Nickname ...................................................................... 3-35
3.6.3.2 Editing a Nickname......................................................................... 3-36
3.6.3.3 Deleting a Nickname ...................................................................... 3-36
3.6.3.4 Exporting Nicknames to a File........................................................ 3-36
3.6.3.5 Importing a Nicknames File ............................................................ 3-37
0
Page vi 59022-11 A
SANbox2-8c/16 Switch Management
0
3.7 Zoning a Fabric ................................................................................................ 3-37
3.7.1 Zoning Concepts ..................................................................................... 3-37
3.7.1.1 Zones.............................................................................................. 3-38
3.7.1.2 Aliases ............................................................................................ 3-39
3.7.1.3 Zone Sets ....................................................................................... 3-39
3.7.1.4 Zoning Database ............................................................................ 3-40
3.7.2 Using the Zoning Wizard ......................................................................... 3-41
3.7.3 Managing the Zoning Database .............................................................. 3-41
3.7.3.1 Editing the Zoning Database .......................................................... 3-42
3.7.3.2 Configuring the Zoning Database................................................... 3-44
3.7.3.3 Saving the Zoning Database to a File............................................. 3-45
3.7.3.4 Restoring the Zoning Database from a File.................................... 3-46
3.7.3.5 Restoring the Default Zoning Database..........................................3-46
3.7.3.6 Removing All Zoning Definitions..................................................... 3-46
3.7.4 Managing Zone Sets ............................................................................... 3-47
3.7.4.1 Creating a Zone Set .......................................................................3-47
3.7.4.2 Activating and Deactivating a Zone Set.......................................... 3-48
3.7.4.3 Copying a Zone to a Zone Set........................................................ 3-48
3.7.4.4 Removing a Zone from a Zone Set or from All Zone Sets.............. 3-49
3.7.4.5 Removing a Zone Set..................................................................... 3-49
3.7.5 Managing Zones...................................................................................... 3-50
3.7.5.1 Creating a Zone in a Zone Set .......................................................3-50
3.7.5.2 Adding Zone Members ................................................................... 3-51
3.7.5.3 Renaming a Zone or a Zone Set .................................................... 3-52
3.7.5.4 Removing a Zone Member ............................................................. 3-52
3.7.5.5 Removing a Zone from a Zone Set ................................................ 3-52
3.7.5.6 Removing a Zone from All Zone Sets............................................. 3-53
3.7.5.7 Changing Zone Types .................................................................... 3-53
3.7.6 Managing Aliases .................................................................................... 3-53
3.7.6.1 Creating an Alias ............................................................................ 3-54
3.7.6.2 Adding a Member to an Alias ......................................................... 3-54
3.7.6.3 Removing an Alias from All Zones ................................................. 3-55
3.7.7 Merging Fabrics and Zoning.................................................................... 3-55
3.7.7.1 Zone Merge Failure ........................................................................ 3-55
3.7.7.2 Zone Merge Failure Recovery ........................................................ 3-56
User’s Guide
59022-11 A Page vii
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-12
4.2.4 Port Information Data Window.................................................................4-13
4.2.5 Configured and Active Zonesets Data Window....................................... 4-14
4.3 Configuring Port Threshold Alarms .................................................................. 4-15
4.4 Paging a Switch................................................................................................ 4-16
4.5 Setting the Date/Time and Enabling NTP Client .............................................. 4-17
4.6 Resetting a Switch............................................................................................ 4-17
4.7 Configuring a Switch ........................................................................................ 4-19
4.7.1 Using the Configuration Wizard............................................................... 4-19
4.7.2 Switch Properties..................................................................................... 4-20
4.7.2.1 Symbolic Name .............................................................................. 4-21
4.7.2.2 Switch Administrative States........................................................... 4-21
4.7.2.3 Domain ID and Domain ID Lock ..................................................... 4-22
4.7.2.4 Fabric Device Management Interface............................................. 4-23
4.7.2.5 Broadcast Support.......................................................................... 4-24
4.7.2.6 In-band Management .....................................................................4-24
4.7.3 Advanced Switch Properties.................................................................... 4-25
4.7.3.1 Interop Mode for Zoning ................................................................. 4-25
4.7.3.2 Legacy Port Address Format.......................................................... 4-26
4.7.3.3 Timeout Values ............................................................................... 4-26
4.7.4 System Services Dialog........................................................................... 4-27
4.7.5 Security Consistency Checklist Dialog .................................................... 4-28
4.7.6 Network Properties.................................................................................. 4-29
4.7.6.1 IP Configuration.............................................................................. 4-30
4.7.6.2 Remote Logging ............................................................................. 4-31
4.7.6.3 NTP Client ...................................................................................... 4-31
4.7.7 SNMP Properties..................................................................................... 4-32
4.7.7.1 SNMP Configuration....................................................................... 4-33
4.7.7.2 SNMP Trap Configuration...............................................................4-34
4.8 Archiving a Switch............................................................................................ 4-35
Page viii 59022-11 A
SANbox2-8c/16 Switch Management
0
4.9 Restoring a Switch ........................................................................................... 4-36
4.10 Restoring the Factory Default Configuration .................................................... 4-38
4.11 Downloading a Support File ............................................................................. 4-39
4.12 Installing Firmware ........................................................................................... 4-40
4.13 Displaying Hardware Status ............................................................................. 4-41
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-4
5.1.3 Port Information Data Window...................................................................5-7
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-13
5.2.4 I/O Stream Guard .................................................................................... 5-13
5.2.5 Device Scan ............................................................................................ 5-14
5.2.6 Changing Port Symbolic Name ............................................................... 5-14
5.3 Using the Extended Credits Wizard ................................................................. 5-14
5.4 Resetting a Port................................................................................................ 5-16
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-20
5.6.3 Saving and Opening Performance View Files......................................... 5-21
5.6.4 Changing the Default Performance View File Encryption Key ................ 5-22
5.6.5 Setting SANsurfer Performance Viewer Preferences.............................. 5-22
5.6.6 Setting the Polling Frequency.................................................................. 5-23
5.6.7 Displaying Graphs ................................................................................... 5-23
5.6.7.1 Arranging Graphs in the Display..................................................... 5-24
5.6.7.2 Customizing Graphs ....................................................................... 5-24
5.6.7.3 Setting Global Graph Type ............................................................. 5-26
5.6.7.4 Rescaling a Selected Graph........................................................... 5-26
5.6.8 Saving Graph Statistics to a File.............................................................. 5-26
59022-11 A Page ix
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-2
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
CIM Command ........................................................................................A-11
CIMListener Command............................................................................A-12
CIMSubscription Command.....................................................................A-14
Config Command.....................................................................................A-16
Create Command ....................................................................................A-19
Date Command .......................................................................................A-22
Firmware Install Command......................................................................A-23
Group Command.....................................................................................A-24
Hardreset Command ...............................................................................A-32
Help Command........................................................................................A-33
History Command....................................................................................A-34
Hotreset Command .................................................................................A-35
Image Command.....................................................................................A-36
Lip Command ..........................................................................................A-39
Passwd Command ..................................................................................A-40
Ping Command........................................................................................A-41
Ps Command...........................................................................................A-42
Quit Command ........................................................................................A-43
Reset Command......................................................................................A-44
Security Command..................................................................................A-52
Securityset Command .............................................................................A-56
Set Command..........................................................................................A-58
Set Config Command ..............................................................................A-60
Set Log Command...................................................................................A-71
Set Port Command..................................................................................A-75
Set Setup Command ...............................................................................A-77
Show Command......................................................................................A-87
Show Config Command.........................................................................A-103
Show Log Command.............................................................................A-106
Show Perf Command ............................................................................A-109
Page x 59022-11 A
0
Glossary
Index
SANbox2-8c/16 Switch Management
User’s Guide
Show Setup Command.......................................................................... A-111
Shutdown Command............................................................................. A-115
Test Command ...................................................................................... A-116
Uptime Command..................................................................................A-119
User Command .....................................................................................A-120
Whoami Command................................................................................A-123
Zone Command.....................................................................................A-124
Zoneset Command................................................................................A-128
Zoning Command..................................................................................A-130
59022-11 A Page xi
0

Figures

Figure Page
2-1 Initial Startup Dialog..................................................................................................... 2-10
2-2 SANsurfer Switch Manager Window............................................................................ 2-11
2-3 Save Default Fabric View File Dialog...........................................................................2-12
2-4 Load Default Fabric File Dialog.................................................................................... 2-13
2-5 Preferences Dialog – SANsurfer Switch Manager ....................................................... 2-17
2-6 SANsurfer Switch Manager Display Elements............................................................. 2-19
2-7 Topology Display Menu................................................................................................2-20
2-8 Faceplate Display Menu............................................................................................... 2-21
2-9 Fabric Tree................................................................................................................... 2-23
2-10 Topology Display..........................................................................................................2-25
2-11 Faceplate Display......................................................................................................... 2-28
3-1 Add Server ..................................................................................................................... 3-2
3-2 Remove Server .............................................................................................................. 3-4
3-3 Edit Radius Server Information ...................................................................................... 3-5
3-4 Modify Authentication Order - Radius Server Information.............................................. 3-6
3-5 Edit Security Dialog...................................................................................................... 3-10
3-6 Create Security Group Dialog ...................................................................................... 3-12
3-7 Create a Security Group Member Dialog..................................................................... 3-14
3-8 Security Config Dialog.................................................................................................. 3-17
3-9 Fabric Version Snapshot Analysis Dialog .................................................................... 3-21
3-10 Add a New Fabric Dialog ............................................................................................. 3-22
3-11 Events Browser............................................................................................................ 3-28
3-12 Filter Events Dialog...................................................................................................... 3-30
3-13 Active Zone Set Data Window ..................................................................................... 3-33
3-14 Detailed Devices Display Dialog .................................................................................. 3-34
3-15 Edit Zoning Dialog........................................................................................................ 3-42
3-16 Zoning Config Dialog....................................................................................................3-44
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...........................................................................................................4-7
4-6 Faceplate Display - Port Information............................................................................4-13
4-7 Configured Zonesets Data Window ............................................................................. 4-14
4-8 Port Threshold Alarm Configuration Dialog.................................................................. 4-15
4-9 Port Threshold Alarm Example .................................................................................... 4-16
4-10 Switch Properties Dialog.............................................................................................. 4-20
4-11 Advanced Switch Properties Dialog............................................................................. 4-25
4-12 System Services Dialog ............................................................................................... 4-27
4-13 Network Properties Dialog ........................................................................................... 4-29
4-14 SNMP Properties Dialog .............................................................................................. 4-32
4-15 Restore Dialogs – Full and Selective ........................................................................... 4-36
4-16 Hardware Status LEDs................................................................................................. 4-41
Page xii 59022-11 A
SANbox2-8c/16 Switch Management
0
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 Performance File Dialog ......................................................................... 5-21
5-8 Preferences – SANsurfer Performance Viewer............................................................ 5-22
5-9 Default Graph Options Dialog ...................................................................................... 5-24
User’s Guide

Tables

Table Page
2-1 Workstation Requirements............................................................................................. 2-2
2-2 Tool Bar Buttons .......................................................................................................... 2-22
3-1 Topology Display Switch and Status Icons .................................................................. 3-27
3-2 Severity Levels............................................................................................................. 3-29
3-3 Devices Data Window Entries...................................................................................... 3-32
3-4 Edit Zoning Dialog Tool Bar Buttons and Icons ........................................................... 3-43
4-1 Factory User Accounts...................................................................................................4-2
4-2 Switch Data Window Entries.......................................................................................... 4-8
4-3 Switch Resets .............................................................................................................. 4-18
4-4 Switch Administrative States........................................................................................4-21
4-5 Timeout Values ............................................................................................................ 4-26
4-6 IP Configuration Parameters........................................................................................ 4-30
4-7 SNMP Configuration Parameters................................................................................. 4-33
4-8 SNMP Trap Configuration Parameters ........................................................................ 4-34
4-9 Factory Default Configuration Settings ........................................................................ 4-38
5-1 Port Types...................................................................................................................... 5-2
5-2 Port Operational States.................................................................................................. 5-3
5-3 Port Speeds ...................................................................................................................5-3
5-4 Transceiver Media View................................................................................................. 5-4
5-5 Port Statistics Data Window Entries............................................................................... 5-5
5-6 Port Information Data Window Entries........................................................................... 5-7
5-7 Port Administrative States............................................................................................ 5-11
5-8 Port Speeds .................................................................................................................5-12
5-9 Port Types.................................................................................................................... 5-13
A-1 Command-Line Completion ...........................................................................................A-6
A-2 Commands Listed by Authority Level.............................................................................A-7
A-3 CIM Listener Configuration Parameters.......................................................................A-12
A-4 CIM Subscription Configuration Parameters................................................................A-14
A-5 ISL Group Member Attributes ......................................................................................A-25
A-6 Port Group Member Attributes .....................................................................................A-26
A-7 MS Group Member Attributes ......................................................................................A-27
A-8 Group Member Attributes.............................................................................................A-28
A-9 Switch Configuration Defaults ......................................................................................A-46
59022-11 A Page xiii
A-10 Port Configuration Defaults..........................................................................................A-47
A-11 Port Threshold Alarm Configuration Defaults...............................................................A-48
A-12 Zoning Configuration Defaults......................................................................................A-48
A-13 SNMP Configuration Defaults ......................................................................................A-49
A-14 RADIUS Configuration Defaults...................................................................................A-50
A-15 Services Configuration Defaults...................................................................................A-50
A-16 System Configuration Defaults.....................................................................................A-51
A-17 Security Configuration Defaults....................................................................................A-51
A-18 Set Config Port Parameters .........................................................................................A-60
A-19 Security Configuration Parameters ..............................................................................A-63
A-20 Set Config Switch Parameters .....................................................................................A-63
A-21 Set Config Threshold Parameters................................................................................A-65
A-22 Set Config Zoning Parameters.....................................................................................A-66
A-23 RADIUS Service Settings.............................................................................................A-77
A-24 Switch Services Settings..............................................................................................A-79
A-25 SNMP Configuration Settings ......................................................................................A-81
A-26 System Configuration Settings.....................................................................................A-82
A-27 Show Port Parameters.................................................................................................A-90
A-28 Switch Operational Parameters ...................................................................................A-93
A-29 Zoning Database Limits .............................................................................................A-131
0
Page xiv 59022-11 A
Section 1
Introduction
This manual describes the switch management tools which include the SANsurfer Switch Manager™ application (version 5.00) and the Command Line Interface (CLI) for the SANbox2 Fibre Channel switch (firmware version 5.0). The SANsurfer Switch Manager switch management 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.
SANbox2-8c Fibre Channel Switch Installation Guide, publication number
59042-08 Rev. A.
SANbox2-16 Fibre Channel Switch Installation Guide, publication number
59021-11 Rev. A.
59022-11 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 59022-11 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 SANbox2™ 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.com
support@qlogic.com tech.training@qlogic.com
59022-11 A 1-3
1 – Introduction Technical Support
Notes
0
1-4 59022-11 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:
Workstation Requirements
Installing the Management Application
Starting SANsurfer Switch Manager
Exiting SANsurfer Management Suite
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
59022-11 A 2-1
2 – Using SANsurfer Switch Manager Workstation Requirements
2.1

Workstation Requirements

The requirements for fabric management workstations running SANsurfer Switch Manager are described in Table 2-1:
0
Table 2-1. Workstation Requirements
Operating System
Memory 256 MB or more
Disk Space 150 MB per installation
Processor 500 MHz or faster
Hardware
Internet Browser Microsoft® Internet Explorer® 5.0 and later
Telnet workstations require an RJ-45 Ethernet port or an RS-232 serial port and an operating system with a Telnet client.
2.2
Windows® 2000, 2003, and XPSolaris™ 8, 9, and 10Linux® Red Hat® EL 3.xS.u.S.E® Linux 9.0 EnterpriseMac OS X® 10.3
CD-ROM drive,
Netscape® Navigator® 4.72 and later Mozilla™ 1.02 and later Safari® Java 2 Run Time Environment to support the web applet
RJ-45 Ethernet port, RS-232 serial port (optional)

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-3 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-4 for instructions on how to install and upgrade SANsurfer Management Suite.
2-2 59022-11 A
0
2.2.1

SANsurfer Switch Manager

You can install SANsurfer Switch Manager on a Windows, Linux, Solaris, or Mac OS X workstation. To install the SANsurfer Switch Manager application from the SANsurfer Switch Manager Installation Disk, do the following:
For a Windows platform:
1. Close all programs currently running, and insert the SANsurfer Switch Manager Installation Disk into the management workstation CD-ROM drive.
2. In the upper left corner of the product introduction screen, click Management Software.
3. Locate your platform in the table and click Install.
If the product introduction screen does not open in step 2, open the CD with Windows Explorer and run the installation program with the following path:
data\files\Management_Software\Windows\Windows_5.00.xx.xx.exe
For a Linux platform:
2 – Using SANsurfer Switch Manager
Installing the Management Application
Open the CD and run the installation program with the following path:
data/files/Management_Software/Linux/Linux_5.00.xx.xx.bin
If there is no CD-ROM icon, do the following:
1. Open an xterm or other terminal window.
2. Mount the CD-ROM. From a shell prompt, enter the following:
mount /mnt/cdrom
3. Change directory to the location of the install program:
cd /mnt/cdrom/data/files/Management_Software/Linux
4. Execute the install program and follow the installation instructions.
Linux_5.00.xx.xx.bin
For a Solaris platform:
1. Open a terminal window. If the disk isn’t already mounted, enter the following command:
volcheck
2. Enter following command to move to the directory on the CD that contains the executable:
cd /cdrom/cdrom0/data/files/Management_Software/solaris
3. Execute the install program and follow the installation instructions:
Solaris_5.00.xx.xx.bin
59022-11 A 2-3
2 – Using SANsurfer Switch Manager Installing the Management Application
For a Mac OS X platform:
1. Open the CD and move to the following folder:
data/files/Management_Software/MacOSX
2. Double click the applicaton zip file (MacOSX_5.00.xx_xxxx.zip). This
will place the install program on your desktop.
3. Locate the Install program icon on your desktop, execute it, and follow
the installation instructions.
2.2.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
0
SMS Installation for Solaris
2.2.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.
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 SANbox2-8c/16 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.
2-4 59022-11 A
0
2 – Using SANsurfer Switch Manager
Installing the Management Application
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.
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 (5.00.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_5.00.xx.exe file.
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.
59022-11 A 2-5
2 – Using SANsurfer Switch Manager Installing the Management Application
2.2.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
0
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 SANbox2-8c/16 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.
2-6 59022-11 A
0
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 (5.00.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_5.00.xx.bin file and make the file executable.
chmod +x sansurferswitchmgr_linux_5.02.xx.bin
12. Execute the install program and follow the installation instructions.
./sansurferswitchmgr_linux_5.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.
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.2.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.
59022-11 A 2-7
2 – Using SANsurfer Switch Manager Installing the Management Application
3. On the SANbox Switch Software page, scroll to the SANbox2-8c/16 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.
0
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 (5.00.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_5.00.xx.bin file in a folder and make the file executable.
# chmod +x sansurferswitchmgr_QLGCsol_5.00.xx
12. Install the new SANsurfer Switch Manager package:
# pkgadd -d sansurferswitchmgr_QLGCsol_5.00.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
2-8 59022-11 A
0
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.3

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.
2 – Using SANsurfer Switch Manager
Starting SANsurfer Switch Manager
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, Solaris, or Mac OS X, 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.
59022-11 A 2-9
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:
For Linux or Solaris enter the SANsurfer command:
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.
0
<install_directory>\SANsurfer.exe
<install_directory>./SANsurfer
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 check box. This has the same effect as disabling the Display Initial Startup Dialog preference. Refer to ”Setting SANsurfer Switch Manager Preferences” on page 2-16 for information about setting preferences.
Figure 2-1. Initial Startup Dialog
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-22.
2-10 59022-11 A
0
2 – Using SANsurfer Switch Manager
Starting SANsurfer Switch Manager
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-23.
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
Configuration Wizard to configure a switch, add a new switch, replace/restore a switch, or recover or edit an IP configuration of an existing switch.
Figure 2-2. SANsurfer Switch Manager Window
59022-11 A 2-11
2 – Using SANsurfer Switch Manager Exiting SANsurfer Management Suite
2.4

Exiting SANsurfer Management Suite

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.
0
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-15 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-16 for more information.
2-12 59022-11 A
Loading...
+ 292 hidden pages
Buy Points How it Works FAQ Contact Us Questions and Suggestions Privacy Policy Cookie Policy Terms of Use