Brocade Fabric OS MIB Reference

Download

Page 1

53-1000602-02 March 12, 2008

Fabric OS

MIB Reference

Supporting Fabric OS v3.1.x, v3.2.x, v4.1.x, v4.2.x, v4.4.x, v5.0.x, v5.1.x, v5.2.x, v5.3.x, v6.0.0,v6.1.0

Page 2

Brocade, Fabric OS, File Lifecycle Manager, MyView, and StorageX are registered trademarks and the Brocade B-wing symbol, DCX, and SAN Health are trademarks of Brocade Communications Systems, Inc., in the United States and/or in other countries. All other brands, products, or service names are or may be trademarks or service marks of, and are used to identify, products or services of their respective owners.

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

The authors and Brocade Communications Systems, Inc. shall have no liability or responsibility to any person or entity with respect to any loss, cost, liability, or damages arising from the information contained in this book or the computer programs that accompany it.

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

Brocade Communications Systems, Incorporated

Corporate Headquarters Brocade Communications Systems, Inc. 1745 Technology Drive San Jose, CA 95110 Tel: 1-408-333-8000 Fax: 1-408-333-8101 Email: info@brocade.com

European and Latin American Headquarters Brocade Communications Switzerland Sàrl Centre Swissair Tour A - 2ème étage 29, Route de l'Aéroport Case Postale 105 CH-1215 Genève 15 Switzerland Tel: +41 22 799 56 40 Fax: +41 22 799 56 41 Email: emea-info@brocade.com

Asia-Pacific Headquarters Brocade Communications Singapore Pte. Ltd. 9 Raffles Place #59-02 Republic Plaza 1 Singapore 048619 Tel: +65-6538-4700 Fax: +65-6538-0302 Email: apac-info@brocade.com

Page 3

Document History

The following table lists all versions of the MIB Reference.

Document Title Publication

Number

Brocade MIB Reference Manual v2.3 53-0000069-02 December 2000

Brocade MIB Reference Manual v3.0 53-0000134-03 July 2001

Brocade MIB Reference Manual v3.0,

4.0

Brocade MIB Reference Manual (v4.1, v4.0.x, v3.1, v3.0.x, v2.6.x)

Brocade MIB Reference Manual (v4.1.2, v4.1, v4.0.x, v3.1, v3.0.x, v2.6.x)

Brocade MIB Reference Manual (v4.2.0, v4.1.2, v4.1, v4.0.x, v3.1, v3.0.x, v2.6.x)

Brocade Fabric OS MIB Reference Manual

53-0000184-02 March 2002

53-0000521-02 Added Brocade-

53-0000521-03 Added FICON

53-0000521-04 Revised FICON

53-0000521-06 Update to support the

53-0000521-08 Updated to support

Summary of Changes

specific Entity and HA-MIBs.

information.

Brocade 3250, 3850, and 24000 switches.

the Brocade 4100.

Publication Date

April 2003

May 2003

October 2003

December 2003

September 2004

Brocade Fabric OS MIB Reference Manual

Brocade Fabric OS MIB Reference 53-1000241-01 Changed name,

Brocade Fabric OS MIB Reference 53-1000439-01 New branding,

Brocade Fabric OS MIB Reference 53-1000602-01 Updated to support

Brocade Fabric OS MIB Reference 53-1000602-02 Updated to support

53-0000521-09 Updated to support

the Brocade 48000 and 200E.

53-1000045-01 Updated to support

the Brocade 4900, 7500, and FR4-18i blade.

updated to support Fabric OS 5.2.x

updated to support Fabric OS 5.3.0

the Brocade DCX Data Center Backbone Director

the Brocade 300, 5100, and 5300 switches.

April 2005

January 2006

September 2006

June 2007

October 19, 2007

March 12, 2008

Page 4

Page 5

About This Document

In this Chapter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

How This Document Is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Supported Hardware and Software . . . . . . . . . . . . . . . . . . . . . . . . . . xii

What’s New in This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv

Getting Technical Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Document Feedback. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi

Chapter 1 Understanding Brocade SNMP

Setting the SNMP Security Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Understanding SNMP Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Understanding MIBs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Understanding SNMP Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Object Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Loading Brocade MIBs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Brocade MIB Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Before Loading MIBs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

MIB Loading Order. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

SNMP CLI usage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Brocade 7500 / FR4-18i and Brocade MIBs . . . . . . . . . . . . . . . . . .11

Access Gateway and Brocade MIBs. . . . . . . . . . . . . . . . . . . . . . . . . .11

Firmware Upgrades and Enabled Traps. . . . . . . . . . . . . . . . . . . . . . .11

Fabric OS Commands for Configuring SNMP . . . . . . . . . . . . . . . . . .12

Support for Administrative Domains . . . . . . . . . . . . . . . . . . . . . . . . .12

Support for Role Based Access Control. . . . . . . . . . . . . . . . . . . . . . .12

Support for IP V6 Addressing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

Chapter 2 MIB-II (RFC1213-MIB)

MIB II Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

System Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Fabris OS MIB Reference v 53-1000602-02

Page 6

Interfaces Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29

AT Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54

IP Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59

ICMP Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107

TCP Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134

UDP Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156

EGP Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164

Transmission Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164

SNMP Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164

ifMIB Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192

Chapter 3 FE MIB Objects

FE MIB Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215

FIBRE-CHANNEL-FE-MIB (MIB-II branch) . . . . . . . . . . . . . . . . . . . . .215

Definitions for FIBRE-CHANNEL-FE-MIB. . . . . . . . . . . . . . . . . . . . . .220

fcFeConfig Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .222

fcFeStatus Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .250

fcFeError Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .278

feFcAccounting Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .292

fcFeCapability Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .320

FCFABRIC-ELEMENT-MIB (Experimental Branch) . . . . . . . . . . . . . .336

fcFeConfig Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .343

fcFeOp Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .378

fcFeError Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .413

fcFeAcct Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .429

fcFeCap Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .429

Chapter 4 Entity MIB Objects

Entity MIB Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .449

Entity MIB System Organization of MIB Objects . . . . . . . . . . .450

Definitions for Entity MIB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .451

Textual Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .452

Entity MIB Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .455

Physical Entity Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .455

Logical Entity Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .475

Entity Mapping Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .485

General Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .495

vi Fabris OS MIB Reference

53-1000602-02

Page 7

Entity MIB Trap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .496

Entity MIB Conformance Information. . . . . . . . . . . . . . . . . . . . . . . .497

Chapter 5 SW-MIB Objects

SW MIB Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .507

SW-MIB System Organization of MIB Objects . . . . . . . . . . . . .507

Textual Conventions for SW-MIB . . . . . . . . . . . . . . . . . . . . . . . .515

sw Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .518

swSystem Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .526

Flash Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .536

swFabric Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .559

SW Agent Configuration Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . .583

Fibre Channel Port Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .589

Name Server Database Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . .628

Event Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .646

Fabric Watch Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .656

End Device Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .700

Switch Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .711

ASIC Performance Monitoring Group. . . . . . . . . . . . . . . . . . . . . . . .721

Trunking Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 742

Chapter 6 High-Availability MIB Objects

HA MIB Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .757

High-Availability Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .759

FRU Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .760

FRU History Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .769

CP Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .778

HA-MIB Traps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .785

HA-MIB Traps and Sample Triggers. . . . . . . . . . . . . . . . . . . . . .788

Chapter 7 FICON MIB Objects

FICON MIB Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .789

SNMP Traps for FICON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .789

FICON MIB System Organization of MIB Objects . . . . . . . . . . .789

Textual Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .791

ficonRNID Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .793

ficonLIRR Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .823

ficonRLIR Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .833

Fabris OS MIB Reference vii 53-1000602-02

Page 8

linkIncidentMIBTraps Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .848

Chapter 8 FibreAlliance MIB Objects

FibreAlliance MIB Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .855

FCMGMT-MIB System Organization of MIB Objects . . . . . . . .856

Definitions for FCMGMT-MIB. . . . . . . . . . . . . . . . . . . . . . . . . . .861

ConnSet Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .863

Statistics Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .964

Service Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1016

SNMP Trap Registration Group. . . . . . . . . . . . . . . . . . . . . . . . . . . 1034

Revision Number Scalar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1042

Unsupported Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1043

FibreAlliance MIB Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1043

Chapter 9 FCIP MIB Objects

FCIP MIB Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1049

FCIP MIB System Organization of MIB Objects . . . . . . . . . . 1050

fcipEntityInstanceTable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1051

fcipLinkTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1060

FCIP Extended Link Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1073

Chapter 10 iSCSI MIB Objects

iSCSI MIB Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1081

iSCSI MIB System Organization of MIB Objects. . . . . . . . . . 1082

iscsiInstanceAttributesTable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1085

iscsiNodeAttributesTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1099

iscsiSessionAttributesTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1119

iscsiSessionStatsTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1142

iscsiConnectionAttributesTable . . . . . . . . . . . . . . . . . . . . . . . . . . 1150

Appendix A MIB Object Groupings

Switch Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1169

Sensor Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1169

Port Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1169

Event Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1170

ISL and End Device Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . .1170

SNMP Configuration Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . .1170

iSCSI Instance Information Variables . . . . . . . . . . . . . . . . . . . . . .1171

viii Fabris OS MIB Reference

53-1000602-02

Page 9

Appendix B MIB OIDs and Their Matching Object Names

MIB OIDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1173

Index

Fabris OS MIB Reference ix 53-1000602-02

Page 10

x Fabris OS MIB Reference

53-1000602-02

Page 11

About This Document

In this Chapter

• How This Document Is Organized . . . . . . . . . . . . . . . . xi

• Supported Hardware and Software. . . . . . . . . . . . . . . xii

• What’s New in This Document. . . . . . . . . . . . . . . . . . xiii

• Document Conventions . . . . . . . . . . . . . . . . . . . . . . . xiii

• Additional Information . . . . . . . . . . . . . . . . . . . . . . . . xiv

• Getting Technical Help . . . . . . . . . . . . . . . . . . . . . . . . . xv

• Document Feedback . . . . . . . . . . . . . . . . . . . . . . . . . xvi

How This Document Is Organized

This document is organized to help you find the information that you want as quickly and easily as possible.

The document contains the following components:

• Chapter 1, “Understanding Brocade SNMP” provides an introduction to Brocade SNMP and

MIBs.

