Simplify
SANbox2 Switch Management
User’s Guide
59022-03 D Page i
SANbox2 Switch Management
User’s Guide
Information furnished in thi s man ual is belie ved to be ac curate and rel iable . Howev er, QLogic Corporati on as sumes 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, SANbox2, SANbox Manager, and SANsurfer are trademarks or registered trademarks of QLogic
Corporation.
Microsoft, Windows, and Internet Explorer are trademarks or registered trademarks of Microsoft Corporation.
Linux is a registered trademark of Linus Torvalds.
NetScape Navigator is a registered trademark of Netscape Communications Corporation.
Solaris is a trademark of Sun Microsystems Corporation.
Brocade is a trademark of Brocade Communications Systems Inc.
All other brand and product names are trademarks or registered trademarks of their respective owners.
Document Revision History
Revision A, release, March 2002
Revision B, update, April 2002
Revision C, update, June 2002
Revision D, update, September 2002
Changes Sections Affected
Reference for SANbox2-8c Installation Guide 1.2
Login limits 3.2.1, A.3
Expanded description of soft, ACL, and VPF zones 3.4.1.1.1, 3.4.1.1.2, 3.4.1.1.3
Added Merging Fabrics and Zoning 3.4.4
Correct description of zone set activation 3.4.1.3, 3.4.6.2
Domain ID lock and principal priority 4.6.1.3
Corrected local0.notice to local0.info 4.6.2.2
Corrected factory domain ID page A-19
Restoring disimilar switches;
Restore available only for out-of-band switch
© 2000–2002 QLogic Corporation
First Printed: May 2001
All Rights Reserved Worldwide.
Printed in U.S.A.
QLogic Corporation, 6321 Bury Drive, Eden Prairie, MN 55346
(800) 342-7379 or (952) 932-4000
4.8
Page ii 59022-03 D
Table of Contents
Section 1 Introduction
1.1 Intended Audience.............................................................................................1-1
1.2 Related Ma te rials ...... .. .. .................... .................... .................... .................... .....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 For Windows:.............................................................................................2-2
2.1.2 Fo r L i n u x: . .................... .................... ................... ... .................... ................ 2-3
2.1.3 Fo r S o la ris:...................... .................... .. .................... .................... ............2-4
2.2 St arting SANbox Manager..................................................................................2-5
2.3 Exiting SANbox Manager........ .. ............................... .. ............................... .........2-7
2.4 Uninstalling SANbox Manager .............................................. ........................... ..2-8
2.5 Changing Default File Password........................................................................2-8
2.6 Setting Preferences............................................................................................2-9
2.7 Using Online Help ............................................................................................2-10
2.8 Viewing Software Version and Copyright Information......................................2-10
2.9 SANbox Manager User Interface..................................................................... 2-11
2.9.1 Menu Bar....................................... ..........................................................2-12
2.9.2 Tool Bar ................................................................................................... 2-13
2.9.3 Fabric Tree..............................................................................................2-14
2.9.4 Graphic Window ............ .................... .................... .................... ..............2-15
2.9.5 Data Window and Tabs.................................................. ..........................2-15
2.9.6 Working Status Indicator..........................................................................2-15
2.10 Using the Topology Display..............................................................................2-16
2.10.1 Switch and Link Status ...................................................... .. ....................2-16
2.10.2 Working with Switches and Links............................................................2-17
2.10.2.1 Selecting Sw itches and Links ......... ... .................... .........................2-17
2.10.2.2 Moving a Switch in the Display.......................................................2-17
2.10.2.3 Opening the Faceplate Display and Popup Menus........................2-17
2.10.3 Topology Data Windows..........................................................................2-18
2.1 1 Using the Faceplate Display.............................................................................2-18
2.11.1 Port Views and Status .................... .........................................................2-19
59022-03 D Page iii
SANbox2 Switch Management
User’s Guide
2.1 1.2 Working with Ports...................................................................................2-19
2.11.2.1 Selecting Po rts .. ................... .................... .. .................... ................. 2-19
2.11.2.2 Opening Popup Menus.................... ....................... ........................2-20
2.1 1.3 Faceplate Data Windows.........................................................................2-20
Section 3 Managing Fabrics
3.1 Security ..............................................................................................................3-1
3.1.1 User Authentication...................................................................................3-1
3.1.2 Fabric Security...........................................................................................3-1
3.2 Managing the Fabric Database.................................................. ........................3-2
3.2.1 Adding a Fabric ......................................................................................... 3-2
3.2.2 Removing a Fabric .................................................................................... 3-3
3.2.3 Opening a Fabric View File ................................................. ......................3-3
3.2.4 Saving a Fabric View File.......................................................................... 3-3
3.2.5 Rediscovering a Fabric..............................................................................3-3
3.2.6 Adding a New Switch to a Fabric......................... ............................. .. .......3-4
3.2.7 Replacing a Failed Switch in a Fabric .......................................................3-5
3.2.8 Deleting Switches and Links..................... .................................................3-5
3.3 Display in g Fa b r ic In fo rmation................................ .................... .................... .....3-5
3.3.1 Fabric Status..............................................................................................3-6
3.3.2 Active Zone Set Data Window...................................................................3-8
3.4 Zoning a Fabric ........................... ........................................................ ...............3- 9
3.4.1 Zoning Concepts ........................................................................ .. .............3- 9
3.4.1.1 Zones..............................................................................................3-10
3.4.1.2 Aliases............................................................................................ 3-11
3.4.1.3 Zone Sets.......................................................................................3-12
3.4.1.4 Zoning Database............ ................................................................3-12
3.4.1.5 Zoning Configuration............ ........................... ...............................3-13
3.4.2 Using the Zoning Config Window... .. ............................ ...........................3-15
3.4.3 Restoring Default Zoning.........................................................................3-15
3.4.4 Merging Fabrics and Zoning....................................................................3-16
3.4.4.1 Zone Merge Failure........................................................................3-16
3.4.4.2 Zone Merge Failure Recovery........................................................3-16
3.4.5 Using the Edit Zoning Window ...................... .. ........................................3-17
3.4.6 Managing Zone Sets ..................... ..........................................................3-19
3.4.6.1 C re a ting a Zone Set ............ .................... .................... ................... 3-20
3.4.6.2 Activating and Deactivating a Zone Set........................ ..................3-20
3.4.6.3 Copying a Zone to a Zone Set............................. ....................... ....3-21
3.4.6.4 Removing a Zone from a Zone Set or from All Zone Sets..............3-21
3.4.6.5 R e m o v in g a Z o ne S e t..................... .................... .................... ........3-21
Page iv 59022-03 D
SANbox2 Switch Management
3.4.6.6 R e m o v in g Al l Zo n ing Definitions.......... .. .. .................... ................... 3-22
3.4.7 Managing Zones....................................................... .. ........................ .....3-22
3.4.7.1 Creating a Zone in a Zone Set .......................................................3-22
3.4.7.2 Adding Zone Members.................................... ........................ .......3-23
3.4.7.3 Renaming a Zone or a Zone Set ....................... .............................3-24
3.4.7.4 R e m o v in g a Z o ne M e m b e r ......... .. .................... .................... ..........3-24
3.4.7.5 Removing a Zone from a Zone Set ................................................3-24
3.4.7.6 R e m o v in g a Zo ne fr o m Al l Z on e Se ts...... .. .................... ................. 3-24
3.4.7.7 Changing Zone Types ................................. ...................................3-25
3.4.8 Managing Aliases.......................................................... .. ........................3-25
3.4.8.1 Creating an Alias ............................................................................3-25
3.4.8.2 A d d in g a M e mb e r to a n A lias . ................... .................... .................3-26
3.4.8.3 Removing an Alias from All Zones .................................................3-26
User’s Guide
Section 4 Managing Switches
4.1 Display in g S w itc h In fo r m a tion.................... .................... .................... ................ 4-1
4.1.1 Dis p l a y in g H a rd wa re Status ................ .................... .................... ..............4-2
4.1.2 Name Server Data Window.......................................................... .............4-3
4.1.3 Switch Data Window..................................................................................4-4
4.1.4 Port St atistics Data Window ......................................................................4-5
4.1.5 Port Information Data Window...................................................................4-5
4.1.6 Configured Zonesets Data Window...........................................................4-6
4.1.7 Alarm Log Data Window................................ ............................................4-6
4.2 Exporting Alarm Log Information to a File................ .. ........................................4-7
4.3 Exporting Name Server Inf or ma tion to a File................................ .................... . 4-7
4.4 Paging a Switch..................................................................................................4-7
4.5 Resetting a Switch..............................................................................................4-7
4.6 Configuring a Switch ..........................................................................................4-7
4.6.1 Sw itch Configuration............... .. .. ...................................... .................... .....4-8
4.6.1.1 C h a ssis Name .......................... .................... .................................... 4-8
4.6.1.2 Switch Admin istrative States............................... ..............................4-8
4.6.1.3 D o m a in ID.......................... .................... .................... .................... ...4-9
4.6.1.4 Broadcast Support............................................................................4-9
4.6.1.5 Timeout Values...............................................................................4-10
4.6.2 Network Configuration............................................................................. 4-11
4.6.2.1 IP C o n fig u ration........ ... ................... .................... ... ................... ......4-12
4.6.2.2 Remote Logging.............................................................................4-13
4.6.2.3 S N M P C o n fig u r a tio n................... .. .................... .. .................... ........4-13
4.6.2.4 S N M P Trap Confi g u ra tion....... .. .. .................... .................... ............4-14
4.6.3 Co n figuration Backup ........ .................... .................... .. .................... ........4-14
59022-03 D Page v
SANbox2 Switch Management
User’s Guide
4.6.4 Co n figuration Restore ................... .................... .................... ................... 4-14
4.6.5 Re in i t ia lizing the Configura tio n F ile S y stem..................... .................... .. . 4-15
4.7 Archivin g a Switch......................... ................... .................... .................... .. ......4-15
4.8 Restoring a Switch ...........................................................................................4-16
4.9 Loading Firmware............. ................................................................................4-16
4.10 Restoring the Factory Default Configuration.................................................... 4-17
Section 5 Managing Ports
5.1 Display in g P or t In f o rm a t io n .... .. .. .................... .................... .................... .. ..........5-1
5.1.1 Mo n itoring 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 D is p l a y in g Tranceiv e r Med i a Status ................................. ................ 5-4
5.1.2 Port St atistics 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-8
5.2.1 Changing Port Administrative States.........................................................5-9
5.2.2 Changing Port Speeds ......................... .. ........................... ........................5-9
5.2.3 Changing Port Modes................................................. .............................5-10
5.2.4 Changing TL Modes... .............................................................................5-11
5.2.5 Changing Buffer-to-Buff er Credits ....................... ......................... .. ......... 5-11
5.2.6 I/O Stream Guard .................................................................................... 5-11
5.2.7 Extending Port Credits................................................... .......................... 5-11
5.2.8 Resetting a Port.......................................................................................5-13
5.3 Testing Ports..................................................................................................... 5-13
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 Comma n d........................ .. .................... .................... .................... .A-4
Alias Comman d ...... ... ................... .................... .................... .................... .A-5
Config Comma n d................................... .................... .................... ............A-7
Date Comman d ................................. .................... .................... ................A-9
Fallback Command..................................................................................A-10
Help Comman d.................................. .................... .................... ..............A-11
History Command....................................................................................A-12
Image Comma n d.................. .. .................... .................... .. .................... ...A-13
Page vi 59022-03 D
SANbox2 Switch Management
User’s Guide
Lip Command..........................................................................................A-14
Passwd Comma n d ............ .................... .................... .................... ..........A-15
Ps Command...........................................................................................A-16
Quit Command ........................................................................................A-17
Reset Command............................................ .. ........................................A-18
Set Alarm Clear Command......................................................................A-22
Set Beacon Co m ma n d ............. .. .................... .................... .................... .A-23
Set Config Com m a n d .......................... .................... .................... ............A-24
Set Log Comman d................ .. .................... .................... ................... ......A -3 0
Set Port Comm a nd..................................... .................... ................... ......A -3 3
Set Setup Com m a n d ......................... .................... .................... ..............A-34
Set Switch Com m a n d..................................... .................... .................... .A-38
Show Command......................................................................................A-39
Show Config Command.................... ............................. ..........................A-48
Show Log Command..................... ........................................ ..................A-50
Show Perf Command ..............................................................................A-52
Show Setup Command............................................................................A-53
Shutdown Command...............................................................................A-55
Test Command ........................................................................................A-56
Uptime Command............................. .. .. .. .. ...................................... .........A-58
User Comman d ............. .. .. .................... .................... .................... ..........A-59
Whoami Command.............................................................................. .. ..A-61
Zone Command....................................................................................... A-62
Zoneset Command....................................................... ...........................A-65
Zoning Command.......................... ........................... .. .. ...........................A-67
Glossary
Index
59022-03 D Page vii
SANbox2 Switch Management
User’s Guide
Figures
Figure Page
2-1 SANbox Manager Window............................... ............................. .................................2-5
2-2 Load Default Fabric View File Window.............. ....................... .....................................2-6
2-3 Add a New Fabric Window........................................................ .....................................2-6
2-4 Save Current Fabric View Window ................................................................................2-7
2-5 Set New Password Window...........................................................................................2-8
2-6 Prefere n c e s Wi nd o w............... .. .. .................... .................... .................... .. .................... . 2-9
2-7 SANbox Manager Display Elements..................... .. ................................................... ..2-11
2-8 SANbox Manager Menu Structure.......... ............................. .. ......................................2- 12
2-9 Fabric Tree...................................................................................................................2-14
2-10 Topology Display..........................................................................................................2-16
2-11 Faceplate Display......................................................................................................... 2-18
3-1 Add a New Fabric Window........................................................ .....................................3-2
3-2 Active Zone Set Data Window.......................................................................................3-8
3-3 Zoning Config Window.................................................................................. ...............3-15
3-4 Edit Zoning Window.... ............................ ........................... ........................... ...............3-17
4-1 Faceplate Display........................................................................................................... 4-2
4-2 Facepl ate Display - Chassi s L E D Cl u st e r ... .................... ..................................... ..........4-3
4-3 Configured Zonesets Data Window............. ............................................ ......................4-6
4-4 Switch Properties Window.............................................................................................4-8
4-5 Network Properties Window.................................. .. ........................... ..........................4-11
5-1 Facepl at e Display - Port Inform a tio n...................... ..................................... ................... 5-1
5-2 Port Properties Window .................................................................................................5-8
5-3 Extended Credits Window...................................................... ....................... ...............5-12
5-4 Port Loopback Test Window.. .................... ...................... ...................... ......................5-13
Tables
Table Page
2-1 Management Workstation Requirements.......................................................................2-1
2-2 Menu Shortcut Keys.....................................................................................................2-12
2-3 Tool Bar buttons.................................. ................................................... .. ....................2-13
3-1 Topology Display Switch and Status Icons....................................................................3-6
3-2 Edit Zoning Window Tool Bar Buttons ..................................................... ....................3-18
4-1 Name Server Data Window Entries ...................... .......................... ...............................4-3
4-2 Switch Data Window Entries..........................................................................................4-4
4-3 Switch A d m in istrative States... .. .................... ...................................... ................... ........4-8
4-4 Timeout Values............................................................................................................4-10
4-5 IP Configu ration Parameters. .. .. .................... .................... .................... .................... ...4-1 2
4-6 SNMP Co n fig u r a tio n P a ra m e t e rs... .. .................... ................... .................... ................. 4-13
4-7 SNMP Trap Configuration Parameters ........................................................................4-14
4-8 Factory Default Configuration Settings ........................................................................4-17
5-1 Port Modes.....................................................................................................................5-2
5-2 Port Operational States............................ .. ................................................... .. ...............5-3
Page viii 59022-03 D
SANbox2 Switch Management
5-3 Port Speeds .................... ......................................................................... ......................5-3
5-4 Transceiver Media View.................................................................................................5-4
5-5 Port Statistics Data Window Entries...............................................................................5-4
5-6 Port Info Data Window Entries.............. ...................... ............................................ .......5-7
5-7 Port Administrative States..............................................................................................5-9
5-8 Port Speeds .................... ......................................................................... ....................5-10
5-9 Port Modes...................................................................................................................5-10
A-1 Commands Listed by Authority Level....................................... ....................... ...............A-3
A-2 Switch Configuration De fa u l t s................ .................... .................... .................... ..........A-19
A-3 Port Configuration Defaults..........................................................................................A-19
A-4 SNM P C o n fig u ration Defaults ........ .. .. .................... .................... .................... ..............A-20
A-5 System Configuration Defaults.....................................................................................A-21
A-6 Set C o n fig P o rt Pa r ameters................. .................... .................... .................... ............A-24
A-7 Set C o n fig S w it ch P a ra me ters..................................... .................... .................... ........ A -2 6
A-8 Set C o n fig Z o ni n g Parameters............................... .. .................... .................... ............A-27
A-9 SNM P C o n fig u ration Settings .................................. .................... .................... ............A-34
A-10 System Configuration Settings.....................................................................................A-35
A-11 Show Port Parameters.................................................................................................A-40
User’s Guide
59022-03 D Page ix
SANbox2 Switch Management
User’s Guide
Notes
Page x 59022-03 D
Section 1
Introduction
This manual describes the switch management tools which incl ude the SANbox
Manager® application and the Command Line Interface (CLI). These switch
management tools support SANbox2 switches.
The SANbox Manager switch management applic ati on is t he primar y f ocus of t his
manual which is organized as follows:
■ Section 1 describes the intended audience for this manual, related
materials, and technical supp ort.
■ 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 managemen t tasks.
■ Appendix A describes the Command Line Interface.
A glossary of terms and an index are also provided.
1.1
Intended Audience
This manual introduces QLogic switch management products and explains their
installation and use. It is intended for users responsible for installing and using
network management tools.
1.2
Related Materials
Refer to the following manual for switch hardware and installation information:
■ SANbox2-16 Fibre Channel Switch Installation Guide, publication number
59021-03.
■ SANbox2-8c Fibre Channel Switch Installa tion Guide, publication number
59042-00.
59022-03 D 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 switch support Web si te listed in 1.3.3 Contact Informatio n for the latest firmware and software updates.
1.3.1
Availability
QLogic Technical Suppor t 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 the followi ng technical training courses:
■ Switch Cert if ic a tio n
■ HBA Certification
Each course is available at the train ing faci lity in Eden Prairi e, MN or at your local
facility. All courses include a Fibre Channel overview and sections on installation,
maintenance, and topology solutions. Each st udent receives a set of manuals and
a CD-ROM containing course training materials. Upon successful completion of
the training, QLogic awards a certificate identifying the student as a Certified
SANbox™ or SANblade™ Professional.
1.3.3
Contact Information
Address: QLogic Switch Products Inc.
Telephone: +1 952-932-4040
Fax: +1 952-932-4018
Email:
Technical Service
Technical Training
6321 Bury Drive
Eden Prairie, Minnesota 55346
USA
support@qlogic.com
tech.training@qlogic.com
Switch Support Web Site:
1-2 59022-03 D
www.qlogic.com/support/home_support.asp
Using SANbox Manager
This section describes how to use the SANbox Manager application and it s
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 workst ation with the
following characteristics:
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 port, 10/100 Base-T Ethernet port
Internet Browser Microsoft® Internet Explorer® or Netscape Navigator®
■ Windows® NT, 2000, 95/98
■ Linux® 6.2 Red Hat
■ Solaris™
59022-03 D 2-1
2 – Using SANbox Manager
Installing SANbox Manager
2.1.1
For Windows:
To instal l the SANbox Manager application on Windows from the SANsurfer® Tool
Kit CD-ROM, do the following:
1. Close all programs currentl y runnin g, and Insert the SANsurfe r Tool Kit
2. On the SANsurfer Tool Kit start page, choose the SANbox Switch
3. On the SANbox Switch Software page, scroll to the SANbox2 (2Gb)
CD into the management workstation CD-ROM drive. If the SANsurfer
Tool Kit start page does not open in your default browser, do the
following:
a. Using Windows Explorer, double-click the drive letter which
contains the SANsurfer Took Kit CD.
b. Locate and double-click the Start_Here.htm file to open the
SANsurfer Tool Kit start page in your default browser.
Software button.
Series area.
4. In the Windows column, choose the SANbox Manager link t o open the
File Download window.
5. You have a choice of running the installation file from the CD-ROM or
downloading the installati on 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-03 D
2.1.2
For Linux:
2 – Using SANbox Manager
Installing SANbox Manager
To instal l the SANbox Manager application on Linux from the SANsurfer Tool Kit
CD-ROM, do the following:
1. Close all programs currently runni ng, and insert t he SANsurfer Tool Kit
CD into the management workstation CD-ROM drive. If a fil e browser
window opens showing icons for the contents of the CD-ROM,
double-click the Start_Here.htm file to open the SANsurfer Tool Kit
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 on the, 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 Tool Kit start page opens in your default browser.
2. On the SANsurfer Tool Kit 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 window.
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:
chmod +x sansurfer_linux_install.bin
7. Press the Enter key.
8. Enter the following command:
./sansurfer_linux_install.bin
9. Press the Enter key, and follow the SANbox Manager installation
instructions.
59022-03 D 2-3
2 – Using SANbox Manager
Installing SANbox Manager
2.1.3
For Solaris:
To install the SANbox Manager application on Solaris from the SANsurfer Tool Kit
CD-ROM, do the following:
1. Close all programs currently runni ng, and insert t he SANsurfer Tool Kit
2. On the SANsurfer Tool Kit start page, choose the SANbox Switch
CD into the management workstation CD-ROM drive. If the SANsurfer
Tool Kit start page does not open in your default browser, do the
following:
a. Right-click the to open the Works pace 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 fil e to
open the SANsurfer Tool Kit start page in your default browser.
Software button.
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 window.
5. Enter a path name to save the sansurfer_solaris_install.bin file and
choose the Save button.
6. Open a terminal window for the directory in which the
sansurfer_solaris_install.bin file was saved, and enter the followin g
command:
chmod +x sansurfer_solaris_install.bin
7. Press the Enter key.
8. Enter the following command:
./sansurfer_solaris_install.bin
9. Press the Enter key, and follow the SANbox Manager installation
instructions.
Note: If you download SANbox Manager from a server, be sure the
downloaded file has execute permission before installing.
2-4 59022-03 D
2.2
Starting SANbox Manager
To start the SANbox Manager application for the first time, choose one of the
following, and press the Enter key:
■ 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.
■ For a Linux platform, enter the following on the command line:
# /SANbox_Manager/SANbox_Manager
■ For a Solaris platform, enter the foll o wing on the command line:
/usr/opt/QLogic_Corporation/SANbox_Manager/SANbox_Manager
The SANbox Manager application opens with the display shown in Figure 2-1.
2 – Using SANbox Manager
Starting SANbox Manager
Figure 2-1. SANbox Manager Window
59022-03 D 2-5
2 – Using SANbox Manager
Starting SANbox Manager
If the default fabric view fil e e xists, the system prompts you to enter th e fil e
password as shown in Figure 2-2. Enter the password and choose the Load View
File button to open the SANbox Manager appli cation a nd loa d a previ ously s aved
set of fabrics. Otherwise, choose the Continue Without Loading button to open
an empty fabric view. Choose Add button to open the Add a New Fabric window
shown in Figure 2-3.
Figure 2-2. Load Default Fabric View File Window
To start usi ng the SANbox Mana ger application, do the following to add a fabric:
1. Open the Fabric menu and select Add Fabric to open the Add a New Fabric
window as shown in Figure 2-3.
Figure 2-3. Add a New Fabric Window
2. Enter a fabric name and the IP address of the switch through which to
manage the fabric.
3. Enter an account name and a password. The factory accoun t name is
"admin" and the factory password is "password". If security is turned off
(default), you are not required to enter an account name or password. This
password is for the switch and is stor ed in the switch firmware. Refer to the
User Command on page A-59 for more information.
4. Choose the Add Fabric button.
2-6 59022-03 D
2.3
Exiting SANb ox Manager
When exiting SANbox Manager, the current fabri c view i s encrypt ed and save d to
the default fabric view file (fc_view.dft). A password is required to encrypt and
save the default fabric view file the first time you exit SANbox Manager. When you
exit subsequent sessions, SANbox Manager closes and saves the default fabric
view file automatically without having to enter a password.
In your next session, SANbox Manager opens the default fabric view file
automatically after entering i ts password. To prevent SANbox Manager from
automatically saving the default fabr ic view file each time you exit SANbox
Manager, set the View File Auto Save and Load preferences setting to Disable
(Enable is the default). Refer to ”Setting Preferences” on page 2-9 for more
information.
To exit a SANbox Manager applicati on session, open the File menu and select
Exit. The system prompts you to enter a passwor d with which to protect the
default fabric view file as shown in Figure 2-4. Choose one of the following:
2 – Using SANbox Manager
Exiting SANbox Manager
■ Enter a password and choose the Save Vi ew Fil e button t o save the cur rent
set of fabrics in the default fabric view file (fc_view .dft) 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 exi t operation.
Figure 2-4. Save Current Fabric View Window
If the default fabric view file was saved wit h a password, the next time you open
the SANbox Manager application, you will be prompted for the password in the
Load Default Fabric View File windo w as shown in Figure 2-2. Your fabric opens
after entering the password.
59022-03 D 2-7
2 – Using SANbox Manager
Uninstalling SANbox Manager
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 user’s home directory during the
SANbox Manager installation proce ss. The default installation director y is the
user’s home directory /QLogic_Corporation/SANbox_Manager.
To uninstall the SANbox Manager application:
1. Browse for the uninstall program file or the shortcut/link that points to the
uninstall program fil e. The uninst all program shortc ut is in the sa me folder as
the program shortcut (Start menu, program group, on, or user speci fied) th at
is used to start the SANbox Manager application.
2. Double-click the uninstall program file or shortcut/link, and follow the
instructions to uninstall the SANbox Manager application.
Note: For UNIX uninstalls, execute the link to Uninstall_SANbox_Manager. If
no links were created during the instal lation, run:
$INSTALL_DIR/UninstallerData/Uninstall_SANbox_Manager. Where
INSTALL_DIR is the directory selected for installation.
2.5
Changing Default 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 t he
Set New Password window as shown in Figure 2-5.
Figure 2-5. Set New Password Window
2. Enter the new password in the Default File Pass wo rd field.
3. Re-enter the same password in the Re-enter Password to Confi rm fi eld.
4. Choose the OK button to save the changes.
2-8 59022-03 D
2.6
Setting Preferences
Using the Preferences settings, you can:
■ Change the location of the working directory (user’s home directory is the
default) used to save files
■ Change the location of the browser used to view the online help
■ Choose the polling frequency. That is, how often the SANbox Manager
application polls the fabric. Rapid (default) is the normal polling level,
Intermediate is 1.5 times slower than the rapid level, and Slow is 2 times
slower than rapid level.
■ Enable or disable the default view file auto save and load feature. Refer to
”Starting SANbox Manager” on page 2-5 for more information on the default
fabric view file.
■ Choose the default port view when opening the faceplate display. Refer to
”Monitoring Port Status” on page 5-2 for more information on port views.
2 – Using SANbox Manager
Setting Preferences
Figure 2-6. Preferences Window
To set user preferences for your SANbox Manager sessions, do the following:
1. Open the File menu, and select Preferences to open the Preferences
window.
2. Enter or browse for paths to the working directory and browser.
3. In the Application-wide Options area, choose the polling frequency, enable
or disable the View File Auto Save and Load feature, and choose the initial
port view when entering the faceplate display.
4. Choose the Apply button to save the changes.
59022-03 D 2-9
2 – Using SANbox Manager
Using Online Help
2.7
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.
2.8
Viewing Software Version and Copyright Information
To view SANbox Manager software version and copyright information, open the
Help menu and select About....
2-10 59022-03 D
2.9
SANbox Manager User Interface
The SANbox Manager application uses two basic displays to manage the fabri c
and individual switches: the topology di splay and the faceplate display. The
topology display shows all switches th at are able to communicate and all
connections between switches. The faceplat e 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-03 D 2-11
2 – Using SANbox Manager
SANbox Manager User Interface
2.9.1
Menu Bar
The Menu Bar presents the SANbox Manager menus as shown in Figure 2-8. The
menus and the tasks of f ered in the m vary dependi ng on the di splay. Fo r examp le,
the Port menu and many of the Switch menu selections appear only in the
faceplate display. Menu items with a gray background.
File
Open View File...
Save View As...
Change Default File Password
Preferences
Exit
Zoning
Edit Zoning
Edit Zoning Config
Activate Zone Set
Deactivate Zone Set
Restore Default Zoning
Figure 2-8. SANbox Manager Menu Structure
Fabric
Add Fabric...
Remove Fabric
Rediscover Fabric
View
Refresh
View Port Modes
View Port S t a tes
View Port S pe eds
View Port Media
Switch
Delete
Export Name Server
Archive
Restore
Load Firmware
Switch Properties
Network Properties
Toggle Beacon
Export Alarm Log
Reset Switch
Restore Factory Defaults
Port
Port Properties
Extended Credits
Reset Port
Port Loopback Test
Help
Help To pi cs
About...
Some menu selections have shortcut keys as shown in Table 2-2.
Table 2-2. Menu Shortcut Keys
Shortcut Key Menu Selection
F5 key View>Refresh
Ctrl+O File>Open View File
In addition to the menu bar, both the topology and facepla te dis plays have cont ext
sensitive menus that pop up when you click in the graphic window with the right
mouse button. Refer to ”Opening the Faceplate Display and Popup Menus” on
page 2-17 for more information about these popup menus.
2-12 59022-03 D
2.9.2
Tool Bar
2 – Using SANbox Manager
SANbox Manager User Interface
The Tool Bar consists of a row of graphical but tons 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.
Table 2-3. Tool Bar buttons
Tool Bar Button Description
Add Fabric button - adds a new a 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 - polls fabric to update topology or faceplate display
with current information.
Help Topics button - opens the online help file.
Edit Zoning button - opens the Edit Zoning window (available only
in faceplate display).
59022-03 D 2-13
2 – Using SANbox Manager
SANbox Manager User Interface
2.9.3
Fabric Tree
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 red icon indicates a communications failure.
■ A blue icon indicates that a switch is unknown, or a switch with security
enabled when the fabric management switch has security disabled.
■ A yellow icon indicates that a switch is operational with errors.
The fabric tree provides access to the topology and facepl ate 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-14 59022-03 D
2.9.4
Graphic Window
The graphic window present s graphic information abou t 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.9.5
Data Window and Tabs
The data window presents a tabl e of data and statistics associated with the
selected tab. Use the scroll bar to browse thr ough the data. The window length
can be adjusted by clicking and drag ging the b order that i t shares wi th the graphi c
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 .
2 – Using SANbox Manager
SANbox Manager User Interface
2.9.6
Working Status Indicator
The working statu s indicator, located in the lower right corne r of SANbox Manager
window , shows when the management workstat ion is exchanging inf ormation with
the fabric. As conditions change, the fabric forwards this information to the
management workstation where it is reflected in the various displays.
59022-03 D 2-15
2 – Using SANbox Manager
Using the Topology Display
2.10
Using the Topology Display
The topology display shown in Figure 2-10 polls the selec ted fabric and displays
its topology. Switches and inter-switch links (ISL) appear in the graphic window
and use color to indicate status. Consider the following features of the topology
display:
■ Switch and link status
■ Working with switches and li nks
■ Topology data windows
Figure 2-10. Topology Display
2.10.1
Switch and Link Status
Switch icon shape and color provide informat ion about the switch and its
operational state. Lines represent links between switches. The topology display
uses green to indicate normal operati on, yellow to indic ate operational wi th errors,
red to indicate inactive or failure, and blue to indicate unknown. Refer to ”Fabric
Status” on page 3-6 for more information about topology display icons.
2-16 59022-03 D
2.10.2
Working with Switches and Links
Switch and link icons are selectable and moveabl e, 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. The
context-sensitive popup menus are accessible through the switch and link icons.
2.10.2.1
Selecting Switches and Links
Selected switch icons are highlighted in violet. Selected ISLs are highlighted in
yellow. 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 in the graphic window background.
Select Select All Switches or Select All Links from the popup menu.
To cancel a selection, press and hold the Control key, and select the item again.
To cancel multiple selections, click in the graphic window background.
2 – Using SANbox Manager
Using the Topology Display
2.10.2.2
Moving a Switch in the Display
To move a switch icon, click and drag the icon to another location in the graphic
window . Links stretch or contract to remain connected.
2.10.2.3
Opening the Faceplate Display and 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.
■ T o open the fabric popup menu when viewi ng the topology display, right-click
the graphic window background. The fabric popup menu pr esents sel ections
to refresh the fabric, select all switches, select all links, or layout topology.
■ To open the switch popup menu when viewing the topology display,
right-click the switch icon in the graphic window. The switch popup menu
presents selections to ref resh the switch, delete the switch from the display,
open the Switch Properties window, or open the Network Properties window.
■ To open the link popup menu, right-click the link. The Link popup menu
presents a selection to delete the link from the display .
■ To open a faceplate display popup menu, right-click the faceplate graphic in
the graphic window. The faceplate popup menu presents selections to
refresh the switch, select all ports, manage switch, port, and network
properties, extend credits, and run the Port Loopback tests.
59022-03 D 2-17
2 – Using SANbox Manager
Using the Faceplate Display
2.10.3
Topology Data W indows
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
location within the current fabric configuration. Refer to ”Name Server Data
Window” on page 4-3 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-8 for more information about this data window. Refer to ”Zoning a
Fabric” on page 3-9 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-4 for more
information.
2.11
Using the Faceplate Display
The faceplate display shown in Figure 2-11 displays the switch name and
operational state, and port status. Consider the following functi onal elements of
the faceplate display:
■ Port views and status
■ Working with ports
■ Faceplate data windows
Figure 2-11. Faceplate Display
2-18 59022-03 D
Loading...