Q-Logic SANbox2-64 User Manual

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/2003Linux® 7.2 Red Hat®, Gnome™ 1.4Solaris™ 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
D
2 – Using SANbox Manager
Setting SANbox Manager Preferences
Enable (default) or disable the Event Browser. Refer to ”Displaying the
Event Browser” on page 3-9. If the Event Browser is enabled using the
Preferences dialog, the next time SANbox Manager is started, all events from the switch alarm log will be displayed. If the Event Browser is disabled when SANbox Manager is started and later enabled, only those events from the time the Event Browser was enabled and forward will be displayed.
Choose the default port view when opening the faceplate display. You can
set the faceplate to reflect the current port type (default), port speed, port operational state, or port transceiver media. Regardless of the default port view you choose, you can change the port view in the faceplate display by opening the View menu and selecting a different port view option. Refer to the corresponding subsection for more information:
”Displaying Port Types” on page 6-2
”Displaying Port Operational States” on page 6-3
”Displaying Port Speeds” on page 6-3
”Displaying Transceiver Media Status” on page 6-4
Figure 2-9. Preferences Dialog – SANbox Manager
To set preferences for your SANbox Manager sessions, do the following:
1. Open the File menu, and select Preferences to open the Preferences dialog.
2. Enter or browse for paths to the working directory and browser.
3. In the Application-wide Options area, choose the preferences you want.
4. Click the OK button to save the changes.
59048-04 Rev. B 2-15
2 – Using SANbox Manager Using Online Help
2.11

Using Online Help

Online help is available for the SANbox Manager application and its functions. The two ways to open the online help file are: open the Help menu and select Help Topics, or click the Help button in the tool bar. You can also display context-sensitive help for all SANbox Manager dialogs by clicking the Help button in the dialog.
2.12

Viewing Software Version and Copyright Information

To view SANbox Manager software version and copyright information, open the
Help menu and select About....
D
2-16 59048-04 Rev. B
D
2.13

SANbox Manager User Interface

The SANbox Manager application uses two basic displays to manage the fabric and individual switches: the topology display and the faceplate display. The topology display shows all switches that are able to communicate and all connections between switches. The faceplate display shows the front of a single switch and its ports. Both displays share some common elements as shown in
Figure 2-10.
2 – Using SANbox Manager
SANbox Manager User Interface
Topology
Display
Fabric
Tree
Faceplate
Display
Menu
Bar
Data Window
Tabs
Tool Bar
Graphic Window
Data
Window
Working Status
Indicator
Figure 2-10. SANbox Manager Display Elements
59048-04 Rev. B 2-17
2 – Using SANbox Manager SANbox Manager User Interface
2.13.1

Menu Bar

The SANbox Manager menus and the tasks offered in them vary depending on the display. For example, the Port menu and many of the Switch menu selections are only available in the faceplate display.
2.13.1.1
Topology Display Menu
The menu options in the topology display are shown below.
D
Figure 2-11. Topology Display Menu
2-18 59048-04 Rev. B
D
2.13.1.2
Faceplate Display Menu
The menu options in the faceplate display are shown below.
2 – Using SANbox Manager
SANbox Manager User Interface
Figure 2-12. Faceplate Display Menu
The keyboard shortcut keys vary by display type: topology display and faceplate display. In addition to the menu bar, both the topology and faceplate displays have context sensitive menus that pop up when you right-click on the switches and links in the topology display, and on the switch image in the faceplate display. Refer to
”Opening the Faceplate Display and Topology Popup Menus” on page 2-27 for
more information about these popup menus.
59048-04 Rev. B 2-19
2 – Using SANbox Manager SANbox Manager User Interface
2.13.1.3
Topology Display Shortcut Keys
The shortcut keys for the topology display are below. The shortcut key combinations are not case-sensitive.
Table 2-2. Topology Display Menu Shortcut Keys
Shortcut Selection Shortcut Selection
D
Ctrl+O Alt+F, O
Alt+F, A File>Save View As Alt+S, P Switch>Switch Properties
Alt+F, D File>Save Default Fabric
Alt+F, R File>Preferences Alt+W, C Wizards> Configuration Wizard
Alt+F, X File>Exit Alt+V, RF5View>Refresh
Alt+B, A Fabric>Add Fabric Alt+V, L View>Layout Topology
Alt+B, R Fabric>Remove Fabric Alt+V, A View>Toggle Auto Layout
Alt+B, D Fabric>Rediscover Fabric Alt+V, M View>Remember Layout
Alt+B, T Fabric>Start Fabric View Alt+H, H Help>Help Topics
Alt+B, E Fabric>Show Event Browser Alt+H, A Help>About
Alt+S, D Switch>Delete
File>Open View File Alt+S, E Switch>Export Name Server
(active only when one switch is selected)
Alt+S, N Switch>Network Properties
View File
(active only when one switch is selected)
2-20 59048-04 Rev. B
D
2.13.1.4
Faceplate Display Shortcut Keys
The shortcut keys for the faceplate displays are shown in below. The shortcut key combinations are not case-sensitive.
Table 2-3. Faceplate Display Menu Shortcut Keys
Shortcut Selection Shortcut Selection
2 – Using SANbox Manager
SANbox Manager User Interface
Ctrl+O Alt+F, O
Alt+F, A File>Save View As Alt+S, S Switch>Restore Factory
Alt+F, D File>Save Default Fabric
Alt+F, R File>Preferences Alt+P, 2 Port>Port Properties
Alt+F, X File>Exit Alt+P, N Port>Port Symbolic Name
Alt+B, A Fabric>Add Fabric Alt+P, T Port>Reset Port
Alt+B, R Fabric>Remove Fabric Alt+P, L Port>Port Loopback Test
Alt+B, E Fabric>Show Event
Alt+S, A Switch>Archive Alt+Z, C Zoning>Edit Zoning Config
Alt+S, R Switch>Restore Alt+Z, A Zoning>Activate Zone Set
Alt+S, U Switch>User Accounts Alt+Z, D Zoning>Deactivate Zone Set
File>Open View File Alt+S, E
+R +H +A
Alt+S, T Switch>Features
View File
Alt+Z, E Zoning>Edit Zoning
Browser
Switch>Reset Switch Reset Hot reset Hard Reset
Defaults
Alt+S, D Switch>Set Date/Time Alt+Z, R Zoning>Restore Default Zoning
Alt+S, O Switch>Switch Properties Alt+W, C Wizards> Configuration Wizard
Alt+S, N Switch>Network Properties Alt+W, E Wizards> Ext Credit Wizard
Alt+S, G Switch>Toggle Beacon Alt+W, H Wizards> Hotswap Wizard
Alt+S, C Switch>Port Threshold
Alarm Configuration
Alt+S, L Switch>Load Firmware Alt+H, H Help>Help Topics
Alt+S, V Switch>Activate Firmware Alt+H, A Help>About
Alt+S, F Switch>Firmware Fallback
59048-04 Rev. B 2-21
Alt+V, R F5
View>Refresh
2 – Using SANbox Manager SANbox Manager User Interface
2.13.2

Tool Bar

The tool bar consists of a row of graphical buttons that you can use to access SANbox Manager functions as shown in Table 2-4. The tool bar buttons are an alternative method to using the menu bar. The tool bar can be relocated in the display by clicking and dragging the handle at the left edge of the tool bar.
Tool Bar Button Description
D
Table 2-4. Tool Bar Buttons
Add Fabric button - adds a new fabric to the fabric view.
Open View File button - opens an existing fabric view file.
Save View As button - saves the current fabric view to a file.
Refresh button - updates the topology or faceplate display with current information.
Event Browser button - opens the events browser.
Help Topics button - opens the online help file.
Edit Zoning button - opens the Edit Zoning dialog (available only in faceplate display).
The QLogic logo opens a link to the QLogic web site.
2-22 59048-04 Rev. B
D
2.13.3

Fabric Tree

2 – Using SANbox Manager
SANbox Manager User Interface
The fabric tree lists the managed fabrics and their switches as shown in
Figure 2-13. The window width can be adjusted by clicking and dragging the
moveable window border. An entry handle located to the left of an entry in the tree indicates that the entry can be expanded or collapsed. Click this handle or double-click the entry to expand or collapse a fabric tree entry. A fabric entry expands to show its member switches.
Fabric
Entry
Entry Handle
Switch
Entries
Moveable
Window Border
Figure 2-13. Fabric Tree
Each fabric tree entry has a small icon next to it that uses color to indicate operational status.
A green icon indicates normal operation.
A yellow icon indicates that a switch is operational, but may require attention
to maintain maximum performance.
A red icon indicates a potential failure, non-operational state (if switch is
offline), or a switch with user authentication enabled when the fabric management switch has user authentication disabled.
A blue icon indicates that a switch is unknown, unreachable, or
unmanageable.
If the status of the fabric is not normal, the fabric icon in the fabric tree will indicate the reason for the abnormal status. The same message is provided when you rest the mouse over the fabric icon in the fabric tree.
59048-04 Rev. B 2-23
2 – Using SANbox Manager SANbox Manager User Interface
The fabric tree provides access to the topology and faceplate displays for any fabric or switch.
To open the topology display from the fabric tree, click a fabric entry.
To open the faceplate display from the fabric tree, click a switch entry.
2.13.4

Graphic Window

The graphic window, as shown in Figure 2-10, presents graphic information about fabrics and switches such as the fabric topology and the switch faceplate. The window height can be adjusted by clicking and dragging the window border that it shares with the data window. This only works when displaying a fabric.
2.13.5

Data Window and Tabs

The data window presents a table of data and statistics associated with the selected tab. Use the scroll bar to browse through the data. The window length can be adjusted by clicking and dragging the border that it shares with the graphic window.
D
Adjust the column width by moving the pointer over the column heading border shared by two columns until a right/left arrow graphic is displayed. Click and drag the arrow to the desired width.
The data window tabs present options for the type of information to display in the data window. These options vary depending on the display.
2.13.6

Working Status Indicator

The working status indicator, located in the lower right corner of the SANbox Manager window, shows when the management workstation is exchanging information with the fabric. As conditions change, the fabric forwards this information to the management workstation where it is reflected in the various displays.
2-24 59048-04 Rev. B
D
2.14

Using the Topology Display

The topology display shown in Figure 2-14 receives information from the selected fabric and displays its topology. Switches and inter-switch links (ISLs) appear in the graphic window and use color to indicate status. Consider the following topology display features:
Switch and link status
Working with switches and links
Topology data windows
2 – Using SANbox Manager
Using the Topology Display
Figure 2-14. Topology Display
2.14.1

Switch and Link Status

