D
Simplify
SANbox2-64 Switch Management
User’s Guide
59048-04 Rev. B Page i
SANbox2-64 Switch Management
User’s Guide
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, 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.
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.
D
Document Revision History
Release, Revision A, November 2003
Release, Revision B, January 2004
© 2000–2004 QLogic Corporation
First Printed: May 2002
All Rights Reserved Worldwide.
Printed in U.S.A.
Page ii 59048-04 Rev. B
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 SANbox Manager
2.1 Installing SANbox Manager................................................................................2-1
2.1.1 SANsurfer Management Suite Disk - Windows Installation....................... 2-2
2.1.2 SANsurfer Management Suite Disk - Linux Installation............................. 2-3
2.1.3 SANsurfer Management Suite Disk - Solaris Installation .......................... 2-4
2.2 Starting SANsurfer Management Suite .............................................................. 2-5
2.3 Exiting SANsurfer Management Suite................................................................ 2-6
2.4 Uninstalling SANsurfer Management Suite........................................................ 2-8
2.4.1 SANbox Manager Installation Disk - Windows Installation........................ 2-8
2.4.2 SANbox Manager Installation Disk - Linux Installation.............................. 2-9
2.4.3 SANbox Manager Installation Disk - Solaris Installation............................ 2-9
2.5 Starting SANbox Manager................................................................................ 2-10
2.6 Exiting SANbox Manager ................................................................................. 2-11
2.7 Uninstalling SANbox Manager ......................................................................... 2-13
2.8 Changing the Encryption Key for the Default Fabric View File......................... 2-13
2.9 Saving and Opening Fabric View Files ............................................................ 2-14
2.10 Setting SANbox Manager Preferences ............................................................ 2-14
2.11 Using Online Help ............................................................................................ 2-16
2.12 Viewing Software Version and Copyright Information ...................................... 2-16
2.13 SANbox Manager User Interface ..................................................................... 2-17
2.13.1 Menu Bar................................................................................................. 2-18
2.13.1.1 Topology Display Menu .................................................................. 2-18
2.13.1.2 Faceplate Display Menu ................................................................. 2-19
2.13.1.3 Topology Display Shortcut Keys..................................................... 2-20
2.13.1.4 Faceplate Display Shortcut Keys.................................................... 2-21
2.13.2 Tool Bar ................................................................................................... 2-22
2.13.3 Fabric Tree .............................................................................................. 2-23
59048-04 Rev. B Page iii
SANbox2-64 Switch Management
User’s Guide
2.13.4 Graphic Window ...................................................................................... 2-24
2.13.5 Data Window and Tabs............................................................................ 2-24
2.13.6 Working Status Indicator.......................................................................... 2-24
2.14 Using the Topology Display.............................................................................. 2-25
2.14.1 Switch and Link Status ............................................................................ 2-25
2.14.2 Working with Switches and Links ............................................................ 2-26
2.14.2.1 Selecting Switches and Links ......................................................... 2-26
2.14.2.2 Arranging Switches in the Display .................................................. 2-26
2.14.3 Opening the Faceplate Display and Topology Popup Menus.................. 2-27
2.14.4 Topology Data Windows.......................................................................... 2-27
2.15 Using the Faceplate Display............................................................................. 2-28
2.15.1 I/O Blades................................................................................................ 2-29
2.15.2 Port Views and Status ............................................................................. 2-29
2.15.3 Working with I/O Blades and Ports.......................................................... 2-29
2.15.3.1 Selecting I/O Blades and Ports....................................................... 2-29
2.15.3.2 Opening the Faceplate Popup Menu.............................................. 2-30
2.15.4 Faceplate Data Windows......................................................................... 2-30
D
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-3
3.2 Managing the Fabric Database .......................................................................... 3-3
3.2.1 Adding a Fabric ......................................................................................... 3-3
3.2.2 Removing a Fabric .................................................................................... 3-4
3.2.3 Opening a Fabric View File ....................................................................... 3-4
3.2.4 Saving a Fabric View File.......................................................................... 3-5
3.2.5 Rediscovering a Fabric.............................................................................. 3-5
3.2.6 Adding a New Switch to a Fabric............................................................... 3-5
3.2.7 Replacing a Failed Switch ......................................................................... 3-6
3.2.8 Deleting Switches and Links...................................................................... 3-7
3.3 Displaying Fabric Information.............................................................................3-7
3.3.1 Fabric Status.............................................................................................. 3-7
3.3.2 Displaying the Event Browser.................................................................... 3-9
3.3.2.1 Filtering the Event Browser ............................................................ 3-11
3.3.2.2 Sorting the Event Browser.............................................................. 3-12
3.3.2.3 Saving the Event Browser to a File ................................................ 3-12
3.3.3 Active Zone Set Data Window................................................................. 3-12
Page iv 59048-04 Rev. B
SANbox2-64 Switch Management
D
3.4 Zoning a Fabric ................................................................................................ 3-13
3.4.1 Zoning Concepts ..................................................................................... 3-13
3.4.1.1 Zones.............................................................................................. 3-14
3.4.1.2 Aliases ............................................................................................ 3-15
3.4.1.3 Zone Sets ....................................................................................... 3-15
3.4.1.4 Zoning Database ............................................................................ 3-15
3.4.1.5 Zoning Configuration ...................................................................... 3-16
3.4.2 Using the Zoning Config Dialog............................................................... 3-17
3.4.2.1 FC-SW-2 Auto Save ....................................................................... 3-17
3.4.2.2 Default Visibility .............................................................................. 3-17
3.4.3 Restoring Default Zoning......................................................................... 3-17
3.4.4 Merging Fabrics and Zoning.................................................................... 3-18
3.4.4.1 Zone Merge Failure ........................................................................ 3-18
3.4.4.2 Zone Merge Failure Recovery ........................................................ 3-18
3.4.4.3 Using the Edit Zoning Dialog .......................................................... 3-19
3.4.5 Managing Zone Sets ............................................................................... 3-22
3.4.5.1 Creating a Zone Set .......................................................................3-22
3.4.5.2 Activating and Deactivating a Zone Set.......................................... 3-23
3.4.5.3 Copying a Zone to a Zone Set........................................................ 3-23
3.4.5.4 Removing a Zone from a Zone Set or from All Zone Sets.............. 3-23
3.4.5.5 Removing a Zone Set..................................................................... 3-24
3.4.5.6 Removing All Zoning Definitions..................................................... 3-24
3.4.6 Managing Zones...................................................................................... 3-24
3.4.6.1 Creating a Zone in a Zone Set .......................................................3-25
3.4.6.2 Adding Zone Members ................................................................... 3-26
3.4.6.3 Creating a Member......................................................................... 3-26
3.4.6.4 Renaming a Zone or a Zone Set .................................................... 3-27
3.4.6.5 Removing a Zone Member ............................................................. 3-27
3.4.6.6 Removing a Zone from a Zone Set ................................................ 3-27
3.4.6.7 Removing a Zone from All Zone Sets............................................. 3-27
3.4.6.8 Changing Zone Types .................................................................... 3-28
3.4.7 Managing Aliases .................................................................................... 3-28
3.4.7.1 Creating an Alias ............................................................................ 3-28
3.4.7.2 Adding a Member to an Alias ......................................................... 3-29
3.4.7.3 Removing an Alias from All Zones ................................................. 3-29
3.4.8 Saving the Zoning Database to a File ..................................................... 3-30
User’s Guide
Section 4 Managing Switches
4.1 Managing User Accounts ................................................................................... 4-1
4.1.1 Creating User Accounts............................................................................. 4-3
59048-04 Rev. B Page v
SANbox2-64 Switch Management
User’s Guide
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 Name Server Data Window....................................................................... 4-8
4.2.2 FDMI Data Window ................................................................................... 4-9
4.2.3 Switch Data Window................................................................................ 4-10
4.2.4 Link Data Window.................................................................................... 4-13
4.2.5 Port Statistics Data Window .................................................................... 4-13
4.2.6 Port Information Data Window.................................................................4-14
4.2.7 Configured and Active Zonesets Data Windows ..................................... 4-15
4.3 Configuring Port Threshold Alarms .................................................................. 4-16
4.4 Exporting Name Server Information to a File ................................................... 4-18
4.5 Exporting FDMI Information to a File................................................................ 4-18
4.6 Paging a Switch................................................................................................ 4-18
4.7 Setting the Date and Time................................................................................ 4-18
4.8 Resetting a Switch............................................................................................ 4-19
4.9 Configuring a Switch ........................................................................................ 4-20
4.9.1 Using the Configuration Wizard............................................................... 4-21
4.9.2 Switch Properties..................................................................................... 4-21
4.9.2.1 Symbolic Name .............................................................................. 4-22
4.9.2.2 Switch Administrative States........................................................... 4-22
4.9.2.3 Domain ID and Domain ID Lock ..................................................... 4-23
4.9.2.4 Fabric Device Management Interface............................................. 4-23
4.9.2.5 Broadcast Support.......................................................................... 4-24
4.9.2.6 In-band Management .....................................................................4-24
4.9.2.7 FC-SW-2 Compliance for Zoning.................................................... 4-25
4.9.2.8 Legacy Port Address Format.......................................................... 4-25
4.9.2.9 Timeout Values ............................................................................... 4-25
4.9.3 Network Properties.................................................................................. 4-26
4.9.3.1 IP Configuration.............................................................................. 4-27
4.9.3.2 SNMP Configuration....................................................................... 4-28
4.9.3.3 SNMP Trap Configuration...............................................................4-29
4.9.3.4 Remote Logging ............................................................................. 4-29
4.10 Archiving a Switch............................................................................................ 4-30
4.11 Restoring a Switch ........................................................................................... 4-30
4.12 Restoring the Factory Default Configuration .................................................... 4-32
4.13 Managing Firmware.......................................................................................... 4-34
4.13.1 Installing Firmware .................................................................................. 4-34
D
Page vi 59048-04 Rev. B
SANbox2-64 Switch Management
D
4.13.2 Activating the Pending Firmware............................................................. 4-35
4.13.3 Changing the Pending Firmware............................................................. 4-35
4.13.4 Displaying Hardware Status .................................................................... 4-36
User’s Guide
Section 5 Managing I/O Blades
5.1 Displaying I/O Blade Information........................................................................ 5-1
5.2 Changing the I/O Blade Administrative State ..................................................... 5-2
5.3 Testing an I/O Blade........................................................................................... 5-2
5.4 Resetting an I/O Blade ....................................................................................... 5-3
5.5 Hot Swap Wizard................................................................................................ 5-3
Section 6 Managing Ports
6.1 Displaying Port Information ................................................................................ 6-1
6.1.1 Monitoring Port Status ............................................................................... 6-2
6.1.1.1 Displaying Port Types....................................................................... 6-2
6.1.1.2 Displaying Port Operational States................................................... 6-3
6.1.1.3 Displaying Port Speeds .................................................................... 6-3
6.1.1.4 Displaying Transceiver Media Status................................................ 6-4
6.1.2 Port Statistics Data Window ...................................................................... 6-4
6.1.3 Port Information Data Window...................................................................6-7
6.1.4 Name Server Data Window....................................................................... 6-9
6.2 Configuring Ports.............................................................................................. 6-10
6.2.1 Changing Port Administrative States ....................................................... 6-11
6.2.2 Changing Port Speeds ............................................................................ 6-12
6.2.3 Changing Port Types ............................................................................... 6-12
6.2.4 Changing Interoperability Credits ............................................................ 6-13
6.2.5 Changing Port Symbolic Name ............................................................... 6-14
6.2.6 I/O Stream Guard .................................................................................... 6-14
6.2.7 Scan Device ............................................................................................ 6-14
6.2.8 Extending Port Credits............................................................................. 6-14
6.3 Resetting a Port................................................................................................ 6-16
6.4 Testing Ports..................................................................................................... 6-16
Appendix A Command Line Interface
A.1 Logging On to a Switch ......................................................................................A-1
A.2 User Accounts....................................................................................................A-1
A.3 Working with Switch Configurations...................................................................A-2
A.3.1 Modifying a Configuration..........................................................................A-2
A.3.2 Backing up and Restoring Switch Configurations......................................A-3
A.4 Commands .........................................................................................................A-5
Admin Command.......................................................................................A-7
59048-04 Rev. B Page vii
SANbox2-64 Switch Management
User’s Guide
Alias Command .........................................................................................A-8
Config Command.....................................................................................A-10
Date Command .......................................................................................A-13
Fallback Command..................................................................................A-14
Hardreset Command ...............................................................................A-15
Help Command........................................................................................A-16
History Command....................................................................................A-17
Hotreset Command .................................................................................A-18
Hotswap Command.................................................................................A-19
Image Command.....................................................................................A-21
Lip Command ..........................................................................................A-22
Passwd Command ..................................................................................A-23
Ping Command........................................................................................A-24
Ps Command...........................................................................................A-25
Quit Command ........................................................................................A-26
Reset Command......................................................................................A-27
Set Command..........................................................................................A-32
Set Config Command ..............................................................................A-34
Set Log Command...................................................................................A-44
Set Port Command..................................................................................A-47
Set Setup Command ...............................................................................A-49
Show Command......................................................................................A-53
Show Config Command...........................................................................A-67
Show Log Command...............................................................................A-70
Show Perf Command ..............................................................................A-73
Show Setup Command............................................................................A-75
Shutdown Command...............................................................................A-78
Test Command ........................................................................................A-79
Uptime Command....................................................................................A-82
User Command .......................................................................................A-83
Whoami Command..................................................................................A-86
Zone Command.......................................................................................A-87
Zoneset Command..................................................................................A-91
Zoning Command....................................................................................A-93
D
Appendix B Graphing Port Performance
B.1 Starting SANsurfer Fabric View..........................................................................B-2
B.2 Exiting SANsurfer Fabric View ...........................................................................B-2
B.3 Saving and Opening Fabric View Files ..............................................................B-4
B.4 Changing the Default Fabric View File Encryption Key......................................B-4
Page viii 59048-04 Rev. B
SANbox2-64 Switch Management
D
B.5 Setting SANsurfer Fabric View Preferences ......................................................B-4
B.6 Setting the Polling Frequency ............................................................................B-5
B.7 Displaying Graphs..............................................................................................B-5
B.7.1 Arranging Graphs in the Display................................................................B-6
B.7.2 Customizing Graphs..................................................................................B-6
B.8 Printing Graphs ..................................................................................................B-8
B.9 Rescaling a Selected Graph...............................................................................B-9
B.10 Saving Graph Statistics to a File ........................................................................B-9
User’s Guide
Appendix C Messages
C.1 Fabrics File—Open, Save ..................................................................................C-1
C.2 Add a Fabric .......................................................................................................C-2
C.3 Network Properties Dialog..................................................................................C-3
C.4 Switch Properties Dialog ....................................................................................C-4
C.5 Port Properties Dialog ........................................................................................C-8
C.6 Faceplate Display.............................................................................................C-10
C.7 Firmware Fallback Dialog.................................................................................C-13
C.8 Load Firmware Dialog ......................................................................................C-13
C.9 Port Loopback Test Dialog ...............................................................................C-15
C.10 Extended Credits Wizard..................................................................................C-17
C.11 Zoning Dialog ...................................................................................................C-17
C.12 Restore Configuration Dialog ...........................................................................C-20
C.13 Save Fabric View .............................................................................................C-20
C.14 Trap Configuration Dialog.................................................................................C-21
Glossary
Index
Figures
Figure Page
2-1 Initial Startup Dialog.......................................................................................................2-5
2-2 SANsurfer Window......................................................................................................... 2-6
2-3 Save Default Fabric View File Dialog – SANsurfer ........................................................ 2-7
2-4 Load Default Fabric File Dialog – SANsurfer ................................................................. 2-7
2-5 Initial Startup Dialog..................................................................................................... 2-10
2-6 SANbox Manager Window........................................................................................... 2-11
2-7 Save Default Fabric View File Dialog – SANbox Manager .......................................... 2-12
2-8 Load Default Fabric File Dialog – SANbox Manager ................................................... 2-12
2-9 Preferences Dialog – SANbox Manager ...................................................................... 2-15
2-10 SANbox Manager Display Elements............................................................................ 2-17
2-11 Topology Display Menu................................................................................................2-18
59048-04 Rev. B Page ix
SANbox2-64 Switch Management
User’s Guide
2-12 Faceplate Display Menu............................................................................................... 2-19
2-13 Fabric Tree................................................................................................................... 2-23
2-14 Topology Display..........................................................................................................2-25
2-15 Faceplate Display......................................................................................................... 2-28
3-1 Add a New Fabric Dialog ............................................................................................... 3-3
3-2 Events Browser.............................................................................................................. 3-9
3-3 Filter Events Dialog...................................................................................................... 3-11
3-4 Active Zone Set Data Window .....................................................................................3-13
3-5 Zoning Config Dialog....................................................................................................3-17
3-6 Edit Zoning Dialog........................................................................................................ 3-19
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 Detailed FDMI Display Dialog ...................................................................................... 4-10
4-7 Faceplate Display - Port Information............................................................................4-14
4-8 Configured Zonesets Data Window ............................................................................. 4-15
4-9 Port Threshold Alarm Configuration Dialog.................................................................. 4-16
4-10 Port Threshold Alarm Example .................................................................................... 4-17
4-11 Switch Properties Dialog.............................................................................................. 4-22
4-12 Network Properties Dialog ........................................................................................... 4-26
4-13 Restore Dialogs – Full and Selective ........................................................................... 4-31
4-14 Hardware Status LEDs................................................................................................. 4-36
6-1 Faceplate Display - Port Information..............................................................................6-1
6-2 Port Properties Dialog.................................................................................................. 6-10
6-3 Designate Donor Ports................................................................................................. 6-15
6-4 Port Loopback Test Dialog........................................................................................... 6-16
B-1 Fabric View Graphs........................................................................................................B-1
B-2 Save Default Fabric View File Dialog – SANsurfer Fabric View ....................................B-3
B-3 Load Default Fabric File Dialog – SANsurfer Fabric View .............................................B-3
B-4 Preferences – SANsurfer Fabric View ...........................................................................B-5
B-5 Default Graph Options Dialog ........................................................................................B-7
D
Tables
Table Page
2-1 Management Workstation Requirements....................................................................... 2-1
2-2 Topology Display Menu Shortcut Keys ........................................................................ 2-20
2-3 Faceplate Display Menu Shortcut Keys ....................................................................... 2-21
2-4 Tool Bar Buttons .......................................................................................................... 2-22
3-1 Topology Display Switch and Status Icons .................................................................... 3-8
3-2 Severity Levels............................................................................................................. 3-10
3-3 Edit Zoning Dialog Tool Bar Buttons and Icons ........................................................... 3-21
4-1 Factory User Accounts...................................................................................................4-2
4-2 Name Server Data Window Entries ............................................................................... 4-8
Page x 59048-04 Rev. B
SANbox2-64 Switch Management
D
4-3 FDMI Data Window Entries............................................................................................4-9
4-4 Switch Data Window Entries........................................................................................ 4-10
4-5 Switch Resets .............................................................................................................. 4-20
4-6 Switch Administrative States........................................................................................4-23
4-7 Timeout Values ............................................................................................................ 4-26
4-8 IP Configuration Parameters........................................................................................ 4-27
4-9 SNMP Configuration Parameters................................................................................. 4-28
4-10 SNMP Trap Configuration Parameters ........................................................................ 4-29
4-11 Factory Default Configuration Settings ........................................................................ 4-32
5-1 Blade Information Data Window Entries ........................................................................ 5-1
5-2 Switch Administrative States..........................................................................................5-2
6-1 Port Types...................................................................................................................... 6-2
6-2 Port Operational States.................................................................................................. 6-3
6-3 Port Speeds ...................................................................................................................6-3
6-4 Transceiver Media View................................................................................................. 6-4
6-5 Port Statistics Data Window Entries............................................................................... 6-5
6-6 Port Information Data Window Entries........................................................................... 6-7
6-7 Port Administrative States............................................................................................ 6-11
6-8 Port Speeds .................................................................................................................6-12
6-9 Port Types.................................................................................................................... 6-12
A-1 Command-Line Completion ...........................................................................................A-5
A-2 Commands Listed by Authority Level.............................................................................A-6
A-3 Switch Configuration Defaults ......................................................................................A-28
A-4 Port Configuration Defaults..........................................................................................A-29
A-5 Port Threshold Alarm Configuration Defaults...............................................................A-30
A-6 Zoning Configuration Defaults......................................................................................A-30
A-7 SNMP Configuration Defaults ......................................................................................A-31
A-8 System Configuration Defaults.....................................................................................A-31
A-9 Set Config Port Parameters .........................................................................................A-35
A-10 Set Config Switch Parameters .....................................................................................A-37
A-11 Set Config Threshold Parameters................................................................................A-39
A-12 Set Config Zoning Parameters.....................................................................................A-40
A-13 SNMP Configuration Settings ......................................................................................A-49
A-14 System Configuration Settings.....................................................................................A-50
A-15 Show Port Parameters.................................................................................................A-55
A-16 Zoning Database Limits ...............................................................................................A-94
C-1 Fabrics File – Open, Save Messages ............................................................................C-1
C-2 Add a Fabric Messages .................................................................................................C-2
C-3 Network Properties Dialog Messages............................................................................C-3
C-4 Switch Properties Dialog Messages...............................................................................C-4
C-5 Port Properties Dialog Messages...................................................................................C-8
C-6 Faceplate Display Messages .......................................................................................C-10
C-7 Firmware Fallback Dialog Messages ...........................................................................C-13
C-8 Load Firmware Dialog Messages.................................................................................C-13
C-9 Port Loopback Test Dialog Messages .........................................................................C-15
User’s Guide
59048-04 Rev. B Page xi
SANbox2-64 Switch Management
User’s Guide
C-10 Extended Credits Wizard Messages ............................................................................C-17
C-11 Zoning Dialog Messages..............................................................................................C-17
C-12 Restore Configuration Dialog Messages......................................................................C-20
C-13 Save Fabric View Messages........................................................................................C-20
C-14 Trap Configuration Dialog Messages...........................................................................C-21
D
Page xii 59048-04 Rev. B
Section 1
Introduction
This manual describes the switch management tools which include the SANbox
Manager™ application (version 4.00) and the Command Line Interface (CLI) for
the SANbox2®-64 Fibre Channel switch (firmware version 4.0). The SANbox
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 SANbox Manager, its menus, and its
displays.
Section 3 describes fabric management tasks.
Section 4 describes switch management tasks.
Section 5 describes I/O blade management tasks.
Section 6 describes port and device management tasks.
Appendix A describes the command line interface.
Appendix B describes the performance monitoring application, Fabric View.
Appendix C describes the SANbox Manager error messages.
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 manual for information about switch hardware and
installation.
SANbox2-64 Fibre Channel Switch Installation Guide, publication number
59043-04 Rev. B.
59048-04 Rev. B 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
D
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 59048-04 Rev. B
D
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
Address: QLogic Corporation
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: http://support.qlogic.com
6321 Bury Drive
Eden Prairie, Minnesota 55346-1739
USA
support@qlogic.com
tech.training@qlogic.com
59048-04 Rev. B 1-3
1 – Introduction
Technical Support
Notes
D
1-4 59048-04 Rev. B
Section 2
Using SANbox Manager
This section describes how to use the SANbox Manager application and its
menus. The following topics are covered:
Installing SANbox Manager
Starting SANbox Manager
Exiting SANbox Manager
Uninstalling SANbox Manager
Changing the encryption key for the default fabric view file
Saving and opening fabric view files
Setting SANbox Manager user preferences
Using online help
Viewing software version and copyright information
SANbox Manager user interface
Using the topology display
Using the faceplate display
2.1
Installing SANbox Manager
The SANbox Manager application requires a management workstation with the
characteristics described in Table 2-1.
Table 2-1. Management Workstation Requirements
Operating System
Memory 256 MB or more
Disk Space 150 MB per installation
Processor 300 MHz or faster
Hardware CD-ROM drive, RS-232 serial port, RJ-45 Ethernet port
Internet Browser Microsoft® Internet Explorer®, Netscape Navigator®, or Mozilla™
Windows® NT/2000/2003
Linux® 7.2 Red Hat®, Gnome™ 1.4
Solaris™ 2.8/2.9, CDE
59048-04 Rev. B 2-1
2 – Using SANbox Manager
Installing SANbox Manager
Your switch was shipped with either a SANsurfer Management Suite Disk or a
SANbox2 Installation Disk. Refer to the following installation instructions that
correspond to your situation:
SANsurfer Management Suite Disk - Windows Installation
SANsurfer Management Suite Disk - Linux Installation
SANsurfer Management Suite Disk - Solaris Installation
SANbox Manager Installation Disk - Windows Installation
SANbox Manager Installation Disk - Linux Installation
SANbox Manager Installation Disk - Solaris Installation
2.1.1
SANsurfer Management Suite Disk - Windows Installation
To install the SANsurfer application on Windows from the SANsurfer®
Management Suite Disk, do the following:
1. Close all programs currently running, and 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:
D
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 (2Gb) 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 have a choice of running the installation file from the CD-ROM or
downloading the installation file to your hard drive. Choose one of the
following:
Open the installation file from the CD-ROM and follow the SANbox
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 SANsurfer installation instructions.
2-2 59048-04 Rev. B
2 – Using SANbox Manager
D
2.1.2
Installing SANbox Manager
SANsurfer Management Suite Disk - Linux Installation
To install the SANsurfer application on Linux from the SANsurfer Management
Suite Disk, do the following:
1. Insert the SANsurfer Management Suite Disk into the management
workstation CD-ROM drive. 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
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 (2Gb) 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:
./sansurfer_linux_install.bin
9. Follow the SANsurfer installation instructions.
59048-04 Rev. B 2-3
2 – Using SANbox Manager
Installing SANbox Manager
2.1.3
SANsurfer Management Suite Disk - Solaris Installation
To install the SANsurfer 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.
D
3. On the SANbox Switch Software page, scroll to the SANbox2 (2Gb) 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
command:
chmod +x sansurfer_solaris_install.bin
8. Execute the install program:
./sansurfer_solaris_install.bin
9. Follow the SANsurfer installation instructions.
Note: If you download SANsurfer from a server, be sure the downloaded file
has execute permission before installing.
2-4 59048-04 Rev. B
D
2.2
Starting SANsurfer Management Suite
To start the SANsurfer application for the first time, choose one of the following
methods:
For a Windows platform, double-click the SANsurfer shortcut, or select
SANsurfer from Start menu, depending on how you installed the SANsurfer
application. From a command line, you can enter the SANsurfer command:
<install_directory>\SANsurfer.exe
For a Linux platform, enter the SANbox_Manager command:
<install_directory>/SANsurfer
For a Solaris platform, enter the SANbox_Manager command:
<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 SANbox Manager Preferences” on page 2-14 for information
about setting preferences.
2 – Using SANbox Manager
Starting SANsurfer Management Suite
Note: If a preferences file exists with the Display Initial Startup Dialog
preference disabled, the Initial Start dialog will not be displayed.
Figure 2-1. Initial Startup Dialog
59048-04 Rev. B 2-5
2 – Using SANbox Manager
Exiting SANsurfer Management Suite
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-3.
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-4.
Click the Start Application Without Specifying a Fabric radio button to
open the SANbox Manager window shown in Figure 2-6.
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.
D
Figure 2-2. SANsurfer Window
2.3
Exiting SANsurfer Management Suite
To exit a SANsurfer application session, open the File menu and select Exit. If an
encryption key has been defined, the current fabric view is automatically saved to
your default fabric view file upon exit. The encryption key is used to encrypt the
sensitive data in the default fabric view file.
If you have not yet defined an encryption key, the Save Default Fabric View File
dialog, shown in Figure 2-7, prompts you to save the current fabric view as 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.
2-6 59048-04 Rev. B
D
2 – Using SANbox Manager
Exiting SANsurfer Management Suite
In the Save Default Fabric View File dialog, 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.
To prevent SANbox Manager from prompting you to save the default fabric view
file between SANbox Manager sessions, set the View File Auto Save and Load
preferences setting to Enable (default). Refer to ”Setting SANbox Manager
Preferences” on page 2-14 for more information.
Figure 2-3. Save Default Fabric View File Dialog – SANsurfer
In your next SANbox 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 SANbox Manager with no fabric displayed.
Figure 2-4. Load Default Fabric File Dialog – SANsurfer
59048-04 Rev. B 2-7
2 – Using SANbox Manager
Uninstalling SANsurfer Management Suite
2.4
Uninstalling SANsurfer Management Suite
A program to uninstall SANsurfer was installed as part of the SANsurfer
installation process. The Uninstall Data folder in the <install_directory> contains
the uninstall program (Uninstall SANsurfer).
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 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 SANbox Manager
application. Double-click the uninstall program file or shortcut/link, and follow
the instructions to uninstall the SANbox Manager application.
D
For Linux, execute the link to SANsurfer Uninstall.
<install_directory>/UninstallerData/SANsurferUninstaller
For Solaris, enter the following command and follow the instructions to
uninstall the SANsurfer application:
<install_directory>/UninstallData/SANsurferUninstaller
2.4.1
SANbox Manager Installation Disk - Windows Installation
To install the SANbox Manager application on Windows from the SANbox
Manager Installation Disk, do the following:
1. Close all programs currently running, and insert the SANbox Manager
Installation Disk into the management workstation CD-ROM drive.
2. Using Windows Explorer, double-click the drive letter which contains the
SANbox2 Installation Disk.
3. Double click the SANbox_Manager folder, then double click the Windows
folder.
4. Double click the executable file and follow the SANbox Manager installation
instructions.
2-8 59048-04 Rev. B
2 – Using SANbox Manager
D
2.4.2
Uninstalling SANsurfer Management Suite
SANbox Manager Installation Disk - Linux Installation
To install the SANbox Manager application on Linux from the SANbox Manager
Installation Disk, do the following:
1. Insert the SANbox2 Installation Disk into the management workstation
CD-ROM drive. If a file browser does not open, double-click the CD-ROM
icon to open the browser. Double click the SANbox_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/SANbox_Manager/Linux
2. Execute the install program and follow the SANbox Manager installation
instructions.
2.4.3
SANbox Manager Installation Disk - Solaris Installation
To install the SANbox Manager application on Solaris from the SANbox Manager
Installation Disk, do the following:
1. Insert the SANbox2 Installation Disk into the management workstation
CD-ROM drive.
2. Open a terminal window. If the disk isn’t already mounted, enter the
following command:
volcheck
3. Move to the directory on the disk that contains the executable. Enter the
following command:
cd cdrom/cdrom0/sanbox_manager/solaris
4. Run the executable and follow the SANbox Manager installation instructions.
Enter the following command:
pkgadd -d sol_pkg
59048-04 Rev. B 2-9
2 – Using SANbox Manager
Starting SANbox Manager
2.5
Starting SANbox Manager
To start the SANbox Manager application for the first time, choose one of the
following methods:
For a Windows platform, double-click the SANbox Manager shortcut, or
select SANbox Manager from Start menu, depending on how you installed
the SANbox Manager application. From a command line, you can enter the
SANbox_Manager command:
<install_directory>SANbox_Manager.exe
For a Linux platform, enter the SANbox_Manager command:
<install_directory>SANbox_Manager
For a Solaris platform, enter the SANbox_Manager command:
<install_directory>SANbox_Manager
The application opens with the Initial Start dialog shown in Figure 2-5. 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 SANbox Manager Preferences” on page 2-14 for information about
setting preferences.
D
Figure 2-5. Initial Startup Dialog
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.
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-3.
2-10 59048-04 Rev. B
D
2 – Using SANbox Manager
Exiting SANbox 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-4.
Click the Start Application Without Specifying a Fabric radio button to
open the SANbox Manager window without displaying any fabric, as shown
in Figure 2-6.
Figure 2-6. SANbox Manager Window
2.6
Exiting SANbox Manager
To exit a SANbox 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-7, 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.
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 setting is set
to Enable, the current fabric view is automatically saved to your default fabric view
file upon exit future SANbox Manager sessions.
59048-04 Rev. B 2-11
2 – Using SANbox Manager
Exiting SANbox Manager
To prevent SANbox Manager from prompting you to save the default fabric view
file between SANbox Manager sessions, set the View File Auto Save and Load
preferences setting to Enable (default). Refer to ”Setting SANbox Manager
Preferences” on page 2-14 for more information.
Figure 2-7. Save Default Fabric View File Dialog – SANbox Manager
In your next SANbox Manager session, the Load Default Fabric File dialog shown
in Figure 2-8 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 SANbox Manager with no fabric displayed.
D
Figure 2-8. Load Default Fabric File Dialog – SANbox Manager
2-12 59048-04 Rev. B
D
2.7
Uninstalling SANbox Manager
A program to uninstall SANbox Manager was installed as part of the SANbox
Manager installation process. The Uninstaller Data folder in the Install folder
contains the uninstall program (Uninstall SANbox Manager). Also, a shortcut/link
to the uninstall program was installed in the installation directory during the
SANbox Manager installation process.
The default installation directories are:
For Windows: C:\Program Files\QLogic_Corporation\SANbox_Manager
For Linux: /opt/QLogic_Corporation/SANbox_Manager
For Solaris: /usr/opt/QLGCsol
To uninstall the SANbox 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 SANbox Manager
application. Double-click the uninstall program file or shortcut/link, and follow
the instructions to uninstall the SANbox Manager application.
2 – Using SANbox Manager
Uninstalling SANbox Manager
For Linux, execute the link to Uninstall_SANbox_Manager. If no links were
created during the installation, enter the following command:
<install_directory>UninstallerData/Uninstall_SANbox_Manager
For Solaris, enter the following command and follow the instructions to
uninstall the SANbox Manager application:
pkgrm QLGCsol
2.8
Changing the Encryption Key for the Default Fabric View File
To change the encryption key for the SANbox 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.
59048-04 Rev. B 2-13
2 – Using SANbox Manager
Saving and Opening Fabric View Files
2.9
Saving and Opening Fabric View Files
A fabric view file is one or more fabrics saved to a file. In addition to the SANbox
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 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 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 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.
D
2. Enter a name for the fabric file or click the Browse button to select an
existing file.
3. If the fabric file was saved with a password, enter the password and click the
OK button.
4. Click the OK button to open the view.
2.10
Setting SANbox 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 SANbox 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 SANbox Manager” on page 2-11 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 SANbox Manager session. Refer to ”Starting SANbox Manager” on
page 2-10 for information about the Initial Start Dialog. After a default fabric
view file is created, this setting has no effect.
2-14 59048-04 Rev. B
Loading...