D
Simplify
SANbox2-8c/16 Switch Management
User’s Guide
59022-06 A Page i
SANbox2-8c/16 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.
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 is a registered trademark 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.
Q
Document Revision History
Revision A, Release, June, 2003
© 2000–2003 QLogic Corporation
First Printed: May 2002
All Rights Reserved Worldwide.
Printed in U.S.A.
QLogic Corporation, 6321 Bury Drive, Eden Prairie, MN 55346
Page ii 59022-06 A
(800) 342-7379 or (952) 932-4000
Table of Contents
Section 1 Introduction
1.1 Intended Audience ............................................................................................. 1-1
1.2 Related Materials ............................................................................................... 1-1
1.3 Technical Support............................................................................................... 1-2
1.3.1 Availability.................................................................................................. 1-2
1.3.2 Training......................................................................................................1-2
1.3.3 Contact Information ................................................................................... 1-2
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.1.4 SANbox2 Installation Disk - Windows Installation ..................................... 2-5
2.1.5 SANbox2 Installation Disk - Linux Installation ........................................... 2-5
2.1.6 SANbox2 Installation Disk - Solaris Installation......................................... 2-5
2.2 Starting SANbox Manager.................................................................................. 2-6
2.3 Exiting SANbox Manager ................................................................................... 2-8
2.4 Uninstalling SANbox Manager ........................................................................... 2-9
2.5 Changing the SANbox Manager Default Fabric File Password........................ 2-10
2.6 Saving and Opening SANbox Manager Fabric View Files............................... 2-10
2.7 Setting SANbox Manager Preferences ............................................................ 2-11
2.8 Using Online Help ............................................................................................ 2-12
2.9 Viewing Software Version and Copyright Information ...................................... 2-12
2.10 SANbox Manager User Interface ..................................................................... 2-13
2.10.1 Menu Bar................................................................................................. 2-14
2.10.2 Tool Bar ................................................................................................... 2-16
2.10.3 Fabric Tree .............................................................................................. 2-17
2.10.4 Graphic Window ...................................................................................... 2-18
2.10.5 Data Window and Tabs............................................................................ 2-18
2.10.6 Working Status Indicator.......................................................................... 2-18
2.11 Using the Topology Display.............................................................................. 2-19
2.11.1 Switch and Link Status ............................................................................ 2-19
2.11.2 Working with Switches and Links ............................................................ 2-20
2.11.2.1 Selecting Switches and Links ......................................................... 2-20
2.11.2.2 Arranging Switches in the Display .................................................. 2-20
59022-06 A Page iii
SANbox2-8c/16 Switch Management
User’s Guide
2.11.2.3 Opening the Faceplate Display and Topology Popup Menus......... 2-21
2.11.3 Topology Data Windows.......................................................................... 2-21
2.12 Using the Faceplate Display............................................................................. 2-22
2.12.1 Port Views and Status ............................................................................. 2-22
2.12.2 Working with Ports...................................................................................2-23
2.12.2.1 Selecting Ports................................................................................2-23
2.12.2.2 Opening the Faceplate Popup Menu.............................................. 2-23
2.12.3 Faceplate Data Windows......................................................................... 2-24
Q
Section 3 Managing Fabrics
3.1 Security .............................................................................................................. 3-1
3.1.1 User Authentication ................................................................................... 3-1
3.1.2 Inter-Switch Link Security.......................................................................... 3-2
3.1.3 Inband Management..................................................................................3-2
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-4
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 Save the Event Browser to a File ................................................... 3-12
3.3.3 Active Zone Set Data Window................................................................. 3-13
3.4 Zoning a Fabric ................................................................................................ 3-14
3.4.1 Zoning Concepts ..................................................................................... 3-14
3.4.1.1 Zones.............................................................................................. 3-14
3.4.1.2 Aliases ............................................................................................ 3-16
3.4.1.3 Zone Sets ....................................................................................... 3-16
3.4.1.4 Zoning Database ............................................................................ 3-17
3.4.1.5 Zoning Configuration ...................................................................... 3-17
3.4.2 Using the Zoning Config Dialog............................................................... 3-18
3.4.2.1 FC-SW-2 Auto Save ....................................................................... 3-18
3.4.2.2 Default Visibility .............................................................................. 3-18
Page iv 59022-06 A
SANbox2-8c/16 Switch Management
Q
3.4.3 Restoring Default Zoning......................................................................... 3-19
3.4.4 Merging Fabrics and Zoning.................................................................... 3-19
3.4.4.1 Zone Merge Failure ........................................................................ 3-19
3.4.4.2 Zone Merge Failure Recovery ........................................................ 3-20
3.4.5 Using the Edit Zoning Window ................................................................ 3-21
3.4.6 Managing Zone Sets ............................................................................... 3-23
3.4.6.1 Creating a Zone Set .......................................................................3-23
3.4.6.2 Activating and Deactivating a Zone Set.......................................... 3-24
3.4.6.3 Copying a Zone to a Zone Set........................................................ 3-24
3.4.6.4 Removing a Zone from a Zone Set or from All Zone Sets.............. 3-24
3.4.6.5 Removing a Zone Set..................................................................... 3-25
3.4.6.6 Removing All Zoning Definitions..................................................... 3-25
3.4.7 Managing Zones...................................................................................... 3-26
3.4.7.1 Creating a Zone in a Zone Set .......................................................3-26
3.4.7.2 Adding Zone Members ................................................................... 3-27
3.4.7.3 Renaming a Zone or a Zone Set .................................................... 3-28
3.4.7.4 Removing a Zone Member ............................................................. 3-28
3.4.7.5 Removing a Zone from a Zone Set ................................................ 3-28
3.4.7.6 Removing a Zone from All Zone Sets............................................. 3-28
3.4.7.7 Changing Zone Types .................................................................... 3-29
3.4.8 Managing Aliases .................................................................................... 3-29
3.4.8.1 Creating an Alias ............................................................................ 3-29
3.4.8.2 Adding a Member to an Alias ......................................................... 3-30
3.4.8.3 Removing an Alias from All Zones ................................................. 3-30
User’s Guide
Section 4 Managing Switches
4.1 Managing User Accounts ................................................................................... 4-1
4.1.1 Creating User Accounts............................................................................. 4-2
4.1.2 Removing a User Account.........................................................................4-3
4.1.3 Changing a User Account Password......................................................... 4-4
4.2 Displaying Switch Information ............................................................................ 4-5
4.2.1 Displaying Hardware Status ...................................................................... 4-6
4.2.2 Name Server Data Window....................................................................... 4-7
4.2.3 Switch Data Window.................................................................................. 4-7
4.2.4 Link Data Window.................................................................................... 4-10
4.2.5 Port Statistics Data Window .................................................................... 4-10
4.2.6 Port Information Data Window.................................................................4-10
4.2.7 Configured Zonesets Data Window......................................................... 4-11
4.3 Configuring Alarms...........................................................................................4-12
4.4 Exporting Name Server Information to a File ................................................... 4-14
59022-06 A Page v
SANbox2-8c/16 Switch Management
User’s Guide
4.5 Paging a Switch................................................................................................ 4-14
4.6 Setting the Date and Time................................................................................ 4-14
4.7 Setting Temperature Thresholds ...................................................................... 4-14
4.8 Resetting a Switch............................................................................................ 4-15
4.9 Configuring a Switch ........................................................................................ 4-16
4.9.1 Switch Properties..................................................................................... 4-16
4.9.1.1 Symbolic Name .............................................................................. 4-17
4.9.1.2 Switch Administrative States........................................................... 4-17
4.9.1.3 Domain ID and Domain ID Lock ..................................................... 4-18
4.9.1.4 Broadcast Support.......................................................................... 4-19
4.9.1.5 Inband Management....................................................................... 4-19
4.9.1.6 FC-SW-2 Compliance for Zoning.................................................... 4-19
4.9.1.7 Legacy Port Address Format.......................................................... 4-20
4.9.1.8 Timeout Values ............................................................................... 4-20
4.9.2 Network Properties.................................................................................. 4-21
4.9.2.1 IP Configuration.............................................................................. 4-22
4.9.2.2 SNMP Configuration....................................................................... 4-23
4.9.2.3 SNMP Trap Configuration...............................................................4-24
4.9.2.4 Remote Logging ............................................................................. 4-24
4.10 Archiving a Switch............................................................................................ 4-25
4.11 Restoring a Switch ........................................................................................... 4-26
4.12 Managing Firmware.......................................................................................... 4-28
4.12.1 Installing Firmware .................................................................................. 4-28
4.12.2 Activating the Pending Firmware............................................................. 4-29
4.12.3 Changing the Pending Firmware............................................................. 4-29
4.13 Restoring the Factory Default Configuration .................................................... 4-30
Q
Section 5 Managing Ports
5.1 Displaying Port Information ................................................................................ 5-1
5.1.1 Monitoring Port Status ............................................................................... 5-2
5.1.1.1 Displaying Port Modes...................................................................... 5-2
5.1.1.2 Displaying Port Operational States................................................... 5-3
5.1.1.3 Displaying Port Speeds .................................................................... 5-3
5.1.1.4 Displaying Transceiver Media Status................................................ 5-4
5.1.2 Port Statistics Data Window ...................................................................... 5-4
5.1.3 Port Information Data Window...................................................................5-7
5.1.4 Name Server Data Window....................................................................... 5-8
5.2 Configuring Ports................................................................................................ 5-9
5.2.1 Changing Port Administrative States....................................................... 5-10
5.2.2 Changing Port Speeds ............................................................................ 5-11
Page vi 59022-06 A
SANbox2-8c/16 Switch Management
Q
5.2.3 Changing Port Modes.............................................................................. 5-11
5.2.4 Changing Buffer-to-Buffer Credits ........................................................... 5-12
5.2.5 I/O Stream Guard .................................................................................... 5-13
5.2.6 Scan Device ............................................................................................ 5-13
5.2.7 Extending Port Credits............................................................................. 5-13
5.2.8 Resetting a Port....................................................................................... 5-14
5.3 Testing Ports..................................................................................................... 5-15
User’s Guide
Appendix A Command Line Interface
A.1 Logging On to a Switch ......................................................................................A-1
A.2 Command Syntax...............................................................................................A-2
A.3 Commands .........................................................................................................A-3
Admin Command.......................................................................................A-4
Alias Command .........................................................................................A-5
Config Command.......................................................................................A-7
Date Command .......................................................................................A-10
Fallback Command..................................................................................A-11
Hardreset Command ...............................................................................A-12
Help Command........................................................................................A-13
History Command....................................................................................A-14
Hotreset Command .................................................................................A-15
Image Command.....................................................................................A-16
Lip Command ..........................................................................................A-17
Passwd Command ..................................................................................A-18
Ping Command........................................................................................A-19
Ps Command...........................................................................................A-20
Quit Command ........................................................................................A-21
Reset Command......................................................................................A-22
Set Command..........................................................................................A-27
Set Config Command ..............................................................................A-29
Set Log Command...................................................................................A-38
Set Port Command..................................................................................A-41
Set Setup Command ...............................................................................A-42
Show Command......................................................................................A-47
Show Config Command...........................................................................A-59
Show Log Command...............................................................................A-62
Show Perf Command ..............................................................................A-64
Show Setup Command............................................................................A-66
Shutdown Command...............................................................................A-69
Test Command ........................................................................................A-70
59022-06 A Page vii
SANbox2-8c/16 Switch Management
User’s Guide
Uptime Command....................................................................................A-73
User Command .......................................................................................A-74
Whoami Command..................................................................................A-76
Zone Command.......................................................................................A-77
Zoneset Command..................................................................................A-81
Zoning Command....................................................................................A-84
Q
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 SANsurfer Fabric View Fabric View Files .........................B-3
B.4 Changing the SANsurfer Fabric View Default Fabric File Password..................B-4
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-7
B.9 Saving Graph Statistics to a File ........................................................................B-8
Glossary
Index
Figures
Figure Page
2-1 Initial Startup Dialog.......................................................................................................2-6
2-2 SANbox Manager Window............................................................................................. 2-7
2-3 Save Default Fabric File Dialog – SANbox Manager ..................................................... 2-8
2-4 Load Default Fabric File Dialog – SANbox Manager ..................................................... 2-8
2-5 Set New Password Dialog – SANbox Manager Fabric File ......................................... 2-10
2-6 Preferences Dialog – SANbox Manager ...................................................................... 2-11
2-7 SANbox Manager Display Elements............................................................................ 2-13
2-8 SANbox Manager Menu Structure ............................................................................... 2-14
2-9 Fabric Tree................................................................................................................... 2-17
2-10 Topology Display..........................................................................................................2-19
2-11 Faceplate Display......................................................................................................... 2-22
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-18
3-6 Edit Zoning Window ..................................................................................................... 3-21
Page viii 59022-06 A
SANbox2-8c/16 Switch Management
Q
4-1 Account Administration – Add........................................................................................ 4-2
4-2 Account Administration – Remove................................................................................. 4-3
4-3 Account Administration – Change Password................................................................. 4-4
4-4 Faceplate Display...........................................................................................................4-5
4-5 Faceplate Display - Chassis LED Cluster ...................................................................... 4-6
4-6 Configured Zonesets Data Window ............................................................................. 4-11
4-7 Alarm Threshold Configuration Dialog ......................................................................... 4-12
4-8 Alarm Threshold Example............................................................................................ 4-13
4-9 Temperature Thresholds Dialog................................................................................... 4-15
4-10 Switch Properties Dialog.............................................................................................. 4-17
4-11 Network Properties Dialog ........................................................................................... 4-21
4-12 Restore Dialogs – Full and Selective ........................................................................... 4-26
5-1 Faceplate Display – Port Information............................................................................. 5-1
5-2 Port Properties Dialog.................................................................................................... 5-9
5-3 Designate Donor Ports................................................................................................. 5-14
5-4 Port Loopback Test Dialog........................................................................................... 5-15
B-1 Fabric View Graphs........................................................................................................B-1
B-2 Save Default Fabric File – SANsurfer Fabric View ........................................................B-2
B-3 Load Default Fabric File – SANsurfer Fabric View.........................................................B-3
B-4 Set New Password – SANsurfer Fabric View Fabric File...............................................B-4
B-5 Preferences – SANsurfer Fabric View ...........................................................................B-4
B-6 Default Graph Options Dialog ........................................................................................B-6
User’s Guide
Tables
Table Page
2-1 Management Workstation Requirements....................................................................... 2-1
2-2 Menu Shortcut Keys..................................................................................................... 2-15
2-3 Tool Bar Buttons .......................................................................................................... 2-16
3-1 Topology Display Switch and Status Icons .................................................................... 3-8
3-2 Severity Levels............................................................................................................. 3-10
3-3 Edit Zoning Window Tool Bar Buttons ......................................................................... 3-22
4-1 Factory User Accounts...................................................................................................4-1
4-2 Name Server Data Window Entries ............................................................................... 4-7
4-3 Switch Data Window Entries.......................................................................................... 4-8
4-4 Switch Resets .............................................................................................................. 4-15
4-5 Switch Administrative States........................................................................................4-18
4-6 Timeout Values ............................................................................................................ 4-20
4-7 IP Configuration Parameters........................................................................................ 4-22
4-8 SNMP Configuration Parameters................................................................................. 4-23
4-9 SNMP Trap Configuration Parameters ........................................................................ 4-24
4-10 Factory Default Configuration Settings ........................................................................ 4-30
5-1 Port Modes..................................................................................................................... 5-2
5-2 Port Operational States.................................................................................................. 5-3
5-3 Port Speeds ...................................................................................................................5-3
5-4 Transceiver Media View................................................................................................. 5-4
59022-06 A Page ix
SANbox2-8c/16 Switch Management
User’s Guide
5-5 Port Statistics Data Window Entries............................................................................... 5-4
5-6 Port Information Data Window Entries........................................................................... 5-7
5-7 Port Administrative States............................................................................................ 5-10
5-8 Port Speeds .................................................................................................................5-11
5-9 Port Modes...................................................................................................................5-12
A-1 Command-Line Completion ...........................................................................................A-2
A-2 Commands Listed by Authority Level.............................................................................A-3
A-3 Switch Configuration Defaults ......................................................................................A-23
A-4 Port Configuration Defaults..........................................................................................A-23
A-5 Alarm Threshold Configuration Defaults ......................................................................A-24
A-6 Zoning Configuration Defaults......................................................................................A-25
A-7 SNMP Configuration Defaults ......................................................................................A-25
A-8 System Configuration Defaults.....................................................................................A-26
A-9 Set Config Port Parameters .........................................................................................A-29
A-10 Set Config Switch Parameters .....................................................................................A-31
A-11 Set Config Threshold Parameters................................................................................A-33
A-12 Set Config Zoning Parameters.....................................................................................A-34
A-13 SNMP Configuration Settings ......................................................................................A-42
A-14 System Configuration Settings.....................................................................................A-43
A-15 Show Port Parameters.................................................................................................A-49
Q
Page x 59022-06 A
Section 1
Introduction
This manual describes the switch management tools which include the SANbox®
Manager application (version 2.0) and the Command Line Interface (CLI) for the
SANbox2®-8c and SANbox2-16 Fibre Channel switches (firmware version 2.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 port and device management tasks.
Appendix A describes the Telnet command line interface.
Appendix B describes the optional performance monitoring application,
Fabric View.
A glossary of terms and an index are also provided.
1.1
Intended Audience
This manual introduces the switch management products and explains their
installation and use. It is intended for users responsible for installing and using
switch management tools.
1.2
Related Materials
Refer to the following manuals for information about switch hardware and
installation.
SANbox2-8c Fibre Channel Switch Installation Guide, publication number
59042-03.
SANbox2-16 Fibre Channel Switch Installation Guide, publication number
59021-06.
59022-06 A 1-1
1 – Introduction
Technical Support
1.3
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.3.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.3.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.
Q
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.3.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
1-2 59022-06 A
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
Changing the password for the default fabric view file
Setting SANbox Manager user preferences
Using online help
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 Figure 2-1.
Section 2
Table 2-1. Management Workstation Requirements
Operating System
Memory 128 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® or Netscape Navigator®
Windows® NT, 2000, 95/98
Linux® 7.2 Red Hat®
Solaris™
59022-06 A 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
SANbox2 Installation Disk - Windows Installation
SANbox2 Installation Disk - Linux Installation
SANbox2 Installation Disk - Solaris Installation
2.1.1
SANsurfer Management Suite Disk - Windows Installation
To install the SANbox Manager 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:
Q
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, choose the SANbox
Switch Software button.
3. On the SANbox Switch Software page, scroll to the SANbox2 (2Gb) Series
area.
4. In the Windows column, choose the SANbox Manager link to open the File
Download window.
5. 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 choose the Save button.
Double-click the saved sansurfer_windows_install.exe file and
follow the SANbox Manager installation instructions.
2-2 59022-06 A
2 – Using SANbox Manager
Q
2.1.2
Installing SANbox Manager
SANsurfer Management Suite Disk - Linux Installation
To install the SANbox Manager application on Linux 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 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 on the
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 default
browser.
2. On the SANsurfer Management Suite start page, choose the SANbox
Switch Software button.
3. On the SANbox Switch Software page, scroll to the SANbox2 (2Gb) Series
area.
4. In the Linux column, choose the SANbox Manager link to open the Save As
dialog.
5. Enter a path name to save the sansurfer_linux_install.bin file, and choose
the Save button.
6. Open a terminal window for the directory in which the
sansurfer_linux_install.bin file was saved, and enter the following
command and press the Enter key:
chmod +x sansurfer_linux_install.bin
7. Enter the following command:
./sansurfer_linux_install.bin
8. Press the Enter key, and follow the SANbox Manager installation
instructions.
59022-06 A 2-3
2 – Using SANbox Manager
Installing SANbox Manager
2.1.3
SANsurfer Management Suite Disk - Solaris Installation
To install the SANbox Manager application on Solaris from the SANsurfer
Management Suite CD-ROM, 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:
a. Right-click the to open the Workshops Menu.
b. Point to and select Files, then select File Manager.
c. In File Manager, double-click the CD-ROM icon, 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, choose the SANbox
Switch Software button.
Q
3. On the SANbox Switch Software page, scroll to the SANbox2 (2Gb) Series
area.
4. In the Solaris column, choose the SANbox Manager link to open the Save
As dialog.
5. Enter a path name to save the sansurfer_solaris_install.pkg file and
choose the Save button.
6. Open a terminal window for the directory in which the
sansurfer_solaris_install.pkg file was saved, and enter the following
command:
chmod +x sansurfer_solaris_install.pkg
7. Enter the following command and follow the SANbox Manager installation
instructions.
pkgadd -d QLGCsol_x.x.yyyy.mm.dd.xx.xx
Note: If you download SANbox Manager from a server, be sure the
downloaded file has execute permission before installing.
2-4 59022-06 A
Q
2.1.4
SANbox2 Installation Disk - Windows Installation
To install the SANbox Manager application on Windows from the SANbox2
Installation Disk, do the following:
1. Close all programs currently running, and insert the SANbox2 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.1.5
SANbox2 Installation Disk - Linux Installation
To install the SANbox Manager application on Linux from the SANbox2 Installation
Disk, do the following:
2 – Using SANbox Manager
Installing SANbox Manager
1. Close all programs currently running, and insert the SANbox2 Installation
Disk into the management workstation CD-ROM drive.
2. Open the File Manager and double-click on the CD-ROM icon.
3. Double click the SANbox_Manager folder, then double click the Linux folder.
4. Double click the executable file and follow the SANbox Manager installation
instructions.
2.1.6
SANbox2 Installation Disk - Solaris Installation
To install the SANbox Manager application on Solaris from the SANbox2
Installation Disk, do the following:
1. Close all programs currently running, and 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:
mount /mnt/cdrom
3. Move the directory on the disk that contains the executable. Enter the
following command:
cd cdrom/cdrom0/sanbox~1/solaris
4. Run the executable and follow the SANbox Manager installation instructions.
Enter the following command:
pkgadd -d sol_pkg
59022-06 A 2-5
2 – Using SANbox Manager
Starting SANbox Manager
2.2
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\sanbox_manager.exe
For a Linux platform, enter the SANbox_Manager command:
/SANbox_Manager/SANbox_Manager
For a Solaris platform, enter the SANbox_Manager command:
/usr/opt/QLGCsol/bin/SANbox_Manager
The application opens with the Initial Start dialog shown in Figure 2-1. If you prefer
not to see this dialog, Check the Don’t show this dialog again box. This has the
same effect as disabling the Display Initial Startup Dialog preference. Refer to
”Setting SANbox Manager Preferences” on page 2-11 for information about
setting preferences.
Q
Figure 2-1. Initial Startup Dialog
Choose Open Existing Fabric to open the Add a New Fabric dialog, which
prompts you for an fabric name, IP address, account name, and password.
Refer to ”Adding a Fabric” on page 3-3.
Choose Open Existing Fabric View File 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.
2-6 59022-06 A
Q
2 – Using SANbox Manager
Starting SANbox Manager
Choose Start Application Without Specifying a Fabric to open the
SANbox Manager window shown in Figure 2-2.
Figure 2-2. SANbox Manager Window
59022-06 A 2-7
2 – Using SANbox Manager
Exiting SANbox Manager
2.3
Exiting SANbox Manager
To exit a SANbox Manager application session, open the File menu and select
Exit. If you have made changes to the view, the Save Default Fabric File dialog,
shown in Figure 2-3, prompts you to save the view as the default fabric view file.
You may also enter a password with which to protect the default fabric view file,
but a password is not required. Refer to ”Changing the SANbox Manager Default
Fabric File Password” on page 2-10 for information about changing this password.
Choose one of the following:
Enter a password in the Default File Password field or leave it blank and
choose the Save View File button. This saves the current set of fabrics in
the default fabric view file in the working directory.
Choose the Exit Without Saving button to exit the application without
saving the current fabrics to the default fabric view file.
Choose the Cancel Exit button to cancel the exit operation.
Q
Figure 2-3. Save Default Fabric File Dialog – SANbox Manager
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
password if there is one.
Figure 2-4. Load Default Fabric File Dialog – SANbox Manager
To prevent SANbox Manager from prompting you to load and save the default
fabric view file between SANbox Manager sessions, set the View File Auto Save
and Load preferences setting to Disable (Enable is the default). Refer to ”Setting
SANbox Manager Preferences” on page 2-11 for more information.
2-8 59022-06 A
Q
2.4
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 directory is
/QLogic_Corporation/SANbox_Manager.
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, 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.
For Linux, execute the link to Uninstall_SANbox_Manager. If no links were
created during the installation, enter the following command where
INSTALL_DIR is the directory selected for installation:
2 – Using SANbox Manager
Uninstalling SANbox Manager
$INSTALL_DIR/UninstallerData/Uninstall_SANbox_Manager
For Solaris, enter the following command and follow the instructions to
uninstall the SANbox Manager application:
pkgrm QLGCsol
59022-06 A 2-9
2 – Using SANbox Manager
Changing the SANbox Manager Default Fabric File Password
2.5
Changing the SANbox Manager Default Fabric File Password
To change the password for the default fabric view file, do the following:
1. Open the File menu and select Change Default File Password to open the
Set New Password dialog as shown in Figure 2-5.
Figure 2-5. Set New Password Dialog – SANbox Manager Fabric File
Q
2. Enter the new password in the Default File Password field.
3. Re-enter the same password in the Re-enter Password to Confirm field.
4. Choose the OK button to save the changes.
2.6
Saving and Opening SANbox Manager Fabric View Files
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 in a fabric view 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 choose 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.
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.
2. Enter a name for the fabric file or choose the Browse button to select an
existing file.
2-10 59022-06 A
Q
2.7
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, 45, or 60 seconds.
Enable or disable the default view file auto save and load feature. Refer to
”Exiting SANbox Manager” on page 2-8 for more information on the default
fabric view file.
Enable 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-6
for information about the Initial Start Dialog.
Enable or disable the Event Browser. Refer to ”Displaying the Event
Browser” on page 3-9.
2 – Using SANbox Manager
Setting SANbox Manager Preferences
Choose the default port view when opening the faceplate display. You can
set the faceplate to reflect the current port mode, port speed, port
operational state, or port transceiver media. Refer to the corresponding
subsection for more information:
”Displaying Port Modes” on page 5-2
”Displaying Port Operational States” on page 5-3
”Displaying Port Speeds” on page 5-3
”Displaying Transceiver Media Status” on page 5-4
Figure 2-6. Preferences Dialog – SANbox Manager
59022-06 A 2-11
2 – Using SANbox Manager
Using Online Help
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. Choose the Apply button to save the changes.
2.8
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 choose the Help button in the tool bar. You can also display
context-sensitive help for all SANbox Manager dialogs by choosing the Help
button in the dialog.
2.9
Viewing Software Version and Copyright Information
To view SANbox Manager software version and copyright information, open the
Help menu and select About....
Q
2-12 59022-06 A
Q
2.10
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-7.
2 – Using SANbox Manager
SANbox Manager User Interface
Topology
Display
Faceplate
Display
Menu
Bar
Data Window
Tabs
Tool Bar
Data
Window
Working Status
Indicator
Figure 2-7. SANbox Manager Display Elements
59022-06 A 2-13
2 – Using SANbox Manager
SANbox Manager User Interface
2.10.1
Menu Bar
The Menu Bar presents the SANbox Manager menus as shown in Figure 2-8. The
menus and the tasks offered in them vary depending on the display. For example,
the Port menu and many of the Switch menu selections, shown in gray, appear
only in the faceplate display.
Q
File
Open View File...
Save View As...
Change Default File Password...
Preferences...
Exit
Port
Port Properties...
Ext Credit Wizard...
Port Symbolic Name
Reset Port
Port Loopback Test...
Zoning
Edit Zoning...
Edit Zoning Config...
Activate Zone Set...
Deactivate Zone Set
Restore Default Zoning
Fabric
Add Fabric...
Remove Fabric
Rediscover Fabric
Start Fabric View
Show Event Browser
View
Refresh
Layout Topology
Toggle Auto Layout
Remember Layout
View Port Modes
View Port States
View Port Speeds
View Port Media
Switch
Delete
Export Name Server
Switch Properties...
Network Properties...
Archive...
Restore...
User Accounts...
Set Date/Time...
Temperature Thresholds...
Toggle Beacon
Configure Alarm Thresholds...
Load Firmware...
Activate Firmware...
Firmware Fallback...
Reset Switch
Restore Factory Defaults
Help
Help Topics
About...
Figure 2-8. SANbox Manager Menu Structure
In addition to the menu bar, both the topology and faceplate displays have context
sensitive menus that pop up when you click in the graphic window with the right
mouse button. Refer to ”Opening the Faceplate Display and Topology Popup
Menus” on page 2-21 for more information about these popup menus.
2-14 59022-06 A
Q
2 – Using SANbox Manager
SANbox Manager User Interface
Most menu selections have shortcut keys as shown in Table 2-2.
Table 2-2. Menu Shortcut Keys
Shortcut Selection Shortcut Selection
Ctrl+O
Alt+F+O
Alt+F+A File>Save As Alt+S+E Switch>Reset Switch
Alt+F+D File>Change Default File
Alt+F+P File>Preferences Alt+P+R Port>Port Properties
Alt+F+X File>Exit Alt+P+C Port>Ext Credit Wizard
Alt+B+R Fabric>Remove Fabric Alt+P+N Port>Port Symbolic Name
Alt+B+D Fabric>Rediscover Fabric Alt+P+T Port>Reset Port
Alt+B+E Fabric>Show Event Browser Alt+P+L Port>Port Loopback Test
Alt+S+D Switch>Delete Alt+Z+E Zoning>Edit Zoning
Alt+S+E Switch>Export Name Server Alt+Z+C Zoning>Edit Zoning Config
Alt+S+A Switch>Archive Alt+Z+A Zoning>Activate Zone Set
Alt+S+R Switch>Restore Alt+Z+D Zoning>Deactivate Zone Set
Alt+S+U Switch>User Accounts Alt+Z+R Zoning>Restore Default Zoning
Alt+S+D Switch>Set Date/Time Alt+V+RF5View>Refresh
File>Open View File Alt+S+F Switch>Firmware Fallback
Alt+S+S Switch>Restore Factory
Password
Defaults
Alt+S+H Switch>Temperature
Thresholds
Alt+S+W Switch>Switch Properties
Alt+S+N Switch>Network Properties
Alt+S+G Switch>Toggle Beacon
Alt+S+C Switch>Configure Alarm
Thresholds
Alt+S+L Switch>Load Firmware
Alt+S+V Switch>Activate Firmware
59022-06 A 2-15
2 – Using SANbox Manager
SANbox Manager User Interface
2.10.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-3. 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
Q
Table 2-3. Tool Bar Buttons
Add Fabric button - adds a new fabric.
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.
Events 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-16 59022-06 A
Q
2.10.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-9. 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. Click this handle or double-click the
entry to expand or contract a fabric tree entry. A fabric entry expands to show its
member switches.
Fabric
Entry
Entry Handle
Switch
Entries
Moveable
Window Border
Figure 2-9. 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.
A blue icon indicates that a switch is unknown, unreachable, unmanageable,
or a switch with security enabled when the fabric management switch has
security disabled.
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.
59022-06 A 2-17
2 – Using SANbox Manager
SANbox Manager User Interface
2.10.4
Graphic Window
The graphic window presents graphic information about fabrics and switches such
as the fabric topology and the switch faceplate. The window length can be
adjusted by clicking and dragging the window border that it shares with the data
window.
2.10.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.
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.
Q
2.10.6
Working Status Indicator
The working status indicator, located in the lower right corner of 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-18 59022-06 A
Loading...