Q-Logic SANBOX2-8C/16 User Manual

Loading...

0

S i m p l i f y

 

SANbox2-8c/16 Switch Management

User’s Guide

Firmware Version 4.2

 

 

 

 

 

 

59022-10 A

Page i

SANbox2-8c/16 Switch Management

0

User’s Guide

Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties which may result from its use. QLogic Corporation reserves the right to change product specifications at any time without notice. Applications described in this document for any of these products are for illustrative purposes only. QLogic Corporation makes no representation nor warranty that such applications are suitable for the specified use without further testing or modification. QLogic Corporation assumes no responsibility for any errors that may appear in this document.

QLogic, SANsurfer Switch Manager, SANbox, SANbox2, SANsurfer, and SANblade are trademarks or registered trademarks of QLogic Corporation.

Gnome is a trademark of the GNOME Foundation Corporation.

Java and Solaris are registered trademarks of Sun Microsystems, Inc. Linux is a registered trademark of Linus Torvalds.

Microsoft, Windows NT, and Windows 2000, and Internet Explorer are trademarks of Microsoft Corporation.

Netscape Navigator and Mozilla are trademarks or registered trademarks of Netscape Communications Corporation.

Red Hat is a registered trademark of Red Hat Software Inc.

All other brand and product names are trademarks or registered trademarks of their respective owners.

Document Revision History

Release, Revision A, September 2004

© 2000–2005 QLogic Corporation

First Printed: May 2001

All Rights Reserved Worldwide.

Printed in U.S.A.

Page ii

59022-10 A

Table of Contents

Section 1

Introduction

 

1.1

Intended Audience .............................................................................................

1-1

1.2

Related Materials ...............................................................................................

1-1

1.3

JDOM License....................................................................................................

1-2

1.4

Technical Support...............................................................................................

1-3

1.4.1

Availability..................................................................................................

1-3

1.4.2

Training......................................................................................................

1-3

1.4.3

Contact Information ...................................................................................

1-3

Section 2 Using SANsurfer Switch Manager

 

2.1

Installing the Management Application...............................................................

2-1

2.1.1

SANsurfer Switch Manager .......................................................................

2-2

2.1.2

SANsurfer Management Suite...................................................................

2-3

2.1.2.1

SMS Installation for Windows ...........................................................

2-3

2.1.2.2

SMS Installation for Linux .................................................................

2-5

2.1.2.3

SMS Installation for Solaris...............................................................

2-6

2.2

Starting SANsurfer Switch Manager...................................................................

2-8

2.3

Exiting SANsurfer Management Suite..............................................................

2-11

2.4

Uninstalling SANsurfer Switch Manager ..........................................................

2-12

2.4.1

SMS Uninstall ..........................................................................................

2-12

2.4.2

Standalone Uninstall................................................................................

2-13

2.5

Changing the Encryption Key for the Default Fabric View File.........................

2-14

2.6

Saving and Opening Fabric View Files ............................................................

2-14

2.7

Setting SANsurfer Switch Manager Preferences .............................................

2-14

2.8

Using Online Help ............................................................................................

2-16

2.9

Viewing Software Version and Copyright Information ......................................

2-16

2.10

SANsurfer Switch Manager User Interface ......................................................

2-17

2.10.1

Menu Bar.................................................................................................

2-18

2.10.1.1

Topology Display Menu ..................................................................

2-18

2.10.1.2

Faceplate Display Menu .................................................................

2-19

2.10.1.3

Topology Display Shortcut Keys .....................................................

2-20

2.10.1.4

Faceplate Display Shortcut Keys....................................................

2-21

2.10.2

Tool Bar ...................................................................................................

2-23

2.10.3

Fabric Tree ..............................................................................................

2-24

2.10.4

Graphic Window ......................................................................................

2-25

2.10.5

Data Window and Tabs............................................................................

2-25

59022-10 A

Page iii

SANbox2-8c/16 Switch Management

0

User’s Guide

 

 

 

 

 

 

 

2.10.6

Working Status Indicator..........................................................................

2-25

 

2.11

Using the Topology Display ..............................................................................

2-26

2.11.1

Switch and Link Status ............................................................................

2-26

2.11.2

Working with Switches and Links ............................................................

2-27

 

2.11.2.1

Selecting Switches and Links .........................................................

2-27

 

2.11.2.2

Arranging Switches in the Display ..................................................

2-27

 

2.11.3

Opening the Faceplate Display and Topology Popup Menus..................

2-28

 

2.11.4

Topology Data Windows ..........................................................................

2-28

 

2.12

Using the Faceplate Display.............................................................................

2-29

 

2.12.1

Port Views and Status .............................................................................

2-29

 

2.12.2

Working with Ports...................................................................................

2-30

2.12.2.1

Selecting Ports................................................................................

2-30

 

2.12.2.2

Opening the Faceplate Popup Menu..............................................

2-30

 

2.12.3

Faceplate Data Windows.........................................................................

2-31

 

Section 3

Managing Fabrics

 

 

3.1

Fabric Security ...................................................................................................

3-1

3.1.1

User Account Security...............................................................................

3-1

 

3.1.2

Fabric Services..........................................................................................

3-2

3.1.2.1

Enabling SNMP Configuration..........................................................

3-2

 

3.1.2.2

Enabling In-band Management ........................................................

3-2

 

3.2

Fabric Tracker ....................................................................................................

3-3

3.2.1

Saving a Version Snapshot .......................................................................

3-3

 

3.2.2

Viewing and Comparing Version Snapshots..............................................

3-3

 

3.2.3

Exporting Version Snapshots to a File.......................................................

3-4

 

3.3

Managing the Fabric Database ..........................................................................

3-4

 

3.3.1

Adding a Fabric .........................................................................................

3-5

3.3.2

Removing a Fabric ....................................................................................

3-6

3.3.3

Opening a Fabric View File .......................................................................

3-6

 

3.3.4

Saving a Fabric View File ..........................................................................

3-6

 

3.3.5

Rediscovering a Fabric..............................................................................

3-6

3.3.6

Adding a New Switch to a Fabric...............................................................

3-7

 

3.3.7

Replacing a Failed Switch .........................................................................

3-8

 

3.3.8

Deleting Switches and Links......................................................................

3-9

 

3.4

Displaying Fabric Information.............................................................................

3-9

 

3.4.1

Fabric Status..............................................................................................

3-9

3.4.2

Displaying the Event Browser..................................................................

3-11

 

3.4.2.1

Filtering the Event Browser ............................................................

3-13

 

3.4.2.2

Sorting the Event Browser..............................................................

3-14

 

3.4.2.3

Saving the Event Browser to a File ................................................

3-14

 

Page iv

59022-10 A

0

SANbox2-8c/16 Switch Management

 

 

User’s Guide

 

 

 

 

3.4.3

Devices Data Window .............................................................................

3-15

3.4.4

Active Zone Set Data Window.................................................................

3-16

3.4.5

Link Data Window....................................................................................

3-17

3.5

Working with Device Information and Nicknames ............................................

3-17

3.5.1

Displaying Detailed Device Information...................................................

3-17

3.5.2

Exporting Device Information to a File.....................................................

3-18

3.5.3

Managing Device Port Nicknames ..........................................................

3-18

3.5.3.1

Creating a Nickname ......................................................................

3-18

3.5.3.2

Editing a Nickname.........................................................................

3-19

3.5.3.3

Deleting a Nickname ......................................................................

3-19

3.5.3.4

Exporting Nicknames to a File........................................................

3-19

3.5.3.5

Importing a Nicknames File ............................................................

3-20

3.6

Zoning a Fabric ................................................................................................

3-20

3.6.1

Zoning Concepts .....................................................................................

3-20

3.6.1.1

Zones..............................................................................................

3-21

3.6.1.2

Aliases ............................................................................................

3-22

3.6.1.3

Zone Sets .......................................................................................

3-22

3.6.1.4

Zoning Database ............................................................................

3-23

3.6.2

Using the Zoning Wizard .........................................................................

3-24

3.6.3

Managing the Zoning Database ..............................................................

3-24

3.6.3.1

Editing the Zoning Database ..........................................................

3-25

3.6.3.2

Configuring the Zoning Database ...................................................

3-28

3.6.3.3

Saving the Zoning Database to a File.............................................

3-29

3.6.3.4

Restoring the Zoning Database from a File ....................................

3-29

3.6.3.5

Restoring the Default Zoning Database..........................................

3-30

3.6.3.6

Removing All Zoning Definitions.....................................................

3-30

3.6.4

Managing Zone Sets ...............................................................................

3-30

3.6.4.1

Creating a Zone Set .......................................................................

3-31

3.6.4.2

Activating and Deactivating a Zone Set..........................................

3-32

3.6.4.3

Copying a Zone to a Zone Set........................................................

3-32

3.6.4.4

Removing a Zone from a Zone Set or from All Zone Sets..............

3-32

