Brocade, the B-wing symbol, BigIron, DCX, Fabric OS, FastIron, IronPoint, IronShield, IronView, IronWare, JetCore, NetIron,
SecureIron, ServerIron, StorageX, and TurboIron are registered trademarks, and Brocade Network Advisor, Extraordinary
Networks, and SAN Health are trademarks of Brocade Communications Systems, Inc., in the United States and/or in other
countries. All other brands, products, or service names are or may be trademarks or service marks of, and are used to identify,
products or services of their respective owners.
Notice: This document is for informational purposes only and does not set forth any warranty, expressed or implied, concerning
any equipment, equipment feature, or service offered or to be offered by Brocade. Brocade reserves the right to make changes to
this document at any time, without notice, and assumes no responsibility for its use. This informational document describes
features that may not be currently available. Contact a Brocade sales office for information on feature and product availability.
Export of technical data contained in this document may require an export license from the United States government.
The authors and Brocade Communications Systems, Inc. shall have no liability or responsibility to any person or entity with
respect to any loss, cost, liability, or damages arising from the information contained in this book or the computer programs that
accompany it.
The product described by this document may contain “open source” software covered by the GNU General Public License or other
open source license agreements. To find-out which open source software is included in Brocade products, view the licensing
terms applicable to the open source software, and obtain a copy of the programming source code, please visit
http://www.brocade.com/support/oscd.
Brocade Communications Systems, Incorporated
Corporate and Latin American Headquarters
Brocade Communications Systems, Inc.
1745 Technology Drive
San Jose, CA 95110
Tel: 1-408-333-8000
Fax: 1-408-333-8101
E-mail: info@brocade.com
European Headquarters
Brocade Communications Switzerland Sàrl
Centre Swissair
Tour B - 4ème étage
29, Route de l'Aéroport
Case Postale 105
CH-1215 Genève 15
Switzerland
Tel: +41 22 799 5640
Fax: +41 22 799 5641
E-mail: emea-info@brocade.com
Asia-Pacific Headquarters
Brocade Communications Systems China HK, Ltd.
No. 1 Guanghua Road
Chao Yang District
Units 2718 and 2818
Beijing 100020, China
Tel: +8610 6588 8888
Fax: +8610 6588 9999
E-mail: china-info@brocade.com
Asia-Pacific Headquarters
Brocade Communications Systems Co., Ltd. (Shenzhen WFOE)
Citic Plaza
No. 233 Tian He Road North
Unit 1308 – 13th Floor
Guangzhou, China
Tel: +8620 3891 2000
Fax: +8620 3891 2111
E-mail: china-info@brocade.com
Page 3
Document History
Document TitlePublication NumberSummary of ChangesPublication Date
Web Tools User’s Guide v2.053-0001536-01N/ASeptember 1999
Web Tools User’s Guide v2.253-0001558-02N/AMay 2000
Web Tools User’s Guide v2.353-0000067-02N/ADecember 2000
Web Tools User’s Guide v3.0 53-0000130-03N/AJuly 2001
Web Tools User’s Guide v2.653-0000197-02N/ADecember 2001
Advanced Web Tools User’s
Guide v3.0 / v4.0
Advanced Web Tools User’s
Guide v4.0.2
Advanced Web Tools User’s
Guide v3.1.0
Advanced Web Tools User’s
Guide v4.1.0
Advanced Web Tools User’s
Guide v4.1.2
Advanced Web Tools
Administrator’s Guide, v4.2.0
Advanced Web Tools User’s
Guide
Advanced Web Tools
Administrator’s Guide
Web Tools Administrator’s Guide 53-0000522-08Updates to support new switch types
Web Tools Administrator’s Guide 53-0000522-09Updates to add additional information
Web Tools Administrator’s Guide 53-1000049-01Updates to support new switch types
Web Tools Administrator’s Guide 53-1000049-02Updates to the FCIP chapter to clarify
Web Tools Administrator’s Guide 53-1000194-01Updates for Fabric OS v5.2.0 and the
Web Tools Administrator’s Guide 53-1000435-01Updates to reflect interface
53-0000185-02N/AMarch 2002
53-0000185-03N/ASeptember 2002
53-0000503-02N/AApril 2003
53-0000522-02N/AApril 2003
53-0000522-04Insistent Domain ID Mode.
Port Swapping information. Minor
editorial changes.
53-0000522-05Updates to support new switch types:
Brocade 3250, 3850, 24000.
Structural changes, support changes,
installation changes.
53-0000522-06Clarifications on software and hardware
support, minor enhancements in
procedure text, minor rearranging of
content.
53-0000522-07Updates to support new switch types
(3016, 4100) and Fabric OS v4.4.0,
including Ports on Demand, user
administration, and zoning wizards.
(200E, 48000) and Fabric OS v5.0.1,
including switchAdmin role, upfront
login, and Web Tools EZ.
about refresh and polling rates.
(4900, 7500) and Fabric OS v5.1.0,
including FCR, FCIP, and the FR4-18i
port blade. Web Tools EZ information is
moved to a separate book.
how to configure tunnels.
FC4-16IP blade. Also new security for
Web Tools, including Role-Based Access
Control and administrative domains.
enhancements, support for new switch
types, IPv6 support, and other
enhancements.
October 2003
December 2003
March 2004
September 2004
April 2005
July 2005
January 2006
April 2006
September 2006
June 2007
Page 4
Document TitlePublication NumberSummary of ChangesPublication Date
Web Tools Administrator’s Guide 53-1000606-01Updates to reflect updates to enhanced
Access Gateway support, changes to
FCIP tunneling wizard, and other
enhancements.
Web Tools Administrator’s Guide 53-1000606-02Updates for support for new switches,
traffic isolation zoning, F_Port trunking,
removal of enhanced Access Gateway
support, and other enhancements.
Web Tools Administrator’s Guide 53-1001080-01Updates to add features that require
the Enhanced Group Management
license, removal of features that are
now available from the Brocade
Network Advisor.
Web Tools Administrator’s Guide 53-1001133-01Updates to add support for Brocade
Encryption Switch and FS8-18
Encryption Blade.
Web Tools Administrator’s Guide 53-1001194-01Updates to add support for Virtual
Fabrics, IPsec, and consistency with
Brocade Network Advisor.
Web Tools Administrator’s Guide 53-1001343-01Updates to add suppor t for Brocade
This document is organized to help you find the information that you want as quickly and easily as
possible.
The document contains the following components:
• Chapter 1, “Introducing Web Tools” provides some basic information about the Web Tools
interface, including system requirements and installation instructions.
• Chapter 2, “Using the Web Tools Interface” describes the components of the Web Tools
interface.
• Chapter 3, “Managing Fabrics and Switches” provides information on how to manage your
fabric and switches using the Web Tools interface.
• Chapter 4, “Maintaining Configurations and Firmware” provides information about uploading
and downloading configuration files and downloading firmware.
• Chapter 5, “Managing Administrative Domains” provides information on managing Admin
Domains.
• Chapter 6, “Managing Ports” provides information about managing FC and GbE ports.
• Chapter 7, “Enabling ISL Trunking” provides information on managing the licensed ISL Trunking
feature.
• Chapter 8, “Monitoring Performance” provides information on how to use the Brocade
Advanced Performance Monitoring feature to monitor your fabric performance.
• Chapter 9, “Administering Zoning” provides information on how to use the Brocade Advanced
Zoning feature to partition your storage area network (SAN) into logical groups of devices that
can access each other.
Web Tools Adminstrator’s Guidexxi
53-1002152-01
Page 22
• Chapter 10, “Working with Diagnostic Features” provides information about trace dumps,
viewing switch health, and interpreting the LEDs.
• Chapter 11, “Using the FC-FC Routing Service” provides information on using the FC-FC
Routing Service to share devices between fabrics without merging those fabrics.
• Chapter 12, “Using the Access Gateway” provides information on how to configure and manage
the Brocade Access Gateway.
• Chapter 13, “Administering Fabric Watch” provides information on how to use the Fabric Watch
feature to monitor the performance and status of switches and alert you when problems arise.
• Chapter 14, “Administering Extended Fabrics” provides information on how to configure a port
for long distance.
• Chapter 15, “Routing Traffic” provides information on how to configure routes.
• Chapter 16, “Configuring Standard Security Features” provides information on managing user
accounts, SNMP, and the RADIUS server.
• Chapter 17, “Administering FICON CUP Fabrics” provides information on how to administer and
manage FICON CUP fabrics. You can enable FMS mode, edit and create configurations, and
edit FMS parameters.
• Chapter 18, “Configuring FCoE with Web Tools” provides information on how to configure FCoE
features.
• Chapter 19, “Limitations” discusses limitations of and provides workarounds for using Web
Tools.
Supported hardware and software
In those instances in which procedures or parts of procedures documented here apply to some
switches but not to others, this guide identifies exactly which switches are supported and which are
not.
Although many different software and hardware configurations are tested and supported by
Brocade Communications Systems, Inc. for Fabric OS v7.0.0, documenting all possible
configurations and scenarios is beyond the scope of this document.
The following hardware platforms are supported by this release:
• Brocade 300
• Brocade 5100
• Brocade 5300
• Brocade 5410
• Brocade 5424
• Brocade 5450
• Brocade 5460
• Brocade 5470
• Brocade 5480
• Brocade NC-5480
• Brocade 6510
• Brocade 7800 Extension
xxiiWeb Tools Adminstrator’s Guide
53-1002152-01
Page 23
• Brocade 8000
• Brocade DCX 8510-4
• Brocade DCX 8510-8 Backbone
• Brocade DCX Backbone
• Brocade DCX-4S Backbone
• Brocade Encryption Switch
• Brocade VA-40FC
The following blades are supported by this release:
• Brocade CORE 8 blade
• Brocade CP8 blade
• Brocade CR16-4 blade
• Brocade CR16-8 blade
• Brocade CR4S-8 blade
• Brocade FC10-6 port blade
• Brocade FC16-32 port blade
• Brocade FC16-48 port blade
• Brocade FC8-16 port blade
• Brocade FC8-32 port blade
• Brocade FC8-48 port blade
• Brocade FC8-64 port blade
• Brocade FCOE10-24 blade
• Brocade FR4-18i router blade
• Brocade FS8-18 Encryption blade
• Brocade FX8-24 Extension blade
What’s new in this document
The following major additions have been made since this document was last released:
• DCFM has been changed to Brocade Network Advisor.
• CEE has been changed to DCB.
• Fabric Watch enhancements.
• User-defined roles
• Persistant user preferences
• Port octet speed combination support
• CSCTL mode support
• Inband management configuration support
• Support for port names of 128 characters.
For further information, refer to the release notes.
Web Tools Adminstrator’s Guidexxiii
53-1002152-01
Page 24
Document conventions
NOTE
ATTENTION
CAUTION
DANGER
This section describes text formatting conventions and important notice formats used in this
document.
Text formatting
The narrative-text formatting conventions that are used are:
bold textIdentifies command names
italic textProvides emphasis
code textIdentifies CLI output
For readability, command names in the narrative portions of this guide are presented in mixed
lettercase: for example, switchShow. In actual examples, command lettercase is often all
lowercase. Otherwise, this manual specifically notes those cases in which a command is case
sensitive.
Identifies the names of user-manipulated GUI elements
Identifies keywords and operands
Identifies text to enter at the GUI or CLI
Identifies variables
Identifies paths and Internet addresses
Identifies document titles
Identifies command syntax examples
Notes, cautions, and warnings
The following notices and statements are used in this manual. They are listed below in order of
increasing severity of potential hazards.
A note provides a tip, guidance, or advice, emphasizes important information, or provides a
reference to related information.
An Attention statement indicates potential damage to hardware or data.
A Caution statement alerts you to situations that can be potentially hazardous to you or cause
damage to hardware, firmware, software, or data.
A Danger statement indicates conditions or situations that can be potentially lethal or extremely
hazardous to you. Safety labels are also attached directly to products to warn of these conditions
or situations.
xxivWeb Tools Adminstrator’s Guide
53-1002152-01
Page 25
Key terms
For definitions specific to Brocade and Fibre Channel, see the Brocade Glossary.
For definitions of SAN-specific terms, visit the Storage Networking Industry Association online
dictionary at:
http://www.snia.org/education/dictionary
Notice to the reader
This document may contain references to the trademarks of the following corporations. These
trademarks are the properties of their respective companies and corporations.
These references are made for informational purposes only.
CorporationReferenced Trademarks and Products
Microsoft CorporationWindows 7, Windows Server 2008 Standard, Windows Vista
Oracle CorporationOracle, Solaris
Netscape Communications CorporationNetscape
Red Hat, Inc.Red Hat, Red Hat Network, Maximum RPM, Linux Undercover
MozillaFirefox
Business, Windows XP- SP3,Internet Explorer
Additional information
This section lists additional Brocade and industry-specific documentation that you might find
helpful.
Brocade resources
To get up-to-the-minute information, go to http://my.brocade.com and register at no cost for a user
ID and password.
White papers, online demonstrations, and data sheets are available through the Brocade website
at:
For additional Brocade documentation, visit the Brocade website:
http://my.brocade.com
Release notes are available on the MyBrocade website and are also bundled with the Fabric OS
firmware.
Web Tools Adminstrator’s Guidexxv
53-1002152-01
Page 26
Other industry resources
For additional resource information, visit the Technical Committee T11 website. This website
provides interface standards for high-performance and mass storage applications for Fibre
Channel, storage management, and other applications:
http://www.t11.org
For information about the Fibre Channel industry, visit the Fibre Channel Industry Association
website:
http://www.fibrechannel.org
Getting technical help
Contact your switch support supplier for hardware, firmware, and software support, including
product repairs and part ordering. To expedite your call, have the following information available:
1. General Information
• Switch model
• Switch operating system version
• Software name and software version, if applicable
• Error numbers and messages received
• supportSave command output
• Detailed description of the problem, including the switch or fabric behavior immediately
following the problem, and specific questions
• Description of any troubleshooting steps already performed and the results
• Serial console and Telnet session logs
• syslog message logs
2. Switch Serial Number
The switch serial number and corresponding bar code are provided on the serial number label,
as illustrated below:
Switch—On the switch ID pull-out tab located inside the chassis on the port side on the left.
• Brocade 5000—On the switch ID pull-out tab located on the bottom of the port side of the
switch.
• Brocade 7600—On the bottom of the chassis.
• Brocade DCX and 8510-8—On the bottom right on the port side of the chassis.
• Brocade DCX-4S and 8510-4—On the bottom right on the port side of the chassis, directly
above the cable management comb.
xxviWeb Tools Adminstrator’s Guide
53-1002152-01
Page 27
• Brocade 8000 —On the switch ID pull-out tab located inside the chassis on the port side
on the left.
3. World Wide Name (WWN)
Use the licenseIdShow command to display the WWN of the chassis.
If you cannot use the licenseIdShow command because the switch is inoperable, you can get
the WWN from the same place as the serial number, except for the Brocade DCX. For the
Brocade DCX, access the numbers on the WWN cards by removing the Brocade logo plate at
the top of the nonport side of the chassis.
Document feedback
Quality is our first concern at Brocade and we have made every effort to ensure the accuracy and
completeness of this document. However, if you find an error or an omission, or you think that a
topic needs further development, we want to hear from you. Forward your feedback to:
documentation@brocade.com
Provide the title and version number of the document and as much detail as possible about your
comment, including the topic heading and page number and your suggestions for improvement.
Brocade Web Tools is an embedded graphical user interface (GUI) that enables administrators to
monitor and manage single or small fabrics, switches, and ports. Web Tools is launched directly
from a web browser, or from the Brocade Network Advisor.
A limited set of features is accessible using Web Tools without a license, and is available free of
charge. Additional switch management features are accessible using Web Tools with the Enhanced
Group Management (EGM) license. Refer to “Web Tools, the EGM license, and Brocade Network
Advisor” for more information.
Web Tools, the EGM license, and Brocade Network Advisor
Beginning with Fabric OS version 6.1.1, Web Tools functionality is tiered and integrated with
Brocade Network Advisor. If you are migrating from a Web Tools release prior to Fabric OS version
6.1.1, this may impact how you use Web Tools.
A Web Tools license is not required, and a basic version of Web Tools is available for free.
Additional functionality may be added by obtaining the Enhanced Group Management (EGM)
license. Tab le 1 compares Basic Web Tools features to Web Tools with the EGM license. The EGM
license is only for 8 Gbps platforms, such as the Encryption Switch, and the 300, 5100, and 5300
switches. For non-8 Gbps platforms, all functionalities are available without the EGM license.
Beginning with Fabric OS version 6.1.1, some Web Tools capabilities are moved from Web Tools to
Brocade Network Advisor. Tabl e 2 summarizes these changes.
Web Tools Adminstrator’s Guide1
53-1002152-01
Page 30
Web Tools, the EGM license, and Brocade Network Advisor
1
Web Tools features enabled by the EGM license
Tab le 1 describes those Web Tools features that require the EGM license.
TABLE 1Basic Web Tools features and EGM licensed features
FeatureBasic Web ToolsWeb Tools with EGM License
Active Directory supportyesyes
AD Context Switchingnoyes
AD filtered viewsyesyes
Admin Domain Managementnoyes
AG Managementyesyes
Analyze zone confignono
Basic Zoning and TI Zoningyesyes
Blade Managementyesyes
Cloning a zonenoyes
Configuration upload/downloadyesyes
Convenience function from Tools menu nono
Device Accessibility Matrixnono
Easy to configure iSCSI wizardyesyes
Extended Fabric Managementnoyes
F_Port Trunk Managementnoyes
Fabric Eventsnono
Fabric Summarynono
Fabric Treeyesyes
FCIP Tunnel configurationnono
FCIP Tunnel Display yesyes
FCR Managementyesyes
FCR Port Configyesyes
FICON CUP Tabnoyes
FRU Monitoringyesyes
High Availabilityyesyes
IP Sec Policiesyesyes
ISL Trunk Managementnoyes
ISL Trunking informationyesyes
License Managementyesyes
Long Distancenoyes
Logical Switch Context Switchingnoyes
Allow/Prohibit Matrix noyes
Performance Monitoring Dialognoyes
2Web Tools Adminstrator’s Guide
53-1002152-01
Page 31
Web Tools, the EGM license, and Brocade Network Advisor
TABLE 1Basic Web Tools features and EGM licensed features (Continued)
FeatureBasic Web ToolsWeb Tools with EGM License
Port Administrationyesyes
Print zone database summarynono
RBACyesyes
Routing and DLS Configurationnoyes
Security Policies Tab (like ACL)yesyes
Switch Info tabyesyes
Switch Statusyesyes
Switch View right-click options yesyes
Trace dumpyesyes
USB Managementyesyes
User Managementyesyes
Verify and troubleshoot accessibility
between devices
yesyes
1
Web Tools functionality moved to Brocade Network Advisor
The functionality that was moved from Web Tools into Brocade Network Advisor is detailed in
Tab le 2.
TABLE 2Web Tools functionality moved to Brocade Network Advisor
Reverse Find in the Zoning dialog box
provides the view of the zoned and unzoned
devices in the fabric if all zone members are
selected for Find.
Zone Admin1Configure > Zoning:
Reverse Find in the Zoning dialog box
provides the view of the zoned and
unzoned devices in the fabric if all zone
members are selected for Find.
2Device Tree and Topology:
Connected End Devices — Custom
Display from the top level in the main
frame provides the device tree and
topology view for all the zoned devices
if all zones are selected in the active
zone configuration.
Zone AdminConfigure > Zoning
Web Tools Adminstrator’s Guide3
53-1002152-01
Page 32
System requirements
1
TABLE 2Web Tools functionality moved to Brocade Network Advisor (Continued)
the Compare dialog box provides the
Storage-Host and Host-Storage view in a
tree representation that is comparable to
the Device Accessibility Matrix when all
devices are selected.
Replace/Replace All zone members by
selecting the offline devices from the zone
tree. Offline devices have an unknown
overlay badge with good visibility.
Zoning report for both online and offline
database.
tunnels is still
supported in Web
Tools 6.1.1, but
New, Edit Config,
and delete are
only available in
Brocade Network
Advisor.
non-local switch
port id/WWN can
be added using
text box.
System requirements
Before you install Web Tools on your workstation, verify that your switches and workstation meet
the Web Tools requirements listed in this chapter.
Web Tools requires any browser that conforms to HTML version 4.0, JavaScript version 1.0, and
Java Plug-in 1.6.0_24 or later.
4Web Tools Adminstrator’s Guide
53-1002152-01
Page 33
System requirements
Brocade has certified and tested Web Tools on the platforms shown in Table 3.
TABLE 3Certified and tested platforms
Operating SystemBrowser
Windows Server 2008 R2 Standard (64-bit)Internet Explorer 8.0
Windows Server 2008 StandardInternet Explorer 7.0
Windows Vista BusinessInternet Explorer 7.0
Red Hat Enterprise Server 5 Advanced
Platform
SUSE Linux Enterprise Server 10Internet Explorer 7.0
Internet Explorer 7.0
Brocade supports the platforms shown in Tab le 4.
TABLE 4Supported platforms
Operating SystemBrowser
1
Red Hat AS 4.0 (x86 32-bit)
Red Hat Enterprise Linux 5.4 Adv (x86 32-bit)
SUSE Linux Enterprise Server 10 (32-bit)
SUSE Linux Enterprise Server 11 (x86 32-bit)
Windows 2000Firefox 2.0, Internet Explorer 6.0
Windows 2003 Server, SP2Firefox 2.0, Internet Explorer 7.0/8.0
Windows XP Pro SP3 (x86 32-bit)Firefox 2.0, Internet Explorer 7.0/8.0
Windows Server 2003 Standard SP2 (x86
32-bit)
Windows Server 2008 StandardFirefox 2.0, Internet Explorer 7.0/8.0
Windows 7 Professional (x86)Firefox 2.0
Solaris 9 (SPARC only)
Solaris 10 (SPARC only)
Firefox 2.0
Firefox 2.0, Internet Explorer 7.0/8.0
Firefox 2.0
For Windows systems, a minimum of 256 MB of RAM for fabrics comprising up to 15 switches, 512
MB of RAM for fabrics comprising more than 15 switches, and a minimum of 8 MB of video RAM
are recommended. Additionally, a DCX with a fully populated FC8-64 blade requires a minimum of
512 MB of RAM.
Setting refresh frequency for Internet Explorer
Correct operation of Web Tools with Internet Explorer requires specifying the appropriate settings
for browser refresh frequency and process model. Browser pages should be refreshed frequently to
ensure the correct operation of Web Tools.
To set the Internet Explorer options, perform the following steps.
1. Open your web browser and select Tools > Internet Options.
2. Select General > Temporary Internet Files > Settings.
Web Tools Adminstrator’s Guide5
53-1002152-01
Page 34
Java installation on the workstation
1
3. Choose Every visit to the page under “Check for newer versions of stored pages:” as shown in
Figure 1 on page 6.
FIGURE 1Configuring Internet Explorer
Deleting temporary internet files used by Java applications
For Web Tools to operate correctly, you must delete the temporary internet files used by Java
applications.
To delete these files, perform the following steps.
1. From the Control Panel, open Java.
2. Select the General tab and click Settings.
3. Click Delete Files to remove the temporary files used by Java applications.
4. Click OK on the confirmation dialog box.
You can clear the Trace and Log files check box if you want to keep those files.
5. Click OK.
6. On the Java Control Panel, click View to review the files that are in the Java cache.
If you have deleted all the temporary files, the list is empty.
Java installation on the workstation
Java Plug-in must be installed on the workstation. If you attempt to open Web Tools without any
Java Plug-in installed:
• Internet Explorer automatically prompts and downloads the proper Java Plug-in.
• Firefox downloads the most recently released Java Plug-in.
6Web Tools Adminstrator’s Guide
53-1002152-01
Page 35
Java installation on the workstation
NOTE
NOTE
If you attempt to open Web Tools with a later version of Java Plug-in installed:
1
• Internet Explorer might prompt for an upgrade, depending on the existing Java Plug-in version.
• Firefox uses the existing Java Plug-in.
Installing the JRE on your Solaris or Linux client workstation
To do the JRE installation, perform the following steps.
1. Locate the JRE on the Internet, at the following URL:
This URL points to a non-Brocade website and is subject to change without notice.
2. Follow the link to download the patch
3. Exit the browser when you have downloaded the patch.
4. Install the patch and restart the system.
Installing the Java plug-in on Windows
To Install the Java plug-in on Windows, perform the following steps.
1. Select Start Menu > Settings > Control Panel and select the Java Plug-in Control Panel.
2. Select the About tab.
3. Determine whether the correct Java Plug-in version is installed:
• If the correct version is installed, Web Tools is ready to use.
Web Tools Adminstrator’s Guide7
53-1002152-01
Page 36
Java plug-in configuration
1
• If no Java Plug-in is installed, point the browser to a switch running Fabric OS 5.2.0 or later
to install JRE 1.6.0. For Fabric OS 6.3.0 install JRE 1.6.0 update 13. Web Tools guides you
through the steps to download the proper Java Plug-in.
• If an outdated version is currently installed, uninstall it, restart your computer, reopen the
browser, and enter the address of a switch running Fabric OS 5.2.0 or later to install JRE
1.6.0. For Fabric OS 6.3.0 install JRE 1.6.0 update 13. Web Tools guides you through the
steps to download the proper Java Plug-in.
Java plug-in configuration
If you are managing fabrics with more than 10 switches or 1000 ports, or if you are using the iSCSI
Gateway module extensively, you should increase the default heap size to 256 MB to avoid
out-of-memory errors.
If you are using a Mozilla family browser (Firefox, Netscape), you should set the default browser in
the Java control panel.
The following procedures instruct you in increasing the default heap size in the Java Control Panel
and in setting the default browser.
Configuring the Java plug-in for Windows
To configure Java plug-in for Windows, perform the following steps.
1. From the Start menu, select Settings > Control Panel > Java.
2. Click the Java tab.
3. In the section Java Applet Runtime Settings, click View.
The Java Runtime Settings dialog box displays.
4. Double-click the Java Runtime Parameters field and enter the following information to set the
minimum and maximum heap size:
-Xms256m -Xmx256m
In this example, the minimum and maximum sizes are both 256 MB.
5. Click Apply to apply your settings and close the Java Control Panel.
8Web Tools Adminstrator’s Guide
53-1002152-01
Page 37
Value line licenses
1
Configuring the Java plug-in for Mozilla family browsers
To configure Java plug-in for Mozilla family browsers, perform the following steps.
1. From the Start menu, select Settings > Control Panel.
2. Click the Advanced tab and expand the Default Java for browsers option, as shown in Figure 2
on page 9.
FIGURE 2Default Java for browsers option
3. Select Mozilla family and click OK.
4. Click OK to apply your settings and close the Java Control Panel.
Value line licenses
If you open Web Tools on a switch with a limited license, and if the fabric exceeds the switch limit
indicated in the license, then Web Tools displays a warning message. Web Tools allows a 30-day
grace period, during which you can still monitor the switch while continuing to display warning
messages periodically.
These messages warn you that your fabric size exceeds the supported switch configuration limit
and tells you how long you have before Web Tools is disabled. After the 30-day grace period, you
are no longer able to open Web Tools from the switch with the limited switch license.
Web Tools is part of the Fabric OS of a switch. When you open Web Tools on a switch, you can
manage other switches in the fabric that have lower or higher firmware versions. It is important to
note that when accessing these switches you are opening the remote switch’s version of Web
Tools, and the functionality available for those switches might vary.
Web Tools Adminstrator’s Guide9
53-1002152-01
Page 38
Opening Web Tools
NOTE
NOTE
1
Opening Web Tools
You can open Web Tools on any workstation with a compatible Web browser installed. For a list of
Web browsers compatible with Fabric OS v7.0.0, refer to Table 3. Web Tools supports both HTTP
and HTTPS protocol.
To open Web Tools, perform the following steps.
1. Open the Web browser and enter the IP address of the device in the Address field, such as:
http://10.77.77.77
or
https://10.77.77.77
2. Press Enter.
The Web Tools login dialog box displays. Refer to “Logging in” on page 11 for more information.
If you are using Firefox, the browser window is left open. You can close it anytime after the login
dialog box displays. If you are using Internet Explorer, the browser window automatically closes
when the login dialog box displays.
If you have installed EZSwitchSetup on your workstation, the EZSwitchSetup Switch Manager
displays the first time you access the device. EZSwitchSetup provides an easy to use wizard
interface that may be used to simplify the initial setup procedure for smaller switches. Refer to
EZSwitchSetup Administrator’s Guide for information about the EZSwitchSetup interface.
If you want to use Web Tools instead of EZSwitchSetup, click Advanced Management in the
lower-left corner of the window to open the Web Tools interface. This book describes only the
Web Tools interface.
FIGURE 3Web Tools interface
10Web Tools Adminstrator’s Guide
53-1002152-01
Page 39
Opening Web Tools
NOTE
1
Logging in
When you use Web Tools, you must log in before you can view or modify any switch information.
This section describes the login process.
Prior to displaying the login window, Web Tools displays a security banner (if one is configured for
your switch), that you must accept before logging in. The security banner displays every time you
access the switch.
When you are presented with the login screen you must provide a user name and a password. Your
home Admin Domain is automatically selected. You can select to log in to an Admin Domain other
than your home domain.
You must login before you can view Switch Explorer (shown in Figure 3 on page 10).
Use this procedure to log in to the Admin Domain.
1. Click Run on the signed certificate applet.
A warning dialog box may display. If you select the check box Always trust content from this
publisher, the warning dialog box is not displayed when you open Web Tools again.
2. Click OK in the security banner window, if one displays.
3. In the login dialog box, enter your user name and password.
If your current password has expired, you must also provide a new password and confirm the
new password.
Logging in to a Virtual Fabric
If you are logging in to a platform that is capable of supporting Virtual Fabrics, the login dialog box
provides the option of logging in to a virtual fabric. The following platforms support virtual fabrics:
• Brocade DCX and DCX-4S
• Brocade VA-40FC
• Brocade 6510
• Brocade DCX 8510-8 and DCX 8510-4
• Brocade 5300
• Brocade 5100
Web Tools Adminstrator’s Guide11
53-1002152-01
Page 40
Opening Web Tools
1
To log in to a Virtual Fabric, perform the following steps.
1. Select Options to display the Virtual Fabric options.
You are given a choice between Home Logical Fabric and User Specified Virtual Fabric
(Figure 4). Home Logical Fabric is the default.
FIGURE 4Virtual Fabric login option
2. Log in to a logical fabric.
• To log in to the home logical fabric, select Home Logical Fabric and click OK.
• To log in to a logical fabric other than the home logical fabric, select User Specified Logical
Fabric, enter the fabric ID number, and click OK.
Logging in to an Admin Domain
If you are logging in to a platform that is capable of supporting Admin Domains, the login dialog box
displays. You do not have an Admin Domain option if the Access Gateway mode is enabled. Admin
Domains and Virtual Fabrics are mutually exclusive.
1. Select Options to select an Admin Domain other than your default home domain.
You are given a choice of Home Domain (the default), or User Specified Domain.
2. Log in to an Admin Domain.
• To log in to the home domain, select Home Domain and click OK.
• To log in to an Admin Domain other than the home domain, select User Specified Domain,
enter the Admin Domain name or number, and click OK.
If the user name or password is incorrect, a dialog box displays indicating an authentication
failure.
If you entered valid credentials, but specified an invalid Admin Domain, a dialog box displays
from which you can select a valid Admin Domain or click Cancel to log in to your home domain.
Logging out
You can end a Web Tools session either by selecting Manage > Log Out, or by closing the Switch
Explorer window.
You might be logged out of a session involuntarily, without explicitly selecting the Manage > Log
Out, under the following conditions:
• A physical fabric administrator changes the contents of your currently selected Admin Domain.
12Web Tools Adminstrator’s Guide
53-1002152-01
Page 41
• Your currently selected Admin Domain is removed or invalidated.
• Your currently selected Admin Domain is removed from your Admin Domain list.
• You initiate a firmware download from Web Tool’s Switch Administration window. In this case,
you are logged out a few minutes later when the switch restarts.
• Your session times out.
Role-Based Access Control
Role-Based Access Control (RBAC) defines the capabilities that a user account has based on the
assigned role. For each role, there is a set of predefined permissions on the jobs and tasks that can
be performed on a fabric and its associated fabric elements.
When you log in to a switch, your user account is associated with a predefined role. The role
determines the level of access you have on that switch and in the fabric. Table 5 describes these
roles.
For information about creating unique user account roles, refer to “User-defined accounts” on
page 175.
TABLE 5Predefined Web Tools roles
RoleDescription
Role-Based Access Control
1
adminYou have full access to all of the Web Tools features.
operatorYou can perform any actions on the switch that do not affect the stored configuration.
securityadminYou can perform actions that do not affect the stored configuration.
switchadminYou can perform all actions on the switch, except the following:
zoneadminYou can only create and modify zones.
fabricadminYou can do everything the Admin role can do except create new users.
basicswitchadminYou have a subset of Admin level access.
userYou have nonadministrative access and can perform tasks such as monitoring
Session management
A Web Tools session is the connection between the Web Tools client and its managed switch. A
session is established when you log in to a switch through Web Tools. When you close Switch
Explorer, Web Tools ends the session.
A session remains in effect until one of the following happens:
• You cannot modify zoning configurations.
• You cannot create new accounts.
• You cannot view or change account information for any accounts. You can only
view your own account and change your account password.
system activity.
• You log out
• You close the Switch Explorer window
• The session ends due to inactivity (time out)
Web Tools Adminstrator’s Guide13
53-1002152-01
Page 42
Web Tools system logs
1
A session automatically ends if no information was sent to the switch for more than two hours.
Because user key strokes are not sent to the switch until you apply or save the information, it is
possible for your session to end while you are entering information in the interface. For example,
entering a zoning scheme in the Zoning module does not require you to send information to the
switch until you save the scheme.
Web Tools does not display a warning when the session is about to time out. If your session ends
due to inactivity, all Web Tools windows become invalid and you must restart Web Tools and log in
again.
Web Tools enables sessions to both secure and nonsecure switches.
Access rights for your session are determined by your role-based access rights and by the contents
of your selected Admin Domain. After you log in, you can change to a different Admin Domain at any
time. However, you cannot change your role-based permissions.
Ending a Web Tools session
To end a Web Tools session, perform one of the following actions:
• Select Manage > Logout.
• Click the X in the upper-right corner of the Switch Explorer window to close it.
• Close all open Web Tools windows.
Web Tools system logs
Web Tools uses the log4j framework to write the logs into a file
When you launch Web Tools for the first time, it automatically creates the following directories.
These directories are created under Web Tools directory if they are not available:
• A <Web Tools> directory under the user home directory.
• The Web Tools Switch Support Save directory with the name format <Core Switch Name-Switch
IP Address-Switch WWN>.
The Web Tools Switch Support Save directory contains the following files:
• Log4j.xml
• WebTools.log
• SwitchInfo.txt
The SwitchInfo.txt file contains the following basic switch information:
• Switch Name
• Fabric OS version
• Switch Type
• Ethernet Ipv4
• Ethernet IPv4 subnet mask
• Ethernet IPv4 gateway
14Web Tools Adminstrator’s Guide
53-1002152-01
Page 43
The maximum size of the webtools.log file is 2MB. It is rolled into new file when the 5mb file size
limit is exceeded. A backup file named webtools1.log is automatically created. Web Tools maintains
only one webtools.log backup file at a time.
The Web Tools debug dialog box can be used to enable the debug state and level for a module at
runtime.
If you are familiar with XML scripting, you can edit the configuration file (log4j.xml) to collect the
data at startup. If you edit the configuration file, Web Tools need to be restarted. Contact your
switch support supplier for assistance.
Requirements for IPv6 support
The following list provides requirements for Web Tools IPv6 support:
• In a pure IPv6 environment, you must configure your DNS maps to the IPv6 address of the
switch.
• The switch name is required to match the DNS name that is mapped to the IPv6 address.
• If both IPv4 and IPv6 addresses are configured, Web Tools can be launched using any
configured IP address.
• Use a switch with v5.3.0 or later firmware to manage a mixed fabric of IPv4 and IPv6 switches.
• Switches running on version 5.2.0 do not discover IPv6 address-only switches in the same
The first thing you see when you log in to a switch with Web Tools is Switch Explorer, shown in
Figure 5 on page 19. Switch Explorer is divided into areas that provide access to, and information
about, the switch and fabric. The Switch Explorer areas are:
• The left pane, displaying the Tasks and Fabric Tree areas.
The Tasks area lets you perform management, monitoring, and other tasks. The Fabric Tree
displays a list of all the switches in the fabric.
• The menu bar, at the top of the window, providing access to commands and actions. The menu
bar displays the same commands as the left pane of Switch Explorer.
If you choose to collapse the left pane, you still have access to:
-Management tasks, such as zone administration, switch administration, port
administration, admin domain administration, and Fabric Watch administration.
You can manage basic zoning and Traffic Isolation zoning using Web Tools and Web Tools
with the Enhanced Group Management (EGM) license. To perform clone operations for
zoning, the EGM license must be installed on the switch; otherwise, access to this feature
is denied and an error message displays.
You must use Brocade Network Advisor to print the zone database summary configuration
and to analyze zone configurations. For more information on zoning management, refer to
“Zone configuration and zoning database management” on page 128.
-Reporting tasks, such as viewing the status of a switch.
-Monitoring tasks, such as performance monitoring, and viewing the temperature or power
status.
Web Tools Adminstrator’s Guide17
53-1002152-01
Page 46
Viewing Switch Explorer
NOTE
2
To perform monitoring tasks such as performance monitoring the EGM license must be
installed on the switch; otherwise, access to this feature is denied and an error message
displays.
-Tools tasks, such as opening the Telnet window.
• The buttons above the Switch View provide access to switch information: status, temperature,
power, and fan data, beaconing, and the legend for the Switch View.
Although clicking a button can open a separate dialog box or window displays the management
tasks, all access control is established when you first log in to the switch.
Buttons in Switch Explorer are unavailable for two reasons: your account does not have
sufficient privileges to access this feature, or your currently selected Admin Domain does not
meet some condition to access the feature.
• The Admin Domain context field indicates the administrative domain you are viewing and
allows you to change it.
• The Switch View displays an interactive graphic of the switch.
• The Switch Events and Switch Information tabs allow you to view event information and switch
information, including connectivity, port, zone and other information.
• An indicator bar in the lower-right corner of every module window contains the Admin Domain
you are currently viewing, the current user name logged in to the switch, and the role
associated with that user account.
• The small right arrow near the Switch Event tab displays the switch. When you log out of Web
Tools, it remembers the last window settings the next time you log in to the application. If you
display the switch, the next time you log in to Web Tools, by default the Switch View displays.
The EGM license is required only for 8 Gbps platforms, such as the following:
• Brocade Encryption Switch
• Brocade 300, 5300, and 5100 switches
• Brocade VA-40FC
• Brocade 8000
• Brocade 7800
18Web Tools Adminstrator’s Guide
53-1002152-01
Page 47
Viewing Switch Explorer
1
2
6
5
3
8
4
7
For non-8 Gbps platforms, all functionalities are available without EGM license.
2
1Tasks and Fabric Tree
2Menu bar
3Switch View buttons
4Changing the Virtual Fabric ID, or
Changing the Admin Domain
5Switch Events and Switch Information
6Indicator bar
7Professional Management Tool
offering
8Switch View
FIGURE 5Switch Explorer
Persisting GUI preferences
Web Tools persists your GUI preferences across sessions for the Switch Explorer, Port Admin,
Switch Admin, Name Server, and Zone Admin dialog boxes on all web-browser platforms.
Persistence is performed on a per host basis.
Web Tools Adminstrator’s Guide19
53-1002152-01
Page 48
Viewing Switch Explorer
2
If you launch WebTools from Brocade Network Advisor (BNA), all of the Web Tools GUI persistence
data for each user name is stored in the BNA database.
The Port Admin GUI preferences that persist are:
• Basic or Advance mode
• Last selected tab by the user
• Table column sor ting
• Table column positions
• Auto refresh interval selection check box
• Auto refresh interval value
The Switch Admin GUI preferences that persist are:
• Basic or Advance modes
• Last selected tab
• Table column sor ting
• Table column positions
• Last selected tab
• Auto refresh interval selection check box
• Auto refresh interval value
The Switch Explorer GUI preferences that persists are:
• Last selected tab
The Name Server GUI preferences that persist are:
• Table column sor ting
• Table column positions
• Auto refresh interval selection check box
• Auto refresh interval value
The Zone Admin GUI preferences that persist are:
• Basic Zones
• Traf f ic Is olat ion Z ones
• Last selected tab
• Table column sor ting
• Table column positions
Tasks
The Tasks menu lets you manage, monitor, and perform other tasks.
The Management section of the Task s menu provides access to the following options:
• Zone administration
Zone information is collected from the selected switch. If an ACL-based FCS policy is in effect,
zoning can be administered only from the primary fabric configuration server (FCS) switch.
Refer to “Zoning management” on page 119 for more information.
20Web Tools Adminstrator’s Guide
53-1002152-01
Page 49
Viewing Switch Explorer
NOTE
2
• Switch administration
• Port administration
• Admin Domain administration
• FCR (present only on the base switch when the Virtual Fabrics capability is enabled.)
• Fabric Watch
Some of these functions require a license key to activate them.
The Monitor section of the Tasks menu provides access to the following options:
• Performance monitoring—You must use Web Tools with the EGM license to perform
performance monitoring operations; otherwise, access to this feature is denied and an error
message displays.
• Name Server information—This feature is available with Web Tools and Web Tools with the EGM
license. Name Server information is collected from the selected switch. Refer to “Displaying the
Name Server entries” on page 51 for more information.
The Other section of the Tasks menu provides access to Telnet tools.
Fabric Tree
Fabric Tree displays all switches in the fabric, even those that do not have a Web Tools license and
that are not owned by your selected Admin Domain. Switches that are not owned by the Admin
Domain are shown in the Fabric Tree with switch status. Fabric Tree does not display switches
segmented before you opened Web Tools.
Only two types of switch icons display in Fabric Tree; one for a pizza box and one for a chassis. No
platform based icons are supported.
Use the drop-down menu at the top of the Fabric Tree area to view switches in the Fabric Tree by
switch name, IP address, or WWN. You can rest on the cursor over a switch to display the IP
address and current status. To manually refresh the status of a switch within the fabric, right-click
the switch in the Fabric Tree and select Refresh.
Although Fabric Tree displays all the switches in the fabric, you can manage switches that support
Fabric OS v6.1 and later versions because it does not requires Web Tools license. If a switch is
launched from Fabric Tree, preference will be given to IPV4, even though both IPV4 and IPV6 are
configured for that particular switch.
The versions earlier than Fabric OS v6.1 requires a Web Tools license and, if applicable, an EGM
license installed. Other switches must be managed through the Fabric OS command line interface
(CLI), another management application, or by using Brocade Network Advisor.
Changing the Admin Domain context
The Admin Domain field displays the currently selected Admin Domain and allows you to change to
a different one. The ability to change Admin Domain context requires that the EGM license is
enabled on the switch. Otherwise, an error message displays.
If you are logged in to Web Tools without the EGM license, you must log in again using a specific
Admin Domain.
Web Tools Adminstrator’s Guide21
53-1002152-01
Page 50
Viewing Switch Explorer
2
After you log in, all Admin Domains assigned to you are available in the drop-down menu. For most
administrative tasks, you must be in either AD0 or the physical fabric.
When changing the Admin Domain context, the option for selecting AD from the drop-down list is
not available if the EGM license is not present.
22Web Tools Adminstrator’s Guide
53-1002152-01
Page 51
Viewing Switch Explorer
NOTE
NOTE
NOTE
To change the Admin Domain context, perform the following steps.
1. Select a domain from the Admin Domain menu.
2. Click OK in the confirmation window.
Switch Explorer refreshes to display the new Admin Domain context. You can monitor the
progress using the progress bar.
The system displays a list of all open windows. You can choose to change the Admin Domain,
which closes all the open windows, or cancel the action and return to Switch Explorer.
The Telnet window and the Fabric Details are not AD-filtered and do not need to be closed.
Switch View buttons
The Switch View buttons let you access the following switch information:
• Status—Click the button to view the status of the switch.
• Temperatur e—Click the button to view temperature monitors.
• Power—Click the button to view power supply information.
• Fan—Click the button to view the status of the switch fans.
• Beaconing—Click this button to enable or disable beaconing and to view the status of
beaconing from the button’s icon.
• Legend—Click the button to view the legend for the Switch View.
2
For all status displays based on errors per time interval, any errors cause the status to show
faulty until the entire sample interval has passed.
Switch View
You can click the small right arrow towards the left of the Switch Event tab to display the Switch
View. The Switch View displays a graphical representation of the switch, including a real-time view
of switch and port status. Refer to area 8 in Figure 5 on page 19.
NOTES: With the upgrade license installed:
• For 7800, all FC ports and 6 GbE ports are enabled
Without the upgrade license installed:
• For 7800, 4 FC ports and 2 GbE ports are enabled
Blades are graphically represented in the Web Tools GUI. They are vertical in the DCX, and horizontal
in the DCX-4S.
Web Tools Adminstrator’s Guide23
53-1002152-01
Page 52
Viewing Switch Explorer
NOTE
2
The default Switch View displayrefresh rate is 60 seconds. However, the initial display of Switch
Explorer might take from 30 to 60 seconds after the switch is booted. Refresh rates are fabric-size
dependent. The auto refresh interval may not be less than 60 seconds. However, the refresh rate
varies depending on the activity in the fabric and on the host system you are using. The larger the
fabric, the longer it takes to poll the fabric and refresh the view. F_Port and L_Port connection
changes refresh immediately.
Port representations
The ports in the Switch View show the port type. Borders around the accessible ports indicate that
SFP modules are present. A colored border indicates the status of the port; for example, a green
border indicates that the port is connected and traffic is flowing. Ports that are not accessible do
not display the port type and do not have borders.
The port LEDs in the Switch View match the LEDs on the physical switch. However, the blink rate of
the LEDs in the Switch View does not necessarily match the blink rate of the LEDs on the physical
switch. Refer to “Port LED interpretation” on page 144 for more information.
Right-click a port in Switch View to get a menu that opens the Port Administration window, allowing
you to view detailed information about the port. From Port Administration, you can access
information on all other ports. Refer to Chapter 6, “Managing Ports” for more information.
For detailed information on ISL Trunking, F_Port Trunking, and long distance, you must install the
EGM license on the switch; otherwise access to these features is denied and an error message is
displayed.
If the selected Admin Domain does not include ownership of some ports that are physically present
on the switch, these ports are represented as black rectangles with horizontal gray bars indicating
they are not accessible.
E_Ports are visible in all domains. You cannot open the Port Administration window by clicking
these ports. For the Brocade DCX, the Port Admin view is launched for ICL ports.
USB port representation
For switches with USB ports, the USB Storage Management view is launched for USB ports
(Figure 6).
FIGURE 6USB port storage management
24Web Tools Adminstrator’s Guide
53-1002152-01
Page 53
Viewing Switch Explorer
NOTE
NOTE
Click the USB port on the switch to launch the USB Storage Management window.
2
Switch Events and Switch Information
Switch Events and Switch Information display as tab forms under Switch View. The information in
the Switch Information View is polled every 60 seconds.
You can click the column head to sort the events by a particular column, and drag the column divider
to resize a column. You can also right-click a column heading to resize one or all columns, sort the
information in ascending or descending order, or select which columns are displayed.
The Switch Information tab displays information about the following items:
• Switch
-NameName of the switch.
-StatusStatus of the switch.
-Fabric OS VersionFabric OS version of the switch.
-Domain IDDomain ID of the switch.
-WWNWorld Wide Name of the switch.
-Typ eTyp e of the swi tch.
-RoleRole of the switch.
The following information is specific to Virtual Fabrics:
-Base SwitchIndicates whether or not the logical switch can act as a base
-Default SwitchIndicates whether or not the logical switch is the default
-Allow XISL UseIndicates whether or not the logical switch is allowed to
• Ethernet
-Ethernet IPv4Ethernet IPv4 address of the switch.
-Ethernet IPv4 subnet
-Ethernet IPv4 gateway Ethernet IPv4 gateway address of the switch.
-Ethernet IPv6Ethernet IPv6 address of the switch.
-Effective Configuration Indicates whether zone configuration is enabled or not.
switch.
logical switch.
connect to other logical switches using an extended
inter-switch link (XISL).
Ethernet IPv4 subnet mask address of the switch.
mask
Web Tools Adminstrator’s Guide25
53-1002152-01
Page 54
Displaying tool tips
2
• Other
-Manufacturer serial numberDisplays the serial number of the manufacturer.
-Supplier serial numberDisplays the serial number of the supplier.
-License IDDisplays the license ID.
• RNID
-Typ eType of the swi tch .
-ModelModel of the switch.
-TagTag o f the switch.
-Sequence numberSequence number of the switch.
-Insistent Domain ID
Mode
Current status of the Insistent Domain ID mode of the switch.
-ManufacturerManufacturer of the switch.
-Manufacturer PlantPlant where the switch was manufactured.
For more information, refer to “Displaying switch information” on page 139.
Free Professional Management tool
You can use the Professional Management tool with Web Tools to view connectivity for each fabric,
to back up and restore last-known configurations, and more. You can also use it with the Enhanced
Group Management license to manage groups of switches, download firmware, manage security
settings, and deploy configurations across groups of switches. Contact your preferred storage
supplier to get a complimentary copy of the Professional Management tool.
Launch the install wizard for the free Professional Management tool through the link located at the
bottom of the Switch Explorer.
Displaying tool tips
When you rest the cursor over a Web Tools button, the system displays a brief description of the
button. If you rest the cursor over most components, the system displays tool tip information about
the component.
In the Fabric Tree you can rest the cursor over a switch to view its type, Ethernet IP, IPFC, and status
of the switch.
In Switch View, you can rest the cursor over a blade to view the blade ID and its status. It is easier
to use the top of the blade to display the tool tip so that you do not inadvertently display the port
tool tips. Firmware versions and IP addressing are displayed for CP blades.
When you rest the cursor over a port, you can view the:
• port name
• port ID
• port beacon
• port number
• port index
• port type (E, F, L, D, Ex, GIGe, or U_Port)
26Web Tools Adminstrator’s Guide
53-1002152-01
Page 55
• port status (online or offline)
• port state (in-sync, no_sync, no light, or no module)
Right-click options
You can right-click a port to quickly perform some basic port administration tasks, as shown in
Figure 7.
FIGURE 7Right-click menu for ports (from Switch Explorer)
The tasks are:
Right-click options
2
Refresh rates
• The Port Admin option displays the Port Administration window.
• The Port Details option displays read-only information about a port, without opening the Port
Administration window. You can right-click on the table content to export or copy the
information from the Port Details window.
• The Configure option provides another menu of options to allow you to rename, enable, and
disable ports, and to set persistent enable or disable without opening the Port Administration
window.
Different panels of Web Tools refresh at different rates.
The refresh, or polling, rates listed in this section and throughout the book indicate the time
between the end of one polling period and the start of the next, and not how often the screen is
refreshed. A refresh rate of 15 seconds does not ensure that a refresh occurs every 15 seconds. It
ensures that the time between each refresh activity is no more than 15 seconds.
Autorefresh intervals might be not be exactly 15 seconds. The refresh rate varies depending on the
activity in the fabric and on the host system you are using. Following are some variables you should
consider when refreshing the fabric:
• Retrieval time increases when you are in a large fabric because there is more data to retrieve
from the switches.
• Processor speed of the system you are using may slow down the refresh rate.
• OS-Job Scheduling if you are using a host-system in the data center impacts the refresh rate.
• JVM-Performance can contribute to causing interval differences between what is on-screen
and how long it is actually taking.
Web Tools Adminstrator’s Guide27
53-1002152-01
Page 56
Displaying switches in the fabric
NOTE
2
For these reasons, the time displayed in the port statistics tab might not be refreshed as expected.
The counter time indicates only that “this statistics data is retrieved from the switch in this time
period.” To ensure the correct information, the time field is updated along with the port statistics
data after every refresh.
The refresh rates are different for each module. Table 6 lists polling rates by module. Though these
rates are sample rates, they correctly illustrate variance in the refresh rates throughout Web Tools.
TABLE 6Polling rates
ModulePolling rate
Name ServerUser-defined; 15 sec minimum
Zoning Database60 sec
Fabric Watch45 sec
Performance Monitor
(This feature requires the EGM license.)
Port Management60 sec
FC Routing45–90 sec, depending on network traffic
30 sec
Displaying switches in the fabric
If your fabric has more than one switch, you can open Web Tools from one switch and then access
other switches. You can also launch Web Tools from the Brocade Network Advisor client as Element
Manager. This lets you manage Web Tool requests in the case where the fabric is in a private
network.
Launch Web Tools from Brocade Network Advisor if you need to access the fabric from a host that
is not in the same network and does not have direct access to the fabric.
If you open switches, running Fabric OS v4.4.x or later, from a Fabric Tree displayed for a version
earlier than a v4.4.x switch. Some of the features might be disabled.
To display switches in the fabric, perform the following steps.
1. Open Web Tools as described in “Opening Web Tools” on page 10 and log in to the switch.
2. If the Fabric Tree is not expanded, click the plus sign (+) in the Fabric Tree to view all the
switches in the fabric.
3. Click a switch in the Fabric Tree.
A separate browser dialog box displays the selected switch. (If the launch switch is running a
Fabric OS version earlier than v5.0.1, the selected switch displays in the same browser
window.)
The graphic of the selected switch displays in Switch View. Additional switch information
displays in the Switch Events and Switch Information dialog box.
28Web Tools Adminstrator’s Guide
53-1002152-01
Page 57
Working with Web Tools: recommendations
NOTE
Working with Web Tools: recommendations
Brocades makes the following recommendations for working with Web Tools:
• If you receive an error when saving changes in the Switch Administration window, note the
error messages, refresh the window, and make your changes again. Do not continue making
changes without refreshing the window and determining which changes were saved correctly.
• In a fabric containing switches and directors running different versions of firmware, use the
switches or directors with the latest firmware versions to control the fabric.
• If switches are accessed simultaneously from different connections (for example, Web Tools,
CLI, and API), changes from one connection might not be updated to the other, and some
modifications might be lost. Make sure that, when you connect with simultaneous multiple
connections, you do not overwrite the work of another connection.
• Several tasks in Web Tools make fabric-level changes, such as the tasks in Zone
Administration. When executing fabric-level configuration tasks, wait until you have received
confirmation that the changes are implemented before executing any subsequent tasks. For a
large fabric, this can take several minutes.
• Some data collection and processing operations in the iSCSI Gateway module might take a
long time to complete, especially in large fabrics or fabrics with large numbers of defined
Discovery Domains and Discovery Domain Sets. In most cases, progress bars are provided.
Allow the application a sufficient amount of time (30-40 seconds) to collect and display data
before taking any action or assuming the application is “hanging.”
• A maximum of five simultaneous HTTP sessions to any one switch is recommended. An HTTP
session is considered a Fabric Manager or Web Tools connection to the switch.
2
Opening a Telnet or SSH client window
When you open a Telnet or SSH client window, it connects to the IP interface of the switch. You
cannot connect to a CP blade on a director switch through a Telnet or SSH client window opened
from Web Tools, even when the blade has an IP address and supports Telnet sessions. Refer to the
Fabric OS Command Reference for information about the Telnet commands.
Internet Explorer 7.0 default settings disable Telnet functionality. If you are using Internet Explorer
7.0, you must make the appropriate changes in the registry to open the Telnet window.
To open a Telnet or SSH client window, perform the following steps.
1. Select a switch in Fabric Tree.
You are prompted to log in if the OS is version 5.3.0 or later; otherwise, the selected switch
displays in Switch View.
2. Select Telnet/SSH Client in the Other section of the Tasks panel. The Preference dialog box
displays.
3. Select the client by clicking Tel net or SSH.
4. Enter the Telnet or SSH path, as defined for your implementation.
Web Tools Adminstrator’s Guide29
53-1002152-01
Page 58
Collecting logs for troubleshooting
2
To avoid the need to remember and key in the path, you can store the path on your PC and
browse to the location. Clicking the button to the right of the field initiates the browse
capability.
5. Click OK.
The Telnet or SSH window displays.
6. Enter your user credentials at the login prompt.
7.To close the session, enter exit at the prompt and press the Enter key.
Collecting logs for troubleshooting
If you encounter problems using the Web Tools interface, collect Java logs for use in
troubleshooting. From Microsoft Windows, perform this procedure.
1. Open Control Panel and select Java.
2. Click on the Advanced tab.
3. Expand Java console.
4. Select Show console.
5. Restart Web Tools.
The Java console displays, along with the Web Tools opening page.
6. Perform the Web Tools operation that caused the problem.
7.Collect the logs shown on the Java console.
8. If you no longer want to see the Java console when you start Web Tools, go back to the Control
Panel, repeat steps 1 and 2, and then deselect Show console.
Most of the management tasks described in this chapter are accessed through the Switch
Administration window. Information in the Switch Administration window is retrieved from the
selected switch, as shown in Figure 8 on page 32.
Web Tools Adminstrator’s Guide31
53-1002152-01
Page 60
Fabric and switch management overview
ATTENTION
3
If the switch is not a member of the selected Admin Domain, most tabs in the Switch
Administration window display in read-only mode, regardless of your permission level. The User tab
is editable because most of its information does not require switch membership in the current
Admin Domain.
FIGURE 8Switch Administration window, Switch tab
With the exception of switch time, information displayed in the Switch Administration window is not
updated automatically by Web Tools. To update the information displayed in the Switch
Administration window, click the Refresh button.
Most changes you make in the Switch Administration window are buffered, and are not applied to
the switch until you save the changes. If you close the Switch Administration window without saving
your changes, your changes are lost. To save the buffered changes you make in the Switch
Administration window to the switch, click Apply before closing the module or before switching to
another tab.
The License tab, Firmware Download tab, and the Security Policies tab are exceptions. The changes
you make on these tabs take effect immediately and there is no Apply button. There is an Apply
button in all the subtabs of security policies except ACL.
You can also use Telnet commands to perform management tasks. Refer to “Opening a Telnet or
SSH client window” on page 29 for information on how to launch a Telnet window using Web Tools.
32Web Tools Adminstrator’s Guide
53-1002152-01
Page 61
Configuring IP and subnet mask information
NOTE
Opening the Switch Administration window
Most of the management procedures in this chapter are performed from the Switch Administration
window.
To open the Switch Administration window, perform the following steps.
1. Select Ta sks > Manage > Switch Admin.
The Switch Administration dialog box displays in basic mode, as shown in Figure 8 on page 32.
The basic mode displays the “basic” tabs and options.
2. Click Show Advanced Mode to see all the available tabs and options.
Configuring IP and subnet mask information
Before proceeding, collect all the information you need to configure the Ethernet IP interface. This
includes the subnet mask, gateway IP address, or IPFC, and subnet mask for your system. When
you configure or change the Ethernet IP, subnet mask, gateway IP, or IPFC, and subnet mask from
Web Tools, there is a normal loss of network connection to the switch. Close all current windows
and restart Web Tools with the new IP address.
3
The IPFC address is specific for each logical switch. The IPFC address is set to FC0 for switches that
do not support Virtual Fabrics.
To configure the IP and subnet mask information, perform the following steps.
1. Select the Network tab.
2. In the appropriate IP address section, enter the IP address you want to use for the IP interface.
Use the IPv4 Address section or the IPv6 Address section to specify IP addresses.
3. In the IPv4 Address section:
• In the Ethernet IP field, enter the Ethernet IP address.
• In the Ethernet Mask field, enter the Ethernet mask address.
• In the GateWay IP address field, enter the gateway IP address.
4. In the IPv6 Address section, in the Ethernet IPv6 field, enter the Ethernet IP address.
5. You can also enable automatic configuration of IPv6 addresses by selecting Enable IPV6 Auto
Configuration.
The automatically generated IPv6 addresses are displayed under Auto Configured IPV6
Addresses. Eight auto-configured addresses are created per switch, and up to 24 for a DCX, or
DCX-4S chassis (eight per chassis, and eight per each installed CP).
Configuring Netstat Auto Refresh
The Netstat Performance window displays the details about Ethernet management port statistics
like the Interface, MTU, Met, RX-OK, RX-ERR, RX-DRP, RX-OVR, TX-OK, TX-ERR, TX-DRP, TX-OVR, and
Flag.
Web Tools Adminstrator’s Guide33
53-1002152-01
Page 62
Configuring a syslog IP address
3
To configure Auto Refresh, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Select the Network tab.
3. Click Netstat Performance.
4. Select the Auto Refresh check box to automatically refresh the port details.
Clear the check box to disable auto refresh.
5. When enabled, enter the interval time in seconds in the Auto-Refresh Interval field.
The port details are automatically refreshed, based on the configured time interval. The
minimum value is 15 seconds.
Configuring a syslog IP address
The syslog IP represents the IP address of the server that is running the syslog process. The syslog
daemon reads and forwards system messages to the appropriate log files or users, depending on
the system configuration. When one or more IP addresses are configured, the switch forwards all
error log entries to the syslog on the specified servers. Up to six servers are supported. Refer to
Fabric OS Administrator’s Guide for more information on configuring the syslog daemon.
To configure a syslog IP address, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Select the Network tab.
3. In the Syslog IP’s Configuration section, in the New IP field, enter an IP address in either IPv4
or IPv6 format.
4. Click Add.
The new IP address displays in the Syslog IP area.
5. Click Apply.
Removing a syslog IP address
To remove a syslog IP address, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Select the Network tab.
3. Select a syslog IP in the table and click Remove.
You can click Clear All to remove all of the syslog IP addresses from the table.
4. Click Apply.
34Web Tools Adminstrator’s Guide
53-1002152-01
Page 63
Configuring IP Filtering
Web Tools provides the ability to control what client IP addresses may connect to a switch or fabric.
To set up IP Filtering, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Select the Security Policies tab.
3. Select IPFilter on the Security Policies menu.
4. Click Create Policy.
The Create IP Filter Policy dialog box displays.
5. Enter a policy name, select a policy type, and then click the Add Rule button.
6. Enter the rule order, rule type, source and destination IP addresses, and then modify the
service or destination port, protocol, and action as necessary.
Both the source and destination IP addresses are needed for the FWD rule type.
Only the source IP address is needed for the INPUT rule type, as the destination IP address
field is disabled.
Configuring IP Filtering
3
7.C l ic k OK.
After you create a policy, you can use the following controls on this tab to manage the policies:
• The Edit Policy button lets you select an existing policy and make changes to it.
• The Show Policy button lets you view the details of the policy in a read-only window.
• The Delete Policy button lets you delete a policy.
• The Clone Policy button lets you copy a policy. Use this feature when you want to create
similar policies. After you create a clone, you can edit the policy to make the appropriate
changes.
• The Activate Policy button lets you make an existing policy active.
• The Distribute Policy button lets you distribute a policy to various switches.
• The Accepts Distribution check box lets you set the policy to accept or reject distributions.
Blade management
Web Tools provides the ability to enable and disable blades, and to set slot-level IP addresses for
blades. The procedure in this section applies only to the Brocade DCX 8510-4, Brocade DCX
8510-8,or the Brocade DCX and DCX-4S enterprise-class platforms.
Enabling or disabling a blade
The Firmware Version columns display the firmware loaded onto each blade. A blade can have
more than one firmware image loaded onto it. The Blade State column in the Blade tab pane
indicates whether the blade is enabled.
Web Tools Adminstrator’s Guide35
53-1002152-01
Page 64
Blade management
NOTE
3
The blade state is always shown as enabled, even if you perform a blade disable operation. When a
blade is set to a disable state, only the ports on the balde are disabled. The blade remains active.
To enable or disable a blade, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Select the Blade tab (Figure 9).
FIGURE 9Blade tab
3. Select Blade Action > Enable Blade for each blade you want to enable, or Blade Action >
Disable Blade to disable a blade, and click Yes in the confirmation dialog.
Disabling a blade does not turn off the blade, it disables the ports on the blade. You cannot
enable or disable the CP blades.
Setting a slot-level IP address
To set an IP address, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Select the Blade tab.
3. Click Set IP address.
4. Select a slot number from the list.
36Web Tools Adminstrator’s Guide
53-1002152-01
Page 65
Switch configuration
NOTE
5. Enter the IP address, subnet mask, and Gateway IP address.
6. Select a type from the list.
7.C l ic k Add to add the new entry to the table.
When you click Add, the values remain in the fields. The Clear Gateway and Clear IP buttons
are available for clearing fields in the table.
To remove a configuration, select a row in the table and click Delete.
8. Click Apply to save the values currently shown in the table or click Cancel to close the dialog
box without saving any of your changes.
9. To update the switch with your changes, update the table using the Add and Delete buttons,
and then click Apply.
3
Viewing IP addresses
If you want to view the IP addresses configured on the switch for the currently populated slots, use
the Show IP Address button.
Use this procedure to display the IP addresses.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Select the Blade tab.
3. Click Show IP Address.
4. Scroll through the list to view all the information.
5. When you are finished, click Close.
Switch configuration
Use the Switch tab of the Switch Administration window to perform basic switch configuration.
Figure 8 on page 32 displays an example of the Switch tab.
Enabling and disabling a switch
You can identify whether a switch is enabled or disabled in the Switch Administration window by
looking at the lower-right corner. If you rest the cursor over the icon, the system displays text that
indicates the status of the switch.
Use this procedure to enable or disable a switch.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Select the Switch tab.
3. In the Switch Status section, click Enable to enable the switch or Disable to disable the switch.
4. Click Apply.
Web Tools Adminstrator’s Guide37
53-1002152-01
Page 66
Switch configuration
NOTE
3
The system displays a confirmation window that asks if you want to save the changes to the
switch. You must click Yes to save the changes.
Changing the switch name
Switches can be identified by IP address, domain ID, World Wide Name (WWN), or switch names.
Names must begin with an alphabetic character, but otherwise can consist of alphanumeric,
hyphen, and underscore characters. The maximum number of characters is 30, unless FICON
mode is enabled. When FICON mode is enabled, the maximum number of characters is 24.
Some system messages identify a switch service by the chassis name. If you assign meaningful
chassis names and switch names, system logs are easier to use.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Select the Switch tab.
3. Enter a new name in the Name field and click Apply.
Changing the switch domain ID
Although domain IDs are assigned dynamically when a switch is enabled, you can request a
specific ID to resolve a domain ID conflict when you merge fabrics.
To change the switch domain ID, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Disable the switch, as described in “Enabling and disabling a switch” on page 37.
3. Select the Switch tab.
4. Enter a new domain ID in the Domain ID field.
For IM0, the range of valid values is from 1 athrough 239.
5. Click Apply.
6. Enable the switch, as described in “Enabling and disabling a switch” on page 37.
Viewing and printing a switch report
The switch report includes the following information:
• A list of switches in the fabric
• Switch configuration parameters
• A list of ISLs and ports
• Name Server information
• Zoning information
• SFP serial ID information
38Web Tools Adminstrator’s Guide
53-1002152-01
Page 67
To view or print a report, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
2. Select the Switch tab.
3. Click View Report.
4. In the new window that displays the report, view or print the report using your browser.
Switch restart
When you restart the switch, the restart takes effect immediately. Ensure that there is no traffic or
other management on the switch, because traffic is interrupted during the restart; however, frames
are not dropped. Be sure to save your changes before the restart, because any changes not saved
are lost.
Performing a fast boot
A fast boot reduces boot time significantly by bypassing the power-on self test (POST).
window” on page 33.
Switch restart
3
To perform a fast boot, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Click Fastboot.
3. On the Fastboot Confirmation window, click Yes to continue.
4. Click Apply.
Performing a reboot
To reboot the CP and execute the normal power-on booting sequence, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Click Reboot.
3. On the Reboot Confirmation window, click Yes to continue.
4. Click Apply.
System configuration parameters
You must disable the switch before you can configure fabric parameters.
You can change the following system configuration parameters:
• Switch fabric settings
• Virtual channel settings
• Arbitrated loop parameters
Web Tools Adminstrator’s Guide39
53-1002152-01
Page 68
System configuration parameters
3
• System services
• Signed firmware
WWN-based Persistent PID assignment
WWN-based PID assignment allows you to configure a PID persistently using a device’s WWN.
When the device logs into the switch, the PID is bound to the device WWN. If the device is moved to
another port in the same switch, or a new blade is hot plugged, the device receives the same PID
(area) at its next login. For information on configuring WWN-based PID assignment, refer to
“Configuring fabric settings” on page 41.
This feature is deactivated by default. When the feature is enabled, bindings are created
dynamically; as new devices log in, they automatically enter the WWN-based PID database. The
bindings exist until you explicitly unbind the mappings through the CLI or change to a different
addressing mode. If there are any existing devices when you enable the feature, you must manually
enter the WWN-based PID assignments through the CLI.
Once WWN-based PID assignment is enabled you must manually enter the WWN-based PID
assignments through the CLI for any existing devices. Any new devices logging in are automatically
entered in the WWN-based PID database. Current WWN-based PID bindings are cleared when you
change to a different addressing mode.
PID assignments are supported for a maximum of 4096 devices; this includes both point-to-point
and NPIV devices. The number of point-to-point devices supported depends directly on the areas
available. For example, 448 are available on an enterprise-class platform and 256 are available on
switches. When the number of entries in the WWN-based PID database reaches the number 4096
or areas are used up, the oldest unused entry is purged from the database to free up the reserved
area for the new FLOGI. Refer to Table 7 for complete information.
TABLE 7Switches that support WWN-based Persistent PID on Web Tools
To configure the fabric settings, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Select the Configure tab.
3. Select the Fabric subtab.
4. Make the fabric parameter configuration changes.
5. Click Apply.
6. Enable the switch as described in “Enabling and disabling a switch” on page 37.
Fabric settings
Configure the following fabric settings on the Fabric subtab of the Configure tab:
BB CreditThe buffer-to-buffer credit is the number of buffers available to attached devices for frame
receipt. The default BB Credit is 16. The range of valid values is from 1 through 27.
R_A_TOVResource allocation timeout value (in milliseconds). This variable works with the E_D_TOV
to determine switch actions when presented with an error condition. The default is 10000.
The possible range is (2*E_D_TOV) –120000. Values must be multiples of 1000.
E_D_TOVError detect timeout value (in milliseconds). This timer is used to flag a potential error
condition when an expected response is not received within the set time. The valid range
is 1000 - (R_A_TOV/2)
Addressing modeDisplays the addressing mode present in the switch.
Datafield sizeThe largest possible data field size (in bytes). The range of valid values is from 256
through 2112.
Sequence Level
Switching
Disable Device Probing Set this mode only if the switch N_Port discovery process (PLOGI, PRLI, INQUIRY) causes
Per-Frame Routing
Priority
Suppress Class F Traffic Applies only if VC-encoded address mode is also set. When selected, translative
Insistent Domain ID
Mode
WWN-based Persistent
PID
Select this box to enable frames of the same sequence from a particular group to be
transmitted together. When this option is not selected, frames are transmitted interleaved
among multiple sequences. Under normal circumstances, sequence-level switching
should be disabled for better performance. However, some host adapters have issues
when receiving interleaved frames among multiple sequences.
an attached device to fail. When set, devices that do not register with the Name Server are
not present in the Name Server database.
Select whether to select per-frame routing priority. When enabled, the virtual channel ID is
used in conjunction with a frame header to form the final virtual channel ID.
addressing (which allows private devices to communicate with public devices) is disabled.
Set this mode to make the current domain ID insistent across reboots, power cycles, and
failovers. This mode is required fabric wide to transmit FICON
Set this mode to configure a PID persistently using a device’s WWN. When the device logs
into the switch, the PID is bound to the device WWN. Refer to “WWN-based Persistent PID
assignment” on page 40.
data.
Enabling insistent domain ID mode
To enable insistent domain ID mode, perform the following steps.
Web Tools Adminstrator’s Guide41
53-1002152-01
Page 70
System configuration parameters
ATTENTION
3
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Disable the switch as described in “Enabling and disabling a switch” on page 37.
3. Select the Configure tab.
4. Select the Fabric subtab.
5. Select the Insistent Domain ID Mode check box.
6. Click Apply.
7.En a b l e t h e sw i t c h as described in “Enabling and disabling a switch” on page 37.
Configuring virtual channel settings
You can configure parameters for eight virtual channels (VC) to enable fine-tuning for a specific
application. You cannot modify the first two virtual channels because these are reserved for switch
internal functions.
The default virtual channel settings are already optimized for switch performance. Changing the
default values can improve switch performance, but can also degrade performance. Do not change
these settings without fully understanding the effects of the changes.
VC Priority specifies the class of frame traffic given priority for a virtual channel.
To configure the virtual channel settings, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Disable the switch as described in “Enabling and disabling a switch” on page 37.
3. Select the Configure tab.
4. Select the Virtual Channel subtab.
5. Enter a value in the VC Priority field you want to change.
The only valid numeric values for all fields are either “2” or “3”.
6. Click Apply.
7.En a b l e t h e sw i t c h as described in “Enabling and disabling a switch” on page 37.
Configuring arbitrated loop parameters
To configure arbitrated loop parameters, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Disable the switch as described in “Enabling and disabling a switch” on page 37.
3. Select the Configure tab.
4. Select the Arbitrated Loop subtab.
42Web Tools Adminstrator’s Guide
53-1002152-01
Page 71
System configuration parameters
NOTE
5. Select or clear the check boxes to enable or disable the corresponding arbitrated loop
parameters.
6. Click Apply.
7.En a b l e t h e sw i t c h as described in “Enabling and disabling a switch” on page 37.
3
Arbitrated loop parameters
Configure the following arbitrated loop parameters on the Arbitrated Loop subtab of the Configure
tab:
Send Fan FramesSelect this check box to specify that fabric address notification (FAN)
frames are sent to public loop devices to notify them of their node ID
and address.
Always Send RSCNFollowing the completion of loop initialization, a remote state change
notification (RSCN) is issued when FL_Ports detect the presence of
new devices or the absence of pre-existing devices. Select this check
box to issue an RSCN upon completion of loop initialization, regardless
of the presence or absence of new or pre-existing devices.
Configuring system services
You can enable or disable FCP read link status (RLS) probing for F_Ports and FL_Ports. It is
disabled by default.
To configure system services, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Disable the switch as described in “Enabling and disabling a switch” on page 37.
3. Select the Configure tab.
4. Select the System subtab.
5. Select the Disable RLS Probing check box to disable RLS probing.
-or-
Clear the check box to enable RLS probing.
6. Click Apply.
7.En a b l e t h e sw i t c h as described in “Enabling and disabling a switch” on page 37.
Configuring signed firmware
When the firmware is downloaded to a device, the system can validate the firmware based on a
configuration setting. By default, the signed firmware download is not validated.
During the first download, the system ignores the signed firmware. After the first download, the
public key is downloaded and then, in subsequent downloads, you can turn on the feature.
You can view the public key on the Firmware Download tab in the Switch Administration window.
Web Tools Adminstrator’s Guide43
53-1002152-01
Page 72
Licensed feature management
NOTE
3
To configure the signed firmware, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Select the Configure tab.
3. Select the Firmware subtab.
4. Select the Enable Signed Firmware Download check box.
5. Click Apply.
Licensed feature management
The licensed features currently installed on the switch are listed in the License tab of the Switch
Administration window. If the feature is listed, such as the EGM license, it is installed and
immediately available. When you enable some licenses, such as ISL Trunking, you might need to
change the state of the port to enable the feature on the link. For time-based licenses, the expiry
date is included. Right-click a license key to export data, copy data, or search the table.
Activating a license on a switch
Before you can unlock a licensed feature, you must obtain a license key. You can either use the
license key provided in the paperpack document supplied with switch software or refer to the
Fabric OS Administrator’s Guide for instructions on how to obtain a license key at the Brocade
website (my.brocade.com).
To activate a license, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Select the License tab and click Add.
The Add License dialog box displays.
3. Paste or enter a license key in the field.
4. Click Add License.
5. Click Refresh to display the new licenses in the License tab.
Some licenses, such as the Trunking or Brocade 7800 upgrade license, do not take effect until
the switch is restarted.
Assigning slots for a license key
This feature allows to increase the capacity without disrupting the slots that already have licensed
features running.
You can enable slot based licenses only on 10 Gigabit Ethernet (FTR_10G), Advanced Extension
(FTR_AE), and Advanced FICON Acceleration (FTR_AFA) features.
To assign slots for a license key, perform the following steps.
44Web Tools Adminstrator’s Guide
53-1002152-01
Page 73
Licensed feature management
ATTENTION
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Select the License tab.
3. Select the license key for which you want to assign slots from the License Administration table.
The Assign Slots window displays.
4. Select the slots you want to assign.
5. Click OK.
3
Removing a license from a switch
To remove a license from a switch in the Switch Administration window, perform the following
steps.
Use care when removing licenses. If you remove a license for a feature, that feature no longer works.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Select the License tab.
3. Click the license you want to remove.
4. Click Remove.
Universal time-based licensing
After v6.3.0, Web Tools supports universal time-based licensing. Each universal key is for a single
feature, and can be used on any product that supports the feature, for a defined trial period. At the
end of the trial period, the feature gets disabled. You can extend the universal key license. For
time-based licenses, the Expiry Date displays in the License Administration table.
The following features are supported for universal time-based license:
• Fabric
• Extended Fabric
• Fabric Watch
• Performance Monitor
• Trun king
• High-Performance Extension over FCIP/FC
• Advanced Extension
• Advanced FICON Acceleration
• FICON Management Server (CUP)
• Enhanced Group Management (EGM)
• 10GbE
• Integrated Routing
• Adaptive Networking
Web Tools Adminstrator’s Guide45
53-1002152-01
Page 74
High Availability overview
3
• Server Application Optimization
High Availability overview
High-Availability (HA) features provide maximum reliability and nondisruptive replacement of key
hardware and software modules. High Availability is available only on the Brocade DCX, DCX-4S,
DCX 8510-4 and DCX 8510-8 platforms. Refer to the Fabric OS Administrator’s Guide for additional
information about High Availability.
The High Availability window, as shown in Figure 10, displays information about the status of the HA
feature on each control processor (CP), and enables you to perform CP failover.
The background color of the HA button indicates the overall status of high availability on the switch.
The colors and their meanings are:
• Green—Healthy: HA Status is HA enabled, Heartbeat Up, HA State synchronized.
• Yellow—Disruptive mode: HA Status is HA enabled, Heartbeat Up, HA State not in sync.
• Red—HA is unavailable: HA Status is Non-Redundant.
Admin Domain considerations
HA is possible if the switch is a member of the current Admin Domain. If switch is not a member of
current Admin Domain, the Synchronize Services and Initiate Failover buttons are unavailable.
Launching the High Availability window
To launch the High Availability window, perform the following steps.
1. Select a Brocade DCX, DCX-4S, DCX 8510-4 or DCX 8510-8 platforms from the Fabric Tree.
The Switch View displays.
2. Click the HA button in the Switch View.
The High Availability dialog box displays.
The High Availability window contains the following two tabs:
• The Service tab displays information about the switch. When the hardware is configured as a
dual switch, the Service tab displays information about both switches.
46Web Tools Adminstrator’s Guide
53-1002152-01
Page 75
High Availability overview
3
• The CP tab displays information about slots. For Brocade DCX-4S or DCX 8510-4, CP blades are
placed in slot 4 and slot 5.,For the Brocade DCX or DCX 8510-8, CP blades are placed in slot 6
and 7.
FIGURE 10High Availability window, CP tab
The High Availability window gets refreshed automatically. You can also click Refresh to update the
information displayed in the High Availability window.
Admin Domain considerations
To open the High Availability window, the switch must be a member of your current Admin Domain.
If the switch is not a member of the current Admin Domain, the Synchronized Services and Initiate
Failover buttons are unavailable.
Synchronizing services on the CP
A nondisruptive CP failover is only possible when all the services are synchronized between both
CPs.
To synchronize services on the CP, perform the following steps.
1. Open the High Availability window as described in “Launching the High Availability window” on
page 46.
2. Verify that the HA Status field displays HA enabled, Heartbeat Up, HA State synchronized.
If the HA Status field displays HA enabled, Heartbeat Up, HA State synchronized you are
finished.
If the HA Status field displays HA enabled, Heartbeat Up, HA State not in sync, continue with
step 3.
3. Click Synchronize Services.
The Warning dialog box displays.
Web Tools Adminstrator’s Guide47
53-1002152-01
Page 76
Event monitoring
3
4. Click Yes and wait for the CPs to complete a synchronization of services, so that a
nondisruptive failover is ready.
5. Click Refresh to update the HA Status field.
When the HA Status field displays HA enabled, Heartbeat Up, HA State synchronized a failover
can be initiated without disrupting frame traffic on the fabric.
Initiating a CP failover
A nondisruptive failover might take about 30 seconds to complete. During the failover, all of the
Web Tools windows and all associated child-windows are invalidated. You must close all Web Tools
windows and open Web Tools again.
To initiate a nondisruptive failover, perform the following steps.
1. Open the High Availability window as described in “Launching the High Availability window” on
page 46.
2. Verify that the HA Status field displays HA enabled, Heartbeat Up, HA State synchronized or HA
enabled, Heartbeat Up, HA State not in sync.
3. Click Initiate Failover.
The Warning dialog box displays.
4. Click Yes to initiate a nondisruptive failover.
5. When prompted, close the Web Tools Switch Explorer window and all associated windows, and
re-open Web Tools.
Event monitoring
Web Tools displays fabric-wide and switch-wide events. Event information includes sortable fields
for the following:
• Switch name
• Message number
• Time stamp
• Indication of whether the event is from a logical switch or a chassis
• The number of successive events of the same kind
• Severity level
• Unique message identifier (in the form moduleID-messageType)
• Detailed error message for root cause analysis
There are eight message severity levels:
• Emergency
• Alert
• Critical
• Error
• Warning
48Web Tools Adminstrator’s Guide
53-1002152-01
Page 77
Event monitoring
3
• Marginal
• Notice
• Information
• Debug
Tab le 8 lists the event message severity levels displayed on the Switch Events tab and explains
what qualifies event messages to be certain levels.
On the Switch Events tab, you can click the Filter button to launch the Filter Events dialog box. The
Filter Events dialog box allows you to define which events should be displayed on the Switch Events
tab. For more information on filtering events, refer to “Filtering Switch Events” on page 50.
TABLE 8Event severity levels
Icon and levelDescription
Emergency-level messages indicate a partial or complete failure of a
Emergency
Critical
subsystem.
Critical-level messages indicate that the software has detected serious
problems that will eventually cause a partial or complete failure of a subsystem
if not corrected immediately. For example, a power supply failure or rise in
temperature must receive immediate attention.
This event does not compromise data or prevent the use of the system;
Alert
Error
Warning
Notice
Info
Debug
however, the event warrants your attention.
Error-level messages represent an error condition that does not impact overall
system functionality significantly. For example, error-level messages might
indicate timeouts on certain operations, failures of certain operations after
retries, invalid parameters, or failure to perform a requested operation.
Warning-level messages highlight a current operating condition that should be
checked or it might lead to a failure in the future. For example, a power supply
failure in a redundant system relays a warning that the system is no longer
operating in redundant mode. The failed power supply must be replaced or
fixed.
Notices report important events, such as task completions or events.
Information-level messages report the current nonerror status of the system
components, such as the online and offline status of a fabric port.
Debug messages deliver status messages relating to debugging systems.
Displaying Switch Events
The Switch Events tab displays a running log of events for the selected switch. Switch events are
polled and updated every 15 seconds; there is no refresh-on-demand option for switch events.
For two-switch configurations, all chassis-related events are displayed in the event list of each
logical switch for convenience.
Web Tools Adminstrator’s Guide49
53-1002152-01
Page 78
Event monitoring
3
To display Switch Events, perform the following steps.
1. Select the switch from the Fabric Tree.
The Switch View displays.
2. Select the Switch Events tab, if necessary.
Filtering Switch Events
You can filter the fabric and switch events by time, severity, message ID, and service. You can apply
either one type of filter at a time or multiple types of filters at the same time. When a filter is
applied, the filter information displays at the bottom of the filtered information and the Show All link
is available to allow you to view the information unfiltered.
To filter Switch Events, perform the following the procedure.
1. Open the Switch Events tab as described in “Displaying Switch Events” on page 49.
2. Click Filter.
The Event Filter dialog box displays.
3. To filter events within a certain time period:
• Select the From check box and enter the start time and date in the fields.
• Select the To check box and enter the finish time and date in the fields.
• To filter events beginning at a certain date and time, select only the From check box and
enter the start time and date.
• To filter events up until a certain date and time, select only the To check box and enter the
finish time and date.
4. Click OK.
The filter is enabled and the window is refreshed to show the filtered information.
Filtering events by event severity levels
To filter events by event severity levels, perform the following steps.
1. Open the Switch Events tab as described in “Displaying Switch Events” on page 49.
2. Click Filter.
The Event Filter dialog box displays.
3. Select Level.
4. Select the event levels you want to display.
5. Click OK.
The filter is enabled and the window is refreshed to show the filtered information.
50Web Tools Adminstrator’s Guide
53-1002152-01
Page 79
Displaying the Name Server entries
NOTE
Filtering events by message ID
To filter events by message ID, perform the following steps.
1. Open the Switch Events tab as described in “Displaying Switch Events” on page 49.
2. Click Filter.
The Event Filter dialog box displays.
3. Select Message ID.
4. Enter the message IDs in the associated field.
You can enter multiple message IDs as long as you separate them by commas. You can enter
either the full message ID (moduleID-messageType) or a partial ID (moduleID only). The
message ID filtering is case-sensitive.
5. Click OK.
The filter is enabled and the window is refreshed to show the filtered information.
3
Filtering events by service component
To filter events by service component, perform the following steps.
1. Open the Switch Events tab as described in “Displaying Switch Events” on page 49.
2. Click Filter.
The Event Filter dialog box displays.
3. Select Service. The event service menu is enabled.
4. Select either Switch or Chassis from the menu to show only those messages from the logical
switch or from the chassis.
5. Click OK.
The filter is enabled and the window is refreshed to show the filtered information.
Displaying the Name Server entries
Web Tools displays Name Server entries listed in the Simple Name Server database. This includes
all Name Server entries for the fabric, not only those related to the local domain. Each row in the
table represents a different device. You can click the column head to sor t the events by a particular
column, and drag the column divider to resize a column. You can also right-click a column heading
to resize one or all columns, sort the information in ascending or descending order, or select which
columns are displayed.
Admin Domain considerations: The Name Server table is filtered based on Admin Domain
membership of the fabric devices. The Name Server table lists only devices that are part of your
current Admin Domain. This includes devices that are direct members of the Admin Domain and
devices that are attached to ports that are direct members of the Admin Domain. All other fabric
devices are filtered out of the Name Server view for the current Admin Domain. Refer to “Admi n
Domain membership” on page 65 for information about direct and indirect members.
Web Tools Adminstrator’s Guide51
53-1002152-01
Page 80
Displaying the Name Server entries
3
For FICON devices: The Name Server table lists the request node identification (RNID) information.
To display the Name Servers, perform the following steps.
1. Select Tasks > Monitor > Name Server.
The Name Server window displays.
2. To set an autorefresh rate for the Name Server entries, select the Auto Refresh check box in
the Name Server window, and enter an auto-refresh interval (in seconds).
The minimum (and default) interval is 15 seconds.
Printing the Name Server entries
To set up printing preferences, perform the following steps.
1. Select Tasks > Monitor > Name Server.
The Name Server window displays.
2. Click Print.
3. On the Page Setup dialog box, set up your printing preferences and click OK.
The Print dialog box displays.
4. Select a printer and click OK.
Displaying Name Server information for a particular device
To display Name Server information for a particular device, perform the following steps.
1. Select Tasks > Monitor > Name Server.
The Name Server window displays.
2. Select a device from the Domain column.
3. Click Detail View.
The Name Server Information dialog box displays the information specific to that device.
Displaying zone members for a particular device
To display zone members for a particular device, perform the following steps.
1. Select Tasks > Monitor > Name Server.
The Name Server window displays.
2. Select a device from the Domain column.
3. Click Accessible Devices.
The Zone Accessible Devices window displays accessible zone member information specific to
that device.
52Web Tools Adminstrator’s Guide
53-1002152-01
Page 81
Physically locating a switch using beaconing
NOTE
Physically locating a switch using beaconing
Use the Beacon button to physically locate a switch in a fabric. The beaconing function helps to
physically locate a switch by sending a signal to the specified switch, resulting in an LED light
pattern that cycles through all ports for each switch (from left to right).
You must have an RBAC role of admin to initiate switch beaconing. The LED light pattern is initiated
on the actual switch or chassis. It is not mirrored in the Switch View.
To use beaconing, perform the following steps.
1. Select a logical switch using the drop-down list under Fabric Tree section in the Switch Explorer
window.
The selected switch displays in the Switch View.
2. Select Beacon for a switch, or Chassis Beacon for a chassis-based switch.
The LED lights on the actual switch light up on the physical switch in a pattern running back
and forth across the switch itself. In chassis-based switches, the LEDs glow across all the
blades.
3
3. Look at the physical switches in your installation location to identify the switch.
Locating logical switches using chassis beaconing
To locate all logical switches in a chassis, perform the following steps.
1. Select a logical switch using the drop-down list under the Fabric Tree section in the Switch
Explorer window.
The selected switch displays in the Switch View.
2. Click Chassis Beacon.
The LEDs on the logical switch light up on the blades associated with the logical switch.
Virtual Fabrics overview
Virtual Fabrics is an architecture that virtualizes hardware boundaries. Traditionally, SAN design
and management is done at the granularity of a physical switch. Each switch and all the ports in
the switch act as a single fabric element that participates in a single fabric. Virtual Fabrics allows
SAN design and management to be done at the granularity of a port. This enables partitioning of a
physical switch into multiple logical switches, which may be organized into logical fabrics.
The following platforms are Virtual Fabrics-capable:
• Brocade DCX and DCX-4S
• Brocade 5300
• Brocade 5100
• Brocade 6510
• Brocade DCX 8510-4
Web Tools Adminstrator’s Guide53
53-1002152-01
Page 82
Virtual Fabrics overview
3
• Brocade DCX 8510-8
Virtual Fabrics cannot be configured or managed from Web Tools. Configuration and management
is done from either the Brocade Network Advisor, or the Fabric OS command line interface. For
information about configuring and managing Virtual Fabrics, refer to the Brocade Network Advisor User Manual if you are using Brocade Network Advisor, or Fabric OS Administrator’s Guide if you
are using the Fabric OS command line interface.
You can use Web Tools to view Virtual Fabrics and logical switch configurations.
Selecting a logical switch from the Switch View
You can log in to a specific logical switch, as described in Chapter 1, or you can select a logical
switch from the Switch View. If you do not log in to a specific logical switch, you are presented with
the default logical switch.
Under the Switch Information tab, Base Switch, Default Switch, and Allow XISL Use are specific to
VIrtual Fabrics. These options perform these functions:
• Base Switch indicates whether or not the logical switch can act as a base switch. A base switch
is a special logical switch that can be used for chassis interconnection. Each chassis may only
designate only one logical switch as a base switch.
• Default Switch indicates whether or not the logical switch is the default logical switch. The
default logical switch is equivalent to the normal, discovered physical switch topology. It is
automatically assigned fabric ID 128. If you do not log in to a specific logical switch using
Options on the login dialog box, the default logical switch displays in the Switch View.
• Allow XISL Use indicates whether or not the logical switch is allowed to connect to other logical
switches using an extended inter-switch link (XISL). Base switches may use XISLs. Dynamically
created logical switches can use the XISL for traffic, only if Allow XISL Use is enabled through
CLI using the configure command.
To select a logical switch, perform the following steps.
1. Use the Logical Switch selector to select the fabric ID.
You must have the EGM license installed to view the Logical Switch selection on a Brocade
5100, 5300, or VA-40FC. A dialog box displays asking you to confirm your selection.
2. Click Yes to confirm.
The selected logical switch displays. Note that the Logical Switch selector is relocated above
the Switch View.
Viewing logical ports
When base switches are connected through XISLs, a base fabric is formed that includes logical
switches in different chassis. A logical link is formed dynamically among logical switches that have
the same FID to carry frames between the logical switches. Logical ports are created in the
respective switches to support the logical link.
54Web Tools Adminstrator’s Guide
53-1002152-01
Page 83
Virtual Fabrics overview
Logical ports are software constructs, and have no corresponding hardware to represent them on
the Switch View. Logical port information is available in the Port Administration window.
1. Select Port Administration. The Port Administration window displays. Logical ports are
displayed in the FC Ports Explorer tree structure.
2. To view logical port properties, expand the Logical Ports folder, and select a port. The General
properties are displayed.
Keep a backup copy of the configuration file in case the configuration is lost or unintentional
changes are made. You should keep individual backup files for all switches in the fabric. You
should avoid copying configurations from one switch to another.
If you upload from a network, enter the host name or IP address in the Host Name or IP field, the
user ID and password required for access to the host in the User Name and Password fields, and
select the Protocol Type used for the upload. The default is FTP. If you select “Secure Copy Protocol
(SCP),” you cannot specify “anonymous” in the User Name field.
4
An info
link is enabled when USB is chosen as the source of the configuration file. If you click on
info
, the following information message displays (Figure 11).
FIGURE 11Information dialog box
To create a configuration backup file, perform the following task.
1. Open the Switch Administration window.
2. Select Show Advanced Mode.
3. Select the Configure tab.
The Configure screen displays.
4. Select the Upload/Download tab.
The Upload/Download configuration screen displays.
Web Tools Adminstrator’s Guide57
53-1002152-01
Page 86
Restoring a configuration
NOTE
NOTE
4
By default, Config Upload is chosen under Function, and Network is chosen as the source of
the configuration file.
5. Enter the configuration file with a fully-qualified path, or select the configuration file name in
the Configuration File Name field.
If you select USB as the configuration file source, the network parameters are not needed and
are not displayed. You can skip to step 6.
6. Use the Fabric ID selector to select the fabric ID of the logical switch from which the
configuration file is to uploaded.
The selector displays all the virtual fabric IDs that have been defined, the default of 128 for the
physical switch, chassis level configuration, and all chassis and switches.
FIGURE 12Fabric ID selector
If you are using a USB device, it must be connected and mounted before you upload or download.
Refer to “Uploading and downloading from USB storage” on page 60 for more information.
7.C l ic k Apply.
You can monitor the progress by watching the Upload/Download Progress bar.
Restoring a configuration
Restoring a configuration involves overwriting the configuration on the switch by downloading a
previously saved backup configuration file. Perform this procedure during a planned down time.
Make sure that the configuration file you are downloading is compatible with your switch model.
Configuration files from other model switches might cause your switch to fail.
If you download from a network, enter the host name or IP address in the Host Name or IP field, the
user ID and password required for access to the host in the User Name and Password fields, and
select the Protocol Type used for the upload. The default is FTP. If you select “Secure Copy Protocol
(SCP),” you cannot specify “anonymous” in the User Name field.
To restore a configuration, perform the following task.
1. Open the Switch Administration window.
2. Select Show Advanced Mode.
3. Select the Configure tab.
The Configure screen displays.
58Web Tools Adminstrator’s Guide
53-1002152-01
Page 87
Admin Domain configuration maintenance
NOTE
4. Select the Upload/Download tab.
The Upload/Download configuration screen displays. By default, Config Upload is chosen
under Function, and Network is chosen as the source of the configuration file.
5. Under Function, select Config Download to Switch.
If you select USB as the configuration file source, the network parameters are not needed and
are not displayed, and you can skip to step 7.
An info
link is enabled when USB is chosen as the source of the configuration file. If you click
info
, an information message displays.
6. Enter the configuration file with a fully-qualified path, or select the configuration file in the
Configuration File Name field.
7.Use the Fabric ID selector to select the fabric ID of the logical switch to which the configuration
file is to downloaded.
The selector displays all the virtual fabric IDs that have been defined, the default of 128 for the
physical switch, chassis level configuration, and all chassis and switches.
8. Enter the fabric ID of the logical switch in Template Fabric ID.
4
If you are using a USB device, it must be connected and mounted before you upload or download.
Refer to “Uploading and downloading from USB storage” on page 60 for more information.
9. Click Apply.
You can monitor the progress by watching the Upload/Download Progress bar.
Admin Domain configuration maintenance
When you log in to the switch as a physical fabric administrator and back up a configuration, all
local switch configuration parameters are saved, as well as all Admin Domain membership
information and Admin Domain zone databases.
To perform a configuration upload or download, you should have the Admin Domain of AD255 or
AD0, if no other user-defined Admin Domains exist. A configuration upload or download gathers all
the configuration files for the fabric, including Admin Domains. For more information on Admin
Domains, refer to “Requirements for Admin Domains” on page 63.
When the configuration is backed up, one of the following scenarios is possible:
• If the current Admin Domain does not own the switch and you are logged in with any role that
allows configuration upload or download, the following items are saved in the configuration file:
-Local zone configuration
-No other configuration information
• If the current Admin Domain owns the switch and you are logged in with any role that allows
configuration upload or download, the following items are saved in the configuration file:
-Local zone configuration
-All other configuration information except Admin Domain configuration information
Web Tools Adminstrator’s Guide59
53-1002152-01
Page 88
Uploading and downloading from USB storage
NOTE
4
• If you invoke Admin Domain from AD255 and you are logged in with any role that allows
configuration upload/download, the following items are saved in the configuration file:
-Configuration information for zones in all Admin Domains
-All other configuration information, including zoning from all Admin Domains
The filtering depends on the Admin Domain switch ownership, with additional access if you are in
AD255. Access to the command itself is limited by Role-Based Access (RBAC), and not by whether
the current user is a Physical Fabric Administrator or an admin user with enumerated access to the
relevant domains.
The ability to change Admin Domain context requires installing the EGM license. Refer to “Changing
the Admin Domain context” on page 21 for complete instructions.
The EGM license is required only for 8 Gbps platforms, such as the:
• Brocade Encryption Switch
• Brocade 300, 5300, and 5100 switches
• Brocade VA-40FC
• Brocade 8000
• Brocade 7800
For non-8 Gbps platforms, all functionalities are available without the EGM license.
Uploading and downloading from USB storage
If you choose to upload or download from a USB device, you must click the USB port to launch the
USB Port Management wizard.
To update your USB storage, perform the following steps.
1. Select Mount USB Device, and select Yes at the confirmation prompt.
2. Right-click on a configuration file to access Export, Copy, and Search options.
3. Click Copy to upload and Export to download.
Performing a firmware download
During a firmware download, the switch restarts and the browser temporarily loses connection with
the switch. When the connection is restored, the version of the software running in the browser is
different from the new software version that was installed and activated on the switch. You must
close all of the Web Tools windows and log in again to avoid a firmware version mismatch. Note
that for chassis-based switches, you might get popup messages that imply the loss of connection is
temporary and will soon be resolved. You must still close all windows and re-log in.
When you request a firmware download, the system first checks the file size being downloaded. If
the compact flash does not have enough space, Web Tools displays a message and the download
does not occur. If this happens, contact your switch support supplier.
You can perform a firmware download only when the current Admin Domain owns the switch.
60Web Tools Adminstrator’s Guide
53-1002152-01
Page 89
Performing a firmware download
NOTE
NOTE
To download a new firmware version, perform the following steps.
1. Open the Switch Administration window as described in “Opening the Switch Administration
window” on page 33.
2. Select the Firmware Download tab.
3. Choose to download either the firmware or the firmware key.
The download source can be located on the network or a USB device.
When you select the USB button, you can specify only a firmware path or directory name. No
other fields on the tab are available. The USB button is available if the USB is present on the
switch.
4. Enter the host name or IP address, user name, password, and fully-qualified path to the file
release.plist.
You can enter the IP address in either IPv4 or IPv6 format.
where the <directory> is the path up to the entry point of <fos_version_directory> and
<fos_version_directory> is where the unzipped version of Fabric OS is located.
Example
//directory_1/my_directory/v7.0.0/release.plist
5. Select the protocol type in the Protocol Type field.
If you select “Secure Copy Protocol (SCP),” you cannot specify “anonymous” in the User field.
6. Click Apply.
The firmware download begins. You can monitor the progress by looking at the Firmware
Download progress bar.
About halfway through the download process, after the firmware key is downloaded to the
switch, connection to the switch is lost and Web Tools invalidates the current session. Web
Tools invalidates all windows because upfront login is always enabled and cannot be disabled.
7.Close all Web Tools windows and log in again.
If the firmware download is in progress when you log in, you can continue to monitor its
progress.
Using Administrative Domains (Admin Domains or ADs), you can partition the fabric into logical
groups and allocate administration of these groups to different user accounts so that these
accounts manage only the Admin Domains assigned to them and do not make changes to the rest
of the fabric. The ability to assign an Admin Domain to a specific user account is performed in the
User tab of the Switch Administration window and not in the Admin Domain window.
5
You can create domains that are grouped together based on the type of members in the domain.
For example, you can create Admin Domains based on the type of switches in your fabric using the
WWN (not to be confused with the Admin Domain number) or put all the devices in a particular
department in the same Admin Domain for ease of administering those devices.
You can have up to 256 Admin Domains in a fabric (254 user-defined and 2 system-defined),
numbered from 0 through 255. Admin Domains are designated by a name and a number. This
document refers to specific Admin Domains using the format “ADn” where n is a number between
0 and 255.
ADs and Virtual Fabrics are mutually exclusive. Virtual Fabrics must be disabled if you want to use
the AD feature.
Requirements for Admin Domains
The following are the requirements for using administrative domains:
• Admin Domains are supported on fabrics with switches running Fabric OS v5.2.0 or later.
• To manage Admin Domains, you must be a physical fabric administrator. A physical fabric
administrator is a user with the Admin role and access to all Admin Domains (AD0 through
AD255).
• The default zone mode setting must be set to No Access (refer to “Enabling Admin Domains”
on page 65).
Web Tools Adminstrator’s Guide63
53-1002152-01
Page 92
Administrative Domain overview
5
User-defined Admin Domains
AD1 through AD254 are user-defined Admin Domains. These user-defined Admin Domains can be
created only by a physical fabric administrator in AD255.
System-defined Admin Domains
AD0 and AD255 are special Admin Domains and are present in every AD-capable fabric.
AD0
AD0 is a system-defined Admin Domain that, in addition to containing members you explicitly
added (similar to user-defined Admin Domains), it contains all online devices, switches, and switch
ports that were not assigned to any user-defined Admin Domain.
AD0 also implicitly contains all devices from switches running Fabric OS versions earlier than 5.2.0,
as they can never be part of an Admin Domain unless they are upgraded to v5.2.0 or later.
Unlike user-defined Admin Domains, AD0 has both an automatic membership list and a fixed
membership list. User-defined Admin Domains have only a fixed membership list.
• Automatic membership list—Contains all devices and switches that were not assigned to any
other Admin Domain.
• Fixed membership list—Contains all devices and switches that you explicitly add to AD0 and
can be used to force device and switch sharing between AD0 and other Admin Domains.
The Admin Domain window displays the fixed members and not the automatic members, you can
use the View menu to display a list of the automatic members.
AD0 can be managed like any user-defined Admin Domain. The only difference between AD0 and
user-defined Admin Domains is the automatic membership list.
In filtered views, the automatic members of AD0 are considered direct members.
The automatic members of AD0 change dynamically as the membership of other Admin Domains
changes. The fixed members of AD0 are not deleted unless you explicitly remove them.
For example, if you explicitly add DeviceA to AD0 and it is not a member of any other Admin
Domain, then DeviceA is both an automatic and a fixed member of AD0. If you add DeviceA to AD2,
then DeviceA is deleted from the AD0 automatic membership list, but is not deleted from the AD0
fixed membership list. If you then remove DeviceA from AD2, DeviceA is added back to the AD0
automatic membership list (assuming DeviceA is not in any other Admin Domains).
AD0 is useful if you want to share its zone database (called “root zone database”) with a legacy
fabric.
AD255 or physical fabric
AD255 is a virtual domain that contains all devices, switches, and switch ports in the fabric. AD255
presents an unfiltered view of the fabric and is also referred to as the physical fabric.
You can use AD255 to do the following:
• Manage other Admin Domains.
• Get an unfiltered view of the fabric.
• Manage ACL and distribution (this can be managed in AD0 if no other Admin Domains are
present).
64Web Tools Adminstrator’s Guide
53-1002152-01
Page 93
Enabling Admin Domains
NOTE
5
• Manage Advanced Performance Monitoring (this can be managed in AD0 if no other Admin
Domains are present, but only if you are using Web Tools with the EGM license).
The EGM license is required only for 8 Gbps platforms, such as the:
• Brocade Encryption Switch
• Brocade 300, 5300, and 5100 switches
• Brocade VA-40FC
• Brocade 8000
• Brocade 7800
For non-8 Gbps platforms, all functionalities are available without EGM license.
You cannot manage zones with AD255, because AD255 does not have a zone database associated
with it.
Admin Domain membership
Switches, ports, and devices can be members of an Admin Domain. Admin Domain members can
be either direct or indirect members as described below:
• Direct members—Devices, switches, and ports that you explicitly add to an Admin Domain.
Direct members are listed in the Admin Domain membership list.
• Indirect port members—Ports that are implicitly added as part of an Admin Domain when any
of the following occurs:
-A device that is connected to a port was added to the Admin Domain.
-A switch to which the port belongs is a member of the Admin Domain.
• Indirect device members—Devices that are connected to ports that are direct members of an
Admin Domain.
Enabling Admin Domains
The default zone mode setting gives attached devices either All Access to all devices or No Access
to all devices. To begin implementing an Admin Domain structure within a SAN, you must set the
default zone mode to No Access. You must be in AD0 to change the default zone mode. After the
default zone mode is set to No Access, you cannot change it from the physical fabric.
The term “physical fabric” is used in Web Tools only.
Even though the default zone mode access is set to No Access, you can still create and enable
zones within each Admin Domain. These zones are configurable only from the Admin Domain in
which they were created. Indirect port members cannot be zoned.
Web Tools Adminstrator’s Guide65
53-1002152-01
Page 94
Admin Domain window
NOTE
ATTENTION
5
To enable Admin Domains, perform the following steps.
1. Change the Admin Domain context to AD0. Refer to “Changing the Admin Domain context” on
page 21.
Changing the Admin Domain context requires using Web Tools with the EGM license;
otherwise, access to this feature is denied and an error message displays. Change the Default
Zone mode to No Access. Refer to “Setting the default zoning mode” on page 119 for more
information.
2. Navigate to AD255 or the physical fabric and begin managing the Admin Domains.
Admin Domain window
You can view and manage Admin Domains through the Admin Domain window.
If you are not using Web Tools with the EGM licensed installed, managing Admin Domain
operations is denied and an error message displays.
The EGM license is required only for 8 Gbps platforms, such as the:
• Brocade Encryption Switch
• Brocade 300, 5300, and 5100 switches
• Brocade VA-40FC
• Brocade 8000
• Brocade 7800
For non-8 Gbps platforms, all functionalities are available without EGM license.
The Admin Domain window displays information about the Admin Domains that are defined in the
fabric. If you launch the Admin Domain window from AD255 (physical fabric), the window contains
information about the current content of all Admin Domains. If you launch the Admin Domain
window from any other Admin Domain, the window displays the current Admin Domain only.
To manage Admin Domains, you must be logged in with the role of Admin.
Any changes you make in the Admin Domain window are held in a buffered environment and are not saved to persistent storage until you explicitly save the changes. If you close the Admin Domain
window without saving your changes, your changes are lost.
To save the buffered changes you make to persistent storage in the Admin Domain window, refer to
“Saving local Admin Domain changes” on page 68.
When you are logged into AD0, if a physical fabric administrator modifies the AD configuration from
another session, the changes in the membership might not be visible to you.
66Web Tools Adminstrator’s Guide
53-1002152-01
Page 95
Admin Domain window
NOTE
NOTE
NOTE
When you launch the Admin Domain window and select the parent Admin Domains node in the tree
on the left pane, the Admin Domain window displays summary information about all of the Admin
Domains. You can also select a specific Admin Domain from the tree to display detailed information
about that Admin Domain. The detailed view displays summary information as well as information
about the online switch, port, and device members of the selected Admin Domain.
The tree only displays launched switches and their ports. It also displays all the devices in the fabric.
Slot and port information of other switches are not displayed in the tree.
The Admin Domain window has the following buttons in a task bar at the top of the window:
5
• New allows you to create a new Admin Domain.
• Print allows you to print the current or effective configuration.
• Refresh allows you to refresh the information for the entire fabric or a specific Admin Domain.
• Apply allows you to apply a configuration.
• Save allows you to save a configuration.
• Clear allows you to clear the configuration.
You can right-click on any of the table content in the Admin Domain window to access Export, Copy,
and Search options. The options are not available if the table does not have any content.
You must accept the Brocade Certificate at the beginning of the log in to Web Tools to enable the
functionality of Export and Copy.
• Click Export Row or Export Table to save the contents to a tab-delimited file.
• Click Copy Row or Copy Table to copy the contents in tab-delimited text format to a file.
• Click Search to search for a specific text string in the table.
The Switch Members dialog box displays.
In the Switch Members dialog box, enter the text string and press Enter. This is an incremental
search and allows 24 maximum characters including the wildcards question mark (?) and
asterisk (*). The first row containing the text string is highlighted. To find the next match, press
the down arrow. To find the previous match, press the up arrow. If the text is not found in the
table, the text turns red.
Opening the Admin Domain window
Use the Admin Domain window to perform all Admin Domain configuration procedures.
If you want to configure Admin Domains, you must launch the Admin Domain window from the
physical fabric context. If you are in any Admin Domain other than the physical fabric, the module
launches in read-only mode.
The switch must be running Fabric OS v5.2.0 or later.
Web Tools Adminstrator’s Guide67
53-1002152-01
Page 96
Admin Domain window
ATTENTION
5
To open an Admin Domain window, perform the following steps.
1. Select a switch from the Fabric Tree and log in when prompted.
Switch View displays information for the selected switch.
2. If you plan to modify the Admin Domain configuration, from the Admin Domain menu, select
Physical Fabric.
3. Click Admin Domain in the Manage section of the Task s menu.
The Admin Domain window displays.
Refreshing fabric information
When you refresh, the system updates the display of fabric elements only (switches, ports, and
devices). It does not update Admin Domain changes in the Admin Domain window.
This option allows you to refresh the fabric element information displayed at any time.
To refresh the fabric information open the Admin Domain window and click Refresh. The status for
the fabric, including switches, ports, and devices is refreshed.
Refreshing Admin Domain information
Any changes you make in the Admin Domain window are saved to a local buffer. They are not
applied to persistent storage until you invoke one of the transactional operations listed in the
Actions menu.
You can refresh the Admin Domain information at any time to reflect changes that might have been
made by other users or to back out of current, unsaved work and start again.
When you refresh the buffered information in the Admin Domain window, any Admin Domain
configuration changes you made and not yet saved are erased from the buffer and replaced with the
currently enabled Admin Domain information that is saved on the switch.
To update the information in the Admin Domain window with the information saved on the switch,
perform the following steps.
1. In the Admin Domain window, click the Refresh arrow.
2. Click Refresh Admin Domains.
The information in the Admin Domain window is updated with the saved information on the
switch. This action also refreshes the fabric information as described in “Refreshing fabric
information” on page 68. Any unsaved Admin Domain changes are deleted.
Saving local Admin Domain changes
All information displayed and all changes made in the Admin Domain window are buffered until you
save the changes. That means that any other user looking at the Admin Domain information for the
switch does not see the changes you made until you save them.
68Web Tools Adminstrator’s Guide
53-1002152-01
Page 97
Creating and populating domains
To save the local Admin Domain changes, perform the following steps.
1. Select Actions > Save AD Configuration to save your changes to persistent storage as the
defined Admin Domain configuration.
2. Select Actions > Apply AD Configuration to save your changes to persistent storage and make your changes effective in the fabric.
These options are not enabled until you make a change to the Admin Domain configuration.
If another user has an Admin Domain operation in progress at the time that you attempt to save
changes, Web Tools displays a warning to indicate that another Admin Domain transaction is in
progress on the fabric. You can select to abort the other transaction and override it with yours.
This action updates the entire contents of the Admin Domain window, not just the selected Admin
Domain. You can save your changes at any time during the Admin Domain configuration session.
5
Closing the Admin Domain window
It is important to remember that any changes you make in the Admin Domain window are not saved
automatically.
To close the Admin Domain window, perform the following steps.
1. In the Admin Domain window, select File > Close.
If there are changes in the buffer that were not saved, a warning message displays. Confirm
that you want to close the Admin Domain session without saving the changes.
2. Click Yes to close without saving changes, or click No to go back to the Admin Domain window
to save the changes (refer to “Saving local Admin Domain changes” on page 68).
Creating and populating domains
Setting up an Admin Domain involves the following steps.
1. Creating an Admin Domain.
2. Assigning one or more administrators to the Admin Domain.
The Admin account always has access to administer the Admin Domains, even if no other
users are assigned (refer to “Changing user account parameters” on page 180).
When you create an Admin Domain, you can activate the Admin Domain after you finish creating it.
If you activate the Admin Domain, you must click Apply to transfer your changes from the Web Tools
database to the fabric database so that your changes are applied to the fabric. You can log in to an
active Admin Domain. You cannot log in to an Admin Domain that was deactivated.
Creating an Admin Domain
To create an Admin Domain, perform the following steps.
1. Open the Admin Domain window, as described in “Opening the Admin Domain window” on
page 67.
2. Click New.
The Create Admin Domain wizard displays.
Web Tools Adminstrator’s Guide69
53-1002152-01
Page 98
Creating and populating domains
NOTE
NOTE
5
3. In the Name area, assign an Admin Domain name.
You can specify a name or let the system assign the name for you.
4. In the ID area, assign an Admin Domain ID.
You can specify an ID or let the system assign the ID for you.
5. In the State area, select the Active check box to activate the Admin Domain when you finish
creating it.
Clear the Active check box if you want the Admin Domain deactivated when you finish creating
it.
6. Click Next.
7.In t h e Membership area, assign members to the Admin Domain by selecting them in the
Available Members section and clicking Add, Add Ports, or Add Devices as described below:
• Select a switch, port, or device in the Available Members tree and click Add to add the
selected element.
Alternatively, you can press the Insert key to add your selections.
• Select a switch or slot and click Add Ports to add all of the ports in the selected switch or
slot.
• Select a switch, slot, or port and click Add Devices to add all of the devices for the selected
element.
8. Optional: Click Manual to add offline devices.
To add ports or other switches in the fabric, launch the Add Member wizard by clicking the
Manual button.
9. Click Next.
The wizard displays a summary of the Admin Domain. Read the summary to verify that the
Admin Domain setup is correctly.
10. Click Finish to close the wizard.
11. Click Save to save the new Admin Domain configuration to persistent storage.
12. Click Apply to enforce the new Admin Domain configuration as the effective configuration.
Adding ports or switches to the fabric
To add ports or switches to the fabric, perform the following steps.
1. From the Create Admin Domain wizard, click Manual.
The Add Member window displays.
2. Select Port and enter the member ID in the Member field using the Domain Index (D,I) format.
3. Click Apply to enforce the added members, and then click OK to accept the changes.
70Web Tools Adminstrator’s Guide
53-1002152-01
Page 99
Modifying Admin Domain members
ATTENTION
5
Activating or deactivating an Admin Domain
To activate or deactivate an Admin Domain, perform the following steps.
1. Open the Admin Domain window.
2. From the tree on the left, select the Admin Domain you want to activate or deactivate.
3. Click Activate to activate the Admin Domain, or click Deactivate to deactivate the Admin
Domain.
4. Select Actions > Save AD Configuration to save the new Admin Domain configuration to
persistent storage.
5. Select Actions > Apply AD Configuration to enforce the new Admin Domain configuration as the
effective configuration.
When you deactivate an Admin Domain, the members or devices assigned to the domain can
no longer access its hosts or storage unless those devices are part of another Admin Domain.
When you deactivate an Admin Domain, no one can use this Admin Domain to log in to a
switch.
Modifying Admin Domain members
To modify members from an Admin Domain, perform the following steps.
1. Open the Admin Domain window.
2. From the tree on the left, select the Admin Domain you want to modify.
3. Click Modify.
The Modify Admin Domain wizard displays the Membership step.
4. Assign members to the Admin Domain by selecting them in the Available Members section and
clicking Add, Add Ports, or Add Devices as described below:
• Select a switch, port, or device in the Available Members tree and click Add to add the
selected element.
Alternatively, you can press the Insert key to add your selections.
• Select a switch or slot and click Add Ports to add all of the ports in the selected switch or
slot.
• Select a switch, slot, or port, and click Add Devices to add all of the devices for the
selected element.
5. Optional: Click Manual to add offline switches and devices.
6. Remove members from the Admin Domain by selecting them in the Selected Members section
and clicking Remove.
Alternatively, you can press the Delete key to remove selected items.
7.C l ic k Next. Use the summary to verify that the Admin Domain setup is correct.
8. Click Finish.
Web Tools Adminstrator’s Guide71
53-1002152-01
Page 100
Modifying Admin Domain members
NOTE
5
9. Select Actions > Save AD Configuration to save the new Admin Domain configuration to
persistent storage.
10. Select Actions > Apply AD Configuration to enforce the new Admin Domain configuration as the
effective configuration.
Renaming Admin Domains
You can change the name of an Admin Domain, including an auto-assigned ID name. The Admin
Domain name cannot exceed 63 characters and can contain alphabetic and numeric characters.
The only special character allowed is an underscore ( _ ).
You cannot rename AD0 or AD255.
To rename an Admin Domain, perform the following steps.
1. Open the Admin Domain window.
2. From the tree on the left, select the Admin Domain.
3. Click Rename.
4. Enter the new name and click OK.
5. Select Actions > Save AD Configuration to save the new Admin Domain configuration to
persistent storage.
6. Select Actions > Apply AD Configuration to enforce the new Admin Domain configuration as the
effective configuration.
Deleting Admin Domains
When you delete an Admin Domain, its devices no longer have access to the members of the zones
with which it was associated.
To delete an Admin Domain, perform the following steps.
1. Open the Admin Domain window.
2. From the tree on the left, select the Admin Domain.
3. Click Delete.
4. In the confirmation dialog box, click Yes to delete the domain.
The system deletes the Admin Domain.
5. Select Actions > Save AD Configuration to save the new Admin Domain configuration to
persistent storage.
6. Select Actions > Apply AD Configuration to enforce the new Admin Domain configuration as the
effective configuration.
72Web Tools Adminstrator’s Guide
53-1002152-01
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.