Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates...

48
53-1003412-09 4 April 2017 ® Fabric OS Documentation Updates Supporting Fabric OS v7.3.x

Transcript of Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates...

Page 1: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

53-1003412-094 April 2017

®

Fabric OSDocumentation Updates

Supporting Fabric OS v7.3.x

Page 2: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

©2017, Brocade Communications Systems, Inc. All Rights Reserved.

Brocade, Brocade Assurance, the B-wing symbol, ClearLink, DCX, Fabric OS, HyperEdge, ICX, MLX, MyBrocade, OpenScript, VCS, VDX, Vplane, and Vyatta are registered trademarks, and Fabric Vision is a trademark 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 others.

Notice: This document is for informational purposes only and does not set forth any warranty, expressed or implied, concerning any equipment, equipment feature, or service offered or to be offered by Brocade. Brocade reserves the right to make changes to this document at any time, without notice, and assumes no responsibility for its use. This informational document describes features that may not be currently available. Contact a Brocade sales office for information on feature and product availability. Export of technical data contained in this document may require an export license from the United States government.

The authors and Brocade Communications Systems, Inc. assume no liability or responsibility to any person or entity with respect to the accuracy of this document or any loss, cost, liability, or damages arising from the information contained herein or the computer programs that accompany it.

The product described by this document may contain open source software covered by the GNU General Public License or other open source license agreements. To find out which open source software is included in Brocade products, view the licensing terms applicable to the open source software, and obtain a copy of the programming source code, please visit http://www.brocade.com/support/oscd.

Brocade Communications Systems, Incorporated

Document History

Corporate and Latin American HeadquartersBrocade Communications Systems, Inc.130 Holger WaySan Jose, CA 95134 Tel: 1-408-333-8000 Fax: 1-408-333-8101 E-mail: [email protected]

Asia-Pacific HeadquartersBrocade Communications Systems China HK, Ltd.No. 1 Guanghua RoadChao Yang DistrictUnits 2718 and 2818Beijing 100020, ChinaTel: +8610 6588 8888Fax: +8610 6588 9999E-mail: [email protected]

European HeadquartersBrocade Communications Switzerland SàrlCentre SwissairTour B - 4ème étage29, Route de l'AéroportCase Postale 105CH-1215 Genève 15Switzerland Tel: +41 22 799 5640Fax: +41 22 799 5641E-mail: [email protected]

Asia-Pacific HeadquartersBrocade Communications Systems Co., Ltd. (Shenzhen WFOE)Citic PlazaNo. 233 Tian He Road NorthUnit 1308 – 13th FloorGuangzhou, ChinaTel: +8620 3891 2000Fax: +8620 3891 2111E-mail: [email protected]

Title Publication number Summary of changes Date

Fabric OS Documentation Updates 53-1003412-01 Updates for the following:• Fabric OS Command Reference• Fabric OS Encryption

Administrator’s Guide• Fabric OS FIPS Configuration Guide• Fabric OS Message Reference• Fabric OS MIB Reference• Web Tools Administrator’s Guide

April 2015

Fabric OS Documentation Updates 53-1003412-02 Updates for the following:• EZSwitchSetup Administrator’s

Guide• Fabric OS Command Reference• Web Tools Administrator’s Guide

October 2015

Fabric OS Documentation Updates 53-1003412-03 Updates for the following:• Fabric OS Command Reference• Fabric OS Message Reference

January 2016

Page 3: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Fabric OS Documentation Updates 53-1003412-04 Updates for the following:• Fabric OS Command Reference

February 2016

Fabric OS Documentation Updates 53-1003412-05 Updates for the following:• Fabric OS Message Reference

March 2016

Fabric OS Documentation Updates 53-1003412-06 Updates for the following:• Fabric OS Command Reference

April 2016

Fabric OS Documentation Updates 53-1003412-07 Updates for the following:• Fabric OS Command Reference

July 2016

Fabric OS Documentation Updates 53-1003412-08 Updates for the following:• Fabric OS Message Reference

October 2016

Fabric OS Documentation Updates 53-1003412-09 Updates for the following:• Fabric OS Message Reference

April 2017

Title Publication number Summary of changes Date

Page 4: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation
Page 5: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Contents

About This Document

In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

What’s new in this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Brocade Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Document feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Chapter 1 Access Gateway Administrator’s Guide

Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . . . . . 11

Chapter 2 Fabric OS Command Reference

Documentation Updates for Fabric OS v7.3.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13portcmd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13portshow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13ficoncupset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Documentation Updates for Fabric OS v7.3.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14bottleneckmon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14configure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14configurechassis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14firmwaredownload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15fmmonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15fosconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15framelog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15mapsconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15portcfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15portledtest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16seccertutil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16sfpshow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16snmpconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Documentation Updates for Fabric OS v7.3.0a1. . . . . . . . . . . . . . . . . . . . . . . . . . 17seccryptocfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17syslogadmin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Documentation Updates for Fabric OS v7.3.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Chapter 3 Fabric OS Encryption Administrator’s Guide

Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . . . . . 25

Fabric OS Documentation Updates 553-1003412-09

Page 6: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Chapter 4 Fabric OS FCIP Administrator’s Guide

Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . . . . . 27

Chapter 5 Fabric OS Software Licensing Guide

Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . . . . . 29

Chapter 6 Fabric OS Troubleshooting and Diagnostics Guide

Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . . . . . 31

Chapter 7 Fabric OS Upgrade Guide

Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . . . . . 33Installing and Maintaining Firmware- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 33

Chapter 8 FICON Administrator’s Guide

Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . . . . . 35

Chapter 9 Web Tools Administrator’s Guide

Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . . . . . 37Chapter 1, Introducing Web Tools - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 37

Chapter 10 FIPS Configuration Guide

Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . . . . . 39

Chapter 11 Fabric OS Message Reference

Documentation updates for Fabric OS 7.3.0 and 7.3.1 . . . . . . . . . . . . . . . . . . . . 41Updates to Chapter 1, Introduction to System Messages - - - - - - - - - - - - - - - 41