• Chapter 2, “MIB-II (RFC1213-MIB)” provides information for MIB-II.

• Chapter 3, “FE MIB Objects” provides information for FE MIB object types.

• Chapter 4, “Entity MIB Objects” provides information for Entity MIB object types.

• Chapter 5, “SW-MIB Objects” provides information for FC Switch MIB (SW-MIB) object types.

• Chapter 6, “High-Availability MIB Objects” provides information for High-Availability MIB object

types.

• Chapter 7, “FICON MIB Objects” provides information for FICON MIB (LINK-INCIDENT-MIB)

object types.

• Chapter 8, “FibreAlliance MIB Objects” provides information for FibreAlliance MIB

(FCMGMT-MIB) object types.

• Chapter 9, “FCIP MIB Objects”provides information on FCIP MIB support for 7500 switches and

FC4-18i blades.

• Chapter 10, “iSCSI MIB Objects”provides information on iSCSI MIB support for 7500 switches

and FC4-18i blades.

• Appendix A, “MIB Object Groupings” is a function-based listing of MIB objects.

• Appendix B, “MIB OIDs and Their Matching Object Names” provides a listing of the MIB object

names and the corresponding MIB Object ID (OID) associated with each.

Fabric OS MIB Reference xi 53-1000602-02

Page 12

Supported Hardware and Software

In those instances in which procedures or parts of procedures documented here apply to some switches but not to others, this guide identifies exactly which switches are supported and which are not.

Although many different software and hardware configurations are tested and supported by Brocade Communications Systems, Inc. for 6.1.0, documenting all possible configurations and scenarios is beyond the scope of this document.

This document supports Brocade Fabric OS versions v6.1.0 and earlier versions, v6.0..0, v5.3.x, v

5.2.x, v5.1.x, v5.0.x, v4.4.0, v4.2.x, v4.1.x, v3.2.x, v3.1.x and all switches supporting these Fabric OS versions, including:

• Brocade 200E Switch

• Brocade 300 switch

• Brocade 3014 Switch

• Brocade 3016 Switch

• Brocade 3200 Switch

• Brocade 3250 Switch

• Brocade 3800 Switch

• Brocade 3850 Switch

• Brocade 3900 Switch

• Brocade 4012 Switch

• Brocade 4100 Switch

• Brocade 4020 Switch

• Brocade 4900 Switch

• Brocade 5000 Switch

• Brocade 5100 switch

• Brocade 5300 switch

• Brocade 7500 Switch

• Brocade 7600 Switch

• Brocade 12000 Director

• Brocade 24000 Director

• Brocade 48000 Director

• Brocade DCX

• FA4-16 Blade

• FC10-6 Blade

• FC4-16IP Blade

• FC4-48C Blade

• FR4-18i Blade

• FC8-16 Blade

• FC8-32 Blade

xii Fabric OS MIB Reference

53-1000602-02

Page 13

• FC8-48 Blade

Although many different software and hardware configurations are tested and supported by Brocade Communications Systems, Inc. for the Fabric OS v6.1.0 release, documenting all possible configurations and scenarios is beyond the scope of this document. This document supports only the Fabric OS versions and switches listed above.

What’s New in This Document

The following changes have been made since this document was last released:

• Information that was changed:

- Information included for support of Brocade 300, 5100 and 5300

- Miscellaneous additions and corrections have been made throughout

For further information about new features and documentation updates for this release, refer to the release notes.

Document Conventions

This section describes text formatting conventions and important notices formats.

TEXT FORMATTING

The narrative-text formatting conventions that are used in this document are as follows:

bold text Identifies command names

Identifies the names of user-manipulated GUI elements Identifies keywords and operands Identifies text to enter at the GUI or CLI

italic text Provides emphasis

Identifies variables Identifies paths and Internet addresses Identifies document titles

code text Identifies CLI output

Identifies syntax examples

For readability, command names in the narrative portions of this guide are presented in mixed lettercase: for example, switchShow. In actual examples, command lettercase is often all lowercase. Otherwise, this manual specifically notes those cases in which a command is case sensitive.

Fabric OS MIB Reference xiii 53-1000602-02

Page 14

NOTES, CAUTIONS, AND WARNINGS

The following notices appear in this document.

NOTE

A note provides a tip, emphasizes important information, or provides a reference to related information.

CAUTION

A caution alerts you to potential damage to hardware, firmware, software, or data.

A warning alerts you to potential danger to personnel.

SPECIAL TERM USES

For definitions of SAN-specific terms, visit the Storage Networking Industry Association online dictionary at http://www.snia.org/education/dictionary.

Additional Information

This section lists additional Brocade and industry-specific documentation that you might find helpful.

BROCADE RESOURCES

The following related documentation is provided on the Brocade Documentation CD-ROM and on the Brocade Web site, through Brocade Connect.

NOTE

Go to http://www.brocade.com and click Brocade Connect to register at no cost for a user ID and password.

Fabric OS

• Fabric OS Administrator’s Guide

• Fabric OS Command Reference Manual

• Fabric OS Message Reference

• Brocade Glossary

Fabric OS Optional Features

• Web Tools Administrator’s Guide

• Fabric Watch Administrator’s Guide

• Fabric Manager Administrator’s Guide

• Secure Fabric OS Administrator’s Guide

xiv Fabric OS MIB Reference

53-1000602-02

Page 15

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

OTHER INDUSTRY RESOURCES

In addition to this manual, the following information about fabric security and the Secure Fabric OS product is available:

• White papers, online demos, and data sheets are available through the Brocade Web site at:

http:// www.brocade.com/products/software.jhtml

• Best practice guides, including the SAN Security Best Practice Guide, white papers, online

demos, data sheets, and other documentation is available through the Brocade Partner Web site.

• The CERT

information about certification at:

http://www.cert.org

For additional resource information, visit the Technical Committee T11 Web site. This Web site provides interface standards for high-performance and mass storage applications for Fibre Channel, storage management, and other applications:

Coordination Center of Carnegie Mellon University provides industry-level

http://www.t11.org

For information about the Fibre Channel industry, visit the Fibre Channel Industry Association Web site:

http://www.fibrechannel.org

Getting Technical Help

Contact your switch supplier for hardware, firmware, and software support, including product repairs and part ordering. To expedite your call, have the following information immediately available:

1. General Information

- Technical Support contract number, if applicable

- Switch model

- Switch operating system version

- Error numbers and messages received

- supportSave command output

- Detailed description of the problem, including the switch or fabric behavior immediately

following the problem, and specific questions

- Description of any troubleshooting steps already performed and the results

Fabric OS MIB Reference xv 53-1000602-02

Page 16

- Serial console and Telnet session logs

- Syslog message logs

2. Switch Serial Number

The switch serial number and corresponding bar code are provided on the serial number label, as shown here:

*FT00X0054E9*

FT00X0054E9

The serial number label is located as follows:

- Brocade 200E—On the nonport side of the chassis

- Brocade 300, 4100, 4900, 5100, 5300, and 7500—On the switch ID pull-out tab located

inside the chassis on the port side on the left

- Brocade 5000—On the switch ID pull-out tab located on the bottom of the port side of the

switch

- Brocade 7600—On the bottom of the chassis

- Brocade 48000 and Brocade DCX—Inside the chassis next to the power supply bays.

3. World Wide Name (WWN)

- Use the wwn command to display the switch WWN. If you cannot use the wwn command

because the switch is inoperable, you can get the WWN from the same place as the serial number.

Document Feedback

Because quality is our first concern at Brocade, 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 and as much detail as possible about your comment, including the topic heading and page number and your suggestions for improvement.

xvi Fabric OS MIB Reference

53-1000602-02

Page 17

Chapter

Understanding Brocade SNMP

The Simple Network Management Protocol (SNMP) is an industry-standard method of monitoring and managing network devices. This protocol promotes interoperability, because SNMP-capable systems must adhere to a common set of framework and language rules.

Understanding the components of SNMP makes it possible to use third-party tools to view, browse, and manipulate Brocade switch variables (MIBs) remotely as well as to set up an enterprise-level management process. Every Brocade switch and director supports SNMP.

This chapter discusses the following:

•Setting the SNMP Security Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

•Understanding SNMP Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

•Loading Brocade MIBs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

•Brocade 7500 / FR4-18i and Brocade MIBs. . . . . . . . . . . . . . . . . . . . . . . . . 11

•Firmware Upgrades and Enabled Traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

•Fabric OS Commands for Configuring SNMP. . . . . . . . . . . . . . . . . . . . . . . . . 12

Setting the SNMP Security Level

Recipients for SNMP traps are restricted according to security levels. Security levels are selected and set for a switch using the snmpconfig --set seclevel command. To select and set SNMP security levels, issue the command snmpconfig --set seclevel after having logged in to the switch as admin.

The following example sets the SNMP security level to 1 (authentication only). This setting allows all snmpv1 users to perform GET and SET operations on mibs, but creates an exception for snmpv3 users that do not have authentication and privacy privileges (noAuthnoPriv).

switch:admin> snmpconfig --set seclevel Select SNMP Security Level (0 = No security, 1 = Authentication only, 2 = Authentication and Privacy, 3 = sxNo Access): (0..3) [0] Select SNMP SET Security Level (0 = No security, 1 = Authentication only, 2 = Authentication and Privacy, 3 = No Access): (0..3) [0]

TABLE 1 Security Level Options

security level Protocol Query Behavior Traps

No security [0] (noAuthnoPriv)

Authentication only [1] (authNoPriv)

SNMPv1 SNMPv3

Allowed. Allowed.

Allowed. All SNMPv3 users allowed except noAuthNoPriv users.

Sent. Sent.

Sent. Sent for all SNMPv3 users except noAuthNoPriv users.

Fabric OS MIB Reference 1 53-1000602-02

Page 18

Understanding SNMP Basics

TABLE 1 Security Level Options (Continued)

security level Protocol Query Behavior Traps

Authentication and Privacy [2]

(authPriv)

No Access [3]SNMPv1

SNMPv1 SNMPv3

SNMPv3

Understanding SNMP Basics

Every Brocade switch carries an agent and management information base (MIB), as shown in

Figure 1. The agent accesses information about a device and makes it available to an SNMP