3.6.4.5

Removing a Zone Set.....................................................................

3-33

3.6.5

Managing Zones......................................................................................

3-33

3.6.5.1

Creating a Zone in a Zone Set .......................................................

3-34

3.6.5.2

Adding Zone Members ...................................................................

3-35

3.6.5.3

Renaming a Zone or a Zone Set ....................................................

3-36

3.6.5.4

Removing a Zone Member .............................................................

3-36

3.6.5.5

Removing a Zone from a Zone Set ................................................

3-36

3.6.5.6

Removing a Zone from All Zone Sets.............................................

3-36

59022-10 A

Page v

SANbox2-8c/16 Switch Management

0

User’s Guide

 

 

 

 

 

 

 

3.6.5.7

Changing Zone Types ....................................................................

3-37

 

3.6.6

Managing Aliases ....................................................................................

3-37

3.6.6.1

Creating an Alias ............................................................................

3-37

 

3.6.6.2

Adding a Member to an Alias .........................................................

3-38

 

3.6.6.3

Removing an Alias from All Zones .................................................

3-38

 

3.6.7

Merging Fabrics and Zoning....................................................................

3-39

 

3.6.7.1

Zone Merge Failure ........................................................................

3-39

 

3.6.7.2

Zone Merge Failure Recovery ........................................................

3-40

 

Section 4

Managing Switches

 

 

4.1

Managing User Accounts ...................................................................................

4-2

 

4.1.1

Creating User Accounts.............................................................................

4-3

 

4.1.2

Removing a User Account.........................................................................

4-4

4.1.3

Changing a User Account Password.........................................................

4-5

 

4.1.4

Modifying a User Account..........................................................................

4-6

 

4.2

Displaying Switch Information ............................................................................

4-7

4.2.1

Devices Data Window ...............................................................................

4-8

 

4.2.2

Switch Data Window..................................................................................

4-9

4.2.3

Port Statistics Data Window ....................................................................

4-12

 

4.2.4

Port Information Data Window.................................................................

4-12

4.2.5

Configured and Active Zonesets Data Window .......................................

4-13

 

4.3

Configuring Port Threshold Alarms ..................................................................

4-14

 

4.4

Paging a Switch................................................................................................

4-15

4.5

Setting the Date/Time and Enabling NTP Client ..............................................

4-16

 

4.6

Resetting a Switch............................................................................................

4-16

 

4.7

Configuring a Switch ........................................................................................

4-18

4.7.1

Using the Configuration Wizard...............................................................

4-18

 

4.7.2

Switch Properties.....................................................................................

4-19

4.7.2.1

Symbolic Name ..............................................................................

4-20

 

4.7.2.2

Switch Administrative States...........................................................

4-20

 

4.7.2.3

Domain ID and Domain ID Lock .....................................................

4-21

 

4.7.2.4

Fabric Device Management Interface.............................................

4-21

 

4.7.2.5

Broadcast Support..........................................................................

4-22

 

4.7.2.6

In-band Management .....................................................................

4-22

 

4.7.2.7

Interop Mode for Zoning .................................................................

4-23

4.7.2.8

Legacy Port Address Format..........................................................

4-23

 

4.7.2.9

Timeout Values ...............................................................................

4-24

4.7.3

Network Properties ..................................................................................

4-25

4.7.3.1

IP Configuration..............................................................................

4-26

4.7.3.2

Remote Logging .............................................................................

4-27

 

Page vi

59022-10 A

0

SANbox2-8c/16 Switch Management

 

 

User’s Guide

 

 

 

 

4.7.3.3

NTP Client ......................................................................................

4-27

4.7.4

SNMP Properties.....................................................................................

4-28

4.7.4.1

SNMP Configuration.......................................................................

4-29

4.7.4.2

SNMP Trap Configuration...............................................................

4-30

4.8

Archiving a Switch ............................................................................................

4-31

4.9

Restoring a Switch ...........................................................................................

4-31

4.10

Restoring the Factory Default Configuration ....................................................

4-33

4.11

Downloading a Support File .............................................................................

4-35

4.12

Installing Firmware ...........................................................................................

4-35

4.13

Displaying Hardware Status .............................................................................

4-37

Section 5

Managing Ports

 

5.1

Displaying Port Information ................................................................................

5-1

5.1.1

Monitoring Port Status ...............................................................................

5-2

5.1.1.1

Displaying Port Types.......................................................................

5-2

5.1.1.2

Displaying Port Operational States...................................................

5-3

5.1.1.3

Displaying Port Speeds ....................................................................

5-3

5.1.1.4

Displaying Transceiver Media Status................................................

5-4

5.1.2

Port Statistics Data Window ......................................................................

5-4

5.1.3

Port Information Data Window...................................................................

5-7

5.2

Configuring Ports..............................................................................................

5-10

5.2.1

Changing Port Administrative States .......................................................

5-11

5.2.2

Changing Port Speeds ............................................................................

5-12

5.2.3

Changing Port Types...............................................................................

5-13

5.2.4

I/O Stream Guard ....................................................................................

5-14

5.2.5

Scan Device ............................................................................................

5-14

5.2.6

Changing Port Symbolic Name ...............................................................

5-14

5.3

Using the Extended Credits Wizard .................................................................

5-15

5.4

Resetting a Port................................................................................................

5-16

5.5

Testing Ports.....................................................................................................

5-16

5.6

Graphing Port Performance .............................................................................

5-18

5.6.1

Starting SANsurfer Performance Viewer .................................................

5-19

5.6.2

Exiting SANsurfer Performance Viewer...................................................

5-20

5.6.3

Saving and Opening Performance View Files .........................................

5-21

5.6.4

Changing the Default Performance View File Encryption Key

................ 5-22

5.6.5

Setting SANsurfer Performance Viewer Preferences..............................

5-22

5.6.6

Setting the Polling Frequency..................................................................

5-22

5.6.7

Displaying Graphs ...................................................................................

5-23

5.6.7.1

Arranging Graphs in the Display.....................................................

5-23

5.6.7.2

Customizing Graphs .......................................................................

5-24

59022-10 A

Page vii

SANbox2-8c/16 Switch Management

0

User’s Guide

 

 

 

 

 

 

 

5.6.7.3

Rescaling a Selected Graph...........................................................

5-26

 

5.6.8

Printing Graphs........................................................................................

5-26

5.6.9

Saving Graph Statistics to a File..............................................................

5-26

Appendix A Command Line Interface

 

 

A.1

Logging On to a Switch ......................................................................................

A-1

A.2

User Accounts ....................................................................................................

A-2

A.3

Working with Switch Configurations ...................................................................

A-2

A.3.1

Modifying a Configuration..........................................................................

A-3

A.3.2

Backing up and Restoring Switch Configurations......................................

A-4

A.4

Commands .........................................................................................................

A-6

 

Admin Command.......................................................................................

A-8

 

Alias Command .........................................................................................

A-9

 

Config Command.....................................................................................

A-11

 

Create Support Command.......................................................................

A-14

 

Date Command .......................................................................................

A-16

 

Firmware Install Command......................................................................

A-17

 

Hardreset Command ...............................................................................

A-18

 

Help Command........................................................................................

A-19

 

History Command....................................................................................

A-20

 

Hotreset Command .................................................................................

A-21

 

Image Command .....................................................................................

A-22

 

Lip Command ..........................................................................................

A-25

 

Passwd Command ..................................................................................

A-26

 

Ping Command........................................................................................

A-27

 

Ps Command...........................................................................................

A-28

 

Quit Command ........................................................................................

A-29

 

Reset Command......................................................................................

A-30

 

Set Command..........................................................................................

A-36

 

Set Config Command ..............................................................................

A-38

 

Set Log Command...................................................................................

A-48

 

Set Port Command ..................................................................................

A-51

 

Set Setup Command ...............................................................................

A-53

 

Show Command ......................................................................................

A-58

 

Show Config Command...........................................................................

A-73

 

Show Log Command...............................................................................

A-76

 

Show Perf Command ..............................................................................

A-79

 

Show Setup Command............................................................................

A-81

 

Shutdown Command ...............................................................................

A-83

 

Test Command ........................................................................................

A-84

Page viii

59022-10 A

0

SANbox2-8c/16 Switch Management

 

User’s Guide

 

 

 

Uptime Command....................................................................................

 

A-87

User Command .......................................................................................

 

A-88

Whoami Command..................................................................................

 

A-91

Zone Command.......................................................................................

 

A-92

Zoneset Command ..................................................................................

 

A-96

Zoning Command ....................................................................................

 

A-98

Glossary

Index

Figures

Figure

 

Page

2-1

Initial Startup Dialog .......................................................................................................

2-9

2-2

SANsurfer Switch Manager Window ............................................................................

2-10

2-3

Save Default Fabric View File Dialog...........................................................................

2-11

2-4

Load Default Fabric File Dialog....................................................................................

2-12

2-5