Switch icon shape and color provide information about the switch and its operational state. Lines represent links between switches. The topology display uses green to indicate normal operation, yellow to indicate operational with errors, red to indicate a potential failure or non-operational state, and blue to indicate unknown, unreachable, or unmanageable. Refer to ”Fabric Status” on page 3-7 for more information about topology display icons.
59048-04 Rev. B 2-25
2 – Using SANbox Manager Using the Topology Display
2.14.2

Working with Switches and Links

Switch and link icons are selectable and moveable, and serve as access points for other displays and menus. You select switches and links to display information about them, modify their configuration, or delete them from the display. Context-sensitive popup menus are displayed when you right-click on a switch or link icon, or in the background of the topology display and graphic window.
2.14.2.1
Selecting Switches and Links
Selected switch icons are highlighted in light blue. Selected ISLs are displayed as a heavier line. You can select switches and links in the following ways:
To select a switch or a link, click the icon or link.
To select multiple switches or links, hold down the Control key and select.
To select all switches or links, right-click anywhere in the graphic window
background. Select Select All Switches or Select All Links from the popup menu.
D
To cancel a selection, press and hold the Control key, and select the item again. To cancel all selections, click in the graphic window background.
2.14.2.2
Arranging Switches in the Display
You can arrange individual switch icons in the topology display or allow SANbox Manager to arrange all switch icons for you:
To move an individual switch icon, click and drag the icon to another location
in the graphic window. Links stretch or contract to remain connected.
To arrange all switch icons in the topology display automatically, open the
View menu and select Layout Topology.
By default, the Toggle Auto Layout box in the View menu is checked which causes SANbox Manager to arrange the icons when you select Layout Topology.
You can save a custom arrangement, or layout, and restore that layout during a SANbox Manager session. Begin by arranging the icons, then open the View menu and select Remember Layout. To restore the saved layout, open the View menu, uncheck the Toggle Auto Layout box, and select Layout Topology.
2-26 59048-04 Rev. B
2 – Using SANbox Manager
D
2.14.3
Using the Topology Display

Opening the Faceplate Display and Topology Popup Menus

The faceplate display shows the front of a single switch and its ports. To open the faceplate display when viewing the topology display, click the switch entry/icon in the fabric tree, or double-click the switch graphic.
The topology display also offers a fabric, switch, and a link popup menu:
To open the fabric popup menu, right-click the graphic window background.
The fabric popup menu presents selections to refresh the fabric, select all switches, select all links, or layout topology.
To open the switch popup menu, right-click the switch icon in the graphic
window. The switch popup menu presents selections to refresh the switch, delete the switch from the display, open the Switch Properties dialog, or open the Network Properties dialog.
To open the link popup menu, right-click the link. The Link popup menu
presents a selection to delete the link from the display.
2.14.4

Topology Data Windows

The topology display provides the following data windows corresponding to the data window tabs:
Name Server – displays all devices logged with the name server and their
addresses within the current fabric configuration. Refer to ”Name Server
Data Window” on page 4-8 for more information.
FDMI - displays device information from the fabric and allows end-devices to
register certain information with the fabric. Refer to ”FDMI Data Window” on
page 4-9 for more information.
Active Zoneset – displays the active zone set for the fabric including zones
and their member ports. Refer to ”Active Zone Set Data Window” on
page 3-12 for more information about this data window. Refer to ”Zoning a Fabric” on page 3-13 for information about zone sets and zones.
Switch – displays current network and switch configuration data for the
selected switches. Refer to ”Switch Data Window” on page 4-10 for more information.
Link – displays information about the inter-switch links. Refer to ”Link Data
Window” on page 4-13 to for more information.
59048-04 Rev. B 2-27
2 – Using SANbox Manager Using the Faceplate Display
2.15

Using the Faceplate Display

The faceplate display shown in Figure 2-15 displays the switch name and operational state, and port status. Consider the following functional elements of the faceplate display:
I/O blades
Port views and status
Working with ports
Working with I/O blades and ports
Faceplate data windows
D
Figure 2-15. Faceplate Display
2-28 59048-04 Rev. B
D
2.15.1

I/O Blades

Figure 2-15 shows how slots appear in the faceplate display with and without
installed I/O blades. I/O blade failure status is indicated by a status icon as shown in Figure 2-15. The SANbox2-64 switch numbers its slots from 0–10 from left to right. I/O blades occupy slots 1–4 and 6–9. Ports on an I/O blade are numbered from 0–7 from top to bottom in slot 1, 8–15 in slot 2, and so on to 56–63 in slot 9. The Blade Info data window assigns blade numbers 0–7 to slot numbers 1–4 and 6–9.
2.15.2

Port Views and Status

Port color and text provide information about the port and its operational state. Green indicates active; gray indicates inactive. The faceplate display provides the following views of port status corresponding to the View menu options in the faceplate display. Refer to ”Monitoring Port Status” on page 6-2 for more information about these displays.
2 – Using SANbox Manager Using the Faceplate Display
Port type
Port state
Port speed
Port media
2.15.3

Working with I/O Blades and Ports

I/O blades and ports are selectable and serve as access points for other displays and menus. You select I/O blades and ports to display information about them in their respective data windows or to modify them. Context sensitive popup menus and properties windows are accessible through the I/O blade and port icons.
2.15.3.1
Selecting I/O Blades and Ports
You can select I/O blades and ports in the following ways. Selected blades are highlighted blue.
To select an I/O blade or port, click the I/O blade or port in the faceplate
display.
To select a range of consecutive I/O blades or ports, select an I/O blade or
port, then press and hold the shift key and select another. The application selects both end I/O blades or ports and those in between in sequence.
To select several non-consecutive I/O blades or ports, hold the Control key
while selecting.
59048-04 Rev. B 2-29
2 – Using SANbox Manager Using the Faceplate Display
To select all I/O blades or ports, right-click anywhere in the graphic window.
Select Select All Blades or Select All Ports from the popup menu.
To cancel a selection, press and hold the Control key and select it again.
2.15.3.2
Opening the Faceplate Popup Menu
To open the popup menu, right-click on the faceplate image to present the following tasks.
Refresh the switch
Select all ports
Manage switch properties
Manage network properties
Extended credits wizard
Manage port properties
Change the port symbolic name
D
Run the port loopback tests
Select all blades
Manage blade properties
If no ports are selected, the port-related tasks will be unavailable in the menu. Right-click a port to open the Port popup menu. Hold down the Shift or Control key to select more than one port. If multiple ports are selected, right-click on one of the selected ports.
If no blades or ports are selected, the blade or port-related tasks will be unavailable in the menu. Right-click a blade or port to open the corresponding popup menu. Hold down the Shift or Control key to select more than one blade or port. If multiple blades or ports are selected, right-click on one of the selected blades or ports.
2.15.4

Faceplate Data Windows

The faceplate display provides the following data windows corresponding to the data window tabs:
Name Server – displays all devices connected to the switch that are logged
with the name server.
Switch – displays current switch configuration data.
Port Statistics – displays performance data for the selected ports.
Port Information – displays information for the selected ports.
Blade Information – displays information for the selected I/O blades.
2-30 59048-04 Rev. B
D
2 – Using SANbox Manager Using the Faceplate Display
Configured Zonesets – displays all zone sets, zones, and zone membership
in the zoning database.
59048-04 Rev. B 2-31
2 – Using SANbox Manager Using the Faceplate Display
Notes
D
2-32 59048-04 Rev. B
This section describes the following tasks that manage fabrics:
Securing a fabric
Managing the fabric database
Displaying fabric information
Zoning a fabric
3.1

Fabric Security

The components of Fibre Channel fabric security are:
User account security
Fabric services
3.1.1

User Account Security

User account security is the process by which your user account and password are authenticated with the list of valid user accounts and passwords. The switch validates your account and password when you attempt to add a fabric using SANbox Manager or log in to a switch through Telnet. Your system administrator defines accounts, passwords, and authority levels that are stored on the switch. Refer to ”Managing User Accounts” on page 4-1 for more information.
Section 3
Managing Fabrics
When logging in to a switch through Telnet, you must enter a user account and password to access the switch. SANbox Manager, however, does not require an user account and password to add a fabric unless the UserAuthentication parameter is enabled. The switch comes from the factory with the UserAuthentication parameter disabled. User account security is only configurable using command line interface. Use the Set Setup System command in the command line interface to enable the UserAuthentication parameter to turn on user account security. The UserAuthentication parameter must be configured the same for all switches in the fabric. Refer to the ”Set Setup Command” on
page A-49 for more information.
When you add a fabric and the UserAuthentication parameter is disabled, SANbox Manager ignores the user account and password entries and logs you in using the default user account (Admin). The Admin account possesses Admin authority which grants full access to all tasks of the SANbox Manager menu system. If the UserAuthentication parameter is enabled, you must enter a user account and password. The switch validates your user account and SANbox
59048-04 Rev. B 3-1
3 – Managing Fabrics Fabric Security
Manager grants access to its menus according to your authority level. If you do not have Admin authority, you are limited to monitoring tasks.
Note: If a user is logged into a switch using SANbox Manager or CLI, and an
3.1.2

Fabric Services

Fabric services security includes SNMP and in-band management. Simple Network Management Protocol (SNMP) is the protocol governing network management and monitoring of network devices. SNMP security consists of a read community string and a write community string, that are basically the passwords that control read and write access to the switch. The read community string ("public") and write community string ("private") are set at the factory to these well-known defaults and should be changed if SNMP is enabled using the Network Properties dialog. If SNMP is enabled (default) and the read and write community strings have not been changed from their defaults, you risk unwanted access to the switch. Refer to ”Enabling SNMP Configuration” on page 3-2 for more information. SNMP is enabled by default.
D
administrator changes user access rights, passwords, or UserAuthentication security settings, existing logins will not be affected by the new settings. Login access and privileges are only checked for a new login request.
In-band management is the ability to manage switches across inter-switch links using SANbox Manager, SNMP, management server, or the application programming interface. The switch comes from the factory with in-band management enabled. If you disable in-band management on a particular switch, you can no longer communicate with that switch by means other than a direct Ethernet or serial connection. Refer to ”Enabling In-band Management” on
page 3-3 for more information.
3.1.2.1
Enabling SNMP Configuration
To enable SNMP configuration, do the following:
1. On the faceplate display, open the Switch menu and select Network Properties to open the Network Properties dialog.
2. In the SNMP Configuration area, place a check mark in the SNMP Enabled check box.
3. Click the OK button to save the change to the database.
3-2 59048-04 Rev. B
D
3.1.2.2
Enabling In-band Management
To enable In-band Management, do the following:
1. On the faceplate display, open the Switch menu and select Switch Properties to open the Switch Properties dialog.
2. Click the In-band Management Enable button.
3. Click the OK button to save the change to the database.
3.2

