Difference between revisions of "RFC4044"

From RFC-Wiki
imported>Admin
(Created page with " Network Working Group K. McCloghrie Request for Comments: 4044 Cisco Systems, Inc Obsoletes: 2837 ...")
 
Line 1: Line 1:
−
 
−
 
−
 
−
 
−
 
−
 
 
Network Working Group                                      K. McCloghrie
 
Network Working Group                                      K. McCloghrie
 
Request for Comments: 4044                            Cisco Systems, Inc
 
Request for Comments: 4044                            Cisco Systems, Inc
 
Obsoletes: 2837                                                May 2005
 
Obsoletes: 2837                                                May 2005
 
Category: Standards Track
 
Category: Standards Track
−
 
  
 
                   Fibre Channel Management MIB
 
                   Fibre Channel Management MIB
Line 31: Line 24:
 
In particular, it describes managed objects for information related
 
In particular, it describes managed objects for information related
 
to the Fibre Channel.
 
to the Fibre Channel.
 +
 +
Table of Contents
 +
 +
1.  Introduction .................................................  2
 +
2.  The Internet-Standard Management Framework ...................  2
 +
3.  Short Overview of the Fibre Channel ..........................  2
 +
4.  MIB Overview .................................................  3
 +
    4.1.  The fcmInstanceBasicGroup Group ........................  3
 +
    4.2.  The fcmSwitchBasicGroup Group ..........................  4
 +
    4.3.  The fcmPortBasicGroup Group ............................  4
 +
    4.4.  The fcmPortStatsGroup Group ............................  4
 +
    4.5.  The fcmPortClass23StatsGroup Group .....................  4
 +
    4.6.  The fcmPortLcStatsGroup Group ..........................  4
 +
    4.7.  The fcmPortClassFStatsGroup Group ......................  4
 +
    4.8.  The fcmPortErrorsGroup Group ...........................  4
 +
    4.9.  The fcmSwitchPortGroup Group ...........................  5
 +
    4.10. The fcmSwitchLoginGroup Group ..........................  5
 +
    4.11. The fcmLinkBasicGroup Group ............................  5
 +
5.  Relationship to Other MIBs ...................................  5
 +
    5.1.  The Interfaces Group MIB ...............................  5
 +
    5.2.  Entity MIB .............................................  8
 +
    5.3.  Host Resources MIB .....................................  9
 +
 +
6.  Definitions ..................................................  9
 +
7.  Acknowledgements ............................................. 57
 +
8.  Normative References ......................................... 57
 +
9.  Informative References ....................................... 58
 +
10. Security Considerations ...................................... 59
 +
11. IANA Considerations .......................................... 60
 +
    11.1. OID Assignment ......................................... 60
 +
    11.2. FC Port Type Registry .................................. 60
 +
12. Comparison to the Fibre Channel Management Integration MIB ... 62
 +
    12.1. Problems with the Fibre Channel Management Integration
 +
          MIB .................................................... 62
 +
    12.2. Detailed Changes ....................................... 62
 +
13. Comparison to RFC 2837 ....................................... 67
  
 
== Introduction ==
 
== Introduction ==
Line 43: Line 72:
 
For a detailed overview of the documents that describe the current
 
For a detailed overview of the documents that describe the current
 
Internet-Standard Management Framework, please refer to section 7 of
 
Internet-Standard Management Framework, please refer to section 7 of
−
[[RFC3410|RFC 3410]] [RFC3410].
+
RFC 3410 [RFC3410].
  
 
Managed objects are accessed via a virtual information store, termed
 
Managed objects are accessed via a virtual information store, termed
Line 51: Line 80:
 
Structure of Management Information (SMI).  This memo specifies a MIB
 
Structure of Management Information (SMI).  This memo specifies a MIB
 
module that is compliant to the SMIv2, which is described in STD 58,
 
module that is compliant to the SMIv2, which is described in STD 58,
−
[[RFC2578|RFC 2578]] [RFC2578], STD 58, [[RFC2579|RFC 2579]] [RFC2579] and STD 58, [[RFC2580|RFC 2580]]
+
RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580
 
[RFC2580].
 
[RFC2580].
  
Line 66: Line 95:
 
Physically, the Fibre Channel is an interconnection of multiple
 
Physically, the Fibre Channel is an interconnection of multiple
 
communication points, called N_Ports, interconnected either by a
 
communication points, called N_Ports, interconnected either by a
−
 
−
 
−
 
−
 
  
 
switching network, called a Fabric, or by a point-to-point link.  A
 
switching network, called a Fabric, or by a point-to-point link.  A
Line 119: Line 144:
 
function(s) it performs, and optional pointers to hardware and/or
 
function(s) it performs, and optional pointers to hardware and/or
 
software components.
 
software components.
−
 
−
 
−
 
−
 
  
 
=== The fcmSwitchBasicGroup Group ===
 
=== The fcmSwitchBasicGroup Group ===
Line 171: Line 192:
 
This group contains counters of various error conditions that can
 
This group contains counters of various error conditions that can
 
occur on Fibre Channel ports.
 
occur on Fibre Channel ports.
−
 
−
 
−
 
−
 
−
 
  
 
=== The fcmSwitchPortGroup Group ===
 
=== The fcmSwitchPortGroup Group ===
Line 187: Line 203:
 
allocation and data field size.
 
allocation and data field size.
  
−
=== The fcmSwitchLoginGroup Group ===
+
4.10.  The fcmSwitchLoginGroup Group
  
 
This group contains information, known to a Fibre Channel switch,
 
This group contains information, known to a Fibre Channel switch,
Line 193: Line 209:
 
have been agreed with them.
 
have been agreed with them.
  
−
=== The fcmLinkBasicGroup Group ===
+
4.11.  The fcmLinkBasicGroup Group
  
 
This group contains information known to a local Fibre Channel
 
This group contains information known to a local Fibre Channel
Line 201: Line 217:
 
== Relationship to Other MIBs ==
 
== Relationship to Other MIBs ==
  
−
This MIB is a replacement for two other MIBs:  [[RFC2837|RFC 2837]], and the
+
This MIB is a replacement for two other MIBs:  RFC 2837, and the
 
Fibre Channel Management Integration MIB which was originally
 
Fibre Channel Management Integration MIB which was originally
 
submitted as an Internet Draft to the IETF's IPFC Working Group, and
 
submitted as an Internet Draft to the IETF's IPFC Working Group, and
Line 221: Line 237:
 
the generic definitions apply for the particular type of media.  The
 
the generic definitions apply for the particular type of media.  The
 
clarifications for Fibre Channel interfaces are as follows.
 
clarifications for Fibre Channel interfaces are as follows.
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
==== Layering Model ====
 
==== Layering Model ====
Line 265: Line 273:
 
applying the objects defined in the Interfaces Group MIB to Fibre
 
applying the objects defined in the Interfaces Group MIB to Fibre
 
Channel interfaces.  For those objects not listed here, refer to
 
Channel interfaces.  For those objects not listed here, refer to
−
their generic definitions in [RFC2863].  ([[RFC2863|RFC 2863]] takes precedence
+
their generic definitions in [RFC2863].  (RFC 2863 takes precedence
 
over these guidelines in the event of any conflict.)
 
over these guidelines in the event of any conflict.)
  
Line 278: Line 286:
 
                             largest IP datagram that can be
 
                             largest IP datagram that can be
 
                             sent/received over the interface.
 
                             sent/received over the interface.
−
 
−
 
−
 
−
 
  
 
   ifSpeed                  For 1Gbs, this will be 1,000,000,000;
 
   ifSpeed                  For 1Gbs, this will be 1,000,000,000;
Line 291: Line 295:
 
                             reflect the maximum speed supported by
 
                             reflect the maximum speed supported by
 
                             the interface.
 
                             the interface.
−
 
  
 
   ifPhysAddress            The interface's 24-bit Fibre Channel
 
   ifPhysAddress            The interface's 24-bit Fibre Channel
Line 331: Line 334:
 
                             that were input errors.
 
                             that were input errors.
  
−
 
+
   ifOutOctets              The number of octets of information
−
 
 
−
 
 
−
 
 
−
 
 
−
   ifOutOctets              The number of octets of information
 
 
   ifHCOutOctets            contained in transmitted frames between
 
   ifHCOutOctets            contained in transmitted frames between
 
                             the Start-of-Frame and End-of-Frame
 
                             the Start-of-Frame and End-of-Frame
Line 384: Line 382:
 
components) will have its value of the fcmInstancePhysicalIndex
 
components) will have its value of the fcmInstancePhysicalIndex
 
object contain a pointer to the relevant row in the Entity MIB.  If
 
object contain a pointer to the relevant row in the Entity MIB.  If
−
 
−
 
−
 
−
 
  
 
there is no correspondence with a physical component (or said
 
there is no correspondence with a physical component (or said
Line 436: Line 430:
 
             "This module defines management information specific to
 
             "This module defines management information specific to
 
             Fibre Channel-attached devices.
 
             Fibre Channel-attached devices.
−
 
−
 
−
 
−
 
−
 
  
 
             Copyright (C) The Internet Society (2005).  This version
 
             Copyright (C) The Internet Society (2005).  This version
−
             of this MIB module is part of [[RFC4044|RFC 4044]];  see the RFC
+
             of this MIB module is part of RFC 4044;  see the RFC
 
             itself for full legal notices."
 
             itself for full legal notices."
 
   REVISION        "200504260000Z"  -- 26 April 2005
 
   REVISION        "200504260000Z"  -- 26 April 2005
Line 484: Line 473:
 
         Id has been assigned."
 
         Id has been assigned."
 
  SYNTAX  Integer32 (0..239)
 
  SYNTAX  Integer32 (0..239)
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
FcPortType ::= TEXTUAL-CONVENTION
 
FcPortType ::= TEXTUAL-CONVENTION
Line 525: Line 504:
 
         "The buffer-to-buffer credit model of an Fx_Port."
 
         "The buffer-to-buffer credit model of an Fx_Port."
 
  SYNTAX    INTEGER { regular(1), alternate (2) }
 
  SYNTAX    INTEGER { regular(1), alternate (2) }
−
 
  
 
FcDataFieldSize ::= TEXTUAL-CONVENTION
 
FcDataFieldSize ::= TEXTUAL-CONVENTION
Line 533: Line 511:
 
  SYNTAX    Integer32 (128..2112)
 
  SYNTAX    Integer32 (128..2112)
  
 +
FcUnitFunctions ::= TEXTUAL-CONVENTION
 +
STATUS current
 +
DESCRIPTION
 +
        "A set of functions that a Fibre Channel Interconnect
 +
        Element or Platform might perform.  A value with no bits set
 +
        indicates the function(s) are unknown.  The individual bits
 +
        have the following meanings:
  
 +
        other - none of the following.
  
 +
        hub - a device that interconnects L_Ports, but does not
 +
        operate as an FL_Port.
  
 +
        switch - a fabric element conforming to the Fibre Channel
 +
        switch fabric set of standards (e.g., [FC-SW-3]).
  
−
 
+
         bridge - a device that encapsulates Fibre Channel frames
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
FcUnitFunctions ::= TEXTUAL-CONVENTION
 
−
STATUS current
 
−
DESCRIPTION
 
−
        "A set of functions that a Fibre Channel Interconnect
 
−
        Element or Platform might perform.  A value with no bits set
 
−
        indicates the function(s) are unknown.  The individual bits
 
−
        have the following meanings:
 
−
 
 
−
        other - none of the following.
 
−
 
 
−
        hub - a device that interconnects L_Ports, but does not
 
−
        operate as an FL_Port.
 
−
 
 
−
        switch - a fabric element conforming to the Fibre Channel
 
−
        switch fabric set of standards (e.g., [FC-SW-3]).
 
−
 
 
−
         bridge - a device that encapsulates Fibre Channel frames
 
 
         within another protocol (e.g., [FC-BB], FC-BB-2).
 
         within another protocol (e.g., [FC-BB], FC-BB-2).
  
Line 596: Line 559:
 
             hub(1),
 
             hub(1),
 
             switch(2),
 
             switch(2),
−
 
−
 
−
 
−
 
  
 
             bridge(3),
 
             bridge(3),
Line 647: Line 606:
 
  }
 
  }
  
−
 
+
fcmInstanceIndex OBJECT-TYPE
−
 
+
  SYNTAX    Unsigned32 (1..4294967295)
−
 
+
  MAX-ACCESS not-accessible
−
 
 
−
 
 
−
 
 
−
 
 
−
fcmInstanceIndex OBJECT-TYPE
 
−
  SYNTAX    Unsigned32 (1..4294967295)
 
−
  MAX-ACCESS not-accessible
 
 
  STATUS    current
 
  STATUS    current
 
  DESCRIPTION
 
  DESCRIPTION
Line 702: Line 654:
 
         the value of the entPhysicalIndex of that component (or of
 
         the value of the entPhysicalIndex of that component (or of
 
         the component at the root of that hierarchy).  If there is
 
         the component at the root of that hierarchy).  If there is
−
 
−
 
−
 
−
 
  
 
         no correspondence to a physical component (or no component
 
         no correspondence to a physical component (or no component
Line 711: Line 659:
 
         object is zero."
 
         object is zero."
 
  REFERENCE
 
  REFERENCE
−
     "entPhysicalIndex is defined in the Entity MIB, [[RFC2737|RFC 2737]]."
+
     "entPhysicalIndex is defined in the Entity MIB, RFC 2737."
 
  ::= { fcmInstanceEntry 4 }
 
  ::= { fcmInstanceEntry 4 }
  
Line 728: Line 676:
 
  REFERENCE
 
  REFERENCE
 
     "hrSWInstalledIndex is defined in the Host Resources MIB,
 
     "hrSWInstalledIndex is defined in the Host Resources MIB,
−
       [[RFC2790|RFC 2790]]"
+
       RFC 2790"
 
  ::= { fcmInstanceEntry 5 }
 
  ::= { fcmInstanceEntry 5 }
  
Line 754: Line 702:
 
         Channel entity/entities that it is managing."
 
         Channel entity/entities that it is managing."
 
  ::= { fcmInstanceEntry 7 }
 
  ::= { fcmInstanceEntry 7 }
−
 
−
 
−
 
−
 
−
 
  
 
fcmInstanceDescr OBJECT-TYPE
 
fcmInstanceDescr OBJECT-TYPE
Line 808: Line 751:
 
  DESCRIPTION
 
  DESCRIPTION
 
         "Information about a particular Fibre Channel switch that is
 
         "Information about a particular Fibre Channel switch that is
−
 
−
 
−
 
−
 
  
 
         managed by the management instance given by
 
         managed by the management instance given by
Line 857: Line 796:
 
         switch within its fabric."
 
         switch within its fabric."
 
  ::= { fcmSwitchEntry 3 }
 
  ::= { fcmSwitchEntry 3 }
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
fcmSwitchWWN  OBJECT-TYPE
 
fcmSwitchWWN  OBJECT-TYPE
Line 886: Line 817:
 
         port is represented by one entry in the IF-MIB's ifTable."
 
         port is represented by one entry in the IF-MIB's ifTable."
 
  REFERENCE
 
  REFERENCE
−
     "[[RFC2863|RFC 2863]], The Interfaces Group MIB, June 2000."
+
     "RFC 2863, The Interfaces Group MIB, June 2000."
 
  ::= { fcmgmtObjects 3 }
 
  ::= { fcmgmtObjects 3 }
  
Line 914: Line 845:
 
     fcmPortCapProtocols    BITS,
 
     fcmPortCapProtocols    BITS,
 
     fcmPortOperProtocols    BITS
 
     fcmPortOperProtocols    BITS
−
 
−
 
−
 
−
 
  
 
  }
 
  }
Line 965: Line 892:
 
         "The current operational type of this port."
 
         "The current operational type of this port."
 
  ::= { fcmPortEntry 5 }
 
  ::= { fcmPortEntry 5 }
−
 
−
 
−
 
−
 
−
 
−
 
  
 
fcmPortFcCapClass OBJECT-TYPE
 
fcmPortFcCapClass OBJECT-TYPE
Line 1,020: Line 941:
 
  }
 
  }
 
  MAX-ACCESS read-only
 
  MAX-ACCESS read-only
−
 
−
 
−
 
−
 
  
 
  STATUS    current
 
  STATUS    current
Line 1,073: Line 990:
 
                 fourGbs(7),    --  4Gbs
 
                 fourGbs(7),    --  4Gbs
 
                 tenGbs(8)      --  10Gbs
 
                 tenGbs(8)      --  10Gbs
−
 
−
 
−
 
−
 
  
 
             }
 
             }
Line 1,126: Line 1,039:
 
  STATUS    current
 
  STATUS    current
 
  DESCRIPTION
 
  DESCRIPTION
−
 
−
 
−
 
−
 
  
 
         "A bit mask specifying the higher level protocols that are
 
         "A bit mask specifying the higher level protocols that are
Line 1,158: Line 1,067:
 
         value of ifCounterDiscontinuityTime (defined in the IF-MIB)
 
         value of ifCounterDiscontinuityTime (defined in the IF-MIB)
 
         must be updated."
 
         must be updated."
−
  REFERENCE  "The Interfaces Group MIB, [[RFC2863|RFC 2863]], June 2000."
+
  REFERENCE  "The Interfaces Group MIB, RFC 2863, June 2000."
 
  AUGMENTS  { fcmPortEntry }
 
  AUGMENTS  { fcmPortEntry }
 
  ::= { fcmPortStatsTable 1 }
 
  ::= { fcmPortStatsTable 1 }
Line 1,179: Line 1,088:
 
     fcmPortClass2TxFrjtFrames  Counter64,
 
     fcmPortClass2TxFrjtFrames  Counter64,
 
     fcmPortClass2TxPrjtFrames  Counter64,
 
     fcmPortClass2TxPrjtFrames  Counter64,
−
 
−
 
−
 
−
 
  
 
     fcmPortClass3RxFrames      Counter64,
 
     fcmPortClass3RxFrames      Counter64,
Line 1,232: Line 1,137:
 
         "The number of octets contained in Class 2 frames received
 
         "The number of octets contained in Class 2 frames received
 
         at this port."
 
         at this port."
−
 
−
 
−
 
−
 
  
 
  ::= { fcmPortStatsEntry 4 }
 
  ::= { fcmPortStatsEntry 4 }