network management station.

Management Station

FIGURE 1 SNMP Structure

When active, the management station can get information or set information when it queries an agent. SNMP commands, such as get, set, getnext, setnext, and getresponse, are sent from the management station, and the agent replies once the value is obtained or modified ( Figure 2). Agents use variables to report such data as the number of bytes and packets in and out of the device, or the number of broadcast messages sent and received. These variables are also known as managed objects. All managed objects are contained in the MIB.

Not allowed. Only SNMPv3 users with authPriv

privilege are allowed.

Not allowed. Not Sent.

SNMP

Agent

Not Sent. Sent only for authPriv users.

MIB

get, getnext, se

Management Station

Agent

FIGURE 2 SNMP Query

The management station can also receive traps, unsolicited messages from the switch agent if an unusual event occurs. Refer to “Understanding SNMP Traps” on page 4 for more information.

Management Station

TRAP

Agent

FIGURE 3 SNMP Trap

The agent can receive queries from one or more management stations and can send traps to up to six management stations.

2 Fabric OS MIB Reference

53-1000602-02

Page 19

Understanding SNMP Basics

Understanding MIBs

The management information base (MIB) is a database of monitored and managed information on a device, in this case a Brocade switch. The MIB structure can be represented by a tree hierarchy. The root splits into three main branches: International Organization for Standardization (ISO), Consultative Committee for International Telegraph and Telephone (CCITT), and joint ISO/CCITT. These branches have short text strings and integers (OIDs) to identify them. Text strings describe object names, while integers allow software to create compact, encoded representations of the names.

Each MIB variable is assigned an object identifier (OID). The OID is the sequence of numeric labels on the nodes along a path from the root to the object. For example, as shown in Figure 4, the Brocade SW.MIB OID is:

1.3.6.1.4.1.1588

The corresponding name is:

iso.org.dod.internet.private.enterprise.bsci

The other branches are part of the standard MIBs, and the portions relevant to configuring SNMP on a Brocade switch are referenced in the remainder of this reference.

iso (1)

org (3)

Brocade SW MIB

1.3.6.1.4.1.1588

private (4)

enterprise (1)

bcsi (1588)

directory (1)

sysDescr (1)

system (1)

mgmt (2)

mib-2 (1)

interface (2)

sysObjectID (2)

dod (6)

internet (1)

experimental (3)

fibreChannel (42)

fcFe (1)

fcFabric (2)

FIGURE 4 Brocade MIB Tree Location

Use a MIB browser to access the MIB variables: all MIB browsers perform queries and load MIBs.

Since different vendors vary the information in their private enterprise MIBs, it is necessary to verify their information. The Fibre Channel MIB standards dictate that certain information be included in all MIBs: it is the vendors’ responsibility to follow the standards. The standards are:

• FibreAlliance (FA) MIB: Brocade supports version 3.0.

• Fabric Element (FE) MIB: accepted by the Internet Engineering Task Force (IETF).

Fabric OS MIB Reference 3 53-1000602-02

Page 20

Understanding SNMP Basics

Once loaded, the MAX-ACCESS provides access levels between the agent and management station. The access levels are as follows:

• not-accessible

• read-create

• read-only - Public

• read-write - Private

Brocade supports FE_RCF2837.mib under the MIB-II branch in Fabric OS v6.1.0, v6.0.0, v4.x, v3.2.0, and v3.1.x and the experimental version, FE_EXP.mib, in Fabric OS v2.6.x and 3.0.x. This latest version of the FE MIB references the FRAMEWORK.MIB and, based on the MIB browser, it is necessary to load this MIB before the FE.MIB. Refer to “Loading Brocade MIBs” on page 6 for more information.

You cannot read or write to this variable.

Specifies a tabular object that can be read, modified, or created as a new row in a table.

You can only monitor information.

You can read or modify this variable.

Understanding SNMP Traps

An unsolicited message that comes to the management station from the SNMP agent on the device is called a trap. Brocade switches send traps out on UDP port 162 and to any configured port. In order to receive traps, the management station IP address and severity level must be configured on the switch. Up to six trap recipients can be configured using Web Tools or the snmpConfig command. You can define a different message severity level for each recipient so that some recipients receive all trap messages and others receive only the most critical.

There are two main MIB trap choices:

• FibreAlliance MIB trap - Associated with the Fibre Alliance MIB (FA-MIB), this MIB manages SAN

switches and devices from any company that complies with Fibre Alliance specifications.

• Brocade-specific MIB trap - Associated with the Brocade-specific Brocade MIB (SW-MIB),

manages Brocade switches only.

There is some overlap in the functionality of these MIBs. If you enable both SW-MIB and FA-MIB traps, you could receive duplicate messages for the switch events that trigger the trap.

You can also use these additional MIBs and their associated traps: HA-MIB; FICON-MIB; and SW-EXTTRA. You can use the snmpConfig command to disable the FA-MIB, HA-MIB, FICON-MIB, and SW_EXTTRA; but neither the SW-MIB or the FE-MIB can be disabled.

An event trap (swEventTrap, connUnitEventTrap, or swFabricWatchTrap) is basically an error message (errShow output) that is SNMP-formatted and delivered.

FA Traps

Consider enabling the FA traps if you want to use SNMP to monitor multiple connectivity units, including Brocade switches.

The switchStatusPolicySet command determines the FA-TRAP switch status-related outputs:

• connUnitStatusChange

• connUnitSensorStatusChange

4 Fabric OS MIB Reference

53-1000602-02

Page 21

Understanding SNMP Basics

• connUnitPortStatusChange

• connUnitEventTrap

The MIB-II system description swEventTrapLevel determines the output for the connUnitEventTrap. Events in the Error Log of a severity at or above the configured threshold will generate SNMP traps.

The Fibre Alliance Trap (FA-TRAP) can be configured to send traps using the snmpConfig command. Refer to the Fabric OS Command Reference for more information on this command.

HA Traps

Consider enabling these traps to monitor field-replaceable unit (FRU) status and control processor (CP) status when you have a Brocade director in your environment:

• fruStatusChanged

This trap is generated by a FRU status change, such as a switch reboot or disabling or enabling a FRU component such as (fandisable/fanenable, etc).

• cpStatusChanged

This trap is generated by a change in the status of a CP, including a reboot or firmware download.

• fruHistoryTrap

This trap is generated when a FRU is added or removed. fruHistoryTrap is not generated when standby CP is removed.

The high availability trap (HA-TRAP) can be configured to send traps using the snmpConfig command. Refer to the Fabric OS Command Reference for more information on this command.

SW Traps

There are six specific traps defined in Brocade SW-TRAP:

1. swfault (no longer supported)

2. swSensorScn (no longer supported)

3. swFCPortScn

This trap is generated by a port state change.

4. swEventTrap

This trap is generated by any switch event reported to the system error log.

5. swFabricWatchTrap

This trap is generated when any Fabric Watch threshold is reached.

6. swTrackChangesTrap

This trap is generated by a login or a logout.

The Brocade trap (SW-TRAP) can be configured to send traps using the snmpConfig command. Refer to the Fabric OS Command Reference for more information on this command.

Fabric OS MIB Reference 5 53-1000602-02

Page 22

Loading Brocade MIBs

Object Instances

MIB objects are defined by the OID, which is the type of object, and by the instance number, which is an instance of that MIB object. A Fibre Channel port is a MIB object, and port 0 is an instance of that object. The following is an OID number and an instance number:

1.3.6.1.4.1.1588.2.1.1.1.6.2.1.11.5

where:

1.3.6.1.4.1.1588.2.1.1.1.6.2.1.11 is the OID (of swFCPortTxWords) and 5 is the instance

ID for port 4.

You must add 1 to the port number to get its instance number in SNMP because SNMP numbering starts at 1; switch port numbering starts at 0.

Loading Brocade MIBs

The Brocade MIB is a set of variables that are private extensions to the Internet standard MIB-II. The Brocade agents support many other Internet-standard MIBs. These standard MIBs are defined in RFC publications. To find specific MIB information, examine the Brocade proprietary MIB structure and the standard RFC MIBs supported by Brocade.

Brocade MIB Files

The Brocade MIB files are as follows:

• BRCD_v5_0.mib

• brcdfcip.mib

• CPQ_HOST.mib

• CPQ_RACK.mib

• ENTITY_RFC2737.mib

• FA_v3_0.mib

• fcip.mib

• FE_RFC2837.mib

• FICON_v5_0.mib

• HA_v5_1.mib

• IF.mib

• IF_TYPE.mib

• INET_ADDR.mib

• ISCSI_RFC4544.mib

• SW_v5_7.mib

Before Loading MIBs

Before loading Brocade MIB files, ensure that you have the correct version of SNMP for your Fabric OS version ( Table 2).

6 Fabric OS MIB Reference

53-1000602-02

Page 23

Loading Brocade MIBs

TABLE 2 Fabric OS Supported SNMP Versions

Firmware SNMPv1 SNMPv2 SNMPv3

Fabric OS v2.6.2 and previous Yes No

Fabric OS v3.2.0 and previous Yes No

Fabric OS v4.2.0 and previous Yes No

Fabric OS v4.4.0 Yes No

Fabric OS v5.x Yes Yes

Fabric OS v6.0.0 Yes Yes Yes

Fabric OS v6.1.0 Yes yes Yes

1. The corresponding Fabric OS has SNMPv2 capabilities, but it is not officially supported by Brocade.

2. Fabric OS v4.4.0 and v5.x support SNMPv3-USM MIB (snmpUsmMIB), which is available as RFC 3414.

3. SNMPv2 is supported from FOS v5.0.4 and higher, but SNMP v2 traps are not supported.

Yes

MIB Loading Order

Many MIBs use definitions that are defined in other MIBs. These definitions are listed in the IMPORTS section near the top of the MIB. When loading the Brocade MIBs, refer to Figure 5 to ensure any MIB dependencies are loading in the correct order.

Fabric OS MIB Reference 7 53-1000602-02

Page 24

Loading Brocade MIBs

RFC1213-MIB

MIB-II

RFC1155-SMI

SNMPv2-SMI

SMNPv2-TC

SNMPv2-CONF

Select one

FA_v2_2.mib