Managing the Fabric Database

A fabric database contains the set of fabrics that you have added during a SANbox Manager session. Initially, if you do not open an existing fabric or fabric view file, the SANbox Manager application opens with an empty fabric database.
3.2.1

Adding a Fabric

To add a fabric to the database, do the following:
3 – Managing Fabrics
Managing the Fabric Database
1. Open the Fabric menu and select Add Fabric to open the Add a New Fabric dialog as shown in Figure 3-1.
Figure 3-1. Add a New Fabric Dialog
2. Enter a fabric name (optional) and the IP address of the switch through which to manage the fabric.
3. Enter an account name and password. The factory login name and password are (admin, password). The password is for the switch and is stored in the switch firmware. If the UserAuthentication parameter is set to False (default), you are not required to enter a login name or password. If you do enter a login name and password when UserAuthentication is set to False, these entries are ignored.
59048-04 Rev. B 3-3
3 – Managing Fabrics Managing the Fabric Database
Refer to ”User Account Security” on page 3-1 for information about
user authentication.
Refer to ”Managing User Accounts” on page 4-1 or the ”User
Command” on page A-83 for information about creating user accounts.
4. Click the Add Fabric button.
Note: A switch supports a combined maximum of 19 logins or sessions
D
reserved as follows:
4 logins or sessions for internal applications such as
management server and SNMP
9 high priority Telnet sessions
6 logins or sessions for SANbox Manager inband and
out-of-band logins, Application Programming Interface (API) inband and out-of-band logins, and Telnet logins. Additional logins will be refused.
3.2.2

Removing a Fabric

To delete a fabric file from the database, do the following:
1. Select a fabric in the fabric tree.
2. Open the Fabric menu and select Remove Fabric.
3.2.3

Opening a Fabric View File

A fabric view file is one or more fabrics saved to a file. To open an existing view file, do the following:
1. Open the File menu and select Open View File, or click the Open button. If the fabric you are currently viewing has changed, you will be prompted to save the changes to the fabric view file with the Save View dialog before opening a different view file.
2. In the Open View dialog, enter the name of the file to open, and enter a file password, if a password was entered when this fabric view file was saved.
3. Click the OK button.
3-4 59048-04 Rev. B
D
3.2.4

Saving a Fabric View File

To save a view file, do the following:
1. Open the File menu, and select Save View As.
2. In the Save View dialog, enter a new file name.
3. Enter a file password, if necessary.
4. Click the OK button.
3.2.5

Rediscovering a Fabric

After making changes to or deleting switches from a fabric view, it may be helpful to again view the actual fabric configuration. The rediscover fabric option clears out the current fabric information being displayed, and rediscovers all switch information. To rediscover a fabric, open the Fabric menu, and select Rediscover Fabric. The rediscover function is more comprehensive than the refresh function.
3 – Managing Fabrics
Managing the Fabric Database
3.2.6

Adding a New Switch to a Fabric

If there are no special conditions to be configured for the new switch, simply plug in the switch and the switch becomes functional with the default fabric configuration. The default fabric configuration settings are:
Fabric zoning is sent to the switch from the fabric.
All ports will be GL_Ports.
The default IP address 10.0.0.1 is assigned to the switch without a gateway
or boot protocol configured (RARP, BOOTP, and DHCP).
If you are adding a new switch to a fabric and do not want to accept the default fabric configuration, do the following:
1. If the switch is not new, reset the switch to the factory configuration before adding the switch to the fabric by selecting Restore Factory Defaults in the Switch menu from the faceplate display.
2. If you want to manage the switch through the Ethernet port, you must first configure the IP address using the Network Properties dialog or the Configuration Wizard.
3. Configure any special switch settings. Consider configuring the Default Visibility setting to None in the Zoning Config dialog to prevent devices from finding other devices on all switches in the fabric until the new switch is configured. To open the Zoning Config dialog, open the Zoning menu, and select Edit Zoning Config.
4. Plug in the inter-switch links (ISL), but do not connect the devices.
59048-04 Rev. B 3-5
3 – Managing Fabrics Managing the Fabric Database
5. Configure the port types for the new switch using the Port Properties dialog. The ports can be G_Port, GL_Port, F_Port, FL_Port, or Donor.
6. Connect the devices to the switch.
7. Make any necessary zoning changes using the Edit Zoning dialog. To open the Edit Zoning dialog, open the Zoning menu, and select Edit Zoning. If you changed the Default Visibility setting in the Zoning Config dialog from All to None, change that setting back to All. To open the Zoning Config dialog, open the Zoning menu, and select Edit Zoning Config.
3.2.7

Replacing a Failed Switch

The archive/restore works for all switches. However, the Restore menu item is not available for the in-band switches. You can only restore a switch out-of-band (the fabric management switch). There are certain parameters that are not archived, and these are not restored by SANbox Manager. Refer to ”Archiving a Switch” on
page 4-30 and ”Restoring a Switch” on page 4-30 for information about archive
and restore. Use the following procedure to replace a failed switch for which an archive is available.
D
1. At the failed switch:
a. Turn off the power and disconnect the AC cords.
b. Note port locations and remove the interconnection cables and SFPs.
c. Remove the failed switch.
2. At the replacement switch:
a. Mount the switch in the location where the failed switch was removed.
b. Install the SFPs using the same ports as were used on the failed
switch.
CAUTION!
c. Attach the AC cords and power up the switch.
3. Select the failed switch in the topology display. Open the Switch menu and select Delete.
4. Restore the configuration from the failed switch to the replacement switch:
a. Open a new fabric through the replacement switch.
Do not reconnect inter-switch links, target devices, and initiator devices at this time. Doing so could invalidate the fabric zoning configuration.
b. Open the faceplate display for the replacement switch. Open the
Switch menu and select Restore.
3-6 59048-04 Rev. B
D
c. In the Restore dialog, enter the archive file from the failed switch or
browse for the file.
d. Click the Restore button.
5. Reset the replacement switch to activate the configuration formerly possessed by the failed switch including the domain ID and the zoning database. Open the Switch menu and select Reset Switch.
6. Reconnect the inter-switch links, target devices, and initiator devices to the replacement switch using the same ports as were used on the failed switch.
3.2.8

Deleting Switches and Links

The SANbox Manager application does not automatically delete switches or links that have failed or have been physically removed from the Fibre Channel network. In these cases, you can delete switches and links to bring the display up to date. If you delete a switch or a link that is still active, the SANbox Manager application will restore it automatically. You can also refresh the display. To delete a switch from the topology display, do the following:
3 – Managing Fabrics

Displaying Fabric Information

1. Select one or more switches in the topology display.
2. Open the Switch menu and select Delete.
To delete a link, do the following:
1. Select one or more links in the topology display.
2. Open the Switch menu and select Delete.
3.3
Displaying Fabric Information
The topology display is your primary tool for monitoring a fabric. The graphic window of the topology display provides status information for switches, inter-switch links, and the Ethernet connection to the management workstation.
The data window tabs show name server, switch, and active zone set information. The Active Zoneset tab shows the zone definitions for the active zone set. Refer to ”Name Server Data Window” on page 4-8 and ”Switch Data Window” on
page 4-10 for information about the Name Server and Switch data windows.
3.3.1

Fabric Status

The fabric updates the topology and faceplate displays by forwarding changes in status to the management workstation as they occur. You can allow the fabric to update the display status, or you can refresh the display at any time. To refresh the topology display, do one of the following:
Click the Refresh button.
Open the View menu and select Refresh.
59048-04 Rev. B 3-7
3 – Managing Fabrics Displaying Fabric Information
Press the F5 key.
Right-click anywhere in the background of the topology display and select
Refresh Fabric from the popup menu.
The topology display uses switch and status icons to provide status information about switches, inter-switch links, and the Ethernet connection. The switch status icons, displayed on the left side of a switch, vary in shape and color. Switches controlled by an Ethernet Internet Protocol have a colored Ethernet icon displayed on the right side of the switch. A green Ethernet icon indicates normal operation, yellow indicates a condition that may require attention to maintain maximum performance, and red indicates a potential failure. Tab le 3- 1 shows the different switch icons and their meanings.
Switch Icon Description
D
Table 3-1. Topology Display Switch and Status Icons
SANbox2-64 switch
Normal operation (Green)Warning–operational with errors (Yellow)Critical–potential failure (Red)Unknown–communication status unknown,
unreachable, or unmanageable (Blue)
Fabric Management Switch
Ethernet connection normal (Green)Ethernet connection warning (Yellow)Ethernet connection critical (Red)
Switch is not manageable with this version of SANbox Manager. Use the management application that was shipped with this switch.
3-8 59048-04 Rev. B
D
3.3.2

Displaying the Event Browser