Line 1,285: Line 1,186:
 
         a result of a Class 2 frame that could not be delivered to
 
         a result of a Class 2 frame that could not be delivered to
 
         the other end of the link.  This can occur when the
 
         the other end of the link.  This can occur when the
−
 
−
 
−
 
−
 
  
 
         destination port is temporarily busy."
 
         destination port is temporarily busy."
Line 1,335: Line 1,232:
 
         that this counter will never increment for an F_Port."
 
         that this counter will never increment for an F_Port."
 
  ::= { fcmPortStatsEntry 13 }
 
  ::= { fcmPortStatsEntry 13 }
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
fcmPortClass2TxFrjtFrames OBJECT-TYPE
 
fcmPortClass2TxFrjtFrames OBJECT-TYPE
Line 1,388: Line 1,278:
 
         "The number of Class 3 frames transmitted out of this port."
 
         "The number of Class 3 frames transmitted out of this port."
 
  ::= { fcmPortStatsEntry 18 }
 
  ::= { fcmPortStatsEntry 18 }
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
fcmPortClass3TxOctets OBJECT-TYPE
 
fcmPortClass3TxOctets OBJECT-TYPE
Line 1,438: Line 1,321:
 
         "The number of Class F frames transmitted out of this port."
 
         "The number of Class F frames transmitted out of this port."
 
  ::= { fcmPortStatsEntry 23 }
 
  ::= { fcmPortStatsEntry 23 }
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
fcmPortClassFTxOctets OBJECT-TYPE
 
fcmPortClassFTxOctets OBJECT-TYPE
Line 1,492: Line 1,365:
 
         ifCounterDiscontinuityTime (defined in the IF-MIB) must be
 
         ifCounterDiscontinuityTime (defined in the IF-MIB) must be
 
         updated."
 
         updated."
−
  REFERENCE  "The Interfaces Group MIB, [[RFC2863|RFC 2863]], June 2000."
+
  REFERENCE  "The Interfaces Group MIB, RFC 2863, June 2000."
 
  AUGMENTS  { fcmPortEntry }
 
  AUGMENTS  { fcmPortEntry }
 
  ::= { fcmPortLcStatsTable 1 }
 
  ::= { fcmPortLcStatsTable 1 }
−
 
−
 
−
 
−
 
−
 
−
 
  
 
FcmPortLcStatsEntry ::=
 
FcmPortLcStatsEntry ::=
Line 1,546: Line 1,413:
 
         side."
 
         side."
 
  ::= { fcmPortLcStatsEntry 2 }
 
  ::= { fcmPortLcStatsEntry 2 }
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
fcmPortLcClass2RxFrames OBJECT-TYPE
 
fcmPortLcClass2RxFrames OBJECT-TYPE
Line 1,597: Line 1,456:
 
         reception at this port."
 
         reception at this port."
 
  ::= { fcmPortLcStatsEntry 7 }
 
  ::= { fcmPortLcStatsEntry 7 }
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
fcmPortLcClass2RxFbsyFrames OBJECT-TYPE
 
fcmPortLcClass2RxFbsyFrames OBJECT-TYPE
Line 1,651: Line 1,500:
 
  ::= { fcmPortLcStatsEntry 11 }
 
  ::= { fcmPortLcStatsEntry 11 }
  
−
 
+
fcmPortLcClass2TxFbsyFrames OBJECT-TYPE
−
 
+
  SYNTAX    Counter32
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
fcmPortLcClass2TxFbsyFrames OBJECT-TYPE
 
−
  SYNTAX    Counter32
 
 
  MAX-ACCESS read-only
 
  MAX-ACCESS read-only
 
  STATUS    current
 
  STATUS    current
Line 1,704: Line 1,543:
 
         increment for an F_Port."
 
         increment for an F_Port."
 
  ::= { fcmPortLcStatsEntry 15 }
 
  ::= { fcmPortLcStatsEntry 15 }
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
fcmPortLcClass3RxFrames OBJECT-TYPE
 
fcmPortLcClass3RxFrames OBJECT-TYPE
Line 1,756: Line 1,586:
 
         reception at this port."
 
         reception at this port."
 
  ::= { fcmPortLcStatsEntry 20 }
 
  ::= { fcmPortLcStatsEntry 20 }
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
--********************************
 
--********************************
Line 1,788: Line 1,608:
 
         ifCounterDiscontinuityTime (defined in the IF-MIB) must be
 
         ifCounterDiscontinuityTime (defined in the IF-MIB) must be
 
         updated."
 
         updated."
−
  REFERENCE  "The Interfaces Group MIB, [[RFC2863|RFC 2863]], June 2000."
+
  REFERENCE  "The Interfaces Group MIB, RFC 2863, June 2000."
 
  AUGMENTS  { fcmPortEntry }
 
  AUGMENTS  { fcmPortEntry }
 
  ::= { fcmPortErrorsTable 1 }
 
  ::= { fcmPortErrorsTable 1 }
Line 1,813: Line 1,633:
 
     fcmPortOtherErrors              Counter32
 
     fcmPortOtherErrors              Counter32
 
  }
 
  }
−
 
−
 
−
 
−
 
−
 
−
 
  
 
fcmPortRxLinkResets OBJECT-TYPE
 
fcmPortRxLinkResets OBJECT-TYPE
Line 1,867: Line 1,681:
 
  ::= { fcmPortErrorsEntry 5 }
 
  ::= { fcmPortErrorsEntry 5 }
  
−
 
+
fcmPortLinkFailures OBJECT-TYPE
−
 
+
  SYNTAX    Counter32
−
 
 
−
 
 
−
 
 
−
 
 
−
fcmPortLinkFailures OBJECT-TYPE
 
−
  SYNTAX    Counter32
 
 
  MAX-ACCESS read-only
 
  MAX-ACCESS read-only
 
  STATUS    current
 
  STATUS    current
Line 1,919: Line 1,727:
 
         "FC-PH, rev 4.3, 1 June 1994, section 29.8."
 
         "FC-PH, rev 4.3, 1 June 1994, section 29.8."
 
  ::= { fcmPortErrorsEntry 9 }
 
  ::= { fcmPortErrorsEntry 9 }
−
 
−
 
−
 
−
 
−
 
−
 
  
 
fcmPortInvalidTxWords OBJECT-TYPE
 
fcmPortInvalidTxWords OBJECT-TYPE
Line 1,974: Line 1,776:
 
  DESCRIPTION
 
  DESCRIPTION
 
         "The number of frames received at this port for which the
 
         "The number of frames received at this port for which the
−
 
−
 
−
 
−
 
  
 
         frame length was less than the minimum indicated by the
 
         frame length was less than the minimum indicated by the
Line 2,021: Line 1,819:
 
         not counted by any other error counter in this row."
 
         not counted by any other error counter in this row."
 
  ::= { fcmPortErrorsEntry 18 }
 
  ::= { fcmPortErrorsEntry 18 }
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
--********************************
 
--********************************
Line 2,080: Line 1,868:
 
         Fx_Port.  This is used as the timeout value for determining
 
         Fx_Port.  This is used as the timeout value for determining
 
         when to reuse an Nx_Port resource such as a
 
         when to reuse an Nx_Port resource such as a
−
 
−
 
−
 
−
 
  
 
         Recovery_Qualifier.  It represents the Error_Detect_Timeout
 
         Recovery_Qualifier.  It represents the Error_Detect_Timeout
Line 2,133: Line 1,917:
 
         "The maximum number of receive buffers that this port is
 
         "The maximum number of receive buffers that this port is
 
         capable of making available for holding frames from attached
 
         capable of making available for holding frames from attached
−
 
−
 
−
 
−
 
  
 
         Nx_Port(s)."
 
         Nx_Port(s)."
Line 2,183: Line 1,963:
 
  ::= { fcmFxPortEntry 9 }
 
  ::= { fcmFxPortEntry 9 }
  
−
 
+
fcmFxPortCapClass3SeqDeliv OBJECT-TYPE
−
 
+
  SYNTAX      TruthValue
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
fcmFxPortCapClass3SeqDeliv OBJECT-TYPE
 
−
  SYNTAX      TruthValue
 
 
  MAX-ACCESS  read-only
 
  MAX-ACCESS  read-only
 
  STATUS      current
 
  STATUS      current
Line 2,234: Line 2,006:
 
         each fcmPortTable entry that represents such a port."
 
         each fcmPortTable entry that represents such a port."
 
  ::= { fcmgmtObjects 8 }
 
  ::= { fcmgmtObjects 8 }
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
fcmISPortEntry OBJECT-TYPE
 
fcmISPortEntry OBJECT-TYPE
Line 2,281: Line 2,044:
 
         frame."
 
         frame."
 
  ::= { fcmISPortEntry 2 }
 
  ::= { fcmISPortEntry 2 }
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
--********************************
 
--********************************
Line 2,341: Line 2,089:
 
  }
 
  }
  
−
 
+
fcmFLoginNxPortIndex OBJECT-TYPE
−
 
+
  SYNTAX      Unsigned32 (1..4294967295)
−
 
+
  MAX-ACCESS  not-accessible
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
fcmFLoginNxPortIndex OBJECT-TYPE
 
−
  SYNTAX      Unsigned32 (1..4294967295)
 
−
  MAX-ACCESS  not-accessible
 
 
  STATUS      current
 
  STATUS      current
 
  DESCRIPTION
 
  DESCRIPTION
Line 2,363: Line 2,102:
 
         assigned to the same Nx_Port, or, after a reset of the value
 
         assigned to the same Nx_Port, or, after a reset of the value
 
         of the relevant instance of ifCounterDiscontinuityTime."
 
         of the relevant instance of ifCounterDiscontinuityTime."
−
  REFERENCE  "The Interfaces Group MIB, [[RFC2863|RFC 2863]], June 2000."
+
  REFERENCE  "The Interfaces Group MIB, RFC 2863, June 2000."
 
  ::= { fcmFLoginEntry 1 }
 
  ::= { fcmFLoginEntry 1 }
  
Line 2,398: Line 2,137:
 
  DESCRIPTION
 
  DESCRIPTION
 
         "The number of buffers available for holding frames to be
 
         "The number of buffers available for holding frames to be
−
 
−
 
−
 
−
 
  
 
         transmitted to the attached Nx_Port.  These buffers are for
 
         transmitted to the attached Nx_Port.  These buffers are for
Line 2,448: Line 2,183:
 
         meaningful if Class 3 service has been agreed upon."
 
         meaningful if Class 3 service has been agreed upon."
 
  ::= { fcmFLoginEntry 9 }
 
  ::= { fcmFLoginEntry 9 }
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
fcmFLoginClass3DataFieldSize OBJECT-TYPE
 
fcmFLoginClass3DataFieldSize OBJECT-TYPE
Line 2,504: Line 2,232:
 
  INDEX { fcmInstanceIndex, fcmLinkIndex }
 
  INDEX { fcmInstanceIndex, fcmLinkIndex }
 
  ::= { fcmLinkTable 1 }
 
  ::= { fcmLinkTable 1 }
−
 
−
 
−
 
−
 
  
 
FcmLinkEntry ::=
 
FcmLinkEntry ::=
Line 2,552: Line 2,276:
 
     "FC-GS-3, section 6.1.2.2.5"
 
     "FC-GS-3, section 6.1.2.2.5"
 
  ::= { fcmLinkEntry 3 }
 
  ::= { fcmLinkEntry 3 }
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
fcmLinkEnd1PortWwn OBJECT-TYPE
 
fcmLinkEnd1PortWwn OBJECT-TYPE
Line 2,610: Line 2,325:
 
         management agents.  If the address is unknown, the value of
 
         management agents.  If the address is unknown, the value of
 
         this object is the zero-length string."
 
         this object is the zero-length string."
−
 
−
 
−
 
−
 
  
 
  REFERENCE
 
  REFERENCE
Line 2,648: Line 2,359:
 
         string if unknown."
 
         string if unknown."
 
  ::= { fcmLinkEntry 11 }
 
  ::= { fcmLinkEntry 11 }
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
--********************************
 
--********************************
Line 2,716: Line 2,408:
 
     GROUP  fcmSwitchPortGroup
 
     GROUP  fcmSwitchPortGroup
 
     DESCRIPTION
 
     DESCRIPTION
−
 
−
 
−
 
−
 
  
 
         "This group is mandatory only for Fibre Channel
 
         "This group is mandatory only for Fibre Channel
Line 2,769: Line 2,457:
 
     DESCRIPTION
 
     DESCRIPTION
 
         "Write access is not required."
 
         "Write access is not required."
−
 
−
 
−
 
−
 
  
 
     OBJECT      fcmISPortClassFCredit
 
     OBJECT      fcmISPortClassFCredit
Line 2,821: Line 2,505:
 
         of service, for Fibre Channel ports."
 
         of service, for Fibre Channel ports."
 
  ::= { fcmgmtGroups 4 }
 
  ::= { fcmgmtGroups 4 }
−
 
−
 
−
 
−
 
−
 
  
 
fcmPortClass23StatsGroup OBJECT-GROUP
 
fcmPortClass23StatsGroup OBJECT-GROUP
Line 2,875: Line 2,554:
 
  STATUS  current
 
  STATUS  current
 
  DESCRIPTION
 
  DESCRIPTION
−
 
−
 
−
 
−
 
  
 
         "Low-capacity (32-bit) statistics for Fibre Channel ports."
 
         "Low-capacity (32-bit) statistics for Fibre Channel ports."
Line 2,929: Line 2,604:
 
         attached/logged-in Nx_Ports."
 
         attached/logged-in Nx_Ports."
  
 +
::= { fcmgmtGroups 10 }
  
−
 
+
fcmLinkBasicGroup OBJECT-GROUP
−
 
 
−
 
 
−
::= { fcmgmtGroups 10 }
 