FCMGMT-MIB

FOS 2.6.x

FA_v3_0.mib

FCMGMT-MIB

FOS 3.x, 4.x, 5.x

BRCD_v5_0.mib

Brocade-REG-MIB

Brocade-TC

FOS 2.6.x, 3.x, 4.x, 5.x

INET-ADDRESS-MIB

snmpUsmMIB

User-based Security Model

SNMP-FRAMEWORK-MIB

RFC2571

Select one or both

FE_EXP.mib

FCFABRIC-ELEMENT-MIB

FE_RFC2837.mib

FIBRE-CHANNEL-FE-MIB

FOS 3.1.x, 4.x, 5.x

FICON_v5_0.mib

FICON-MIB

FOS 4.x, 5.x

SW_v5_5.mib

FOS 2.6.x, 3.x, 4.x, 5.x

ENTITY_RFC2737.mib

ENTITY-MIB FOS 4.x, 5.x

HA_v5_1.mib

HA-MIB

FOS 4.x, v5.x

fcip.mib

brcdfcip.mib

ISCSI_RFC4544.mib

Legend

Standard MIB File

Module name

Dependency

Brocade MIB

Module name

FOS supported

NOTE

FA_v3_0.mib obsoletes the use of the connUnitPortStatFabricTable used in the FA_v2_2.mib. FA_v3_0.mib now uses the connUnitPortStatTable for port statistics. The FA_v3_0.mib and the FA_v2_2.mib cannot be loaded concurrently on the same SNMP management system.

The FE_RFC2837.mib and the FE_EXP.mib can be loaded concurrently on the same SNMP management system. The FE_EXP.mib was listed in the experimental OID section. The FE_RFC2837.mib has subsequently been ratified by the standards organizations.|

All versions of Fabric OS support SNMPv1. Fabric v2.6.x and v3.2.x partially support SNMPv2. Fabric OS v4.4.0 and v5.0.1 support SNMPv3-USM (snmpUsmMIB) MIB. Fabric OS version 5.3.0 supports the FCIP MIB and ifXtable.

FIGURE 5 Brocade SNMP MIB Dependencies and Advised Installation Order

SNMP CLI usage

An example of the SNMPv3 User/Traps configuration is provided below.

8 Fabric OS MIB Reference

53-1000602-02

Page 25

Loading Brocade MIBs

Configuring SNMPv3 User/Traps

1. Create user on switch using CLI userconfig, with the required role.

switch:admin> userconfig --add fa_adm -r fabricadmin -h0 -a 0-255 Setting initial password for fa_adm Enter new password:******** Re-type new password:******** Account fa_adm has been successfully added. switch:admin>

2. Create the SNMPv3 user as shown below.

switch:admin> snmpconfig --set snmpv3 SNMPv3 user configuration(snmp user not configured in FOS user database will have physical AD and admin role as the default): User (rw): [snmpadmin1] fa_adm Auth Protocol [MD5(1)/SHA(2)/noAuth(3)]: (1..3) [3] 1 New Auth Passwd:******** Verify Auth Passwd:******** Priv Protocol [DES(1)/noPriv(2)/3DES(3)/AES128(4)/AES192(5)/AES256(6)]): (1..6) [2] 1 New Priv Passwd:******** Verify Priv Passwd:******** User (rw): [snmpadmin2] Auth Protocol [MD5(1)/SHA(2)/noAuth(3)]: (1..3) [3] Priv Protocol [DES(1)/noPriv(2)/3DES(3)/AES128(4)/AES192(5)/AES256(6)]): (2..2) [2] User (rw): [snmpadmin3] Auth Protocol [MD5(1)/SHA(2)/noAuth(3)]: (1..3) [3] Priv Protocol [DES(1)/noPriv(2)/3DES(3)/AES128(4)/AES192(5)/AES256(6)]): (2..2) [2] User (ro): [snmpuser1] Auth Protocol [MD5(1)/SHA(2)/noAuth(3)]: (1..3) [3] Priv Protocol [DES(1)/noPriv(2)/3DES(3)/AES128(4)/AES192(5)/AES256(6)]): (2..2) [2] User (ro): [snmpuser2] Auth Protocol [MD5(1)/SHA(2)/noAuth(3)]: (1..3) [3] Priv Protocol [DES(1)/noPriv(2)/3DES(3)/AES128(4)/AES192(5)/AES256(6)]): (2..2) [2] User (ro): [snmpuser3] Auth Protocol [MD5(1)/SHA(2)/noAuth(3)]: (1..3) [3] Priv Protocol [DES(1)/noPriv(2)/3DES(3)/AES128(4)/AES192(5)/AES256(6)]): (2..2) [2]

SNMPv3 trap recipient configuration: Trap Recipient's IP address : [0.0.0.0] 10.202.95.70 UserIndex: (1..6) [1] Trap recipient Severity level : (0..5) [0] 5 Trap recipient Port : (0..65535) [162] 65000 Trap Recipient's IP address : [0.0.0.0] Trap Recipient's IP address : [0.0.0.0] Trap Recipient's IP address : [0.0.0.0] Trap Recipient's IP address : [0.0.0.0] Trap Recipient's IP address : [0.0.0.0]

Committing configuration...done. switch:admin> switch:admin> snmpconfig --show snmpv3

Fabric OS MIB Reference 9 53-1000602-02

Page 26

Loading Brocade MIBs

SNMPv3 USM configuration: User 1 (rw): fa_adm Auth Protocol: MD5 Priv Protocol: DES User 2 (rw): snmpadmin2 Auth Protocol: noAuth Priv Protocol: noPriv User 3 (rw): snmpadmin3 Auth Protocol: noAuth Priv Protocol: noPriv User 4 (ro): snmpuser1 Auth Protocol: noAuth Priv Protocol: noPriv User 5 (ro): snmpuser2 Auth Protocol: noAuth Priv Protocol: noPriv User 6 (ro): snmpuser3 Auth Protocol: noAuth Priv Protocol: noPriv

SNMPv3 Trap configuration: Trap Entry 1: 10.202.95.70 Trap Port: 65000 Trap User: fa_adm Trap recipient Severity level: 5 Trap Entry 2: No trap recipient configured yet Trap Entry 3: No trap recipient configured yet Trap Entry 4: No trap recipient configured yet Trap Entry 5: No trap recipient configured yet Trap Entry 6: No trap recipient configured yet switch:admin>

3. Set the security level.

switch:admin> snmpconfig --set secLevel Select SNMP GET Security Level (0 = No security, 1 = Authentication only, 2 = Authentication and Privacy, 3 = No Access): (0..3) [0] 2 Select SNMP SET Security Level (0 = No security, 1 = Authentication only, 2 = Authentication and Privacy, 3 = No Access): (2..3) [2] 2 switch:admin> snmpconfig --show secLevel GET security level = 2, SET level = 2 SNMP GET Security Level: Authentication and Privacy SNMP SET Security Level: Authentication and Privacy

4. In the Manager (SNMP Browser) , create a user fa_adm with Authentication protocol as MD5, Privacy protocol as DES, set the password and set the trap port as 65000. (same values are set as in the switch SNMPv3 configuration).

10 Fabric OS MIB Reference

53-1000602-02

Page 27

Brocade 7500 / FR4-18i and Brocade MIBs

Beginning with release Fabric OS 5.3.0, statistics are available for FCIP tunnels, VEX_Ports, or VE_Ports through the portstatshow command.

The changes in the sensor details for FR4-18i Blade has been incorporated into SNMP. The

“connUnitSensorTable 1.3.6.1.3.94.1.8” on page 902 and “swSensorTable

1.3.6.1.4.1.1588.2.1.1.1.1.22” on page 547 display information consistent with the Fabric OS

sensorShow command.

Access Gateway and Brocade MIBs

Brocade Access Gateway supports the following MIBs:

TABLE 3 Access Gateway MIB Support

MIB Name Supported Description

MIB-2 Yes Updated to support Access Gateway in v5.2.1.

Entity-MIB Yes

HA MIB Yes

SW-MIB No Disabled in Access Gateway because the conventions are specific to

fabric switches.

FA-MIB Yes The connUnitSnsTable is not supported because a switch in Access

Gateway does support name server services.

FE-MIB No Disabled in Access Gateway because the conventions are specific to

fabric switches.

CPQ-Rack MIB Limited Supported on embedded switches only.

FCIP MIB Limited Implemented to support WAN interfaces in Fabric OS v5.3.0

iSCSI MIB Limited Supports displaying information about virtual targets (VTs), iSCSI

sessions, and TCP connection tables, as derived from specific MIB tables

Firmware Upgrades and Enabled Traps

Prior to Fabric OS v4.4, traps were turned on and off as a group (for example, the SW-Trap, or FA-Trap). In these versions of the Fabric OS it was not possible to set individual traps (such as, swSensorStatusChangeTrap, swTrackChangesTrap, or connUnitEventTrap).

In Fabric OS v4.4 or above you can to turn on and off traps individually within a trap group. After the trap group is enabled, the individual traps need to be enabled explicitly.

Because the pre- Fabric OS v4.4 firmware only has trap group level settings, when you upgrade to the Fabric OS v4.4 firmware or above, individual traps are turned off by default even if the corresponding trap group was enabled before upgrading. When moving from a downlevel version to Fabric OS v4.4 or above you must use the snmpconfig command to turn on explicitly the individual traps within each trap group.

Fabric OS MIB Reference 11 53-1000602-02

Page 28

Fabric OS Commands for Configuring SNMP

Use the following commands to configure MIBs in the Fabric OS. Refer to the Fabric OS Administrator’s Guide for procedures for configuring SNMP on the Brocade switches.

TABLE 4 Commands for Configuring SNMP

Command Description

snmpConfig This command has all the features of the existing the agtcfg* commands; in

addition, it has SNMPv3 configuration parameters.

snmpMibCapSet Enhanced in Fabric OS v4.4 to provide a filter facility at the trap level (previously the

filter facility was at MIB level for traps). Enhanced in Fabric OS 5.3.0 to support enabling and disabling of MIBs and traps

for the FCIP MIB and the ifTable and ifXTable for FC ports (MIB II Intefaces group).

snmpMibCapShow Displays the snmpMibCapSet command settings.