The Event Browser displays a list of recorded events and alarms generated by the switches in the fabric and the SANbox Manager application. Events are generated by the SANbox Manager application and are not saved on the switch, but can be saved to a file during the SANbox Manager session. An alarm is also an event, but is generated by the switch, stored on the switch, and will be retrieved when restarting the SANbox Manager application. Entries in the Event Browser shown in Figure 3-2, are formatted by severity, time stamp, source, type, and description. The maximum number of entries allowed is 1500. Once the maximum is reached, the event list wraps and the oldest events are discarded and replaced with the new events. Alarm entries have a switch time stamp, while event entries have a workstation time stamp. You can filter, sort, and export the contents of the Event Browser to a file. The Event Browser begins recording when enabled and SANbox Manager is running.
Column Sorting
Buttons
3 – Managing Fabrics
Displaying Fabric Information
Severity
Column
Figure 3-2. Events Browser
If the Event Browser is enabled using the Preferences dialog, the next time SANbox Manager is started all events from the switch alarm log will be displayed. If the Event Browser is disabled when SANbox Manager is started and later enabled, only those events from the time the Event Browser was enabled and forward will be displayed.
To display the Event Browser, open the Fabric menu and select Show Event Browser, or click the Events button on the tool bar. If the Show Event Browser selection or the Events button is grayed-out, you must first enable the Events
59048-04 Rev. B 3-9
3 – Managing Fabrics Displaying Fabric Information
Browser preference. Refer to ”Setting SANbox Manager Preferences” on
page 2-14.
Severity is indicated in the severity column using icons as described in Table 3-2.
Note:  The alarm log is cleared out when the switch is reset or power
D
cycled and that the user should save these log files off if they want to keep the data. Refer to ”Set Log Command” on page A-44 for information about saving the alarm log to a file.
Events (Critical, Warning, Normal, and Informative) are generated
by the application and are not saved on the switch. They are permanently discarded when you close a SANbox Manager session, but you can save these events to a file on the workstation before you close SANbox Manager and read it later with a text editor or browser.
Alarms are generated by the switch, stored on switch, and will be
retrieved when the application is restarted. Some alarms are configurable. Refer to ”Configuring Port Threshold Alarms” on
page 4-16.
Table 3-2. Severity Levels
Severity
Icon
Alarm – An alarm is an event generated by the switch that specifically requests attention.
Critical event – An event generated by the SANbox Manager application and indicates a potential failure.
Warning event – An event generated by the SANbox Manager application that indicates errors or other conditions that may require attention to maintain maximum performance.
Normal event – An event generated by the SANbox Manager application that indicates a transition from a non-normal to normal operation.
No icon Informative – An unclassified event generated by the SANbox Manager
application that provides supporting information.
Description
3-10 59048-04 Rev. B
D
3.3.2.1
Filtering the Event Browser
Filtering the Event Browser enables you to display only those events that are of interest based on the event severity, timestamp, source, type, and description. To filter the Event Browser, open the Filter menu and select Filter Entries. This opens the Filter Events dialog shown in Figure 3-3. The Event Browser displays those events that meet all of the criteria in the Filter Events dialog. If the filtering criteria is cleared or changed, then all the events that were previously hidden that satisfy the new criteria will be shown.
You can filter the event browser in the following ways:
Severity – Check one or more of the corresponding check boxes to display
alarm events, critical events, warning events, normal events, or informative events.
Date/Time – Check one or both of the From: and To: check boxes. Enter the
bounding timestamps (MM/dd/yy hh:mm:ss aa) to display only those events that fall within those times. ("aa" indicates AM or PM.) The current year (yy) can be entered as either 2 or 4 digits. For example, 12/12/03 will be interpreted December 12, 2003.
3 – Managing Fabrics
Displaying Fabric Information
Text – Check one or more of the corresponding check boxes and enter a text
string (case sensitive) for event source, type, and description. The Event Browser displays only those events that satisfy all of the search specifications for the Source, Type, and Description text.
Figure 3-3. Filter Events Dialog
59048-04 Rev. B 3-11
3 – Managing Fabrics Displaying Fabric Information
3.3.2.2
Sorting the Event Browser
Sorting the Event Browser enables you to display the events in alphanumeric order based on the event severity, timestamp, source, type, or description. Initially, the Event Browser is sorted in ascending order by timestamp. To sort the Event Browser, click the Severity, Timestamp, Source, Type, or Description column buttons. You can also open the Sort menu and select By Severity, By Timestamp, By Source, By Type, or By Description. Successive sort operations of the same type alternate between ascending and descending order.
3.3.2.3
Saving the Event Browser to a File
Filtering does affect the save operation; that is, only those events are saved. To save the Event Browser to a file, do the following:
1. Filter and sort the Event Browser to obtain the desired display.
2. Open the File menu and select Save As.
D
3. Select a folder and enter a file name in which to save the event log and click the Save button. The file is saved in XML format and can be opened with an internet browser or a text editor.
3.3.3

Active Zone Set Data Window

The Active Zoneset data window displays the zone membership for the active zone set that resides on the fabric management switch. The active zone set is the same on all switches in the fabric – you can confirm this by adding a fabric through another switch and comparing Active Zone Set displays.
To open the Active Zoneset data window, click the Active Zoneset tab below the data window in the topology display. Refer to ”Configured and Active Zonesets
Data Windows” on page 4-15 for information about the zone set definitions on a
particular switch. Refer to ”Zoning a Fabric” on page 3-13 for more information about zone sets and zones.
The Active Zoneset data window, shown in Figure , uses display conventions for expanding and contracting entries that are similar to the fabric tree. An entry handle located to the left of an entry in the tree indicates that the entry can be expanded. Click this handle or double-click the following entries:
A zone set entry expands to show its member zones.
A zone entry expands to show its member port/devices.
WWN and FC devices that are zoned, but no longer part of the fabric, are
grayed-out.
3-12 59048-04 Rev. B
D
3 – Managing Fabrics

Zoning a Fabric

3.4
Zoning a Fabric
Zoning enables you to divide the ports and devices of the fabric into zones for more efficient and secure communication among functionally grouped nodes. This subsection addresses the following topics:
Zoning concepts
Using the Zoning Config dialog
Restoring default zoning
Using the Edit Zoning dialog
Merging fabrics and zoning
Managing zone sets
Managing zones
Managing aliases
3.4.1

Zoning Concepts

The following zoning concepts provide some context for the zoning tasks described in this section:
Figure 3-4. Active Zone Set Data Window
Zones
Aliases
59048-04 Rev. B 3-13
3 – Managing Fabrics Zoning a Fabric
Zone sets
Zoning database
Zoning configuration
3.4.1.1
Zones
A zone is a named group of ports or devices that can communicate with each other. Devices within a zone can only communicate with other devices in the same zone. A device may participate in more than one zone.
Membership in a zone can be defined by switch domain ID and port number, device Fibre Channel address, or device World Wide Name (WWN).
WWN entries define zone membership by the World Wide Name of the
D
attached device. With this membership method, you can move WWN member devices to different switch ports in different zones without having to edit the member entry as you would with a domain ID/port number member. Furthermore, unlike FCID members, WWN zone members are not affected by changes in the fabric that could change the Fibre Channel address of an attached device.
3.4.1.1.1
Soft Zones
FCID entries define zone membership by the Fibre Channel address of the
attached device. With this membership method you can replace a device on the same port without having to edit the member entry as you would with a WWN member.
Domain ID/Port number entries define zone membership by switch domain
ID and port number. All devices attached to the specified port become members of the zone. The specified port must be an F_Port or an FL_Port.
Two types of zones are supported. The following zone types define increasingly restrictive levels of communication.
Soft zone
Hard zone - Access Control List (ACL)
Soft zoning divides the fabric for purposes of controlling discovery. Devices within the same soft zone automatically discover and communicate freely with all other members of the same zone. The soft zone boundary is not secure; traffic across soft zones can occur if addressed correctly. Soft zones that include members from multiple switches need not include the ports of the inter-switch links. Soft zone boundaries yield to ACL zone boundaries. Soft zones can overlap; that is, a device can participate in more than one soft zone. Zone membership can be defined by Fibre Channel address, domain ID and port number, World Wide Name, or a combination. Soft zoning supports all port types.
3-14 59048-04 Rev. B
D
3.4.1.1.2
Access Control List Hard Zones
Access Control List (ACL) zoning divides the fabric for purposes of controlling discovery and inbound traffic. ACL zoning is a type of hard zoning that is hardware enforced. This type of zoning is useful for controlling access to certain devices without totally isolating them from the fabric. Devices can communicate with each other and transmit outside the ACL zone, but cannot receive inbound traffic from outside the zone. The ACL zone boundary is secure against inbound traffic. ACL zones can overlap; that is, a port can be a member of more than one ACL zone. ACL zones that include members from multiple switches need not include the ports of the inter-switch links. ACL zone boundaries supersede soft zone boundaries. Membership can be defined only by domain ID and port number. ACL zoning supports all port types.
3.4.1.2
Aliases
To make it easier to add a group of ports or devices to one or more zones, you can create an alias. An alias is a named set of ports or devices that are grouped together for convenience. Unlike zones, aliases impose no communication restrictions between its members. You can add an alias to one or more zones. However, you cannot add a zone to an alias, nor can an alias be a member of another alias.
3 – Managing Fabrics
Zoning a Fabric
3.4.1.3
Zone Sets
A zone set is a named group of zones. A zone can be a member of more than one zone set. All zones that are not members of a zone set belong to the orphan zone set. The orphan zone set is saved on the switch. Each switch in the fabric maintains its own zoning database containing one or more zone sets. This zoning database resides in non-volatile or permanent memory and is therefore retained after a reset. Refer to ”Configured Zonesets Data Window” on page 4-15 for information about displaying the zoning database.
To apply zoning to a fabric, choose a zone set and activate it. When you activate a zone set, the switch distributes that zone set and its zones, excluding aliases, to every switch in the fabric. This zone set is known as the active zone set. Refer to
”” on page 3-13 for information about displaying the active zone set.
3.4.1.4
Zoning Database
Each switch has its own zoning database. The zoning database is made up of all aliases, zones, and zone sets that have been created on the switch or received from other switches. The switch maintains two copies of the inactive zoning database: one copy is maintained in temporary memory for editing purposes; the second copy is maintained in permanent memory. Zoning database edits are
59048-04 Rev. B 3-15
3 – Managing Fabrics Zoning a Fabric
made on an individual switch basis and are not propagated to other switches in the fabric when saved.
The zoning limits for a fabric are as follows:
MaxZoneSets is 256. The maximum number of zone sets that can be
MaxZones is 256. The maximum number of zones that can be configured
MaxAliases is 256. The maximum number of aliases that can be configured
MaxTotalMembers is 2000. The maximum number of total zone and alias
D
configured on the switch. This will be enforced during the configuration of zoning and during a zoning database merge from the fabric.
on the switch. This will be enforced during the configuration of zoning and during a zoning database merge from the fabric.
on the switch. This will be enforced during the configuration of zoning and during a zoning database merge from the fabric.
members that can be configured on the switch. This will be enforced during the configuration of zoning and during a zoning database merge from the fabric. Aliases are considered zone members since they can be added to a zone just like a normal zone member.
MaxZonesInZoneSets is 1000. The maximum number of zone linkages to
zonesets that can be configured on the switch. This will be enforced during the configuration of zoning and during a zoning database merge from the fabric. Every time a zone is added to a zoneset this constitutes a linkage.
MaxMembersPerZone is 2000. The maximum number of zone members
that can be added to any zone on the switch. This will be enforced during the configuration of zoning and during a zoning database merge from the fabric. Aliases are considered zone members when added to a zone.
MaxMembersPerAlias is 2000. The maximum number of zone members
that can be added to any alias on the switch. This will be enforced during the configuration of zoning and during a zoning database merge from the fabric.
3.4.1.5
Zoning Configuration
You can set the FC-SW-2 Auto Save and Default Visibility zoning configuration parameters using SANbox Manager. The Auto Save parameter determines whether changes to the active zone set that a switch receives from another switch in the fabric will be saved to permanent memory on that switch. The Default Visibility parameter permits or prohibits communication among ports/devices when there is no active zone set. Refer to ”Using the Zoning Config Dialog” on
page 3-17 for information about zoning configuration using SANbox Manager.
3-16 59048-04 Rev. B
D
3.4.2

