Page 3
Title Publication number Summary of changes Date Fabric OS Documentation Updates 53-1002063-06 Added updates for the Fabric OS September 2011 Administrator’s Guide, Fabric OS Command Reference, Brocade DCX Backbone Hardware Reference Manual, Brocade DCX-4S Backbone Hardware Reference Manual. Fabric OS Documentation Updates 53-1002063-07 Added updates for the Fabric OS December 2011...
Page 4
Fabric OS Documentation Updates 53-1002063-09...
Contents About This Document In this chapter ..........ix How this document is organized .
Page 6
Documentation updates for Fabric OS v6.4.0 and later... 9 Chapter 6, Configuring Protocols ......9 Chapter 7, Configuring Security Policies .
Page 7
Documentation updates for Fabric OS v6.4.0 and v6.4.1 ..49 Appendix A, Fibre Channel Fast Write (FCFW) ....49 In this appendix ........49 FC Fast Write (FCFW) concepts .
Page 8
viii Fabric OS Documentation Updates 53-1002063-09...
TABLE 1 Documentation Supporting Fabric OS 6.4.x Publication Title Fabric OS Release Page Number Publication Date Web Tools Administrator’s Guide v6.4.0 and later No updates March 2010 DCX Backbone Hardware Reference Manual v6.4.0 and later Updates on page 55 October 2011 DCX-4S Backbone Hardware Reference Manual v6.4.0 and later Updates on...
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.
Page 12
Fabric OS Documentation Updates 53-1002063-09...
Chapter Access Gateway Administrator’s Guide In this chapter The updates in this chapter are for the Access Gateway Administrator’s Guide, published March 2010. • Documentation updates for Fabric OS v6.4.1 and later ....1 Documentation updates for Fabric OS v6.4.1 and later Chapter 3, Managing Policies and Features in Access Gateway Mode Under the heading “Trunking in Access Gateway Mode”...
Page 14
Documentation updates for Fabric OS v6.4.1 and later Fabric OS Documentation Updates 53-1002063-09...
Chapter CEE Administrator’s Guide In this chapter The updates in this chapter are for the CEE Administrator’s Guide, published March 2010 and October 2010. • Documentation updates for Fabric OS v6.4.0 ......3 •...
Documentation updates for Fabric OS v6.4.1 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"...
Documentation updates for Fabric OS v6.4.1 Chapter 9, Configuring QoS using the CEE CLI Under the heading of "Creating a CEE map" 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.
Page 18
Documentation updates for Fabric OS v6.4.1 Fabric OS Documentation Updates 53-1002063-09...
Chapter CEE Command Reference 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 •...
Page 20
Documentation updates for Fabric OS v6.4.1 Fabric OS Documentation Updates 53-1002063-09...
Chapter Fabric OS Administrator’s Guide In this chapter The updates in this chapter are for the Fabric OS Administrator’s Guide, published September 2010. • Documentation updates for Fabric OS v6.4.0 and later ....9 •...
Documentation updates for Fabric OS v6.4.0 and later 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.
Documentation updates for Fabric OS v6.4.0 and later License Description ICL 16-link License, or Inter Chassis Links 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).
Documentation Updates for Fabric OS v6.4.1 and later Chapter 18, Optimizing Fabric Behavior In the section “Limitations and restrictions for traffic prioritization” on page 413, delete the following item: • 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.
Page 25
Documentation Updates for Fabric OS v6.4.1 and later Enable the trunk on the ports using the portTrunkArea command. switch:admin> porttrunkarea --enable 3/40-41 -index 296 Trunk index 296 enabled for ports 3/40 and 3/41. 2. On the host side, enable trunking as described in the Brocade Adapters Administrator’s Guide. 3.
Page 26
Documentation Updates for Fabric OS v6.4.1 and later Fabric OS Documentation Updates 53-1002063-09...
Chapter Fabric OS Commands Reference In this chapter The updates in this chapter are for the Fabric OS Command Reference. • Documentation updates for Fabric OS v6.4.0 ......15 •...
Page 28
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.
switchName APM PERFORMANCE MONITORING The following command help pages were accidental deleted from the code and in the v6.4.0 Command reference. These commands are still valid in all v6.x firmware versions. However, the recommendation is to use the more recent commands, perfMonitorShow and perfMonitorClear. Fabric OS Documentation Updates 53-1002063-09...
Page 30
perfClearEEMonitor perfClearEEMonitor Clears statistics counters of an end-to-end performance monitors. Synopsis perfcleareemonitor [slotnumber/]portnumber [monitorId] Description 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.
Page 31
perfClearFilterMonitor perfClearFilterMonitor Clears counters of one or more filter-based performance monitors. Synopsis perfclearfiltermonitor [slotnumber/]portnumber [monitorId] Description 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.
Page 32
perfHelp perfHelp Displays performance monitoring help information. Synopsis perfhelp Description Use this command to display the help commands available for performance monitoring. Note 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"...
Page 33
perfShowEEMonitor perfShowEEMonitor Displays end-to-end performance monitor information on a port. Synopsis perfcshoweermonitor [slotnumber/]portnumber [interval] Description Use this command to display end-to-end monitor information on a port. Refer to perfMonitorShow for details regarding this command’s output. Output displays may vary depending on platform. Notes This command requires a Brocade Advanced Performance Monitoring license.
Page 34
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...
Page 35
perfShowFilterMonitor perfShowFilterMonitor Displays all filter-based performance monitors. Synopsis perfcshowfiltermonitor [slotnumber/]portnumber [interval] Description Use this command to display counters for all filter-based performance monitors on the specified port. 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.
Page 36
perfShowFilterMonitor To display filter monitor information on a port: switch:admin> perfshowfiltermonitor 2/52 There are 7 filter-based monitors defined on port 21. KEY ALIAS OWNER_APP FRAME_COUNT OWNER_IP_ADDR ----------------------------------------------------------------- SCSI_Frame TELNET 0x00000000002c2229 SCSI_WR TELNET 0x000000000000464a SCSI_RW TELNET 0x000000000000fd8c SCSI_RW WEB_TOOLS 0x0000000000007ba3 192.168.169.40 SCSI_RW WEB_TOOLS 0x0000000000004f0e...
Page 37
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.
Page 38
fwShow : Show port persistence time : Quit => : (1..4) [3] 1 Select an item : Environment class : SFP class : Port class : Fabric class : E-Port class : F/FL Port (Optical) class : Alpa Performance Monitor class : End-to-End Performance Monitor class : Filter Performance Monitor class 10 : Security class...
Page 39
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.
Documentation updates for Fabric OS v6.4.1 Documentation updates for Fabric OS v6.4.1 New commands in Fabric OS v6.4.1 Add the following new commands to the Fabric OS Command Reference. bufOpMode Changes or displays the Buffer Optimized Mode. SYNOPSIS bufopmode --set slot -f bufopmode --reset slot bufopmode --show slot bufopmode --showall...
Page 41
bufOpMode EXAMPLES To display the buffer optimized mode for all slots in a chassis: switch:admin> bufopmode --showall Slot 1: buffer optimized mode - Off Slot 2: buffer optimized mode - Off Slot 3: buffer optimized mode - Off Slot 4: buffer optimized mode - Off Slot 9: buffer optimized mode - Off Slot 10: buffer optimized mode - Off Slot 11: buffer optimized mode - Off...
Page 42
portCfgFaultDelay portCfgFaultDelay Configures the fault delay for a single FC port. SYNOPSIS portcfgfaultdelay --enable [slot/]port mode portcfgfaultdelay --help 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.
portCfgFaultDelay Mirror Port F_Port Buffers Fault Delay 1(1.2sec) switch:admin> portcfgshow Ports of Slot 2 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 AL_PA Offset 13 ..
configure Revised commands in Fabric OS v6.4.1 configure A new configurable parameter has been added to the configure command under Fabric Parameters: In Table 6 on page 133 add the following row: TABLE 6 Configure command fabric parameters Field Type Default Range Edge hold time...
Page 45
portLoopBackTest To configure Edge hold time on an enabled switch: Switch:admin> configure Not all options will be available on an enabled switch. To disable the switch, use the "switchDisable" command. Configure... Fabric parameters (yes, y, no, n): [no] yes Configure edge hold time (yes, y, no, n): [no] yes Edge hold time: (100..500) [220] System services (yes, y, no, n): [no] ssl attributes (yes, y, no, n): [no]...
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.
Page 47
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.
Documentation updates for Fabric OS v6.4.3 Documentation updates for Fabric OS v6.4.3 bottleneckMon This command has been enhanced in two ways: Support for more granular alerts: New options have been provided to enable RASlog alerts and SNMP traps for only one kind of bottleneck, latency or congestion, while preserving the existing ability to enable alerts for both kinds of bottleneck.
Page 49
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.
Page 50
bottleneckMon To display the configuration: switch:admin> bottleneckmon --status Bottleneck detection - Enabled ============================== Switch-wide alerting parameters: ============================ Alerts - Congestion only Congestion threshold for alert - 0.800 Averaging time for alert - 300 seconds Quiet time for alert - 300 seconds Per-port overrides for alert parameters: ======================================== Port...
Page 51
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.
Page 52
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: •...
Page 53
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>...
Page 54
serDesTuneMode Fabric OS Documentation Updates 53-1002063-09...
EA DRAFT: BROCADE CONFIDENTIAL Chapter Fabric OS Message Reference In this chapter Replace and update the chapters as described in the following sections: • Documentation updates for Fabric OS v6.4.0 and later ....43 •...
EA DRAFT: BROCADE CONFIDENTIAL CDR-1009 Probable Cause Indicates an internal error in the ASIC hardware that may or may not degrade data traffic. Recommended Whenever this error occurs, restart the system at the next maintenance window. Action Severity WARNING CDR-1009 Message <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>.
EA DRAFT: BROCADE CONFIDENTIAL Chapter 57, KAC System Messages Chapter 57, KAC System Messages Include the following message in the chapter, KAC System Messages on page 412. 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>.
Page 58
EA DRAFT: BROCADE CONFIDENTIAL KAC-1014 Probable Cause Indicates that putting the Actual DEK failed to keyvault. Recommended No action is required. Action Severity 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>.
Chapter Fabric Watch Administrator’s Guide In this chapter The updates in this chapter are for the Fabric Watch Administrator’s Guide, published March 2010. • Documentation updates for Fabric OS v6.4.0 and later ....47 Documentation updates for Fabric OS v6.4.0 and later Chapter 1, Fabric Watch notification types swFabricWatchTrap severity...
Documentation updates for Fabric OS v6.4.0 and later Chapter 2, Fabric Watch Thresholds On page 15 and 16, the sections “High and low thresholds” have been changed to include the following expanded threshold categories: • Above high threshold • Below high threshold •...
Chapter Fibre Channel over IP Administrator’s Guide In this chapter The updates in this chapter are for the Fibre Channel over IP Administrator’s Guide, published March 2010. • Documentation updates for Fabric OS v6.4.0 and v6.4.1 ....49 Documentation updates for Fabric OS v6.4.0 and v6.4.1 The following appendix is added to the Fibre Channel over IP Administrator’s Guide.
Documentation updates for Fabric OS v6.4.0 and v6.4.1 FC Fast Write (FCFW) concepts FCFW operates in Fibre Channel network topologies similar to the basic topology shown in Figure FCFW provides accelerated speeds for SCSI Write operations over long distance Fibre Channel ISLs implemented through the FC-FC Routing Service (FRS) rather than FCIP FIGURE 1 Typical network topology for FCFW...
Page 63
Documentation updates for Fabric OS v6.4.0 and v6.4.1 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.
Documentation updates for Fabric OS v6.4.0 and v6.4.1 • 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.
Documentation updates for Fabric OS v6.4.0 and v6.4.1 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>...
Documentation updates for Fabric OS v6.4.0 and v6.4.1 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. Disabling FCFW flows without removing FCFW If you are running Fabric OS version 6.2.0f, or a later version, you can disable FCFW flows on a single host without removing FCFW on the port.
Chapter Brocade DCX Backbone Hardware Reference Manual 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 • Chapter 5, Removal and Replacement Procedures ....55 Chapter 5, Removal and Replacement Procedures All of the following occurs under the heading “Removal and replacement of the WWN card.”...
Page 68
Chapter 5, Removal and Replacement Procedures 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.
Chapter Brocade DCX-4S Backbone Hardware Reference Manual 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. • Chapter 5, Removal and Replacement Procedures ....57 Chapter 5, Removal and Replacement Procedures All of the following occurs under the heading “Removal and replacement of the WWN card.”...
Page 70
Chapter 5, Removal and Replacement Procedures 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.