agtcfgDefault This command is deprecated.Only the snmpConfig command is working.

agtcfgSet This command is deprecated.Only the snmpConfig command is working.

agtcfgShow This command is deprecated.Only the snmpConfig command is working.

SNMPMibCapSet This command is deprecated.Only the snmpConfig command is working.

SNMPMibCapShow This command is deprecated.Only the snmpConfig command is working.

Support for Administrative Domains

Administrative Domains are supported in Fabric OS Version 5.3.0 and later releases. An Administrative Domain (AD) is a domain within a fabric. Administrative domains can be used to limit administrator access within a fabric, and to provide service providers with a means to assign portions of a fabric to individual consumers. An AD may contain switches, devices, and ports. An AD may also limit access to a configured set of users.

Support for Role Based Access Control

Role Based Access Control (RBAC) is supported in Fabric OS Version 5.3.0 and later releas RBAC applies a fixed set of roles that address the access control needs of a majority of customers. Each role is a set of permissions that can be applied to a user that controls the kinds of jobs and tasks the user can perform on a fabric or fabric element.

Support for IP V6 Addressing

IP V6 addressing is supported in Fabric OS Version 5.3.0 and later releases.

12 Fabric OS MIB Reference

53-1000602-02

Page 29

Chapter

MIB-II (RFC1213-MIB)

This chapter provides descriptions and other information specific to MIB-II, and includes the following sections:

•MIB II Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

•System Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

•Interfaces Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

•AT Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

•IP Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

•ICMP Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

•TCP Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

•UDP Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

•EGP Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

•Transmission Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

•SNMP Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

•ifMIB Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

MIB II Overview

The descriptions of each of the MIB variables in this chapter come directly from the MIB-II itself. The notes that follow the descriptions refer to Brocade-specific information and are provided by Brocade.

Fabric OS MIB Reference 13 53-1000602-02

Page 30

MIB-II Object Hierarchy

Figure 6 through Figure 15 depicts the organization and structure of MIB-II.

- iso

- org

- dod

FIGURE 6 MIB-II Overall Hierarchy

- internet

- directory

- mgmt

- mib-2

- system

- interfaces

- at

- ip

- icmp

- tcp

- udp

- egp

- transmission

- snmp

- iFMIB

- system (1.3.6.1.2.1.1)

- sysDescr 1.3.6.1.2.1.1.1

- sysObjectID 1.3.6.1.2.1.1.2

- sysUpTime 1.3.6.1.2.1.1.3

- sysContact 1.3.6.1.2.1.1.4

- sysName 1.3.6.1.2.1.1.5

- sysLocation 1.3.6.1.2.1.1.6

- sysServices 1.3.6.1.2.1.1.7

FIGURE 7 System Hierarchy

14 Fabric OS MIB Reference

53-1000602-02

Page 31

- interfaces (1.3.6.1.2.1.2)

- ifNumber 1.3.6.1.2.1.2.1

- ifTable 1.3.6.1.2.1.2.2

- ifEntry 1.3.6.1.2.1.2.2.1

- ifIndex 1.3.6.1.2.1.2.2.1.1

- ifDescr 1.3.6.1.2.1.2.2.1.2

- ifType 1.3.6.1.2.1.2.2.1.3

- ifMtu 1.3.6.1.2.1.2.2.1.4

- ifSpeed 1.3.6.1.2.1.2.2.1.5

- ifPhysAddress 1.3.6.1.2.1.2.2.1.6

- ifAdminStatus 1.3.6.1.2.1.2.2.1.7

- ifOperStatus 1.3.6.1.2.1.2.2.1.8

- ifLastChange 1.3.6.1.2.1.2.2.1.9

- ifInOctets 1.3.6.1.2.1.2.2.1.10

- ifInUcastPkts 1.3.6.1.2.1.2.2.1.11

- ifInNUcastPkts 1.3.6.1.2.1.2.2.1.12

- ifInDiscards 1.3.6.1.2.1.2.2.1.13

- ifInErrors 1.3.6.1.2.1.2.2.1.14

- ifInUnknownProtos 1.3.6.1.2.1.2.2.1.15

- ifOutOctets 1.3.6.1.2.1.2.2.1.16

- ifOutUcastPkts 1.3.6.1.2.1.2.2.1.17

- ifOutNUcastPkts 1.3.6.1.2.1.2.2.1.18

- ifOutDiscards 1.3.6.1.2.1.2.2.1.19

- ifOutErrors 1.3.6.1.2.1.2.2.1.20

- ifOutQLen 1.3.6.1.2.1.2.2.1.21

- ifSpecific 1.3.6.1.2.1.2.2.1.22

- ifOutUcastPkts 1.3.6.1.2.1.2.2.1.17

- ifOutNUcastPkts 1.3.6.1.2.1.2.2.1.18

- ifOutDiscards 1.3.6.1.2.1.2.2.1.19

- ifOutErrors 1.3.6.1.2.1.2.2.1.20

- ifOutQLen 1.3.6.1.2.1.2.2.1.21

- ifSpecific 1.3.6.1.2.1.2.2.1.22

MIB-II Object Hierarchy

FIGURE 8 Interfaces Hierarchy

- at (1.3.6.1.2.1.3)

- atTable 1.3.6.1.2.1.3.1

- atEntry 1.3.6.1.2.1.3.1.1

- atIfIndex 1.3.6.1.2.1.3.1.1.1

- atPhysAddress 1.3.6.1.2.1.3.1.1.2

- atNetAddress 1.3.6.1.2.1.3.1.1.3

FIGURE 9 AT Hierarchy

Fabric OS MIB Reference 15 53-1000602-02

Page 32

MIB-II Object Hierarchy

- ip (1.3.6.1.2.1.4)

- ipForwarding 1.3.6.1.2.1.4.1

- ipDefaultTTL 1.3.6.1.2.1.4.2

- ipInReceives 1.3.6.1.2.1.4.3

- ipInHdrErrors 1.3.6.1.2.1.4.4

- ipInAddrErrors 1.3.6.1.2.1.4.5

- ipForwDatagrams 1.3.6.1.2.1.4.6

- ipInUnknownProtos 1.3.6.1.2.1.4.7

- ipInDiscards 1.3.6.1.2.1.4.8

- ipInDelivers 1.3.6.1.2.1.4.9

- ipOutRequests 1.3.6.1.2.1.4.10

- ipOutDiscards 1.3.6.1.2.1.4.11

- ipOutNoRoutes 1.3.6.1.2.1.4.12

- ipReasmTimeout 1.3.6.1.2.1.4.13

- ipReasmReqds 1.3.6.1.2.1.4.14

- ipReasmOKs 1.3.6.1.2.1.4.15

- ipReasmFails 1.3.6.1.2.1.4.16

- ipFragOKs 1.3.6.1.2.1.4.17

- ipFragFails 1.3.6.1.2.1.4.18

- ipFragCreates 1.3.6.1.2.1.4.19

- ipAddrTable 1.3.6.1.2.1.4.20

- ipAddrEntry 1.3.6.1.2.1.4.20.1

- ipAdEntAddr 1.3.6.1.2.1.4.20.1.1

- ipAdEntIfIndex 1.3.6.1.2.1.4.20.1.2

- ipAdEntNetMask 1.3.6.1.2.1.4.20.1.3

- ipAdEntBcastAddr 1.3.6.1.2.1.4.20.1.4

- ipAdEntReasmMaxSize 1.3.6.1.2.1.4.20.1.5

- ipRouteTable 1.3.6.1.2.1.4.21

- ipRouteEntry 1.3.6.1.2.1.4.21.1

- ipRouteDest 1.3.6.1.2.1.4.21.1.1

- ipRouteIfIndex 1.3.6.1.2.1.4.21.1.2

- ipRouteMetric1 1.3.6.1.2.1.4.21.1.3

- ipRouteMetric2 1.3.6.1.2.1.4.21.1.4

- ipRouteMetric3 1.3.6.1.2.1.4.21.1.5

- ipRouteMetric4 1.3.6.1.2.1.4.21.1.6

- ipRouteNextHop 1.3.6.1.2.1.4.21.1.7

- ipRouteType 1.3.6.1.2.1.4.21.1.8

- ipRouteProto 1.3.6.1.2.1.4.21.1.9

- ipRouteAge 1.3.6.1.2.1.4.21.1.10

- ipRouteMask 1.3.6.1.2.1.4.21.1.11

- ipRouteMetric5 1.3.6.1.2.1.4.21.1.12

- ipRouteInfo 1.3.6.1.2.1.4.21.1.13

- ipNetToMediaTable 1.3.6.1.2.1.4.22

- ipNetToMediaEntry 1.3.6.1.2.1.4.22.1

- ipNetToMediaIfIndex 1.3.6.1.2.1.4.22.1.1

- ipNetToMediaPhysAddress 1.3.6.1.2.1.4.22.1.2

- ipNetToMediaNetAddress 1.3.6.1.2.1.4.22.1.3

- ipNetToMediaType 1.3.6.1.2.1.4.22.1.4

- ipRoutingDiscards 1.3.6.1.2.1.4.23

FIGURE 10 IP Hierarchy

16 Fabric OS MIB Reference

53-1000602-02

Page 33

- icmp (1.3.6.1.2.1.5)

- icmpInMsgs 1.3.6.1.2.1.5.1

- icmpInErrors 1.3.6.1.2.1.5.2

- icmpInDestUnreachs 1.3.6.1.2.1.5.3

- icmpInTimeExcds 1.3.6.1.2.1.5.4

- icmpInParmProbs 1.3.6.1.2.1.5.5

- icmpInSrcQuenchs 1.3.6.1.2.1.5.6

- icmpInRedirects 1.3.6.1.2.1.5.7

- icmpInEchos 1.3.6.1.2.1.5.8

- icmpInEchoReps 1.3.6.1.2.1.5.9

- icmpInTimestamps 1.3.6.1.2.1.5.10

- icmpInTimestampReps 1.3.6.1.2.1.5.11

- icmpInAddrMasks 1.3.6.1.2.1.5.12

- icmpInAddrMaskReps 1.3.6.1.2.1.5.13

- icmpOutMsgs 1.3.6.1.2.1.5.14