Using the Zoning Config Dialog

Use the Zoning Config dialog to change the Auto Save and Default Visibility configuration parameters. In the faceplate display, open the Zoning menu and select Edit Zoning Config to open the Zoning Config dialog shown in Figure 3-5. After making changes, click the OK button to put the new values into effect.
Figure 3-5. Zoning Config Dialog
3 – Managing Fabrics
Zoning a Fabric
3.4.2.1
FC-SW-2 Auto Save
The FC-SW-2 Auto Save parameter determines whether changes to the active zone set that a switch receives from other switches in the fabric will be saved to the zoning database on that switch. Changes are saved when an updated zone set is activated. Zoning changes are always saved to temporary memory. However, if Auto Save is enabled, the switch firmware saves changes to the active zone set in temporary memory and to the zoning database. If Auto Save is disabled, changes to the active zone set are stored only in temporary memory which is cleared when the switch is reset.
3.4.2.2
Default Visibility
Default visibility determines the level of communication that is permitted among ports/devices when there is no active zone set. The default visibility parameter can be set differently on each switch. When default visibility is enabled (ALL) on a switch, all ports/devices on the switch can communicate with all ports/devices on switches that also have default visibility enabled. When Default Visibility is disabled (NONE), none of the ports/devices on that switch can communicate with any other port/device in the fabric.
3.4.3

Restoring Default Zoning

Restoring the default zoning clears the switch of all zoning definitions.
59048-04 Rev. B 3-17
3 – Managing Fabrics Zoning a Fabric
D
CAUTION!
To restore the default zoning for a switch:
1. In the faceplate display, open the Zoning menu and select Restore Default Zoning.
2. Click the OK button to confirm that you want to restore default zoning and save changes to the zoning database.
3.4.4
This command will deactivate the active zone set.

Merging Fabrics and Zoning

If you join two fabrics with an inter-switch link, the active zone sets from the two fabrics attempt to merge automatically. The fabrics may consist of a single switch or many switches already connected together. The switches in the two fabrics attempt to create a new active zone set containing the union of each fabric's active zone set. The propagation of zoning information only affects the active zone set, not the configured zone sets, unless FC-SW-2 Auto Save is turned on.
3.4.4.1
Zone Merge Failure
If a zone merge is unsuccessful, the inter-switch links between the fabrics will isolate due to a zone merge failure, which will generate an alarm. The reason for the E_Port isolation can also be determined by viewing the port information. Refer to ”Port Information Data Window” on page 6-7 and the ”Show Command” on
page A-53 (Port keyword).
A zone merge will fail if the two active zone sets have member zones with identical names that differ in membership or type. For example, consider Fabric A and Fabric B each with a soft zone named “ZN1” in its active zone set. Fabric A "ZN1" contains a member specified by Domain ID 1 and Port 1; Fabric B “ZN1” contains a member specified by Domain ID 1 and Port 2. In this case, the merge will fail because the two zones have the same name, but different membership.
3.4.4.2
Zone Merge Failure Recovery
When a zone merge failure occurs, the conflict that caused the failure must be resolved. You can correct a failure due to a zone conflict by deactivating one of the active zone sets or by editing the conflicting zones so that their membership is the same. You can deactivate the active zone set on one fabric if the active zone set on the other fabric accurately defines your zoning needs. If not, you must edit the zone memberships, and reactivate the zone sets. After correcting the zone membership, reset the isolated ports to allow the fabrics to join.
3-18 59048-04 Rev. B
D
Note: If you deactivate the active zone set in one fabric and the Auto Save
parameter is enabled, the active zone set from the second fabric will propagate to the first fabric and replace all zones with matching names in the configured zone sets.
If the zone sets to merge have the same Zone A that only differ in the type of zone (soft vs. ACL), the zone sets will merge. If this is a 2 switch fabric, Switch 1 will state that Zone A is soft and Switch 2 will state that Zone A is ACL.
Refer to ”Managing Zones” on page 3-24 for information about adding and removing zone members. Refer to ”Resetting a Port” on page 6-16 for information about resetting a port.
3.4.4.3
Using the Edit Zoning Dialog
To edit the zoning database for a particular switch, open the Zoning menu from the faceplate display and select Edit Zoning to open the Edit Zoning dialog shown in Figure 3-6. Changes can only be made to inactive zone sets, which are stored in flash (non-volatile) memory and retained after resetting a switch.
3 – Managing Fabrics
Zoning a Fabric
Zone Sets
Tree
Port/Device
Tree
Figure 3-6. Edit Zoning Dialog
59048-04 Rev. B 3-19
3 – Managing Fabrics Zoning a Fabric
To apply zoning to a fabric, choose a zone set and activate it. When you activate a zone set, the switch distributes that zone set and its zones, excluding aliases, to every switch in the fabric. This zone set is known as the active zone set.
You can not edit an active zone set on a switch. You must configure an inactive zone set to your needs and then activate that updated zone set to apply the changes to the fabric. When you activate a zone set, the switch distributes that zone set to the temporary zoning database on every switch in the fabric. However, in addition to the merged active zone set, each switch maintains its own original zone set in its zoning database. Only one zone set can be active at one time.
Note: If the FC-SW2-Auto-Save parameter is enabled on the Switch
D
Properties dialog, then every time the active zone set changes, the switch will copy it into an inactive zone set stored on the switch. You can edit this copy of the active zone set stored on the switch, and activate the updated copy to conveniently apply the changes to the active zone set. The edited copy then becomes the active zone set.
The Edit Zoning dialog has a Zone Sets tree on the left and a Port/Device (or members) tree on the right. Both trees use display conventions similar to the fabric tree for expanding and contracting zone sets, zones, and ports. An expanded port shows the port Fibre Channel address; an expanded address shows the port World Wide Name. You can select zone sets, zones, and ports in the following ways:
Click a zone, zone set, or port icon.
Right-click to select a zone set or zone, and open the corresponding popup
menu.
Hold down the Shift key while clicking several consecutive icons.
Hold down the Control key while clicking several non-consecutive icons.
Using tool bar buttons, popup menus, or a drag-and-drop method, you can create and manage zone sets and zones in the zoning database. Ta bl e 3-3 describes the zoning tool bar operations.
Use the Edit Zoning dialog to define zoning changes, and click the Apply button to open the Error Check dialog. Click the Error Check button to have SANbox Manager check for zoning conflicts, such as empty zones, aliases, or zone sets, and ACL zones with non-domain ID/port number membership. Click the Save Zoning button to implement the changes. Click the Close button to close the Error Check dialog. On the Edit Zoning dialog, click the Close button to close the Edit Zoning dialog.
3-20 59048-04 Rev. B
D
3 – Managing Fabrics
Zoning a Fabric
Table 3-3. Edit Zoning Dialog Tool Bar Buttons and Icons
Tool Bar Button Description
Create Zone Set button - create a new zone set
Create Zone button - create a new zone
Create Alias button - create another name for a set of objects
Add Member button - add the selected zone to a zone set, or add the selected port/device to a zone
Remove Member button - delete the selected zone from a zone set, or delete the selected port/device from a zone
Switch port icon – not logged in
Switch port icon – logged in
NL_Port (loop) device icon – logged in to fabric
NL_Port (loop) device icon – not logged in to fabric
N_Port device icon – logged in to fabric
N_Port device icon – not logged in to fabric
59048-04 Rev. B 3-21
3 – Managing Fabrics Zoning a Fabric
3.4.5

Managing Zone Sets

Zoning a fabric involves creating a zone set, creating zones as zone set members, then adding devices as zone members. The zoning database supports multiple zone sets to serve the different security and access needs of your storage area network, but only one zone set can be active at one time. Managing zone sets consists of the following tasks:
Creating zone sets
Activating and deactivating zone sets
Copying a zone to a zone set
Removing a zone from one zone set or from all zone sets
Removing a zone set
Removing all zoning definitions
Note: Changes that you make to the zoning database are limited to the
managed switch and do not propagate to the rest of the fabric. To distribute changes to configured zone sets fabric wide, you must edit the zoning databases on the individual switches.
D
3.4.5.1
Creating a Zone Set
To create a zone set, do the following:
1. Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog.
2. Open the Edit menu, and select Create Zone Set to open the Create Zone Set dialog.
3. Enter a name for the zone set, and click the OK button. The new zone set name is displayed in the Zone Sets dialog. A zone set name must begin with a letter and be no longer than 64 characters. Valid characters are 0-9, A-Z, a-z, _, -, ^, and $.
4. To create new zones in a zone set, do one of the following:
Right-click a zone set and select Create A Zone from the popup menu.
Copy an existing zone by dragging a zone into the new zone set. Refer
5. Click the Apply button to save changes to the zoning database.
In the Create a Zone dialog, enter a name for the new zone, and click the OK button. The new zone name is displayed in the Zone Sets dialog.
to ”Copying a Zone to a Zone Set” on page 3-23.
3-22 59048-04 Rev. B
D
3.4.5.2
Activating and Deactivating a Zone Set
You must activate a zone set to apply its zoning definitions to the fabric. Only one zone set can be active at one time. When you activate a zone set, the switch distributes that zone set to the temporary zoning database on every switch in the fabric.
The purpose of the deactivate function is to suspend all fabric zoning which results in free communication fabric wide or no communication depending on the default visibility setting. Refer to ”Default Visibility” on page 3-17 for more information. It is not necessary to deactivate the active zone set before activating a new one.
To activate a zone set, open the Zoning menu and select Activate Zone Set
to open the Activate Zone Set dialog. Select a zone set from the Select Zone Set pull-down menu, and click the Activate button.
To deactivate the active zone set, open the Zoning menu, select Deactivate
Zone Set. Acknowledge the warning about traffic disruption, and click the Yes button to confirm that you want to deactivate the active zone set.
3 – Managing Fabrics
Zoning a Fabric
3.4.5.3
Copying a Zone to a Zone Set
To copy an existing zone and its membership from one zone set to another, select the zone and drag it to the chosen zone set. Click the Apply button to save changes to the zoning database.
3.4.5.4
Removing a Zone from a Zone Set or from All Zone Sets
You can remove a zone from a zone set or from all zone sets in the database.
1. In the faceplate display, open the Zoning menu and select Edit Zoning to open the Edit Zoning dialog.
2. In the Zone Sets tree, select the zone(s) to be removed.
3. Open the Edit menu, and select Remove to remove the zone from the zone set, or select Remove from All Zones to remove the zone from all zone sets.
4. Click the Apply button to save changes to the zoning database.
Alternatively, you may use shortcut menus to remove a zone from a zone set or from all zone sets in the database.
59048-04 Rev. B 3-23
3 – Managing Fabrics Zoning a Fabric
3.4.5.5
Removing a Zone Set
Removing a zone set from the database affects the member zones in the following ways.
Member zones that are members of other zone sets are not affected.
Member zones that are not members of other zone sets become members
of the orphan zone set. The orphan zone set is not saved on the switch.
To delete a zone set from the database, do the following:
1. In the faceplate display, open the Zoning menu and select Edit Zoning to open the Edit Zoning dialog.
2. In the Zone Sets tree, select the zone set to be removed.
3. Open the Edit menu, and select Remove to remove the zone set.
4. Click the Apply button to save changes to the zoning database.
Alternatively, you may use shortcut menus to remove a zone set from the database.
D
3.4.5.6
Removing All Zoning Definitions
To clear all zone and zone set definitions from the zoning database, choose one of the following:
Open the Edit menu and select Clear Zoning. In the Removes All dialog,
click the Yes button to confirm that you want to delete all zones and zone sets.
Right-click the Zone Sets heading at the top of the Zone Sets tree, and
select Clear Zoning from the popup menu. Click the Yes button to confirm that you want to delete all zone sets and zones.
3.4.6

