Brocade Web Tools User Manual
53-1003169-01
27 June 2014
Web Tools
Administrator's Guide
Supporting Fabric OS v7.3.0
©
2014, Brocade Communications Systems, Inc. All Rights Reserved.
Brocade, the B-wing symbol, Brocade Assurance, ADX, AnyIO, DCX, Fabric OS, FastIron, HyperEdge, ICX, MLX, MyBrocade, NetIron,
OpenScript, VCS, VDX, and Vyatta are registered trademarks, and The Effortless Network and the On-Demand Data Center are trademarks
of Brocade Communications Systems, Inc., in the United States and in other countries. Other brands and product names mentioned may be
trademarks of others.
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. assume no liability or responsibility to any person or entity with respect to the
accuracy of this document or any loss, cost, liability, or damages arising from the information contained herein 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.
Contents
Preface...................................................................................................................................13
Document conventions....................................................................................13
Text formatting conventions................................................................ 13
Command syntax conventions............................................................ 13
Notes, cautions, and warnings............................................................ 14
Brocade resources.......................................................................................... 15
Contacting Brocade Technical Support...........................................................15
Document feedback........................................................................................ 16
About This Document ............................................................................................................. 17
Supported hardware and software.................................................................. 17
What’s new in this document.......................................................................... 18
Introducing Web Tools.............................................................................................................19
Web Tools overview........................................................................................19
Web Tools, the EGM license, and Brocade Network Advisor......................... 19
Web Tools features enabled by the EGM license............................... 20
Web Tools functionality moved to Brocade Network Advisor..............21
System requirements...................................................................................... 23
Setting refresh frequency for Internet Explorer................................... 24
Deleting temporary Internet files used by Java applications............... 25
Java installation on the workstation................................................................ 26
Installing the JRE on your Solaris or Linux client workstation.............26
Installing patches on Solaris............................................................... 26
Installing the Java Plug-in on Windows...............................................27
Java Plug-in configuration...............................................................................27
Enabling Java content in the browser................................................. 27
Configuring the Java Plug-in for Windows.......................................... 27
Configuring the Java Plug-in for Mozilla family browsers....................28
Value line licenses.......................................................................................... 28
Opening Web Tools........................................................................................ 29
Logging in............................................................................................29
Logging out......................................................................................... 32
Role-Based Access Control............................................................................ 32
Session management..................................................................................... 33
Ending a Web Tools session...............................................................33
Web Tools system logs .................................................................................. 33
SupportSave logs............................................................................................34
Requirements for IPv6 support....................................................................... 35
Web Tools Administrator's Guide
53-1003169-01
Using the Web Tools Interface................................................................................................. 37
Viewing Switch Explorer..................................................................................37
Persisting GUI preferences................................................................. 39
Tabs.................................................................................................... 40
Fabric Tree..........................................................................................40
Changing the Admin Domain context..................................................41
Switch View buttons............................................................................ 41
3
Switch View.......................................................................................41
Switch Events and Switch Information..............................................43
Free Professional Management tool................................................. 45
Displaying tool tips........................................................................................ 45
Right-click options.........................................................................................45
Refresh rates.................................................................................................46
Displaying switches in the fabric................................................................... 47
Recommendations for working with Web Tools............................................47
Opening a Telnet or SSH client window....................................................... 48
Collecting logs for troubleshooting................................................................48
Managing Fabrics and Switches............................................................................................ 51
Fabric and switch management overview.....................................................51
Opening the Switch Administration window...................................... 52
Configuring IP and subnet mask information................................................ 53
Configuring Netstat Auto Refresh................................................................. 54
Configuring a syslog IP address................................................................... 54
Removing a syslog IP address......................................................................55
Configuring IP filtering...................................................................................55
Blade management.......................................................................................56
Enabling or disabling a blade............................................................56
Setting a slot-level IP address...........................................................57
Viewing IP addresses........................................................................58
Switch configuration......................................................................................58
Enabling and disabling a switch........................................................58
Enabling and disabling switch persistent.......................................... 58
Changing the switch name................................................................59
Changing the switch domain ID........................................................ 59
Viewing and printing a switch report................................................. 60
Setting a principal switch...................................................................60
Switch restart................................................................................................ 61
Performing a fast boot.......................................................................61
Performing a reboot.......................................................................... 61
System configuration parameters................................................................. 62
WWN-based persistent PID assignment...........................................62
Configuring fabric settings.................................................................63
Enabling insistent domain ID mode...................................................64
Configuring virtual channel settings.................................................. 64
Configuring arbitrated loop parameters............................................ 65
Configuring system services............................................................. 66
Configuring CSCTL QoS mode.........................................................66
Configuring signed firmware............................................................. 66
Licensed feature management..................................................................... 67
Activating a license on a switch........................................................ 67
Assigning slots for a license key....................................................... 67
Removing a license from a switch.....................................................68
Universal time-based licensing......................................................... 68
High Availability overview..............................................................................69
Admin Domain considerations.......................................................... 69
Launching the High Availability window............................................ 69
Synchronizing services on the CP.................................................... 70
Initiating a CP failover....................................................................... 71
Event monitoring........................................................................................... 71
Displaying switch events...................................................................72
Filtering switch events.......................................................................72
Filtering events by event severity levels............................................73
Filtering events by message ID.........................................................73
4
Web Tools Administrator's Guide
53-1003169-01
Filtering events by service component................................................73
Displaying the Name Server entries................................................................74
Printing the Name Server entries........................................................ 74
Displaying Name Server information for a particular device............... 74
Displaying zone members for a particular device............................... 75
Physically locating a switch using beaconing..................................................75
Locating logical switches using chassis beaconing........................................ 75
Virtual Fabrics overview.................................................................................. 76
Selecting a logical switch from the Switch View..................................76
Viewing logical ports........................................................................... 77
Maintaining Configurations and Firmware............................................................................... 79
Creating a configuration backup file................................................................79
Restoring a configuration................................................................................ 80
Admin Domain configuration maintenance..................................................... 81
Uploading and downloading from USB storage.............................................. 82
Performing a firmware download.................................................................... 82
Managing Administrative Domains..........................................................................................85
Administrative Domain overview..................................................................... 85
Requirements for Admin Domains...................................................... 85
User-defined Admin Domains............................................................. 85
System-defined Admin Domains.........................................................86
Admin Domain membership................................................................87
Enabling Admin Domains................................................................................87
Admin Domain window....................................................................................87
Opening the Admin Domain window................................................... 89
Refreshing fabric information.............................................................. 89
Refreshing Admin Domain information............................................... 89
Saving local Admin Domain changes..................................................90
Closing the Admin Domain window.....................................................90
Creating and populating domains................................................................... 90
Creating an Admin Domain................................................................. 91
Adding ports or switches to the fabric................................................. 91
Activating or deactivating an Admin Domain.......................................92
Modifying Admin Domain members................................................................ 92
Renaming Admin Domains................................................................. 93
Deleting Admin Domains.....................................................................93
Clearing the Admin Domain configuration...........................................93
Web Tools Administrator's Guide
53-1003169-01
Managing Ports.......................................................................................................................95
Port management overview............................................................................ 95
Opening the Port Admin tab................................................................95
Port Admin tab components................................................................96
Controllable ports................................................................................ 99
Configuring FC ports....................................................................................... 99
Allowed port types.............................................................................100
Speed................................................................................................101
Long distance mode..........................................................................101
Ingress rate limit................................................................................101
Available buffer credit calculation......................................................103
Assigning a name to a port........................................................................... 103
Port beaconing.............................................................................................. 103
Enabling and disabling a port........................................................................104
Considerations for enabling or disabling a port.................................104
5
Persistent enabling and disabling ports...................................................... 105
Configuring NPIV ports............................................................................... 106
Port activation............................................................................................. 106
Enabling Ports on Demand............................................................. 108
Enabling Dynamic Ports on Demand.............................................. 108
Disabling Dynamic Ports on Demand............................................. 108
Diagnostic ports.............................................................................. 109
Reserving and releasing licenses on a port basis...........................109
Port swapping index....................................................................................110
Port swapping................................................................................. 110
Determining if a port index was swapped with another switch
port............................................................................................ 111
Configuring port binding..............................................................................112
Unbinding a port..............................................................................113
Configuring BB credits on an F_Port.......................................................... 113
Configuring ALPA .......................................................................................114
Configuring port octet speed combination ................................................. 115
Configuring CSCTL.....................................................................................116
Enabling CSCTL mode................................................................... 117
Disabling CSCTL mode...................................................................117
Configuring compression and encryption....................................................117
Enabling or disabling encryption..................................................... 118
Enabling or disabling compression................................................. 118
Displaying compression ratio.......................................................... 118
Forward Error Correction............................................................................ 119
In-Band Management..................................................................................119
GigE port modes......................................................................................... 120
Enabling ISL Trunking......................................................................................................... 121
ISL Trunking overview.................................................................................121
Disabling or enabling ISL Trunking ............................................................ 121
Admin Domain considerations........................................................ 122
Viewing trunk group information................................................................. 122
F_Port trunk groups.................................................................................... 123
Creating and maintaining F_Port trunk groups............................... 123
Monitoring Performance..................................................................................................... 125
Performance Monitor overview................................................................... 125
Basic monitoring .............................................................................125
Advanced monitoring...................................................................... 125
Performance graphs........................................................................126
Admin Domain considerations........................................................ 126
Predefined performance graphs..................................................... 126
User-defined graphs........................................................................129
Canvas configurations.....................................................................129
Opening the Performance Monitor window.................................................130
Creating basic performance monitor graphs...............................................130
Customizing basic monitoring graphs......................................................... 131
Advanced performance monitoring graphs................................................. 133
Creating SID/DID Performance graphs...........................................133
Creating the SCSI vs. IP Traffic graph............................................134
Creating SCSI command graphs.................................................... 134
Tunnel and TCP performance monitoring graphs.......................................135
Tunnel and TCP graph chart properties..........................................136
Saving graphs to a canvas..........................................................................136
Adding graphs to an existing canvas.......................................................... 137
6
Web Tools Administrator's Guide
53-1003169-01
Printing graphs.............................................................................................. 137
Modifying graphs...........................................................................................137
Administering Zoning............................................................................................................139
Zoning overview............................................................................................ 139
Basic zones.......................................................................................139
Traffic Isolation zones....................................................................... 139
LSAN zone requirements.................................................................. 139
QoS zone requirements.................................................................... 140
Zoning configurations ...................................................................................140
Opening the Zone Admin window..................................................... 140
Setting the default zoning mode........................................................140
Zoning management..................................................................................... 141
Refreshing fabric information............................................................ 144
Refreshing Zone Administration window information........................ 144
Saving local zoning changes.............................................................145
Selecting a zoning view.....................................................................145
Creating and populating zone aliases............................................... 146
Adding and removing members of a zone alias................................ 146
Renaming zone aliases.....................................................................147
Deleting zone aliases........................................................................ 147
Creating and populating zones......................................................... 148
Adding and removing members of a zone........................................ 148
Renaming zones............................................................................... 149
Cloning zones................................................................................... 149
Deleting zones.................................................................................. 149
Creating and populating enhanced Traffic Isolation zones............... 150
Zone configuration and zoning database management................................ 151
Creating zone configurations............................................................ 151
Adding or removing zone configuration members.............................152
Renaming zone configurations..........................................................152
Cloning zone configurations..............................................................153
Deleting zone configurations.............................................................153
Enabling zone configurations............................................................ 153
Disabling zone configurations........................................................... 154
Displaying enabled zone configurations............................................154
Viewing the enabled zone configuration name without opening
the Zone Administration window..................................................155
Viewing detailed information about the enabled zone configuration. 155
Adding a WWN to multiple aliases and zones.................................. 155
Removing a WWN from multiple aliases and zones......................... 156
Replacing a WWN in multiple aliases and zones..............................156
Searching for zone members............................................................ 157
Clearing the zoning database........................................................... 157
Zone configuration analysis.............................................................. 157
Best practices for zoning...............................................................................158
Web Tools Administrator's Guide
53-1003169-01
Working with Diagnostic Features..........................................................................................159
Trace dumps................................................................................................. 159
How a trace dump is used.................................................................159
Setting up automatic trace dump transfers....................................... 160
Specifying a remote server............................................................... 160
Enabling automatic transfer of trace dumps......................................160
Disabling automatic trace uploads.................................................... 160
Displaying switch information........................................................................161
Viewing detailed fan hardware status............................................... 162
7
Viewing the temperature status.......................................................162
Viewing the power supply status.....................................................163
Checking the physical health of a switch........................................ 163
Defining switch policy..................................................................................165
Port LED interpretation................................................................................166
Port icon colors............................................................................... 166
Using the FC-FC Routing Service......................................................................................... 167
Fibre Channel Routing overview.................................................................167
Supported switches for Fibre Channel Routing.......................................... 168
Setting up FC-FC routing............................................................................ 168
FC-FC routing management....................................................................... 169
Opening the FC Routing module.................................................... 169
Viewing and managing LSAN fabrics..............................................170
Viewing EX_Ports....................................................................................... 170
Configuring an EX_Port.............................................................................. 171
Editing the configuration of an EX_Port.......................................... 171
Configuring FCR router port cost................................................................ 172
Viewing LSAN zones...................................................................................172
Viewing LSAN devices....................................................................172
Configuring the backbone fabric ID.............................................................173
Using the Access Gateway...................................................................................................175
Access Gateway overview.......................................................................... 175
Viewing Switch Explorer for Access Gateway mode.................................. 175
Access Gateway mode .............................................................................. 176
Restricted access in the Port Admin tab......................................... 176
Enabling Access Gateway mode................................................................ 177
Disabling Access Gateway mode................................................................177
Viewing the Access Gateway settings........................................................ 178
Port configuration........................................................................................178
Editing a Port...................................................................................178
Creating port groups....................................................................... 179
Editing or viewing port groups.........................................................180
Deleting port groups........................................................................181
Defining custom primary F-N port mapping.................................... 181
Defining custom static F-N port mapping........................................181
Defining custom WWN-N port mappings........................................ 182
Access Gateway policy modification...........................................................182
Path Failover and Failback policies.................................................182
Modifying Path Failover and Failback policies................................ 182
Enabling the Automatic Port Configuration policy.......................................183
Administering Fabric Watch................................................................................................ 185
Fabric Watch overview................................................................................185
Administering Extended Fabrics.......................................................................................... 187
Extended link buffer allocation overview.....................................................187
Configuring a port for long distance............................................................ 189
Routing Traffic.................................................................................................................... 191
Routing overview.........................................................................................191
8
Web Tools Administrator's Guide
53-1003169-01
Viewing fabric shortest path first routing....................................................... 192
Configuring dynamic load sharing.................................................................193
Lossless dynamic load sharing......................................................... 193
Specifying frame order delivery.....................................................................194
Configuring the link cost for a port................................................................ 194
Configuring Standard Security Features.................................................................................197
User-defined accounts.................................................................................. 197
Virtual Fabrics considerations........................................................... 198
Admin Domain considerations.......................................................... 198
Viewing user account information..................................................... 199
Creating user-defined accounts........................................................ 199
Deleting user-defined accounts.........................................................202
Changing user account parameters ................................................. 202
Maintaining passwords......................................................................204
User-defined roles.........................................................................................206
Guidelines and restrictions................................................................206
Creating a user-defined role..............................................................207
Editing a user-defined role................................................................ 208
Access control list policy configuration..........................................................209
Virtual Fabrics considerations........................................................... 209
Admin Domain considerations.......................................................... 209
Creating an SCC, DCC, or FCS policy..............................................209
Editing an SCC, DCC, or FCS policy................................................ 210
Deleting all SCC, DCC, or FCS policies............................................210
Activating all SCC, DCC, or FCS policies......................................... 210
Distributing an SCC, DCC, or FCS policy......................................... 211
Moving an FCS policy switch position...............................................211
Configuring Advanced Device Security policy ..................................211
Fabric-Wide Consistency Policy configuration.............................................. 212
Authentication policy configuration................................................................213
Configuring authentication policies for E_Ports................................ 213
Configuring authentication policies for F_Ports.................................213
Distributing authentication policies....................................................214
Re-authenticating policies................................................................. 214
Setting a shared secret key pair........................................................214
Modifying a shared secret key pair................................................... 215
Setting the Switch Policy Authentication mode................................. 215
SNMP configuration...................................................................................... 215
Setting SNMP trap levels.................................................................. 215
Changing the systemGroup configuration parameters......................216
Setting SNMPv1 configuration parameters....................................... 216
Setting SNMPv3 configuration parameters....................................... 216
Changing the access control configuration....................................... 217
RADIUS management...................................................................................217
Enabling and disabling RADIUS....................................................... 218
Configuring RADIUS......................................................................... 218
Modifying the RADIUS server........................................................... 219
Modifying the RADIUS server order..................................................219
Removing a RADIUS server............................................................. 220
Active Directory service management...........................................................220
Enabling Active Directory service......................................................220
Modifying Active Directory service.................................................... 221
Removing Active Directory service................................................... 221
TACACS+ management................................................................................221
Enabling and disabling TACACS+.................................................... 221
Configuring TACACS+...................................................................... 222
Web Tools Administrator's Guide
53-1003169-01
9
Modifying TACACS+....................................................................... 222
Removing TACACS+...................................................................... 222
IPsec concepts............................................................................................223
Transport mode and tunnel mode...................................................224
IPsec header options...................................................................... 224
Basic IPsec configurations..............................................................225
Internet Key Exchange concepts.................................................... 226
IPsec over management ports.................................................................... 228
Enabling the Ethernet IPsec policies ............................................. 228
Establishing an IKE policy...............................................................229
Creating a security association....................................................... 229
Creating an SA proposal.................................................................230
Adding an IPsec transform policy....................................................230
Adding an IPsec selector................................................................ 231
Manually creating an SA................................................................. 231
Editing an IKE or IPsec policy.........................................................232
Deleting an IKE or IPsec policy.......................................................232
Establishing authentication policies for HBAs.............................................233
Administering FICON CUP Fabrics....................................................................................... 235
FICON CUP fabrics overview......................................................................235
Enabling port-based routing........................................................................236
Enabling or disabling FICON Management Server mode...........................237
FMS parameter configuration......................................................................237
Configuring FMS mode parameters................................................238
Displaying code page information...............................................................239
Viewing the control device state................................................................. 239
Allow / Prohibit Matrix configuration............................................................240
Viewing Allow / Prohibit Matrix configurations.................................241
Modifying Allow / Prohibit Matrix configurations..............................241
Activating an Allow / Prohibit Matrix configuration.......................... 242
Copying an Allow / Prohibit Matrix configuration.............................243
Deleting an Allow / Prohibit Matrix configuration.............................243
CUP logical path configuration....................................................................243
Viewing CUP logical path configurations........................................ 243
Configuring CUP logical paths........................................................ 244
Link Incident Registered Recipient configuration........................................244
Viewing Link Incident Registered Recipient configurations............ 244
Configuring LIRRs...........................................................................244
Displaying Request Node Identification Data .............................................245
10
Configuring FCoE with Web Tools.........................................................................................247
Web Tools and FCoE overview...................................................................247
Web Tools, the EGM license, and Brocade Network Advisor.....................247
Port information that is unique to FCoE.......................................... 248
Switch administration and FCoE.................................................................248
FCoE configuration tasks............................................................................249
Quality of Service configuration.................................................................. 249
Editing the DCB map.......................................................................249
Adding a traffic class map...............................................................250
LLDP-DCBX configuration.......................................................................... 250
Configuring global LLDP characteristics......................................... 251
Adding an LLDP profile................................................................... 252
Configuring DCB interfaces.........................................................................253
Configuring a link aggregation group ......................................................... 254
Configuring VLANs......................................................................................254
Web Tools Administrator's Guide
53-1003169-01
Configuring FCoE login groups..................................................................... 255
Displaying FCoE port information................................................................. 256
Displaying LAG information...........................................................................257
Displaying VLAN information........................................................................ 257
Displaying FCoE login groups.......................................................................257
Displaying QoS information...........................................................................257
Displaying LLDP-DCBX information..............................................................257
Displaying DCB interface statistics............................................................... 258
Configuring a DCB interface from the Switch View.......................................258
Configuring a DCB interface from the Port Admin panel...............................258
Enabling and disabling a LAG.......................................................................259
Enabling and disabling LLDP........................................................................ 259
Enabling and disabling QoS priority-based flow control................................259
Enabling and disabling FCoE ports...............................................................260
Limitations........................................................................................................................... 261
General Web Tools limitations...................................................................... 261
Index.................................................................................................................................... 267
Web Tools Administrator's Guide 11
53-1003169-01
12 Web Tools Administrator's Guide
53-1003169-01
Preface
● Document conventions....................................................................................................13
● Brocade resources.......................................................................................................... 15
● Contacting Brocade Technical Support...........................................................................15
● Document feedback........................................................................................................ 16
Document conventions
The document conventions describe text formatting conventions, command syntax conventions, and
important notice formats used in Brocade technical documentation.
Text formatting conventions
Text formatting conventions such as boldface, italic, or Courier font may be used in the flow of the text
to highlight specific words or phrases.
Format
bold text
italic text
Courier font
Description
Identifies command names
Identifies keywords and operands
Identifies the names of user-manipulated GUI elements
Identifies text to enter at the GUI
Identifies emphasis
Identifies variables and modifiers
Identifies paths and Internet addresses
Identifies document titles
Identifies CLI output
Identifies command syntax examples
Command syntax conventions
Bold and italic text identify command syntax components. Delimiters and operators define groupings of
parameters and their logical relationships.
Convention
bold text Identifies command names, keywords, and command options.
italic text Identifies a variable.
Description
Web Tools Administrator's Guide 13
53-1003169-01
Notes, cautions, and warnings
Convention Description
value In Fibre Channel products, a fixed value provided as input to a command
[ ] Syntax components displayed within square brackets are optional.
option is printed in plain text, for example, --show WWN.
Default responses to system prompts are enclosed in square brackets.
{ x | y | z } A choice of required parameters is enclosed in curly brackets separated by
x | y A vertical bar separates mutually exclusive elements.
< > Nonprinting characters, for example, passwords, are enclosed in angle
...
\
vertical bars. You must select one of the options.
In Fibre Channel products, square brackets may be used instead for this
purpose.
brackets.
Repeat the previous element, for example, member[member...].
Indicates a “soft” line break in command examples. If a backslash separates
two lines of a command input, enter the entire command at the prompt without
the backslash.
Notes, cautions, and warnings
Notes, cautions, and warning statements may be used in this document. They are listed in the order of
increasing severity of potential hazards.
NOTE
A Note provides a tip, guidance, or advice, emphasizes important information, or provides a reference
to related information.
ATTENTION
An Attention statement indicates a stronger note, for example, to alert you when traffic might be
interrupted or the device might reboot.
CAUTION
A Caution statement alerts you to situations that can be potentially hazardous to you or cause
damage to hardware, firmware, software, or data.
DANGER
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.
14 Web Tools Administrator's Guide
53-1003169-01
Brocade resources
Visit the Brocade website to locate related documentation for your product and additional Brocade
resources.
You can download additional publications supporting your product at www.brocade.com. Select the
Brocade Products tab to locate your product, then click the Brocade product name or image to open the
individual product page. The user manuals are available in the resources module at the bottom of the
page under the Documentation category.
To get up-to-the-minute information on Brocade products and resources, go to MyBrocade. You can
register at no cost to obtain a user ID and password.
Release notes are available on MyBrocade under Product Downloads.
White papers, online demonstrations, and data sheets are available through the Brocade website.
Contacting Brocade Technical Support
Brocade resources
As a Brocade customer, you can contact Brocade Technical Support 24x7 online, by telephone, or by email. Brocade OEM customers contact their OEM/Solutions provider.
Brocade customers
For product support information and the latest information on contacting the Technical Assistance
Center, go to http://www.brocade.com/services-support/index.html.
If you have purchased Brocade product support directly from Brocade, use one of the following methods
to contact the Brocade Technical Assistance Center 24x7.
Online Telephone E-mail
Preferred method of contact for nonurgent issues:
• My Cases through MyBrocade
• Software downloads and licensing
tools
• Knowledge Base
Required for Sev 1-Critical and Sev
2-High issues:
• Continental US: 1-800-752-8061
• Europe, Middle East, Africa, and
Asia Pacific: +800-AT FIBREE
(+800 28 34 27 33)
• For areas unable to access toll
free number: +1-408-333-6061
• Toll-free numbers are available in
many countries.
support@brocade.com
Please include:
• Problem summary
• Serial number
• Installation details
• Environment description
Brocade OEM customers
If you have purchased Brocade product support from a Brocade OEM/Solution Provider, contact your
OEM/Solution Provider for all of your product support needs.
• OEM/Solution Providers are trained and certified by Brocade to support Brocade® products.
• Brocade provides backline support for issues that cannot be resolved by the OEM/Solution Provider.
Web Tools Administrator's Guide 15
53-1003169-01
Document feedback
• Brocade Supplemental Support augments your existing OEM support contract, providing direct
access to Brocade expertise. For more information, contact Brocade or your OEM.
• For questions regarding service levels and response times, contact your OEM/Solution Provider.
Document feedback
To send feedback and report errors in the documentation you can use the feedback form posted with
the document or you can e-mail the documentation team.
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. You can provide feedback in two ways:
• Through the online feedback form in the HTML documents posted on www.brocade.com.
• By sending your feedback to documentation@brocade.com.
Provide the publication title, part number, and as much detail as possible, including the topic heading
and page number if applicable, as well as your suggestions for improvement.
16 Web Tools Administrator's Guide
53-1003169-01
About This Document
● Supported hardware and software.................................................................................. 17
● What’s new in this document.......................................................................................... 18
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.3.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 5431
• Brocade 5450
• Brocade 5460
• Brocade 5470
• Brocade 5480
• Brocade 6505
• Brocade M6505
• Brocade 6510
• Brocade 6520
• Brocade 6547
• Brocade 7800 Extension Switch
• Brocade 7840 Extension Switch
• Brocade DCX 8510-4 Backbone
• 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
Web Tools Administrator's Guide
53-1003169-01
17
What’s new in this document
• Brocade FC16-32 port blade
• Brocade FC16-48 port blade
• Brocade FC16-64 port blade
• Brocade FC8-16 port blade
• Brocade FC8-32 port blade
• Brocade FC8-32E port blade
• Brocade FC8-48 port blade
• Brocade FC8-48E port blade
• Brocade FC8-64 port blade
• Brocade FS8-18 encryption blade
• Brocade FX8-24 extension blade
What’s new in this document
The following additions and enhancements have been made since this document was last released:
• In-Band Management is not supported in Fabric OS v7.3.0.
• MaximumCommunicationRate and MinimumCommunicationRate is changed to Mbps from Kbps.
• Auto Max speed configuration is supported for all platforms.
• Secure File Transfer Protocol (SFTP) is supported for firmware download, configuration upload, and
configuration download.
• Available and recommended buffer credit calculation support in FC Port Configuration and
Extended Fabric tab.
• Beginning with Fabric OS v7.3.0, Non DFE is supported in Port Admin.
For further information, refer to the release notes.
18 Web Tools Administrator's Guide
53-1003169-01
Introducing Web Tools
● Web Tools overview........................................................................................................19
● Web Tools, the EGM license, and Brocade Network Advisor......................................... 19
● System requirements...................................................................................................... 23
● Java installation on the workstation................................................................................ 26
● Java Plug-in configuration...............................................................................................27
● Value line licenses.......................................................................................................... 28
● Opening Web Tools........................................................................................................ 29
● Role-Based Access Control............................................................................................ 32
● Session management..................................................................................................... 33
● Web Tools system logs .................................................................................................. 33
● SupportSave logs............................................................................................................34
● Requirements for IPv6 support....................................................................................... 35
Web Tools overview
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 on
page 19 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. Web Tools
features enabled by the EGM license on page 20 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, 5300, and 7800 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. Web Tools functionality moved to Brocade Network Advisor on page 21
summarizes these changes.
Web Tools Administrator's Guide
53-1003169-01
19
Web Tools features enabled by the EGM license
Web Tools features enabled by the EGM license
The following table describes those Web Tools features that require the EGM license.
Basic Web Tools features and EGM licensed features TABLE 1
Feature Basic Web Tools Web Tools with EGM License
Active Directory support yes yes
AD Context Switching no yes
AD filtered views yes yes
Admin Domain Management no yes
AG Management yes yes
Analyze zone config no no
Basic Zoning and TI Zoning yes yes
Blade Management yes yes
Cloning a zone no yes
Configuration upload/download yes yes
Convenience function from Tools menu no no
Device Accessibility Matrix no no
Easy to configure iSCSI wizard yes yes
Extended Fabric Management no yes
F_Port Trunk Management no yes
Fabric Events no no
Fabric Summary no no
Fabric Tree yes yes
FCIP Tunnel configuration no no
FCIP Tunnel Display yes yes
FCR Management yes yes
FCR Port Config yes yes
FICON CUP Tab no yes
20 Web Tools Administrator's Guide
53-1003169-01
Web Tools functionality moved to Brocade Network Advisor
Basic Web Tools features and EGM licensed features (Continued)TABLE 1
Feature Basic Web Tools Web Tools with EGM License
FRU Monitoring yes yes
High Availability yes yes
IP Sec Policies yes yes
ISL Trunk Management no yes
ISL Trunking information yes yes
License Management yes yes
Long Distance no yes
Logical Switch Context Switching no yes
Allow/Prohibit Matrix no yes
Performance Monitoring dialog box no yes
Port Administration yes yes
Print zone database summary no no
RBAC yes yes
Routing and DLS Configuration no yes
Security Policies Tab (like ACL) yes yes
Switch Info tab yes yes
Switch Status yes yes
Switch View right-click options yes yes
Trace dump yes yes
USB Management yes yes
User Management yes yes
Verify and troubleshoot accessibility between devices yes yes
Web Tools functionality moved to Brocade Network Advisor
The functionality that was moved from Web Tools into Brocade Network Advisor is detailed in the
following table.
Web Tools Administrator's Guide 21
53-1003169-01
Introducing Web Tools
Web Tools functionality moved to Brocade Network Advisor TABLE 2
Function Web Tools 6.1.0 Brocade Network Advisor Comments
Add Un-Zoned
Devices
Analyze Zone
Config
Define Device Alias Zone Admin Configure > Zoning
Device Accessibility
Matrix
Fabric Events Monitor > Fabric Events Monitor > Logs > Events
Zone Admin Configure > 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.
Zone Admin 1. Configure > 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.
2. Device 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 Admin Configure > Zoning 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.
Fabric Summary Reports > Fabric Summary Monitor > Reports > Fabric
FCIP Tunnel
Configuration
GigE Ports
Interface
GigE Ports Route Port Admin Module > GigE
Non-local switch
ports display in
zoning tree
Port Admin Module > GigE
tab
Port Admin Module > GigE
tab
tab
Zone AdminAdmin
DomainSwitch Admin >
DCC policiesPerformance
Monitoring
Summary Report
Configure > FCIP Tunnel Viewing FCIP
Configure > FCIP Tunnel
Configure > FCIP Tunnel
Configure > Zoning In Web Tools,
tunnels is still
supported in Web
Tools for Fabric
OS v6.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.
22 Web Tools Administrator's Guide
53-1003169-01
System requirements
Web Tools functionality moved to Brocade Network Advisor (Continued)TABLE 2
Function Web Tools 6.1.0 Brocade Network Advisor Comments
Remove Offline or
Inaccessible
Devices
Zone database
summary print
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 4.0, JavaScript 1.0, and JRE 1.7.0_55 update
or later.
NOTE
If there are multiple JRE versions installed, go to the Java Control Panel and uncheck the lower JRE
versions for Web Tools to launch using the latest JRE version.
Brocade has certified and tested Web Tools on the platforms shown in the following table.
Zone Admin Configure > Zoning Replace/Replace
All zone members by selecting the
offline devices from the zone tree.
Offline devices have an unknown
overlay badge with good visibility.
Zone Admin Configure > Zoning Zoning report for
both online and offline database.
Certified and tested platforms TABLE 3
Operating System Browser
Windows Server 2008 (SP2) Standard (32-bit) Firefox 26.0, Internet Explorer 9.0, Chrome 33
Windows 8.1 Enterprise (32-bit) Firefox 26.0, Internet Explorer 10.0/11.0, Chrome 33
Windows 2012 R2 Firefox 26.0, Internet Explorer 11.0, Chrome 33
Windows 7 Service Pack 1 (SP1) Firefox 26.0, Internet Explorer 9.0/10.0/11.0, Chrome 33
SUSE Linux Enterprise Server 11.3 Firefox 26.0
Windows Server 2008 R2 (SP1) Enterprise (64-bit) Firefox 26.0, Internet Explorer 9.0/10.0, Chrome 33
Windows Server 2012 Standard (64-bit) Firefox 26.0, Internet Explorer 10.0/11.0, Chrome 33
Red Hat Enterprise Linux 6.3 Advanced Platform (64-bit) Firefox 26.0
Red Hat Enterprise Linux 6.5 Advanced Platform (64-bit) Firefox 26.0
Oracle Enterprise Linux 6.5 Platform (64-bit) Firefox 26.0
Web Tools Administrator's Guide 23
53-1003169-01
Setting refresh frequency for Internet Explorer
Brocade supports the platforms shown in the following table.
Supported platformsTABLE 4
Operating System Browser
Red Hat AS 4.0 (x86 32-bit)
Red Hat Enterprise Linux 6.1 Adv (32-bit)
Red Hat Enterprise Server 5 Advanced Platform
SUSE Linux Enterprise Server 10 (32-bit)
SUSE Linux Enterprise Server 11 (x86 32-bit)
SUSE Linux Enterprise Server 11 (SP2) (32-bit) Firefox 26.0
Windows 2000 Firefox 12.0, Internet Explorer 9.0
Windows 2003 Server, SP2 Firefox 12.0, Internet Explorer 8.0/9.0
Windows XP Pro SP3 (x86 32-bit) Firefox 12.0, Internet Explorer 8.0/9.0
Windows Server 2003 Standard SP2 (x86 32-bit) Firefox 12.0, Internet Explorer 8.0/9.0
Windows Server 2008 Standard Firefox 12.0, Internet Explorer 8.0/9.0
Windows Server 2008 R2 Standard (64-bit) Internet Explorer 8.0, 9.0
Windows 7 Professional (x86) Firefox 12.0
Windows 8 Firefox 12.0, Internet Explorer 8.0/9.0/10.0
Solaris 9 (SPARC only)
Solaris 10 (SPARC only)
Firefox 12.0
Firefox 12.0
Oracle Enterprise Linux 6.1 (x86 32-bit) Firefox 12.0
For Windows systems, a minimum of 512 MB of RAM for fabrics comprising up to 15 switches, 1 GB
of RAM for fabrics comprising more than 15 switches, or a DCX with a fully populated blade, and a
minimum of 8 MB of video RAM are recommended.
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 > Browsing History > Settings.
3. Choose Every time I visit the webpage under Check for newer versions of stored pages as
shown in the following figure.
24 Web Tools Administrator's Guide
53-1003169-01
FIGURE 1 Configuring Internet Explorer
Deleting temporary Internet files used by Java applications
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.
Web Tools Administrator's Guide 25
53-1003169-01
Java installation on the workstation
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.
If you attempt to open Web Tools with a later version of Java Plug-in installed:
• 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 install JRE on your Solaris or Linux client workstation, perform the following steps.
1. Locate the JRE on the Internet, at the following URL:
http://www.oracle.com/technetwork/java/archive-139210.html
NOTE
This URL points to a non-Brocade website and is subject to change without notice.
2. On locating the JRE link, follow the instructions to install the JRE.
3. Create a symbolic link from this location:
$FIREFOX/plugins/libjavaplugin_oji.so
To this location:
$JRE/plugin/$ARCH/ns600/libjavaplugin_oji.so
Installing patches on Solaris
To install patches on Solaris, perform the following steps.
1. Search for any required patches for your current version of the JRE at the following website:
http://www.oracle.com/technetwork/java/javase/downloads/jre7u9-downloads-1859586.html
NOTE
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.
26 Web Tools Administrator's Guide
53-1003169-01
Installing the Java Plug-in on Windows
To Install the Java Plug-in on Windows, perform the following steps.
1. From the Start menu, select Control Panel and select the Java 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.
• If no Java Plug-in is installed, point the browser to a switch running Fabric OS 7.0.0 or later to
install JRE 1.7.0. 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 7.0.0 or later to install JRE 1.7.0. 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-ofmemory 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.
Installing the Java Plug-in on Windows
Enabling Java content in the browser
Launching Web Tools from a browser or Brocade Network Advisor is done using Java Web Start
technology. This requires the local system's web browser to be able to run Java web start applications.
This setting may have been turned off in the wake of recent Java zero-day vulnerabilities.
To turn on Java content in the browser, perform the following steps.
1. Launch Java Control Panel.
2. Click the Security tab and select the Enable Java content in the browser check box.
3. Click Apply.
When the Windows User Account Control (UAC) dialog box displays, allow permissions to make
the changes.
4. Click OK in the Java Plug-in confirmation window.
You can now enter the IP address of the switch and launch Web Tools from a 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 Control Panel > Java.
2. Click the Java tab.
3. In the Java Applet Runtime Settings section, click View.
Web Tools Administrator's Guide 27
53-1003169-01
Configuring the Java Plug-in for Mozilla family browsers
The Java Runtime Environment Settings dialog box displays.
4. Double-click the 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 OK to apply your settings and close the Java Control Panel.
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 Control Panel.
2. Click the Advanced tab and expand the Default Java for browsers option, as shown in the
following figure.
FIGURE 2 Default Java for browsers option
3. Select Mozilla family and click Apply .
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
28 Web Tools Administrator's Guide
53-1003169-01
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 earlier or later 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.
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.3.0, refer to System requirements on page 23. Web Tools
supports both HTTP and HTTPS.
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
Opening Web Tools
https://10.77.77.77
2. Press Enter.
The Web Tools login dialog box displays. Refer to Logging in on page 29 for more information.
NOTE
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.
NOTE
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 the
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 guide describes only the Web Tools interface.
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.
Web Tools Administrator's Guide 29
53-1003169-01
Logging in to a Virtual Fabric
When you are presented with the login window, 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.
NOTE
You must log in before you can view Switch Explorer (shown in Figure 4 on page 39).
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 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 7800
• Brocade 7840
• Brocade DCX and DCX-4S
• Brocade VA-40FC
• Brocade 6510
• Brocade 6520
• Brocade DCX 8510-8 and DCX 8510-4
• Brocade 5300
• Brocade 5100
• Brocade 5432
• Brocade 6548
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 Logical Fabric as
shown in the following figure. Home Logical Fabric is the default.
30 Web Tools Administrator's Guide
53-1003169-01
Loading...