- icmpOutErrors 1.3.6.1.2.1.5.15

- icmpOutDestUnreachs 1.3.6.1.2.1.5.16

- icmpOutTimeExcds 1.3.6.1.2.1.5.17

- icmpOutParmProbs 1.3.6.1.2.1.5.18

- icmpOutSrcQuenchs 1.3.6.1.2.1.5.19

- icmpOutRedirects 1.3.6.1.2.1.5.20

- icmpOutEchos 1.3.6.1.2.1.5.21

- icmpOutEchoReps 1.3.6.1.2.1.5.22

- icmpOutTimestamps 1.3.6.1.2.1.5.23

- icmpOutTimestampReps 1.3.6.1.2.1.5.24

- icmpOutAddrMasks 1.3.6.1.2.1.5.25

- icmpOutAddrMaskReps 1.3.6.1.2.1.5.26

- icmpOutSrcQuenchs 1.3.6.1.2.1.5.19

- icmpOutRedirects 1.3.6.1.2.1.5.20

- icmpOutEchos 1.3.6.1.2.1.5.21

- icmpOutEchoReps 1.3.6.1.2.1.5.22

- icmpOutTimestamps 1.3.6.1.2.1.5.23

- icmpOutTimestampReps 1.3.6.1.2.1.5.24

- icmpOutAddrMasks 1.3.6.1.2.1.5.25

- icmpOutAddrMaskReps 1.3.6.1.2.1.5.26

MIB-II Object Hierarchy

FIGURE 11 ICMP Hierarchy

Fabric OS MIB Reference 17 53-1000602-02

Page 34

MIB-II Object Hierarchy

- tcp (1.3.6.1.2.1.6)

- tcpRtoAlgorithm 1.3.6.1.2.1.6.1

- tcpRtoMin 1.3.6.1.2.1.6.2

- tcpRtoMax 1.3.6.1.2.1.6.3

- tcpMaxConn 1.3.6.1.2.1.6.4

- tcpActiveOpens 1.3.6.1.2.1.6.5

- tcpPassiveOpens 1.3.6.1.2.1.6.6

- tcpAttemptFails 1.3.6.1.2.1.6.7

- tcpEstabResets 1.3.6.1.2.1.6.8

- tcpCurrEstab 1.3.6.1.2.1.6.9

- tcpInSegs 1.3.6.1.2.1.6.10

- tcpOutSegs 1.3.6.1.2.1.6.11

- tcpRetransSegs 1.3.6.1.2.1.6.12

- tcpConnTable 1.3.6.1.2.1.6.13

- tcpConnEntry 1.3.6.1.2.1.6.13.1

- tcpConnState 1.3.6.1.2.1.6.13.1.1

- tcpConnLocalAddress 1.3.6.1.2.1.6.13.1.2

- tcpConnLocalPort 1.3.6.1.2.1.6.13.1.3

- tcpConnRemAddress 1.3.6.1.2.1.6.13.1.4

- tcpConnRemPort 1.3.6.1.2.1.6.13.1.5

- tcpInErrs 1.3.6.1.2.1.6.14

- tcpOutRsts 1.3.6.1.2.1.6.15

FIGURE 12 TCP Hierarchy

- udp (1.3.6.1.2.1.7)

- udpInDatagrams 1.3.6.1.2.1.7.1

- udpNoPorts 1.3.6.1.2.1.7.2

- udpInErrors 1.3.6.1.2.1.7.3

- udpOutDatagrams 1.3.6.1.2.1.7.4

- udpTable 1.3.6.1.2.1.7.5

- udpEntry 1.3.6.1.2.1.7.5.1

- udpLocalAddress 1.3.6.1.2.1.7.5.1.1

- udpLocalPort 1.3.6.1.2.1.7.5.1.2

FIGURE 13 udp Hierarchy

18 Fabric OS MIB Reference

53-1000602-02

Page 35

- egp (1.3.6.1.2.1.8)

- Transmission Group

- egpInErrors

- egpOutMsgs

- egpOutErrors

- egpNeighTable

- egpNeighEntry

- egpNeighState

- egpNeighAddr

- egpNeighAs

- egpNeighInMsgs

- egpNeighInErrs

- egpNeighOutMsgs

- egpNeighOutErrs

- egpNeighInErrMsgs

- egpNeighOutErrMsgs

- egpNeighStateUps

- egpNeighStateDowns

- egpNeighIntervalHello

- egpNeighIntervalPoll

- egpNeighMode

- egpNeighEventTrigger

- egpAs

MIB-II Object Hierarchy

FIGURE 14 egp Hierarchy

- snmp (1.3.6.1.2.1.11)

- snmpInPkts 1.3.6.1.2.1.11.1

- snmpOutPkts 1.3.6.1.2.1.11.2

- snmpInBadVersions 1.3.6.1.2.1.11.3

- snmpInBadCommunityNames 1.3.6.1.2.1.11.4

- snmpInBadCommunityUses 1.3.6.1.2.1.11.5

- snmpInASNParseErrs 1.3.6.1.2.1.11.6

- snmpInTooBigs 1.3.6.1.2.1.11.8

- snmpInNoSuchNames 1.3.6.1.2.1.11.9

- snmpInBadValues 1.3.6.1.2.1.11.10

- snmpInReadOnlys 1.3.6.1.2.1.11.11

- snmpInGenErrs 1.3.6.1.2.1.11.12

- snmpInTotalReqVars 1.3.6.1.2.1.11.13

- snmpInTotalSetVars 1.3.6.1.2.1.11.14

- snmpInGetRequests 1.3.6.1.2.1.11.15

- snmpInGetNexts 1.3.6.1.2.1.11.16

- snmpInSetRequests 1.3.6.1.2.1.11.17

- snmpInGetResponses 1.3.6.1.2.1.11.18

- snmpInTraps 1.3.6.1.2.1.11.19

- snmpOutTooBigs 1.3.6.1.2.1.11.20

- snmpOutNoSuchNames 1.3.6.1.2.1.11.21

- snmpOutBadValues 1.3.6.1.2.1.11.22

- snmpOutGenErrs 1.3.6.1.2.1.11.24

- snmpOutGetRequests 1.3.6.1.2.1.11.25

- snmpOutGetNexts 1.3.6.1.2.1.11.26

- snmpOutSetRequests 1.3.6.1.2.1.11.27

- snmpOutGetResponses 1.3.6.1.2.1.11.28

- snmpOutTraps 1.3.6.1.2.1.11.29

- snmpEnableAuthenTraps 1.3.6.1.2.1.11.30

FIGURE 15 snmp Hierarchy

Fabric OS MIB Reference 19 53-1000602-02

Page 36

MIB-II Object Hierarchy

- ifMIB (1.3.6.1.2.1.31)

FIGURE 16 ifMIB Hierarchy

20 Fabric OS MIB Reference

53-1000602-02

Page 37

Textual Conventions

Tab le 5 lists the textual conventions used for MIB-II.

TABLE 5 MIB-II Textual Conventions

Type Definition Value

DisplayString Octet String of size 0 to 255

PhysAddress Octet String

Textual Conventions

Fabric OS MIB Reference 21 53-1000602-02

Page 38

Objects and Types Imported

The following objects and types are imported from RFC1155-SMI:

• mgmt

• NetworkAddress

• IpAddress

• Counter

• Gauge

• TimeTicks

System Group

All systems must implement the System Group. If an agent is not configured to have a value for any of the System Group variables, a string of length 0 is returned.

22 Fabric OS MIB Reference

53-1000602-02

Page 39

sysDescr 1.3.6.1.2.1.1.1

A textual description of the entity. This value should include the full name and version identification of the hardware type, software operating system, and networking software.

Format This must contain only printable ASCII characters.

Set command Set this value using the snmpconfig command.

Default The switch type. The default value is either Fibre Channel Switch or Access Gateway.

sysDescr 1.3.6.1.2.1.1.1

Fabric OS MIB Reference 23 53-1000602-02

Page 40

sysObjectID 1.3.6.1.2.1.1.2

The vendor’s authoritative identification of the network management subsystem contained in the entity. This value is allocated within the SMI enterprises subtree (1.3.6.1.4.1) and provides an easy and unambiguous means for determining what kind of device is being managed.

Example If a vendor “NetYarn, Inc.” was assigned the subtree 1.3.6.1.4.1.4242, it could assign the identifier

1.3.6.1.4.1.4242.1.1 to its “Knit Router”.

Default The device type. The default value is either:

• Fibre Channel Switches:

iso.org.dod.internet.private.enterprises.bcsi.commDev.fibrechannel.fcSwitch.sw

• Brocade Access Gateway:

iso.org.dod.internet.private.enterprises.bcsi.commDev.fibrechannel.fcSwitch.sw

24 Fabric OS MIB Reference

53-1000602-02

Page 41

sysUpTime 1.3.6.1.2.1.1.3

The time (in hundredths of a second) since the network management portion of the system was last reinitialized.

sysUpTime 1.3.6.1.2.1.1.3

Fabric OS MIB Reference 25 53-1000602-02

Page 42

sysContact 1.3.6.1.2.1.1.4

The textual identification of the contact person for this managed node, together with information on how to contact this person.

Default Field Support

Set command Set this value using the snmpconfig command.

26 Fabric OS MIB Reference

53-1000602-02

Page 43

sysName 1.3.6.1.2.1.1.5

An administratively assigned name for this managed node. By convention, this is the node’s fully qualified domain name.

Default Preassigned name of the switch

sysName 1.3.6.1.2.1.1.5

Fabric OS MIB Reference 27 53-1000602-02

Page 44

sysLocation 1.3.6.1.2.1.1.6

The physical location of this node (for example, telephone closet, 3rd floor).

Default End User Premise

Set command Set this value using the snmpconfig command.

28 Fabric OS MIB Reference

53-1000602-02

Page 45

sysServices 1.3.6.1.2.1.1.7

