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
2.11.1
Port Views and Status
Port color and text provides information about the port and its operational state.
Green indicates active ; gray i ndicat es inacti ve. Th e f aceplat e displ ay provi des the
following views of port status corresponding to the View menu options in the
faceplate display. Refer to ”Monitoring Port Status” on page 5-2 for more
information about these displays.
■ Port mode
■ Port state
■ Port speed
■ Port media
2.11.2
Working with Ports
Ports are selectable and serve as access points for other displays and menus.
You select ports to display information about them in the data win dow or to modify
them. Context sensitive popup menus and propertie s windows are accessible
through the faceplate and port icons.
2 – Using SANbox Manager
Using the Faceplate Display
2.11.2.1
Selecting Ports
You can select ports in the following ways. Selected ports are highlighted with a
white border.
■ To select a port, click the port in the faceplate display.
■ To select a range of consecutive por ts, select a port, th en press and hold the
■ To select several non-consecutive ports, hold the Control key while
■ To select all ports, right-cli ck anywher e in t he graphi c win dow. Select Select
To cancel a selection, press and hold the Control key and select it again.
shift key and select another port. The appl ic ation sel ect s bot h end port s and
all ports in between in port number sequence.
selecting.
All Ports from the popup menu.
59022-03 D 2-19
2 – Using SANbox Manager
Using the Faceplate Display
2.11.2.2
Opening Popup Menus
Using the right mouse button, you can open the faceplate popup menu. This
popup menu presents several selections to manage the switch and its ports.
■ To open the popup menu, right-click anywhere in the graphic window. If no
ports are selected, port specific tasks will be unavailable in the menu.
■ To select one or more ports and open the Port popup menu, right-click a
port.
2.11.3
Faceplate Data Windows
The faceplate display provides the following data windows corresponding to the
data window tabs:
■ Name Server - displays all devices connected to the switch that are logged
with the name server.
■ Switch - displays current switch configuration data.
■ Port Statistics - displays port performance data for the selected port(s).
■ Port Information - displays port detail information for the selected port.
■ Configured Zonesets - displays all zone sets, zones, and zone membership
in the zoning database.
■ Alarm Log - displays the system error information.
2-20 59022-03 D
3.1
Security
Section 3
Managing Fabrics
This section describes the following tasks that manage fabrics:
■ Security
■ Managing the fabric database
■ Displaying fabric information
■ Zoning a fabric
The two components of SANbox2 security are user authentication and fabric
security. The user must be authenticated before gaining access to a switch. If an
invalid account name/password combination is entered, that user can not access
the switch, and thus can not gain access to the fabric. If security is enabled (on)
and a valid account name/p ass word combinati on is entered, t hat user can access
the switch but can not execute any command that exceeds their autho rity
(privileges) level. If security is disabled (off) and a valid account name/passwor d
combination is entered, that user has access to all switches in the fabric and can
execute all commands (both user and admin), regardless of their authority
(privileges) level.
3.1.1
User Authentication
User authentication pert ains to accessing a switch based on a valid account
name/password combination entered by the user. The valid account
name/password/system privilege s combinations are set up by the system
administrator, and define which set of system commands each user may execute
if a valid account name/password combination is entered. The system privileges
are tied to the account name/password combinat ion.
3.1.2
Fabric Security
Fabric security pertai ns to whether all switches in the fabric are configured to
permit access to each switch in that fabric. All switches in the fabric should be
configured with the same security setting (enabled/true or disabled/false). By
default, security is disabled. Once access is gained to the entry switch in a fabric,
that user may access all switches in that fabr ic.
59022-03 D 3-1
3 – Managing Fabrics
Managing the Fabric Database
3.2
Managing the Fabric Database
A fabric database contains the set of fabrics that you have added during a
SANbox Manager session. Initially, the SANbox Manager application opens with
an empty fabric database.
3.2.1
Adding a Fabric
To add a fabric to the database, do the following:
1. Open the Fabric menu and select Add Fabric to open the Add a New Fabric
window as shown in Figure 3-1.
Figure 3-1. 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. The factory account name and password are
(admin, password). Choose the Add Fabric button.
This password is for the switch and is stored in the switch firmware. If
security is turned off (default), you are not required to enter an account
name or password. Refer to ”Security” on page 3-1. Refer to the Set Setup
Command on page A-34 for account name, password, and security
information.
Note: A switch supports a combined maximum of 15 logins. This incl udes
SANbox Manager inband and out-of-band logins, Telnet out-of-band
logins, and SNMP out-of-band logins. Additional logins will be refused.
3-2 59022-03 D
3.2.2
Removing a Fabric
To delete a fabric file from the database, do the following:
1. Select a fabric in the fabric tree.
2. Open the Fabric menu and select Remove Fabric.
3.2.3
Opening a Fabric View File
To open an existing view file, do the following:
1. Open the File menu, and select Open View File, or choose the Open
button. If the fabric you are currently has changed, you will be prompted to
save the changes to the view file before opening a different view file.
2. In the Open View window, enter the name of the file to open.
3. Enter a file password, if necessary.
4. Choose the Load View File button. If the fabric has changed, you will be
prompted to save before opening the new view.
3 – Managing Fabrics
Managing the Fabric Database
3.2.4
Saving a Fabric View File
To save a view file, do the following:
1. Open the File menu, and select Save View As.
2. In the Save View window, enter a new file name.
3. Enter a file password, if necessary.
4. Choose the OK button.
3.2.5
Rediscovering a Fabric
After making changes to or deleting swi tches from a fabric view, it may be helpful
to again view the actual fabric configuration. The rediscover fabric option clears
out the current fabric information being displayed, and rediscovers all switch
information. To rediscover a fabric, open the Fabr ic menu, and select Rediscover
Fabric.
59022-03 D 3-3
3 – Managing Fabrics
Managing the Fabric Database
3.2.6
Adding a New Switch to a Fabric
If there are no special conditions to be configur ed for the new switch, simply plug
in the switch and the switch becomes functional with the defaul t fabric
configuration. The default fabri c configuration settings are:
■ Fabric zoning is sent to the switch from the fabric.
■ All ports will be GL_Ports.
■ The default IP address 10.0.0.1 is assigned to the switch without a gateway
or boot protocol configured (RARP, BOOTP, and DHCP).
If you are adding a new switch to a fabric and do not want to accept the default
fabric configuration, do the following:
1. If the switch is not new, reset the switch to factory configuration before
adding the switch to the fabric using the Restore Factory Defaults option in
the Switch menu.
2. If you want to manage the switch through the Ethernet port, you must first
configure the network SNMP configuration using the Network Properties
window.
3. Configure any special switch settings (default visibility, broadcast support,
and orphan zone behavior). We suggest configuring Default Vi sibil ity set ting
to None in the Zoning Config window to prevent communication with other
switches in the fabric until the new switch is configured.
4. Plug in the inter-switch links (ISL), but do not connect the devices.
5. Configure the port types for the new switch (GL_Port, TL_Port , Donor) using
the Port Properties window.
6. Connect the devices to the switch.
7. Make any necessary zoning changes using the Edit Zoning window.
3-4 59022-03 D
3.2.7
Replacing a Failed Switch in a Fabric
To replace a failed switch in a fabric, plug in the switch and copy the archived
switch configuration file to the switch usi ng the Restore function. Refer to
”Restoring a Switch” on p age 4-16 and ”Archiving a Switch” on page 4-15 for more
information. The switch configuration must be archived before it can be restored.
To replace a failed switch using the SANbox Manager Restore function:
1. Unplug and remove the failed switch.
2. Plug in the new replacement switch.
3. Open the topology display and select the replacement switch.
4. Open the Switch menu and select Restore.
5. In the Restore Switch window, enter a name or choose the archived switch
configuration file to copy to the switch.
6. Choose the OK button to writ e the confi guration file to the switch.
3 – Managing Fabrics
Displaying Fabric Information
3.2.8
Deleting Switches and Links
The SANbox Manager application does not automatically delete switches or links
that have failed or have been physicall y removed from the Fibre Chann el network.
In these cases, you can delete switches and links t o bring the display up to date. If
you delete a switch or a link that is still active, the SANbox Manager application
will restore it automatically. You can also refresh the display. To delete a switch
from the topology display, do the following:
1. Select one or more switches in the topology display.
2. Open the Switch menu and select Delete.
To delete a link, do the following:
1. Select one or more links in the topology display.
2. Open the Switch menu and select Delete.
3.3
Displaying Fabric Information
The topology display is your primary tool for monitoring a fabric. The graphics
window of the topology display provides status information for switches,
inter-switch links, and the Eth ernet connection to the management workstation.
The data window tabs show name server, switch, and active zone set information.
The Active Zoneset tab shows the zone definitions for the active zone set. Refer
to ”Name Server Data Window” on page 4-3 and ”Switch Data Window” on
page 4-4 for information about the Name Server and Switch data windows.
59022-03 D 3-5
3 – Managing Fabrics
Displaying Fa bric Information
3.3.1
Fabric Status
The fabric updates the topology and faceplate displays by forwarding changes in
status to the management workstat ion as they occur. You can allow the fabric to
update the display status, or you can refresh the display at any time. To refresh
the topology display, do one of the following:
■ Choose the Refresh button.
■ Open the View menu and select Refresh.
■ Press the F5 key.
■ Right-click anywhere in the background of the topology display and select
Refresh Fabric from the popup menu.
The topology display uses switch and status icons to provide status information
about switches, inter-switch links, and the Ethernet connection. The switch icons
indicate 16 port switch or an unknown switch type. The switch status icons,
displayed on the left side of a s wit ch, vary in sh ape and col or. Switches controlled
by an Ethernet Internet Protocol have a colored Ethernet icon displayed on the
right side of the switch. A green Ethernet icon indicates normal operation, yellow
indicates operational with error s, and red indicates inactive or failure. Table 3-1
shows the different switch icons and their meanings.
Table 3-1. Topology Display Switch and Status Icons
Switch Icon Description
SANbox2 Switch
Normal operation (Green)
SANbox2-8c Switch
Normal operation (Green)
Non-QLogic Switch, or a QLogic Switch with different
security than the fabric management swi tc h.
Switch communication normal (Green)
Switch is operational with errors (Yellow)
3-6 59022-03 D
3 – Managing Fabrics
Displaying Fabric Information
Table 3-1. Topology Display Switch and S tat us Icons (Continued)
Switch Icon Description
Switch communication interrupted (Red)
Switch management communication unknown (Blue)
Fabric Management Switch
Ethernet connection normal (Green)
Fabric Management Switch
Ethernet connection critical (Red)
Fabric Management Switch
Ethernet connection warning (Yellow)
59022-03 D 3-7
3 – Managing Fabrics
Displaying Fa bric Information
3.3.2
Active Zone Set Data Window
The Active Zoneset data window displays the zone membership for the active
zone set. To open the Active Zoneset data window, choose the Active Zoneset
tab below the data window in the topology display. Refer to ”Configured Zonesets
Data Window” on page 4-6 for information about the zone set definition s on a
particular switch. Refer to ”Zoning a Fabric” on page 3-9 for more information
about zone sets and zones.
The Active Zoneset data window, shown in Figure 3-2, uses display conventions
for expanding and contracting entries that are similar to the fabric tree. An entry
handle located to the left of an entry in the tree indicates that the entry can be
expanded. Click this handle or double-c li ck the following entries to expand or
contract them:
■ A zone set entry expands to show its member zones.
■ A zone entry expands to show its member ports.
■ A port entry expands to show the port Fibre Channel address.
■ A Fibre Channel address entry expands to show the port worldwi de name.
Active Zoneset
Data Window
Figure 3-2. Active Zone Set Data Window
3-8 59022-03 D
3.4
Zoning a Fabric
Zoning enables you to divide the ports and devices of the fabr ic into zones for
more efficient and secure communicat ion among functionally grouped nodes. This
subsection addresses the following topics:
■ Zoning concepts
■ Using the Zoning Config window
■ Restoring default zoning
■ Merging fabrics and zoning
■ Using the Edit Zoning window
■ Managing zone sets
■ Managing zones
■ Managing aliases
3.4.1
Zoning Concepts
The following zoning concepts provide some context for the zoning tasks
described in this section:
3 – Managing Fabrics
Zoning a Fabric
■ Zones
■ Aliases
■ Zone sets
■ Zoning database
■ Zoning configuration
59022-03 D 3-9
3 – Managing Fabrics
Zoning a Fabric
3.4.1.1
Zones
A zone is a named group of ports or devices that can communicate with each
other. Membership in a zone can be defined by port number, device Fibre
Channel address, or device World Wide Name (WWN). Zone members can
communicate only with members of the same zone. Zones can overlap; that is, a
port or device can be a member of more than one zone.
Note: Domain ID conflicts can result in automatic reassignment of switch
domain IDs. These reassignments are not reflected in zones that use
domain ID and port number pai rs or Fibre Chann el addresses to define
their membership. Be sure to reconfigure zones that ar e affected by a
domain ID change. To prevent zoning definitions from bec oming invalid
when the membership is defined by domain ID/port number or Fibre
Channel address, use the Set Config Switch command to lock domai n
IDs. Refer to the ”Set Config Command” on page A-24.
3.4.1.1.1
Soft Zones
Three types of zones are supported. The followin g zone types define increasing
restrictive levels of communication.
■ Soft zone
■ Access Control List (ACL) - hard zone
■ Virtual Private Fabric (VPF) - hard zone
Soft zoning divides the fabric for purposes of controlling discovery. Members of
the same soft zone automatically discover and communicate freely with all other
members of the same zone. The soft zone boundary is not secure; traffic across
soft zones can occur if addressed correctly. Soft zones that include members from
multiple switches need not include the ports of the inter-switch links. Soft zone
boundaries yield to ACL and VPF zone boundaries. Soft zones can overlap; that
is, a port can be a member of more than one soft zone. Membership can be
defined by Fibre Channel address, port ID and domain ID, or worldwide name.
Soft zoning supports all port modes.
3-10 59022-03 D
3.4.1.1.2
Access Control List Hard Zones
Access Control List (ACL) zoning divides the fabr ic for purposes of controlling
discovery and inbound traff ic. ACL zoning is a type of hard zoning that is
hardware enforced. This type of zoning is usef ul for controlling access to certain
devices without totally isolating them from the fabric. Members can communicate
with each other and transmit outside the ACL zone, but cannot receive inbound
traffic from out side the zone. The ACL zone boundary is secure against inbound
traffic. ACL zones can overlap; that is, a port can be a member of more than one
ACL zone. ACL zones that include members from multiple switches need not
include the ports of the inter-switch links. ACL zone boundaries supersede soft
zone boundaries, but yield to VPF zone boundaries. Membership can be defined
only by port ID and domain ID. ACL zoning supports all port modes except
TL_Ports.
3.4.1.1.3
Virtual Private Fabric Hard Zones
Virtual Private Fabric (VPF) zoning divides the fabric for purposes of controlling
discovery and both inbound and outbound traffic. This type of zoning is useful for
providing security and reserving paths between devices to guarantee bandwidth.
VPF zoning is a type of h ard zoni ng that is ha rdwar e enforc ed. Members can only
transmit to and receive from members of the same VPF zone. The VPF zone
boundary is secure against both inbound and outbound tra ffic. VPF zones that
include members from multiple switches must include the port s of the inter- switc h
links. VPF zones cannot overlap; that i s, a por t can be a memb er of onl y one VPF
zone. VPF zone boundaries supersede both soft and ACL zone boundaries.
Membership can be defined only by port ID and domain ID. VPF zoning supports
all port modes.
3 – Managing Fabrics
Zoning a Fabric
3.4.1.2
Aliases
To make it easier to add a group of ports or devices to one or more zones, you can
create an alias. An alias is a named set of ports or devi ces that are grouped
together for convenience. Unlike zones, aliases impose no communication
restrictions between it s memb ers. You can add an alias to one or more zones.
However, you cannot add a zone to an alias, nor can an alias be a member of
another alias.
59022-03 D 3-11
3 – Managing Fabrics
Zoning a Fabric
3.4.1.3
Zone Sets
A zone set is a named gro up of zon es. A zone can be a membe r of more than o ne
zone set. All zones that a re not member s of a zo ne set belong t o the or phan zone
set. The orphan zone set is saved to the switch. Each switch in the fabr ic
maintains its own zoni ng dat abas e cont ai ning one or more zone set s. Thi s zoning
database resides in non-volatil e or permanent memory and is therefore retained
after a reset. Refer to ”Configured Zonesets Data Window” on page 4-6 for
information about displaying the zoning database.
To apply zoning to a fabric, choose a zone set and activate it. When you activate a
zone set, the switch distributes that zone set to every switch in the fabric.
Therefore, every switch in the fabric will have identical active zone sets. Refer to
”Active Zone Set Data Window” on page 3-8 for information about displaying the
active zone set.
3.4.1.4
Zoning Database
Each switch has its own zoning database. The zoning database is made up of all
aliases, zones, and zone sets that have been created on the swi tch or received
from other switches. The switch mai ntain s two copi es of the zoning dat abase: one
copy is maintained i n temporary memory for editing pur poses; the second copy is
maintained in permanent memory. When you modify aliases, zones, and zone
sets, these changes are made to the temporar y zoning database. If you reset the
switch or lose power to the switch before savi ng the permanent zoning database,
the changes will be lost.
The Auto Save zoning configuration parameter controls whether the temporary
zoning database is automatically saved in permanent memory. Refer to ”Zoning
Configuration” on page 3-13 for more information about the Auto Save
parameters.
3-12 59022-03 D
3.4.1.5
Zoning Configuration
Note the following SANbox2 zoning configuration concepts:
■ Orphan zones are allowed.
■ You can not edit an active zone set.
■ The three types of zones are Soft, VPF, and ACL.
■ Aliases are allowed.
■ The zoning limits for a fabric are:
■ Maximum number of zonesets is 256
■ Maximum number of zones is 256
■ Maximum number of aliases is 256
■ Maximum number of members per zone is 2000
■ Maximum number of members per aliases is 2000
3 – Managing Fabrics
Zoning a Fabric
■ Maximum total number of members is 2000
■ The entire zoning database can be saved to either temporary or permanent
memory.
You can set the zoning configuration parameters using SANbox Manager or the
Set Zoning Config command. Refer to ”Using the Zoning Config Window” on
page 3-15 for information about zoning configuration using SANbox Manager.
Refer to ”Set Config Command” on page A-24 for information about the Set
Config command.
The following parameters make up the zoning configuration:
■ Auto Save
■ Merge Mode
■ Default Visibility
59022-03 D 3-13
3 – Managing Fabrics
Zoning a Fabric
3.4.1.5.1
Auto Save
The Auto Save parameter on a switch determines whether zoning changes
received from other switches in the fabric will be automatically saved to
permanent memory on that switch. Zoning changes you apply to your switch are
automatically saved to permanent memory on your switch, but where those
changes are saved on each swi tch in the fabric is dependent on whether a switch
has the Auto Save parameter enabled or disabled.
Zoning changes are saved to temporary memory on all switches in the fabric. If
Auto Save is enabled, the switch firmware automatically saves the zoning
changes it receives to both temporary and permanent memory on that switch. If
Auto Save is disabled on a switch, any zoning changes that the switch receives
will be stored only in its temporary memory.
How the save operation is triggered depends on the s elec ted merge mode. When
in SW-2 merge mode, changes are save d when an upda ted zone set is act ivated.
When in Brocade™ merge mode, changes are saved when any zone set is
updated. You can save the zoning database to permanent memory (if Auto Save
is disabled) using the Zoning command. Refer to Zoning Command on page A-67.
3.4.1.5.2
Merge Mode
The Merge Mode parameter enables a SANbox2 switch to interoper ate with
Brocade switches running non-FC-SW-2-compl iant firmware. There are two
merge modes: SW2 and Brocade Proprietary. The SW2 merge mode is intended
for FC-SW-2 compliant switches. The Brocade merge mode is intended for
SANbox2 fabrics that include Brocade switch es with non-FC-SW-2 compliant
firmware. All switches in a fabric should be set to the same merge mode,
otherwise the switches may become isolated from each other.
When you activate a zone set, the SW2 merge mode causes the active zone set
to be distributed to temporary memory on all switches in the fabr ic. This ensures
that all switches have identical acti ve zone sets. The Brocade merge mode
propagates the ent ire zoning dat abase to t emporary memory on al l switches in the
fabric anytime the zoning databas e is changed and saved on any switch.
3.4.1.5.3
Default Visibility
Default Visibility determines the level of communication that is permitted between
devices when there is no active zone set. The default visibility parameter can be
set differently on each switch. When default visibility is enabled (All) on a switch,
the switch and its devices can communicate with all devices in the fabric. When
Default Visibility is disabled (None) on a switch, none of the ports on that switch
can communicate with any other port in the fabric.
3-14 59022-03 D
3.4.2
Using the Zoning Config Window
Use the Zoning Config window to change the Auto Save, Merge Mode, and
Default Visibility configuration parameters. In the faceplate display, open the
Zoning menu and select Edit Zoning Config to open the Zoning Config window
shown in Figure 3-3. After making changes, choose the OK button to put the new
values into effect.
3 – Managing Fabrics
Zoning a Fabric
Figure 3-3. Zoning Config Window
3.4.3
Restoring Default Zoning
Restoring the default zoning clears the swit ch of all zoning definitions.
CAUTION!
To restore the default zoning for a switch:
1. In the faceplate display, open the Zoning menu and select Restore Default
Zoning.
2. Choose the OK but ton to confirm that you want to rest ore default zoning and
save changes to the zoning database.
The use of this command will deactivate any active zone set . If
the switch is not isolated from the fabric, this command will
deactivate the active zone set for the entire fabric.
59022-03 D 3-15
3 – Managing Fabrics
Zoning a Fabric
3.4.4
Merging Fabrics and Zoning
If you join two fabrics, the active zone sets from the two fabrics attempt to merge.
The fabrics may consist of a single switch or many switches already connected
together. The switches in the two fabrics attempt to create a new active zone set
containing the union of each fabric’s active zone set. The propagation of zoning
information only affects the active zone set, not the configured zone sets, unless
the Merge Mode is set to "Brocade Proprietary". Refer to ”Merge Mode” on
page 3-14.
3.4.4.1
Zone Merge Failure
If a zone merge is unsuccessful, the inter-switch links between the fabrics will
isolate due to a zone merge failure, which will generate an alar m log entr y. The
reason for the E_Port isolation can also be deter mined by viewing the port
information . R e fe r to ”Port Information Data Window” on page 4-5 and the ”Show
Command” on page A-39 (Port keyword).
A zone merge will fail under the following condition s:
■ The Merge Mode in the two fabrics is different. All switches in the combined
fabric must have the same merge mode.
■ The two active zone sets have member zones with identical names that
differ in content or type. For example, consider Fabric A and Fabric B each
with a zone in its active zone set named “ZS1”. Fabric A "ZS1" contains a
member specified by Domain ID 1 and Port 1; Fabric B “ZS1” contains a
member specified by Domain ID 1 an d Port 2. I n this case, the merge wil l fail
and the inter-switch links between the fabrics will isolate.
3.4.4.2
Zone Merge Failure Recovery
When a zone merge failure occurs, the conflict that caused the failure must be
resolved. If the failure was due to dif fering Merge Modes, change the Merge Mode
on the switches in one of the fabrics to match the other fabric. Refer to ”Using the
Zoning Config Window” on page 3-15 for information about changing the Merge
Mode. To permit the fabrics to join, reset the ports that were isol ated. Refer to
”Resetting a Port” on page 5-13.
1. You can correct a failure due to a zone conflict by deactivating one of the
active zone sets or editing the conf licting zones so that their membership is
the same. You can deactivate the active zone set on one switch if the active
zone set on the other switch accurately defi nes your zoning needs. If not,
you must edit the zone memberships, and r eactiv ate the zone sets. Refer to
”Managing Zones” on page 3-22 for information about adding and removing
zone members. To permit the fabrics to join, reset the port s that were
isolated. Refer to ”Resetting a Port” on page 5-13.
3-16 59022-03 D
3.4.5
Using the Edit Zoning Window
To edit the zoning database for a particular switch, open the Zoning menu from
the faceplate display and select Edit Zoning to open the Edit Zoning window
shown in Figure 3-4. Changes can only be made to an inactive zone set, which
will be stored in flash (non-volatile) memory and retained after resetting a switch.
The Edit Zoning window has a Zone Sets tree on the left and a Port/Device (or
members) tree on the right. Both trees use display convent ions similar to the
fabric tree for expanding and contracting zone sets, zones, and ports. An
expanded port shows the port Fibre Channel address; an expanded address
shows the port worldwide name. You can select zone sets, z ones, and ports in t he
following ways:
■ Click a zone, zone set, or port icon.
■ Right-click to select a zone set or zone, and open the corresponding popup
menu.
■ Hold down the Shift key while clicking several consecutive icons.
3 – Managing Fabrics
Zoning a Fabric
■ Hold down the Control key while clicking several non-consecutive icons.
Zone Sets
Tree
Port/Device
Tree
Figure 3-4. Edit Zoning Window
59022-03 D 3-17
3 – Managing Fabrics
Zoning a Fabric
Using tool bar buttons, popup menus, or a dr ag-and-dr op method, you ca n create
and manage zone sets and zones in the zoning database. The Apply button
saves changes to the zoning database wi thout closing the window. The OK button
saves the zoning changes to the database and closes the window. The tool bar
presents the following operati ons:
Tool Bar Button Description
Table 3-2. Edit Zoning Window Tool Bar Buttons
Create Zone Set button - create a new zone set
Create Zone button - create a new zone
Create Alias button - create another name for a set of objects
Add Member button - add the selected zone to a zone set, or
add the selected port to a zone
Remove Member button - delete the selected zone from a zone
set, or delete the selected port from a zone
3-18 59022-03 D
3.4.6
Managing Zone Sets
Zoning a fabric involves creati ng a zone set, creating zones as zone set members,
then adding devices as zone members. The zoning database supports multiple
zone sets to serve the different security and access needs of your storage area
network, but only one zone set can be active at one time. Managing zone sets
consists of the following tasks:
■ Creating zone sets
■ Activating and deactivating zone sets
■ Copying a zone to a zone set
■ Removing a zone from one zone set or from all zone sets
■ Removing a zone set
■ Removing all zoning definitions
Note: Changes that you make to the zoning database behave as follows:
3 – Managing Fabrics
Zoning a Fabric
■ In SW2 merge mode, changes to configured zone sets are limited
to the managed switch and do not propagate to the rest of the
fabric. To distribute changes to configured zone sets fabric wide,
you must edit the zoning databases on the individual switches.
■ In Brocade merge mode, when a zone set is activated, the entire
zoning database, including any changes, is distributed from the
managed switch throughout the fabric.
59022-03 D 3-19
3 – Managing Fabrics
Zoning a Fabric
3.4.6.1
Creating a Zone Set
To create a zone set, do the following:
1. Open the Zoning menu, and select Edit Zoning to open the Edit Zoning
window.
2. Open the Edit menu, and select Create Zone Set to open the Create Zone
Set window.
3. Enter a name for the zone set, and choose the OK button. The new zone set
name is displayed in the Zone Sets window.
4. To create new zones in a zone set, do one of the following:
■ Right-click a zone set and select Create A Zone from the popup menu.
■ Copy an existing zone by dragging a zone into the new zone set . Refer
In the Create a Zone window, enter a name for the new zone, and
choose the OK button. The new zone name is displayed in the Zone
Sets window.
to ”Copying a Zone to a Zone Set” on page 3-21.
5. Choose the Apply button to save changes to the zoning database.
3.4.6.2
Activating and Deactivating a Zone Set
You must activate a zone set to apply its zoning definitions to the fabric. Only one
zone set can be active at one time. When you activate a zone set, the switch
distributes that zone set to the temporary zoni ng database on every switch in the
fabric replacing any zon e set of th e same name. I f Auto Save i s enabled, t he zone
set is saved in the permanent zoning database also. Refer to ”Auto Save” on
page 3-14.
The purpose of the deactivate function is to suspend all fabric zoning which
results in free communication fabric wide or no communication depending on the
default visibility setting. Refer to ”Default Visibility” on page 3-14 for more
information. It is not necessary to deactivate the active zone set before activating
a new one.
■ To activate a zone set, open the Zoning menu and select Activate Zone Set
to open the Activate Zone Set window. Select a zone set from the Select
Zone Set pull-down menu, and choose the Activate button.
■ To deactivate the active zone set, open the Zoning menu, select Deactivate
Zone Set. Acknowledge the warning about traffic dis ruption, and choose the
Yes button to confirm that you want to deactivate the active zone set.
3-20 59022-03 D
3.4.6.3
Copying a Zone to a Zone Set
To copy an existing zone and it s members hip f rom one zone set to anot her, select
the zone and drag it to the chosen zone set. Choose the Apply button to save
changes to the zoning database.
3.4.6.4
Removing a Zone from a Zone Set or from All Zone Sets
You can remove a zone from a zone set or from all zone sets in the database.
1. In the Faceplate Display, open the Zoning menu and select Edit Zoning to
open the Edit Zoning window.
2. In the Zone Sets tree, select the zone(s) to be removed.
3. Open the Edit menu, and select Remove to remov e the zone from the zone
set, or select Remove from All Zones to remove the zone from all zone
sets.
4. Choose the Apply button to save changes to the zoning database.
3 – Managing Fabrics
Zoning a Fabric
Alternatively, you may use shortcut menus to remove a zone from a zone set or
from all zone sets in the databas e.
3.4.6.5
Removing a Zone Set
Removing a zone set from the database affect s the member zones in the following
ways.
■ Member zones that are members of other zone sets are not affected.
■ Member zones that are not members of other zone sets become members
of the orphan zone set.
To delete a zone set from the database, do the following:
1. In the faceplate display, open the Zoning menu and select Edit Zoning to
open the Edit Zoning window.
2. In the Zone Sets tree, select the zone set to be removed.
3. Open the Edit menu, and select Remove to remove the zone set.
4. Choose the Apply button to save changes to the zoning database.
Alternatively, you may use shortcut menus to remove a zone set from the
database.
59022-03 D 3-21
3 – Managing Fabrics
Zoning a Fabric
3.4.6.6
Removing All Zoning Definitions
To clear all zone and zone set defi nitions fr om the zoning dat abase, cho ose one of
the following:
■ Open the Edit menu and select Remove All. In the Remove All window,
choose the Yes button to conf irm th at you want to del ete all zones and zone
sets.
■ Right-click the Zone Sets heading at the top of the Zone Sets tree, and
select Clear Zoning from the popup menu. Choose the Yes button to
confirm that you want to delete all zone sets and zones.
3.4.7
Managing Zones
Managing zones involves the following:
■ Creating a zone in a zone set
■ Adding zone members
■ Renaming a zone or a zone set
■ Removing a zone member
■ Removing a zone from a zone set
■ Removing a zone from all zone sets
■ Changing zone types
Note: Changes that you make to the zoning database behave as follows:
■ In SW2 merge mode, changes to configured zone sets are limited
to the managed switch and do not propagate to the rest of the
fabric. To distribute changes to configured zone sets fabric wide,
you must edit the zoning databases on the individual switches.
■ In Brocade merge mode, when a zone set is activated, the entire
zoning database, including any changes, is distributed from the
managed switch throughout the fabric.
3.4.7.1
Creating a Zone in a Zone Set
When a zone is created, it’s zone type is soft. To change the zone type to a hard
zone (ACL or VP F ), ref e r to ”Changing Zone Types” on page 3-25 for more
information. Refer to ”Zones” on page 3-10 for information on zone types (sof t and
hard). To create a zone in a zone set, do the following:
1. Open the Zoning menu, and select Edit Zoning to open the Edit Zoning
window.
3-22 59022-03 D
3 – Managing Fabrics
Zoning a Fabric
2. Open the Edit menu and select Create a Zone.
3. In the Create a Zone window, enter a name for the new zone, and choose
the OK button. The new zone name is displayed in the Zone Sets window.
Note: If you enter the name of a zone that already exists in the
database, the SANbox Manager application will create a copy of
that zone and its membership in the zone set.
4. To add ports or devices to the zone, do one of the following:
■ In the zone set tree, select the zone set. In the graphic window, select
the port to add to the zone. Open the Edit menu and select Add
Members.
■ Select a port by port number, Fibre Channel address, or worldwide
name in the Port/Device tree, and drag it into the zone.
■ Select a port by port number, Fibre Channel address, or worldwide
name in the Port/Device tree. Right-click the zone and sele ct Add
Zone Members from the popup menu.
5. Choose the Apply button to save changes to the zoning database.
3.4.7.2
Adding Zone Members
Adding a zone member to a zone will affect every zone set in whic h that zone is a
member. To add member ports/devices to a zone, do one of the following:
■ Select a port by port number, Fibre Channel address, or worldwide name in
the Port/Device tree, and drag it into the zone. To select and drag multiple
ports/devices, press and hold the Control key while dragging.
■ Select one or more ports by port number, Fibre Channel address, or
worldwide name in the Port/Device tree. Ri ght-click the zo ne and select Add
Zone Members from the popup menu.
Choose the Apply button to save changes to the zoning database.
Note: Domain ID conflicts can result in automatic reassignment of switch
domain IDs. These reassignments are not reflected in zones that use
domain ID/port number pair to define their membershi p. Be sure to
reconfigure zones that are affected by a domain ID change.
59022-03 D 3-23
3 – Managing Fabrics
Zoning a Fabric
3.4.7.3
Renaming a Zone or a Zone Set
To rename a zone, do the following:
1. In the Zone Sets tree of the Edit Zoning window, click the zone/zone set to
be renamed.
2. Open the Edit menu and select Rename.
3. In the Rename Zone/Rename Zone Set window , enter a new name for the
zone/zone set.
4. Choose the OK button.
3.4.7.4
Removing a Zone Member
Removing a zone member will affect every zone and zone set in which that zone
is a member. To remove a member from a zone:
1. In the Edit Zoning window, select the zone member to be removed.
2. Open the Edit menu and select Remove.
3. Choose the OK button to save the changes and close the Edit Zoning
window.
3.4.7.5
Removing a Zone from a Zone Set
Removing a zone from a zone set will aff ect every z one set in which that zone is a
member. To delete a zone from a zone set:
1. In the Edit Zoning window, select the zone to be removed.
2. Open the Edit menu and select Remove.
3. Choose the OK button to save the changes and close the Edit Zoning
window.
3.4.7.6
Removing a Zone from All Zone Sets
To delete a zone from all zone sets, do the following:
1. In the Edit Zoning window, select the zone to be removed.
2. Open the Edit menu and select Remove Zone from All Sets.
3. Choose the OK button to save the changes and close the Edit Zoning
window.
3-24 59022-03 D
3.4.7.7
Changing Zone Typ es
To change a zone type, do the following:
1. In the faceplate display, select the switch with the zone type to change.
2. Choose the Zoning button to open the Edit Zoning window.
3. In the Zone Sets tree, select the zone to change.
4. Open the Edit menu and select Set Zone Type to open the Set Zone Type
window.
5. Open the Zone Type pull-down menu and select Soft, VPF (virtual private
fabric), or ACL (access control list). Refer to ”Soft Zones” on page 3-10,
”Access Control List Hard Zones” on page 3-11, or ”Virtual Private Fabric
Hard Zones” on page 3-11 for a description of these zone types.
3.4.8
Managing Aliases
An alias is a collection of objects that can be zoned together. An alias is not a
zone, and can not have a zone or another alias as a member.
3 – Managing Fabrics
Zoning a Fabric
Note: Changes that you make to the zoning database behave as follows:
3.4.8.1
Creating an Alias
To create an alias, do the following:
1. Open the Zoning menu, and select Edit Zoning to open the Edit Zoning
window.
2. Open the Edit menu, and select Create Alias to open the Create Alias
window.
3. Enter a name for the alias, and choose the OK button. The alias name is
displayed in the Zone Sets window.
4. Choose the OK button to save the alias name to the zoning database.
■ In SW2 merge mode, changes to configured zone sets are limited
to the managed switch and do not propagate to the rest of the
fabric. To distribute changes to configured zone sets fabric wide,
you must edit the zoning databases on the individual switches.
■ In Brocade merge mode, when a zone set is activated, the entire
zoning database, including any changes, is distributed from the
managed switch throughout the fabric.
59022-03 D 3-25
3 – Managing Fabrics
Zoning a Fabric
3.4.8.2
Adding a Member to an Alias
The three ways to add a member to an alias are:
■ Drag-and-drop method.
■ Select the alias in the left pane and the member in the right pane to add to
that alias, and choose the Insert button.
■ Select the alias in the left pane and the member in the right pane to add to
that alias, and open the Edit menu and select Add Members.
To add a member to an alias using the drag-and-drop method, do the following:
1. In the right pane, click and hold down the mouse button on the member to
be added to the alias.
2. Drag the selected member from the right pane to the alias in the left pane.
To add a member to an alias using the menu options, do the following:
1. Open the Zoning menu, and select Edit Zoning to open the Edit Zoning
window.
2. In the left pane, select an alias.
3. In the right pane, select the member to add to the select ed ali as.
4. Choose one of the following:
■ Open the Edit menu and select Add Members.
■ Choose the Insert button.
5. Choose the OK button to save the changes and close the Edit Zoning
window.
3.4.8.3
Removing an Alias from All Zones
To remove an alias from all zones, do the following:
1. In the Zone Sets tree in the Edit Zoning window, select the alias to be
removed.
2. Open the Edit menu, and select Remove Alias from All Zones.
3. Choose the Yes button in the Remove window.
3-26 59022-03 D
Managing Switches
This section describes the following tasks that manage switches in the fabric.
■ Displaying switch information
■ Exporting alarm log information to a file
■ Exporting name server information to a file
■ Paging a switch
■ Resetting a switch
■ Configuring a switch
■ Archiving a switch
■ Restoring a switch
■ Loading firmware
■ Restoring the factory default configu ration
4.1
Displaying Switch Information
The faceplate display and data windows provide the following specific switch
information:
Section 4
■ Hardware status
■ Name server information
■ Switch specifications and addresses
■ Configuration parameters
■ Performance statistics
■ Configured zone sets
■ Alarm log information
59022-03 D 4-1
4 – Managing Switches
Displaying Switch Information
Figure 4-1. Faceplate Display
The fabric updates the topology and faceplate displays by forwarding changes in
status to the management workstat ion as they occur. You can allow the fabric to
update the switch status, or you can refresh the display at any time. To refresh
switch status in the display, do one of the following:
■ Choose the Refresh button.
■ Open the View menu and select Refresh.
■ Press the F5 key.
■ Right-click a switch in the topology display and select Refresh Switch from
the popup menu.
■ Right-click in the graphic window of the faceplate displ a y, and select
Refresh Switch from the popup menu.
4.1.1
Displaying Hardware Status
A SANbox2 switch is equipped with the following chassis LEDs that provide
hardware status information:
■ Chassis Over Temperature LED - indicates air temperature inside the
switch.
■ Fan Fail LED - indicates operational st atus of both fans.
■ Heartbeat LED - indicate s the st atus of the int ernal s witch proce ssor and the
results of Power On Self Tests (POSTs).
■ Input Power LED - indicates the voltage status at the switch logic circuitry.
4-2 59022-03 D
You can display a summary of this status infor ma ti on by placing the cursor on the
chassis LED cluster as shown in Figure 4-2. Refer to SANbox2 Fibre Channel
Switch Installer’s/User’s Manual for more information about the chassis LEDs.
Figure 4-2. Faceplate Display - Chassis LED Cluster
4.1.2
Name Server Data Window
The Name Server data window d isplays i nformation abo ut the devic es logged int o
the fabric. It is available in both the topology display and the faceplate display.
Choose the Name Server tab below the data window to display name server data
for the selected fabric. To narrow the display, select on or more switches. Refer to
”Name Server Data Window Entries” on p age 4-3 for a description of the fields in
the Name Server data window. Refer to ”Exporting Name Server Information to a
File” on page 4-7 to export name server information to a file.
4 – Managing Switches
Displaying Switch Information
Table 4-1. Name Server Data Window Entries
Entry Description
Device Device number in the fabric
Switch Switch name
Port Port number (0 - 15)
Address Fibre Channel address
Type Node type
WWNN Worldwide node name
WWPN Worldwide port name
Vendor Host Bus Adapter/Device Vendor
FC-4 Types Device Fibre Channel protocol types
59022-03 D 4-3
4 – Managing Switches
Displaying Switch Information
4.1.3
Switch Data Window
The Switch data window displays current networ k and switch information for the
selected switches. Refer to ”Configuring a Switch” on page 4-7 for more
information about the Switc h data window . To open the Switch data window , select
one or more switches in the topology display and choose the Switch tab below
the window. You can also open the Switch data window in the faceplate display.
Table 4-2 describes the Switch data window entries.
FcAddress Switch Fibre Channel address
World Wide Name Switch worldwide name
Reason for Status Additional status information
User Name Name of user
Table 4-2. Switch Data Window Entries
Entry Description
Login Level Security level
Vendor Switch manufacturer
Flash Version Active Flash
Inactive Flash Version Inactive firmware version
PROM/Flasher Version Firmware version
MAC Address Media Access Control address
IP Address Internet Protocol Address
Negotiated Domain ID The domain ID currently being used by the fabric
Configured Domain ID The domain ID defined by network administrator
Number of Ports Number of ports on the switch
Switch Type Switch model
Operational State Switch operational state: Online, Offline, Diagnostic
Administrative State Switch administrative state: Online, Offline,
Diagnostic
MFS Timeout Multi frame sequencing timeout value
RA Timeout Resource allocation timeout value
RT Timeout Receiver transmitter timeout value
4-4 59022-03 D
4 – Managing Switches
Displaying Switch Information
Table 4-2. Switch Data W indow Entries (Continued)
Entry Description
ED Timeout Error detect timeout value
Zoning Merge Mode SW2 Standard or Brocade Proprietary
Zoning Merge Auto Save Whether zoning auto save is on (default) or off
Zoning Default Visibility Whether zoning visibility is set to All (default) or None
Temperature Internal switch temperature °C
Fan 1 Status Fan status
Fan 2 Status Fan status
Fan 3 Status Fan status
Power Supply 1 Status Power supply 1 status
Power Supply 2 Status Power supply 2 status
Beacon Status Whether LEDs on the switch are blinking (on or off).
Broadcast Support Whether broadcast support is enabled or disabled
4.1.4
Port Statistics Data Window
The Port Statistics data window displays port performance data for the selected
ports. To open the Port Statistics data window, choose the Port Stats tab below
the data window in the fa ceplate displ ay. Refer to Table 5-5 for a descrip tion of the
Port Statistics data window entries.
The Statistics pull-down menu is available on the Port Statistics data window, a nd
provides different ways to view detailed port information. Choose the down arrow
to open the pull-down menu. Open the pull-down menu and select Absolute to
view the total co unt of stati stics s ince the l ast switch r eset. Select Rate to vi ew the
number of statistics counted per second over the polling period. Select Baseline
to view the total count of statistics since the last time the baseline was set.
Choose the Clear Baseline button to set the current baseline.
4.1.5
Port Information Data Window
The Port Information data window displays port detail information for the selected
ports. To open the Port St atis tics dat a window, choose the Port Info tab below the
data window in the faceplate display. Refer to Table 5-6 for a description of the
Port Information data window entries.
(default).
59022-03 D 4-5
4 – Managing Switches
Displaying Switch Information
4.1.6
Configured Zonesets Data Window
The Configured Zonesets data window displays all zone sets, zones, and zone
membership in the zoning database, as shown in Figure 4-3. To open the
Configured Zonesets data win dow, choose the Configured Zonesets tab below
the data window in the faceplate display.
The Configured Zonesets data window uses display conventions for expanding
and contracting entries that are simil ar to the fabric tree. An entry handle located
to the left of an entry in the tree indicates that the entry can be expanded. Click
this handle or double-click the follo wing entries to expand or contract them:
■ A zone set entry expands to show its member zones.
■ A zone entry expands to show its members by port number, worldwide
name, or Fibre Channel address.
Figure 4-3. Configured Zonesets Data Window
4.1.7
Alarm Log Data Window
The Alarm Log data window displays swit ch event i nfor mation. To open the Alarm
Log data window, choose the Alarm Log tab below the data window in the
faceplate display.
4-6 59022-03 D
4.2
Exporting Alarm Log Information to a File
To save switch alarm log information to file, open the face plate di splay and do the
following:
1. Open the Switch menu and select Export Alarm Log.
2. In the Save window, enter a file name.
3. Choose the Save button.
4.3
Exporting Name Server Information to a File
To save switch name server information to file, open the topology display and do
the following:
1. Open the Switch menu and select Export Name Server.
2. In the Save window, enter a file name.
3. Choose the Save button.
4 – Managing Switches
Exporting Alarm Log Information to a File
4.4
Paging a Switch
You can use the beacon feature to page a switch. The beacon feature causes all
port Logged-In LEDs to flash, making it easier to recognize. To page a switch,
open the Switch menu in the faceplate display and enable the Toggle Beacon
selection. To cancel the beacon, reselect Toggle Beacon.
4.5
Resetting a Switch
Resetting a switch reboots the switch using configuration parameters in memory.
You can reset a switch in the following ways:
■ Select the switch to be reset in the fabric tree. Open the Switch menu and
select Reset Switch.
■ Turn both power supplies off, then turn one or both of them back on.
4.6
Configuring a Switch
Switch configuration is divided into two areas: chassis configuration and network
configuration. Chassis configurat ion specif ies swi tch-wide F ibre Channel settings.
Network configuration specifies Ethernet and SNMP related settings.
To open the Switch Properties window, open the Switch menu and select Switch
Properties. You may also right-click a switch graphic in the topology display or
faceplate display, and select Switch Properties from the popup menu.
59022-03 D 4-7
4 – Managing Switches
Configuring a Switch
4.6.1
Switch Configuration
Use the Switch Properties window to change the chassis name, administrative
state, domain ID, and to enable or disable broadca st support. Broadcast support
provides support for IP broadcast over Fibre Channel. The timeout values are
displayed for reference purposes only when the switch is online. These fields
become activate when the switch is take offline and then redisplaying the Switch
Properties window. After making changes, choose the OK button to put the new
values into effect.
Figure 4-4. Switch Properties Window
4.6.1.1
Chassis Name
A user-defined name that identifies t he switch. The default is SANbox2.
4.6.1.2
Switch Administrative States
The switch administrative stat e specifies the operational status of the switch.
Table 4-3 describes the administrative state values. When applied to the switch,
the administrative state becomes the oper ational state.
Table 4-3. Switch Administrative States
Parameter Description
Online The switch is available.
Offline The switch is unavailable.
Test The switch is in test mode and is unavailable.
4-8 59022-03 D
4.6.1.3
Domain ID
4 – Managing Switches
Configuring a Switch
The domain ID is a unique Fibre Channel identifier for the switch. The Fibre
Channel address consists of the domain ID, port ID, and the Arbi trated Loop
Physical Address (ALPA). The maximum number of switches within a fabric is 239
with each switch having a unique domain ID.
Switches come from the factory with the domain IDs unlocked (DomainI D-Lock=
FALSE). This means that if there is a domain ID conflict in the fabric, the switch
with the highest principal priority, or the principal switch, wi ll reassign any domain
ID conflicts and establ ish the fabric. If you lock the domain ID on a switch
(DomainIDLock=TRUE) and a domain ID conflict occurs, the switch with the
higher WWN will isolate as a separate fabric and the Logged-In LEDs on both
switches will flash to show the affected ports . Refer to the ”Set Config Command”
on page A-24 for information about the Switch keyword and the DomainIDLock
and PrincipalPriority parameters.
If you connect a new switch to an existing fabric wit h its domain ID unlocked, and
a domain conflict occurs, the new switch will isolate as a separate fabric.
However, you can remedy this by resetting the new switch or taking it offline then
back online. The principal switch will reassign the domain ID and the switch will
join the fabric.
Note: Domain ID reassignment is not reflected in zoning that is defined by
4.6.1.4
Broadcast Support
Broadcast is supported on the SANbox2 which allows for IP-over-Fi bre Channel
support support. Broadcast is implemente d using the propose d standard spe cified
in Multi-Switch Broadcast for FC-SW-3, T11 Presentation Number T11/02-031v0.
FSPF is used to setup a fabric spanning tree used in transmission of broadcast
frames. Broadcast frames are retransmitted on all ISLs indicated in the spanning
tree and all online F/FL ports. Broadc ast zoning is supported with Access Control
List (ACL) and Virtual Private Fabric (VPF) hard zones. When a broadcast frame
is received, these hard zones are enf orce d at the F/ FL port . If the ori gina tor of t he
broadcast is in a hard zone, the frame is retransmitted on all online F/FL ports
within the hard zone. If the origi nat or of th e broadc ast fra me is not in a hard zon e,
the frame is retransmitted on online F/FL ports that are not in a hard zone.
domain ID and port number pair. You must reconfigure zones that are
affected by domain ID reassi gnment.
59022-03 D 4-9
4 – Managing Switches
Configuring a Switch
4.6.1.5
Timeout Values
The switch timeout valu es determine the t imeout valu es for al l port s on t he switch.
Table 4-4 describes the switch timeout parameters. The R_A_TOV, R_T_TOV, or
E_D_TOV values must be the same for all switches in the fabric.
Note: Timeout values can only be changed if the switch operational state is
R_A_TOV Resource Allocation Timeout. The maximum amount of time a
offline.
Table 4-4. T imeout Values
Parameter Description
frame could be delayed in the fabric and still be delivered. The
default is 10000 milliseconds.
R_T_TOV Receiver Transmitter Timeout. The amount of time that
synchonization may be lost between two ports before link
failure is detected. The default is 100 milliseconds.
E_D_TOV Error Detect Timeout. The maximum round trip time that an
operation between two N_Ports could require. The default is
2000 milliseconds.
4-10 59022-03 D
4.6.2
Network Configuration
Use the Network Propert ies window shown in Figure 4-5 to change IP and SNMP
configuration paramet ers . Af t er making changes , c hoose the OK button to put the
new values into effect. To open the Network Properties window, open the Switch
menu and select Network Properties.
Note: Since Read Community, Trap Community, and Write Community
settings are like passwords, they are write-only fields; the current
settings are not displayed.
4 – Managing Switches
Configuring a Switch
Figure 4-5. Network Properties Window
59022-03 D 4-11
4 – Managing Switches
Configuring a Switch
4.6.2.1
IP Configuration
The IP configuration identif ies the s wit ch on the Et hernet net work and determi nes
which boot method to use. Table 4-5 describes the IP configuration para met ers.
Parameter Description
IP Address Internet Protocol (IP) address for the Ethernet port. The default and
Subnet mask Subnet mask address for the Ethernet port. The default and PROM
Boot Method Choose one of the following methods:
Table 4-5. IP Configuration Parameters
PROM mode value is 10.0.0.1.
mode value is 255.0.0.0.
■ Static - Uses the IP configuration parameters entered in the
Switch Properties window.
■ BootP - Acquires the IP configuration from a BootP server.
■ RARP (Reverse Address Resolution Protocol) - Acquires the IP
address from an RARP server. A RARP request is broadcast,
with up to three retries, each at 5 second intervals. If no IP
address is obtained, the switch reverts to the previously
configured IP address.
■ DHCP (Dynamic Host Configuration Protocol) - Acquires the IP
configuration from a DHCP server. If no satisfactory lease is
obtained, the DHCP client attempts to use the previously
configured lease. If the previous lease cannot be used, no IP
address will be assigned to this switch in order to avoid an IP
address conflict. The DHCP server must then be made available.
If a BootP, RARP, or DHCP server is not available, the switch will
boot. However, you will be unable to manage the switch through the
Ethernet connection. To manage a switch under these
circumstances, the connection must be made through the serial port
or inband from another switch.
Gateway IP gateway address. The default and PROM mode value is
10.0.0.254.
4-12 59022-03 D
4.6.2.2
Remote Logging
The Remote Logging (syslog) feature enables saving of the log information to a
remote host that supports the syslog protocol. When enabled, the log entries are
sent to the syslog host at the IP address that you specify in the Logging Host IP
Address field. Log entries are saved i n the inter nal swit ch log whethe r th is f eature
is enabled or not.
To save log information to a remote host, you must edit the syslog.conf file and
then restart the syslog daemon. The syslog.conf file on the remote host must
contain an entry that specifi es the name of the log file in which to save error
messages. Add the following line to the syslog .conf file. A <tab> separates the
selector field (local0.info) and action field which contains the log file path name
(/var/adm/messages/messages.name).
local0.info <tab> /var/adm/messages.name
4.6.2.3
SNMP Configuration
The SNMP configuration defines how authentication tr aps are managed.
Table 4-6 describes the SNMP configuration parameters.
4 – Managing Switches
Configuring a Switch
Table 4-6. SNMP Configuration Parameters
Parameter Description
Contact Specifies the name of the contact person who is to be contacted to
respond to trap events. The default is undefined.
Read
Community
Trap Community Trap Community Authentication. A write-only field; the value on the
Location Specifies the switch location. The default is undefined.
Authentication
Trap
Write
Community
Read Community Authentication. A write-only field; the value on the
switch and the SNMP management server must be the same. The
default value is Public.
switch and the SNMP management server must be the same. The
default value is Public.
Enables or disables the reporting of SNMP authentication failures. If
enabled, a notification trap is sent to the configured trap addresses in
the event of an authentication failure if incorrect community string
values are used. The default value is False.
Write Community Authentication. A write-only field; the value on the
switch and the SNMP management server must be the same. The
default value is Private.
59022-03 D 4-13
4 – Managing Switches
Configuring a Switch
4.6.2.4
SNMP Trap Configuration
The SNMP trap configuration defines how traps are sent . Table 4-7 describes the
SNMP configuration parameters.
Table 4-7. SNMP Trap Configuration Parameters
Parameter Description
Trap Enabled Check box to enable or disable the trap.
Trap Address Specifies the IP address to which SNMP traps are sent. The default
is 127.0.0.1. A maximum of 5 trap addresses are supported.
Trap Port The port number on which the trap is set.
Trap Severity Specifies a severity level to assign to the trap. Open the pull-down
menu and choose a level. Traps must be enabled to access this
pull-down menu. Trap severity levels include Unknown, Emergency,
Alert, Critical, Error, Warning, Notify, Info, Debug, and Mark
4.6.3
Configuration Backup
Changes made to the switch since it was manufactured can be saved to a file in
non-volatile memory. However the backup is lost if the switch is reset. Use the
FTP User Images procedures to save the configdata f ile to the workstation. (In
FTP, no directory listing is available. The configuration backup file is always
named configdata.) Refer to the ”Config Command” on page A-7 for more
information . R e fe r to ”Archiving a Switch” on page 4-15.
4.6.4
Configuration Restore
Switch configurations can be “cloned” to easily propagate an identical
configuration to other switches. Use the FTP User Images procedures with the
Put command to send the previously saved (using config backup) configdata file
to the switch. Use the Config Restore command to return the switch configuration
to the previously saved configuration. The switch is automatically reset upon a
successful restore. Refer to the ”Config Command” on page A-7 for more
information . R e fe r to ”Restoring a Switch” on page 4-16.
4-14 59022-03 D
4.6.5
Reinitializing the Configuration File System
If the Heartbeat LED on the switch is the 4-blink pattern, the configuration file
system may be corrupted. To recover the previous switch configu ration, use the
Config Restore command. The Heartbeat LED 4-blink pattern continues until a
previous switch configuration is successfully restored. The Heartbeat LED is not
reflected in the SANbox Manager.
4.7
Archiving a Switch
You can create an .XML archive file containing the configuration parameters.
Archived parameters include the fol lowi ng:
■ Switch properties and statistics
■ IP configuration
■ SNMP configuration
■ Port properties and statistics
4 – Managing Switches
Archiving a Switch
■ Zoning configuration
This archive file can be used to rest ore the conf igurati on on the same swi tch or on
a replacement switch. You can also use the archive file as a template for
configurring new switches to add to a fabric. Security settings and user account
information are not archived. The archive can be used later to restore the switch.
Refer to ”Restoring a Switch” on page 4-16 for more information. To archive a
switch, do the following:
1. Open the Switch menu and select Archive.
2. In the Save window, enter a file name.
3. Choose the Save button.
59022-03 D 4-15
4 – Managing Switches
Restoring a Switch
4.8
Restoring a Switch
Restoring a switch loads the archiv ed sw itch configuration parameters to the
switch. The switch configuration must be archived before it can be restored.
Refer to ”Archiving a Switch” on page 4-15 for more information.
It is good practice to archive and restore configurations from like switches. This
means restoring a SANbox2-16 switch with a SANbox2-16 archive file, or
restoring a SANbox2-8c with a SANbox2-8c archive file. If it is necessary to
restore a switch with a dissimilar archive file, consider the following:
■ If you restore a SANbox2-8c switch with a SANbox2-16 archive file, the
configuration for ports 0-7 on the SANbox2-8c switch will be restored.
Archive information for ports 8-15 will be ignored.
■ If you restore a SANbox2-16 switch with a SANbox2-8c archive file, the
configuration for ports 0-7 on the SANbox2-16 switch will be restored. Ports
8-15 wil be unchanged.
The Restore menu item is not available for the inband switches. You can only
restore a switch out-of-band (t he fabric management switch). To restore a switch,
do the following:
1. Open the Switch menu and select Restore.
2. In the Restore window , enter the s witch configur ation file name or browse for
the file.
3. Choose the Restore button.
4.9
Loading Firmware
The switch does not have to offline to download firmware. However, the switch
must be reset to activate the new firmware, which does require admin authority.
SANbox Manager will prompt you to reset the switch after the firmware is loaded.
The To load firmware to a switch, do the following:
1. In the faceplate display, open the Switch menu and select Load Firmware.
2. In the Firmware Upload window, choose the Select button to browse and
select the firmware file to be uploaded.
3. Choose the Start button to begin the firmware load process.
4. When the loading is complete, choose the Close button to close the
Firmware Upload window.
5. The application prompts you to reset the switch. Choose the OK button to
reset the switch and implement the new firmware.
4-16 59022-03 D
4.10
Restoring the Factory De fault Configuration
Restoring the Factory Default Configuration
You can restore the switch and port configuration settings to the factory default
values. To restore the factory configuration on a switch, open the Switch menu
and select Restore Factory Defaults. Table 4-8 lists the factory default switch
configuration settings. Restoring the switch to the factory default configurati on
does not restore the account name and password settings. You must use the
Reset Password File button in the Force PROM Mode screen. Refer to
Recovering a Switch section in the SANbox2-8c Fibre Channel Switch In stall ation
Guide or SANbox2 Fibre Channel Switch Installer’s/User’s Manual.
Table 4-8. Factory Default Configuration Settings
Setting Value
Chassis name SANbox2
Administrative state Online
4 – Managing Switches
Domain ID 1
Resource Allocation Timeout (RA TOV) 10000 milliseconds
Receiver Transmitter Timeout (RT TOV) 100 milliseconds
Error Detect Timeout (ED TOV) 2000 milliseconds
IP address 10.0.0.1
Subnet mask address 255.0.0.0
Gateway address 10.0.0.254
Boot method Static
Contact Undefined
Location Undefined
Trap address 127.0.0.1
Trap community Public
Read community Public
Write community Private
Port state Online
Port speed Auto-detect
Port mode GL
59022-03 D 4-17
4 – Managing Switches
Restoring the Factory Default Configuration
Notes
4-18 59022-03 D
Managing Ports
This section describes the following tasks that manage ports and devices:
■ Displaying port information
■ Configuring ports
■ Testing Ports
5.1
Displaying Port Information
Port information is available primarily in the fac eplate display shown in Figure 5-1.
The faceplate display data windows provide i nformatio n and s ta tistics f or swit ches
and ports. Use the topology display to show the status information for links
between switches.
Section 5
Figure 5-1. Faceplate Display - Port Information
59022-03 D 5-1
5 – Managing Ports
Displaying Port Information
5.1.1
Monitoring Port Status
The faceplate display provides the follo wing port related information:
■ Port mode
■ Port operational state
■ Port speed
■ Port media
To display port number and status information for a port, positi on the cursor over a
port on the faceplate display. The status information changes depending on the
View menu option selected.
5.1.1.1
Displaying Port Modes
To display port mode status, from the faceplate display, open the View menu, and
select View Port Modes. Table 5-1 lists the possible port modes and their
meanings.
Table 5-1. Port Modes
Mode Description
F Fabric port
FL Fabric loop port
TL Translated loop port
G Generic port
GL Generic fabric loop port
E Expansion port
D Donor port
5-2 59022-03 D
5.1.1.2
Displaying Port Operational States
To display the operational state on each port in the faceplate displ a y, open the
View menu and select View Port States. Table 5-2 lists the possibl e operational
states and their meanings. The port operati onal state refers to actual port state
and not the administrative state you may have assigned.
Table 5-2. Port Operat ional States
State Description
On Online - port is active and ready to send data.
Ia Inactive - port operational state is offline, but administrative state is
online.
Off Offline - port is active, can receive signal, but cannot accept a device
login.
Tst Test - port is active and being tested.
5 – Managing Ports
Displaying Port Information
Dn Down – the port is inactive or shut off, not receiving a signal, and can’t
5.1.1.3
Displaying Port Speeds
To display the speed of each port in the faceplate display, open the View menu
and select View Port Speeds. Table 5-3 lists the possible speeds.
State Description
1Gb A 1 Gbps transmission speed.
2Gb A 2 Gbps transmission speed.
be logged in.
Table 5-3. Port Speeds
59022-03 D 5-3
5 – Managing Ports
Displaying Port Information
5.1.1.4
Displaying Tranceiver Media Status
To display transceiver media status, open the View menu and select View Port
Media. Table 5-2 lists the possi ble media states and their meanings.
Table 5-4. Transceiver Media Vi ew
Media Icon Description
Optical SFP, Online (Green)
Optical SFP, Offline (Gray)
None Empty port, no transceiver installed
5.1.2
Port Statistics Data Window
The Port Statistics data window displays statistics about port performance. To
open the Port Statistics window, select one or more ports in the faceplate display
and choose the Port Statistics tab below the data window. Table 5-5 describes
the Port Statistics data window entries.
The Statistics pull-down menu is available on the Port Statistics data window, a nd
provides different ways to view detailed port information. Choose the down arrow
to open the pull-down menu. Open the pull-down menu and select Absolute to
view the total co unt of stati stics s ince the l ast switch r eset. Select Rate to vi ew the
number of statistics counted per second over the polling period. Select Baseline
to view the total count of statistics since the last time the baseline was set. When
viewing baseline statistics, choose the Cl ear Baseline button to set the current
baseline.
Table 5-5. Port Statistics Data Window Entries
Entry Description
Start Time The beginning of the period over which the statistics apply. The
start time for the Absolute view is not applicable. The start time
for the Rate view is the beginning of polling interval. The start
time for the Baseline view is the last time the baseline was set.
End Time The last time the statistics were updated on the display.
Total Time Total time period from start time to end time.
Login Count Number of logins that have occurred on the switch.
5-4 59022-03 D
5 – Managing Ports
Displaying Port Information
Table 5-5. Port Statistics Data Window Entries (Continued)
Entry Description
Logout Count Number of logouts that have occurred on the switch.
Al Init Count Number of times the port entered the initialization state.
Invalid Destination
Address
Total LIP Received Number of loop initialization primative frames received.
LIP F7F7 Count A loop initialization primative frame used to acquire an AL_PA.
LIP F8F7 Count Currently not used.
LIP F7AIPs Count This LIP is used to reinitialize the loop. An L_port, identified by
LIP F8AIPs Count This LIP denotes a loop failure detected by the L_port
LIP AIPdAIPs Count Number of F7, AL_PS LIPs, or AL_PD (vendor specific) resets,
Class 2 In Frames Number of class 2 frames received by this port.
Class 2 Out Frames Number of class 2 frames transmitted by this port.
Class 2 Words In Number of class 2 words received by this port.
Class 2 Words Out Number of class 2 words transmitted by this port.
Class 3 In Frames Number of class 3 frames received by this port.
Number of address identifiers (S_ID, D_ID) found to be in
error.
AL_PS, may have noticed a performance degradation and is
trying to restore the loop.
identified by AL_PS.
performed.
Class 3 Out Frames Number of class 3 frames transmitted by this port.
Class 3 Words In Number of class 3 words received by this port.
Class 3 Words Out Number of class 3 words transmitted by this port.
Decode Error Count Number of invalid transmission words detected during
decoding. Decoding is from the 10-bit characters and special K
characters.
Loss Of Sync Count Number of synchronization losses (>100 ms) detected by this
port. A loss of synchronization is detected by receipt of an
invalid transmissio n word.
Invalid CRC Count Number of invalid Cyclic Redundancy Check (CRC) frames
detected.
Tx Wait Count Number of times the port entered a wait state because it was
out of buffer-to-buffer credits.
59022-03 D 5-5
5 – Managing Ports
Displaying Port Information
Class 3 Toss Count Number of class 2 and class 3 sequences that were discarded
FReject Count Number of frames, from devices, that have been rejected.
FBusy Count Number of class 2 and class 3 fabric busy (F_BSY) frames
Link Failures Number of optical link failures detected by this port. A link
Table 5-5. Port Statistics Data Window Entries (Continued)
Entry Description
by this port. A sequence can be discarded because of
detection of a missing frame (based on SEQ_CNT), detection
of an E_D_TOV timeout, receiving a reject frame, receiving
frames for a stopped sequence, or other causes.
Frames can be rejected for any of a large number of reasons.
generated by this port in response to incoming frames. This
usually indicates a busy condition on the fabric or N_port that
is preventing delivery of this frame.
failure is a loss of synchronization for a period of time greater
than the value of R_T_TOV or by loss of signal while not in the
offline state. A loss of signal causes the switch to attempt to
re-establish the link. If the link is not re-established by the time
specified by R_T_TOV, a link failure is counted. A link reset is
performed after a link failure.
Primitive Sequence
Errors
Rx Link Resets Number of link reset primatives received from an attached
Tx Link Resets Number of link reset primatives sent from this port to an
Rx Offline Sequences Number of offline sequence primitives received by the port.
Tx Offline Sequences Number of offline primitives transmitted by the port.
Total Errors Total number of primitive and non-primitive port link errors.
Total Tx Frames Total number of frames transmitted by the port.
Total Rx Frames Total number of frames received by the port.
Total Tx Words Total number of words transmitted by the port.
Total Rx Words Total number of words received by the port.
Total Link Resets Number of link-reset primitives the transmitted by the port.
Total Offline
Sequences
Number of bad primitives received by the port.
device.
attached port.
Total number of offline sequences transmitted and received by
the port.
5-6 59022-03 D
5.1.3
Port Information Data Window
The Port Information data window displays port detail information for the selected
port. To open the Port Information data window, choose the Port Info tab below
the data window in the faceplate display.
Table 5-6. Port Info Data Window Entries
Entry Description
Admin Port Mode The port mode before auto-configuration
Oper Port Mode The current port mode.
Admin Port State The port state before auto-configuration
Oper Port State The current port state.
5 – Managing Ports
Displaying Port Information
occurs.
occurs.
Loop Enabled A setting to allow arbitrated loop
configuration.
Logged In Indicates whether logged in or not.
E Port Connection Status Whether E Port connection is enabled.
E Port Isolation Status Why E Port is isolated.
MFS Mode Port tuning indicator.
I/O Stream Guard Whether RSCN suppression is enabled or
disabled.
Admin Port Speed The speed requested by the user.
Oper Port Speed The speed actually being used by the port.
TLMode Indicates if TL target or TL initiator is being
used.
BB Credits Whether buffer-to-buffer credits have been
set.
Ext Credits Requested Whether extended credits have been
requested for ports.
Medium The transceiver type.
59022-03 D 5-7
5 – Managing Ports
Configuring Ports
5.1.4
Name Server Data Window
The Name Server data window displays information about the port and the
connected device. To open the Name Server data window, select one or more
switches in the topology display and choose the Name Server t ab below the dat a
window . You can also open the Name Server data window in the fac eplate display.
Refer to Table 4-1 for a description of the Name Server data window entries.
5.2
Configuring Ports
The port settings or characteristi cs are configured using the Port Properties
window shown in Figure 5-2. To open the Port Properties window, select one or
more ports, open the Port menu and select Port Properties.
Figure 5-2. Port Properties Window
The Port Properties window displays the switch name and the selected port(s).
Use the Port Properties window to change the following par ame ters:
■ Port state
■ Port speed
■ Port mode
■ TL mode
■ Port buffer credits
■ I/O Stream Guard (RSCN Suppression)
5-8 59022-03 D
5.2.1
Changing Port Administrative States
The port administrative state det ermines the port operational state. The port
administrative state refers to the requested state in the SANbox Manager
application or through the CLI; the port operational state refers to the state
actually being used by the p ort. Table 5-7 describes the port administra tive st ates.
To change port administrative state, do the following:
1. Select one or more ports in the faceplate display.
2. Open the Port menu and select Port Properties to open the Port Prop erties
window.
3. Choose the Port States radio button for the the port state you want.
4. Choose the OK button to write the new port state to the switch.
Table 5-7. Port Administrative States
State Description
5 – Managing Ports
Configuring Ports
Online Activates and prepares port to send data.
Offline Permits port to remain active, but prevents port from receiving signal
Test Permits port to remain active, but prepares port for testing.
5.2.2
Changing Port Speeds
The SANbox2 switch ports are capable of transmitting and receiving at 1 or 2
Gbps. The ports can be configured for either transmission speed or to sense the
transmission speed of the device to which it is connected. Table 5-8 describes the
port speeds. To change the port speed, do the following:
1. Select one or more ports in the faceplate display.
2. Open the Port menu and select Port Properties.
3. Choose the radio button that corresponds to the port speed you want.
4. Choose the Apply button to write the new port speed to the switch.
and accepting a device login.
59022-03 D 5-9
5 – Managing Ports
Configuring Ports
State Description
Auto-Detect Matches the transmission speed of the connected device. This is the
1Gb Sets the transmission speed to 1 Gbps.
2Gb Sets the transmission speed to 2 Gbps.
5.2.3
Changing Port Modes
The SANbox2 switch ports support both public and priv ate devices as single
devices or in loops. The ports can be configured to self-discover the proper mode
to match the device or s witch to which it is connected. Table 5-9 describe s the port
modes. To change the port mode, do the following:
1. Select one or more ports in the faceplate display.
Table 5-8. Port Speeds
default.
2. Open the Port menu and select Port Properties to open the Port Prop erties
window.
3. Choose the Port Modes radio but ton that c orr esponds t o the por t mode yo u
want.
4. Choose the OK button to write the new port mode to the switch.
Table 5-9. Port Modes
State Description
F_Port Fabric port - Supports a single public device (N_Port).
FL_Port Fabric loop port - Supports a loop of up to 126 public devices (NL_Port).
TL_Port Translated loop port - Supports a loop of up to 126 private target or
initiator devices capable of communicating with up to 63 public or private
devices on other ports. Refer to the Installation Guide for your switch for
more information about TL_Ports.
G_Port Generic port - Self discovers as an F_Port or an E_Port.
GL_Port Generic loop port - Self discovers as an F_Port, FL_Port, or an E_Port.
Donor Donor port - Allows buffer credits to used by another port.
5-10 59022-03 D
5.2.4
Changing TL Modes
You can configure a TL_Port to support a loop of private target devices or a loop
of private initiator devices.
■ For a loop of private tar get devic es, choose the TL Target radio butto n. This
enables up to 63 initiator devices anywhere in the fabric to automatically
connect with the private devices on the TL_Port. Use zoning to limit the
number of possible initiators to 63.
■ For a loop of private initiator devices, choose the TL Initiator radio button.
This enables the private ini tiators on the TL_Port to au tomatica lly connect t o
up to 63 target devices. The TL_Port init iator devi ces and the t a rget devi ces
must be members of the same soft zone.
5.2.5
Changing Buffer-to-Buffer Credits
Each SANbox2 port has a receive buffer cap a city of 12 Fibre Channel frames or
credits which is equal to approximatel y 24K bytes. Port buffer credits can be
changed on ports to accommodate connections to non-SANbox2 switches that
have different port buffer capacities. To change port buffer credits, do the
following:
5 – Managing Ports
Configuring Ports
1. Select one or more ports in the faceplate display.
2. Open the Port menu and select Port Properties.
3. In the E_Port BB Credits field, enter the new number.
4. Choose the OK button to write the new buffer-to-buffer setting to the switch.
5.2.6
I/O Stream Guard
The I/O Stream Guard feature suppresses Registered State Control Notification
(RSCN) messages on a port basis.
5.2.7
Extending Port Credits
Each port is supported by a data buffer with a 12 credit capacity; that is, 12
maximum sized frames. For fibre optic cables, this enables full bandwidth class 2
service over a distance of 20 kilomet ers at 1 Gbps (0.6 credits/Km), or 10
kilometers at 2 Gbps (1.2 credits/Km). Longer distances can be spanned at full
bandwidth by borrowing credits from designated donor ports thus pooling the
buffer capacities. This is called credit extension. Each donor port contributes 11
credits to the pool from which the recipient ports can draw. For example, one
donor port contributes 11 credits to the pool from which a recipient draws for a
total of 23 credi t s ( 11+12). This provides approximately 38 Km at 1 Gbps (23÷0.6)
or 19 Km at 2 Gbps (23÷1.2).
59022-03 D 5-11
5 – Managing Ports
Configuring Ports
To extend port buffer credits, do the following:
1. In the faceplate display, select the ports that are to serve as donor ports .
2. In the faceplate display, select the recipient ports. Recipient ports must be
3. Distribute the borrowed cre dit s by inc rementin g the Ext Credits Requested
Open the Port menu and select Port Properties. In the Port Properties
window, choose the Donor radio button and choose OK.
Note: Donor ports are incapa ble of transmitting or receiving data.
configured as G_Ports or F_Ports. Open the Port menu and select
Extended Credits. This opens the Extended Credits window shown in
Figure 5-3.
field for the recipient ports up to the total credits in the pool. If you exceed
this total, s ome recipien t port s wil l not r eceive th e request ed credit s. Choose
OK.
Note: As credits are used, the Logged-In LEDs on the corresponding donor
ports illuminate continuously. In addition, donor port Activity LEDs will
reflect the same traf fic as t he rec ipient port . Donor ports whose credits
are being used are unavailable to devices that are connected to them.
Figure 5-3. Extended Credits Window
5-12 59022-03 D
5.2.8
Resetting a Port
The Reset Port option reinitializes the port using configuration parameters in
memory. To reset a port, do the following:
1. In the Faceplate Display, select the port(s) to be reset.
2. Open the Port menu and select Reset Por t.
5.3
Testing Ports
The port loopback tests veri fy correct port operation by sending a frame out
through the loop, and then verifying that the fr ame recei ved ma tches the frame
that was sent. Only one port can be tested at a time for each type of test. The
three types of port loopback tests are:
■ SerDes level (Internal) - The SerDes level test verifies port circuitry. The
SerDes level test sends a test frame f rom the ASIC through the SerDes chip
and back to the ASIC for the selected ports. The port passes the test if the
frame that was sent by the ASIC matches the test frame that was receiv ed.
5 – Managing Ports
Testing Ports
■ SFP level (External) - The SFP level test also verifies port cir cuitry. The
SFP level test sends a test frame from the ASIC through the SerDes chip,
through the SFP transceiver fitted wit h a loopback plug, and back to the
ASIC for the selected ports. The port passes the test if the test frame that
was sent by the ASIC matches the test frame that was received.
■ Node-to-Node (Online) - The Node-to-Node test verifies communications
between the port and its device node or device lo op. The port being tested
must be online and connected to a remote dev ice. The port passes the t est if
the test frame that was sent matches the test frame that was received.
Figure 5-4. Port Loopback Test Window
59022-03 D 5-13
5 – Managing Ports
Testing Ports
Note: The SerDes (Internal) and SFP (External) level tests disrupt
To run the Internal, External, or Online port loopback test on a port, do the
following:
1. In the faceplate display, select the port to be tested.
2. Open the Port menu and select Port Loopback Test to open the Port
3. In the Test Selection area, choose the radio button for the type of loopback
communication on the selected port. The Node-to-Node (Online) level
test does not disrupt co mmunication, because the requi res that t he port
be online.
Loopback Test window.
test (Internal, External, or Online) to be run.
■ If you choose the Internal or External test, SANbox Manager wi ll
prompt you to confirm that the state of the port being tested needs t o
be changed to the Test (diagnostic) state in order to run the test.
Choose the OK butt on and SANbox Manager will change the port
state. In the Port Loopback Test window, choose the Start Test button
to begin the test.
■ If you choose the Online test, the fields in the Test Parameters area
are activated. Enter the frame count, frame size, and choose a test
pattern radio button. You may use the default pattern or enter a
user-specified pattern (hex). Check the Terminate Test Upon Error
box if you want the test to stop when encountering an error. Choose
the Start Test button to begin the test.
4. The Test Results area displays the test status, number of frames sent , and
number of errors found.
5. To test another port, open the Select Port pull-down menu and select
another port (number) and test type (Inter nal, Exter nal, or Onli ne) in th e Test
Selection area.
6. Choose the Start Test button to begin the next test . Observe the results in
the Test Results area.
5-14 59022-03 D
Command Line Interfa c e
Each SANbox2 switch contains a Telnet server. This server allows a Telnet client
to establish a Telnet session with the switch to retrieve information or to configure
parameters. The Command Line Interface enables you to perform a variety of
fabric and switch management tasks through an Ethernet or a serial port
connection to a switch.
A.1
Logging On to a Switch
To log on to a switch using Telnet, open a command line window on the
management workstation and ent er the Telnet command followed by the switch IP
address:
/> telnet 123.45.67.890
A Telnet window opens prompting you for a SANbox2 login. Enter an account
name and password. Switches come from the factory with the following user
account already defined:
Account name: admin
Password: password
Authority: Admin
Appendix A
This user account provides full access to the switch and its configuration. After
planning your fabric management needs and creating your own user account s,
consider changing the password for this account. Refer to ”Commands” on
page A-3 for more information about authority levels. Refer to the ”User
Command” on page A-59 for information about cr eating and deleting user
accounts.
Note: The switch supports a combined maximum of 15 logins. This incl udes
SANbox Manager inband and out-of-band logins, Telnet out-of-band
logins, and SNMP out-of-band logins. Additional logins will be refused.
59022-03 D A-1
A – Command Line Interface
Command Syntax
A.2
Command Syntax
The command syntax is as follows:
command
word
key
keyword [value]
keyword [value1] [value2]
The Command is f ollowed by o ne or mor e keywords. Consid er the fol lowing rules
and conventions:
■ Commands and keywords are lowercase and case sensitive.
■ Commands with keywords require one of those keywords.
■ Required keyword values appear in standard font: [value]. Optional values
are shown in italics: [value].
■ Underlined portions of the keyword in the command format indicate the
abbreviated form that can be used. For example the Del
abbreviated Del.
ete keyword can be
A-2 59022-03 D
A.3
Commands
A – Command Line Interface
Commands
The command set provides for User and Admin authority levels.
■ User authority grants viewing access to the fabric and switches using the
Show command and other read-only commands.
■ Admin authority includes the User aut hority and grants permission to use the
Admin command. The Admin S t art command opens an admin session which
provides access to the commands that change switch and fabric
configurations. Refer to the ”Admin Command” on page A-4.
Note: Admin authority is enforced only if fabric security is enabled on
the switch. By default, fabric security is disabled. Refer to the
System keyword of the ”Set Setup Command” on page A-34 for
information about setting fabric security.
The commands and their page numbers are listed by authority level in Table A-1.
Table A-1. Commands Listed by Authority Level
User Authority Commands Admin Authority Command
Date
Help
History
Ps
Quit
Set Beacon
Show
Show Config
Show Log
Show Perf
Show Setup
Uptime
Whoami
1
Some keywords are available with User authority outsiide of an admin session.
(A-9)
(A-11)
(A-12)
(A-16)
(A-17)
(A-23)
(A-39)
(A-48)
(A-50)
(A-52)
(A-53)
(A-58)
(A-61)
Admin (A-4)
Admin Session Commands
1
Alias
1
Config
Fallback
Image
Lip
Passwd
Reset
Set Alarm Clear
Set Config
Set Log
Set Port
Set Setup
Set Switch
Shutdown
Test
1
User
1
Zone
Zoneset
Zoning
1
1
(A-5)
(A-7)
(A-10)
(A-13)
(A-14)
(A-15)
(A-18)
(A-22)
(A-24)
(A-30)
(A-33)
(A-34)
(A-38)
(A-55)
(A-56)
(A-59)
(A-62)
(A-65)
(A-67)
59022-03 D A-3
A – Command Line Interface
Admin Command
Admin Command
Opens and closes an Admin sessi on granting Admin authority. The Admin session
provides commands that change the fabric and switch conf igurations. Only one
Admin session can be open in the fabric at any time. An inactive Admin session
will time out after a period of time which can be changed using the Set Setup
System command. Refer to the Set Setup Command on page A-34.
Authority Admin
Syntax admin
start
end
cancel
Keywords start
Opens the Admin session.
end
Closes the Admin session.
cancel
Terminates an Admin session opened by another user. Use this keyword with care
because it terminates the Admin session withou t warning the other user and
without saving pending changes.
Examples The following example shows how to open and close an Admin session:
SANbox2 $> admin start
SANbox2 (admin) #>
.
.
.
SANbox2 (admin) #> admin end
SANbox2 #>
A-4 59022-03 D
Alias Command
Creates a named set of ports. Aliases make it easier to assign a set of ports to
many zones. An alias can not have a zone or another alias as a member.
Authority Admin
Syntax alias
add [alias] [members]
copy [alias_source] [alias_destination]
create [alias]
del
ete [alias]
list
members [alias]
remove [alias] [members]
rename [alias_old] [alias_new]
Keywords add [alias] [members]
Speci fies one or more ports given by [members] to add to the alias named [alias].
[members] can have one of the following formats:
A – Command Line Interface
Alias Command
■ Domain ID and port number p air (Domain I D, Port Number). Domain IDs and
port numbers are in decimal. Ports are numbered beginning with 0.
■ 6-character device Fibre Channel address (hex)
■ 16-character hexadecimal worldwide port name (WWPN) with the format
xx:xx:xx:xx:xx:xx:xx:xx.
The application verifie s that the [alias] format is correct, but does not validate that
such a port/device exists.
copy [alias_source] [alias_destination]
Creates a new alias named [alias_destination] and copies the membership into it
from the alias given by [alias_source].
create [alias]
Creates an alias with the name given by [alias]. The alias name can have a
maximum of 64 characters.
del
ete [alias]
Deletes the specified alias gi ven by [ali as] from the zon ing datab ase. If the alias i s
a member of the active zone set, the alias will not be removed from the active
zone set until the active zone set is deactivated.
list
Displays a list of all aliases. This keyword is valid for User authority and does not
require a zoning edit session or an admin session.
members [alias]
Displays all members of the alias given by [alias]. This keyword is available with
User authority and does not require a zoning edit session or an admin session.
59022-03 D A-5
A – Command Line Interface
Alias Command
remove [alias] [members]
Removes the ports given by [members] from the alias given by [alias]. [members ]
can have one of the following formats:
■ Domain ID and port number p air (Domain I D, Port Number). Domain IDs and
port numbers are in decimal. Ports are numbered beginning with 0.
■ 6-character device Fibre Channel address (hex)
■ 16-character hexadecimal worldwide port name ( WWPN) for the device wi th
the format xx:xx:xx:xx:xx:xx:xx:xx.
rename [alias_old] [alias_new]
Renames the alias given by [alias_old] to the alias given by [alias_new].
A-6 59022-03 D
Config Command
Manages the Fibre Channel configurations on a switch. For infor m ation about
setting the port and switch configurations, refer to the ”Set Config Command” on
page A-24.
Authority Admin for all keywords except List
Syntax config
act
ivate [config]
backup
cancel
copy [config_source] [config_destination]
del
ete [config]
edit [config]
list
restore
save [config]
Keywords activate [config]
Activates the configuration given by [config]. If you omit the configuration, the
currently active configura ti on is used. SANbox2 supports up to 10 configurations
(only one can be active at a time).
A – Command Line Interface
Config Command
backup
Creates a file named configdata, which contains the system configuration
information. This file should be downl oaded from the switch using FTP and st ored
in a safe place.
cancel
Terminates the current configuration edit session without saving changes that
were made.
copy [config_source] [config_destination]
Copies the configuration given by [config_source] to the configuration given by
[config_destination].
delete [config]
Deletes the specified configurati on fi le where [config] is a file name.
edit [config]
Opens the an edit session for the configuration given by [config]. If you omit the
configuration name, the currentl y active configuration is used. SANbox2 supports
up to 10 configurations (only one can be active at a time).
list
Displays a list of all available configurations. This keyword is available with User
authority.
restore
Restores configuration settings t o the switch fr om a backup file named configdata,
which must be first uploaded on the switch using FTP. Y ou create the backup file
59022-03 D A-7
A – Command Line Interface
Config Command
using the Config Backup command. Use FTP to load the backup file on a switch,
then enter the Config Restore command.
save [config]
Saves changes made during a configuration edit session in the configuration
given by [config]. If you omit the configur ation name value, the configuration you
chose for the Config Edit command is used.
Notes If you edit the active configuration, changes will be held in suspense until you
reactivate the configurati on or activate another configuration.
Examples The following shows an example of how to open and close a Config Edit session:
SANbox2 $> admin start
SANbox2 (admin) #> config edit
.
.
.
SANbox2 (admin-config) #> config cancel
Configuration mode will be canceled.Please confirm (y/n): [n] y
SANbox2 (admin) #> admin end
SANbox2 $>
A-8 59022-03 D
Date Command
This command displays or set s the system dat e and time. To set the date and time
the information string must be provided in this forma t: MMDDhhmmCCYY.
Authority Admin
Syntax date
[MMDDhhmmCCYY]
Keywords [MMDDhhmmCCYY]
Specifies the date. If you omit the keyword value, the current date is displayed.
Examples The following is an example of the Date command:
SANbox2 $> date
Tue Jun 12 07:51:24 2001
A – Command Line Interface
Date Command
59022-03 D A-9
A – Command Line Interface
Fallback Command
Fallback Command
Loads the fallback version of the fir mware fr om switch memory. The switch stores
two versions of the firmware. This command alternately activates the two
versions.
Authority Admin
Syntax fallback
Notes ■ The Show Switch command displays the available firmware versions and
the currently active version.
■ After executing the Fallback command, reset the switch for the firmware to
placed in effect.
Examples The following is an example of the Fallback command:
SANbox2 $> admin start
SANbox2 (admin) #> fallback
Reverting to previous software image. Please confirm (y/n): [n] y
SANbox2 $> admin end
SANbox2 $>
A-10 59022-03 D
Loading...