Preferences Dialog – SANsurfer Switch Manager .......................................................

2-15

2-6

SANsurfer Switch Manager Display Elements .............................................................

2-17

2-7

Topology Display Menu................................................................................................

2-18

2-8

Faceplate Display Menu...............................................................................................

2-19

2-9

Fabric Tree...................................................................................................................

2-24

2-10

Topology Display..........................................................................................................

2-26

2-11

Faceplate Display.........................................................................................................

2-29

3-1

Fabric Version Snapshot Analysis Dialog ......................................................................

3-4

3-2

Add a New Fabric Dialog ...............................................................................................

3-5

3-3

Events Browser ............................................................................................................

3-11

3-4

Filter Events Dialog ......................................................................................................

3-13

3-5

Active Zone Set Data Window .....................................................................................

3-16

3-6

Detailed Devices Display Dialog ..................................................................................

3-17

3-7

Edit Zoning Dialog........................................................................................................

3-25

3-8

Zoning Config Dialog....................................................................................................

3-28

4-1

User Account Administration Dialog – Add Account ......................................................

4-3

4-2

User Account Administration Dialog – Remove Account ...............................................

4-4

4-3

User Account Administration Dialog– Change Password ..............................................

4-5

4-4

User Account Administration Dialog – Modify Account ..................................................

4-6

4-5

Faceplate Display...........................................................................................................

4-7

4-6

Faceplate Display - Port Information............................................................................

4-12

4-7

Configured Zonesets Data Window .............................................................................

4-13

4-8

Port Threshold Alarm Configuration Dialog..................................................................

4-14

4-9

Port Threshold Alarm Example ....................................................................................

4-15

4-10

Switch Properties Dialog ..............................................................................................

4-19

4-11

Network Properties Dialog ...........................................................................................

4-25

4-12

SNMP Properties Dialog ..............................................................................................

4-28

59022-10 A

Page ix

SANbox2-8c/16 Switch Management

0

User’s Guide

 

 

 

 

 

4-13

Restore Dialogs – Full and Selective ...........................................................................

4-32

 

4-14

Hardware Status LEDs.................................................................................................

4-37

5-1

Faceplate Display - Port Information..............................................................................

5-1

 

5-2

Port Properties Dialog ..................................................................................................

5-10

5-3

Designate Donor Ports.................................................................................................

5-15

5-4

Port Loopback Test Dialog...........................................................................................

5-16

 

5-5

Fabric View Graphs......................................................................................................

5-18

5-6

Save Default Performance View File Dialog ................................................................

5-20

 

5-7

Load Default Performance File Dialog .........................................................................

5-21

 

5-8

Preferences – SANsurfer Performance Viewer............................................................

5-22

 

5-9

Default Graph Options Dialog ......................................................................................

5-24

 

Table

 

Tables

Page

 

 

2-1

Topology Display Menu Shortcut Keys ........................................................................

2-20

 

2-2

Faceplate Display Menu Shortcut Keys .......................................................................

2-21

 

2-3

Tool Bar Buttons ..........................................................................................................

2-23

 

3-1

Topology Display Switch and Status Icons ..................................................................

3-10

 

3-2

Severity Levels.............................................................................................................

3-12

 

3-3

Devices Data Window Entries......................................................................................

3-15

 

3-4

Edit Zoning Dialog Tool Bar Buttons and Icons ...........................................................

3-27

 

4-1

Factory User Accounts...................................................................................................

4-2

 

4-2

Switch Data Window Entries ..........................................................................................

4-9

 

4-3

Switch Resets ..............................................................................................................

4-17

 

4-4

Switch Administrative States........................................................................................

4-20

 

4-5

Timeout Values ............................................................................................................

4-24

 

4-6

IP Configuration Parameters........................................................................................

4-26

4-7

SNMP Configuration Parameters.................................................................................

4-29

 

4-8

SNMP Trap Configuration Parameters ........................................................................

4-30

 

4-9

Factory Default Configuration Settings ........................................................................

4-33

 

5-1

Port Types......................................................................................................................

5-2

 

5-2

Port Operational States..................................................................................................

5-3

5-3

Port Speeds ...................................................................................................................

5-3

 

5-4

Transceiver Media View.................................................................................................

5-4

5-5

Port Statistics Data Window Entries...............................................................................

5-5

 

5-6

Port Information Data Window Entries ...........................................................................

5-7

5-7

Port Administrative States............................................................................................

5-11

 

5-8

Port Speeds .................................................................................................................

5-12

 

5-9

Port Types....................................................................................................................

5-13

 

A-1

Command-Line Completion ...........................................................................................

A-6

A-2

Commands Listed by Authority Level.............................................................................

A-7

A-3

Switch Configuration Defaults ......................................................................................

A-31

A-4

Port Configuration Defaults ..........................................................................................

A-32

A-5

Port Threshold Alarm Configuration Defaults...............................................................

A-33

A-6

Zoning Configuration Defaults......................................................................................

A-33

Page x

59022-10 A

0

SANbox2-8c/16 Switch Management

 

User’s Guide

 

 

 

 

A-7

SNMP Configuration Defaults ......................................................................................

 

A-34

A-8

System Configuration Defaults.....................................................................................

 

A-35

A-9

Set Config Port Parameters .........................................................................................

 

A-38

A-10

Set Config Switch Parameters .....................................................................................

 

A-41

A-11

Set Config Threshold Parameters................................................................................

 

A-43

A-12

Set Config Zoning Parameters.....................................................................................

 

A-44

A-13

SNMP Configuration Settings ......................................................................................

 

A-53

A-14

System Configuration Settings.....................................................................................

 

A-54

A-15

Show Port Parameters .................................................................................................

 

A-60

A-16

Switch Operational Parameters ...................................................................................

 

A-63

A-17

Zoning Database Limits ...............................................................................................

 

A-99

59022-10 A

Page xi

SANbox2-8c/16 Switch Management

0

User’s Guide

Notes

Page xii

59022-10 A

Section 1

Introduction

This manual describes the switch management tools which include the SANsurfer Switch Manager™ application (version 4.02) and the Command Line Interface (CLI) for the (firmware version 4.2). The SANsurfer Switch Manager switch management application is the primary focus of this manual which is organized as follows:

Section 1 describes the intended audience for this manual, related materials, and technical support.

Section 2 describes how to use SANsurfer Switch Manager, its menus, and its displays.

Section 3 describes fabric management tasks.

Section 4 describes switch management tasks.

Section 5 describes port and device management tasks.

Appendix A describes the command line interface.

A glossary of terms and an index are also provided.

1.1

Intended Audience

This manual introduces the switch management products and explains their installation and use. It is intended for users responsible for installing and using switch management tools.

1.2

Related Materials

Refer to the following manuals for information about switch hardware and installation.

SANbox2-8c Fibre Channel Switch Installation Guide, publication number 59042-07 Rev. A.

SANbox2-16 Fibre Channel Switch Installation Guide, publication number 59021-10 Rev. A.

59022-10 A

1-1

1 – Introduction

0

JDOM License

1.3

JDOM License