Managing Zones

Managing zones involves the following:
Creating a zone in a zone set
Adding zone members
Renaming a zone or a zone set
Removing a zone member
Removing a zone from a zone set
Removing a zone from all zone sets
Changing zone types
Saving a zoning file
3-24 59048-04 Rev. B
D
Note: Changes that you make to the zoning database are limited to the
managed switch and do not propagate to the rest of the fabric. To distribute changes to configured zone sets fabric wide, you must edit the zoning databases on the individual switches.
3.4.6.1
Creating a Zone in a Zone Set
When a zone is created, its zone type is soft. To change the zone type to a hard zone, refer to ”Changing Zone Types” on page 3-28 for more information. Refer to
”Zones” on page 3-14 for information on zone types (soft and hard). To create a
zone in a zone set, do the following:
1. Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog.
2. Select a zone set.
3. Open the Edit menu and select Create a Zone.
3 – Managing Fabrics
Zoning a Fabric
4. In the Create a Zone dialog, enter a name for the new zone, and click the OK button. The new zone name is displayed in the Zone Sets dialog. A zone name must begin with a letter and be no longer than 64 characters. Valid characters are 0-9, A-Z, a-z, _, ^, $, and -.
Note: If you enter the name of a zone that already exists in the
database, the SANbox Manager application will ask if you would like to add that zone and its membership to the zone set.
5. To add switch ports or attached devices to the zone, do one of the following:
In the zone set tree, select the zone set. In the graphic window, select
the port to add to the zone. Open the Edit menu and select Add Members.
Select a port by port number, Fibre Channel address, or World Wide
Name in the Port/Device tree, and drag it into the zone.
Select a port by port number, Fibre Channel address, or World Wide
Name in the Port/Device tree. Right-click the zone and select Add Zone Members from the popup menu.
6. Click the Apply button to save changes to the zoning database.
59048-04 Rev. B 3-25
3 – Managing Fabrics Zoning a Fabric
3.4.6.2
Adding Zone Members
Adding a zone member to a zone will affect every zone set in which that zone is a member. To add member ports/devices to a zone, do one of the following:
Select a port by port number, Fibre Channel address, or World Wide Name
in the Port/Device tree, and drag it into the zone. To select and drag multiple ports/devices, press and hold the Control key while dragging.
Select one or more ports by port number, Fibre Channel address, or World
Wide Name in the Port/Device tree. Right-click the zone and select Add Zone Members from the popup menu.
Open the Edit menu or right click on the selected zone and select Create
Members. Choose the WWN, Domain/Port, or First Port Address radio
button and enter the port hex value.
Click the Apply button to save changes to the zoning database.
D
Note: Domain ID conflicts can result in automatic reassignment of switch
3.4.6.3
Creating a Member
The Create a Member dialog allows you to add a member to a zone or alias that can not be added using the drag/drop method. The Create a Member dialog must be used to add a domain/port member to a zone or alias from a non-QLogic switch.
To create a member, do the following:
1. In the faceplate display, click the Zoning button or open the Zoning menu and select Edit Zoning.
2. In the Edit Zoning dialog, select the zone or alias in the left pane in which to add a member.
3. Open the Edit menu and select Create Members to open the Create a Member dialog.
4. Click the WWN, Domain Port, or FC Address radio button.
domain IDs. These reassignments are not reflected in zones that use domain ID/port number pair to define their membership. Be sure to reconfigure zones that are affected by a domain ID change.
5. Enter the hexadecimal value for the new zone member. Enter 16 digits for a WWN member, 4 digits for a Domain Port member (DDPP), or 6 digits for an FC Address member (DDPPAA - D=Domain ID, P=PortNumber, A=ALPA).
6. Click the OK button to add the member and save the change.
3-26 59048-04 Rev. B
D
3.4.6.4
Renaming a Zone or a Zone Set
To rename a zone, do the following:
1. In the Zone Sets tree of the Edit Zoning dialog, click the zone/zone set to be renamed.
2. Open the Edit menu and select Rename.
3. In the Rename Zone/Rename Zone Set dialog, enter a new name for the zone/zone set.
4. Click the OK button.
3.4.6.5
Removing a Zone Member
Removing a zone member will affect every zone and zone set in which that zone is a member. To remove a member from a zone:
1. In the Edit Zoning dialog, select the zone member to be removed.
3 – Managing Fabrics
Zoning a Fabric
2. Open the Edit menu and select Remove.
3. Click the OK button to save changes and close the Edit Zoning dialog.
3.4.6.6
Removing a Zone from a Zone Set
Zones that are no longer members of any zone set are moved to the orphan zone set. The orphan zone set is saved on the switch. To remove a zone from a zone set, do the following:
1. In the Edit Zoning dialog, select the zone to be removed. The selected zone will be removed from that zone set only.
2. Open the Edit menu and select Remove.
3. Click the OK button to save changes and close the Edit Zoning dialog.
3.4.6.7
Removing a Zone from All Zone Sets
Zones that are no longer members of any zone set are moved to the orphan zone set. The orphan zone set is saved on the switch. To remove a zone from all zone sets including the orphan zone set, do the following:
1. In the Edit Zoning dialog, select the zone to be removed.
2. Open the Edit menu and select Remove Zone from All Sets.
3. Click the OK button to save changes and close the Edit Zoning dialog.
59048-04 Rev. B 3-27
3 – Managing Fabrics Zoning a Fabric
3.4.6.8
Changing Zone Types
To change a zone type, do the following:
1. In the faceplate display, select the switch with the zone type to change.
2. Click the Zoning button to open the Edit Zoning dialog.
3. In the Zone Sets tree, select the zone to change.
4. Open the Edit menu and select Set Zone Type to open the Set Zone Type dialog.
5. Open the Zone Type pull-down menu and select Soft or ACL.
Soft zoning is the least restrictive type of zoning.
ACL zoning is hard zoning and is enforced by hardware and defines
access to a given port. ACL zones need not include inter-switch links.
3.4.7

Managing Aliases

An alias is a collection of objects that can be zoned together. An alias is not a zone, and can not have a zone or another alias as a member.
D
Note: Changes that you make to the zoning database are limited to the
3.4.7.1
Creating an Alias
To create an alias, do the following:
1. Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog.
2. Open the Edit menu, and select Create Alias to open the Create Alias dialog.
3. Enter a name for the alias, and click the OK button. The alias name is displayed in the Zone Sets dialog. An alias name must begin with a letter and be no longer than 64 characters. Valid characters are 0-9, A-Z, a-z, _, $, ^, and -.
4. Click the OK button to save the alias name to the zoning database.
managed switch and do not propagate to the rest of the fabric. To distribute changes to configured zone sets fabric wide, you must edit the zoning databases on the individual switches.
You will not see aliases in the active zone set.
3-28 59048-04 Rev. B
D
3.4.7.2
Adding a Member to an Alias
You can add a member to an alias in the following ways:
Drag-and-drop method.
Select the alias in the left pane and the member in the right pane to add to
that alias, and click the Insert button.
Select the alias in the left pane and the member in the right pane to add to
that alias, and open the Edit menu and select Add Members.
To add a member to an alias using the drag-and-drop method, do the following:
1. In the right pane, click and hold down the mouse button on the member to be added to the alias.
2. Drag the selected member from the right pane to the alias in the left pane.
To add a member to an alias using the menu options, do the following:
1. Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog.
3 – Managing Fabrics
Zoning a Fabric
2. In the left pane, select an alias.
3. In the right pane, select the member to add to the selected alias.
4. Choose one of the following:
Open the Edit menu and select Add Members.
Click the Insert button.
5. Click the OK button to save changes and close the Edit Zoning dialog.
3.4.7.3
Removing an Alias from All Zones
To remove an alias from all zones, do the following:
1. In the Zone Sets tree in the Edit Zoning dialog, select the alias to be removed.
2. Open the Edit menu, and select Remove Alias from All Zones.
3. Click the Yes button in the Remove dialog.
59048-04 Rev. B 3-29
3 – Managing Fabrics Zoning a Fabric
3.4.8

Saving the Zoning Database to a File

You can save the zoning database to an XML file. You can later reload this zoning database on the same switch or another switch. To save a zoning database to a file, do the following:
1. In the faceplate display, open the Zoning menu, and select Edit Zoning.
2. In the Edit Zoning dialog, open the File menu and select Save As.
3. In the Save dialog, enter a file name for the database file.
4. Click the Save button to save the zoning file.
D
3-30 59048-04 Rev. B
Section 4
Managing Switches
This section describes the following tasks that manage switches in the fabric.
Managing user accounts
Displaying switch information
Configuring port threshold alarms
Exporting name server information to a file
Exporting FDMI information to a file
Paging a switch
Setting the date and time
Resetting a switch
Configuring a switch
Archiving a switch
Restoring a switch
Restoring the factory default configuration
Managing firmware
Displaying hardware status
4.1

Managing User Accounts

