Documente Academic
Documente Profesional
Documente Cultură
Fabric OS
Documentation Updates
Supporting Fabric OS v6.4.x
Copyright 2010-2013 Brocade Communications Systems, Inc. All Rights Reserved. ADX, AnyIO, Brocade, Brocade Assurance, the B-wing symbol, DCX, Fabric OS, ICX, MLX, MyBrocade, OpenScript, VCS, VDX, and Vyatta are registered trademarks, and HyperEdge, The Effortless Network, and The On-Demand Data Center are trademarks of Brocade Communications Systems, Inc., in the United States and/or in other countries. Other brands, products, or service names mentioned may be trademarks 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.
European Headquarters Brocade Communications Switzerland Srl Centre Swissair Tour B - 4me tage 29, Route de l'Aroport Case Postale 105 CH-1215 Genve 15 Switzerland Tel: +41 22 799 5640 Fax: +41 22 799 5641 E-mail: emea-info@brocade.com
Document History
Title
Fabric OS Documentation Updates Fabric OS Documentation Updates Fabric OS Documentation Updates Fabric OS Documentation Updates
Date
October 2010 November 2010 February 2011 March 2011
53-1002063-05
April 2011
Title
Fabric OS Documentation Updates
Date
September 2011
53-1002063-07 53-1002063-08
53-1002063-09
August 2012
53-1002063-10
December 2012
53-1002063-11
Added updates for the following: Fabric OS Administrators Guide Fabric OS Command Reference Fabric Watch Administrators Guide
August 2013
iii
iv
Contents
Chapter 1
Chapter 2
Chapter 3
Chapter 4
Chapter 5
Chapter 6
Chapter 7
vi
Chapter 8
Chapter 9
Chapter 10
vii
viii
In this chapter
How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Whats new in this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Brocade resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Document feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ix x x xi
TABLE 1
Publication Title
Access Gateway Administrators Guide CEE Administrators Guide CEE Administrators Guide CEE Command Reference CEE Command Reference Fabric OS Administrators Guide Fabric OS Command Reference Fabric OS Encryption Administrators Guide (LKM) Fabric OS Encryption Administrators Guide (RKM) Fabric OS Encryption Administrators Guide (TEMS) Fabric OS Encryption Administrators Guide (SKM) Fabric OS Encryption Administrators Guide (TKLM) Fibre Channel over IP Administrators Guide Fabric OS Message Reference Fabric OS Troubleshooting and Diagnostics Guide Fabric Watch Administrators Guide FICON Administrators Guide iSCSI Administrators Guide
Page Number
Updates on page 1 Updated on page 3 Updated on page 3 Updates on page 7 Updates on page 7 Updates on page 9 Updated on page 15 No Updates No Updates No Updates No Updates No Updates Updates on page 53 Updates on page 43 No updates Updates on page 49 No updates No updates
Publication Date
March 2010 October 2010 March 2010 September 2010 March 2010 September 2010 April 2012 March 2010 November 2010 March 2010 March 2010 October 2010 March 2010 March 2010 March 2010 March 2010 March 2010 March 2010
ix
TABLE 1
Publication Title
Web Tools Administrators Guide DCX Backbone Hardware Reference Manual DCX-4S Backbone Hardware Reference Manual
Page Number
No updates Updates on page 59 Updates on page 61
Publication Date
March 2010 October 2011 October 2011
For the Fabric Watch Administrators Guide, changed the following: - Added new section to Chapter 6. Fabric, Security, SFP, and Performance Monitoring on
page 51.
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. For practical discussions about SAN design, implementation, and maintenance, you can obtain Building SANs with Brocade Fabric Switches through: http://www.amazon.com For additional Brocade documentation, visit the Brocade SAN Info Center and click the Resource Library location: http://www.brocade.com Release notes are available on the MyBrocade web site and are also bundled with the Fabric OS firmware.
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.
xi
xii
Chapter
In this chapter
The updates in this chapter are for the Access Gateway Administrators Guide, published March 2010.
NOTE
Chapter
In this chapter
The updates in this chapter are for the CEE Administrators Guide, published March 2010 and October 2010.
Documentation updates for Fabric OS v6.4.0 . . . . . . . . . . . . . . . . . . . . . . . . . 3 Documentation updates for Fabric OS v6.4.1 . . . . . . . . . . . . . . . . . . . . . . . . . 4
NOTE
The name used in the cee-map command must begin with a letter, and can consist of letters, digits, hyphens, and underscore characters. Spaces are prohibited. Special characters are not supported, and cause the name to truncate. Under the heading of "Minimum CEE configuration to allow FCoE traffic flow" on page 29, add the following note:
NOTE
The name used in the cee-map command must begin with a letter, and can consist of letters, digits, hyphens, and underscore characters. Spaces are prohibited. Special characters are not supported, and cause the name to truncate.
NOTE
The name used in the cee-map command must begin with a letter, and can consist of letters, digits, hyphens, and underscore characters. Spaces are prohibited. Special characters are not supported, and cause the name to truncate. Under the heading of "Creating a CEE map" on page 107, delete the example under step 2. Under the heading of "Defining a priority group table" on page 107, add the following note:
NOTE
The name used in the cee-map command must begin with a letter, and can consist of letters, digits, hyphens, and underscore characters. Spaces are prohibited. Special characters are not supported, and cause the name to truncate. Under the heading of "Defining a priority group table" on page 107, delete the example under step 4. Under the heading of "Defining a priority-table map" on page 108, add the following note:
NOTE
The name used in the cee-map command must begin with a letter, and can consist of letters, digits, hyphens, and underscore characters. Spaces are prohibited. Special characters are not supported, and cause the name to truncate. Under the heading of "Defining a priority-table map" on page 108, delete the example under step 3. Under the heading of "Applying a CEE provisioning map to an interface on page 110, delete the example under step 3.
NOTE
The name used in the cee-map command must begin with a letter, and can consist of letters, digits, hyphens, and underscore characters. Spaces are prohibited. Special characters are not supported, and cause the name to truncate. Under the heading of "Minimum CEE configuration to allow FCoE traffic flow" on page 29, add the following note:
NOTE
The name used in the cee-map command must begin with a letter, and can consist of letters, digits, hyphens, and underscore characters. Spaces are prohibited. Special characters are not supported, and cause the name to truncate.
NOTE
The name used in the cee-map command must begin with a letter, and can consist of letters, digits, hyphens, and underscore characters. Spaces are prohibited. Special characters are not supported, and cause the name to truncate.
NOTE
The name used in the cee-map command must begin with a letter, and can consist of letters, digits, hyphens, and underscore characters. Spaces are prohibited. Special characters are not supported, and cause the name to truncate. Under the heading of "Creating a CEE map" on page 109, delete the example under step 2. Under the heading of "Defining a priority group table" on page 109, add the following note:
NOTE
The name used in the cee-map command must begin with a letter, and can consist of letters, digits, hyphens, and underscore characters. Spaces are prohibited. Special characters are not supported, and cause the name to truncate. Under the heading of "Defining a priority group table" on page 109, delete the example under step 4. Under the heading of "Defining a priority-table map" on page 110, add the following note:
NOTE
The name used in the cee-map command must begin with a letter, and can consist of letters, digits, hyphens, and underscore characters. Spaces are prohibited. Special characters are not supported, and cause the name to truncate. Under the heading of "Defining a priority-table map" on page 110, delete the example under step 3. Under the heading of "Applying a CEE provisioning map to an interface on page 112, delete the example under step 3.
Chapter
In this chapter
The updates in this chapter are for the CEE Command Reference, published March 2010 and October 2010.
Documentation updates for Fabric OS v6.4.0 . . . . . . . . . . . . . . . . . . . . . . . . . 7 Documentation updates for Fabric OS v6.4.1 . . . . . . . . . . . . . . . . . . . . . . . . . 8
USAGE GUIDELINES
The map name must begin with a letter, and can consist of letters, digits, hyphens, and underscore characters. Spaces are prohibited. Special characters are not supported, and cause the name to truncate.
configure
configure
The description for the Enable 256 Area limit parameter option 1 incorrectly stated that mode 1 was incompatible with domain index zoning. The sentence has been removed. The description of Enable 256 Area limit option 1 now reads: 1 The unique area assignments begin at zero regardless of where the port is physically located. This allows FICON users to make use of high port count port blades with port indexes greater than 256.
USAGE GUIDELINES
The map name must begin with a letter, and can consist of letters, digits, hyphens, and underscore characters. Spaces are prohibited. Special characters are not supported, and cause the name to truncate.
Chapter
In this chapter
The updates in this chapter are for the Fabric OS Administrators Guide, published September 2010.
Documentation updates for Fabric OS v6.4.0 and later . . . . . . . . . . . . . . . . . 9 Documentation Updates for Fabric OS v6.4.1 and later. . . . . . . . . . . . . . . . 13
NOTE
IP fragmentation is not supported on the Brocade 7500 switch or the FR4-18i blade.
ChassisRole is the account access permission at the chassis level. The chassis role allows
the user to execute chassis-related commands in a Virtual Fabrics-enabled environment. Valid chassis roles include the default roles and any of the user-defined roles.
.pem (text)
RPC supports .pem file types. For RPC, the .cer and .crt file types are automatically converted to .pem. In the section Installing a switch certificate on page 125, the example is missing the command. Add the following command line to the beginning of the example:
switch:admin> seccertutil import -config swcert -enable https
Zoning enforcement
Zoning enforcement describes a set of predefined rules that the switch uses to determine where to send incoming data. Fabric OS uses hardware-enforced zoning. Hardware-enforced zoning means that each frame is checked by hardware (the ASIC) before it is delivered to a zone member and is discarded if there is a zone mismatch. When hardware-enforced zoning is active, the Fabric OS switch monitors the communications and blocks any frames that do not comply with the effective zone configuration. The switch performs this blocking at the transmit side of the port on which the destination device is located. There are two methods of hardware enforcement:
10
A zone can contain all WWNs, or all D,I members, or a combination of WWN and D,I members. Frame-based hardware enforcement is in effect if all members of a zone are identified the same way, either using WWNs or D,I notation, but not both. If the zone includes aliases, then the aliases must also be defined the same way as the zone. Session-based hardware enforcement is in effect if the zone has a mix of WWN and D,I members. If a port is in multiple zones, and is defined by WWN in one zone and by D,I in another, then session-based hardware enforcement is in effect.
TI over FCR is supported on an edge switch only in Brocade Native Mode (interopmode 0).
In the section Limitations and restrictions of Traffic Isolation Zoning on page 278, change the fourth bullet item (which is on page 279) to the following:
Two N_Ports that have the same shared area must be configured in the same TI zone. This
limitation does not apply to E_Ports that use the same shared area on the FC4-48 and FC8-48 port blades.
The maximum zone database size is 1 MB and is a combination of the active configuration
size and the defined configuration size. For example, if the active configuration size is 200 KB, then the size of the defined configuration cannot exceed 800 KB.
License
ICL 16-link License, or Inter Chassis Links
Description
Provides dedicated high-bandwidth links between to Brocade DCX chassis, without consuming valuable front-end 8 Gbps ports. Each chassis must have the ICL license installed in order to enable the full 16-link ICL connections (Available on the DCX only). NOTE: It is possible to upgrade an ICL 8-link License on a DCX to an ICL 16-link license by just adding a new ICL 16-link License. In that case, the ICL 8-link License will be retained and will also be displayed when listing licenses for the product. Even though both 8-link and 16-link licenses are present, no more than 16 links per ICL connector are actually enabled.
Add the following sub-section within the Ports on Demand section on page 378:
11
License
Server Application Optimization and ISL Trunking
Fabric mode Top Talker monitors and FC-FC routing are not concurrently supported.
Traffic prioritization is not supported over LSAN zones. The traffic is always medium priority
in the ingress edge fabric, the backbone fabric, and the egress edge fabric. In Fabric OS 6.3.0 and later, QoS is supported with FC-FC routing.
12
N_Port Trunking configurations are between a switch and a Brocade Host Bus Adapter (HBA).
See Configuring N_Port trunking for Brocade adapters and the Brocade Adapters Administrators Guide for more information about configuring this type of trunking. Add the following section at the end of the chapter:
b.
Disable the ports to be used for trunking using the portDisable command.
switch:admin> portdisable 3/40 switch:admin> portdisable 3/41
c.
2. On the host side, enable trunking as described in the Brocade Adapters Administrators Guide. 3. On the switch side, enable the ports using the portEnable command.
switch:admin> portenable 3/40 switch:admin> portenable 3/41
13
14
Chapter
In this chapter
The updates in this chapter are for the Fabric OS Command Reference.
Documentation updates for Fabric OS v6.4.0 . . . . . . . . . . . . . . . . . . . . . . . . 15 Documentation updates for Fabric OS v6.4.1 . . . . . . . . . . . . . . . . . . . . . . . . 28 Documentation updates for Fabric OS v6.4.2 . . . . . . . . . . . . . . . . . . . . . . . . 34 Documentation updates for Fabric OS v6.4.3 . . . . . . . . . . . . . . . . . . . . . . . . 36
ceePortLoopbackTest/portLoopbackTest
The man pages and corresponding pages in the Command Reference should be updated with the following note: This diagnostic cannot be run on an operational switch. You must disable the switch using the chassisDisable command before you can run this test. After the test completes, re-enable the switch using the chassisEnable command. Do not use the switchDisable command followed by manually shutting down the ports before running the test. This will not work because executing switchEnable after the test completes will leave the ports in the same state as before. The only way to bring the ports down before running the test and back up after the test completes is by using the chassisDisable command followed by the chassisEnable command.
passwd
The syntax for the following example has been corrected as follows: To change the password for user "brocadeUser" from an admin account noninteractively:
switch:admin> passwd brocadeUser -old brcdPasswd -new mynewPasswd Password changed. Saving password to stable storage. Password saved to stable storage successfully.
15
perfUserMonitor
perfUserMonitor
The perfUserMonitor valueList parameter must be entered in hexadecimal format. Decimal values are not permitted. Update the parameter description and example as follows:
OPERAND
valueList
Specifies up to four values that need to be captured from the frame contents. The ValueList values must be in hexadecimal notation. SOFx frames are considered special cases. The Offset is specified as 0x0, valueList values are specified with: 0 SOFf 1 SOFc1 2 OFi1 3 SOFn1 4 SOFi2 5 SOFn2 6 SOFi3 7 OFn3
EXAMPLE
To add a filter-based monitor for all Extended Link Service requests (R_CTL=0x22 and TYPE=0x01) to a port:
switch:admin> perfaddusermonitor 1/4 "4, 0xff, 0x22; 0x12, 0xff, 0x01" User monitor #0 added
switchName
A switch name can include up to 30 characters on all platforms running Fabric OS v.6.2.0 or later. On the Brocade 300, 5100, 5300, and 5410 platforms running earlier firmware versions, the switch name can be up to 31 characters long. On all other pre-Fabric OS v6.2.0 platforms, the name is limited to 15 characters. When you configure a switch name with 31 characters on a switch running Fabric OS v 6.1 and upgrade from v6.1.X to v 6.2, the login prompt and switchShow command may still show 31 characters. This inconsistency is harmless and does not cause memory corruption. To resolve the inconsistency, you can take one of the following actions:
Reboot the system after upgrade from v6.1.X to v 6.2. Wait for the switch to reboot and log in after the switch has come back up. The switch name will show only 30 characters. Do a firmware upgrade from v6.2 to 6.3. This upgrade involves a reboot. Wait for the switch to reboot and log in after the switch has come back up. The switch name will show only 30 characters.
The behavior of the switchName command in Fabric OS v 6.4 is the same as in v6.3. Since you cannot upgrade directly to from v6.1.x to v6.4, the issue of switch name inconsistency is not applicable to Fabric OS v6.4.
16
userConfig
userConfig
The userConfig command documentation incorrectly stated a required minimum length. The description of the username parameter has been modified to correct this error. username Specifies the login name of the account to be created or modified. Enter a valid login name to modify an existing account. For new accounts, the name must be unique and must begin with an alphabetic character. User names are case-sensitive and can contain up to 40 alphanumeric characters, including periods (.) and underscore (_) characters.
17
perfClearEEMonitor
perfClearEEMonitor
Clears statistics counters of an end-to-end performance monitors. Synopsis Description perfcleareemonitor [slotnumber/]portnumber [monitorId] Use this command to clear statistics counters for all end-to-end performance monitors on a port, or from an end-to-end monitor associated with a specific monitorId Issuing portStatsClear on a port also results in all end-to-end monitors clearing. This command requires a Brocade Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/Viewport), EX_Port, M (Mirror) ports and GbE ports. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to Chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: slotnumber portnumber monitorId For bladed systems only, specifies the slot number of the port on which the monitor is to be cleared, followed by a slash (/). Specifies the number of the port on which the monitor is to be cleared, relative to its slot for bladed systems. Use switchShow for a list of valid ports. Specify the monitor number to clear. Monitor numbers are defined when created and can be displayed using perfShowEEMonitor. This operand is optional. If not specified, all monitor counters on the port are cleared.
Notes
Examples
See Also
perfMonitorClear, perfhelp
18
perfClearFilterMonitor
perfClearFilterMonitor
Clears counters of one or more filter-based performance monitors. Synopsis Description perfclearfiltermonitor [slotnumber/]portnumber [monitorId] Use this command to clear counters for all filter-based performance monitors on a port or a filter-based monitor associated with a specific monitorId. Issuing portStatsClear on a port also results in all filter-based monitors clearing. Notes This command requires a Brocade Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to Chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: slotnumber portnumber monitorId For bladed systems only, this operand specifies the slot number of the port on which the monitor is to be cleared, followed by a slash (/). Specifies the number of the port on which the monitor is to be cleared, relative to its slot for bladed systems. Use switchShow for a list of valid ports. Specify the monitor number to clear. Monitor numbers are defined when created and can be displayed using perfShowEEMonitor. This operand is optional. If not specified, all monitor counters on the port are cleared.
Optionally, a comma can separate the operands. A space is required to separate the operands even when using commas. Examples To clear statistics counters for a filter-based monitor:
switch:admin> perfclearfiltermonitor 1/2 4 Filter-based monitor number 4 counters are cleared switch:admin> perfclearfiltermonitor 1/2 This will clear ALL filter-based monitors' counters on port 2, continue? (yes, y, no, n): [no] y
See Also
perfMonitorClear, perfHelp
19
perfHelp
perfHelp
Displays performance monitoring help information. Synopsis Description Note perfhelp Use this command to display the help commands available for performance monitoring. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. none To display commands related to performance monitoring:
switch:admin> perfhelp perfAddEEMonitor perfAddIPMonitor perfAddReadMonitor perfAddRWMonitor perfAddSCSIMonitor perfAddUserMonitor perfAddWriteMonitor perfCfgClear perfCfgRestore perfCfgSave perfClearAlpaCrc perfCleareEEmonitor perfClearFilterMonitor perfDelEEMonitor perfDelFilterMonitor perfMonitorClear perfMonitorShow perfresourceshow perfSetPortEEMask perfShowAlpaCrc perfshowEEmonitor perfshowfiltermonitor perfShowPortEEMask PerfTTmon Add end-to-end monitor Add monitor for IP traffic frame count Add filter-based monitor - SCSI Read Add monitor - SCSI Read and Write Add monitor for SCSI frame count Add filter-based monitor Add filter-based monitor - SCSI Write Clear Performance settings from FLASH Restore Performance configuration from FLASH Save Performance configuration to FLASH Clears the CRC error count associated with a port Clears statistics counters of one or more end-to-end performance monitors Clears counters of one or more filter-based performance monitors Delete an end-to-end monitor Delete filter-based monitor Clear end-to-end/filter-based/ISL monitors Show end-to-end/filter-based/ISL monitors Show monitor availability Set overall mask for end-to-end monitors Get ALPA CRC count by port and ALPA Show user-defined end-to-end monitors Show filter-based monitors Show the current end-to-end mask Install Top Talker monitor
Operands Examples
See Also
none
20
perfShowEEMonitor
perfShowEEMonitor
Displays end-to-end performance monitor information on a port. Synopsis Description Notes perfcshoweermonitor [slotnumber/]portnumber [interval] Use this command to display end-to-end monitor information on a port. Refer to perfMonitorShow for details regarding this commands output. Output displays may vary depending on platform. This command requires a Brocade Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to Chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: slotnumber portnumber interval For bladed systems only, this operand specifies the slot number of the port on which the monitor is to be displayed, followed by a slash (/). Specifies the number of the port on which the monitor is to be displayed, relative to its slot for bladed systems. Use switchShow for a list of valid ports. Specify an interval, in seconds (5 or more). Tx and Rx counts are in the unit of bytes when this operand is specified. This operand is optional; if omitted, this command displays cumulative counts.
Examples
The output displays the key, source and destination PID, client application used to add the monitor, client IP address where application is running followed by different counters. CLI shows IPv6 address for OWNER_IP_ADDR field. If the monitor is added using perf CLIs OWNER_IP_ADDR field will display as N/A. When a monitor is created using a telnet application, the IP address continues to display as N/A. To display the EE monitor configured on the switch port 0 using an application that passes an IPV6 address:
switch:admin> perfshoweemonitor 0 There is 1 end-to-end monitor(s) defined on port 0. switch:admin> perfshoweemonitor 0 KEY SID DID OWNER_APP TX_COUNT ----------------------------------------------------18 Fabric OS Documentation Updates 53-1002063-06
21
perfShowEEMonitor
5 perfShowEEMonitor 0 0x112233 0x223344 TELNET 0x00000000000 RX_COUNT CRC_COUNT OWNER_IP_ADDR -----------------------------------------------------0x0000000000000000 0x0000000000000000 N/A To display end-to-end monitor frame traffic on a port at an interval of every 6 seconds: switch:admin> perfshoweemonitor 4/5 6perfshoweemonitor 53, 6: Tx/Rx are # of bytes and crc is # of crc errors 0 1 2 3 4 ------------- ------------- ------------- ------------- ------------crc Tx Rx crc Tx Rx crc Tx Rx crc Tx Rx crc Tx Rx ============= ============= ============= ============= ============= 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 53m 4.9m 0 53m 4.9m 0 53m 4.9m 0 53m 4.9m 0 53m 0 0 53m 4.4m 0 53m 4.4m 0 53m 4.4m 0 53m 4.4m 0 53m 0 0 53m 4.8m 0 53m 4.8m 0 53m 4.8m 0 53m 4.8m 0 53m 0 0 53m 4.6m 0 53m 4.6m 0 53m 4.6m 0 53m 4.6m 0 53m 0 0 53m 5.0m 0 53m 5.0m 0 53m 5.0m 0 53m 5.0m 0 53m 0 0 53m 4.8m 0 53m 4.8m 0 53m 4.8m 0 53m 4.8m 0 53m 0 0 53m 4.5m 0 53m 4.5m 0 53m 4.5m 0 53m 4.5m 0 53m 0 0 52m 4.5m 0 52m 4.5m 0 52m 4.5m 0 52m 4.5m 0 52m 0 [output truncated]
See Also
perfAddEEMonitor, perfHelp
22
perfShowFilterMonitor
perfShowFilterMonitor
Displays all filter-based performance monitors. Synopsis Description Notes perfcshowfiltermonitor [slotnumber/]portnumber [interval] Use this command to display counters for all filter-based performance monitors on the specified port. This command requires a Brocade Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to Chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: slotnumber portnumber interval Examples For bladed systems only, this operand specifies the slot number of the port on which the monitor is to be cleared, followed by a slash (/). Specifies the number of the port on which the monitor is to be displayed, relative to its slot for bladed systems. Use switchShow for a list of valid ports. Specify an interval, in seconds (5 or more). This operand is optional; if omitted, this command displays cumulative counts.
23
perfShowFilterMonitor
See Also
perfMonitorShow, perfHelp
24
fwShow
The fwShow command was deprecated in Fabric OS v6.4.0 along with fwConfigure. Typically, when Brocade announces deprecation of a command for a given Fabric OS release, the commands are still functional and only an announcement is made in the preface. The man pages are kept intact until the commands are removed in the following release. For the fwShow command, the man page was accidentally removed from the printed manual. It is reprinted below.
fwShow
Displays the class thresholds monitored by Fabric Watch. Synopsis Description fwshow [--port --persistence] | [--disable --port] Use this command to display the thresholds monitored by Fabric Watch. This command also displays the port persistence time and ports with all disabled thresholds. For a description of the class thresholds supported in Fabric OS and the restrictions that apply to some of the classes in terms of support for V/VE/VEX ports and GbE ports, refer to the help page for fwConfigure or consult the Fabric Watch Administrator's Guide. In Access Gateway mode, only the following class thresholds are supported. F/FL Port (Copper) class threshold is supported only on Embedded platforms.
TABLE 1
Class
Notes
This command requires a Fabric Watch license. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details.
Operands
The operands are as follows: --port --persistence Displays the time (in seconds) that a port must be persistently in a state before being marked as such. --disable --port Displays the ports that have all associated thresholds disabled.
Examples
25
fwShow
3 : Show port persistence time 4 : Quit Select an item => : (1..4) [3] 1 : Environment class : SFP class : Port class 4 : Fabric class 5 : E-Port class 6 : F/FL Port (Optical) class 7 : Alpa Performance Monitor class 8 : End-to-End Performance Monitor class 9 : Filter Performance Monitor class 10 : Security class 11 : Resource class 12 : Quit Select an item => : (1..12) [12] 1 1 : Temperature 2 : Fan 3 : Power Supply 4 : return to previous page Select an area => : (1..4) [4] 2 ===================================================================== Name Label Last value --------------- -----------------------------------------envFan001 Env Fan 1 2576 RPM envFan002 Env Fan 2 2518 RPM envFan003 Env Fan 3 2481 RPM 1 2 3
switch:user> fwshow 1 : Show class thresholds 2 : Detail threshold information 3 : Show port persistence time 4 : Quit Select an item => : (1..4) [3] 2 Enter Threshold Name : [] envFan001 Env Temperature 1: Monitored for: 1283 (21 mins) Last checked: 10:50:21 on 02/01/2000 Lower bound: Upper bound: Buffer Size: Value history: Disabled? No Locked? No Raw history: 38 38 38 40 C C C TRIGGERED 0 C 75 C 10 33 C
Flags: 0x Counter:
26
fwShow
Argument: 0x00000001 Previous: 0x00000026 (38) Current: 0x00000026 (38) Events: Style: Triggered Event 0 occurred 1 time, last at 16:30:17 on 12/09/2011 Event 1 occurred 10 times, last at 16:49:02 on 12/09/2011 * Event 5 occurred 1 time, last at 16:30:23 on 12/09/2011 Callbacks: No callbacks are registered.
See Also
27
bufOpMode
Changes or displays the Buffer Optimized Mode.
SYNOPSIS
bufopmode --set slot -f bufopmode --reset slot bufopmode --show slot bufopmode --showall
DESCRIPTION
Use this command to display or change the buffer optimized mode on a switch. When buffer optimized mode is enabled on a slot, additional buffers are allocated on the internal ports. Use this feature, if you have slow draining devices connected to the slot and there are no long distance links on that slot. This command can provide more credit flexibility and may help with congestion. However, the full solution to traffic congestion requires the use of monitoring applications such as Fabric Watch, Bottleneck detection, and Port Fencing. You must power off the slot before changing the buffer optimized mode. Changes take effect immediately after the slot is powered on. Enabling buffer optimized mode removes all long distance configurations on that slot. You will be prompted if any long distance configuration is detected.
NOTES
The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. For details on command availability, refer to the Fabric OS Command Reference, Appendix A. This command is only supported only on the Brocade FC8-16, FC8-32, and FC8-48 blades in a DCX or DCX-4S chassis. This command is not supported on CP and core blades.
OPERANDS
This command has the following operands: slot Specifies the slot number. --set Enables buffer optimized mode on the specified slot. This commands prompts for confirmation before removing any long distance configurations on that slot. Use the -f option to execute this command without confirmation. Clears buffer optimized mode on the specified slot. Displays the current buffer optimized mode for the specified slot (On or Off). Displays the current buffer optimized mode for all slots.
28
bufOpMode
EXAMPLES
SEE ALSO
29
portCfgFaultDelay
portCfgFaultDelay
Configures the fault delay for a single FC port.
SYNOPSIS
DESCRIPTION
Use this command to configure the fault delay of an FC port. In the event that the link is noisy after a host power cycle, the switch may go into a soft fault state, which means a delay of R_A_TOV. Setting the mode value to 1 reduces the fault delay value to 1.2 seconds. The configuration is stored in nonvolatile memory and is persistent across switch reboots or power cycle. Use the portCfgShow command to display user-configured fault delay settings.
NOTES
The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to Chapter 1, Using Fabric OS Commands and Appendix A, Command Availability for details. This command is not applicable to non-FC ports.
OPERANDS
This command has the following operands: slot port mode 0 1 ---help For bladed systems only, specifies the slot number of the port to be configured, followed by a slash (/). Specifies the number of the port to be configured, relative to its slot for bladed systems. Use switchShow for a listing of valid ports. Specifies the fault delay value for the port number. This operand is required. Valid values are one of the following: Sets the fault delay to R_A_TOV (default) Sets the fault delay to 1.2 seconds. Displays the command usage.
EXAMPLES
30
portCfgFaultDelay
Ports of Slot 2 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 ---------------+--+--+--+--+---+--+--+--+---+--+--+--+---+--+--+-Speed AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN Fill Word 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 AL_PA Offset 13 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. Trunk Port ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON Long Distance .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. VC Link Init .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. Locked L_Port .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. Locked G_Port .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. Disabled E_Port .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. ISL R_RDY Mode .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. RSCN Suppressed .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. Persistent Disable .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. NPIV capability ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON QOS E_Port AE AE AE AE AE AE AE AE AE AE AE AE .. .. .. .. EX Port .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. Mirror Port .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. Rate Limit .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. Credit Recovery ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON Fport Buffers .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. Port Auto Disable. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. Fault Delay 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 (output truncated)
SEE ALSO
portCfgShow
TABLE 2
Command Name
Zone Admin
O O
Fabric Admin
OM OM
Security Admin
O O
Admin Domain
Context
Switch Type
All All
bufOpMode
OM OM
OM OM
SwitchMember PortMember
VF VF
portCfgFaultDelay O
31
configure
TABLE 6
Field
Default
220
Range
0-500
The description for Edge hold time is as follows: Configures the maximum time a frame can wait after it is received on the ingress port and before it is delivered to the egress port. If the frame waits in the egress buffer for more than the configured hold time, the switch drops the frame, replenishes sender's credit, and increments the counters sts_tx_timeout and er_c3_timeout on the TX and RX ports respectively. The frame-timeout indicates a slow draining or a congestion or bottleneck in the fabric. Decreasing hold time on the Edge switches may reduce frame drop counts in the core switches. This parameter is stored persistently in the configuration file. You can configure Edge hold time only on the default switch: Example: To configure Edge hold time on a disabled switch:
Switch:admin> configure Configure... Fabric parameters (yes, y, no, n): [no] yes Domain: (1..239) [1] R_A_TOV: (4000..120000) [10000] E_D_TOV: (1000..5000) [2000] WAN_TOV: (0..30000) [0] MAX_HOPS: (7..19) [7] Data field size: (256..2112) [2112] Sequence Level Switching: (0..1) [0] Disable Device Probing: (0..1) [0] Suppress Class F Traffic: (0..1) [0] Per-frame Route Priority: (0..1) [0] Long Distance Fabric: (0..1) [0] BB credit: (1..27) [16] Disable FID Check (yes, y, no, n): [no] Insistent Domain ID Mode (yes, y, no, n): [no] Configure edge hold time (yes, y, no, n): [no] Edge hold time: (100..500) [220] Virtual Channel parameters (yes, y, no, n): [no] F-Port login parameters (yes, y, no, n): [no] Zoning Operation parameters (yes, y, no, n): [no] RSCN Transmission Mode (yes, y, no, n): [no] Arbitrated Loop parameters (yes, y, no, n): [no] System services (yes, y, no, n): [no] Portlog events enable (yes, y, no, n): [no] ssl attributes (yes, y, no, n): [no] rpcd attributes (yes, y, no, n): [no] webtools attributes (yes, y, no, n): [no] System (yes, y, no, n): [no]
32
portLoopBackTest
portLoopBackTest
Augment the note section of the portLoopBackTest help pages as follows: This diagnostic cannot be run on an operational switch. You must disable the switch using the chassisDisable command before you can run this test. After the test completes, re-enable the switch using the chassisEnable command. Do NOT use the switchDisable command followed by manually shutting down the ports before running the test. This will not work, because executing switchEnable, after the test completes, will leave the ports in the same state as before. The only way to bring the ports down before running the test and back up after the test completes is by using the chassisDisable command followed by the chassisEnable command
turboRamTest
:Augment the note section of the turboRamTest help pages as follows: This diagnostic cannot be run on an operational switch. You must disable the switch using the chassisDisable command before you can run this test. After the test completes, re-enable the switch using the chassisEnable command.
portLedTest
:Augment the note section of the portLedtestTest help pages as follows: This diagnostic cannot be run on an operational switch. You must disable the switch using the chassisDisable command before you can run this test. After the test completes, re-enable the switch using the chassisEnable command.
33
fruReplace
fruReplace
This command is no longer supported in Fabric OS v6.4.1 and later. Although you can still execute the command, it causes problems and should not be used. It will be removed in v7.0.0. Refer to the WWN Card Remove and Replace Procedure (53-1000832-05) for information on how to replace a WWN card without this command.
SYNTAX
The syntax for added credit recovery support is as follows: bottleneckmon --cfgcredittools -intport -recover [off | onLrOnly | onLrThresh] bottleneckmon--showcredittools
DESCRIPTION
Add the following text to the Description section: Credit recovery on backend ports Use the --cfgcredittools commands to enable or disable credit recovery of external backend ports and to display the configuration. When this feature is enabled, credit is recovered on external backend ports (ports connected to the core blade or core blade backend ports) when credit loss has been detected on these ports. When used with the -recover onLrOnly option, the recovery mechanism takes the following escalating actions:
When it detects credit loss, it performs a link reset and logs a RASlog message (RAS Cx-1014). If the link reset fails to recover the port, the port reinitializes. A RASlog message is generated (RAS Cx-1015). Note that the port reinitialization does not fault the blade. If the port fails to reinitialize, the port is faulted. A RASlog message (RAS Cx-1016) is generated. If a port is faulted and there are no more online backend ports in the trunk, the core blade is faulted. (Note that the port blade will always be faulted). A RASlog message is generated (RAS Cx-1017).
When used with the -recover onLrThresh option, recovery is attempted through repeated link resets and a count of the link resets is kept. If the threshold of more than two link resets per hour is reached, the blade is faulted (RAS Cx-1018). Note that regardless of whether the link reset occurs on the port blade or on the core blade, the port blade is always faulted. For more information on the RASlog messages, refer to the Fabric OS Message Reference.
NOTES
Add the following text to the Notes section: The credit recovery commands are supported only on backend ports of Condor, Condor 2, and Condor 3-based blades in the Brocade 48000, DCX, DCX-4S, DCX 8510-8, and DCX 8510-4 chassis.
34
bottleneckMon
OPERANDS
Add the following text to the Operand Section: Backend port credit recovery commands The following operands support backend port credit recovery: --cfgcredittools -intport Enables credit recovery for internal backend ports. Use one of the following recovery options: -recover onLrOnly Enables the backend port recovery feature in link reset mode. -recover onLrThresh Enables the backend port recovery feature in link reset threshold mode. -recover off Disables the backend port credit recovery feature. --showcredittools Displays the backend port credit recovery configuration as enabled or disabled. In addition, the output indicates whether link reset mode or link reset threshold mode is configured.
EXAMPLES
Add the following text to the example section: backend port credit recovery examples To enable backend port credit recovery with the link reset only option and to display the configuration:
switch:admin> bottleneckmon --cfgcredittools \ -intport -recover onLrOnly switch:admin> bottleneckmon --showcredittools Internal port credit recovery is Enabled with LrOnly
To enable backend port credit recovery with the link reset threshold option and to display the configuration:
switch:admin> bottleneckmon --cfgcredittools -intport \ -recover onLrThresh switch:admin> bottleneckmon --showcredittools Internal port credit recovery is Enabled with LrOnThresh
35
2.
DESCRIPTION
Modify the description section (second paragraph on page 70) as follows: When bottleneck monitoring is enabled on a switch and you specify alerts, the command triggers an SNMP and a RASlog alert when the ports on the configured switch experience a bottleneck. Another alert is sent after the condition resolves. You can configure alerts for latency, for congestion, or both. Modify the description of the alert configuration in the operand section as follows: -alert Enables alerts when configured thresholds are exceeded on the ports that are enabled for bottleneck monitoring. This option enables both congestion and latency alerts. The alerting mechanism is by RASlog and SNMP traps. This operand is optional; if omitted, no alert is assumed. When -alert is specified, you can optionally specify thresholds for congestion, or latency, or both. If -alert is not specified and you try to specify additional parameters, the command fails with an appropriate message.
-alert=congestion Enables congestion alerts only. You can optionally specify a congestion threshold for this type of alert. Latency thresholds are not valid. -alert=latency Enables latency alerts only. You can optionally specify a latency threshold for this type of alert. Congestion thresholds are not valid. -cthresh congestion_threshold Specifies the severity threshold for congestion that triggers an alert. The threshold indicates the percentage of one-second intervals affected by the bottleneck condition within the specified time window. The threshold is expressed as the equivalent fraction between 0 and 1. The default value is 0.8. This parameter is valid only for congestion alerts.
36
bottleneckMon
-lthresh latency_threshold Specifies the severity threshold for latency that triggers an alert. The threshold indicates the percentage of one-second intervals affected by the bottleneck condition within the specified time window. The threshold is expressed as the equivalent fraction between 0 and 1. The default value is 0.1. This parameter is valid only for latency alerts.
EXAMPLES
Add the following examples to the Example section: To enable bottleneck detection on the logical switch with congestion alerts only:
switch:admin> bottleneckmon --enable -alert=congestion
To enable bottleneck detection on the logical switch with latency alerts only:
switch:admin> bottleneckmon --enable -alert=latency
To enable bottleneck detection on the logical switch with both congestion and latency alerts:
switch:admin> bottleneckmon --enable -alert
To change the bottleneck detection configuration on the logical switch to allow congestion alerts only:
switch:admin> bottleneckmon --config -alert=congestion
To change the bottleneck detection configuration on the logical switch to allow latency alerts only:
switch:admin> bottleneckmon --config -alert=latency
To change the bottleneck detection configuration on the logical switch to allow both congestion and latency alerts:
switch:admin> bottleneckmon --config -alert
To change the bottleneck detection configuration on the logical switch to disable all alerts:
switch:admin> bottleneckmon --config -noalert
To change the bottleneck detection configuration on port 5 to allow congestion alerts only; overrides switch-wide configuration:
switch:admin> bottleneckmon --config -alert=congestion 5
To change the bottleneck detection configuration on port 5 to allow latency alerts only; overrides switch-wide configuration:
switch:admin> bottleneckmon --config -alert=latency 5
To change the bottleneck detection configuration on port 5 to allow congestion and latency alerts; overrides switch-wide configuration:
switch:admin> bottleneckmon --config -alert 5
To change the bottleneck detection configuration on port 5 to disable alerts; overrides switch-wide configuration:
switch:admin> bottleneckmon --config -noalert 5
The output of the --status display has been changed to indicate which type of alert is configured. In the section "Switch-wide alerting parameters", the output now displays which type of alert is configured. (Previously it only displayed whether or not alerts were enabled.) In the section "Per-port overrides for alert parameters", the abbreviations "C" and "L" indicate "congestion" and "latency". The meanings of the abbreviations "Y" (both alerts configured) and "N" (no alerts configured) remain unchanged.
37
bottleneckMon
Per-port overrides for alert parameters: ======================================== Port Alerts? LatencyThresh CongestionThresh Time (s) QTime (s) =========================================================================== 1 Y 0.100 0.800 300 300 2 C -0.800 600 600 3 L 0.100 -300 300 4 N -----
DESCRIPTION
Credit recovery on backend ports Use the --cfgcredittools commands to enable or disable credit recovery of external backend ports and to display the configuration. When this feature is enabled, credit is recovered on external backend ports (ports connected to the core blade or core blade backend ports) when credit loss has been detected on these ports. If complete loss of credit on a Condor2 backend port causes frame timeouts, a link reset will be performed on that port regardless of the configured setting, even if that setting is -recover off. When used with the -recover onLrOnly option, the recovery mechanism takes the following escalating actions:
When it detects credit loss, it performs a link reset and logs a RASlog message (RAS Cx-1014). If the link reset fails to recover the port, the port reinitializes. A RASlog message is generated (RAS Cx-1015). Note that the port reinitialization does not fault the blade. If the port fails to reinitialize, the port is faulted. A RASlog message (RAS Cx-1016) is generated. If a port is faulted and there are no more online backend ports in the trunk, the core blade is faulted. (Note that the port blade will always be faulted). A RASlog message is generated (RAS Cx-1017).
When used with the -recover onLrThresh option, recovery is attempted through repeated link resets and a count of the link resets is kept. If the threshold of more than two link resets per hour is reached, the blade is faulted (RAS Cx-1018). Note that regardless of whether the link reset occurs on the port blade or on the core blade, the port blade is always faulted. If you suspect complete credit loss on a particular virtual channel (VC) on a particular backend port, use the -check option to examine that particular backend port and VC for credit loss.
38
bottleneckMon
If the command detects complete credit loss, it reports the information. If, in addition, you have enabled link resets on backend ports, this command will perform a link reset on the link in an attempt to recover from the problem. You must explicitly initiate this check and it is a one-time operation. In other words, this command does not continuously monitor for credit loss in the background. Detection of credit loss takes 2-7 seconds, after which the results of the operation are displayed. A Link Reset also generates a RASlog message.
NOTES
Add the following text to the Notes section: The -check option is supported only on modular switches, and only on Condor 2-Condor 2 links between Condor 2 core blades and Condor 2 port blades. AP blades are not supported.
OPERANDS
Add the following text to the Operand Section: backend port credit recovery commands You can use the -intport option either with the -recover option to configure credit recovery options on a back end port, or you can use it with the -check option to examine a port for credit loss. You cannot use both options at the same time. --cfgcredittools -intport -recover Configures credit recovery options for backend ports. Use one of the following required recovery options to configure credit recovery: onLrOnly Enables the backend port recovery feature in link reset mode. onLrThresh Enables the backend port recovery feature in link reset threshold mode. off Disables the backend port credit recovery feature. Performs the on-demand detection of credit loss on a given backend port and VC. This operand is optional and exclusive; when you specify this option you cannot use the --cfgcredittools -intport -recover options at the same time. You must specify a port and a VC, separated by a comma. A space before the comma is not permitted. slot/blade_port Specifies the backend port that is to be examined for credit loss. The port number must be the blade port number, since this is a backend port. The blade port number can be located in the Bpt column output of the bladeportmap command. Note that the bladeportmap command requires root permissions. Specifies the Virtual Channel number. The valid range is 1 to 31.VC 0 is invalid. --cfgcredittools -intport -check
VC
--linkreset slot/blade_port Performs a link reset on the specified front-end or backend blade port. The blade port number can be located in the "Bpt" column output of the bladePortMap command. The bladeportmap command requires root permissions.
EXAMPLES
Add the following text to the example section: Backend port credit recovery examples To examine a backend port for credit loss:
switch:admin> bottleneckmon --cfgcredittools \ -intport -check 10/4,30 Started Credit loss Detection on slot 10 port 4 VC 30. Please wait.... Detected credit loss. Link Reset performed.
39
fmConfig
fmConfig
This command has been reclassified as an Advanced Performance Monitor (APM) command. It is no longer displayed with the fwHelp command; it is now displayed under perfHelp. Permissions for the operator role have changed. Users with the operator role do not have permission to execute following commands:
fmConfig --create fmconfig --change fmconfig --addmonitor fmconfig --delmonitor fmconfig --delete fmconfig --save fmconfig --clear fmconfig --show fmconfig --help
Users with the operator role are allowed to execute following commands:
serDesTuneMode
This command has been enhanced with new operands to support an automated tuning process to fix CRC errors. The man page has been updated as follows; only the additions are shown below.
NAME SYNOPSIS
Configures and displays SerDes tuning parameters. serdestunemode --autoenable serdestunemode --autodisable serdestunemode --autoreset serdestunemode --autoshow
DESCRIPTION
Use this command to configure and display SerDes values on the Brocade FC8-16 and to control tuning optimization of backend links for all Brocade FC8-xx blades. When used with the --autoset, --autodisable, --autoreset and --autoshow options, this command configures tuning optimization for backend SerDes errors. SerDes tuning optimization is indicated when you receive RASLog errors of type C2-5825 indicating a CRC error with a good EOF. Brocade highly recommends that you contact your service provider if you encounter such errors. If the error appears to be an isolated incident, you may enable auto SerDes tuning for a short period of time (24-48 hours) to see if this resolves the problem. Then disable the function to reduce the risk of resetting register values unnecessarily if single occurrence errors are encountered. If the errors persist contact your service provider.
OPERANDS
Enables SerDes tuning optimization on all backend ports. Disables further tuning optimization but retains all current tuning values identified by the algorithm. Disables further tuning optimization and resets all tuning values back to their default values. If SerDes tune mode or was set, the co figuration is restored. Displays whether SerDes tuning optimization is enabled or disabled.
40
serDesTuneMode
EXAMPLES
To enable SerDes tuning optimization on all backend ports and to display the configuration:
switch:admin> serdestunemode --autoset Autotunemode is turned on switch:admin> serdestunemode --show Autotunemode is turned on
To disable SerDes tuning optimization on all backend ports and retain all current tuning values:
switch:admin> serdestunemode --autodisable Autotunemode is turned off switch:admin> serdestunemode --show Autotunemode is turned off
To disable SerDes tuning optimization on all backend ports and reset all tuning values to their default values:
switch:admin> serdestunemode --autoreset AutoTune Resetting Default Tuning On Next Poll switch:admin> serdestunemode --show Autotunemode is in reset state
41
serDesTuneMode
42
Chapter
In this chapter
Replace and update the chapters as described in the following sections:
New messages, CDR System Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . New message, FCOE System Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . New messages, KAC System Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modified messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
43 44 45 47
The updates are arranged by the chapter names as they appear in the original document.
NOTE
CDR-1007
Message
<timestamp>, [CDR-1007], <sequence-number>,, WARNING, <system-name>, S<slot number>,C<chip index>: Internal link errors have been reported, no hardware faults identified, continuing to monitor for errors: flt1:<fault1_cnt>, flt2:<fault2_cnt> thresh1:0x<threshold_used>.
Indicates some errors found in hardware that may or may not impact data traffic. No action is required. WARNING
CDR-1008
Message
<timestamp>, [CDR-1008], <sequence-number>,, WARNING, <system-name>, S<slot number>,C<chip index>: HW ASIC Chip warning Level 1 type = 0x<chip error type>.
43
CDR-1009
Indicates an internal error in the ASIC hardware that may or may not degrade data traffic. Whenever this error occurs, restart the system at the next maintenance window. WARNING
CDR-1009
Message Probable Cause Recommended Action Severity
<timestamp>, [CDR-1009], <sequence-number>,, WARNING, <system-name>, S<slot number>,C<chip index>: HW ASIC Chip warning Level 2 type = 0x<chip error type>.
Indicates an internal error in the ASIC hardware that may or may not degrade data traffic. Whenever this error occurs, restart the system at the next maintenance window. WARNING
CDR-1010
Message
<timestamp>, [CDR-1010], <sequence-number>,, CRITICAL, <system-name>, S<slot number>,C<chip index>: Internal monitoring of faults has identified suspect hardware, blade may need to be reset or replaced: fault1:<fault1_cnt>, fault2:<fault2_cnt> thresh2:0x<threshold_used>.
Indicates above normal errors observed in hardware that may or may not impact data traffic. Whenever this error is observed persistently, power cycle the faulted blade. If the problem persists, replace the blade. CRITICAL
FCOE-1020
Message Probable Cause Recommended Action Severity
<timestamp>, [FCOE-1020], <sequence-number>,, INFO, <system-name>, Login rejected by FC stack.
Indicates a FLOGI was sent to the FC stack by the FCoE driver but login was rejected by FC stack. No action is required. INFO
44
KAC-1010
Message
<timestamp>, [KAC-1010], <sequence-number>,, ERROR, <system-name>, Putting the KeyID <KeyID> failed to <Keyvault IP Address>. Error code=<Error code>, string=<Error string>.
Indicates that putting the DEK failed to the keyvault. No action is required. ERROR
KAC-1011
Message
<timestamp>, [KAC-1011], <sequence-number>,, ERROR, <system-name>, Putting the dummy DEK to the KV <Keyvault IP Address> failed. Dummy DEK: <Dummy Key Id>, KeyCount: <Key Count>. Error code=<Error code>, string=<Error string>.
Indicates that putting the Dummy failed to keyvault. No action is required. ERROR
KAC-1012
Message
<timestamp>, [KAC-1012], <sequence-number>,, ERROR, <system-name>, Getting the dummy from the KV <Keyvault IP Address> failed. Dummy DEK: <Dummy Key Id>, KeyCount: <Key Count>. Error code=<Error code>, string=<Error string>.
Indicates that getting the Dummy failed from keyvault. No action is required. ERROR
KAC-1013
Message
<timestamp>, [KAC-1013], <sequence-number>,, ERROR, <system-name>, Putting the Actual DEK to the KV <Keyvault IP Address> failed. Actual Key: <Actual Key Id>. Error code=<Error code>, string=<Error string>.
45
KAC-1014
Indicates that putting the Actual DEK failed to keyvault. No action is required. ERROR
KAC-1014
Message
<timestamp>, [KAC-1014], <sequence-number>,, ERROR, <system-name>, Getting the Actual DEK from the KV <Keyvault IP Address> failed. Actual Key: <Actual Key Id>. Error code=<Error code>, string=<Error string>.
Indicates that getting the Actual DEK failed from keyvault. No action is required. ERROR
KAC-1015
Message
<timestamp>, [KAC-1015], <sequence-number>,, ERROR, <system-name>, KAC(<Key Vault Type>) communication Error: Error connecting to <Key Vault IP>. Error code=<Error code>, string=<Error string>.
Indicates that key archival client is unable to communicate with the primary or backup key vault. Change the switch key vault settings and/or ensure that the configured key vault is operational. ERROR
KAC-1016
Message
<timestamp>, [KAC-1016], <sequence-number>,, ERROR, <system-name>, Error : Keyid mismatched in request/response. requested keyid <Key ID in response> and key in response <Requested Key Id>. Error code=<Error code>, string=<Error string>.
Indicates the mismatch of requested key id and key got in response from the Key vault. No action is required. ERROR
46
Modified messages
The probable cause has been modified for the following message in the chapter, FSS System Messages on page 283.
FSS-1009
Message Probable Cause Recommended Action Severity
<timestamp>, [FSS-1009], <sequence-number>, SLOT cp-slot-number | CHASSIS, ERROR, <system-name>, FSS Error: <Error Message>.
Indicates that a Fabric OS state synchronization (FSS) error has occurred for the specified component. The error code is displayed in the message. Run the supportSave command and contact your switch service provider. ERROR The recommended action has been modified for the following message in the chapter, FW System Messages on page 290.
FW-1035
Message
<timestamp>, [FW-1035], <sequence-number>,, WARNING, <system-name>, <Label>, is above high boundary(High=<High value>, Low=<Low value>). Current value is <Value> <Unit>.
Indicates that the temperature of the small form-factor pluggable (SFP) has risen above the high boundary. Frequent fluctuations in temperature might indicate a deteriorating SFP. When other errors such as cyclic redundancy check (CRC) and invalid transmission word (ITW) occur on the port, replace the SFP. WARNING The probable cause and recommended action has been modified for the following message in the chapter, HSL System Messages on page 387.
HSL-1000
Message Probable Cause
<timestamp>, [HSL-1000], <sequence-number>,, CRITICAL, <system-name>, HSL initialization failed.
Indicates a hardware subsystem layer (HSL) initialization failure. This error is caused by other system errors.
47
HSL-1000
Execute the supportFtp command (as needed) to set up automatic FTP transfers; then execute the supportSave command and contact your switch service provider. CRITICAL
48
Chapter
In this chapter
The updates in this chapter are for the Fabric Watch Administrators Guide, published March 2010.
Understanding SNMP basics Loading Brocade MIBs Table 14: SW-MIB Traps
When a counter is in the in-between state, Fabric Watch sends an informational SNMP trap.
(See In-between buffer values on page 50 for an explanation of the concepts of in-between boundaries and high and low thresholds.)
When a counter is above the high threshold or below the low threshold, Fabric Watch sends a
warning SNMP trap except for the power supply area of the environment class, CPU, and memory:
The severity of a Fabric Watch SNMP trap for the power supply area of the environment class will always be informational except when the counter value is below the low threshold. When the counter value of the power supply is below threshold, Fabric Watch sends a warning SNMP trap. The severity of a Fabric Watch SNMP trap for CPU and memory will always be informational.
49
Above high threshold Below high threshold Above low threshold Below low threshold
NOTE
The above low threshold action applies only to the portThConfig command. It does not apply to the thConfig and sysMonitor commands.
Above high threshold Above action = 5 _______________________________________________________________________________ BUFFER = 1 _______________________________________________________________________________ Low action Below high threshold In-between Above low threshold Above action ______________________________________________________________________________ BUFFER ______________________________________________________________________________ Low action Below low threshold
50
The PERFPT area provides threshold values to the user-defined frame type. When a new user-defined frame type is created using the fmMonitor command, the threshold value is automatically based on the PERFPT configuration at the time the frame type is created. In the above example, the high threshold value is 10. Therefore, all frame monitors configured hereafter will have a high threshold value of 10.
51
52
Chapter
In this chapter
The updates in this chapter are for the Fibre Channel over IP Administrators Guide, published March 2010.
IP interface considerations
There may be an issue a tunnel not initiating after creating new IP interfaces (IPIFs) for a 7500 or FR4-18i GbE interface when multiple IPIFs exist for the tunnel on the same GbE interface. This occurs when the received destination IP address falsely appears to be a broadcast address when compared to the first IPIF subnet mask. To avoid this problem, always define IPIFs in order, with the most available host addresses defined first. As an example, if IP subnet 1 has a mask of 255.255.255.0 and subnet 2 has a mask of 255.255.0.0, then the first IPIF defined on a GbE port should be the subnet 2 IPIF (as it is the least restrictive address). This will avoid a false positive check for a broadcast address for any IP address in subnet 1.
In this appendix
FC Fast Write (FCFW) concepts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring and enabling FCFW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Disabling FCFW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Disabling FCFW flows without removing FCFW . . . . . . . . . . . . . . . . . . . . . . .
NOTE
54 56 57 58
Fibre Channel Fast Write is currently only supported by the 7500 switch and FR4-18i blade.
53
FIGURE 1
NOTE
FCFW and FCIP tunnels cannot be used together on the same 7500 or FR4-18i blade.
FCFW disables the local Ethernet ports (ge0 and ge1), making it impossible to configure FCFW
and FCIP tunnels on the same 7500 or FR4-18i blade.
FCFW does not work in FICON environments. FCFW flows may be routed to another 7500 or FR4-18i blade on the FC network. This 7500 or
FR4-18i blade may have active FCIP tunnels over an IP network. FCFW flows may be passed through the FCIP tunnel, but only if the FCIP fastwrite option is disabled on the tunnel.
FCFW does not support loop device configurations for more than one device.
54
1. The initiator sends a write command. 2. The PT responds with a Transfer Ready, enabling the host to send more data. 3. The target device processes the write command, and sends a Transfer Ready to solicit more data. The PI intercepts the Transfer Ready, and begins sending data received from the host. 4. The PI continues to stage data received from the initiator, respond locally to a Transfer Ready, and send the data to the target device until the target device sends an FCP_RSP.
FIGURE 2
FCFW can improve Write performance. Read performance is unaffected. The gains seen from enabling FCFW depend on several factors, including the following:
The size of I/O vs. Transfer Ready. In general, the more times a target device sends a Transfer
Ready, the greater the performance gain.
The number of outstanding I/Os (both Write and Read), link speed, and link congestion. FCFW
may not result in significant improvement if these factors suggest that the write data is delayed because it is sharing bandwidth.
Target response latency - If the target is slow in responding to the write command, the data
must be held by the remote switch.
55
FC ports on both the 7500 switch and the FR4-18i blade are organized into two groups. Ports
0-7 form one group, and ports 8-15 form the other. A maximum of four ports in each group may be configured as FCFW.
The maximum bandwidth available for FCFW is 4 Gbps per group. This bandwidth is shared by
all write flows.
Host initiators and target devices must be directly connected to the 7500 switch or FR4-18i
blade on their respective ends of the ISL. FCFW must be configured and enabled for the ports on both the ends of the flow. Mismatch of the configuration results in I/O failure.
2. Ensure that FCFW is enabled on the switch or blade using the fastwritecfg - -show command. If Fastwrite is not enabled, enable FCFW using the fastwritecfg command. The following example enables FCFW for a blade in slot 3.
switch:admin> fastwritecfg --enable 3 !!!! WARNING !!!! Enabling FC Fastwrite will require powering off and back on the and it may take upto 5 minutes. For non bladed system, the switch will be rebooted. Data traffic will be disrupted. Continue (Y,y,N,n): [ n] y
3. Disable the FC ports that you intend to use for FCFW using the portdisable command. 4. Enable FCFW using the portcfg fastwrite command on the ports you just disabled. The following example enables FCFW on FC port 3 on a blade in slot 3.
portcfg fastwrite 3/3 --enable
5. Enable the zoning configuration established in step 1. 6. Enable the ports that were disabled in step 3. 7. Repeat the steps for the blade or switch on the other end of the FCFW path.
56
8. Allow the hosts and devices to fully log in to the fabric. After the hosts and devices are fully logged in, you can start FCFW I/O. 9. Use the portshow command to verify that FCFW is enabled.
rack1_6a1:root> portshow 3/3 portName: portHealth: HEALTHY Authentication: None portDisableReason: None portCFlags: 0x1 portFlags: 0x20b03 PRESENT ACTIVE F_PORT G_PORT U_PORT LOGICAL_ONLINE LOGIN NOELP ACCEPT portType: 10.0 portState: 1 Online portPhys: 6 In_Sync portScn: 32 F_Port port generation number: 0 portId: 022300 portIfId: 43320004 portWwn: 20:23:00:60:69:80:04:8a portWwn of device(s) connected: 10:00:00:00:c9:2f:68:4d Distance: normal portSpeed: N2Gbps LE domain: 0 FC Fastwrite: ON Interrupts: Unknown: Lli: Proc_rqrd: Timed_out: Rx_flushed: Tx_unavail: Free_buffer: Overrun: Suspended: Parity_err: 2_parity_err: CMI_bus_err:
18 0 12 13 0 0 0 0 0 0 0 0 0
Link_failure: Loss_of_sync: Loss_of_sig: Protocol_err: Invalid_word: Invalid_crc: Delim_err: Address_err: Lr_in: Lr_out: Ols_in: Ols_out:
0 2 4 0 0 0 0 0 2 0 0 2
Frjt: Fbsy:
0 0
Disabling FCFW
To disable FCFW, do the following. 1. Disable the ports that are currently being used for FCFW using the portdisable command. 2. Disable FCFW on the ports you just disabled using the portcfg fastwrite command.
portcfg fastwrite <slot/port> --disable
3. Enable a non-FCFW zoning configuration to remove and replace the fcacc zone that includes the WWNs of the devices that were plugged into the ports you disabled in step 1.
57
4. Enable the ports you disabled in step 1, using the portenable command. 5. Allow the hosts and devices to fully log in to the fabric before starting normal I/O.
58
Chapter
In this chapter
The updates in this chapter are for the Brocade DCX Backbone Hardware Reference Manual, publication number 53-1000685-13, published October 2011
Type of message
WWN unit is being faulted.
Before the subheading Removing the WWN card and WWN bezel (logo plate) on page 74, add the following section:
ATTENTION
Follow ESD precautions (see ESD Precautions in your chassis manual). 1. Open a Telnet session to the chassis and log in to the active CP as admin. The default password is password. 2. Verify that you are logged into the active CP. Run the haShow command to determine the active CP.
59
3. Run the supportsave command on the active CP to capture all settings. 4. Contact Brocade Technical Support for a replacement WWN card. Technical Support will require the supportsave data collected in the previous step so that a replacement can be programmed prior to shipping to your location. DO NOT execute the frureplace command. The command will no longer be functional beginning with the release of Fabric OS 7.0.0c, but users with earlier versions of the Fabric OS should also NOT run the command. Under the subheading Removing the WWN card and WWN bezel (logo plate) on page 82, replace the steps with the following: When the replacement WWN card has been received, complete the following steps to remove the bezel and faulted WWN card.
ATTENTION
Follow ESD precautions (see ESD Precautions in your chassis manual). 1. Open a Telnet session to the chassis and log in to the active CP as admin. The default password is password. 2. Verify that you are logged into the active CP. Run the haShow command to determine the active CP. 3. Run the supportsave command on the active CP to capture all settings. If any problems occur during the replacement, the information will be important for solving the problem. 4. Remove the screws from the WWN bezel. Pull the bezel away from chassis and set it aside. The WWN cards are visible. 5. Use a Phillips screwdriver to unscrew the two screws that secure the WWN card to the chassis. Hold the card by the edges and remove it. 6. Disconnect the WWN cable by depressing the cable connector latch and pulling the connector from the WWN module. 7. Set the WWN card on a static-free surface, such as a grounding pad.
Under the subheading Replacing the WWN bezel (logo plate) and WWN card on page 83, delete step 4.
60
Chapter
10
In this chapter
The updates in this chapter are for the Brocade DCX-4S Backbone Hardware Reference Manual, publication number 53-1001191-09, published October 2011.
Type of message
WWN unit is being faulted.
Before the subheading Removing the WWN card and WWN bezel (logo plate) on page 69, add the following section:
ATTENTION
Follow ESD precautions (see ESD Precautions in your chassis manual). 1. Open a Telnet session to the chassis and log in to the active CP as admin. The default password is password. 2. Verify that you are logged into the active CP. Run the haShow command to determine the active CP.
61
10
3. Run the supportsave command on the active CP to capture all settings. 4. Contact Brocade Technical Support for a replacement WWN card. Technical Support will require the supportsave data collected in the previous step so that a replacement can be programmed prior to shipping to your location. DO NOT execute the frureplace command. The command will no longer be functional beginning with the release of Fabric OS 7.0.0c, but users with earlier versions of the Fabric OS should also NOT run the command. Under the subheading Removing the WWN card and WWN bezel (logo plate) on page 69, replace the steps with the following: When the replacement WWN card has been received, complete the following steps to remove the bezel and faulted WWN card.
ATTENTION
Follow ESD precautions (see ESD Precautions in your chassis manual). 1. Open a Telnet session to the chassis and log in to the active CP as admin. The default password is password. 2. Verify that you are logged into the active CP. Run the haShow command to determine the active CP. 3. Run the supportsave command on the active CP to capture all settings. If any problems occur during the replacement, the information will be important for solving the problem. 4. Remove the screws from the WWN bezel. Pull the bezel away from chassis and set it aside. The WWN cards are visible. 5. Use a Phillips screwdriver to unscrew the two screws that secure the WWN card to the chassis. Hold the card by the edges and remove it. 6. Disconnect the WWN cable by depressing the cable connector latch and pulling the connector from the WWN module. 7. Set the WWN card on a static-free surface, such as a grounding pad.
Under the subheading Replacing the WWN bezel (logo plate) and WWN card on page 70, delete steps 3 and 4.
62