Updates to Chapter 5, Fabric OS System Messages - - - - - - - - - - - - - - - - - - - 42

FV-3014. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Documentation updates for Fabric OS 7.3.1 and later . . . . . . . . . . . . . . . . . . . . . 42

Chapter 12 Fabric OS MIB Reference

Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . . . . . 43Chapter 6, SW-MIB Objects - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 43

Chapter 19, BD MIB Objects - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 46

Chapter 13 EZSwitchSetup Administrator’s Guide

Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . . . . . 47Chapter 1, Introducing EZSwitchSetup - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 47

6 Fabric OS Documentation Updates53-1003412-09

Page 7: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

About This Document

In this chapter

•How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

•What’s new in this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

•Brocade Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

•Document feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

How this document is organized

This document contains updates to the Fabric OS 7.3.x product manuals: These updates include document fixes and changes covering new features. The following table lists the most recently released Fabric OS 7.3.x product manuals as of the date of this document. Refer to mybrocade.com for the posted versions of these documents.

TABLE 1 Documentation Supporting Fabric OS v7.3.x

Publication Title Fabric OS Release Page Number/Version ID Publication Date

FICON Administrator’s Guide v7.3.0 53-1003144-02 August 2014

Access Gateway Administrator’s Guide v7.3.0 53-1003126-02 August 2014

Fabric OS Troubleshooting and Diagnostics Guide v7.3.0 53-1003141-02Update on page 31

August 2014

Fabric OS Upgrade Guide v7.3.0 53-1003240-02Update on page 33

August 2014

FCIP Administrator’s Guide v7.3.0 53-1003138-03 September 2014

Monitoring and Alerting Policy Suite Administrator’s Guide v7.3.0 53-1003147-03 September 2014

Fabric OS Administrator’s Guide v7.3.0 53-1003130-04 October 2014

Flow Vision Administrator’s Guide v7.3.0 53-1003168-05 November 2014

Fabric OS Command Reference v7.3.0v7.3.0a1

Update on page 14 January 2016

v7.3.2 Update on page 23 February 2016

v7.3.0 53-1003147-07Update on page 15

July 2016

Fabric OS Encryption Administrator’s Guide v7.3.0 Update on page 25 April 2015

Web Tools Administrator’s Guide v7.3.0 53-1003169-03Update on page 37

September 2014

Fabric OS FIPS Configuration Guide v7.3.0a1 Update on page 39 April 2015

Fabric OS Documentation Updates 753-1003412-09

Page 8: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

What’s new in this documentThe following documents are no longer updated in this publication, as they are now published as complete updates. Please refer to mybrocade.com for the most recent versions of these documents. This includes all documents for Fabric OS 7.3.2.

• Fabric OS Administrator’s Guide

• Monitoring and Alerting Policy Suite Administrator’s Guide

• Fabric Watch Administrator’s Guide

• Fabric OS Software Licensing Guide

• Fabric OS FIPS Configuration Guide

• Fabric OS Encryption Administrator’s Guide

• Fabric OS Troubleshooting and Diagnostics Guide

NOTEWith the release of Fabric OS 7.3.0, many of the document updates will be described only in the updated version of the document. The latest version of all Fabric OS documents is available on Brocade.com or mybrocade.com.

The following document changes have been made since this update document was last released. Refer to the individual chapters for descriptions of all changes made since the first version (-01) of a specific document was released. If a document has not been updated, it will not be listed in this publication. This section only provides an overview, refer to the chapter for a specific book for more details.

• For the Fabric OS Command Reference, the following changes are noted:

- The units for the portcmd --wtool test time are corrected from seconds to minutes.

- A typo in the example shown on the man page and Command Reference for the portshow command Optional Arguments is corrected:-H,--heirarchy - Display object hierarchy.

(“heirarchy” was misspelled as “hierarchy”.)

- The Notes section for the ficoncupset command is updated to include the following statement: “High Integrity Fabric (HIF) mode must be enabled before FMSMODE is enabled.”

Fabric OS Message Reference v7.3.0 Update on page 41 June 2014

v7.3.1 Update on page 42 December 2014

Fabric OS MIB Reference v7.3.0 Update on page 43 April 2015

EZSwitchSetup Administrator’s Guide v7.3.0 53-1003129-01Update on page 43

June 2014

Fabric OS Command Reference v7.3.x Update on page 13 April 2017

TABLE 1 Documentation Supporting Fabric OS v7.3.x (Continued)

Publication Title Fabric OS Release Page Number/Version ID Publication Date

8 Fabric OS Documentation Updates53-1003412-09

Page 9: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

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. Send your feedback to:

[email protected]

Please 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 with your suggestions for improvement.

Fabric OS Documentation Updates 953-1003412-09

Page 10: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

10 Fabric OS Documentation Updates53-1003412-09

Page 11: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Fabric OS Documentation Updates53-1003412-09

Chapter

1

Access Gateway Administrator’s Guide

In this chapter•Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . 11

Documentation updates for Fabric OS v7.3.0 and laterThe updates in this section are for the Access Gateway Administrator’s Guide, publication number 53-1002919-01, published July 2013.

Refer to mybrocade.com for the latest version of this document.

11

Page 12: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Documentation updates for Fabric OS v7.3.0 and later1

12 Fabric OS Documentation Updates53-1003412-09

Page 13: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Fabric OS Documentation Updates53-1003412-09

Chapter

2

Fabric OS Command Reference

In this chapter• Documentation Updates for Fabric OS v7.3.x . . . . . . . . . . . . . . . . . . . . . . . . 13

• Documentation Updates for Fabric OS v7.3.0 . . . . . . . . . . . . . . . . . . . . . . . . 14

• Documentation Updates for Fabric OS v7.3.0a1. . . . . . . . . . . . . . . . . . . . . . 17