A value that indicates the set of services that this entity primarily offers.The value is a sum. This sum initially takes the value 0. Then, for each layer, L, in the range 1 through 7, for which this node performs transactions, 2 raised to (L - 1) is added to the sum. For example, a node that primarily performs routing functions has a value of 4 (2 application services has a value of 72 (2

Calculate In the context of the Internet suite of protocols, values should be calculated accordingly:

Layer functionality 1 = physical (for example, repeaters) 2 = datalink/subnetwork (for example, bridges) 3 = internet (for example, IP gateways) 4 = end-to-end (for example, IP hosts) 7 = applications (for example, mail relays)

For systems including OSI protocols, layers 5 and 6 also can be counted. The return value is always

79.

4-1

sysServices 1.3.6.1.2.1.1.7

3-1

). In contrast, a node that is a host and offers

7-1

+ 2

Interfaces Group

Implementation of the Interfaces group is mandatory for all systems. FCIP tunnel support is added in Fabric OS 5.3.0 and higher. To support FCIP tunneling, entries are created in the ifTable for each WAN interface (GbE port), each FC port, and each FCIP tunnel (transport interface).

Fabric OS MIB Reference 29 53-1000602-02

Page 46

ifNumber 1.3.6.1.2.1.2.1

The number of network interfaces and existing FC ports present on this system, regardless of their current state.This number will vary across platforms ( switches ).

The return value is dynamic for all Brocade switches and depends on the number of GbE ports, FC ports and transport interfaces.

30 Fabric OS MIB Reference

53-1000602-02

Page 47

ifTable 1.3.6.1.2.1.2.2

A list of interface entries. The number of entries is given by the value of ifNumber.

The Interfaces table contains information on the entity’s interfaces. Each interface is thought of as being attached to a subnetwork. Note that this term should not be confused with subnet, which refers to an addressing partitioning scheme used in the Internet suite of protocols.

ifTable 1.3.6.1.2.1.2.2

Fabric OS MIB Reference 31 53-1000602-02

Page 48

ifEntry 1.3.6.1.2.1.2.2.1

An interface entry containing objects at the subnetwork layer and below, for a particular interface.

Index ifIndex

32 Fabric OS MIB Reference

53-1000602-02

Page 49

ifIndex 1.3.6.1.2.1.2.2.1.1

A unique value for each interface.

The values range between 1 and the value of ifNumber. The value for each interface must remain constant, at least from one reinitialization of the entity's network management system to the next reinitialization.

For Network Interface, the number starts from 805306369 and increments with the interface count. For FC Ports, the number starts from 1073741824 and increments with the existing FC Ports.

ifIndex 1.3.6.1.2.1.2.2.1.1

Fabric OS MIB Reference 33 53-1000602-02

Page 50

ifDescr 1.3.6.1.2.1.2.2.1.2

A textual string containing information about the interface. The ifDescr for non-bladed switches includes: lo, eth0, and fc0. The ifDescr for Brocade 12000, 24000, and 48000 directors includes: lo, eth0, fc0, and sit0, as well as fc1, eth0:1, and eth0:2.

Return values

• For WAN interface- GigE port for FCIP

• For transport interface- fcip tunnel ID

• For FC ports- Port name (if set), otherwise, FC Port <slot/port>

34 Fabric OS MIB Reference

53-1000602-02

Page 51

ifType 1.3.6.1.2.1.2.2.1.3

The type of interface, designated by the physical/link protocol(s) immediately below the network layer in the protocol stack.

ifType 1.3.6.1.2.1.2.2.1.3

Return values

• For WAN interface- ethernetCsmacd (6)

• For transport interface-fcipLink(224)

• For FC ports- fibre channel (56)

Fabric OS MIB Reference 35 53-1000602-02

Page 52

ifMtu 1.3.6.1.2.1.2.2.1.4

The size of the largest datagram that can be sent/received on the interface, specified in octets.

Values For interfaces that are used to transmit network datagrams, the value is the size of the largest

network datagram that can be sent on the interface (these values are different for Fabric OS v4.x).

• eth0 returns 1500

• lo returns 16436

• fc0 returns 2024

36 Fabric OS MIB Reference

53-1000602-02

Page 53

ifSpeed 1.3.6.1.2.1.2.2.1.5

An estimate (in bits per second) of the interface's current bandwidth.

Values For interfaces that do not vary in bandwidth or interfaces for which no accurate estimation can be

made, this object should contain the nominal bandwidth. For Fabric OS v4.x, 2 Gbit/sec returns.

• eth0 returns null

• lo returns 1,000,000,000 for 1G

• fc0 returns 2000000000

• For 10G: Value displayed will be 4294967295

• For 8G: Value displayed will be 4294967294

ifSpeed 1.3.6.1.2.1.2.2.1.5

Fabric OS MIB Reference 37 53-1000602-02

Page 54

ifPhysAddress 1.3.6.1.2.1.2.2.1.6

The interface's address at the protocol layer immediately below the network layer in the protocol stack.

Values For interfaces that do not have such an address (for example, a serial line), this object should

contain an octet string of zero length.

• eth0 returns the Mac address for GiGE ports

• lo returns null

• fc0 returns the fibre channel address ID (24-bit Domain:Area:Port format) which is PID

38 Fabric OS MIB Reference

53-1000602-02

Page 55

ifAdminStatus 1.3.6.1.2.1.2.2.1.7

The desired state of the interface.

ifAdminStatus 1.3.6.1.2.1.2.2.1.7

Return Values

• up (1)

• Down (2) or

• testing (3?)

Supports Read only, should return same value with ifOperStatus for WAN and FC ports interfaces.

NOTE

The 3 state (testing) indicates that no operational packets can be passed. This object is read-only in Fabric OS v4.x and above.

Fabric OS MIB Reference 39 53-1000602-02

Page 56

ifOperStatus 1.3.6.1.2.1.2.2.1.8

The current operational state of the interface.

Return values

• up (1)

• Down (2) or

• testing (3?)

Active tunnels will be up; inactive tunnels will be down (configured but not online)

NOTE

.The 3 state (testing) indicates that no operational packets can be passed.

40 Fabric OS MIB Reference

53-1000602-02

Page 57

ifLastChange 1.3.6.1.2.1.2.2.1.9

The value of sysUpTime at the time the interface entered its current operational state. If the current state was entered prior to the last re-initialization of the local network management subsystem, then this object contains a zero value.

ifLastChange 1.3.6.1.2.1.2.2.1.9

Fabric OS MIB Reference 41 53-1000602-02

Page 58

ifInOctets 1.3.6.1.2.1.2.2.1.10

The total number of octets received on the interface, including framing characters.

42 Fabric OS MIB Reference

53-1000602-02

Page 59

ifInUcastPkts 1.3.6.1.2.1.2.2.1.11

The number of subnetwork-unicast packets delivered to a higher-layer protocol.

Not supported.

ifInUcastPkts 1.3.6.1.2.1.2.2.1.11

Fabric OS MIB Reference 43 53-1000602-02

Page 60

ifInNUcastPkts 1.3.6.1.2.1.2.2.1.12

The number of nonunicast packets (for example, subnetwork-broadcast or subnetwork-multicast) delivered to a higher-layer protocol.

Not supported.

44 Fabric OS MIB Reference

53-1000602-02

Page 61

ifInDiscards 1.3.6.1.2.1.2.2.1.13

The number of inbound packets that were chosen to be discarded (even though no errors had been detected) to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free buffer space.

ifInDiscards 1.3.6.1.2.1.2.2.1.13

Fabric OS MIB Reference 45 53-1000602-02

Page 62

ifInErrors 1.3.6.1.2.1.2.2.1.14

The number of inbound packets that contained errors, which thereby prevented them from being deliverable to a higher-layer protocol.

46 Fabric OS MIB Reference

53-1000602-02

Page 63

ifInUnknownProtos 1.3.6.1.2.1.2.2.1.15

The number of packets received by way of the interface that were discarded because of an unknown or unsupported protocol.

Not supported.

ifInUnknownProtos 1.3.6.1.2.1.2.2.1.15

Fabric OS MIB Reference 47 53-1000602-02

Page 64

ifOutOctets 1.3.6.1.2.1.2.2.1.16

The total number of octets transmitted out of the interface, including framing characters.

48 Fabric OS MIB Reference

53-1000602-02

Page 65

ifOutUcastPkts 1.3.6.1.2.1.2.2.1.17

The total number of packets that were requested, by higher-level protocols, to be transmitted to a subnetwork-unicast address, including those that were discarded or not sent.

Not supported.

ifOutUcastPkts 1.3.6.1.2.1.2.2.1.17

Fabric OS MIB Reference 49 53-1000602-02

Page 66

ifOutNUcastPkts 1.3.6.1.2.1.2.2.1.18

The total number of packets that were requested, by higher-level protocols, to be transmitted to a nonunicast address (for example, a subnetwork-broadcast or subnetwork-multicast), including those that were discarded or not sent.

Not supported.

50 Fabric OS MIB Reference

53-1000602-02

Page 67

ifOutDiscards 1.3.6.1.2.1.2.2.1.19

The number of outbound packets that were chosen to be discarded (even though no errors had been detected) to prevent their being transmitted. One possible reason for discarding such a packet could be to free buffer space.

ifOutDiscards 1.3.6.1.2.1.2.2.1.19

Fabric OS MIB Reference 51 53-1000602-02

Page 68

ifOutErrors 1.3.6.1.2.1.2.2.1.20

The number of outbound packets that could not be transmitted because of errors.

52 Fabric OS MIB Reference

53-1000602-02

Page 69

ifOutQLen 1.3.6.1.2.1.2.2.1.21

The length of the output packet queue (in packets).

Not supported.

ifOutQLen 1.3.6.1.2.1.2.2.1.21

Fabric OS MIB Reference 53 53-1000602-02

Page 70

ifSpecific 1.3.6.1.2.1.2.2.1.22

A reference to MIB definitions specific to the particular media being used to realize the interface.

If the interface is realized by an Ethernet, then the value of this object refers to a document defining objects specific to Ethernet. If this information is not present, its value should be set to the Object Identifier 0 0, which is a syntactically valid object identifier, and any conferment implementation of ASN.1 and BER must be able to generate and recognize this value.

Returns

AT Group

• eth0 returns null OID

• lo returns null OID

• fc0 returns null OID

Implementation of the Address Translation group is mandatory for all systems. Note, however, that this group is deprecated by MIB-II. From MIB-II onward, each network protocol group contains its own address translation tables.

54 Fabric OS MIB Reference

53-1000602-02

Page 71

atTable 1.3.6.1.2.1.3.1

The Address Translation group contains one table, which is the union across all interfaces of the translation tables for converting a network address (for example, an IP address) into a subnetwork-specific address. This document refers to such a subnetwork-specific address as a physical address.

For example, for broadcast media, where ARP is in use, the translation table is equivalent to the ARP cache; on an X.25 network, where non-algorithmic translation to X.121 addresses is required, the translation table contains the network address to X.121 address equivalences.

The Address Translation tables contain the network address to physical address equivalences. Some interfaces do not use translation tables for determining address equivalences (for example, DDN-X.25 has an algorithmic method); if all interfaces are of this type, then the Address Translation table is empty.

atTable 1.3.6.1.2.1.3.1

Fabric OS MIB Reference 55 53-1000602-02

Page 72

atEntry 1.3.6.1.2.1.3.1.1

Each entry contains one network address to physical address equivalence.

Index atIfIndex, atNetAddress

56 Fabric OS MIB Reference

53-1000602-02

Page 73

atIfIndex 1.3.6.1.2.1.3.1.1.1

The interface on which this entry's equivalence is effective. The interface identified by a particular value of this index is the same interface as identified by the same value of ifIndex.

atIfIndex 1.3.6.1.2.1.3.1.1.1

Fabric OS MIB Reference 57 53-1000602-02

Page 74

atPhysAddress 1.3.6.1.2.1.3.1.1.2

The media-dependent physical address.

58 Fabric OS MIB Reference

53-1000602-02

Page 75

atNetAddress 1.3.6.1.2.1.3.1.1.3

The network address (for example, the IP address) corresponding to the media-dependent physical address.

IP Group

Implementation of the IP group is mandatory for all systems.

atNetAddress 1.3.6.1.2.1.3.1.1.3

Fabric OS MIB Reference 59 53-1000602-02

Page 76

ipForwarding 1.3.6.1.2.1.4.1

The indication of whether this entity is acting as an IP gateway in respect to the forwarding of datagrams received by, but not addressed to, this entity. IP gateways forward datagrams; IP hosts do not (except those source-routed through the host).

60 Fabric OS MIB Reference

53-1000602-02

Page 77

ipDefaultTTL 1.3.6.1.2.1.4.2

The default value inserted into the time-to-live field of the IP header of datagrams originated at this entity, whenever a TTL value is not supplied by the transport layer protocol.

ipDefaultTTL 1.3.6.1.2.1.4.2

Fabric OS MIB Reference 61 53-1000602-02

Page 78

ipInReceives 1.3.6.1.2.1.4.3

The total number of input datagrams received from interfaces, including those received in error.

62 Fabric OS MIB Reference

53-1000602-02

Page 79

ipInHdrErrors 1.3.6.1.2.1.4.4

The number of input datagrams discarded due to errors in their IP headers, including bad checksums, version number mismatch, other format errors, time-to-live exceeded, errors discovered in processing their IP options, and so on.

ipInHdrErrors 1.3.6.1.2.1.4.4

Fabric OS MIB Reference 63 53-1000602-02

Page 80

ipInAddrErrors 1.3.6.1.2.1.4.5

The number of input datagrams discarded because the IP address in their IP header's destination field was not a valid address to be received at this entity. This count includes invalid addresses (for example, 0.0.0.0) and addresses of unsupported classes (for example, Class E). For entities that are not IP gateways and therefore do not forward datagrams, this counter includes datagrams discarded because the destination address was not a local address.

64 Fabric OS MIB Reference

53-1000602-02

Page 81

ipForwDatagrams 1.3.6.1.2.1.4.6

The number of input datagrams for which this entity was not final IP destination, as a result of which an attempt was made to find a route to forward them to that final destination. In entities that do not act as IP gateways, this counter includes only those packets that were source-routed through this entity, and the Source-Route option processing was successful.

ipForwDatagrams 1.3.6.1.2.1.4.6

Fabric OS MIB Reference 65 53-1000602-02

Page 82

ipInUnknownProtos 1.3.6.1.2.1.4.7

The number of locally addressed datagrams received successfully but discarded because of an unknown or unsupported protocol.

66 Fabric OS MIB Reference

53-1000602-02

Page 83

ipInDiscards 1.3.6.1.2.1.4.8

The number of input IP datagrams for which no problems were encountered to prevent their continued processing, but which were discarded (for example, for lack of buffer space).

This counter does not include any datagrams discarded while awaiting reassembly.

ipInDiscards 1.3.6.1.2.1.4.8

Fabric OS MIB Reference 67 53-1000602-02

Page 84

ipInDelivers 1.3.6.1.2.1.4.9

The total number of input datagrams successfully delivered to IP user protocols (including ICMP).

68 Fabric OS MIB Reference

53-1000602-02

Page 85

ipOutRequests 1.3.6.1.2.1.4.10

The total number of IP datagrams that local IP user protocols (including ICMP) supplied to IP in requests for transmission. Note that this counter does not include any datagrams counted in ipForwDatagrams.

ipOutRequests 1.3.6.1.2.1.4.10

Fabric OS MIB Reference 69 53-1000602-02

Page 86

ipOutDiscards 1.3.6.1.2.1.4.11

The number of output IP datagrams for which no problem was encountered to prevent their transmission to their destination, but which were discarded (for example, for lack of buffer space).

NOTE

This counter would include datagrams counted in ipForwDatagrams if any such packets met this (discretionary) discard criterion.

70 Fabric OS MIB Reference

53-1000602-02

Page 87

ipOutNoRoutes 1.3.6.1.2.1.4.12

The number of IP datagrams discarded because no route could be found to transmit them to their destination.

NOTE

This counter includes any packets counted in ipForwDatagrams that meet this “no-route” criterion. Note that this includes any datagrams that a host cannot route because all of its default gateways are down.

ipOutNoRoutes 1.3.6.1.2.1.4.12

Fabric OS MIB Reference 71 53-1000602-02

Page 88

ipReasmTimeout 1.3.6.1.2.1.4.13

The maximum number of seconds that received fragments are held while they are awaiting reassembly at this entity.

72 Fabric OS MIB Reference

53-1000602-02

Page 89

ipReasmReqds 1.3.6.1.2.1.4.14

The number of IP fragments received that needed to be reassembled at this entity.

ipReasmReqds 1.3.6.1.2.1.4.14

Fabric OS MIB Reference 73 53-1000602-02

Page 90

ipReasmOKs 1.3.6.1.2.1.4.15

The number of IP datagrams successfully reassembled.

74 Fabric OS MIB Reference

53-1000602-02

Page 91

ipReasmFails 1.3.6.1.2.1.4.16

The number of failures detected by the IP reassembly algorithm (for whatever reason: timed out, errors, and so on).

NOTE

This is not necessarily a count of discarded IP fragments, because some algorithms (notably the algorithm in RFC 815) can lose track of the number of fragments by combining them as they are received.

ipReasmFails 1.3.6.1.2.1.4.16

Fabric OS MIB Reference 75 53-1000602-02

Page 92

ipFragOKs 1.3.6.1.2.1.4.17

The number of IP datagrams that have been successfully fragmented at this entity.

76 Fabric OS MIB Reference

53-1000602-02

Page 93

ipFragFails 1.3.6.1.2.1.4.18

The number of IP datagrams that have been discarded because they needed to be fragmented at this entity but could not be (for example, because their Don't Fragment flag was set).

ipFragFails 1.3.6.1.2.1.4.18

Fabric OS MIB Reference 77 53-1000602-02

Page 94

ipFragCreates 1.3.6.1.2.1.4.19

The number of IP datagram fragments that have been generated as a result of fragmentation at this entity.

78 Fabric OS MIB Reference

53-1000602-02

Page 95

ipAddrTable 1.3.6.1.2.1.4.20

The table of addressing information relevant to this entity's IP addresses.

ipAddrTable 1.3.6.1.2.1.4.20

Fabric OS MIB Reference 79 53-1000602-02

Page 96

ipAddrEntry 1.3.6.1.2.1.4.20.1

The addressing information for one of this entity's IP addresses.

Index ipAdEntAddr

80 Fabric OS MIB Reference

53-1000602-02

Page 97

ipAdEntAddr 1.3.6.1.2.1.4.20.1.1

The IP address to which this entry's addressing information pertains.

ipAdEntAddr 1.3.6.1.2.1.4.20.1.1

Fabric OS MIB Reference 81 53-1000602-02

Page 98

ipAdEntIfIndex 1.3.6.1.2.1.4.20.1.2

The index value which uniquely identifies the interface to which this entry is applicable. The interface identified by a particular value of this index is the same interface as identified by the same value of ifIndex.

82 Fabric OS MIB Reference

53-1000602-02

Page 99

ipAdEntNetMask 1.3.6.1.2.1.4.20.1.3

The subnet mask associated with the IP address of this entry. The value of the mask is an IP address with all the network bits set to 1 and all the host bits set to 0.

ipAdEntNetMask 1.3.6.1.2.1.4.20.1.3

Fabric OS MIB Reference 83 53-1000602-02

Page 100

ipAdEntBcastAddr 1.3.6.1.2.1.4.20.1.4

The value of the least-significant bit in the IP broadcast address used for sending datagrams on the (logical) interface associated with the IP address of this entry. For example, when the Internet standard all-ones broadcast address is used, the value will be 1. This value applies to both the subnet and network broadcasts addresses used by the entity on this (logical) interface.

84 Fabric OS MIB Reference

53-1000602-02

Brocade Fabric OS MIB Reference

Specifications and Main Features

Frequently Asked Questions

User Manual

Contents

About This Document

Understanding Brocade SNMP

Setting the SNMP Security Level

Understanding SNMP Basics

Loading Brocade MIBs

Brocade 7500 / FR4-18i and Brocade MIBs

Access Gateway and Brocade MIBs

Firmware Upgrades and Enabled Traps

Fabric OS Commands for Configuring SNMP

Support for Administrative Domains

Support for Role Based Access Control

Support for IP V6 Addressing

MIB-II (RFC1213-MIB)

MIB II Overview

System Group

Interfaces Group

AT Group

IP Group