Only the Admin account can manage user accounts with the User Account Administration dialogs. However, any user can modify their own password. To open the User Account Administration dialogs, open the Switch menu in the
faceplate display, and select User Accounts.... A user account consists of the
following:
Account name or login
Password
Authority level
Expiration date
Switches come from the factory with the following user accounts:
59048-04 Rev. B 4-1
4 – Managing Switches Managing User Accounts
Account Name Password Admin Authority Expiration
admin admin true never expires
images images false never expires
The Admin account is the only user that can manage all user accounts with the User Account Administration dialogs. The Admin account can create, remove, or modify user accounts, and change account passwords. The Admin account can also view and modify the switch and its configuration with SANbox Manager. The Admin account can not be removed.
Users with Admin authority can view and modify the switch and its configuration using SANbox Manager. Users without Admin authority are limited to viewing switch status and configuration.
The Images account can not be removed, and is required for exchanging files with the switch using FTP.
D
Table 4-1. Factory User Accounts
The factory switch configuration does not enforce user accounts and passwords. This means that no account name and password are required to add a fabric and modify switch configurations using SANbox Manager. You can only use the command line interface to change the enforcement (on or off) of user accounts and authority. To enforce user accounts and authority, set the UserAuthentication parameter to True using the Set Setup System command. Refer to ”Set Setup
Command” on page A-49.
4-2 59048-04 Rev. B
D
4.1.1

Creating User Accounts

To create a user account on a switch, open the Switch menu in the faceplate
display and select User Accounts.... This displays the User Account
Administration dialog shown in Figure 4-1. A switch can have a maximum of 15 user accounts.
4 – Managing Switches
Managing User Accounts
Figure 4-1. User Account Administration Dialog – Add Account
1. To open the User Account Administration dialogs, open the Switch menu in
the faceplate display, and select User Accounts....
2. Click the Add Account tab to open the Add Account tab page.
3. Enter an account name in the New Account Login field. Account names are limited to 15 characters.
4. If the account is to have the ability to modify switch configurations, check the Admin Authority Enabled box.
5. Enter a password in the New Password field and enter it again in the Verify Password field. A password must have a minimum of 4 characters and no more than 20.
6. If this account is to be permanent with no expiration date, click the
Permanent Account radio button. Otherwise, click the Account Will Expire button and enter the number days in which the account will expire.
7. Click the Add Account button to add the newly defined account.
59048-04 Rev. B 4-3
4 – Managing Switches Managing User Accounts
4.1.2

Removing a User Account

To remove a user account on a switch, open the Switch menu in the faceplate
display and select User Accounts.... Click the Remove Account tab in the dialog
to present the display shown in Figure 4-2. Select the account name from the list of accounts at the top of the dialog and click the Remove Account button.
D
Figure 4-2. User Account Administration Dialog – Remove Account
4-4 59048-04 Rev. B
D
4.1.3

Changing a User Account Password

To change the password for an account on a switch, open the Switch menu in the
faceplate display and select User Accounts.... Click the Change Password tab
in the dialog to present the display shown in Figure 4-3. Select the account name from the list of accounts at the top of the dialog, then enter the old password, the new password, and verify the new password in the corresponding fields. Click the Change Password button. Any user can change their password for their account, but only the Admin account name can change the password for another user’s account. If the administrator does not know the user’s original password, the administrator must remove the account and add the account.
4 – Managing Switches
Managing User Accounts
Figure 4-3. User Account Administration Dialog– Change Password
59048-04 Rev. B 4-5
4 – Managing Switches Managing User Accounts
4.1.4

Modifying a User Account

To modify a user account on a switch, open the Switch menu in the faceplate
display and select User Accounts.... This displays the User Account
Administration dialog shown in Figure 4-4. Click the Modify Account tab. Select the account name from the list of accounts at the top of the dialog. Click the Admin authority Enabled check box to grant admin authority to the account name. Click an Account Expiration Date radio button. If the account is not to be permanent, enter the number of days until the account expires. Click the Modify Account button to save the changes. Click the Close button to close the User Account Administration dialog.
D
Figure 4-4. User Account Administration Dialog – Modify Account
4-6 59048-04 Rev. B
D
4.2

Displaying Switch Information

The faceplate display and data windows provide the following switch information:
Name server information
Device and HBA information
Switch specifications and addresses
Configuration parameters
Performance statistics
Port information
Configured zone sets
Figure 4-5 shows the faceplate display for the SANbox2-64 switch.
4 – Managing Switches
Displaying Switch Information
Figure 4-5. Faceplate Display
59048-04 Rev. B 4-7
4 – Managing Switches Displaying Switch Information
The fabric updates the topology and faceplate displays by forwarding changes in status to the management workstation as they occur. You can allow the fabric to update the switch status, or you can refresh the display at any time. To refresh switch status in the display, do one of the following:
Click the Refresh button.
Open the View menu and select Refresh.
Press the F5 key.
Right-click a switch in the topology display and select Refresh Switch from
the popup menu.
Right-click in the graphic window of the faceplate display, and select
Refresh Switch from the popup menu.
4.2.1

Name Server Data Window

The Name Server data window displays information about the devices that are logged into the fabric. Click the Name Server tab below the data window to display name server information for all devices that are logged into the selected fabric. To narrow the display to devices that are logged into specific switches, select one or more switches in the fabric tree or the topology display. Refer to
Table 4-2 for a description of the entries in the Name Server data window. Refer to ”Exporting Name Server Information to a File” on page 4-18 for exporting name
server information.
D
Table 4-2. Name Server Data Window Entries
Entry Description
Target/Initiator Device type: target or initiator
Switch Switch name
Port Switch port number
Address Fibre Channel address
Type Node type
WWNN Node World Wide Name
WWPN Port World Wide Name
Vendor Host Bus Adapter/Device Vendor
FC-4 Types Device Fibre Channel protocol types
Active Zones The active zone to which the device belongs
4-8 59048-04 Rev. B
D
4.2.2

FDMI Data Window

The FDMI data window displays device information from the fabric and allows devices to register certain information with the fabric. To open the FDMI data window, open the topology display and click the FDMI tab below the window. SANbox Manager will report any and all FDMI information reported by the entry switch, if FDMI is enabled on the entry switch. To view FDMI data, FDMI must be enabled on the entry switch and on all other switches in the fabric which are to report FDMI data. To enable FDMI, select a switch in the topology display or open the faceplate display, open the Switch menu, select Switch Properties, and click the Enable FDMI radio button in the Switch Properties dialog.
HBA WWN HBA World Wide Name
Details Detail device information. Click the Information (i) button
4 – Managing Switches
Displaying Switch Information
Table 4-3. FDMI Data Window Entries
Entry Description
to open the Detailed FDMI Display dialog. Refer to
Figure 4-6 for detailed FDMI information.
Vendor Device vendor
Model Device model
Node WWN Node World Wide Name
H/W Version Version of hardware
Driver Version Version of driver software
F/W Version Version of firmware
OS Operating System used
# Ports Number of device ports
The Detailed FDMI Display dialog is opened after clicking the Information (i) button in the Details column of the FDMI data window, and lists additional FDMI information for the device. To open the FDMI data window, open the topology display and click the FDMI data window tab.
59048-04 Rev. B 4-9
4 – Managing Switches Displaying Switch Information
D
Figure 4-6. Detailed FDMI Display Dialog
4.2.3

Switch Data Window

The Switch data window displays current network and switch information for the selected switches. Refer to ”Configuring a Switch” on page 4-20 for more information about the Switch data window. To open the Switch data window, select one or more switches in the topology display or open the faceplate display, and click the Switch tab below the window. Tab le 4-4 describes the Switch data window entries.
Entry Description
First Port Address Switch Fibre Channel address
World Wide Name Switch World Wide Name
Serial Number Number assigned to each chassis.
Reason for Status Additional status information
User Name Account name
Table 4-4. Switch Data Window Entries
Login Level Authority level
Super User Super user privileges enabled/disabled
4-10 59048-04 Rev. B
D
4 – Managing Switches
Displaying Switch Information
Table 4-4. Switch Data Window Entries (Continued)
Entry Description
UserAuthentication Enabled
Vendor Switch manufacturer
Firmware Version Active firmware version
Inactive Firmware Version Inactive firmware version
Pending Firmware Version Firmware version that will be activated at the next reset
PROM/Flasher Version PROM firmware version
MAC Address Media Access Control address
IP Address Internet Protocol address
Subnet Mask Mask that determines the IP address subnet
Gateway Gateway address
SNMP Enabled SNMP enabled or disabled.
Negotiated Domain ID The domain ID currently being used by the fabric
Configured Domain ID The domain ID defined by network administrator
Domain ID Lock Domain ID lock status. Prevents (True) or permits (False)
Enforcement of account names and authority
dynamic domain ID reassignment.
Number of Ports Number of ports activated on the switch
Switch Type Switch model
Operational State Switch operational state: Online, Offline, Diagnostic
Administrative State Current switch administrative state
Configured Admin State Switch administrative state that is stored in the switch
configuration
R_A_TOV Resource allocation timeout value
E_D_TOV Error detect timeout value
FC-SW-2 Compliant Zoning merge status. If True, changes to the active zone
set are propagated throughout the fabric. If false, changes to both the active zone set and zoning database are propagated throughout the fabric. Refer to the QLogic Switch Interoperability Guide found on the QLogic Web site.
59048-04 Rev. B 4-11
4 – Managing Switches Displaying Switch Information
Legacy Address Format Legacy port addressing status. Enabled only for
FC-SW-2 Auto Save Zoning auto save status. Saves zoning updates in
Zoning Default Visibility Zoning visibility status. Permits (All) or prevents (None)
Temperature Internal switch temperature °C
Security Auto Save N/A
D
Table 4-4. Switch Data Window Entries (Continued)
Entry Description
interoperability with non-FC-SW-2 switches.
temporary memory and the zoning database (True) or only in temporary memory (False).
communication between attached devices in the absence of an active zone set.
Security Fabric Binding Enable
Fan 1 Status Fan 1 status
Fan 2 Status Fan 2 status
Fan 3 Status Fan 3 status
Power Supply 1 Status Power supply 1 status
Power Supply 2 Status Power supply 2 status
Beacon Status Beacon status. Switch LEDs are blinking (On) or not (off).
Broadcast Support Broadcast support status. Broadcast support is enabled or
In-band Enabled In-band management status. Permits (True) or prevents
Temp Failure Port Shutdown
Warning Temperature N/A
Failure Temperature N/A
FDMI Enable Fabric Device Management Interface status. If enabled,
N/A
disabled (default).
(False) a switch from being managed over an ISL.
N/A
device information can be obtained, managed, and saved through the fabric using Name Service Management Server functions. SANbox Manager will report any and all FDMI information reported by the entry switch, if FDMI is enabled on the entry switch.
4-12 59048-04 Rev. B
D
Table 4-4. Switch Data Window Entries (Continued)
Entry Description
FDMI HBA Entry Limit Maximum number of HBAs that can be registered with a
Number of Donor Groups Total number of donor port groups. A donor group is a set
4.2.4

Link Data Window

The Link data window displays information about all switch links in the fabric or selected links. This information includes the switch name, the port number at the end of each link, and the link status. To open the Link data window, click the Link tab below the data window in the topology display.
4.2.5