• Documentation Updates for Fabric OS v7.3.2 . . . . . . . . . . . . . . . . . . . . . . . . 23

Documentation Updates for Fabric OS v7.3.xThe updates in this section apply to all versions of the Fabric OS Command Reference for Fabric OS 7.3.x.

portcmd

Corrected the time unit for the --wtool test time.

The correct time unit for the --wtool test time is seconds, not minutes.

portshow

Corrected the spelling of the man page example of the optional argument to show object hierarchy.

The correct spelling is:

switch:admin> portshow fciptunnel --hierarchy

ficoncupset

Updated the Notes section to include the following:

High Integrity Fabric (HIF) mode must be enabled before FMSMODE is enabled.

13

Page 14: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Documentation Updates for Fabric OS v7.3.02

Documentation Updates for Fabric OS v7.3.0The updates in this section are for the Fabric OS Command Reference, publication number 53-1003131-01, published 27 June 2014.

bottleneckmon

Updated the notes section to include all supported platforms:

To support buffer credit recovery, E_Ports must be connected between devices that support 16 Gbps or between devices that support 8 Gbps.

• Devices that support 16 Gbps:

- Brocade 6505, 6510, 6520, M6505, 6547

- FC8-32E, FC8-48E,FC16-32, FC16-48, FC16-64

• Devices that support 8 Gbps:

- Brocade 300, 5100, 5300, 5410, 5424, 5450, 5480, VA-40FC

- FC8-16, FC8-32, FC8-48

By default, buffer credit recovery is not enabled on any of the platforms.

configure

Added the "F-Port Device Update Mode" option under Fabric Parameters:

Field Type Default Range __________________________________________________F-Port Device Update Mode Boolean on on/off

Added the following description for the F-Port Device Update Mode option:

F-Port Device Update Mode

When enabled, this feature provides the ability to update NS entries when the base devices perform logout. This option can only be changed when a switch is disabled. In Fabric OS prior to v7.3.0, the details of devices logged in with FLOGI (base devices) with AL_PA 0x40 and 0xC0 are not propagated to NS or FCP unless the devices are registered with NS. Since they cannot be probed, devices with these AL_PAs must initiate NS registration. If they do register with NS and then later logout, there can be multiple LUNs losing access during login time because the logged out base device entry is not removed from NS. Furthermore, the logged out base device cannot login to the fabric again. Enabling this update mode ensures NS and login database consistency.

configurechassis

The description of the CSCTL QoS Mode parameter has been modified as follows.

CSCTL QoS Mode

Configures the CS_CTL to virtual channel (VC) mapping. After changing the CS_CTL QoS mode in a chassis, you must run the slotPowerOff and slotPowerOn commands for all the edge blades; In a fixed-port switch, you must reboot the switch. Because this mode change affects the persistent storage in the switch and chassis, rebooting is required for the new CS_CTL QoS mode to become effective.

14 Fabric OS Documentation Updates53-1003412-09

Page 15: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

firmwaredownload 2

firmwaredownload

Add constraint to the password operand:

Spaces cannot be used in the password string to connect to FTP or SCP servers.

fmmonitor

Added --showwtmon and --delwtmon operands.

--showwtmonDisplays the frame monitors that are installed through Web Tools.

--delwtmonDeletes the frame monitors that are installed through Web Tools. This command option must be used only to delete the frame monitors that are stale in switch due to unexpected closure of Web Tools.

fosconfig

The description of the vf operand has been modified as follows to clarify that Virtual Fabrics are enabled by default.

vfEnables Virtual Fabrics. By default, Virtual Fabrics are enabled. Before enabling the Virtual Fabrics, ensure that there are no Administrative Domains (ADs) in effect. Administrative Domains must be disabled before enabling Virtual Fabrics. This command prompts for confirmation, because the chassis reboots after this command is executed.

framelog

Add du and unroute options to -type operand.

OPERANDS -type duSpecifies du for destination unreachable frames.

-type unrouteSpecifies unroute for unroutable frames.

mapsconfig

Modified the description of the MAPS action "sfp_marginal" as follows:

sfp_marginal

Sets the state of the affected SFP transceiver to marginal. This action is valid only if the monitoring system (specified by the monitor operand in the mapsRule command) is one of the following monitoring systems: CURRENT, RXP, TXP, VOLTAGE, SFP_TEMP.

portcfg

The committed rate values are incorrect in the description of -b | --min-comm-rate value in kbps -B | --max-comm-rate value in kbps parameter. The description is modified as follows:

Fabric OS Documentation Updates 1553-1003412-09

Page 16: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

portledtest2

-b | --min-comm-rate value in kbps -B | --max-comm-rate value in kbpsYou can set a minimum and a maximum for the committed rate to configure the tunnel for Adaptive Rate Limiting (ARL), which allows for a more effective sharing of bandwidth between applications. For Brocade 7800 and FX8-24, the valid range is 10,000 Kbps to 1,000,000 Kbps for 1G ports and 10,000 Kbps to 10,000,000 Kbps for 10G ports. For Brocade 7840, the valid range is 20,000 Kbps to 10,000,000 Kbps. The maximum committed rate can be no larger than five times the minimum committed rate, and both sides of the circuit must have matching configurations.

portledtest

Add the following sentence in the Description section.

“The port LED behavior at portledtest varies depending on platform.”

seccertutil

Added the ’Input hash type (sha1 or sha256)’ field to the command output in the following examples:

To generate a CSR in interactive mode:

switch:admin> seccertutil gencsr Input hash type (sha1 or sha256): sha1 Country Name (2 letter code, eg, US):US State or Province Name (full name, \ eg, California):California Locality Name (eg, city name):"San Jose" Organization Name (eg, company name):Brocade Organizational Unit Name (eg, department \ or section name): IT Common Name (Fully qualified Domain Name, \ or IP address):192.168.38.206 generating CSR, file name is: 192.168.38.206.csr Done

To generate a CSR in noninteractive mode:

switch:admin> seccertutil gencsr -country US \ -state California -locality "San Jose" \ -org Brocade -orgunit software -cn 192.168.38.206Input hash type (sha1 or sha256): sha1Generating CSR, file name is: 192.168.38.206.csrDone

sfpshow

Replaced "sfpshow 8/26" output with the following:

switch:admin> sfpshow 3/44QSFP No: 11 Channel No:0 Identifier: 13 QSFP+ Connector: 12 MPO Parallel Optic Transceiver: 0000000000000000 16_Gbps sw Short_dist Encoding: 5 64B66B Baud Rate: 140 (units 100 megabaud) Length 9u: 0 (units km) Length 50u (OM4): 100 (units m)

16 Fabric OS Documentation Updates53-1003412-09

Page 17: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

snmpconfig 2

Length 62.5u: 0 (units m) Vendor Name: BROCADE Vendor OUI: 00:05:1e Vendor PN: 57-1000294-01 Vendor Rev: A Wavelength: 850 (units nm) Options: 00000fde Max Case Temp: 70 (C) Device Tech: 0x00 Serial No: HUA1140700000A1 Date Code: 140215 DD Type: 0x8 Enh Options: 0x0 Status/Ctrl: 0x0 Alarm flags[0,1]= 0x0, 0x0 Warn Flags[0,1] = 0x0, 0x0 Temperature: 32 Centigrade Current: 7.502 mAmps Voltage: 3272.6 mVolts RX Power: -1.8 dBm (659.9uW) State transitions: 1 Last poll time: 02-16-2016 PST Tue 22:18:49

snmpconfig

Add constraint to the password operand:

snmpv3 Configuration Parameters

The SNMPv3 configuration password must have at least 8 characters.

Documentation Updates for Fabric OS v7.3.0a1The updates in this section are for the Fabric OS Command Reference, publication number 53-1003131-01, published 27 June 2014.

The following commands are introduced in Fabric OS 7.3.0a1 release.

seccryptocfg

Configures and displays ciphers, kex, and MAC algorithms for SSH and HTTPS.

SYNOPSIS seccryptocfg --replace -type SSH | https [-cipher cipher_string | -kex value | -mac value] -force

seccryptocfg --default -type https | SSH [-force]

seccryptocfg --show

seccryptocfg --help

Fabric OS Documentation Updates 1753-1003412-09

Page 18: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

seccryptocfg2

DESCRIPTION Use this command to configure cryptographic parameters such as ciphers, key exchange (kex) algorithm, and message authentication code (MAC) algorithm for SSL or HTTPS, to reset the cryptographic parameters to default, and to display the configured cryptographic parameters. This command restarts the SSH or HTTPS daemon for the changes to take effect. This command prompts for confirmation unless you use the -force option.

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.

OPERANDS This command has the following operands:

--replace -type SSH | httpsConfigures the specified ciphers, kex, and MAC algorithms for SSL or HTTPS and restarts the SSH or HTTPS daemon.

-cipher cipher_stringSpecifies the SSH or HTTPS cipher list. You can either specify one or more ciphers separated by a comma, for example, 3des-cbc,aes128-cbc,aes192-cbc. The following ciphers are configured by default. You can modify the cipher list using this operand.

For SSL:

• aes128-ctr

• aes192-ctr

• aes256-ctr

• aes128-cbc

• 3des-cbc

• aes192-cbc

• aes256-cbc

For HTTPS:

• ECDH

• DH

• HIGH

• MD5

• CAMELLIA

• SRP

• PSK

• AESGCM

-kex valueSpecifies the SSH kex algorithms list. You can either specify one or more kex algorithms separated by a comma, for example, ecdh-sha2-nistp256,diffie-hellman-group-exchange-sha256. The following kex algorithms are configured by default. You can modify the kex algorithms list using this operand.

• ecdh-sha2-nistp256

• ecdh-sha2-nistp384

• ecdh-sha2-nistp521

• diffie-hellman-group-exchange-sha256

• diffie-hellman-group-exchange-sha1

• diffie-hellman-group14-sha1

• diffie-hellman-group1-sha1

18 Fabric OS Documentation Updates53-1003412-09

Page 19: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

seccryptocfg 2

-mac valueSpecifies the SSH MAC list. You can either specify one or more MAC algorithms separated by a comma, for example, hmac-md5,hmac-sha1. The following MAC algorithms are configured by default. You can modify the MAC algorithms list using this operand.

• hmac-md5

• hmac-sha1

• hmac-sha2-256

• hmac-sha2-512

--default -type SSH | httpsResets the cipher, kex, and MAC configurations to default.

-forceExecutes without prompting for a confirmation.

--showDisplays the configured cipher, kex, and MAC algorithms.

--helpDisplays the command usage.

EXAMPLES To configure ciphers, kex, and MAC for SSL:

switch:admin> seccryptocfg --replace -type SSH -cipher \ 3des-cbc,aes128-cbc,aes192-cbc -kex diffie-hellman-group-exchange-sha1 \ -mac hmac-sha2-256

To configure ciphers for SSL:

switch:admin> seccryptocfg --replace -type SSH -cipher \ aes128-ctr,aes192-ctrThis command requires the daemon(s) SSL to be restarted.Existing sessions will be terminated.Please confirm and provide the preferred optionPress Yes(Y,y), No(N,n) [N]:y

To configure ciphers for HTTP:

switch:admin> seccryptocfg --replace -type https -cipher \ '!ECDH:!DH:HIGH:-MD5:!CAMELLIA'This command requires the daemon(s) HTTP to be restarted.Existing sessions will be terminated.Please confirm and provide the preferred optionPress Yes(Y,y), No(N,n) [N]:no

To configure ciphers for HTTP using the -force option:

switch:admin> seccryptocfg --replace -type https -cipher \ '!ECDH:!DH:HIGH:-MD5:!CAMELLIA' -forceHTTP cipher list configured successfully.

Fabric OS Documentation Updates 1953-1003412-09