This product includes software developed by the JDOM Project (http://www.jdom.org/). Copyright (C) 2000-2002 Brett McLaughlin & Jason Hunter. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1.Redistributions of source code must retain the above copyright notice, this list of conditions, and the following disclaimer.

2.Redistributions in binary form must reproduce the above copyright notice, this list of conditions, and the disclaimer that follows these conditions in the documentation and/or other materials provided with the distribution.

3.The name "JDOM" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact license@jdom.org.

4.Products derived from this software may not be called "JDOM", nor may "JDOM" appear in their name, without prior written permission from the JDOM Project Management (pm@jdom.org).

In addition, we request (but do not require) that you include in the end-user documentation provided with the redistribution and/or in the software itself an acknowledgement equivalent to the following: "This product includes software developed by the JDOM Project (http://www.jdom.org/)."

Alternatively, the acknowledgment may be graphical using the logos available at http://www.jdom.org/images/logos.

THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

This software consists of voluntary contributions made by many individuals on behalf of the JDOM Project and was originally created by Brett McLaughlin <brett@jdom.org> and Jason Hunter <jhunter@jdom.org>. For more information on the JDOM Project, please see <http://www.jdom.org/>.

1-2

59022-10 A

0

1 – Introduction

Technical Support

 

 

1.4

Technical Support

Customers should contact their authorized maintenance provider for technical support of their QLogic switch products. QLogic-direct customers may contact QLogic Technical Support; others will be redirected to their authorized maintenance provider.

Visit the QLogic support Web site listed in Contact Information for the latest firmware and software updates.

1.4.1

Availability

QLogic Technical Support is available from 7:00 AM to 7:00 PM Central Standard Time, Monday through Friday, excluding QLogic-observed holidays.

1.4.2

Training

QLogic offers certification training for the technical professional for both the SANblade™ HBAs and the SANbox2™ switches. From the training link at www.qlogic.com, you may choose Electronic-Based Training or schedule an intensive "hands-on" Certification course.

Technical Certification courses include installation, maintenance and troubleshooting QLogic SAN products. Upon demonstrating knowledge using live equipment, QLogic awards a certificate identifying the student as a Certified Professional. The training professionals at QLogic may be reached by email at tech.training@qlogic.com

1.4.3

Contact Information

Telephone:

+1 952-932-4040

Fax:

+1 952-932-4018

Email:

 

Technical Service

support@qlogic.com

Technical Training

tech.training@qlogic.com

QLogic Web Site:

www.qlogic.com

Technical Support Web Site:

support.qlogic.com

59022-10 A

1-3

1 – Introduction

0

Technical Support

Notes

1-4

59022-10 A

Section 2

Using SANsurfer Switch Manager

This section describes how to use the SANsurfer Switch Manager application and its menus. The following topics are covered:

Installing the Management Application

Starting SANsurfer Switch Manager

Exiting SANsurfer Management Suite

Uninstalling SANsurfer Switch Manager

Changing the Encryption Key for the Default Fabric View File

Saving and Opening Fabric View Files

Setting SANsurfer Switch Manager Preferences

Using Online Help

Viewing Software Version and Copyright Information

SANsurfer Switch Manager User Interface

Using the Topology Display

Using the Faceplate Display

2.1

Installing the Management Application

You can manage the switch using SANsurfer Switch Manager as a standalone application or as a part of SANsurfer Management Suite™. SANsurfer Management Suite is QLogic’s integrated fabric management application, managing both HBAs and switches.

If your switch was shipped with a SANsurfer Switch Manager Disk, refer to ”SANsurfer Switch Manager” on page 2-2 for instructions on how to install SANsurfer Switch Manager.

If your switch was shipped with a SANsurfer Management Suite Disk, refer to ”SANsurfer Management Suite” on page 2-3 for instructions on how to install and upgrade SANsurfer Management Suite.

Refer to the SANbox2-8c/16 Switch Management User’s Guide for more information about using, exiting, and uninstalling SANsurfer Management Suite and SANsurfer Switch Manager.

59022-10 A

2-1

2 – Using SANsurfer Switch Manager

0

Installing the Management Application

2.1.1

SANsurfer Switch Manager

You can install SANsurfer Switch Manager on a Windows, Linux, or Solaris workstation. To install SANsurfer Switch Manager from the SANsurfer Switch Manager disk, close all programs currently running, and insert the SANsurfer Switch Manager Installation Disk into the management workstation CD-ROM drive.

For a Windows workstation:

1.Using Windows Explorer, double-click the drive letter which contains the SANsurfer Switch Manager Installation Disk.

2.Double click the Switch_Manager folder, then double click the Windows folder.

3.Double click the executable file and follow the SANsurfer Switch Manager installation instructions.

For a Linux workstation:

1.If a file browser does not open, double-click the CD-ROM icon to open the browser. Double click the Switch_Manager folder, then double click the Linux folder. If there is no CD-ROM icon, do the following:

a.Open an xterm or other terminal window.

b.Mount the CD-ROM. From a shell prompt, enter the following command:

mount /mnt/cdrom

c.Change directory to location of the install program: cd /mnt/cdrom/Switch_Manager/Linux

2.Enter the following command to make the install file executable:

chmod +x Linux_4.02.xx_xxxx.bin

3.Execute the install program and follow the installation instructions:

./Linux_4.02.xx_xxxx.bin

For a Solaris workstation:

1.Open a terminal window. If the disk isn’t already mounted, enter the following command:

volcheck

2.Move to the directory on the disk that contains the executable. Enter the following command:

cd /cdrom/cdrom0/Switch_Manager/solaris

2-2

59022-10 A

0

2 – Using SANsurfer Switch Manager

Installing the Management Application

 

 

 

3.Add the package and follow the SANsurfer Switch Manager installation instructions. Enter the following command:

pkgadd -d sol_pkg

2.1.2

SANsurfer Management Suite

The following instructions describe how to install SANsurfer Management Suite and upgrade SANsurfer Switch Manager. You can install SANsurfer Management Suite (SMS) on a Windows, Linux, or Solaris workstation. Choose the instructions for your workstation:

SMS Installation for Windows

SMS Installation for Linux

SMS Installation for Solaris

2.1.2.1

SMS Installation for Windows

Close all programs currently running, and insert the SANsurfer Management Suite Installation Disk into the management workstation CD-ROM drive.

1.If the SANsurfer Management Suite 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 Management Suite Disk.

b.Locate and double-click the Start_Here.htm file to open the SANsurfer Management Suite start page in your default browser.

2.On the SANsurfer Management Suite start page, click the SANbox Switch Software button.

3.On the SANbox Switch Software page, scroll to the SANbox2-8c/16 Series area.

4.In the Operating System column, click the Win NT/2000 link.

5.Click the SANsurfer Management Software link to open the File Download dialog.

6.You can run the installation file from the CD-ROM or download the installation file to your hard drive. Choose one of the following:

Open the installation file from the CD-ROM and follow the SANsurfer Switch Manager installation instructions.

Specify a location in which to save the sansurfer_windows_install.exe file, and click the Save button. Double-click the saved sansurfer_windows_install.exe file and follow the installation instructions.

59022-10 A

2-3

2 – Using SANsurfer Switch Manager

0

Installing the Management Application

7.When the installation is complete, start SANsurfer Management Suite using the SANsurfer file from the SANsurfer Management Suite installation directory. You can also start SANsurfer Management Suite by clicking the SANsurfer icon (if installed) on the desktop or from the Start menu. In SMS, Click the Switch tab in the left pane. From the Help menu, select About ...

and make note of the version number. Close SANsurfer Management Suite.

8.To ensure you are using the most recent version of SANsurfer Switch Manager, visit the QLogic support web page and go to Drivers, Software and Manuals.

a.Select your switch model from the pull-down menu. Locate the description for SANsurfer Switch Manager for Windows under "Management Software".

b.If the release version number (4.02.xx) is greater than what is currently installed, download the new version and proceed to step 9. Otherwise, no upgrade is needed and the SMS installation is complete.

9.To start the installer, open the zip file and run the

SANsurferSwitchMgr_Windows_4.02.xx.exe file.

10.When prompted for an installation directory, click the Choose button and select the same folder as the SANsurfer Management Suite installation in step 6. The default SMS installation directory is C:\Program Files\QLogic Corporation\SANsurfer. Click the Next button.

11.When prompted for the location in which to create the program icons, click the In an Existing Group radio button, then specify the same group that was used for the SMS installation. The default SMS group is "QLogic Management Suite". Click the Next button.

12.Click the Install button to the start the installation. When the installation is complete, click the Done button.

13.In the SMS install directory, enter the following command to execute the chglax.bat file. If prompted to overwrite an existing file, enter Y to do so.

chglax.bat

14.Restart SANsurfer Switch Manager from SANsurfer Management suite as you did in step 7 and confirm that the new version is running.

2-4

59022-10 A

0

2 – Using SANsurfer Switch Manager

Installing the Management Application

 

 

 

2.1.2.2

SMS Installation for Linux

Close all programs currently running, and insert the SANsurfer Management Suite Installation Disk into the management workstation CD-ROM drive.

1.If a file browser dialog opens showing icons for the contents of the CD-ROM, double-click the Start_Here.htm file to open the SANsurfer Management Suite start page. If a file browser does not open, double-click the CD-ROM icon to open the browser. If there is no CD-ROM icon, do the following:

a.Open an xterm or other terminal window.

b.Mount the CD-ROM. From a shell prompt, enter the following command:

mount /mnt/cdrom

c.Execute your web browser to view the Start_Here.htm document using one of the following commands:

mozilla file:/mnt/cdrom/Start_Here.htm or

netscape file:/mnt/cdrom/Start_Here.htm

d.The SANsurfer Management Suite start page opens in your browser.

2.On the SANsurfer Management Suite start page, click the SANbox Switch Software button.

3.On the SANbox Switch Software page, scroll to the SANbox2-8c/16 Series area.

4.In the Operating System column, click the Linux link.

5.Click the SANsurfer Management Software link to open the File Download dialog.

6.Enter a path name to save the sansurfer_linux_install.bin file, and click the Save button.

7.Open a terminal window for the directory in which the sansurfer_linux_install.bin file was saved, and make the file executable.

chmod +x sansurfer_linux_install.bin

8. Execute the install program and follow the installation instructions

./sansurfer_linux_install.bin

9.When the installation is complete, start SANsurfer Management Suite using the SANsurfer file in the installation directory. Click the Switch tab from the left pane to open SANsurfer Switch Manager. From the Help menu, select About ... and make note of the release version number. Close SANsurfer Management Suite.

59022-10 A

2-5

2 – Using SANsurfer Switch Manager

0

Installing the Management Application

10.To ensure that you are using the most recent version of SANsurfer Switch Manager, visit the QLogic support web page and go to Drivers, Software and Manuals.

a.Select your switch model from the pull-down menu. Locate the description for SANsurfer Switch Manager for Linux under "Management Software".

b.If the release version number (4.02.xx) is greater than what is currently installed on your workstation, down load the new version and proceed to step 11. Otherwise, no upgrade is needed and the SMS installation is complete.

11.From the tar.gz file, extract the SANsurferSwitchMgr_Linux_4.02.xx.bin file and make the file executable.

chmod +x sansurferswitchmgr_linux_4.02.xx.bin

12. Execute the install program and follow the installation instructions.

./sansurferswitchmgr_linux_4.02.xx.bin

13.When prompted for an installation directory, click the Choose button and select the same folder as the SANsurfer Management Suite installation in step 9. The default SMS installation directory is /opt/QLogic_Corporation/SANsurfer.

14.Enter the following script command from the installation directory:

./chglax

15.Start SANsurfer Switch Manager from SANsurfer Management suite as you did in step 9 and confirm that the new version is running.

2.1.2.3

SMS Installation for Solaris

To install the SANsurfer Switch Manager application on Solaris from the SANsurfer Management Suite CD-ROM, do the following:

1.Insert the SANsurfer Management Suite Disk into the management workstation CD-ROM drive. If the SANsurfer Management Suite start page does not open in your default browser, do the following:

a.Right-click the Workspace Menu.

b.Select File, then select File Manager.

c.In File Manager, double-click the CD-ROM folder, and then double-click the Sansurfer folder.

d.In the Sansurfer folder, double-click the Start_Here.htm file to open the SANsurfer Management Suite start page in your default browser.

2.On the SANsurfer Management Suite start page, click the SANbox Switch Software button.

2-6

59022-10 A

0

2 – Using SANsurfer Switch Manager

Installing the Management Application

 

 

 

3.On the SANbox Switch Software page, scroll to the SANbox2-8c/16 Series area.

4.In the Operating System column, click the Solaris SPARC link.

5.Click the SANsurfer Management Software link to open the Save As dialog.

6.Enter a path name to save the sansurfer_solaris_install.bin file and click the Save button.

7.Open a terminal window for the directory in which the sansurfer_solaris_install.bin file was saved, and enter the following:

chmod +x sansurfer_solaris_install.bin

8. Execute the install program and follow the installation instructions:

./sansurfer_solaris_install.bin

9.When the installation is complete, start SANsurfer Management Suite using the SANsurfer file in the installation directory. Click the Switch tab from the left pane to open SANsurfer Switch Manager. From the Help menu, select About ... and make note of the release version number. Close SANsurfer Management Suite.

10.To ensure that you are using the most recent version of SANsurfer Switch Manager, visit the QLogic support web page and go to Drivers, Software and Manuals.

a.Select your switch model from the pull-down menu. Locate the description for SANsurfer Switch Manager for Linux under "Management Software".

b.If the release version number (4.02.xx) is greater than what is currently installed on your workstation, down load the new version. Otherwise, no upgrade is needed.

11.Open the tar file and save the

SANsurferSwitchMgr_QLGCsol_4.02.xx.bin file in a folder and make the file executable.

#chmod +x sansurferswitchmgr_QLGCsol_4.02.xx

12.Install the new SANsurfer Switch Manager package:

#pkgadd -d sansurferswitchmgr_QLGCsol_4.02.xx

13.Change directories to the package location:

#cd /usr/opt/QLGCsol/bin

14.Locate and execute the file sbm_over_sms.sh:

#./sbm_over_sms.sh

59022-10 A

2-7

2 – Using SANsurfer Switch Manager

0

Starting SANsurfer Switch Manager

15.When prompted for the SMS installation directory, enter d if SMS was installed in it’s default directory (/opt/QLogic_Corporation/SANsurfer). Otherwise, enter the path name for the SMS installation directory. The script will copy the necessary files to the specified installation directory.

16.Restart SANsurfer Switch Manager from SANsurfer Management suite as you did in step 9 and confirm that the new version is running.

2.2

Starting SANsurfer Switch Manager

You can start SANsurfer Switch Manager as a standalone application or from SANsurfer Management Suite.

Note: After the switch is operational, you can also open the SANsurfer Switch Manager web applet, by entering the switch IP address in an internet browser. If your workstation does not have the Java 2 Run Time Environment program, you will be prompted to download it.

To start SANsurfer Switch Manager as a standalone application, do the following.

1.Start the SANsurfer Switch Manager using one of the following methods:

For Windows, double-click the SANsurfer Switch Manager shortcut, or select SANsurfer Switch Manager from Start menu, depending on how you installed the SANsurfer Switch Manager application. From a command line, you can enter the SANsurfer_Switch_Manager command:

<install_directory>SANsurfer_Switch_Manager.exe

For Linux or Solaris, enter the SANsurfer_Switch_Manager command:

<install_directory>./SANsurfer_Switch_Manager

2.In the Initial Start dialog, click the Open Configuration Wizard button. When you power up the switch, the Configuration Wizard will recognize the switch and lead you through the configuration process.

2-8

59022-10 A

0

2 – Using SANsurfer Switch Manager

Starting SANsurfer Switch Manager

 

 

 

To start SANsurfer Switch Manager from SANsurfer Management Suite, do the following.

1.Start the SANsurfer Management Suite application using one of the following methods:

For Windows, double-click the SANsurfer shortcut, or select SANsurfer from Start menu, depending on how you installed the SANsurfer application. From a command line, enter the following command:

<install_directory>\SANsurfer.exe

For Linux or Solaris enter the SANsurfer command:

<install_directory>./SANsurfer

2.From the SANsurfer Management Suite home page, click the SANsurfer Switch Manager button.

3.In the Initial Start dialog, click the Open Configuration Wizard button. When you power up the switch, the Configuration Wizard will recognize the switch and lead you through the configuration process.

The application opens with the Initial Start dialog shown in Figure 2-1. If you prefer not to see this dialog, check the Don’t show this dialog again check box. This has the same effect as disabling the Display Initial Startup Dialog preference. Refer to ”Setting SANsurfer Switch Manager Preferences” on page 2-14 for information about setting preferences.

Figure 2-1. Initial Startup Dialog

Click the Open Existing Fabric radio button to open the Add a New Fabric dialog, which prompts you for a fabric name, IP address, account name, and password. Refer to ”Adding a Fabric” on page 3-5.

59022-10 A

2-9

2 – Using SANsurfer Switch Manager

0

Starting SANsurfer Switch Manager

Click the Open Existing Fabric View File radio button to open the Open View dialog which prompts you to specify a fabric view file that you saved earlier. Refer to ”Opening a Fabric View File” on page 3-6.

Click the Start Application Without Specifying a Fabric radio button to open the SANsurfer Switch Manager window shown in Figure 2-2.

Click the Open Configuration Wizard radio button to open the Configuration Wizard to configure a switch, add a new switch, replace/restore a switch, or recover or edit an IP configuration of an existing switch.

Figure 2-2. SANsurfer Switch Manager Window

2-10

59022-10 A

0

2 – Using SANsurfer Switch Manager

Exiting SANsurfer Management Suite

 

 

 

2.3

Exiting SANsurfer Management Suite

To exit a SANsurfer Switch Manager application session, open the File menu and select Exit. If you have not yet defined an encryption key, the Save Default Fabric View File dialog, shown in Figure 2-3, prompts you to save the current fabric view as the default fabric view file. Enter an encryption key in the Default Fabric File Encryption Key field. Re-enter the encryption key in the Re-enter Encryption Key to Confirm field. Click the OK button to save the current set of fabrics to the default fabric view file in the working directory.

Figure 2-3. Save Default Fabric View File Dialog

The encryption key is used to encrypt the sensitive data in the default fabric view file. Refer to ”Changing the Encryption Key for the Default Fabric View File” on page 2-14 for information about changing this encryption key. If an encryption key has been defined and the View File Auto Save and Load preferences settings are set to Enable, the current fabric view is automatically saved to your default fabric view file upon exit future SANsurfer Switch Manager sessions.

To prevent SANsurfer Switch Manager from prompting you to save the default fabric view file between SANsurfer Switch Manager sessions, set the View File Auto Save and Load preferences setting to Enable (default). Refer to ”Setting SANsurfer Switch Manager Preferences” on page 2-14 for more information.

59022-10 A

2-11

2 – Using SANsurfer Switch Manager

0

Uninstalling SANsurfer Switch Manager

In your next SANsurfer Switch Manager session, the Load Default Fabric File dialog shown in Figure 2-4 prompts you to load the default fabric view file and to specify its encryption key, if there is one. In the Default Fabric File Encryption Key field, enter the encryption key and click the Load View File button. If you do not want to load the default fabric view file, click the Continue Without Loading button to open the SANsurfer Switch Manager with no fabric displayed.

Figure 2-4. Load Default Fabric File Dialog

2.4

Uninstalling SANsurfer Switch Manager

The method you use to uninstall SANsurfer Switch Manager depends on how you installed it:

If you installed SANsurfer Switch Manager as part of SANsurfer Management Suite, you must uninstall SANsurfer Management Suite. Refer to ”SMS Uninstall” on page 2-12.

If you installed SANsurfer Switch Manager as a standalone program, you must uninstall SANsurfer Switch Manager directly. Refer to ”Standalone Uninstall” on page 2-13.

2.4.1

SMS Uninstall

A program to uninstall SANsurfer Management Suite was included as part of the SANsurfer Management Suite installation process. Use this method only if you installed SANsurfer Switch Manager as part of SANsurfer Management Suite. The UninstallData folder in the installation directory contains the uninstall program, SANsurferUninstaller.

The default installation directories are:

For Windows: C:\Program Files\QLogic_Corporation\SANsurfer

For Linux: /opt/QLogic_Corporation/SANsurfer

For Solaris: /opt/QLogic_Corporation/SANsurfer

2-12

59022-10 A

0

2 – Using SANsurfer Switch Manager

Uninstalling SANsurfer Switch Manager

 

 

 

To uninstall the SANsurfer Management Suite application, do the following:

For Windows, browse for the uninstall program file or the shortcut/link that points to the uninstall program file. The uninstall program shortcut is in the same folder as the program shortcut (Start menu, program group, on desktop, or user specified) that is used to start the SANsurfer Management Suite application. Double-click the uninstall program file or shortcut/link, and follow the instructions.

For Linux, execute the link to SANsurferUninstaller.

<install_directory>/UninstallerData/SANsurferUninstaller

For Solaris, enter the following command and follow the instructions:

<install_directory>/UninstallData/SANsurferUninstaller

2.4.2

Standalone Uninstall

A program to uninstall SANsurfer Switch Manager was included as part of the SANsurfer Switch Manager installation process. Use this method only if you installed SANsurfer Switch Manager as a standalone program. The UninstallerData folder in the Install directory contains the uninstall program, Uninstall Switch_Manager. Also, a shortcut/link to the uninstall program was installed in the installation directory during the SANsurfer Switch Manager installation process.

The default installation directories are:

For Windows: C:\Program Files\QLogic_Corporation\Switch_Manager

For Linux: /opt/QLogic_Corporation/Switch_Manager

For Solaris: /usr/opt/QLGCsol

To uninstall the SANsurfer Switch Manager application, do the following:

For Windows, browse for the uninstall program file or the shortcut/link that points to the uninstall program file. The uninstall program shortcut is in the same folder as the program shortcut (Start menu, program group, on desktop, or user specified) that is used to start the SANsurfer Switch Manager application. Double-click the uninstall program file or shortcut/link, and follow the instructions to uninstall the SANsurfer Switch Manager application.

For Linux, execute the link to Uninstall_Switch_Manager. If no links were created during the installation, enter the following command:

<install_directory>UninstallerData/Uninstall_Switch_Manager

For Solaris, enter the following command and follow the instructions to uninstall the SANsurfer Switch Manager application:

pkgrm QLGCsol

59022-10 A

2-13

2 – Using SANsurfer Switch Manager

0

Changing the Encryption Key for the Default Fabric View File

2.5

Changing the Encryption Key for the Default Fabric View File

To change the encryption key for the SANsurfer Switch Manager default fabric view file, do the following:

1.Open the File menu and select Save Default Fabric View File to open the Save Default Fabric View File dialog. Enter an encryption key in the Default Fabric File Encryption Key field.

2.Re-enter the same encryption key in the Re-enter Encryption Key to Confirm field.

3.Click the OK button to save the current set of fabrics to the default fabric view file in the working directory.

2.6

Saving and Opening Fabric View Files

A fabric view file is one or more fabrics saved to a file. In addition to the SANsurfer Switch Manager default fabric view file, you can save and open your own fabric view files. To save a set of fabrics to a file, do the following:

1.Open the File menu and select Save View As to open the Save View dialog.

2.Enter a name for the fabric view file or click the Browse button to select an existing file. Files are saved in the working directory.

3.Enter a password. When you attempt to open this fabric view file, you will be prompted for this password. If you leave the File Password field blank, no password will be required when attempting to open this fabric view file.

4.Click the OK button to save the view.

To open a fabric view file, do the following:

1.Open the File menu and select Open View File to open the Open View dialog.

2.Enter a name for the fabric view file or click the Browse button to select an existing file.

3.If the fabric view file was saved with a password, enter the password and click the OK button.

4.Click the OK button to open the view.

2.7

Setting SANsurfer Switch Manager Preferences

Using the preferences settings, you can:

Change the location of the working directory in which to save files.

Change the location of the browser used to view the online help.

2-14

59022-10 A

0

2 – Using SANsurfer Switch Manager

Setting SANsurfer Switch Manager Preferences

 

 

 

Enable (default) or disable the view file auto save and load feature. Refer to ”Exiting SANsurfer Management Suite” on page 2-11 for more information on the default fabric view file.

Enable (default) or disable the use of the Initial Start Dialog at the beginning of a SANsurfer Switch Manager session. Refer to ”Starting SANsurfer Switch Manager” on page 2-8 for information about the Initial Start Dialog. After a default fabric view file is created, this setting has no effect.

Enable (default) or disable the Event Browser. Refer to ”Displaying the Event Browser” on page 3-11. If the Event Browser is enabled using the Preferences dialog shown in Figure 2-5, the next time SANsurfer Switch Manager is started, all events will be displayed. If the Event Browser is disabled when SANsurfer Switch Manager is started and later enabled, only those events from the time the Event Browser was enabled and forward will be displayed.

Choose the default port view when opening the faceplate display. You can set the faceplate to reflect the current port type (default), port speed, port operational state, or port transceiver media. Regardless of the default port view you choose, you can change the port view in the faceplate display by opening the View menu and selecting a different port view option. Refer to the corresponding subsection for more information:

”Displaying Port Types” on page 5-2

”Displaying Port Operational States” on page 5-3

”Displaying Port Speeds” on page 5-3

”Displaying Transceiver Media Status” on page 5-4

Figure 2-5. Preferences Dialog – SANsurfer Switch Manager

59022-10 A

2-15

2 – Using SANsurfer Switch Manager

0

Using Online Help

To set preferences for your SANsurfer Switch Manager sessions, do the following:

1.Open the File menu, and select Preferences to open the Preferences dialog.

2.Enter or browse for paths to the working directory and browser.

3.In the Application-wide Options area, choose the preferences you want.

4.Click the OK button to save the changes.

2.8

Using Online Help

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

2.9

Viewing Software Version and Copyright Information

To view SANsurfer Switch Manager software version and copyright information, open the Help menu and select About....

2-16

59022-10 A

0

2 – Using SANsurfer Switch Manager

SANsurfer Switch Manager User Interface

 

 

 

2.10

SANsurfer Switch Manager User Interface

The SANsurfer Switch Manager application uses two basic displays to manage the fabric and individual switches: the topology display and the faceplate display. The topology display shows all switches that are able to communicate and all connections between switches. The faceplate display shows the front of a single switch and its ports. Both displays share some common elements as shown in Figure 2-6.

Menu

Tool Bar

Bar

 

Topology

Display

Graphic

Fabric Window

Tree

Data

Window

 

 

Working Status

Data Window

Indicator

Tabs

 

Faceplate

Display

Figure 2-6. SANsurfer Switch Manager Display Elements

59022-10 A

2-17

2 – Using SANsurfer Switch Manager

0

SANsurfer Switch Manager User Interface

2.10.1

Menu Bar

The SANsurfer Switch Manager menus and the tasks offered in them vary depending on the display. For example, the Port menu and many of the Switch menu selections are only available in the faceplate display.

2.10.1.1

Topology Display Menu

The menu options in the topology display are shown in Figure 2-7.

Figure 2-7. Topology Display Menu

2-18

59022-10 A

0

2 – Using SANsurfer Switch Manager

SANsurfer Switch Manager User Interface

 

 

 

2.10.1.2

Faceplate Display Menu

The menu options in the faceplate display are shown in Figure 2-8.

Figure 2-8. Faceplate Display Menu

The keyboard shortcut keys vary by display type: topology display and faceplate display. In addition to the menu bar, both the topology and faceplate displays have context sensitive menus that pop up when you right-click on the switches and links in the topology display, and on the switch image in the faceplate display. Refer to ”Opening the Faceplate Display and Topology Popup Menus” on page 2-28 for more information about these popup menus.

59022-10 A

2-19

2 – Using SANsurfer Switch Manager

0

SANsurfer Switch Manager User Interface

2.10.1.3

Topology Display Shortcut Keys

The shortcut keys for the topology display are below. The shortcut key combinations are not case-sensitive.

Table 2-1. Topology Display Menu Shortcut Keys

Shortcut

Selection

 

Shortcut

Selection

 

 

 

 

 

Ctrl+O

File>Open View File

 

Alt+S, D

Switch>Delete

Alt+F, O

 

 

 

 

 

 

 

 

 

Alt+F, A

File>Save View As

 

Alt+S, E

Switch>Export Devices

 

 

 

 

Information

 

 

 

 

 

Alt+F, D

File>Save Default Fabric

 

Alt+S, P

Switch>Switch Properties

 

View File

 

 

(active only when one switch is

 

 

 

 

selected)

 

 

 

 

 

Alt+F, R

File>Preferences

 

Alt+S, N

Switch>Network Properties

 

 

 

 

(active only when one switch is

 

 

 

 

selected)

 

 

 

 

 

Alt+F, N

File>Nicknames

 

Alt+S, S

Switch>SNMP Properties

 

 

 

 

(active only when one switch is

 

 

 

 

selected)

 

 

 

 

 

Alt+F, X

File>Exit

 

Alt+W, C

Wizards> Configuration Wizard

 

 

 

 

 

Alt+B, A

Fabric>Add Fabric

 

Alt+V, R

View>Refresh

 

 

 

F5

 

 

 

 

 

 

Alt+B, R

Fabric>Remove Fabric

 

Alt+V, L

View>Layout Topology

 

 

 

 

 

Alt+B, F

Fabric>Fabric Tracker

 

Alt+V, A

View>Toggle Auto Layout

+S

Save Snapshot

 

 

 

+A

Analyze Snapshot

 

 

 

 

 

 

 

 

Alt+B, D

Fabric>Rediscover Fabric

 

Alt+V, M

View>Remember Layout

 

 

 

 

 

Alt+B, T

Fabric>Start Performance

 

Alt+H, H

Help>Help Topics

 

Viewer

 

 

 

 

 

 

 

 

Alt+B, E

Fabric>Show Event Browser

 

Alt+H, A

Help>About

 

 

 

 

 

2-20

59022-10 A

0

2 – Using SANsurfer Switch Manager

SANsurfer Switch Manager User Interface

 

 

 

2.10.1.4

Faceplate Display Shortcut Keys

The shortcut keys for the faceplate displays are shown in below. The shortcut key combinations are not case-sensitive.

Table 2-2. Faceplate Display Menu Shortcut Keys

Shortcut

Selection

 

Shortcut

Selection

 

 

 

 

 

Ctrl+O

File>Open View File

 

Alt+S, W

Switch>Download Support File

Alt+F, O

 

 

 

 

 

 

 

 

 

Alt+F, A

File>Save View As

 

Alt+S, Y

Switch>Restore Factory Defaults

 

 

 

 

 

Alt+F, D

File>Save Default Fabric

 

Alt+P, R

Port>Port Properties

 

View File

 

 

 

 

 

 

 

 

Alt+F, R

File>Preferences

 

Alt+P, N

Port>Port Symbolic Name

 

 

 

 

 

Alt+F, N

File>Nicknames

 

Alt+P, T

Port>Reset Port

 

 

 

 

 

Alt+F, X

File>Exit

 

Alt+P, L

Port>Port Loopback Test

 

 

 

 

 

Alt+B, A

Fabric>Add Fabric

 

Alt+Z, E

Zoning>Edit Zoning

 

 

 

 

 

Alt+B, R

Fabric>Remove Fabric

 

Alt+Z, C

Zoning>Edit Zoning Config

 

 

 

 

 

Alt+B, F

Fabric>FabricTracker

 

Alt+Z, A

Zoning>Activate Zone Set

+S

Save Snapshot

 

 

 

+A

Analyze Snapshot

 

 

 

 

 

 

 

 

Alt+B, E

Fabric>Show Event Browser

 

Alt+Z, D

Zoning>Deactivate Zone Set

 

 

 

 

 

Alt+S, A

Switch>Archive

 

Alt+Z, R

Zoning>Restore Default Zoning

 

 

 

 

 

Alt+S, R

Switch>Restore

 

Alt+W, C

Wizards> Configuration Wizard

 

 

 

 

 

Alt+S, U

Switch>User Accounts

 

Alt+W, E

Wizards> Ext Credit Wizard

 

 

 

 

 

Alt+S, D

Switch>Set Date/Time

 

Alt+W, Z

Wizards>Zoning Wizard

 

 

 

 

 

Alt+S, P

Switch>Switch Properties

 

Alt+V, R

View>Refresh

 

 

 

F5

 

 

 

 

 

 

Alt+S, N

Switch>Network Properties

 

Alt+V, T

View>View Port Types

 

 

 

 

 

Alt+S, S

Switch>SNMP Properties

 

Alt+V, S

View>View Port States

 

 

 

 

 

Alt+S, G

Switch>Toggle Beacon

 

Alt+V, E

View>View Port Speeds

 

 

 

 

 

Alt+S, C

Switch>Port Threshold

 

Alt+V, M

View>View Port Media

 

Alarm Configuration

 

 

 

 

 

 

 

 

59022-10 A

2-21

2 – Using SANsurfer Switch Manager

 

 

0

SANsurfer Switch Manager User Interface

 

 

 

 

 

 

 

 

 

 

 

Table 2-2. Faceplate Display Menu Shortcut Keys (Continued)

 

 

 

 

 

 

 

 

Shortcut

 

Selection

 

Shortcut

Selection

 

 

 

 

 

 

 

Alt+S, L

Switch>Load Firmware

 

Alt+H, H

Help>Help Topics

 

 

 

 

 

 

 

Alt+S, E

Switch>Reset Switch

 

Alt+H, A

Help>About

 

+R

Reset

 

 

 

 

 

+H

Hot reset

 

 

 

 

 

+A

Hard Reset

 

 

 

 

 

 

 

 

 

 

 

 

2-22

59022-10 A

0

2 – Using SANsurfer Switch Manager

SANsurfer Switch Manager User Interface

 

 

 

2.10.2

Tool Bar

The tool bar consists of a row of graphical buttons that you can use to access SANsurfer Switch Manager functions as shown in Table 2-3. The tool bar buttons are an alternative method to using the menu bar. The tool bar can be relocated in the display by clicking and dragging the handle at the left edge of the tool bar.

 

Table 2-3. Tool Bar Buttons

 

 

Tool Bar Button

Description

 

 

 

Add Fabric button - adds a new fabric to the fabric view.

 

Open View File button - opens an existing fabric view file.

 

Save View As button - saves the current fabric view to a file.

 

Refresh button - updates the topology or faceplate display with

 

current information.

 

Event Browser button - opens the events browser.

 

Help Topics button - opens the online help file.

 

Edit Zoning button - opens the Edit Zoning dialog (available only in

 

faceplate display).

 

The QLogic logo opens a link to the QLogic web site.

 

 

59022-10 A

2-23

2 – Using SANsurfer Switch Manager

0

SANsurfer Switch Manager User Interface

2.10.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 or collapsed. Click this handle or double-click the entry to expand or collapse a fabric tree entry. A fabric entry expands to show its member switches.

Fabric

Entry

Entry Handle

 

Moveable

 

 

 

Window Border

Switch

Entries

Figure 2-9. Fabric Tree

Each fabric tree entry has a small icon next to it that uses color to indicate operational status.

A green icon indicates normal operation.

A yellow icon indicates that a switch is operational, but may require attention to maintain maximum performance.

A red icon indicates a potential failure or non-operational state (if switch is offline).

A blue icon indicates that a switch is unknown, unreachable, or unmanageable.

If the status of the fabric is not normal, the fabric icon in the fabric tree will indicate the reason for the abnormal status. The same message is provided when you rest the mouse over the fabric icon in the fabric tree.

The fabric tree provides access to the topology and faceplate displays for any fabric or switch.

To open the topology display from the fabric tree, click a fabric entry.

To open the faceplate display from the fabric tree, click a switch entry.

2-24

59022-10 A

0

2 – Using SANsurfer Switch Manager

SANsurfer Switch Manager User Interface

 

 

 

2.10.4

Graphic Window

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

2.10.5

Data Window and Tabs

The data window presents a table of data and statistics associated with the selected tab. Use the scroll bar to browse through the data. The window length can be adjusted by clicking and dragging the border that it shares with the graphic window.

Adjust the column width by moving the pointer over the column heading border shared by two columns until a right/left arrow graphic is displayed. Click and drag the arrow to the desired width.

The data window tabs present options for the type of information to display in the data window. These options vary depending on the display.

2.10.6

Working Status Indicator

The working status indicator, located in the lower right corner of the SANsurfer Switch Manager window, shows when the management workstation is exchanging information with the fabric. As conditions change, the fabric forwards this information to the management workstation where it is reflected in the various displays.

59022-10 A

2-25

2 – Using SANsurfer Switch Manager

0

Using the Topology Display

2.11

Using the Topology Display

The topology display shown in Figure 2-10 receives information from the selected fabric and displays its topology. Switches and inter-switch links (ISLs) appear in the graphic window and use color to indicate status. Consider the following topology display features:

Switch and link status

Working with switches and links

Topology data windows

Figure 2-10. Topology Display

2.11.1

Switch and Link Status

Switch icon shape and color provide information about the switch and its operational state. Lines represent links between switches. The topology display uses green to indicate normal operation, yellow to indicate operational with errors, red to indicate a potential failure or non-operational state, and blue to indicate unknown, unreachable, or unmanageable. Refer to ”Fabric Status” on page 3-9 for more information about topology display icons.

2-26

59022-10 A

0

2 – Using SANsurfer Switch Manager

 

Using the Topology Display

 

 

 

2.11.2

Working with Switches and Links

Switch and link icons are selectable and moveable, and serve as access points for other displays and menus. You select switches and links to display information about them, modify their configuration, or delete them from the display. Context-sensitive popup menus are displayed when you right-click on a switch or link icon, or in the background of the topology display and graphic window.

2.11.2.1

Selecting Switches and Links

Selected switch icons are highlighted in light blue. Selected ISLs are displayed as a heavier line. You can select switches and links in the following ways:

To select a switch or a link, click the icon or link.

To select multiple switches or links, hold down the Control key and select.

To select all switches or links, right-click anywhere in the graphic window background. Select Select All Switches or Select All Links from the popup menu.

To cancel a selection, press and hold the Control key, and select the item again. To cancel all selections, click in the graphic window background.

2.11.2.2

Arranging Switches in the Display

You can arrange individual switch icons in the topology display or allow SANsurfer Switch Manager to arrange all switch icons for you:

To move an individual switch icon, click and drag the icon to another location in the graphic window. Links stretch or contract to remain connected.

To arrange all switch icons in the topology display automatically, open the View menu and select Layout Topology.

By default, the Toggle Auto Layout box in the View menu is checked which causes SANsurfer Switch Manager to arrange the icons when you select Layout Topology.

You can save a custom arrangement, or layout, and restore that layout during a SANsurfer Switch Manager session. Begin by arranging the icons, then open the View menu and select Remember Layout. To restore the saved layout, open the View menu, uncheck the Toggle Auto Layout box, and select Layout Topology.

59022-10 A

2-27

2 – Using SANsurfer Switch Manager

0

Using the Topology Display

2.11.3

Opening the Faceplate Display and Topology Popup Menus

The faceplate display shows the front of a single switch and its ports. To open the faceplate display when viewing the topology display, click the switch entry/icon in the fabric tree, or double-click the switch graphic.

The topology display also offers a fabric, switch, and a link popup menu:

To open the fabric popup menu, right-click the graphic window background. The fabric popup menu presents selections to refresh the fabric, select all switches, select all links, or layout topology.

To open the switch popup menu, right-click the switch icon in the graphic window. The switch popup menu presents selections to refresh the switch, delete the switch from the display, open the Switch Properties dialog, or open the Network Properties dialog.

To open the link popup menu, right-click the link. The Link popup menu presents a selection to delete the link from the display.

2.11.4

Topology Data Windows

The topology display provides the following data windows corresponding to the data window tabs:

Devices – displays all devices logged with the name server and their addresses within the current fabric configuration, and displays information from the fabric and allows devices to register certain information with the fabric. Refer to ”Devices Data Window” on page 4-8 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-16 for more information about this data window. Refer to ”Zoning a Fabric” on page 3-20 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-9 for more information.

Link – displays information about the inter-switch links. Refer to ”Link Data Window” on page 3-17 to for more information.

2-28

59022-10 A

0

2 – Using SANsurfer Switch Manager

 

Using the Faceplate Display

 

 

 

2.12

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 functional elements of the faceplate display:

Port Views and Status

Working with Ports

Faceplate Data Windows

Figure 2-11. Faceplate Display

2.12.1

Port Views and Status

Port color and text provide information about the port and its operational state. Green indicates active; gray indicates inactive. The faceplate display provides the following views of port status corresponding to the View menu options in the faceplate display. Refer to ”Monitoring Port Status” on page 5-2 for more information about these displays.

Port type

Port state

Port speed

Port media

59022-10 A

2-29

2 – Using SANsurfer Switch Manager

0

Using the Faceplate Display

2.12.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 window or to modify them. Context-sensitive popup menus and properties dialogs are displayed when you right-click the faceplate image or port icons in the faceplate display.

2.12.2.1

Selecting Ports

You can select ports in the following ways. Selected ports are outlined in white.

To select a port, click the port in the faceplate display.

To select a range of consecutive ports, select a port, then press and hold the shift key and select another port. The application selects both end ports and all ports in between in port number sequence.

To select several non-consecutive ports, hold the Control key while selecting.

To select all ports, right-click the faceplate image in the graphic window. Select Select All Ports from the popup menu.

To cancel a selection, press and hold the Control key and select it again.

2.12.2.2

Opening the Faceplate Popup Menu

To open the popup menu, right-click the faceplate image to present the following tasks.

Refresh the switch

Select all ports

Manage switch properties

Manage network properties

Manage SNMP properties

Extended credits wizard

Manage port properties

Change the port symbolic name

Run the port loopback tests

If no ports are selected, the port-related tasks will be unavailable in the menu. Right-click a port to open the Port popup menu. Hold down the Shift or Control key to select more than one port. If multiple ports are selected, right-click one of the selected ports.

2-30

59022-10 A

0

2 – Using SANsurfer Switch Manager

 

Using the Faceplate Display

 

 

 

2.12.3

Faceplate Data Windows

The faceplate display provides the following data windows corresponding to the data window tabs:

Devices – displays information about devices (hosts and storage targets) connected to the switch.

Switch – displays current switch configuration data.

Port Statistics – displays performance data for the selected ports.

Port Information – displays information for the selected ports.

Configured Zonesets – displays all zone sets, zones, and zone membership in the zoning database.

59022-10 A

2-31

2 – Using SANsurfer Switch Manager

0

Using the Faceplate Display

Notes

2-32

59022-10 A

Section 3

Managing Fabrics

This section describes the following tasks that manage fabrics:

Fabric Security

Fabric Tracker

Managing the Fabric Database

Working with Device Information and Nicknames

Displaying Fabric Information

Zoning a Fabric

3.1

Fabric Security

The components of Fibre Channel fabric security are:

User Account Security

Fabric Services

3.1.1

User Account Security

User account security is the process by which your user account and password are authenticated with the list of valid user accounts and passwords. The switch validates your account and password when you attempt to add a fabric using SANsurfer Switch Manager or log in to a switch through Telnet. Your system administrator defines accounts, passwords, and authority levels that are stored on the switch. Refer to ”Managing User Accounts” on page 4-2 for more information.

The Admin account possesses Admin authority which grants full access to all tasks of the SANsurfer Switch Manager menu system. The switch validates your user account and SANsurfer Switch Manager grants access to its menus according to your authority level. If you do not have Admin authority, you are limited to monitoring tasks.

Note: If a user is logged into a switch using SANsurfer Switch Manager or CLI, and an administrator changes user access rights and passwords, existing logins will not be affected by the new settings. Login access and privileges are only checked for a new login request.

59022-10 A

3-1

3 – Managing Fabrics

0

Fabric Security

3.1.2

Fabric Services

Fabric services security includes SNMP and in-band management. Simple Network Management Protocol (SNMP) is the protocol governing network management and monitoring of network devices. SNMP security consists of a read community string and a write community string, that are basically the passwords that control read and write access to the switch. The read community string ("public") and write community string ("private") are set at the factory to these well-known defaults and should be changed if SNMP is enabled using the SNMP Properties dialog. If SNMP is enabled (default) and the read and write community strings have not been changed from their defaults, you risk unwanted access to the switch. Refer to ”Enabling SNMP Configuration” on page 3-2 for more information. SNMP is enabled by default.

In-band management is the ability to manage switches across inter-switch links using SANsurfer Switch Manager, SNMP, management server, or the application programming interface. The switch comes from the factory with in-band management enabled. If you disable in-band management on a particular switch, you can no longer communicate with that switch by means other than a direct Ethernet or serial connection. Refer to ”Enabling In-band Management” on

page 3-2 for more information.

3.1.2.1

Enabling SNMP Configuration

To enable SNMP configuration, do the following:

1.On the faceplate display, open the Switch menu and select SNMP Properties to open the SNMP Properties dialog.

2.In the SNMP Configuration area, place a check mark in the SNMP Enabled check box.

3.Click the OK button to save the change to the database.

3.1.2.2

Enabling In-band Management

To enable In-band Management, do the following:

1.On the faceplate display, open the Switch menu and select Switch Properties to open the Switch Properties dialog.

2.Click the In-band Management Enable button.

3.Click the OK button to save the change to the database.

3-2

59022-10 A

+ 216 hidden pages