Port Statistics Data Window

The Port Statistics data window displays port performance data for the selected ports. To open the Port Statistics data window, click the Port Stats tab below the data window in the faceplate display. Refer to Tab le 6 -5 for a description of the Port Statistics data window entries.
4 – Managing Switches
Displaying Switch Information
switch.
of ports on a switch that can donate buffer credits to each other.
The Statistics pull-down menu is available on the Port Statistics data window, and provides different ways to view detailed port information. Click the down arrow to open the pull-down menu. Open the pull-down menu and select Absolute to view the total count of statistics since the last switch reset. Select Rate to view the number of statistics counted per second over the polling period. Select Baseline to view the total count of statistics since the last time the baseline was set. Click the Clear Baseline button to set the current baseline.
59048-04 Rev. B 4-13
4 – Managing Switches Displaying Switch Information
4.2.6

Port Information Data Window

The Port Information data window displays port detail information for the selected ports. To open the Port Statistics data window, click the Port Info tab below the data window in the faceplate display. Refer to Tab le 6 -6 for a description of the Port Information data window entries.
D
Figure 4-7. Faceplate Display - Port Information
4-14 59048-04 Rev. B
D
4.2.7

Configured and Active Zonesets Data Windows

The Configured Zonesets data window displays all zone sets, zones, aliases, and zone membership in the zoning database, as shown in Figure 4-8. To open the Configured Zonesets data window, click the Configured Zonesets tab below the data window in the faceplate display. To view the active zonesets in the Active Zonesets data window, open the topology display and click the Active Zonesets data window tab.
The Configured Zonesets data window uses display conventions for expanding and contracting entries that are similar to the fabric tree. An entry handle located to the left of an entry in the tree indicates that the entry can be expanded. Click this handle or double-click the following entries to expand or collapse them:
A zone set entry expands to show its member zones.
A zone entry expands to show its members by port number, World Wide
Name, or Fibre Channel address.
The alias entry expands to show its entries.
4 – Managing Switches
Displaying Switch Information
Figure 4-8. Configured Zonesets Data Window
59048-04 Rev. B 4-15
4 – Managing Switches Configuring Port Threshold Alarms
4.3

Configuring Port Threshold Alarms

You can configure the switch to generate alarms for selected events. Configuring an alarm involves choosing an event type, rising and falling triggers, a sample window, and finally enabling or disabling the alarm. To configure port threshold alarms, do the following:
1. In the faceplate display, open the Switch menu and select Port Threshold Alarm Configuration. The Port Threshold Alarm Configuration dialog shown in Figure 4-9 prompts you to enable or disable all alarms, select an event, set triggers, set a sample window and enable or disable an individual alarm.
D
Figure 4-9. Port Threshold Alarm Configuration Dialog
2. Check the Enable All Port Threshold Alarms check box to enable monitoring for all the individual alarm types that are enabled. The Enable All Port Threshold Alarms check box is the master control for the individual alarms. For example, the switch will monitor CRC errors only if both the CRC Error Enable box and the Enable All Port Threshold Alarms box are checked.
3. Select an event type from the Port Threshold Alarm pull-down menu. Choose from the following options:
CRC error monitoring
Decode error monitoring
ISL monitoring
Login monitoring
Logout monitoring
Loss of signal monitoring
4. Check the Enable box to make the alarm eligible for use.
4-16 59048-04 Rev. B
D
4 – Managing Switches
Configuring Port Threshold Alarms
5. Enter a value for the rising trigger. A rising trigger alarm is generated when the event count per interval exceeds the rising trigger. The switch will not generate another rising trigger alarm for that event until the count descends below the falling trigger and rises again above the rising trigger. Consider the example in Figure 4-10.
6. Enter a value for the falling trigger. A falling trigger alarm is generated when the event count per interval descends below the falling trigger.
Note: The switch will down a port if a rising trigger alarm is not cleared
after three consecutive sample windows.
Generate rising trigger alarm; eligibility ends
Event
Generate rising trigger alarm; eligibility ends
Rising
Trigger
Count
Falling
Generate falling
trigger alarm;
eligibility is reset
Trigger
Sample Window
Figure 4-10. Port Threshold Alarm Example
7. Enter a sample window in seconds. The sample window defines the period of time in which to count events.
8. Repeat steps 3 through 7 for each alarm you want to configure or enable.
9. Click the OK button to save all changes.
59048-04 Rev. B 4-17
4 – Managing Switches Exporting Name Server Information to a File
4.4

Exporting Name Server Information to a File

To save name server information to a file, open the topology display and do the following:
1. Select one or more switches. If no switches are selected, name server information is gathered for all switches.
2. Open the Switch menu and select Export Name Server.
3. In the Save dialog, enter a file name.
4. Click the Save button.
4.5

Exporting FDMI Information to a File

SANbox Manager will report any and all FDMI information reported by the entry switch, if FDMI is enabled on the entry switch. To save FDMI information to a file, do the following:
1. Open the topology display.
D
2. Open the Switch menu and select Export FDMI.
3. In the Save dialog, enter a file name.
4. Click the Save button.
4.6

Paging a Switch

You can use the beacon feature to page a switch. The beacon feature causes all Port Status LEDs to flash, making it easier to recognize. To page a switch, open the Switch menu in the faceplate display and enable the Toggle Beacon selection. To cancel the beacon, reselect Toggle Beacon.
4.7

Setting the Date and Time

To set the date and time on a switch, do the following:
1. Select a switch in the topology display, and open the faceplate display.
2. Open the Switch menu, and select Set Date/Time....
3. Enter the year, month, day and time in the Switch Date and Time dialog, then click OK. The new date and time take effect immediately.
4-18 59048-04 Rev. B
D
4.8

Resetting a Switch

Resetting a switch reboots the switch using configuration parameters in memory. Depending on the reset type, a switch reset may or may not include a power-on self test or it may or may not disrupt traffic. Tab le 4 -5 describes the types of switch resets.
During a hotreset operation, fabric services will be unavailable for a short period (30-75 seconds depending on switch model). To ensure that an NDCLA operation is successful, verify that all administrative changes to the fabric (if any) are complete. When upgrading firmware across a fabric using non-disruptive activation, upgrade one switch at a time and allow 75 seconds between switches.
4 – Managing Switches
Resetting a Switch
CAUTION!
Common administrative operations that change the fabric include:
Zoning modifications.
Adding, moving or removing devices attached to the switch fabric. This
includes powering up or powering down attached devices.
Adding, moving or removing ISLs or other connections.
Management Interfaces:
After an NDCLA operation is complete, management connections must be re-initiated:
SANbox Manager sessions will re-connect automatically.
Telnet sessions must be restarted manually.
Applicable Code Versions:
NDCLA capability is available starting with version 2.0 of the switch code.
Upgrading to version 2.0 from previous releases will be disruptive.
Future switch code releases will be upgraded non-disruptively unless
specifically indicated in its associated release notes.
Changes to the fabric may disrupt the NDCLA process.
An NDCLA operation to previous switch code releases is not supported.
59048-04 Rev. B 4-19
4 – Managing Switches Configuring a Switch
Hot Reset Resets a switch without a power-on self test. This reset activates
D
Table 4-5. Switch Resets
Type Desc r iption
the pending firmware, but does not disrupt switch traffic. If errors are detected on a port during a hot reset, the port is reset automatically.
Reset without POST
Hard Reset Resets a switch with a power-on self test. This reset activates the
To reset a switch using SANbox Manager, do the following:
1. Select the switch to be reset and open the faceplate display.
2. Open the Switch menu and select the Reset Switch pull-down menu:
Select Hot Reset to perform a hot reset.
Select Reset to perform a standard reset.
Select Hard Reset to perform a hard reset.
4.9

Configuring a Switch

Switch configuration is divided into two areas: chassis configuration and network configuration. Chassis configuration specifies switch-wide Fibre Channel settings. Network configuration specifies Ethernet and SNMP settings.
To open the Switch Properties dialog, either select a switch in the topology display or open the faceplate display for the switch you will be configuring, and then open the Switch menu and select Switch Properties. You may also right-click a switch graphic in the topology display or faceplate display, and select Switch Properties from the popup menu.
Resets a switch without a power-on self test. This reset activates the pending firmware and it is disruptive to switch traffic.
pending firmware and it is disruptive to switch traffic.
4-20 59048-04 Rev. B
D
4.9.1

Using the Configuration Wizard

The Configuration Wizard is a series of dialogs you can use to configure the IP address and other basic parameters on new or replacement switches. SANbox Manager will detect the first time use and present the Initial Start dialog, from which the Configuration Wizard can be launched. The Configuration Wizard allows you to assign a temporary IP address to a connected switch, eliminating the need to change your workstation's IP address for initial configuration of a new switch. You can also launch the Configuration Wizard from the Wizards menu in either the topology display or the faceplate display. Open the Wizards menu and select Configuration Wizard.
Use the Configuration Wizard to:
Configure a new switch in a fabric.
Add a new switch to an existing fabric.
Replace or restore a switch in an existing fabric.
Recover or edit the IP configuration of an existing switch.
4 – Managing Switches
Configuring a Switch
4.9.2

Switch Properties

Use the Switch Properties dialog to change the following switch configuration parameters:
Symbolic name
Administrative state
Domain ID and domain ID lock
FDMI and FDMI HBA entry limit
Broadcast support (TCP/IP)
In-band management
FC-SW-2 compliance for zoning
Legacy port address format
The timeout values are displayed only for reference purposes when the switch is online; they become active when the switch is taken offline. After making changes, click the OK button to put the new values into effect.
59048-04 Rev. B 4-21
4 – Managing Switches Configuring a Switch
D
Figure 4-11. Switch Properties Dialog
4.9.2.1
Symbolic Name
The symbolic name is a user-defined name of up to 63 characters that identifies the switch. The symbolic name is used in the topology and faceplate displays, as well as many data windows to more easily identify switches. The illegal characters are the pound sign (#), semi-colon (;), and comma (,).
4.9.2.2
Switch Administrative States
The switch administrative state determines the operational state of the switch. The switch administrative state exists in two forms: the configured administrative state and the current administrative state.
The configured administrative state is the state that is saved in the switch
configuration and is preserved across switch resets. SANbox Manager always makes changes to the configured administrative state. The configured administrative state is displayed in the Switch Properties dialog.
The current administrative state is the state that is applied to the switch for
temporary purposes and is not retained across switch resets. The current administrative state is set using the Set Switch command. Refer to the ”Set
Command” on page A-32.
4-22 59048-04 Rev. B
Loading...