Page 20: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

seccryptocfg2

To display the configured ciphers, kex, and MAC algorithms:

switch:admin> seccryptocfg --showHTTPS Cipher List : !ECDH:!DH:HIGH:-MD5:!CAMELLIA:!SRP:!PSK:!AESGCMSSH Cipher List : aes128-ctr,aes192-ctr,aes256-ctr,aes128-cbc,3des-cbc, \

aes192-cbc,aes256-cbcSSH Kex Algorithms List : ecdh-sha2-nistp256,ecdh-sha2-nistp384, \ ecdh-sha2-nistp521, diffie-hellman-group-exchange-sha256, \

diffie-hellman-group-exchange-sha1, diffie-hellman-group14-sha1, \

diffie-hellman-group1-sha1SSH MACs List : hmac-md5,hmac-sha1,hmac-sha2-256,hmac-sha2-512

SEE ALSO None

20 Fabric OS Documentation Updates53-1003412-09

Page 21: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

syslogadmin 2

syslogadmin

Configures a syslog server host.

SYNOPSIS syslogadmin --set -ip ip_address [-secure [-port port_num]]

syslogadmin --set -facility level

syslogadmin --remove -ip ip_address

syslogadmin --show -ip | -facility

syslogadmin --help

DESCRIPTION Use this command to configure a switch to forward all error log entries to a remote syslog server, to set the syslog facility to a specified log file, to remove a syslog server, and to display the list of configured syslog servers. Brocade switches use the syslog daemon, a process available on most UNIX systems that reads and forwards system messages to the appropriate log files or users, depending on the system configuration. Up to six servers are supported.

By default, the switch uses UDP protocol to send the error log messages to the syslog server. The default UDP port is 514. Use the -secure option to configure the switch to send the error log messages securely using the Transport Layer Security (TLS) protocol. TLS is an encryption protocol over the TCP/IP network protocol and it can be used only with the TCP-based destinations (tcp() and tcp6()). The default TLS port is 6514. While enabling secure syslog mode, you must specify a port that is configured to receive the log messages from the switch.

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.

OPERANDS This command has the following operands:

--set -ip ip_addressConfigures a syslog server with the specified IP address. IPv4 and IPv6 addresses are supported. Only one syslog server can be specified at any given time. To configure more than one server, the command must be executed for each server.

-secure [-port port_num]Enables secure syslog mode to send the error log messages securely using the TLS protocol to the syslog server. The secure syslog mode is disabled by default. The -port operand is optional. If secure mode is enabled and port number is not specified, the default TLS port number (6514) is set.

--set -facility levelSets the syslog facility. Valid levels are 0 through 7. The default is 7.

0LOG_LOCAL0

1 LOG_LOCAL1

2LOG_LOCAL2

3LOG_LOCAL3

Fabric OS Documentation Updates 2153-1003412-09

Page 22: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

syslogadmin2

4LOG_LOCAL4

5LOG_LOCAL5

6LOG_LOCAL6

7LOG_LOCAL7 (default)

--remove -ip ip_addressRemoves the specified syslog server. IPv4 and IPv6 addresses are supported.

--showDisplays the list of configured syslog servers and the facility level.

-ipDisplays all syslog server IP addresses.

-facilityDisplay the configured syslog facility.

--helpDisplays the command usage.

EXAMPLES To configure an IPv4 secure syslog server to which error log messages are sent:

switch:admin> syslogadmin --set -ip 172.26.26.173 -secure -port 2000

To configure an IPv6 non-secure syslog server:

switch:admin> syslogadmin --set -ip fec0:60:69bc:92:218:8bff:fe40:15c4

To set the syslog facility to LOG_LOCAL2:

switch:admin> syslogadmin --set -facility 2switch:admin> syslogadmin --show -facilitySyslog facility: LOG_LOCAL2

To display all syslog IP addresses configured on a switch:

switch:admin> syslogadmin --show -ipsyslog.1 172.26.26.173syslog.2 fec0:60:69bc:92:218:8bff:fe40:15c4

To remove the IP address fec0:60:69bc:92:218:8bff:fe40:15c4 from the list of servers to which error log messages are sent:

switch:admin> syslogadmin --remove -ip fec0:60:69bc:92:218:8bff:fe40:15c4

SEE ALSO None

22 Fabric OS Documentation Updates53-1003412-09

Page 23: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Documentation Updates for Fabric OS v7.3.2 2

Documentation Updates for Fabric OS v7.3.2The updates in this section are for the Fabric OS Command Reference, publication number 53-1003131-01, published 27 June 2014.

Added the following note to “Supported hardware and software” section in “Supported hardware and software” chapter:

NOTECertain versions of Fabric OS software support connections to the Brocade Analytics Monitoring Platform. For more information about the Brocade Analytics Monitoring Platform, including which versions of Fabric OS can interact with it, refer to the Brocade Analytics Monitoring Platform Release Notes.

Fabric OS Documentation Updates 2353-1003412-09

Page 24: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Documentation Updates for Fabric OS v7.3.22

24 Fabric OS Documentation Updates53-1003412-09

Page 25: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Fabric OS Documentation Updates53-1003412-09

Chapter

3

Fabric OS Encryption Administrator’s Guide

In this chapter•Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . 25

Documentation updates for Fabric OS v7.3.0 and laterNone of the following documents were published for Fabric OS v7.3.x:

• Fabric OS Encryption Administrator’s Guide Supporting Key Management Interoperability Protocol (KMIP) Key-Compliant Environments (Fabric OS Encryption Administrator’s Guide (KMIP)

• Fabric OS Encryption Administrator’s Guide Supporting RSA Data Protection Manager (DPM) Environments (Fabric OS Encryption Administrator’s Guide (RKM)

• Fabric OS Encryption Administrator’s Guide Supporting NetApp Lifetime Key Manager (LKM) and KeySecure Storage Secure Key Manager (SSKM) Environments (Fabric OS Encryption Administrator’s Guide (LKM))

• Fabric OS Encryption Administrator’s Guide Supporting HP Secure Key Manager (SKM) and HP Enterprise Secure Key Manager (ESKM) Environments (Fabric OS Encryption Administrator’s Guide (SKM/ESKM))

• Fabric OS Encryption Administrator’s Guide Supporting Thales e-Security keyAuthority (TEKA) Environments (Fabric OS Encryption Administrator’s Guide (TEKA)

• Fabric OS Encryption Administrator’s Guide Supporting Tivoli Key Lifecycle Manager (TKLM) Environments (Fabric OS Encryption Administrator’s Guide (TKLM)

25

Page 26: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Documentation updates for Fabric OS v7.3.0 and later3

26 Fabric OS Documentation Updates53-1003412-09

Page 27: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Fabric OS Documentation Updates53-1003412-09

Chapter

4

Fabric OS FCIP Administrator’s Guide

In this chapter•Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . 27

Documentation updates for Fabric OS v7.3.0 and laterThe updates in this section are for the Fabric OS FCIP Administrator’s Guide, publication number 53-1002928-01, published July 2013.

Refer to mybrocade.com for the latest version of this document.

27

Page 28: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Documentation updates for Fabric OS v7.3.0 and later4

28 Fabric OS Documentation Updates53-1003412-09

Page 29: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Fabric OS Documentation Updates53-1003412-09

Chapter

5

Fabric OS Software Licensing Guide

In this chapter•Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . 29

Documentation updates for Fabric OS v7.3.0 and laterThe updates in this section are for the Fabric OS Software Licensing Guide, publication number 53-1003110-01, published December 2013.

Refer to mybrocade.com for the latest version of this document.

29

Page 30: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Documentation updates for Fabric OS v7.3.0 and later5

30 Fabric OS Documentation Updates53-1003412-09

Page 31: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Fabric OS Documentation Updates53-1003412-09

Chapter

6

Fabric OS Troubleshooting and Diagnostics Guide

In this chapter•Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . 31

Documentation updates for Fabric OS v7.3.0 and laterThe updates in this section are for the Fabric OS Troubleshooting and Diagnostics Guide, publication number 53-1002930-01, published July 2013.

Refer to mybrocade.com for the latest version of this document.

In Table 22 on page 121, the Brocade 4024 should 4 Gb and not 2 Gb. Change the entry for switchType 43 to the following:

TABLE 22 switchType to B-Series model converter

switchType B-Series switch model Base switch speed

43 4024 4 Gb 24-port embedded switch

31

Page 32: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Documentation updates for Fabric OS v7.3.0 and later6

32 Fabric OS Documentation Updates53-1003412-09

Page 33: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Fabric OS Documentation Updates53-1003412-09

Chapter

7

Fabric OS Upgrade Guide

In this chapter•Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . 33

Documentation updates for Fabric OS v7.3.0 and laterThe updates in this section are for the Fabric OS Upgrade Guide, publication number 53-1003240-01, published July 2013.

Refer to mybrocade.com for the latest version of this document.

Installing and Maintaining FirmwareIncluded a new section” Considerations for FTP server credentials with special characters”.

Considerations for FTP server credentials with special characters

FTP server credentials may include special characters that need to be handled in specified manner on the Command Line Interface (CLI).

Special characters also referred to as meta-characters, are members of an exempt set of characters, which when used in command line mode are evaluated as characters with non-literal meaning. These characters are designated to carry out a special instruction, or have an alternate meaning.

NOTEThis list is not exhaustive and alternate meaning for some characters is contextual. For more information, refer to any Linux scripting information available for general use on the internet.

A list of some of the more commonly used special characters and their alternate meaning is as follows: & is used to put a command in background/batch mode.

• ! is used to recall the last invocation of the command matching the pattern that follows the character.

• | is used to pipe output to the command that follows the character.

• ; is used to concatenate multiple bash commands.

• * is used to represent a wildcard character.

• ? is used as a match for any single character in the specified position.

• () is used for integer expansion.

• <> is used for redirection. < represents input and > represents output.

• $ is used to represent shell variable.

33

Page 34: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Documentation updates for Fabric OS v7.3.0 and later7

• ` is used for command substitution or assign output of a command to a variable.

• " is used for partial quoting.

• ' is used for full quoting.

• Space is used as a separation character.

• # when preceded by a space, treats all characters till the end of the corresponding line as a comment.

These special characters may be used to enhance the security of the user credentials. However, to interpret these characters properly in the CLI mode, you must follow one of the following methods:

• Escape each instance of the special character by preceding it with the escape character (\).

• Enclose the credentials containing special characters, with single quotes.

If single quotes are themselves part of the credential, precede each instance of the single quote with the escape character (\). Alternately, the string may be enclosed in double quotes if more intricate bash substitution is desired to further strengthen the security measure of the credentials.

For detailed information on using the special characters in the credentials, refer to any Linux scripting information available for general use on the internet.

You can test the representation of the credentials using the echo tests.

To verify the use of single quote for the password aaa!01:

switch:admin> echo ‘aaa!01’ aaa!01To verify escaping ! without quotes for the password aaa!01:

switch:admin> echo aaa\!01 aaa!01To verify using the quotes, excluding the \! for password aaa!01:

switch:admin> echo "aaa"\!"01" aaa!01To verify using the quotes without excluding the \! for password aaa!01, resulting in different password pattern:

switch:admin> "aaa\!01" aaa\!01To verify using the quotes around the \! for password aaa!01, resulting in different password pattern:

switch:admin> echo ‘aaa!01’ aaa!01

Upgrading and downgrading firmware

In the section “Upgrading and downgrading firmware”, the firmware upgrade and downgrade considerations are updated.

During the firmware upgrade, the configuration file uploaded from firmware versions Fabric OS 7.1.x and Fabric OS 7.2.x is allowed to download to Fabric OS v7.3.0.

During the firmware downgrade, the configuration file uploaded from v7.3.0 is allowed to download to previous firmware versions Fabric OS 7.2.x and Fabric OS 7.01x.

34 Fabric OS Documentation Updates53-1003412-09

Page 35: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Fabric OS Documentation Updates53-1003412-09

Chapter

8

FICON Administrator’s Guide

In this chapter•Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . 35

Documentation updates for Fabric OS v7.3.0 and laterThe updates in this section are for the FICON Administrator’s Guide, publication number 53-1002931-01, published July 2013.

Refer to mybrocade.com for the latest version of this document.

35

Page 36: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Documentation updates for Fabric OS v7.3.0 and later8

36 Fabric OS Documentation Updates53-1003412-09

Page 37: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Fabric OS Documentation Updates53-1003412-09

Chapter

9

Web Tools Administrator’s Guide

In this chapter•Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . 37

Documentation updates for Fabric OS v7.3.0 and laterThe updates in this section are for the Web Tools Administrator’s Guide, publication number 53-1003169-03, published September 2014.

Refer to mybrocade.com for the latest version of this document.

Chapter 1, Introducing Web ToolsUnder the heading “Opening Web Tools”, add the following note.

NOTETo avoid a potential POODLE attack and establish a secure connection, disable the SSL 3.0 protocol option from your web browser settings.

Under the heading “System requirements”, remove Chrome 33 browser support in the “Certified and tested platforms” table and “Supported platforms” table.

37

Page 38: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Documentation updates for Fabric OS v7.3.0 and later9

38 Fabric OS Documentation Updates53-1003412-09

Page 39: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Fabric OS Documentation Updates53-1003412-09

Chapter

10

FIPS Configuration Guide

In this chapter•Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . 39

Documentation updates for Fabric OS v7.3.0 and laterThe updates in this section are for the FIPS Configuration Guide, publication number 53-1003111-01, published December 2013.

Refer to mybrocade.com for the latest version of this document.

The following changes have been made to 53-1003111-01:

• The name of the book has been changed to the FIPS and Common Criteria Configuration Guide. 

• The 53-1003111-02 version of this document applies only to the Fabric OS 7.3.0a1 build, not any earlier release. This version has achieved Common Criteria certification, and the content reflects this. However, as FIPS certification has not yet been issued for any Fabric OS 7.3.x release, all FIPS material contained in the -01 and -02 versions of this document should be considered preliminary. Once FIPS approval has been granted for FOS 7.3.x, the document will be reissued with any required updates and an updated version number.

39

Page 40: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Documentation updates for Fabric OS v7.3.0 and later10

40 Fabric OS Documentation Updates53-1003412-09

Page 41: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Fabric OS Documentation Updates53-1003412-09

Chapter

11

Fabric OS Message Reference

In this chapter•Documentation updates for Fabric OS 7.3.0 and 7.3.1 . . . . . . . . . . . . . . . . 41

•Documentation updates for Fabric OS 7.3.1 and later . . . . . . . . . . . . . . . . . 42

Documentation updates for Fabric OS 7.3.0 and 7.3.1 The updates in this section are for the following published documents:

• Fabric OS Message Reference supporting Fabric OS 7.3.0 (53-1003140-01), originally published in June 2014.

• Fabric OS Message Reference supporting Fabric OS 7.3.1 (53-1003601-01), originally published in December 2014.

Refer to mybrocade.com for the latest version of this document.

NOTEThe updates are arranged by the chapter names as they appear in the original document.

Updates to Chapter 1, Introduction to System MessagesTable 6 in the section “System Modules Description” has been updated to include the following Raslog modules along with description.

Table 6 System module descriptions.

System module

Description

BCM BCM kernel module is a Linux driver which manages and indicates any problems associated with the Broadcom Ethernet switch for 10G/40G ports.

BLZ BLZ module messages indicate any problems associated with Fibre Channel over IP (FCIP) data path processing and configurations.

ESM Extension Services Module (ESM) provides management control and reporting for extension features such as FCIP and IPEX as well as their associated configurations.

L3SS L3SYS error messages indicate problems with the Layer 3 system manager that controls the IP routing table in hardware as well as Linux IP stack.

41

Page 42: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

FV-301411

Updates to Chapter 5, Fabric OS System Messages

Modified messages

• The command name "fosConfig" is not supported.

Use the command name "fosconfig" instead in the probable cause description of the following messages: FABR-1045, FCR-1068, FCR-1069, ISNS-1011. This error is resolved in Fabric OS 8.1.0 documents.

• The probable cause description of the FV-3014 Raslog message has been modified as follows.

FV-3014

Message All flows are reset for the feature(s) <feature_list>.

Message Type AUDIT

Class CFG

Severity INFO

Probable Cause Indicates all flows are reset for the specified features.

RecommendedAction

No action is required.

Documentation updates for Fabric OS 7.3.1 and later The updates in this section are for the Fabric OS Message Reference supporting Fabric OS 7.3.1 (53-1003601-01), originally published in December 2014.

Refer to mybrocade.com for the latest version of this document.

NOTEThe updates are arranged by the chapter names as they appear in the original document.

Deleted messages

The following message is not supported and therefore deleted from the Chapter 5, Fabric OS System Messages:

• SRM-1001

42 Fabric OS Documentation Updates53-1003412-09

Page 43: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Fabric OS Documentation Updates53-1003412-09

Chapter

12

Fabric OS MIB Reference

In this chapterThe updates in this chapter are for the Fabric OS MIB Reference, part number: 53-1002750-01 published December 2012, and part number: 53-1002750-02, published March 2013.

•Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . 43

Refer to mybrocade.com for the latest version of this document.

Documentation updates for Fabric OS v7.3.0 and later

Chapter 6, SW-MIB ObjectsUnder the heading “sw traps”, add the variables ‘swBrcdBitObjVal’ and ‘swVfId’ to the following row in Table 44, as shown below.

TABLE 44

Trap name and OID Variables Description

swBrcdGenericTrap1.3.6.1.4.1.1588.2.1.1.1.0.14

swBrcdTrapBitMaskswBrcdBitObjValswVfId

This trap is sent for one of the following events:• fabric change• device change• FAPWWN change• FDMI events• Routing policy change• Diagnostics port configuration change• Polling status• Dynamic port name change• Dynamic port name feature enable/disable

eventThis trap is enabled by default.

NOTE: This trap is for internal use.

43

Page 44: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Documentation updates for Fabric OS v7.3.0 and later12

Under the heading “sw traps”, add the given note to the following row in Table 44, as shown below.

TABLE 44

Trap name and OID Variables Description

swTrackChangesTrap1.3.6.1.4.1.1588.2.1.1.1.0.6

swBrcdTrapBitMaskswBrcdBitObjValswVfId

Trap to be sent for tracking log in, log out, or configuration changes.

#TYPE Track changes has generated a trap.#SUMMARY %s and SSN is #%s#ARGUMENTS 0, 1#SEVERITY Informational#TIMEINDEX 1#STATE Operational

Some of the triggers that will generate this trap are:• Log out• Unsuccessful log in• Successful log in• Switch configuration changes• Track changes on and off This trap gets sent when track-changes is set to ENABLED and is configured to send SNMP traps on track events. Use the trackchangesset command to enable the track changes feature and SNMP trap mode.

NOTE: This trap is deprecated.

44 Fabric OS Documentation Updates53-1003412-09

Page 45: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Documentation updates for Fabric OS v7.3.0 and later 12

Under the heading “Switch system group”, add the given note to the following rows in Table 45, as shown below.

Under the heading “Switch system group”, add the following rows to Table 45.

TABLE 45

Object and OID Access Description

swTelnetShellAdmStatus1.3.6.1.4.1.1588.2.1.1.1.1.9

Read-write The desired administrative status of the Telnet shell. Setting this value to 1 (terminated), deletes the current Telnet shell task. When this variable instance is read, it reports the value last set through SNMP.This OID is supported in Fabric OS v2.x through v3.x. This OID is not supported in Fabric OS v4.0 through v4.2. This OID is supported in Fabric OS v4.3 and later versions.Possible values are:• unknown (0) - The status of the current Telnet

shell task is unknown.• terminated (1) - The current Telnet shell task is

deleted.By setting it to 1 (terminated), the current Telnet shell task is deleted. When this variable instance is read, it reports the value last set through SNMP.

NOTE: This object is deprecated.

swTrackChangesInfo1.3.6.1.4.1.1588.2.1.1.1.1.23

Read only Track changes string; for trap only.If there are no events to track, the default return value is “No event so far.”If there are events to track, the following are valid return values:• Successful log in• Unsuccessful log in• Logout• Configuration file change from task [name of

task]• Track-changes on• Track-changes off

NOTE: This object is deprecated.

TABLE 45

Object and OID Access Description

swBrcdBitObjVal1.3.6.1.4.1.1588.2.1.1.1.1.37

Not accessible The object contains object value for each change mentioned in the swBrcdGenericTrap. It will be empty for the events which do not have any value.

swIODState1.3.6.1.4.1.1588.2.1.1.1.1.38

Not accessible The object represents the IOD feature state. Possible values are:• 1 - enabled• 2 - disabled• 3 - unknown

Fabric OS Documentation Updates 4553-1003412-09

Page 46: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Documentation updates for Fabric OS v7.3.0 and later12

Under the heading “Switch system group”, add the ‘d-port(8)’ value to the following row in Table 45, as shown below.

Chapter 19, BD MIB ObjectsUnder the heading “BD Traps”, add the variable ‘slotPort’ to the following rows in Table 131, as shown below.

TABLE 45

Object and OID Access Description

swFCPortPrevType1.3.6.1.4.1.1588.2.1.1.1.1.35

Not accessible This represents the port type of a port before it goes online or offline and it is valid only in swFcPortSCN trap.Valid values are:• unknown (1)• other (2)• fl-port (3) - public loop• f-port (4) - fabric port• e-port (5) - fabric expansion port• g-port (6) - generic fabric port• ex-port (7)• d-port(8)

TABLE 131

Trap name and OID Variables Description

bdTrap1.3.6.1.4.1.1588.2.1.1.51.0.1

userPortNumber bdWinAvgTime nBdType bdThreshold bdAggrStats bdAbsoluteValue swVfId bdAvgFrameSize slotPort

This trap is sent for both latency bottleneck and congestion bottleneck with nBDType accordingly. This trap is triggered when the threshold is exceeded.

bdClearTrap1.3.6.1.4.1.1588.2.1.1.51.0.2

userPortNumber bdWinAvgTime nBdType bdThreshold bdAggrStats bdAbsoluteValue swVfId bdAvgFrameSize slotPort

This trap is sent after a latency or congestion bottleneck is cleared.

46 Fabric OS Documentation Updates53-1003412-09

Page 47: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Fabric OS Documentation Updates53-1003412-09

Chapter

13

EZSwitchSetup Administrator’s Guide

In this chapter•Documentation updates for Fabric OS v7.3.0 and later . . . . . . . . . . . . . . . . 47

Documentation updates for Fabric OS v7.3.0 and laterThe updates in this section are for the EZSwitchSetup Administrator’s Guide, publication number 53-1003129-01, published June 2014.

Refer to mybrocade.com for the latest version of this document.

Chapter 1, Introducing EZSwitchSetupUnder the heading “EZSwitchSetup software and hardware requirements”, remove Chrome 33 browser support in the “Certified and tested platforms” table.

47

Page 48: Fabric OS Documentation Updates, 7.3March 2016 Fabric OS Documentation Updates 53-1003412-06 Updates for the following: • Fabric OS Command Reference April 2016 Fabric OS Documentation

Documentation updates for Fabric OS v7.3.0 and later13

48 Fabric OS Documentation Updates53-1003412-09