−
 
 
−
fcmLinkBasicGroup OBJECT-GROUP
 
 
  OBJECTS { fcmLinkEnd1NodeWwn , fcmLinkEnd1PhysPortNumber,
 
  OBJECTS { fcmLinkEnd1NodeWwn , fcmLinkEnd1PhysPortNumber,
 
           fcmLinkEnd1PortWwn, fcmLinkEnd2NodeWwn ,
 
           fcmLinkEnd1PortWwn, fcmLinkEnd2NodeWwn ,
Line 2,953: Line 2,624:
 
original submission of the Fibre Channel Management Integration MIB
 
original submission of the Fibre Channel Management Integration MIB
 
to the IETF's IPFC Working Group (now available as [MIB-FA]) and
 
to the IETF's IPFC Working Group (now available as [MIB-FA]) and
−
obsoletes [[RFC2837|RFC 2837]].
+
obsoletes RFC 2837.
  
 
Feedback has been incorporated into this document based on comments
 
Feedback has been incorporated into this document based on comments
Line 2,962: Line 2,633:
  
 
[RFC2434] Narten, T. and H. Alvestrand, "Guidelines for Writing an
 
[RFC2434] Narten, T. and H. Alvestrand, "Guidelines for Writing an
−
           IANA Considerations Section in RFCs", [[BCP26|BCP 26]], [[RFC2434|RFC 2434]],
+
           IANA Considerations Section in RFCs", BCP 26, RFC 2434,
 
           October 1998.
 
           October 1998.
  
 
[RFC2578] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
 
[RFC2578] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
 
           "Structure of Management Information Version 2 (SMIv2)",
 
           "Structure of Management Information Version 2 (SMIv2)",
−
           STD 58, [[RFC2578|RFC 2578]], April 1999.
+
           STD 58, RFC 2578, April 1999.
  
 
[RFC2579] McCloghrie, K., Perkins, D., and J. Schoenwaelder, "Textual
 
[RFC2579] McCloghrie, K., Perkins, D., and J. Schoenwaelder, "Textual
−
           Conventions for SMIv2", STD 58, [[RFC2579|RFC 2579]], April 1999.
+
           Conventions for SMIv2", STD 58, RFC 2579, April 1999.
  
 
[RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
 
[RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
−
           "Conformance Statements for SMIv2", STD 58, [[RFC2580|RFC 2580]], April
+
           "Conformance Statements for SMIv2", STD 58, RFC 2580, April
 
           1999.
 
           1999.
  
 
[RFC2737] McCloghrie, K. and A. Bierman, "Entity MIB (Version 2)",
 
[RFC2737] McCloghrie, K. and A. Bierman, "Entity MIB (Version 2)",
−
           [[RFC2737|RFC 2737]], December 1999.
+
           RFC 2737, December 1999.
  
 
[RFC2790] Waldbusser, S. and P. Grillo, "Host Resources MIB", RFC
 
[RFC2790] Waldbusser, S. and P. Grillo, "Host Resources MIB", RFC
 
           2790, March 2000.
 
           2790, March 2000.
−
 
−
 
−
 
−
 
  
 
[RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group
 
[RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group
−
           MIB", [[RFC2863|RFC 2863]], June 2000.
+
           MIB", RFC 2863, June 2000.
  
 
[RFC3411] Harrington, D., Presuhn, R., and B. Wijnen, "An
 
[RFC3411] Harrington, D., Presuhn, R., and B. Wijnen, "An
 
           Architecture for Describing Simple Network Management
 
           Architecture for Describing Simple Network Management
−
           Protocol (SNMP) Management Frameworks", STD 62, [[RFC3411|RFC 3411]],
+
           Protocol (SNMP) Management Frameworks", STD 62, RFC 3411,
 
           December 2002.
 
           December 2002.
  
Line 3,022: Line 2,689:
  
 
[RFC2837] Teow, K., "Definitions of Managed Objects for the Fabric
 
[RFC2837] Teow, K., "Definitions of Managed Objects for the Fabric
−
           Element in Fibre Channel Standard", [[RFC2837|RFC 2837]], May 2000.
+
           Element in Fibre Channel Standard", RFC 2837, May 2000.
  
 
[RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart,
 
[RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart,
 
           "Introduction and Applicability Statements for Internet-
 
           "Introduction and Applicability Statements for Internet-
−
           Standard Management Framework", [[RFC3410|RFC 3410]], December 2002.
+
           Standard Management Framework", RFC 3410, December 2002.
  
 
[RFC3433] Bierman, A., Romascanu, D., and K.C. Norseth, "Entity
 
[RFC3433] Bierman, A., Romascanu, D., and K.C. Norseth, "Entity
−
           Sensor Management Information Base", [[RFC3433|RFC 3433]], December
+
           Sensor Management Information Base", RFC 3433, December
 
           2002.
 
           2002.
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
[MIB-FA]  "INCITS Technical Report for Information Technology - Fibre
 
[MIB-FA]  "INCITS Technical Report for Information Technology - Fibre
Line 3,053: Line 2,713:
 
           fibrecomp_id.html, 24 February 1997.
 
           fibrecomp_id.html, 24 February 1997.
  
−
== Security Considerations ==
+
10.  Security Considerations
  
 
There are a number of management objects defined in this MIB that
 
There are a number of management objects defined in this MIB that
Line 3,087: Line 2,747:
 
   fcmLinkEnd2NodeWwn
 
   fcmLinkEnd2NodeWwn
 
   fcmLinkEnd2PhysPortNumber
 
   fcmLinkEnd2PhysPortNumber
−
 
−
 
−
 
−
 
  
 
   fcmLinkEnd2PortWwn
 
   fcmLinkEnd2PortWwn
Line 3,117: Line 2,773:
 
rights to indeed GET or SET (change/create/delete) them.
 
rights to indeed GET or SET (change/create/delete) them.
  
−
== IANA Considerations ==
+
11.  IANA Considerations
  
−
=== OID Assignment ===
+
11.1.  OID Assignment
  
 
IANA has made a MIB OID assignment under the transmission branch.
 
IANA has made a MIB OID assignment under the transmission branch.
Line 3,127: Line 2,783:
 
value of fibreChannel(56).
 
value of fibreChannel(56).
  
−
=== FC Port Type Registry ===
+
11.2.  FC Port Type Registry
  
 
IANA has established a registry for Fibre Channel Port Types.  The
 
IANA has established a registry for Fibre Channel Port Types.  The
Line 3,140: Line 2,796:
  
 
   -  the Expert Reviewer is to be appointed by the IESG.
 
   -  the Expert Reviewer is to be appointed by the IESG.
−
 
−
 
−
 
−
 
  
 
   -  the Expert Reviewer shall obtain approval (or rejection) from
 
   -  the Expert Reviewer shall obtain approval (or rejection) from
Line 3,185: Line 2,837:
 
3) values larger than 99,999 are RESERVED.
 
3) values larger than 99,999 are RESERVED.
  
 +
12.  Comparison to the Fibre Channel Management Integration MIB
  
−
 
+
12.1.  Problems with the Fibre Channel Management Integration MIB
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
== Comparison to the Fibre Channel Management Integration MIB ==
 
−
 
 
−
=== Problems with the Fibre Channel Management Integration MIB ===
 
  
 
The Fibre Channel Management Integration MIB [MIB-FA] had the
 
The Fibre Channel Management Integration MIB [MIB-FA] had the
Line 3,223: Line 2,862:
  
 
-  The MIB had some but not complete overlap in functionality with
 
-  The MIB had some but not complete overlap in functionality with
−
   [[RFC2837|RFC 2837]].
+
   RFC 2837.
  
 
-  Every SNMP agent must implement the ifTable.  The ifTable counters
 
-  Every SNMP agent must implement the ifTable.  The ifTable counters
Line 3,231: Line 2,870:
 
   Channel interfaces.  The IF-MIB requires a media-specific MIB to
 
   Channel interfaces.  The IF-MIB requires a media-specific MIB to
 
   specify how that type of interface uses the ifTable (see section 4
 
   specify how that type of interface uses the ifTable (see section 4
−
   in [[RFC2863|RFC 2863]]).  [RFC2837] doesn't do that, nor did the Fibre
+
   in RFC 2863).  [RFC2837] doesn't do that, nor did the Fibre
 
   Channel Integration MIB.
 
   Channel Integration MIB.
  
Line 3,237: Line 2,876:
 
   or Counter64) for counters.
 
   or Counter64) for counters.
  
−
=== Detailed Changes ===
+
12.2.  Detailed Changes
  
−
==== Removal of Sensor-Related Objects ====
+
12.2.1.  Removal of Sensor-Related Objects
  
 
Information about sensors is not specific to Fibre Channel, and
 
Information about sensors is not specific to Fibre Channel, and
Line 3,245: Line 2,884:
 
IETF's ENTITY MIB Working Group has produced a first draft of a
 
IETF's ENTITY MIB Working Group has produced a first draft of a
 
Sensor MIB, see [RFC3433].)  This removed the need for:
 
Sensor MIB, see [RFC3433].)  This removed the need for:
−
 
−
 
−
 
−
 
−
 
  
 
   connUnitSensorTable (and all its contents)
 
   connUnitSensorTable (and all its contents)
Line 3,255: Line 2,889:
 
   connUnitSensorStatusChange
 
   connUnitSensorStatusChange
  
−
==== Removal of Trap-registration Objects ====
+
12.2.2.  Removal of Trap-registration Objects
  
 
Information about registering "traps" is not specific to Fibre
 
Information about registering "traps" is not specific to Fibre
Line 3,266: Line 2,900:
 
   trapRegTable (and all its contents)
 
   trapRegTable (and all its contents)
  
−
==== Removal of Event-Related Objects ====
+
12.2.3.  Removal of Event-Related Objects
  
 
Information about generic events is not specific to Fibre Channel,
 
Information about generic events is not specific to Fibre Channel,
 
and therefore should not be in this MIB.  (For similar functionality,
 
and therefore should not be in this MIB.  (For similar functionality,
−
see the Event group in [[RFC2819|RFC 2819]] and the Notification Log MIB in RFC
+
see the Event group in RFC 2819 and the Notification Log MIB in RFC
 
3014; the SNMP-NOTIFICATION-MIB provides for the filtering of
 
3014; the SNMP-NOTIFICATION-MIB provides for the filtering of
 
notifications.)  This removed the need for:
 
notifications.)  This removed the need for:
Line 3,281: Line 2,915:
 
   connUnitEventTrap
 
   connUnitEventTrap
  
−
==== Removal of Inventory-Related Information ====
+
12.2.4.  Removal of Inventory-Related Information
  
 
Aspects of hardware (physical) components are represented in the
 
Aspects of hardware (physical) components are represented in the
−
Entity MIB ([[RFC2737|RFC 2737]]); aspects of software modules are represented in
+
Entity MIB (RFC 2737); aspects of software modules are represented in
−
the Host Resources MIB ([[RFC2790|RFC 2790]]).  Two new objects provide indexing
+
the Host Resources MIB (RFC 2790).  Two new objects provide indexing
 
from this MIB into those MIBs: one having the value of PhysicalIndex
 
from this MIB into those MIBs: one having the value of PhysicalIndex
 
(or zero) and the other having the value of hrSWInstalledIndex (or
 
(or zero) and the other having the value of hrSWInstalledIndex (or
Line 3,299: Line 2,933:
 
   connUnitSn
 
   connUnitSn
 
   connUnitModuleId
 
   connUnitModuleId
−
 
−
 
−
 
−
 
  
 
   connUnitVendorId
 
   connUnitVendorId
 
   connUnitDeletedTrap
 
   connUnitDeletedTrap
  
−
==== Removal of Revision Numbers ====
+
12.2.5.  Removal of Revision Numbers
  
 
The forward/backward compatibility rules of how to evolve MIBs are
 
The forward/backward compatibility rules of how to evolve MIBs are
Line 3,315: Line 2,945:
 
   revisionNumber
 
   revisionNumber
  
−
==== Removal of Other Not FC-Specific Information ====
+
12.2.6.  Removal of Other Not FC-Specific Information
  
 
Other information was removed because it was not specific to Fibre
 
Other information was removed because it was not specific to Fibre
Line 3,333: Line 2,963:
 
   connUnitStatusChange
 
   connUnitStatusChange
  
−
==== Clean-up of Ambiguous/Obsolete Definitions ====
+
12.2.7.  Clean-up of Ambiguous/Obsolete Definitions
  
 
Some information in the FC Management integration was obsolete or
 
Some information in the FC Management integration was obsolete or
Line 3,347: Line 2,977:
 
   connUnitLinkCurrIndex (badly defined)
 
   connUnitLinkCurrIndex (badly defined)
  
−
==== Use of an ifTable Entry ====
+
12.2.8.  Use of an ifTable Entry
  
 
The following objects were removed because they duplicated existing
 
The following objects were removed because they duplicated existing
 
IF-MIB objects:
 
IF-MIB objects:
−
 
−
 
−
 
−
 
−
 
  
 
   redundant object                  existing object(s)
 
   redundant object                  existing object(s)
Line 3,390: Line 3,015:
 
   connUnitPortStatusChange          linkUp/linkDown
 
   connUnitPortStatusChange          linkUp/linkDown
  
−
==== Removed Because of AgentX Difficulty ====
+
12.2.9.  Removed Because of AgentX Difficulty
  
 
An AgentX environment [RFC2741] consists of a master agent and
 
An AgentX environment [RFC2741] consists of a master agent and
Line 3,404: Line 3,029:
 
   systemURL
 
   systemURL
  
−
 
+
12.2.10.  FC Management Instance
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
==== FC Management Instance ====
 
  
 
The term "connectivity unit" was changed to "FC management instance".
 
The term "connectivity unit" was changed to "FC management instance".
Line 3,441: Line 3,060:
 
than is "connectivity unit".
 
than is "connectivity unit".
  
−
==== Counter Syntax ====
+
12.2.11.  Counter Syntax
  
 
All packet and octet counters have been changed to be Counter64's
 
All packet and octet counters have been changed to be Counter64's
Line 3,451: Line 3,070:
 
occurring will almost certainly be apparent from other MIB objects.)
 
occurring will almost certainly be apparent from other MIB objects.)
  
−
==== Obsolete/Little-Used Fibre Channel Features ====
+
12.2.12.  Obsolete/Little-Used Fibre Channel Features
  
 
Information relating to Fibre Channel features that are obsolete or
 
Information relating to Fibre Channel features that are obsolete or
 
not widely-implemented has been deleted.  (For more information, see
 
not widely-implemented has been deleted.  (For more information, see
 
section 6.2.1 and section 6.2.2 of [FC-MI].)
 
section 6.2.1 and section 6.2.2 of [FC-MI].)
−
 
−
 
−
 
−
 
−
 
−
 
  
 
   -  Class 1 service,
 
   -  Class 1 service,
Line 3,478: Line 3,091:
 
   connUnitPortStatCountPRJTFrames
 
   connUnitPortStatCountPRJTFrames
  
−
=== Name Server Objects ===
+
12.3.  Name Server Objects
  
 
A table of Name Server information was present in
 
A table of Name Server information was present in
Line 3,487: Line 3,100:
 
defined in a separate (new) MIB.
 
defined in a separate (new) MIB.
  
−
=== Additional Objects ===
+
12.4.  Additional Objects
  
 
Support for Class F traffic, including 32-bit octet and frame
 
Support for Class F traffic, including 32-bit octet and frame
 
counters, has been added.
 
counters, has been added.
  
−
== Comparison to RFC 2837 ==
+
13.  Comparison to RFC 2837
  
−
This MIB is a superset of [[RFC2837|RFC 2837]], except for the following:
+
This MIB is a superset of RFC 2837, except for the following:
  
 
-  the fcFeClass1AccountingGroup group is obsolete,
 
-  the fcFeClass1AccountingGroup group is obsolete,
Line 3,511: Line 3,124:
 
-  fcFxPortPhysAdminStatus, fcFxPortPhysOperStatus, and
 
-  fcFxPortPhysAdminStatus, fcFxPortPhysOperStatus, and
 
   fcFxPortPhysLastChange have equivalents in the ifTable.
 
   fcFxPortPhysLastChange have equivalents in the ifTable.
−
 
−
 
−
 
−
 
  
 
Author's Address
 
Author's Address
Line 3,525: Line 3,134:
 
Phone: +1 408-526-5260
 
Phone: +1 408-526-5260
  
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
−
 
  
 
Full Copyright Statement
 
Full Copyright Statement
Line 3,574: Line 3,140:
  
 
This document is subject to the rights, licenses and restrictions
 
This document is subject to the rights, licenses and restrictions
−
contained in [[BCP78|BCP 78]], and except as set forth therein, the authors
+
contained in BCP 78, and except as set forth therein, the authors
 
retain all their rights.
 
retain all their rights.
  
Line 3,594: Line 3,160:
 
made any independent effort to identify any such rights.  Information
 
made any independent effort to identify any such rights.  Information
 
on the procedures with respect to rights in RFC documents can be
 
on the procedures with respect to rights in RFC documents can be
−
found in [[BCP78|BCP 78]] and [[BCP79|BCP 79]].
+
found in BCP 78 and BCP 79.
  
 
Copies of IPR disclosures made to the IETF Secretariat and any
 
Copies of IPR disclosures made to the IETF Secretariat and any

Revision as of 15:46, 24 September 2020

Network Working Group K. McCloghrie Request for Comments: 4044 Cisco Systems, Inc Obsoletes: 2837 May 2005 Category: Standards Track 

                  Fibre Channel Management MIB

Status of This Memo

This document specifies an Internet standards track protocol for the Internet community, and requests discussion and suggestions for improvements. Please refer to the current edition of the "Internet Official Protocol Standards" (STD 1) for the standardization state and status of this protocol. Distribution of this memo is unlimited.

Copyright Notice

Copyright (C) The Internet Society (2005).

Abstract

This memo defines a portion of the Management Information Base (MIB) for use with network management protocols in the Internet community. In particular, it describes managed objects for information related to the Fibre Channel.

Table of Contents

1. Introduction ................................................. 2 2. The Internet-Standard Management Framework ................... 2 3. Short Overview of the Fibre Channel .......................... 2 4. MIB Overview ................................................. 3 

   4.1.  The fcmInstanceBasicGroup Group ........................  3
   4.2.  The fcmSwitchBasicGroup Group ..........................  4
   4.3.  The fcmPortBasicGroup Group ............................  4
   4.4.  The fcmPortStatsGroup Group ............................  4
   4.5.  The fcmPortClass23StatsGroup Group .....................  4
   4.6.  The fcmPortLcStatsGroup Group ..........................  4
   4.7.  The fcmPortClassFStatsGroup Group ......................  4
   4.8.  The fcmPortErrorsGroup Group ...........................  4
   4.9.  The fcmSwitchPortGroup Group ...........................  5
   4.10. The fcmSwitchLoginGroup Group ..........................  5
   4.11. The fcmLinkBasicGroup Group ............................  5

5. Relationship to Other MIBs ................................... 5 

   5.1.  The Interfaces Group MIB ...............................  5
   5.2.  Entity MIB .............................................  8
   5.3.  Host Resources MIB .....................................  9

6. Definitions .................................................. 9 7. Acknowledgements ............................................. 57 8. Normative References ......................................... 57 9. Informative References ....................................... 58 10. Security Considerations ...................................... 59 11. IANA Considerations .......................................... 60 

   11.1. OID Assignment ......................................... 60
   11.2. FC Port Type Registry .................................. 60

12. Comparison to the Fibre Channel Management Integration MIB ... 62 

   12.1. Problems with the Fibre Channel Management Integration
         MIB .................................................... 62
   12.2. Detailed Changes ....................................... 62

13. Comparison to RFC 2837 ....................................... 67

Introduction

This memo defines a portion of the Management Information Base (MIB) for use with network management protocols in the Internet community. In particular, it describes managed objects for information related to the Fibre Channel.

The Internet-Standard Management Framework

For a detailed overview of the documents that describe the current Internet-Standard Management Framework, please refer to section 7 of RFC 3410 [RFC3410].

Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. MIB objects are generally accessed through the Simple Network Management Protocol (SNMP). Objects in the MIB are defined using the mechanisms defined in the Structure of Management Information (SMI). This memo specifies a MIB module that is compliant to the SMIv2, which is described in STD 58, RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 [RFC2580].

Short Overview of the Fibre Channel

The Fibre Channel (FC) is logically a bidirectional point-to-point serial data channel, structured for high performance capability. The Fibre Channel provides a general transport vehicle for higher level protocols such as Intelligent Peripheral Interface (IPI) and Small Computer System Interface (SCSI) command sets, the High-Performance Parallel Interface (HIPPI) data framing, IP (Internet Protocol), IEEE 802.2, and others.

Physically, the Fibre Channel is an interconnection of multiple communication points, called N_Ports, interconnected either by a

switching network, called a Fabric, or by a point-to-point link. A Fibre Channel "node" consists of one or more N_Ports. A Fabric may consist of multiple Interconnect Elements, some of which are switches. An N_Port connects to the Fabric via a port on a switch called an F_Port. When multiple FC nodes are connected to a single port on a switch via an "Arbitrated Loop" topology, the switch port is called an FL_Port, and the nodes' ports are called NL_Ports. The term Nx_Port refers to either an N_Port or an NL_port. The term Fx_Port refers to either an F_Port or an FL_port. A switch port, which is interconnected to another switch port via an Inter Element Link (IEL), is called an E_Port. A B_Port connects a bridge device with an E_Port on a switch; a B_Port provides a subset of E_Port functionality.

Many Fibre Channel components, including the fabric, each node, and most ports, have globally-unique names. These globally-unique names are typically formatted as World Wide Names (WWNs). More information on WWNs can be found in [WWN1] and [WWN2]. WWNs are expected to be persistent across agent and unit resets.

Fibre Channel frames contain 24-bit address identifiers that identify the frame's source and destination ports. Each FC port has an address identifier and a WWN. When a fabric is in use, the FC address identifiers are dynamic and are assigned by a switch.

MIB Overview

This MIB contains the notion of a Fibre Channel management instance, which is defined as a separable managed instance of Fibre Channel functionality. Fibre Channel functionality may be grouped into Fibre Channel management instances in whatever way is most convenient for the implementation(s). For example, one such grouping accommodates a single SNMP agent having multiple AgentX [RFC2741] sub-agents, with each sub-agent implementing a different Fibre Channel management instance. To represent such multiple Fibre Channel management instances within the same SNMP context (see section 3.3.1 of [RFC3411]), all tables in this MIB are INDEX-ed by fcmInstanceIndex, which is defined as an arbitrary integer to uniquely identify a particular Fibre Channel management instance.

This MIB contains eleven MIB groups, as follows.

The fcmInstanceBasicGroup Group

This group contains basic information about a Fibre Channel managed instance, including its name and description, the Fibre Channel function(s) it performs, and optional pointers to hardware and/or software components.

The fcmSwitchBasicGroup Group

This group contains basic information about a Fibre Channel switch, including its domain-id and whether it is the principal switch of its fabric.

The fcmPortBasicGroup Group

This group contains basic information about a Fibre Channel port, including its port name (WWN), the name of the node (if any) of which it is a part, the type of port, the classes of service it supports, its transmitter and connector types, and the higher level protocols it supports.

Each Fibre Channel port is represented by an entry in the ifTable (see below). The tables relating to ports in this MIB are indexed by the port's value of ifIndex.

The fcmPortStatsGroup Group

This group contains traffic statistics, which are not specific to any particular class of service, for Fibre Channel ports.

The fcmPortClass23StatsGroup Group

This group contains traffic statistics that are specific to Class 2 or Class 3 traffic on Fibre Channel ports, including class-specific frame and octet counters and counters of busy and reject frames.

The fcmPortLcStatsGroup Group

Some of the statistics in the fcmPortClass23StatsGroup can increase rapidly enough to warrant them being defined using the Counter64 syntax. However, some old SNMP systems do not (yet) support Counter64 objects. Thus, this group defines low-capacity (Counter32-based) equivalents for the Counter64-based statistics in the fcmPortClass23StatsGroup group.

The fcmPortClassFStatsGroup Group

This group contains traffic statistics that are specific to Class F traffic on the E_Ports of a Fibre Channel switch.

The fcmPortErrorsGroup Group

This group contains counters of various error conditions that can occur on Fibre Channel ports.

The fcmSwitchPortGroup Group

This group contains information about ports on a Fibre Channel switch. For an Fx_Port, it includes the port's timeout values, its hold-time, and its capabilities in terms of maximum and minimum buffer-to-buffer credit allocations, maximum and minimum data field sizes, and support for class 2 and class 3 sequenced delivery. For an E_Port or B_Port, it includes the buffer-to-buffer credit allocation and data field size.

4.10. The fcmSwitchLoginGroup Group

This group contains information, known to a Fibre Channel switch, about its attached/logged-in Nx_Ports and the service parameters that have been agreed with them.

4.11. The fcmLinkBasicGroup Group

This group contains information known to a local Fibre Channel management instance, and concerning Fibre Channel links including those which terminate locally.

Relationship to Other MIBs

This MIB is a replacement for two other MIBs: RFC 2837, and the Fibre Channel Management Integration MIB which was originally submitted as an Internet Draft to the IETF's IPFC Working Group, and is now available as [MIB-FA].

The Interfaces Group MIB

The Interfaces Group MIB [RFC2863] contains generic information about all lower layer interfaces, i.e., interfaces which are (potentially) below the internet layer. Thus, each Fibre Channel port should have its own row in the ifTable, and that row will contain the generic information about the interface/port. The Interfaces Group MIB specifies that additional information which is specific to a particular type of interface media, should be defined in a media- specific MIB. This MIB is the media-specific MIB for Fibre Channel ports/interfaces.

Section 4 of [RFC2863] requires that a media-specific MIB clarify how the generic definitions apply for the particular type of media. The clarifications for Fibre Channel interfaces are as follows.

Layering Model

The Interfaces Group MIB permits multiple ifTable entries to be defined for interface sub-layers, and for those multiple entries to be arranged in a stack.

For Fibre Channel interfaces, no sublayers are defined and a Fibre Channel interface will typically have no other ifTable rows stacked on top of it, nor underneath it.

Virtual Circuits

This Fibre Channel MIB does not deal with virtual circuits.

ifRcvAddressTable

The ifRcvAddressTable does not apply to Fibre Channel interfaces.

ifType

The value of ifType for a Fibre Channel interface is 56.

ifXxxOctets

The definitions of ifInOctets and ifOutOctets (and similarly, ifHCInOctets and ifHCOutOctets) specify that their values include framing characters. For Fibre Channel interfaces, they include all the octets contained in frames between the Start-of-Frame and End- of-Frame delimiters (excluding the delimiters).

Specific Interface Group MIB Objects

The following table provides specific implementation guidelines for applying the objects defined in the Interfaces Group MIB to Fibre Channel interfaces. For those objects not listed here, refer to their generic definitions in [RFC2863]. (RFC 2863 takes precedence over these guidelines in the event of any conflict.) 

  Object                   Guidelines

  ifType                   56

  ifMtu                    The MTU as seen by a higher layer
                           protocol, like IP.
                           That is, when IP is running over the
                           interface, this object is the size of the
                           largest IP datagram that can be
                           sent/received over the interface.

  ifSpeed                  For 1Gbs, this will be 1,000,000,000;
                           for 2Gbs, it will be 2,000,000,000.  If
                           auto-negotiation is implemented and
                           enabled on an interface, and the
                           interface has not yet negotiated an
                           operational speed, this object SHOULD
                           reflect the maximum speed supported by
                           the interface.

  ifPhysAddress            The interface's 24-bit Fibre Channel
                           Address Identifier, or the zero-length
                           string if no Address Identifier has been
                           assigned to the interface.

  ifAdminStatus            Write access is not required, and support
                           for 'testing' is not required.

  ifOperStatus             Support for 'testing' is not required.
                           The value 'dormant' has no meaning for
                           Fibre Channel interfaces.

  ifInOctets               The number of octets of information

  ifHCInOctets             contained in received frames between the
                           Start-of-Frame and End-of-Frame
                           delimiters (excluding the delimiters).

  ifInUcastPkts            The number of unicast frames received,

  ifHCInUcastPkts          i.e., the number of Start-of-Frame
                           delimiters received for unicast frames.

  ifInErrors               The sum for this interface of

                              fcmPortLossofSynchs
                              fcmPortLossofSignals
                              fcmPortPrimSeqProtocolErrors
                              fcmPortInvalidTxWords
                              fcmPortInvalidCRCs
                              fcmPortAddressErrors
                              fcmPortDelimiterErrors
                              fcmPortTruncatedFrames
                              fcmPortEncodingDisparityErrors

                           plus any errors in fcmPortOtherErrors
                           that were input errors.

  ifOutOctets              The number of octets of information
  ifHCOutOctets            contained in transmitted frames between
                           the Start-of-Frame and End-of-Frame
                           delimiters (excluding the delimiters).

  ifOutUcastPkts           The number of frames transmitted,
                           ifHCOutUcastPkts         i.e., the number
                           of start-of-frame delimiters transmitted
                           for unicast frames.

  ifOutErrors              This is the number of errors in
                           fcmPortOtherErrors that were output
                           errors.

  ifInMulticastPkts        These counters are not incremented

  ifInBroadcastPkts        (unless a proprietary mechanism for
  ifOutMulticastPkts       multicast/broadcast is supported).
  ifOutBroadcastPkts
  ifHCInMulticastPkts
  ifHCInBroadcastPkts
  ifHCOutMulticastPkts
  ifHCOutBroadcastPkts

  ifLinkUpDownTrapEnable   Refer to [RFC2863].  Default is 'enabled'

  ifHighSpeed              The current operational speed of the
                           interface in millions of bits per second.
                           For 1Gbs, this will be 1000; for 2Gbs, it
                           will be 2000.  If auto-negotiation is
                           implemented and enabled on an interface,
                           and the interface has not yet negotiated
                           an operational speed, this object SHOULD
                           reflect the maximum speed supported by
                           the interface.

  ifPromiscuousMode        This will normally be 'false'

  ifConnectorPresent       This will normally be 'true'.

Entity MIB

The Entity MIB [RFC2737] contains information about individual physical components and any hierarchical relationship that may exist between them. Any Fibre Channel management instance with a relationship to a physical component (or to a hierarchy of physical components) will have its value of the fcmInstancePhysicalIndex object contain a pointer to the relevant row in the Entity MIB. If

there is no correspondence with a physical component (or said component does not have a row in the Entity MIB), then the value of fcmInstancePhysicalIndex is zero. (Note that an implementation is not required to support a non-zero value of fcmInstancePhysicalIndex.)

Host Resources MIB

The Host Resources MIB [RFC2790] includes information about installed software modules. Any Fibre Channel management instance with a correspondence to a software module, will have its value of the fcmInstanceSoftwareIndex object contain a pointer to the relevant row in the Host Resources MIB. If there is no correspondence to a software module (or said software module does not have a row in the Host Resources MIB), then the value of fcmInstanceSoftwareIndex is zero. (Note that an agent implementation is not required to support a non-zero value of fcmInstanceSoftwareIndex.)

Definitions

FC-MGMT-MIB DEFINITIONS ::= BEGIN

IMPORTS 

   MODULE-IDENTITY, OBJECT-TYPE,
   Integer32, Unsigned32, Counter32, Counter64, transmission
                           FROM SNMPv2-SMI
   MODULE-COMPLIANCE, OBJECT-GROUP
                           FROM SNMPv2-CONF
   TruthValue, TEXTUAL-CONVENTION
                           FROM SNMPv2-TC
   ifIndex                 FROM IF-MIB
   SnmpAdminString         FROM SNMP-FRAMEWORK-MIB;

fcMgmtMIB MODULE-IDENTITY 

   LAST-UPDATED    "200504260000Z"  -- 26 April 2005
   ORGANIZATION    "IETF IPS (IP-Storage) Working Group"
   CONTACT-INFO
           "        Keith McCloghrie
                    Cisco Systems, Inc.
               Tel: +1 408 526-5260
            E-mail: [email protected]
            Postal: 170 West Tasman Drive
                    San Jose, CA USA 95134
           "
   DESCRIPTION
           "This module defines management information specific to
           Fibre Channel-attached devices.

           Copyright (C) The Internet Society (2005).  This version
           of this MIB module is part of RFC 4044;  see the RFC
           itself for full legal notices."
  REVISION        "200504260000Z"  -- 26 April 2005
  DESCRIPTION
          "Initial version of the Fibre Channel Mgmt MIB module."
 ::= { transmission 56 }

fcmgmtObjects       OBJECT IDENTIFIER ::= { fcMgmtMIB 1 }
fcmgmtNotifications OBJECT IDENTIFIER ::= { fcMgmtMIB 2 }
fcmgmtNotifPrefix   OBJECT IDENTIFIER ::= { fcmgmtNotifications 0 }
fcmgmtConformance   OBJECT IDENTIFIER ::= { fcMgmtMIB 3 }

--********************************
--  Textual Conventions
--

FcNameIdOrZero ::= TEXTUAL-CONVENTION
 STATUS current
 DESCRIPTION
         "The World Wide Name (WWN) associated with a Fibre Channel
         (FC) entity.  WWNs were initially defined as 64-bits in
         length.  The latest definition (for future use) is 128-bits
         long.  The zero-length string value is used in
         circumstances in which the WWN is unassigned/unknown."
SYNTAX  OCTET STRING (SIZE(0 | 8 | 16))

FcAddressIdOrZero ::= TEXTUAL-CONVENTION 

STATUS current
DESCRIPTION
        "A Fibre Channel Address ID, a 24-bit value unique within
        the address space of a Fabric.  The zero-length string value
        is used in circumstances in which the WWN is
        unassigned/unknown."
SYNTAX  OCTET STRING (SIZE(0 | 3))

FcDomainIdOrZero ::= TEXTUAL-CONVENTION 

STATUS current
DESCRIPTION
        "The Domain Id (of an FC switch), or zero if the no Domain
        Id has been assigned."
SYNTAX  Integer32 (0..239)

FcPortType ::= TEXTUAL-CONVENTION 

STATUS current
DESCRIPTION
        "The type of a Fibre Channel port, as indicated by the use
        of the appropriate value assigned by IANA."
REFERENCE
         "The IANA-maintained registry for
          Fibre Channel port types (http://www.iana.org/)."
SYNTAX   Unsigned32

FcClasses ::= TEXTUAL-CONVENTION 

STATUS current
DESCRIPTION
        "A set of Fibre Channel classes of service."
REFERENCE
         "Classes of service are described in FC-FS Section 13."
SYNTAX   BITS { classF(0), class1(1), class2(2), class3(3),
                class4(4), class5(5), class6(6) }

FcBbCredit ::= TEXTUAL-CONVENTION 

STATUS current
DESCRIPTION
        "The buffer-to-buffer credit of an FC port."
SYNTAX     Integer32 (0..32767)

FcBbCreditModel ::= TEXTUAL-CONVENTION 

STATUS current
DESCRIPTION
        "The buffer-to-buffer credit model of an Fx_Port."
SYNTAX    INTEGER { regular(1), alternate (2) }

FcDataFieldSize ::= TEXTUAL-CONVENTION 

STATUS current
DESCRIPTION
        "The Receive Data Field Size associated with an FC port."
SYNTAX     Integer32 (128..2112)

FcUnitFunctions ::= TEXTUAL-CONVENTION 

STATUS current
DESCRIPTION
        "A set of functions that a Fibre Channel Interconnect
        Element or Platform might perform.  A value with no bits set
        indicates the function(s) are unknown.  The individual bits
        have the following meanings:

        other - none of the following.

        hub - a device that interconnects L_Ports, but does not
        operate as an FL_Port.

        switch - a fabric element conforming to the Fibre Channel
        switch fabric set of standards (e.g., [FC-SW-3]).

        bridge - a device that encapsulates Fibre Channel frames
        within another protocol (e.g., [FC-BB], FC-BB-2).

        gateway - a device that converts an FC-4 to another protocol
        (e.g., FCP to iSCSI).

        host - a computer system that provides end users with
        services such as computation and storage access.

        storageSubsys - an integrated collection of storage
        controllers, storage devices, and necessary software that
        provides storage services to one or more hosts.

        storageAccessDev - a device that provides storage management
        and access for heterogeneous hosts and heterogeneous devices
        (e.g., medium changer).

        nas - a device that connects to a network and provides file
        access services.

        wdmux - a device that modulates/demodulates each of several
        data streams (e.g., Fibre Channel protocol data streams)
        onto/from a different part of the light spectrum in an
        optical fiber.

        storageDevice - a disk/tape/etc. device (without the
        controller and/or software required for it to be a
        'storageSubsys')."
SYNTAX  BITS {
            other(0),        -- none of the following
            hub(1),
            switch(2),

            bridge(3),
            gateway(4),
            host(5),
            storageSubsys(6),
            storageAccessDev(7),
            nas(8),
            wdmux(9),
            storageDevice(10)
        }

--******************************** -- MIB object definitions --

fcmInstanceTable OBJECT-TYPE 

SYNTAX     SEQUENCE OF FcmInstanceEntry
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "Information about the local Fibre Channel management
        instances."
::= { fcmgmtObjects 1 }

fcmInstanceEntry OBJECT-TYPE 

SYNTAX     FcmInstanceEntry
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "A list of attributes for a particular local Fibre Channel
        management instance."
INDEX { fcmInstanceIndex }
::= { fcmInstanceTable 1 }

FcmInstanceEntry ::= 

SEQUENCE {
    fcmInstanceIndex             Unsigned32,
    fcmInstanceWwn               FcNameIdOrZero,
    fcmInstanceFunctions         FcUnitFunctions,
    fcmInstancePhysicalIndex     Integer32,
    fcmInstanceSoftwareIndex     Integer32,
    fcmInstanceStatus            INTEGER,
    fcmInstanceTextName          SnmpAdminString,
    fcmInstanceDescr             SnmpAdminString,
    fcmInstanceFabricId          FcNameIdOrZero
}

fcmInstanceIndex OBJECT-TYPE 

SYNTAX     Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "An arbitrary integer value that uniquely identifies this
        instance amongst all local Fibre Channel management
        instances.

        It is mandatory to keep this value constant between restarts
        of the agent, and to make every possible effort to keep it
        constant across restarts (but note, it is unrealistic to
        expect it to remain constant across all re-configurations of
        the local system, e.g., across the replacement of all non-
        volatile storage)."
::= { fcmInstanceEntry 1 }

fcmInstanceWwn OBJECT-TYPE 

SYNTAX     FcNameIdOrZero
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "If the instance has one (or more) WWN(s), then this object
        contains that (or one of those) WWN(s).

        If the instance does not have a WWN associated with it, then
        this object contains the zero-length string."
::= { fcmInstanceEntry 2 }

fcmInstanceFunctions OBJECT-TYPE 

SYNTAX     FcUnitFunctions
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "One (or more) Fibre Channel unit functions being performed
        by this instance."
::= { fcmInstanceEntry 3 }

fcmInstancePhysicalIndex OBJECT-TYPE 

SYNTAX     Integer32 (0..2147483647)
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "If this management instance corresponds to a physical
        component (or to a hierarchy of physical components)
        identified by the Entity-MIB, then this object's value is
        the value of the entPhysicalIndex of that component (or of
        the component at the root of that hierarchy).  If there is

        no correspondence to a physical component (or no component
        that has an entPhysicalIndex value), then the value of this
        object is zero."
REFERENCE
    "entPhysicalIndex is defined in the Entity MIB, RFC 2737."
::= { fcmInstanceEntry 4 }

fcmInstanceSoftwareIndex OBJECT-TYPE 

SYNTAX     Integer32 (0..2147483647)
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "If this management instance corresponds to an installed
        software module identified in the Host Resources MIB, then
        this object's value is the value of the hrSWInstalledIndex
        of that module.  If there is no correspondence to an
        installed software module (or no module that has a
        hrSWInstalledIndex value), then the value of this object is
        zero."
REFERENCE
    "hrSWInstalledIndex is defined in the Host Resources MIB,
     RFC 2790"
::= { fcmInstanceEntry 5 }

fcmInstanceStatus OBJECT-TYPE 

SYNTAX     INTEGER {
               unknown(1),
               ok(2),      -- able to operate correctly
               warning(3), -- needs attention
               failed(4)   -- something has failed
           }
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "Overall status of the Fibre Channel entity/entities managed
        by this management instance.  The value should reflect the
        most serious status of such entities."
::= { fcmInstanceEntry 6 }

fcmInstanceTextName OBJECT-TYPE 

SYNTAX     SnmpAdminString (SIZE(0..79))
MAX-ACCESS read-write
STATUS     current
DESCRIPTION
        "A textual name for this management instance and the Fibre
        Channel entity/entities that it is managing."
::= { fcmInstanceEntry 7 }

fcmInstanceDescr OBJECT-TYPE 

SYNTAX     SnmpAdminString
MAX-ACCESS read-write
STATUS     current
DESCRIPTION
        "A textual description of this management instance and the
        Fibre Channel entity/entities that it is managing."
::= { fcmInstanceEntry 8 }

fcmInstanceFabricId OBJECT-TYPE 

SYNTAX     FcNameIdOrZero
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The globally unique Fabric Identifier that identifies the
        fabric to which the Fibre Channel entity/entities managed by
        this management instance are connected, or, of which they
        are a part.  This is typically the Node WWN of the principal
        switch of a Fibre Channel fabric.  The zero-length string
        indicates that the fabric identifier is unknown (or not
        applicable).

        In the event that the Fibre Channel entity/entities managed
        by this management instance is/are connected to multiple
        fabrics, then this object records the first (known) one."
::= { fcmInstanceEntry 9 }

--******************************** -- The Fibre Channel Switch Table --

fcmSwitchTable OBJECT-TYPE 

SYNTAX     SEQUENCE OF FcmSwitchEntry
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "A table of information about Fibre Channel switches that
        are managed by Fibre Channel management instances.  Each
        Fibre Channel management instance can manage one or more
        Fibre Channel switches."
::= { fcmgmtObjects 2 }

fcmSwitchEntry OBJECT-TYPE 

SYNTAX     FcmSwitchEntry
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "Information about a particular Fibre Channel switch that is

        managed by the management instance given by
        fcmInstanceIndex."
INDEX { fcmInstanceIndex, fcmSwitchIndex }
::= { fcmSwitchTable 1 }

FcmSwitchEntry ::= 

SEQUENCE {
    fcmSwitchIndex         Unsigned32,
    fcmSwitchDomainId      FcDomainIdOrZero,
    fcmSwitchPrincipal     TruthValue,
    fcmSwitchWWN           FcNameIdOrZero
}

fcmSwitchIndex OBJECT-TYPE 

SYNTAX     Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "An arbitrary integer that uniquely identifies a Fibre
        Channel switch amongst those managed by one Fibre Channel
        management instance.

        It is mandatory to keep this value constant between restarts
        of the agent, and to make every possible effort to keep it
        constant across restarts."
::= { fcmSwitchEntry 1 }

fcmSwitchDomainId OBJECT-TYPE 

SYNTAX     FcDomainIdOrZero
MAX-ACCESS read-write
STATUS     current
DESCRIPTION
        "The Domain Id of this switch.  A value of zero indicates
        that a switch has not (yet) been assigned a Domain Id."
::= { fcmSwitchEntry 2 }

fcmSwitchPrincipal OBJECT-TYPE 

SYNTAX     TruthValue
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "An indication of whether this switch is the principal
        switch within its fabric."
::= { fcmSwitchEntry 3 }

fcmSwitchWWN OBJECT-TYPE 

SYNTAX     FcNameIdOrZero
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The World Wide Name of this switch."
::= { fcmSwitchEntry 4 }

--******************************** -- The Fibre Channel Port Table --

fcmPortTable OBJECT-TYPE 

SYNTAX     SEQUENCE OF FcmPortEntry
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "Information about Fibre Channel ports.  Each Fibre Channel
        port is represented by one entry in the IF-MIB's ifTable."
REFERENCE
    "RFC 2863, The Interfaces Group MIB, June 2000."
::= { fcmgmtObjects 3 }

fcmPortEntry OBJECT-TYPE 

SYNTAX     FcmPortEntry
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "Each entry contains information about a specific port."
INDEX { ifIndex }
::= { fcmPortTable 1 }

FcmPortEntry ::= 

SEQUENCE {
    fcmPortInstanceIndex    Unsigned32,
    fcmPortWwn              FcNameIdOrZero,
    fcmPortNodeWwn          FcNameIdOrZero,
    fcmPortAdminType        FcPortType,
    fcmPortOperType         FcPortType,
    fcmPortFcCapClass       FcClasses,
    fcmPortFcOperClass      FcClasses,
    fcmPortTransmitterType  INTEGER,
    fcmPortConnectorType    INTEGER,
    fcmPortSerialNumber     SnmpAdminString,
    fcmPortPhysicalNumber   Unsigned32,
    fcmPortAdminSpeed       INTEGER,
    fcmPortCapProtocols     BITS,
    fcmPortOperProtocols    BITS

}

fcmPortInstanceIndex OBJECT-TYPE 

SYNTAX     Unsigned32 (1..4294967295)
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The value of fcmInstanceIndex by which the Fibre Channel
        management instance, which manages this port, is identified
        in the fcmInstanceTable."
::= { fcmPortEntry 1 }

fcmPortWwn OBJECT-TYPE 

SYNTAX     FcNameIdOrZero
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The World Wide Name of the port, or the zero-length string
        if the port does not have a WWN."
 ::= { fcmPortEntry 2 }

fcmPortNodeWwn OBJECT-TYPE 

SYNTAX     FcNameIdOrZero
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The World Wide Name of the Node that contains this port, or
        the zero-length string if the port does not have a node
        WWN."
 ::= { fcmPortEntry 3 }

fcmPortAdminType OBJECT-TYPE 

SYNTAX     FcPortType
MAX-ACCESS read-write
STATUS     current
DESCRIPTION
        "The administratively desired type of this port."
::= { fcmPortEntry 4 }

fcmPortOperType OBJECT-TYPE 

SYNTAX     FcPortType
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The current operational type of this port."
::= { fcmPortEntry 5 }

fcmPortFcCapClass OBJECT-TYPE 

SYNTAX     FcClasses
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The classes of service capability of this port."
::= { fcmPortEntry 6 }

fcmPortFcOperClass OBJECT-TYPE 

SYNTAX     FcClasses
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The classes of service that are currently operational on
        this port.  For an FL_Port, this is the union of the classes
        being supported across all attached NL_Ports."
::= { fcmPortEntry 7 }

fcmPortTransmitterType OBJECT-TYPE 

SYNTAX     INTEGER {
    unknown(1),
    other(2),
    shortwave850nm(3),
    longwave1550nm(4),
    longwave1310nm(5),
    electrical(6)
 }
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The technology of the port transceiver."
REFERENCE
    "FC-GS-3, section 6.1.2.2.3"
::= { fcmPortEntry 8 }

fcmPortConnectorType OBJECT-TYPE 

SYNTAX     INTEGER {
    unknown(1),
    other(2),
    gbic(3),
    embedded(4),
    glm(5),
    gbicSerialId(6),
    gbicNoSerialId(7),
    sfpSerialId(8),
    sfpNoSerialId(9)
}
MAX-ACCESS read-only

STATUS     current
DESCRIPTION
        "The module type of the port connector.  This object refers
        to the hardware implementation of the port.  It will be
        'embedded' if the hardware equivalent to Gigabit interface
        card (GBIC) is part of the line card and is unremovable.  It
        will be 'glm' if it's a gigabit link module (GLM).  It will
        be 'gbicSerialId' if the GBIC serial id can be read, else it
        will be 'gbicNoSerialId'.  It will be 'sfpSerialId' if the
        small form factor (SFP) pluggable GBICs serial id can be
        read, else it will be 'sfpNoSerialId'."
REFERENCE
    "FC-GS-3, section 6.1.2.2.4"
::= { fcmPortEntry 9 }

fcmPortSerialNumber OBJECT-TYPE 

SYNTAX      SnmpAdminString
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The serial number associated with the port (e.g., for a
        GBIC).  If not applicable, the object's value is a zero-
        length string."
REFERENCE
    "FC-GS-3, section 6.1.2.2.4"
::= { fcmPortEntry 10 }

fcmPortPhysicalNumber OBJECT-TYPE 

SYNTAX      Unsigned32
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "This is the port's 'Physical Port Number' as defined by
        GS-3."
REFERENCE
    "FC-GS-3, section 6.1.2.2.5"
::= { fcmPortEntry 11 }

fcmPortAdminSpeed OBJECT-TYPE 

SYNTAX     INTEGER {
               auto(1),
               eighthGbs(2),   -- 125Mbs
               quarterGbs(3),  -- 250Mbs
               halfGbs(4),     -- 500Mbs
               oneGbs(5),      --   1Gbs
               twoGbs(6),      --   2Gbs
               fourGbs(7),     --   4Gbs
               tenGbs(8)       --  10Gbs

           }
MAX-ACCESS read-write
STATUS     current
DESCRIPTION
        "The speed of the interface:

            'auto'        - auto-negotiation
            'tenGbs'      - 10Gbs
            'fourGbs'     -  4Gbs
            'twoGbs'      -  2Gbs
            'oneGbs'      -  1Gbs
            'halfGbs'     - 500Mbs
            'quarterGbs'  - 250Mbs
            'eighthGbs'   - 125Mbs"
::= { fcmPortEntry 12 }

fcmPortCapProtocols OBJECT-TYPE 

SYNTAX     BITS {
               unknown(0),
               loop(1),
               fabric(2),
               scsi(3),
               tcpIp(4),
               vi(5),
               ficon(6)
           }
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "A bit mask specifying the higher level protocols that are
        capable of running over this port.  Note that for generic
        Fx_Ports, E_Ports, and B_Ports, this object will indicate
        all protocols."
::= { fcmPortEntry 13 }

fcmPortOperProtocols OBJECT-TYPE 

SYNTAX     BITS {
               unknown(0),
               loop(1),
               fabric(2),
               scsi(3),
               tcpIp(4),
               vi(5),
               ficon(6)
           }
MAX-ACCESS read-only
STATUS     current
DESCRIPTION

        "A bit mask specifying the higher level protocols that are
        currently operational on this port.  For Fx_Ports, E_Ports,
        and B_Ports, this object will typically have the value
        'unknown'."
::= { fcmPortEntry 14 }

--******************************** -- Port Statistics --

fcmPortStatsTable OBJECT-TYPE 

SYNTAX     SEQUENCE OF FcmPortStatsEntry
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "A list of statistics for Fibre Channel ports."
::= { fcmgmtObjects 4 }

fcmPortStatsEntry OBJECT-TYPE 

SYNTAX     FcmPortStatsEntry
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "An entry containing statistics for a Fibre Channel port.
        If any counter in this table suffers a discontinuity, the
        value of ifCounterDiscontinuityTime (defined in the IF-MIB)
        must be updated."
REFERENCE  "The Interfaces Group MIB, RFC 2863, June 2000."
AUGMENTS   { fcmPortEntry }
::= { fcmPortStatsTable 1 }

FcmPortStatsEntry ::= 

SEQUENCE {
    fcmPortBBCreditZeros       Counter64,
    fcmPortFullInputBuffers    Counter64,
    fcmPortClass2RxFrames      Counter64,
    fcmPortClass2RxOctets      Counter64,
    fcmPortClass2TxFrames      Counter64,
    fcmPortClass2TxOctets      Counter64,
    fcmPortClass2Discards      Counter64,
    fcmPortClass2RxFbsyFrames  Counter64,
    fcmPortClass2RxPbsyFrames  Counter64,
    fcmPortClass2RxFrjtFrames  Counter64,
    fcmPortClass2RxPrjtFrames  Counter64,
    fcmPortClass2TxFbsyFrames  Counter64,
    fcmPortClass2TxPbsyFrames  Counter64,
    fcmPortClass2TxFrjtFrames  Counter64,
    fcmPortClass2TxPrjtFrames  Counter64,

    fcmPortClass3RxFrames      Counter64,
    fcmPortClass3RxOctets      Counter64,
    fcmPortClass3TxFrames      Counter64,
    fcmPortClass3TxOctets      Counter64,
    fcmPortClass3Discards      Counter64,
    fcmPortClassFRxFrames      Counter32,
    fcmPortClassFRxOctets      Counter32,
    fcmPortClassFTxFrames      Counter32,
    fcmPortClassFTxOctets      Counter32,
    fcmPortClassFDiscards      Counter32
}

fcmPortBBCreditZeros OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of transitions in/out of the buffer-to-buffer
        credit zero state.  The other side is not providing any
        credit."
::= { fcmPortStatsEntry 1 }

fcmPortFullInputBuffers OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of occurrences when all input buffers of a port
        were full and outbound buffer-to-buffer credit transitioned
        to zero, i.e., there became no credit to provide to other
        side."
::= { fcmPortStatsEntry 2 }

fcmPortClass2RxFrames OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Class 2 frames received at this port."
::= { fcmPortStatsEntry 3 }

fcmPortClass2RxOctets OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of octets contained in Class 2 frames received
        at this port."

::= { fcmPortStatsEntry 4 }

fcmPortClass2TxFrames OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Class 2 frames transmitted out of this port."
::= { fcmPortStatsEntry 5 }

fcmPortClass2TxOctets OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of octets contained in Class 2 frames
        transmitted out of this port."
::= { fcmPortStatsEntry 6 }

fcmPortClass2Discards OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Class 2 frames that were discarded upon
        reception at this port."
::= { fcmPortStatsEntry 7 }

fcmPortClass2RxFbsyFrames OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times that F_BSY was returned to this port as
        a result of a Class 2 frame that could not be delivered to
        the other end of the link.  This can occur when either the
        fabric or the destination port is temporarily busy.  Note
        that this counter will never increment for an F_Port."
::= { fcmPortStatsEntry 8 }

fcmPortClass2RxPbsyFrames OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times that P_BSY was returned to this port as
        a result of a Class 2 frame that could not be delivered to
        the other end of the link.  This can occur when the

        destination port is temporarily busy."
::= { fcmPortStatsEntry 9 }

fcmPortClass2RxFrjtFrames OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times that F_RJT was returned to this port as
        a result of a Class 2 frame that was rejected by the fabric.
        Note that this counter will never increment for an F_Port."
::= { fcmPortStatsEntry 10 }

fcmPortClass2RxPrjtFrames OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times that P_RJT was returned to this port as
        a result of a Class 2 frame that was rejected at the
        destination N_Port."
::= { fcmPortStatsEntry 11 }

fcmPortClass2TxFbsyFrames OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times that F_BSY was generated by this port
        as a result of a Class 2 frame that could not be delivered
        because either the Fabric or the destination port was
        temporarily busy.  Note that this counter will never
        increment for an N_Port."
::= { fcmPortStatsEntry 12 }

fcmPortClass2TxPbsyFrames OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times that P_BSY was generated by this port
        as a result of a Class 2 frame that could not be delivered
        because the destination port was temporarily busy.  Note
        that this counter will never increment for an F_Port."
::= { fcmPortStatsEntry 13 }

fcmPortClass2TxFrjtFrames OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times that F_RJT was generated by this port
        as a result of a Class 2 frame being rejected by the fabric.
        Note that this counter will never increment for an N_Port."
::= { fcmPortStatsEntry 14 }

fcmPortClass2TxPrjtFrames OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times that P_RJT was generated by this port
        as a result of a Class 2 frame being rejected at the
        destination N_Port.  Note that this counter will never
        increment for an F_Port."
::= { fcmPortStatsEntry 15 }

fcmPortClass3RxFrames OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Class 3 frames received at this port."
::= { fcmPortStatsEntry 16 }

fcmPortClass3RxOctets OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of octets contained in Class 3 frames received
        at this port."
::= { fcmPortStatsEntry 17 }

fcmPortClass3TxFrames OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Class 3 frames transmitted out of this port."
::= { fcmPortStatsEntry 18 }

fcmPortClass3TxOctets OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of octets contained in Class 3 frames
        transmitted out of this port."
::= { fcmPortStatsEntry 19 }

fcmPortClass3Discards OBJECT-TYPE 

SYNTAX     Counter64
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Class 3 frames that were discarded upon
        reception at this port."
::= { fcmPortStatsEntry 20 }

fcmPortClassFRxFrames OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Class F frames received at this port."
::= { fcmPortStatsEntry 21 }

fcmPortClassFRxOctets OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of octets contained in Class F frames received
        at this port."
::= { fcmPortStatsEntry 22 }

fcmPortClassFTxFrames OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Class F frames transmitted out of this port."
::= { fcmPortStatsEntry 23 }

fcmPortClassFTxOctets OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of octets contained in Class F frames
        transmitted out of this port."
::= { fcmPortStatsEntry 24 }

fcmPortClassFDiscards OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Class F frames that were discarded upon
        reception at this port."
::= { fcmPortStatsEntry 25 }

--******************************** -- Port Low-capacity Statistics -- -- these are Counter32 "low-capacity" counters for systems -- that do not support Counter64's

fcmPortLcStatsTable OBJECT-TYPE 

SYNTAX     SEQUENCE OF FcmPortLcStatsEntry
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "A list of Counter32-based statistics for systems that do
        not support Counter64."
::= { fcmgmtObjects 5 }

fcmPortLcStatsEntry OBJECT-TYPE 

SYNTAX     FcmPortLcStatsEntry
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "An entry containing low-capacity (i.e., based on Counter32)
        statistics for a Fibre Channel port.  If any counter in this
        table suffers a discontinuity, the value of
        ifCounterDiscontinuityTime (defined in the IF-MIB) must be
        updated."
REFERENCE  "The Interfaces Group MIB, RFC 2863, June 2000."
AUGMENTS   { fcmPortEntry }
::= { fcmPortLcStatsTable 1 }

FcmPortLcStatsEntry ::= 

SEQUENCE {
    fcmPortLcBBCreditZeros       Counter32,
    fcmPortLcFullInputBuffers    Counter32,
    fcmPortLcClass2RxFrames      Counter32,
    fcmPortLcClass2RxOctets      Counter32,
    fcmPortLcClass2TxFrames      Counter32,
    fcmPortLcClass2TxOctets      Counter32,
    fcmPortLcClass2Discards      Counter32,
    fcmPortLcClass2RxFbsyFrames  Counter32,
    fcmPortLcClass2RxPbsyFrames  Counter32,
    fcmPortLcClass2RxFrjtFrames  Counter32,
    fcmPortLcClass2RxPrjtFrames  Counter32,
    fcmPortLcClass2TxFbsyFrames  Counter32,
    fcmPortLcClass2TxPbsyFrames  Counter32,
    fcmPortLcClass2TxFrjtFrames  Counter32,
    fcmPortLcClass2TxPrjtFrames  Counter32,
    fcmPortLcClass3RxFrames      Counter32,
    fcmPortLcClass3RxOctets      Counter32,
    fcmPortLcClass3TxFrames      Counter32,
    fcmPortLcClass3TxOctets      Counter32,
    fcmPortLcClass3Discards      Counter32
}

fcmPortLcBBCreditZeros OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of transitions in/out of the buffer-to-buffer
        credit zero state.  The other side is not providing any
        credit."
::= { fcmPortLcStatsEntry 1 }

fcmPortLcFullInputBuffers OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of occurrences when all input buffers of a port
        were full and outbound buffer-to-buffer credit transitioned
        to zero, i.e., there became no credit to provide to other
        side."
::= { fcmPortLcStatsEntry 2 }

fcmPortLcClass2RxFrames OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Class 2 frames received at this port."
::= { fcmPortLcStatsEntry 3 }

fcmPortLcClass2RxOctets OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of octets contained in Class 2 frames received
        at this port."
::= { fcmPortLcStatsEntry 4 }

fcmPortLcClass2TxFrames OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Class 2 frames transmitted out of this port."
::= { fcmPortLcStatsEntry 5 }

fcmPortLcClass2TxOctets OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of octets contained in Class 2 frames
        transmitted out of this port."
::= { fcmPortLcStatsEntry 6 }

fcmPortLcClass2Discards OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Class 2 frames that were discarded upon
        reception at this port."
::= { fcmPortLcStatsEntry 7 }

fcmPortLcClass2RxFbsyFrames OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times that F_BSY was returned to this port as
        a result of a Class 2 frame that could not be delivered to
        the other end of the link.  This can occur when either the
        fabric or the destination port is temporarily busy.  Note
        that this counter will never increment for an F_Port."
::= { fcmPortLcStatsEntry 8 }

fcmPortLcClass2RxPbsyFrames OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times that P_BSY was returned to this port as
        a result of a Class 2 frame that could not be delivered to
        the other end of the link.  This can occur when the
        destination port is temporarily busy."
::= { fcmPortLcStatsEntry 9 }

fcmPortLcClass2RxFrjtFrames OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times that F_RJT was returned to this port as
        a result of a Class 2 frame that was rejected by the fabric.
        Note that this counter will never increment for an F_Port."
::= { fcmPortLcStatsEntry 10 }

fcmPortLcClass2RxPrjtFrames OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times that P_RJT was returned to this port as
        a result of a Class 2 frame that was rejected at the
        destination N_Port."
::= { fcmPortLcStatsEntry 11 }

fcmPortLcClass2TxFbsyFrames OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times that F_BSY was generated by this port
        as a result of a Class 2 frame that could not be delivered
        because either the Fabric or the destination port was
        temporarily busy.  Note that this counter will never
        increment for an N_Port."
::= { fcmPortLcStatsEntry 12 }

fcmPortLcClass2TxPbsyFrames OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times that P_BSY was generated by this port
        as a result of a Class 2 frame that could not be delivered
        because the destination port was temporarily busy.  Note
        that this counter will never increment for an F_Port."
::= { fcmPortLcStatsEntry 13 }

fcmPortLcClass2TxFrjtFrames OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times that F_RJT was generated by this port
        as a result of a Class 2 frame being rejected by the fabric.
        Note that this counter will never increment for an N_Port."
::= { fcmPortLcStatsEntry 14 }

fcmPortLcClass2TxPrjtFrames OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times that P_RJT was generated by this port
        as a result of a Class 2 frame being rejected at the
        destination N_Port.  Note that this counter will never
        increment for an F_Port."
::= { fcmPortLcStatsEntry 15 }

fcmPortLcClass3RxFrames OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Class 3 frames received at this port."
::= { fcmPortLcStatsEntry 16 }

fcmPortLcClass3RxOctets OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of octets contained in Class 3 frames received
        at this port."
::= { fcmPortLcStatsEntry 17 }

fcmPortLcClass3TxFrames OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Class 3 frames transmitted out of this port."
::= { fcmPortLcStatsEntry 18 }

fcmPortLcClass3TxOctets OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of octets contained in Class 3 frames
        transmitted out of this port."
::= { fcmPortLcStatsEntry 19 }

fcmPortLcClass3Discards OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Class 3 frames that were discarded upon
        reception at this port."
::= { fcmPortLcStatsEntry 20 }

--******************************** -- Port Error Counters --

fcmPortErrorsTable OBJECT-TYPE 

SYNTAX     SEQUENCE OF FcmPortErrorsEntry
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "Error counters for Fibre Channel ports."
::= { fcmgmtObjects 6 }

fcmPortErrorsEntry OBJECT-TYPE 

SYNTAX     FcmPortErrorsEntry
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "Error counters for a Fibre Channel port.  If any counter in
        this table suffers a discontinuity, the value of
        ifCounterDiscontinuityTime (defined in the IF-MIB) must be
        updated."
REFERENCE  "The Interfaces Group MIB, RFC 2863, June 2000."
AUGMENTS   { fcmPortEntry }
::= { fcmPortErrorsTable 1 }

FcmPortErrorsEntry ::= 

SEQUENCE {
    fcmPortRxLinkResets             Counter32,
    fcmPortTxLinkResets             Counter32,
    fcmPortLinkResets               Counter32,
    fcmPortRxOfflineSequences       Counter32,
    fcmPortTxOfflineSequences       Counter32,
    fcmPortLinkFailures             Counter32,
    fcmPortLossofSynchs             Counter32,
    fcmPortLossofSignals            Counter32,
    fcmPortPrimSeqProtocolErrors    Counter32,
    fcmPortInvalidTxWords           Counter32,
    fcmPortInvalidCRCs              Counter32,
    fcmPortInvalidOrderedSets       Counter32,
    fcmPortFrameTooLongs            Counter32,
    fcmPortTruncatedFrames          Counter32,
    fcmPortAddressErrors            Counter32,
    fcmPortDelimiterErrors          Counter32,
    fcmPortEncodingDisparityErrors  Counter32,
    fcmPortOtherErrors              Counter32
}

fcmPortRxLinkResets OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Link Reset (LR) Primitive Sequences
        received."
::= { fcmPortErrorsEntry 1 }

fcmPortTxLinkResets OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Link Reset (LR) Primitive Sequences
        transmitted."
::= { fcmPortErrorsEntry 2 }

fcmPortLinkResets OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of times the reset link protocol was initiated
        on this port.  This includes the number of Loop
        Initialization Primitive (LIP) events on an arbitrated loop
        port."
::= { fcmPortErrorsEntry 3 }

fcmPortRxOfflineSequences OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Offline (OLS) Primitive Sequences received at
        this port."
::= { fcmPortErrorsEntry 4 }

fcmPortTxOfflineSequences OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of Offline (OLS) Primitive Sequences transmitted
        by this port."
::= { fcmPortErrorsEntry 5 }

fcmPortLinkFailures OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of link failures.  This count is part of FC-PH's
        Link Error Status Block (LESB)."
REFERENCE
       "FC-PH, rev 4.3, 1 June 1994, section 29.8 [FC-PH]."
::= { fcmPortErrorsEntry 6 }

fcmPortLossofSynchs OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of instances of synchronization loss detected at
        this port.  This count is part of FC-PH's Link Error Status
        Block (LESB)."
REFERENCE
       "FC-PH, rev 4.3, 1 June 1994, section 29.8."
::= { fcmPortErrorsEntry 7 }

fcmPortLossofSignals OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of instances of signal loss detected at this
        port.  This count is part of FC-PH's Link Error Status Block
        (LESB)."
REFERENCE
       "FC-PH, rev 4.3, 1 June 1994, section 29.8."
::= { fcmPortErrorsEntry 8 }

fcmPortPrimSeqProtocolErrors OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of primitive sequence protocol errors detected
        at this port.  This count is part of FC-PH's Link Error
        Status Block (LESB)."
REFERENCE
       "FC-PH, rev 4.3, 1 June 1994, section 29.8."
::= { fcmPortErrorsEntry 9 }

fcmPortInvalidTxWords OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of invalid transmission words received at this
        port.  This count is part of FC-PH's Link Error Status Block
        (LESB)."
REFERENCE
       "FC-PH, rev 4.3, 1 June 1994, section 29.8."
::= { fcmPortErrorsEntry 10 }

fcmPortInvalidCRCs OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of frames received with an invalid CRC.  This
        count is part of FC-PH's Link Error Status Block (LESB)."
REFERENCE
       "FC-PH, rev 4.3, 1 June 1994, section 29.8."
::= { fcmPortErrorsEntry 11 }

fcmPortInvalidOrderedSets OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of invalid ordered sets received at this port."
::= { fcmPortErrorsEntry 12 }

fcmPortFrameTooLongs OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of frames received at this port for which the
        frame length was greater than what was agreed to in
        FLOGI/PLOGI.  This could be caused by losing the end of
        frame delimiter."
::= { fcmPortErrorsEntry 13 }

fcmPortTruncatedFrames OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of frames received at this port for which the

        frame length was less than the minimum indicated by the
        frame header - normally 24 bytes, but it could be more if
        the DFCTL field indicates an optional header should have
        been present."
::= { fcmPortErrorsEntry 14 }

fcmPortAddressErrors OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of frames received with unknown addressing; for
        example, an unknown SID or DID."
::= { fcmPortErrorsEntry 15 }

fcmPortDelimiterErrors OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of invalid frame delimiters received at this
        port.  An example is a frame with a class 2 start and a
        class 3 at the end."
::= { fcmPortErrorsEntry 16 }

fcmPortEncodingDisparityErrors OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of encoding disparity errors received at this
        port."
::= { fcmPortErrorsEntry 17 }

fcmPortOtherErrors OBJECT-TYPE 

SYNTAX     Counter32
MAX-ACCESS read-only
STATUS     current
DESCRIPTION
        "The number of errors that were detected on this port but
        not counted by any other error counter in this row."
::= { fcmPortErrorsEntry 18 }

--******************************** -- The Fibre Channel Fx_Port Table --

fcmFxPortTable OBJECT-TYPE 

SYNTAX     SEQUENCE OF FcmFxPortEntry
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "Additional information about Fibre Channel ports that is
        specific to Fx_Ports.  This table will contain one entry for
        each fcmPortTable entry that represents an Fx_Port."
::= { fcmgmtObjects 7 }

fcmFxPortEntry OBJECT-TYPE 

SYNTAX     FcmFxPortEntry
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "Each entry contains information about a specific Fx_Port."
INDEX { ifIndex }
::= { fcmFxPortTable 1 }

FcmFxPortEntry ::= 

SEQUENCE {
    fcmFxPortRatov                  Unsigned32,
    fcmFxPortEdtov                  Unsigned32,
    fcmFxPortRttov                  Unsigned32,
    fcmFxPortHoldTime               Unsigned32,
    fcmFxPortCapBbCreditMax         FcBbCredit,
    fcmFxPortCapBbCreditMin         FcBbCredit,
    fcmFxPortCapDataFieldSizeMax    FcDataFieldSize,
    fcmFxPortCapDataFieldSizeMin    FcDataFieldSize,
    fcmFxPortCapClass2SeqDeliv      TruthValue,
    fcmFxPortCapClass3SeqDeliv      TruthValue,
    fcmFxPortCapHoldTimeMax         Unsigned32,
    fcmFxPortCapHoldTimeMin         Unsigned32
}

fcmFxPortRatov OBJECT-TYPE 

SYNTAX      Unsigned32
UNITS       "milliseconds"
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The Resource_Allocation_Timeout Value configured for this
        Fx_Port.  This is used as the timeout value for determining
        when to reuse an Nx_Port resource such as a

        Recovery_Qualifier.  It represents the Error_Detect_Timeout
        value (see fcmFxPortEdtov) plus twice the maximum time that
        a frame may be delayed within the Fabric and still be
        delivered."
::= { fcmFxPortEntry 1 }

fcmFxPortEdtov OBJECT-TYPE 

SYNTAX      Unsigned32
UNITS       "milliseconds"
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The Error_Detect_Timeout value configured for this Fx_Port.
        This is used as the timeout value for detecting an error
        condition."
::= { fcmFxPortEntry 2 }

fcmFxPortRttov OBJECT-TYPE 

SYNTAX      Unsigned32
UNITS       "milliseconds"
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The Receiver_Transmitter_Timeout value of this Fx_Port.
        This is used by the receiver logic to detect a Loss of
        Synchronization."
::= { fcmFxPortEntry 3 }

fcmFxPortHoldTime OBJECT-TYPE 

SYNTAX      Unsigned32
UNITS       "microseconds"
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The maximum time that this Fx_Port shall hold a frame
        before discarding the frame if it is unable to deliver the
        frame.  The value 0 means that this Fx_Port does not support
        this parameter."
::= { fcmFxPortEntry 4 }

fcmFxPortCapBbCreditMax OBJECT-TYPE 

SYNTAX      FcBbCredit
UNITS       "buffers"
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The maximum number of receive buffers that this port is
        capable of making available for holding frames from attached

        Nx_Port(s)."
::= { fcmFxPortEntry 5 }

fcmFxPortCapBbCreditMin OBJECT-TYPE 

SYNTAX      FcBbCredit
UNITS       "buffers"
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The minimum number of receive buffers that this port is
        capable of making available for holding frames from attached
        Nx_Port(s)."
::= { fcmFxPortEntry 6 }

fcmFxPortCapDataFieldSizeMax OBJECT-TYPE 

SYNTAX      FcDataFieldSize
UNITS       "bytes"
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The maximum size in bytes of the Data Field in a frame that
        this Fx_Port is capable of receiving from an attached
        Nx_Port."
::= { fcmFxPortEntry 7 }

fcmFxPortCapDataFieldSizeMin OBJECT-TYPE 

SYNTAX      FcDataFieldSize
UNITS       "bytes"
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The minimum size in bytes of the Data Field in a frame that
        this Fx_Port is capable of receiving from an attached
        Nx_Port."
::= { fcmFxPortEntry 8 }

fcmFxPortCapClass2SeqDeliv OBJECT-TYPE 

SYNTAX      TruthValue
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "An indication of whether this Fx_Port is capable of
        supporting Class 2 Sequential Delivery."
::= { fcmFxPortEntry 9 }

fcmFxPortCapClass3SeqDeliv OBJECT-TYPE 

SYNTAX      TruthValue
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "An indication of whether this Fx_Port is capable of
        supporting Class 3 Sequential Delivery."
::= { fcmFxPortEntry 10 }

fcmFxPortCapHoldTimeMax OBJECT-TYPE 

SYNTAX      Unsigned32
UNITS       "microseconds"
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The maximum holding time that this Fx_Port is capable of
        supporting."
::= { fcmFxPortEntry 11 }

fcmFxPortCapHoldTimeMin OBJECT-TYPE 

SYNTAX      Unsigned32
UNITS       "microseconds"
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The minimum holding time that this Fx_Port is capable of
        supporting."
::= { fcmFxPortEntry 12 }

--******************************** -- The Fibre Channel Inter-Switch Port Table --

fcmISPortTable OBJECT-TYPE 

SYNTAX     SEQUENCE OF FcmISPortEntry
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "Additional information about E_Ports, B_Ports, and any
        other type of Fibre Channel port to which inter-switch links
        can be connected.  This table will contain one entry for
        each fcmPortTable entry that represents such a port."
::= { fcmgmtObjects 8 }

fcmISPortEntry OBJECT-TYPE 

SYNTAX     FcmISPortEntry
MAX-ACCESS not-accessible
STATUS     current
DESCRIPTION
        "Each entry contains information about a specific port
        connected to an inter-switch link."
INDEX { ifIndex }
::= { fcmISPortTable 1 }

FcmISPortEntry ::= 

SEQUENCE {
    fcmISPortClassFCredit           FcBbCredit,
    fcmISPortClassFDataFieldSize    FcDataFieldSize
}

fcmISPortClassFCredit OBJECT-TYPE 

SYNTAX      FcBbCredit
MAX-ACCESS  read-write
STATUS      current
DESCRIPTION
        "The maximum number of Class F data frames that can be
        transmitted by the inter-switch port without receipt of ACK
        or Link_Response frames."
::= { fcmISPortEntry 1 }

fcmISPortClassFDataFieldSize OBJECT-TYPE 

SYNTAX      FcDataFieldSize
UNITS       "bytes"
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The Receive Data Field Size that the inter-switch port has
        agreed to support for Class F frames to/from this port.  The
        size specifies the largest Data Field Size for an FT_1
        frame."
::= { fcmISPortEntry 2 }

--******************************** -- The Fabric Login table -- -- This table contains the information held by FC switches -- about the Nx_Ports that are logged-in/attached to their -- Fx_Ports

fcmFLoginTable OBJECT-TYPE 

SYNTAX      SEQUENCE OF FcmFLoginEntry
MAX-ACCESS  not-accessible
STATUS      current
DESCRIPTION
        "A table that contains one entry for each Nx_Port logged-
        in/attached to a particular Fx_Port in the switch.  Each
        entry contains the services parameters established during
        the most recent Fabric Login, explicit or implicit.  Note
        that an Fx_Port may have one or more Nx_Ports attached to
        it."
::= { fcmgmtObjects 9 }

fcmFLoginEntry OBJECT-TYPE 

SYNTAX      FcmFLoginEntry
MAX-ACCESS  not-accessible
STATUS      current
DESCRIPTION
        "An entry containing service parameters established from a
        successful Fabric Login."
INDEX { ifIndex, fcmFLoginNxPortIndex }
::= { fcmFLoginTable 1 }

FcmFLoginEntry ::= 

SEQUENCE {
    fcmFLoginNxPortIndex             Unsigned32,
    fcmFLoginPortWwn                 FcNameIdOrZero,
    fcmFLoginNodeWwn                 FcNameIdOrZero,
    fcmFLoginBbCreditModel           FcBbCreditModel,
    fcmFLoginBbCredit                FcBbCredit,
    fcmFLoginClassesAgreed           FcClasses,
    fcmFLoginClass2SeqDelivAgreed    TruthValue,
    fcmFLoginClass2DataFieldSize     FcDataFieldSize,
    fcmFLoginClass3SeqDelivAgreed    TruthValue,
    fcmFLoginClass3DataFieldSize     FcDataFieldSize
}

fcmFLoginNxPortIndex OBJECT-TYPE 

SYNTAX      Unsigned32 (1..4294967295)
MAX-ACCESS  not-accessible
STATUS      current
DESCRIPTION
        "An arbitrary integer that uniquely identifies an Nx_Port
        amongst all those attached to the Fx_Port indicated by
        ifIndex.

        After a value of this object is assigned to a particular
        Nx_Port, that value can be re-used when and only when it is
        assigned to the same Nx_Port, or, after a reset of the value
        of the relevant instance of ifCounterDiscontinuityTime."
REFERENCE  "The Interfaces Group MIB, RFC 2863, June 2000."
::= { fcmFLoginEntry 1 }

fcmFLoginPortWwn OBJECT-TYPE 

SYNTAX      FcNameIdOrZero
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The port name of the attached Nx_Port, or the zero-length
        string if unknown."
::= { fcmFLoginEntry 2 }

fcmFLoginNodeWwn OBJECT-TYPE 

SYNTAX      FcNameIdOrZero
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The node name of the attached Nx_Port, or the zero-length
        string if unknown."
::= { fcmFLoginEntry 3 }

fcmFLoginBbCreditModel OBJECT-TYPE 

SYNTAX      FcBbCreditModel
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The buffer-to-buffer credit model in use by the Fx_Port."
::= { fcmFLoginEntry 4 }

fcmFLoginBbCredit OBJECT-TYPE 

SYNTAX      FcBbCredit
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The number of buffers available for holding frames to be

        transmitted to the attached Nx_Port.  These buffers are for
        buffer-to-buffer flow control in the direction from Fx_Port
        to Nx_Port."
::= { fcmFLoginEntry 5 }

fcmFLoginClassesAgreed OBJECT-TYPE 

SYNTAX      FcClasses
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The Classes of Service that the Fx_Port has agreed to
        support for this Nx_Port."
::= { fcmFLoginEntry 6 }

fcmFLoginClass2SeqDelivAgreed OBJECT-TYPE 

SYNTAX      TruthValue
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "An indication of whether the Fx_Port has agreed to support
        Class 2 sequential delivery for this Nx_Port.  This is only
        meaningful if Class 2 service has been agreed upon."
::= { fcmFLoginEntry 7 }

fcmFLoginClass2DataFieldSize OBJECT-TYPE 

SYNTAX      FcDataFieldSize
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The Receive Data Field Size that the Fx_Port has agreed to
        support for Class 2 frames to/from this Nx_Port.  The size
        specifies the largest Data Field Size for an FT_1 frame.
        This is only meaningful if Class 2 service has been agreed
        upon."
::= { fcmFLoginEntry 8 }

fcmFLoginClass3SeqDelivAgreed OBJECT-TYPE 

SYNTAX      TruthValue
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "An indication of whether the Fx_Port has agreed to support
        Class 3 sequential delivery for this Nx_Port.  This is only
        meaningful if Class 3 service has been agreed upon."
::= { fcmFLoginEntry 9 }

fcmFLoginClass3DataFieldSize OBJECT-TYPE 

SYNTAX      FcDataFieldSize
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The Receive Data Field Size that the Fx_Port has agreed to
        support for Class 3 frames to/from this Nx_Port.  The size
        specifies the largest Data Field Size for an FT_1 frame.
        This is only meaningful if Class 3 service has been agreed
        upon."
::= { fcmFLoginEntry 10 }

--******************************** -- The Link table -- -- This table is intended to assist management applications -- in determining the topology of the network. The table -- contains any recent information the known to the agent -- about Fibre Channel links, not only those that terminate at -- a local port but also any others for which information -- is known.

fcmLinkTable OBJECT-TYPE 

SYNTAX      SEQUENCE OF FcmLinkEntry
MAX-ACCESS  not-accessible
STATUS      current
DESCRIPTION
        "A table containing any Fibre Channel link information that
        is known to local Fibre Channel managed instances.  One end
        of such a link is typically at a local port, but the table
        can also contain information on links for which neither end
        is a local port.

        If one end of a link terminates locally, then that end is
        termed 'end1'; the other end is termed 'end2'."
::= { fcmgmtObjects 10 }

fcmLinkEntry OBJECT-TYPE 

SYNTAX      FcmLinkEntry
MAX-ACCESS  not-accessible
STATUS      current
DESCRIPTION
        "An entry containing information that a particular Fibre
        Channel managed instance has about a Fibre Channel link.

        The two ends of the link are called 'end1' and 'end2'."
INDEX { fcmInstanceIndex, fcmLinkIndex }
::= { fcmLinkTable 1 }

FcmLinkEntry ::= SEQUENCE { 

    fcmLinkIndex               Unsigned32,
    fcmLinkEnd1NodeWwn         FcNameIdOrZero,
    fcmLinkEnd1PhysPortNumber  Unsigned32,
    fcmLinkEnd1PortWwn         FcNameIdOrZero,
    fcmLinkEnd2NodeWwn         FcNameIdOrZero,
    fcmLinkEnd2PhysPortNumber  Unsigned32,
    fcmLinkEnd2PortWwn         FcNameIdOrZero,
    fcmLinkEnd2AgentAddress    SnmpAdminString,
    fcmLinkEnd2PortType        FcPortType,
    fcmLinkEnd2UnitType        FcUnitFunctions,
    fcmLinkEnd2FcAddressId     FcAddressIdOrZero

}

fcmLinkIndex OBJECT-TYPE 

SYNTAX      Unsigned32 (1..4294967295)
MAX-ACCESS  not-accessible
STATUS      current
DESCRIPTION
        "An arbitrary integer that uniquely identifies one link
        within the set of links about which a particular managed
        instance has information."
::= { fcmLinkEntry 1 }

fcmLinkEnd1NodeWwn OBJECT-TYPE 

SYNTAX      FcNameIdOrZero
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The node name of end1, or the zero-length string if
        unknown."
::= { fcmLinkEntry 2 }

fcmLinkEnd1PhysPortNumber OBJECT-TYPE 

SYNTAX      Unsigned32
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The physical port number of end1, or zero if unknown."
REFERENCE
    "FC-GS-3, section 6.1.2.2.5"
::= { fcmLinkEntry 3 }

fcmLinkEnd1PortWwn OBJECT-TYPE 

SYNTAX      FcNameIdOrZero
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The port WWN of end1, or the zero-length string if unknown.
        ('end1' is local if this value is equal to the value of
        fcmPortWwn in one of the rows of the fcmPortTable.)"
::= { fcmLinkEntry 4 }

fcmLinkEnd2NodeWwn OBJECT-TYPE 

SYNTAX      FcNameIdOrZero
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The node name of end2, or the zero-length string if
        unknown."
::= { fcmLinkEntry 5 }

fcmLinkEnd2PhysPortNumber OBJECT-TYPE 

SYNTAX      Unsigned32
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The physical port number of end2, or zero if unknown."
REFERENCE
    "FC-GS-3, section 6.1.2.2.5"
::= { fcmLinkEntry 6 }

fcmLinkEnd2PortWwn OBJECT-TYPE 

SYNTAX      FcNameIdOrZero
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The port WWN of end2, or the zero-length string if
        unknown."
::= { fcmLinkEntry 7 }

fcmLinkEnd2AgentAddress OBJECT-TYPE 

SYNTAX      SnmpAdminString
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The address of the management agent for the Fibre Channel
        Interconnect Element or Platform of which end2 is a part.
        The GS-4 specification provides some information about
        management agents.  If the address is unknown, the value of
        this object is the zero-length string."

REFERENCE
    "FC-GS-3, section 6.1.2.1.7"
::= { fcmLinkEntry 8 }

fcmLinkEnd2PortType OBJECT-TYPE 

SYNTAX      FcPortType
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The port type of end2."
REFERENCE
    "FC-GS-3, section 6.1.2.2.2"
::= { fcmLinkEntry 9 }

fcmLinkEnd2UnitType OBJECT-TYPE 

SYNTAX      FcUnitFunctions
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The type of/function(s) performed by the Fibre Channel
        Interconnect Element or Platform of which end2 is a part."
REFERENCE
    "FC-GS-3, sections 6.1.2.1.2 and 6.1.2.3.2"
::= { fcmLinkEntry 10 }

fcmLinkEnd2FcAddressId OBJECT-TYPE 

SYNTAX      FcAddressIdOrZero
MAX-ACCESS  read-only
STATUS      current
DESCRIPTION
        "The Fibre Channel Address ID of end2, or the zero-length
        string if unknown."
::= { fcmLinkEntry 11 }

--******************************** -- Conformance Section --

fcmgmtCompliances OBJECT IDENTIFIER ::= { fcmgmtConformance 1 } fcmgmtGroups OBJECT IDENTIFIER ::= { fcmgmtConformance 2 }

fcmgmtCompliance MODULE-COMPLIANCE 

STATUS  current
DESCRIPTION
        "Describes the requirements for compliance to this Fibre
        Channel Management MIB."
MODULE  -- this module
    MANDATORY-GROUPS { fcmInstanceBasicGroup,
                       fcmPortBasicGroup,
                       fcmPortErrorsGroup }

    GROUP   fcmPortStatsGroup
    DESCRIPTION
        "This group is mandatory for all systems that
        are able to support the Counter64 date type."

    GROUP   fcmPortClass23StatsGroup
    DESCRIPTION
        "This group is mandatory only for systems that
        keep class-specific traffic statistics on Class 2
        and Class 3 traffic and are able to support the
        Counter64 date type."

    GROUP   fcmPortClassFStatsGroup
    DESCRIPTION
        "This group is mandatory only for FC switches that
        keep statistics on Class F traffic."

    GROUP   fcmPortLcStatsGroup
    DESCRIPTION
        "This group is mandatory only for agents that can not
        support the Counter64 data type and/or need to provide
        information accessible by SNMPv1 applications."

    GROUP   fcmSwitchBasicGroup
    DESCRIPTION
        "This group is mandatory only for Fibre Channel
        managed instances that manage Fibre Channel
        switches."

    GROUP   fcmSwitchPortGroup
    DESCRIPTION

        "This group is mandatory only for Fibre Channel
        managed instances that manage Fibre Channel
        switches."

    GROUP   fcmSwitchLoginGroup
    DESCRIPTION
        "This group is mandatory only for Fibre Channel
        managed instances that manage Fibre Channel
        switches."

    GROUP fcmLinkBasicGroup
    DESCRIPTION
        "This group is optional."

    OBJECT      fcmInstancePhysicalIndex
    SYNTAX      Integer32 (0)
    DESCRIPTION
        "Implementation of a non-zero value is not required."

    OBJECT      fcmInstanceSoftwareIndex
    SYNTAX      Integer32 (0)
    DESCRIPTION
        "Implementation of a non-zero value is not required."

    OBJECT      fcmInstanceTextName
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT      fcmInstanceDescr
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT      fcmPortAdminType
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT      fcmPortAdminSpeed
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT      fcmSwitchDomainId
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT      fcmISPortClassFCredit
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

::= { fcmgmtCompliances 1 }

--******************************** -- Object Groups --

fcmInstanceBasicGroup OBJECT-GROUP 

OBJECTS { fcmInstanceWwn, fcmInstanceFunctions,
          fcmInstancePhysicalIndex, fcmInstanceSoftwareIndex,
          fcmInstanceStatus, fcmInstanceTextName,
          fcmInstanceDescr, fcmInstanceFabricId }
STATUS  current
DESCRIPTION
        "Basic information about Fibre Channel managed instances."
::= { fcmgmtGroups 1 }

fcmSwitchBasicGroup OBJECT-GROUP 

OBJECTS { fcmSwitchDomainId, fcmSwitchPrincipal, fcmSwitchWWN }
STATUS  current
DESCRIPTION
        "Basic information about Fibre Channel switches."
::= { fcmgmtGroups 2 }

fcmPortBasicGroup OBJECT-GROUP 

OBJECTS { fcmPortInstanceIndex, fcmPortWwn, fcmPortNodeWwn,
          fcmPortAdminType, fcmPortOperType, fcmPortFcCapClass,
          fcmPortFcOperClass, fcmPortTransmitterType,
          fcmPortConnectorType, fcmPortSerialNumber,
          fcmPortPhysicalNumber, fcmPortAdminSpeed,
          fcmPortCapProtocols, fcmPortOperProtocols }
STATUS  current
DESCRIPTION
        "Basic information about Fibre Channel ports."
::= { fcmgmtGroups 3 }

fcmPortStatsGroup OBJECT-GROUP 

OBJECTS { fcmPortBBCreditZeros, fcmPortFullInputBuffers }
STATUS  current
DESCRIPTION
        "Traffic statistics, which are not specific to any one class
        of service, for Fibre Channel ports."
::= { fcmgmtGroups 4 }

fcmPortClass23StatsGroup OBJECT-GROUP 

OBJECTS { fcmPortClass2RxFrames, fcmPortClass2RxOctets,
          fcmPortClass2TxFrames, fcmPortClass2TxOctets,
          fcmPortClass2Discards, fcmPortClass2RxFbsyFrames,
          fcmPortClass2RxPbsyFrames,
          fcmPortClass2RxFrjtFrames,
          fcmPortClass2RxPrjtFrames,
          fcmPortClass2TxFbsyFrames,
          fcmPortClass2TxPbsyFrames,
          fcmPortClass2TxFrjtFrames,
          fcmPortClass2TxPrjtFrames, fcmPortClass3RxFrames,
          fcmPortClass3RxOctets, fcmPortClass3TxFrames,
          fcmPortClass3TxOctets, fcmPortClass3Discards }
STATUS  current
DESCRIPTION
        "Traffic statistics for Class 2 and Class 3 traffic on Fibre
        Channel ports."
::= { fcmgmtGroups 5 }

fcmPortClassFStatsGroup OBJECT-GROUP 

OBJECTS { fcmPortClassFRxFrames,
          fcmPortClassFRxOctets,
          fcmPortClassFTxFrames,
          fcmPortClassFTxOctets,
          fcmPortClassFDiscards }
STATUS  current
DESCRIPTION
        "Traffic statistics for Class F traffic on Fibre Channel
        ports."
::= { fcmgmtGroups 6 }

fcmPortLcStatsGroup OBJECT-GROUP 

OBJECTS { fcmPortLcBBCreditZeros, fcmPortLcFullInputBuffers,
          fcmPortLcClass2RxFrames, fcmPortLcClass2RxOctets,
          fcmPortLcClass2TxFrames, fcmPortLcClass2TxOctets,
          fcmPortLcClass2Discards, fcmPortLcClass3Discards,
          fcmPortLcClass3RxFrames, fcmPortLcClass3RxOctets,
          fcmPortLcClass3TxFrames, fcmPortLcClass3TxOctets,
          fcmPortLcClass2RxFbsyFrames,
          fcmPortLcClass2RxPbsyFrames,
          fcmPortLcClass2RxFrjtFrames,
          fcmPortLcClass2RxPrjtFrames,
          fcmPortLcClass2TxFbsyFrames,
          fcmPortLcClass2TxPbsyFrames,
          fcmPortLcClass2TxFrjtFrames,
          fcmPortLcClass2TxPrjtFrames }
STATUS  current
DESCRIPTION

        "Low-capacity (32-bit) statistics for Fibre Channel ports."
::= { fcmgmtGroups 7 }

fcmPortErrorsGroup OBJECT-GROUP 

OBJECTS { fcmPortRxLinkResets, fcmPortTxLinkResets,
          fcmPortLinkResets, fcmPortRxOfflineSequences,
          fcmPortTxOfflineSequences, fcmPortLinkFailures,
          fcmPortLossofSynchs, fcmPortLossofSignals,
          fcmPortPrimSeqProtocolErrors, fcmPortInvalidTxWords,
          fcmPortInvalidCRCs, fcmPortInvalidOrderedSets,
          fcmPortFrameTooLongs, fcmPortTruncatedFrames,
          fcmPortAddressErrors, fcmPortDelimiterErrors,
          fcmPortEncodingDisparityErrors,
          fcmPortOtherErrors }
STATUS  current
DESCRIPTION
        "Error statistics for Fibre Channel ports."
::= { fcmgmtGroups 8 }

fcmSwitchPortGroup OBJECT-GROUP 

OBJECTS { fcmFxPortRatov, fcmFxPortEdtov, fcmFxPortRttov,
          fcmFxPortHoldTime, fcmFxPortCapBbCreditMax,
          fcmFxPortCapBbCreditMin,
          fcmFxPortCapDataFieldSizeMax,
          fcmFxPortCapDataFieldSizeMin,
          fcmFxPortCapClass2SeqDeliv,
          fcmFxPortCapClass3SeqDeliv,
          fcmFxPortCapHoldTimeMax,
          fcmFxPortCapHoldTimeMin,
          fcmISPortClassFCredit,
          fcmISPortClassFDataFieldSize }
STATUS  current
DESCRIPTION
        "Information about ports on a Fibre Channel switch."
::= { fcmgmtGroups 9 }

fcmSwitchLoginGroup OBJECT-GROUP 

OBJECTS { fcmFLoginPortWwn, fcmFLoginNodeWwn,
          fcmFLoginBbCreditModel, fcmFLoginBbCredit,
          fcmFLoginClassesAgreed,
          fcmFLoginClass2SeqDelivAgreed,
          fcmFLoginClass2DataFieldSize,
          fcmFLoginClass3SeqDelivAgreed,
          fcmFLoginClass3DataFieldSize }
STATUS  current
DESCRIPTION
        "Information known to a Fibre Channel switch about
        attached/logged-in Nx_Ports."

::= { fcmgmtGroups 10 }

fcmLinkBasicGroup OBJECT-GROUP 

OBJECTS { fcmLinkEnd1NodeWwn , fcmLinkEnd1PhysPortNumber,
          fcmLinkEnd1PortWwn, fcmLinkEnd2NodeWwn ,
          fcmLinkEnd2PhysPortNumber, fcmLinkEnd2PortWwn,
          fcmLinkEnd2AgentAddress, fcmLinkEnd2PortType,
          fcmLinkEnd2UnitType, fcmLinkEnd2FcAddressId }
STATUS  current
DESCRIPTION
        "Information about Fibre Channel links."
::= { fcmgmtGroups 11 }

END

Acknowledgements

This memo is partly based on the information contained in the original submission of the Fibre Channel Management Integration MIB to the IETF's IPFC Working Group (now available as [MIB-FA]) and obsoletes RFC 2837.

Feedback has been incorporated into this document based on comments from the following: Sudhir Pendse, SimpleSoft; Steve Senum, Cisco Systems; and Kha Sin Teow, Brocade.

Normative References

[RFC2434] Narten, T. and H. Alvestrand, "Guidelines for Writing an 

         IANA Considerations Section in RFCs", BCP 26, RFC 2434,
         October 1998.

[RFC2578] McCloghrie, K., Perkins, D., and J. Schoenwaelder, 

         "Structure of Management Information Version 2 (SMIv2)",
         STD 58, RFC 2578, April 1999.

[RFC2579] McCloghrie, K., Perkins, D., and J. Schoenwaelder, "Textual 

         Conventions for SMIv2", STD 58, RFC 2579, April 1999.

[RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder, 

         "Conformance Statements for SMIv2", STD 58, RFC 2580, April
         1999.

[RFC2737] McCloghrie, K. and A. Bierman, "Entity MIB (Version 2)", 

         RFC 2737, December 1999.

[RFC2790] Waldbusser, S. and P. Grillo, "Host Resources MIB", RFC 

         2790, March 2000.

[RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group 

         MIB", RFC 2863, June 2000.

[RFC3411] Harrington, D., Presuhn, R., and B. Wijnen, "An 

         Architecture for Describing Simple Network Management
         Protocol (SNMP) Management Frameworks", STD 62, RFC 3411,
         December 2002.

[FC-AL-2] "Fibre Channel - Arbitrated Loop (FC-AL-2)", ANSI INCITS 

         332-1999, 1999.

[FC-BB] "Fibre Channel - Backbone (FC-BB)" ANSI INCITS 342-2001, 

         2001.

[FC-FS] "Fibre Channel - Framing and Signaling (FC-FS)" ANSI INCITS 

         373-2003, April 2003.

[FC-GS-3] "Fibre Channel - Generic Services - 3 (FC-GS-3)" ANSI 

         INCITS 348-2001, 2001.

[FC-MI] "Fibre Channel - Methodologies for Interconnects Technical 

         Report (FC-MI)" INCITS TR-30-2002, 2002.

[FC-PH] "Information Technology - Fibre Channel Physical and 

         Signaling Interface (FC-PH)", ANSI X3.230, 1994.

[FC-SW-3] "Fibre Channel - Switch Fabric - 3 (FC-SW-3)", ANSI INCITS 

         384-2004, June 2004.

Informative References

[RFC2741] Daniele, M., Wijnen, B., Ellison, M., and D. Francisco, 

         "Agent Extensibility (AgentX) Protocol Version 1", RFC
         2741, January 2000.

[RFC2837] Teow, K., "Definitions of Managed Objects for the Fabric 

         Element in Fibre Channel Standard", RFC 2837, May 2000.

[RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, 

         "Introduction and Applicability Statements for Internet-
         Standard Management Framework", RFC 3410, December 2002.

[RFC3433] Bierman, A., Romascanu, D., and K.C. Norseth, "Entity 

         Sensor Management Information Base", RFC 3433, December
         2002.

[MIB-FA] "INCITS Technical Report for Information Technology - Fibre 

         Channel - Management Information Base - FA (MIB-FA)",
         INCITS, TR-32-2003.

[WWN1] Snively, R., "New identifier formats based on IEEE 

         registration", http://standards.ieee.org/regauth/oui/
         tutorials/fibreformat.html, 16 January 2001.

[WWN2] Snively, R., "Use of the IEEE Registration Authority 

         assigned 'company_id' with the ANSI X3.230 FC-PH Fibre
         Channel specification and its extensions",
         http://standards.ieee.org/regauth/oui/tutorials/
         fibrecomp_id.html, 24 February 1997.

10. Security Considerations

There are a number of management objects defined in this MIB that have a MAX-ACCESS clause of read-write: 

  fcmInstanceTextName
  fcmInstanceDescr
  fcmSwitchDomainId
  fcmPortAdminType
  fcmPortAdminSpeed
  fcmISPortClassFCredit

Such objects may be considered sensitive or vulnerable in some network environments. For example, the ability to change network topology or network speed may afford an attacker the ability to obtain better performance at the expense of other network users; setting fcmSwitchDomainId to an invalid value could lead to denial of service in some configurations. The support for SET operations in a non-secure environment without proper protection can have a negative effect on network operations.

Some of the readable objects in this MIB module (i.e., objects with a MAX-ACCESS other than not-accessible) may be considered sensitive or vulnerable in some network environments. It is thus important to control even GET and/or NOTIFY access to these objects and possibly to even encrypt the values of these objects when sending them over the network via SNMP. In particular, these objects provide information on network topology: 

  fcmLinkEnd1NodeWwn
  fcmLinkEnd1PhysPortNumber
  fcmLinkEnd1PortWwn
  fcmLinkEnd2NodeWwn
  fcmLinkEnd2PhysPortNumber

  fcmLinkEnd2PortWwn
  fcmLinkEnd2AgentAddress
  fcmLinkEnd2PortType
  fcmLinkEnd2UnitType
  fcmLinkEnd2FcAddressId

SNMP versions prior to SNMPv3 did not include adequate security. Even if the network itself is secure (for example by using IPSec), even then, there is no control as to who on the secure network is allowed to access and GET/SET (read/change/create/delete) the objects in this MIB module.

It is RECOMMENDED that implementors consider the security features as provided by the SNMPv3 framework (see [RFC3410], section 8), including full support for the SNMPv3 cryptographic mechanisms (for authentication and privacy).

Further, deployment of SNMP versions prior to SNMPv3 is NOT RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to enable cryptographic security. It is then a customer/operator responsibility to ensure that the SNMP entity giving access to an instance of this MIB module is properly configured to give access to the objects only to those principals (users) that have legitimate rights to indeed GET or SET (change/create/delete) them.

11. IANA Considerations

11.1. OID Assignment

IANA has made a MIB OID assignment under the transmission branch. Specifically, transmission 56 has been assigned as the OID for fcMgmtMIB. This sub-identifier was requested because this MIB contains the media-specific definitions that correspond to the ifType value of fibreChannel(56).

11.2. FC Port Type Registry

IANA has established a registry for Fibre Channel Port Types. The registry is split into disjointed subset ranges:

1) a 'standard' range for Fibre Channel Port Types that have been 

  standardized by the InterNational Committee for Information
  Technology Standards (INCITS)'s Technical Committee T11.  This
  range will be subject to the 'Expert Review' and 'Specification
  Required' policies described in [RFC2434], with the following
  provisions:

  -  the Expert Reviewer is to be appointed by the IESG.

  -  the Expert Reviewer shall obtain approval (or rejection) from
     INCITS Technical Committee T11 via the chair of that Committee.
     Rejected values shall not be added to the registry.

  -  if the addition is approved, the Expert shall advise IANA of
     how to record the reference to the T11 specification document
     that describes the newly added port type(s), and that is
     considered to be the "other permanent and readily available
     reference" required by [RFC2434].

The initial assignments in the 'standard' range will be as follows: 

  Assigned
   Value     Type      Meaning
  --------   ------    -------
     1       unknown   for use when the type is not known,
                       or is "unidentified" as specified in
                       section 5.1.2.10 of [FC-GS-3]
     2       other     used for types without assigned values
     3       --        an obsolete value, not to be re-assigned
     4       N_Port     see [FC-FS]
     5       NL_Port    see [FC-FS]
     6       F_Port     see [FC-FS]
     7       FL_Port    see [FC-FS]
     8       E_Port     see [FC-FS]
     9       B_Port     see [FC-FS]
    10       G_Port     see [FC-SW-3]
    11       GL_Port    see [FC-SW-3]
    12       F/NL_Port  see [FC-AL-2]

The above range extends up to a maximum of 9,999.

2) a range assigned under the "Private Use" policy described in 

  [RFC2434] for values intended for private use by one party or
  among mutually consenting parties.
  Values in this range extend from 10,000 to 99,999.  IANA will not
  make any allocations from this range.

3) values larger than 99,999 are RESERVED.

12. Comparison to the Fibre Channel Management Integration MIB

12.1. Problems with the Fibre Channel Management Integration MIB

The Fibre Channel Management Integration MIB [MIB-FA] had the following major problems:

- It wasn't formatted using SMIv2, which is mandatory.

- The MIB seemed to have been defined with the notion that it would 

  be the only MIB that a Fibre Channel product will require.  The
  notion of an agent implementing just a single MIB was abandoned by
  the IETF in 1992 as being non-scalable.  Rather, a Fibre Channel
  MIB needed to be another MIB in the continuing series of MIBs
  defined by the IETF, and thus, it needed to be consistent with its
  predecessors.  In other words, there are existing MIBs that all
  SNMP agents must support, even if the support of Fibre Channel
  interfaces is the only functionality that they have.  Thus, it was
  essential that the Fibre Channel Integration MIB contained only
  objects for information that is specific to Fibre Channel.  All
  objects relevant to non-Fibre Channel environments needed to be
  removed.  This issue applied to a large fraction of the objects
  defined in the MIB.

- The MIB had some but not complete overlap in functionality with 

  RFC 2837.

- Every SNMP agent must implement the ifTable. The ifTable counters 

  are the MIB objects most well-used by administrators in SNMP
  management.  SNMP agents need to implement a row in the ifTable
  for each of their network interfaces, including their Fibre
  Channel interfaces.  The IF-MIB requires a media-specific MIB to
  specify how that type of interface uses the ifTable (see section 4
  in RFC 2863).  [RFC2837] doesn't do that, nor did the Fibre
  Channel Integration MIB.

- It incorrectly used the OCTET STRING syntax (instead of Counter32 

  or Counter64) for counters.

12.2. Detailed Changes

12.2.1. Removal of Sensor-Related Objects

Information about sensors is not specific to Fibre Channel, and therefore should not be in this MIB. (At the time of writing, the IETF's ENTITY MIB Working Group has produced a first draft of a Sensor MIB, see [RFC3433].) This removed the need for: 

  connUnitSensorTable (and all its contents)
  connUnitNumSensors
  connUnitSensorStatusChange

12.2.2. Removal of Trap-registration Objects

Information about registering "traps" is not specific to Fibre Channel, and therefore should not be in this MIB. (For similar functionality, see SNMP-NOTIFICATION-MIB and SNMP-TARGET-MIB in RFC 2573). This removed the need for: 

  trapMaxClients
  trapClientCount
  trapRegTable (and all its contents)

12.2.3. Removal of Event-Related Objects

Information about generic events is not specific to Fibre Channel, and therefore should not be in this MIB. (For similar functionality, see the Event group in RFC 2819 and the Notification Log MIB in RFC 3014; the SNMP-NOTIFICATION-MIB provides for the filtering of notifications.) This removed the need for: 

  connUnitEventTable (and all its contents)
  connUnitEventFilter
  connUnitNumEvents
  connUnitMaxEvents
  connUnitEventCurrID
  connUnitEventTrap

12.2.4. Removal of Inventory-Related Information

Aspects of hardware (physical) components are represented in the Entity MIB (RFC 2737); aspects of software modules are represented in the Host Resources MIB (RFC 2790). Two new objects provide indexing from this MIB into those MIBs: one having the value of PhysicalIndex (or zero) and the other having the value of hrSWInstalledIndex (or zero). These replaced the need for: 

  connUnitNumports
  connUnitRevsTable (and all its contents)
  connUnitNumRevs
  connUnitPortRevision
  connUnitPortVendor
  connUnitProduct
  connUnitInfo
  connUnitSn
  connUnitModuleId

  connUnitVendorId
  connUnitDeletedTrap

12.2.5. Removal of Revision Numbers

The forward/backward compatibility rules of how to evolve MIBs are designed such that MIBs do not have revision numbers. This removed the need for: 

  revisionNumber

12.2.6. Removal of Other Not FC-Specific Information

Other information was removed because it was not specific to Fibre Channel: 

  systemURL
  statusChangeTime
  configurationChangeTime
  connUnitUrl
  connUnitUpTime
  connUnitState
  connUnitContact
  connUnitLocation
  connUnitProxyMaster
  connUnitControl
  connUnitStatus
  connUnitStatusChange

12.2.7. Clean-up of Ambiguous/Obsolete Definitions

Some information in the FC Management integration was obsolete or ambiguous: 

  statusChangeTime (obsolete)
  configurationChangeTime (obsolete)
  connUnitTableChangeTime (obsolete)
  connUnitStatusChangeTime (obsolete)
  connUnitConfigurationChangeTime (obsolete)
  connUnitNumZones (obsolete)
  connUnitZoneTable (referenced but not defined)
  connUnitLinkCurrIndex (badly defined)

12.2.8. Use of an ifTable Entry

The following objects were removed because they duplicated existing IF-MIB objects: 

  redundant object                   existing object(s)
  ----------------                   ------------------
  connUnitPortStatCountError         ifInErrors & ifOutErrors
  connUnitPortStatCountTxObjects     ifOutUcastPkts &
                                     ifHCOutUcastPkts
  connUnitPortStatCountRxObjects     ifInUcastPkts &
                                     ifHCInUcastPkts
  connUnitPortStatCountTxElements    ifOutOctets &
                                     ifHCOutOctets
  connUnitPortStatCountRxElements    ifInOctets &
                                     ifHCInOctets
  connUnitPortStatCountRxMulticastObjects
                                     ifInMulticastPkts &
                                     ifHCInMulticastPkts
  connUnitPortStatCountTxMulticastObjects
                                     ifOutMulticastPkts &
                                     ifHCOutMulticastPkts
  connUnitPortStatCountRxBroadcastObjects
                                     ifInBroadcastPkts &
                                     ifHCInBroadcastPkts
  connUnitPortStatCountTxBroadcastObjects
                                     ifOutBroadcastPkts &
                                     ifHCOutBroadcastPkts
  connUnitPortFCId                   ifPhysAddress
  connUnitPortControl                ifAdminStatus
  connUnitPortState                  ifAdminStatus
  connUnitPortHWState                ifOperStatus
  connUnitPortStatus                 ifOperStatus
  connUnitPortName                   ifAlias
  connUnitPortStatObject             ifSpecific
  connUnitNumports                   ifNumber
  connUnitPortStatusChange           linkUp/linkDown

12.2.9. Removed Because of AgentX Difficulty

An AgentX environment [RFC2741] consists of a master agent and several sub-agents. It is not difficult to implement the same MIB in several such sub-agents if all of the MIB's tables have a common index variable as the first auxiliary object in their INDEX clauses. However, any scalars that the MIB contains pose a problem for the AgentX environment. All the (remaining) scalars were therefore removed: 

  revisionNumber
  uNumber
  systemURL

12.2.10. FC Management Instance

The term "connectivity unit" was changed to "FC management instance".

The term "connectivity unit" was not properly defined in [MIB-FA], and its usage provided a confused mixture of indications to the implementor: 

  -  the definition of FcUnitType suggested it was functional;

  -  the definition of uNumber suggested it was physical;

  -  the definition of connUnitProduct suggested it was a vendor's
     product;

  -  etc.

The common implementation strategy for the "connectivity unit" was which ever grouping provided access to the management functionality the easiest. (One such grouping accommodates a single SNMP agent having multiple AgentX [RFC2741] sub-agents, each supporting a separate implementation of the MIB.)

In fact, this scenario is not new; in practice, a "connectivity unit" will have the same semantics as a management "instance" in other MIBs, e.g., the IPS WG's own iSCSI MIB. For this MIB, its meaning is: "a separable managed instance of Fibre Channel functionality". Given this definition, the "FC management instance" is a better name because it is more accurate and more representative of the definition than is "connectivity unit".

12.2.11. Counter Syntax

All packet and octet counters have been changed to be Counter64's (but Counter32 versions of them are also included for use by old agents). The error counters have been changed to Counter32's. (In the probably impossible, and at most improbable, circumstances that the rate of occurrence of errors, even on a 10Gbs Fibre Channel interface, might wrap faster than an hour, the fact that errors are occurring will almost certainly be apparent from other MIB objects.)

12.2.12. Obsolete/Little-Used Fibre Channel Features

Information relating to Fibre Channel features that are obsolete or not widely-implemented has been deleted. (For more information, see section 6.2.1 and section 6.2.2 of [FC-MI].) 

  -  Class 1 service,
  -  Intermix Mode,
  -  Stacked Conn Mode.
  -  PH version numbers

Note that with support for Class 1 service being deleted, only class 2 now needs F_BSY, F_RJT, P_BSY, and P_RJT counters, and thus they no longer need to be counted for all classes as well as for class 2, and therefore the following objects have been deleted: 

  connUnitPortStatCountFBSYFrames
  connUnitPortStatCountPBSYFrames
  connUnitPortStatCountFRJTFrames
  connUnitPortStatCountPRJTFrames

12.3. Name Server Objects

A table of Name Server information was present in the Fibre Channel Management Integration MIB [MIB-FA]. That information is not currently represented in this MIB because this MIB is already quite large, and a set of Name Server objects are expected to be defined in a separate (new) MIB.

12.4. Additional Objects

Support for Class F traffic, including 32-bit octet and frame counters, has been added.

13. Comparison to RFC 2837

This MIB is a superset of RFC 2837, except for the following:

- the fcFeClass1AccountingGroup group is obsolete,

- fcFxPortConnectedNxPort, fcFxPortFcphVersionHigh, 

  fcFxPortFcphVersionLow, fcFxPortFcphVersionAgreed,
  fcFxPortStackedConnModeAgreed, fcFxPortIntermixSuppAgreed,
  fcFxPortCapStackedConnMode, and fcFxPortCapIntermix are obsolete,

- fcFxPortBbCredit and fcFxPortRxBufSize are per attached Nx_Port,

- fcFxPortBbCreditAvailable is ephemeral,

- fcFeModuleTable is mostly contained in the entPhysicalTable,

- fcFxPortPhysAdminStatus, fcFxPortPhysOperStatus, and 

  fcFxPortPhysLastChange have equivalents in the ifTable.

Author's Address

Keith McCloghrie Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA USA 95134

Phone: +1 408-526-5260 EMail: [email protected]

Full Copyright Statement

Copyright (C) The Internet Society (2005).

This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights.

This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Intellectual Property

The IETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79.

Copies of IPR disclosures made to the IETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr.

The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf- [email protected].

Acknowledgement

Funding for the RFC Editor function is currently provided by the Internet Society.

Retrieved from "https://rfc-wiki.org/index.php?title=RFC4044&oldid=10410"