home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 10 Tools
/
10-Tools.zip
/
iscsiprj.zip
/
draft-ietf-ips-fcmgmt-mib-01.txt
< prev
next >
Wrap
Text File
|
2002-06-02
|
128KB
|
4,418 lines
Internet Draft Keith McCloghrie
Cisco Systems
28 February 2002
Fibre Channel Management MIB
draft-ietf-ips-fcmgmt-mib-01.txt
Status of this Memo
This document is an Internet-Draft and is in full conformance with all
provisions of Section 10 of RFC2026 [RFC2026].
Internet-Drafts are working documents of the Internet Engineering Task
Force (IETF), its areas, and its working groups. Note that other groups
may also distribute working documents as Internet-Drafts.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet- Drafts as reference material
or to cite them other than as "work in progress".
The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html.
Distribution of this document is unlimited. Please send comments to
author.
Copyright Notice
Copyright (C) The Internet Society (2002). All Rights Reserved.
Expires August 2002 [Page 1]
Internet Draft Fibre Channel Management MIB February 2002
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 informantion related
to Fibre Channel.
Table of Contents
1 The SNMP Network Management Framework ........................... 3
2 Change Log ...................................................... 4
3 Short Overview of Fibre Channel ................................. 4
4 MIB Overview .................................................... 5
5 Relationship to Other MIBs ...................................... 7
5.1 The Interfaces Group MIB ...................................... 7
5.2 Entity MIB .................................................... 10
5.3 Host Resources MIB ............................................ 11
6 Definitions ..................................................... 12
7 Intellectual Property ........................................... 61
8 Acknowledgements ................................................ 61
9 References ...................................................... 61
10 Security Considerations ........................................ 65
11 Comparison to draft-ietf-ipfc-fcmgmt-int-mib-07.txt ............ 67
11.1 Problems with draft-ietf-ipfc-fcmgmt-int-mib-07.txt .......... 67
11.2 Detailed Changes ............................................. 68
11.2.1 Removal of Sensor-related objects .......................... 68
11.2.2 Removal of Trap-registration objects ....................... 68
11.2.3 Removal of Event-related objects ........................... 68
11.2.4 Removal of inventory-related information ................... 69
11.2.5 Removal of revision numbers ................................ 69
11.2.6 Removal of other not FC-specific information ............... 69
11.2.7 Clean-up of ambiguous/obsolete definitions ................. 70
11.2.8 Use of an ifTable entry .................................... 70
11.2.9 Removed because of AgentX difficulty ....................... 71
11.2.10 FC Management Instance .................................... 71
11.2.11 Counter Syntax ............................................ 72
11.2.12 Obsolete/Little-Used Fibre Channel features ............... 72
11.3 Name Server objects .......................................... 72
11.4 Additional objects ........................................... 73
12 Comparison to RFC 2837 ......................................... 74
13 Author's Address ............................................... 75
14 Full Copyright Statement ....................................... 75
Expires August 2002 [Page 2]
Internet Draft Fibre Channel Management MIB February 2002
1. The SNMP Network Management Framework
The SNMP Management Framework presently consists of five major
components:
o An overall architecture, described in RFC 2571 [RFC2571].
o Mechanisms for describing and naming objects and events for the
purpose of management. The first version of this Structure of
Management Information (SMI) is called SMIv1 and described in
RFC 1155 [RFC1155], RFC 1212 [RFC1212] and RFC 1215 [RFC1215].
The second version, called SMIv2, is described in RFC 2578
[RFC2578], RFC 2579 [RFC2579] and RFC 2580 [RFC2580].
o Message protocols for transferring management information. The
first version of the SNMP message protocol is called SNMPv1 and
described in RFC 1157 [RFC1157]. A second version of the SNMP
message protocol, which is not an Internet standards track
protocol, is called SNMPv2c and described in RFC 1901 [RFC1901]
and RFC 1906 [RFC1906]. The third version of the message
protocol is called SNMPv3 and described in RFC 1906 [RFC1906],
RFC 2572 [RFC2572] and RFC 2574 [RFC2574].
o Protocol operations for accessing management information. The
first set of protocol operations and associated PDU formats is
described in RFC 1157 [RFC1157]. A second set of protocol
operations and associated PDU formats is described in RFC 1905
[RFC1905].
o A set of fundamental applications described in RFC 2573
[RFC2573] and the view-based access control mechanism described
in RFC 2575 [RFC2575].
A more detailed introduction to the current SNMP Management Framework
can be found in RFC 2570 [RFC2570].
Managed objects are accessed via a virtual information store, termed
the Management Information Base or MIB. Objects in the MIB are
defined using the mechanisms defined in the SMI.
This memo specifies a MIB module that is compliant to the SMIv2. A
MIB conforming to the SMIv1 can be produced through the appropriate
translations. The resulting translated MIB must be semantically
equivalent, except where objects or events are omitted because no
translation is possible (use of Counter64). Some machine readable
Expires August 2002 [Page 3]
Internet Draft Fibre Channel Management MIB February 2002
information in SMIv2 will be converted into textual descriptions in
SMIv1 during the translation process. However, this loss of machine
readable information is not considered to change the semantics of the
MIB.
2. Change Log
This section to be deleted before publication as an RFC.
2.1. Initial version: draft-ietf-ips-fcmgmt-mib-00.txt
Initial version derived from draft-ietf-ipfc-fcmgmt-int-mib-07.txt and
RFC 2837, and published on 22 January 2002.
2.2. Changes made in draft-ietf-ips-fcmgmt-mib-01.txt
- support added for Class F traffic.
- the description of Class 1 changed to "not widely-implemented"
(instead of "obsolete"), and a reference to FC-MI added.
- Counter32 objects added in order to support old SNMPv1-only systems
which cannot support standard Counter64 objects.
3. Short Overview of 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, 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 is
used to refer to either an N_Port or an NL_port. The term Fx_Port is
used to refer to either an F_Port or an FL_port. A switch port, which
Expires August 2002 [Page 4]
Internet Draft Fibre Channel Management MIB February 2002
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 addresses identifers which identify the frame's source and
destination ports.
4. 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.
This MIB contains eleven MIB groups, as follows.
4.1. 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.
4.2. 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.
4.3. 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.
Expires August 2002 [Page 5]
Internet Draft Fibre Channel Management MIB February 2002
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.
4.4. The fcmPortStatsGroup group
This group contains traffic statistics, which are not specific to any
particular class of service, for Fibre Channel ports.
4.5. The fcmPortClass23StatsGroup group
This group contains traffic statistics which 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.
4.6. 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.
4.7. The fcmPortClassFStatsGroup group
This group contains traffic statistics which are specific to Class F
traffic on the E_Ports of a Fibre Channel switch.
4.8. The fcmPortErrorsGroup group
This group contains counters of various error conditions which can occur
on Fibre Channel ports."
4.9. 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 size, and support for
class 2 and class 3 sequenced delivery. For an E_Port, it includes the
buffer-to-buffer credit allocation and data field size.
Expires August 2002 [Page 6]
Internet Draft Fibre Channel Management MIB February 2002
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 which have
been agreed with them.
4.11. The fcmLinkBasicGroup group
This group contains information, known to a local Fibre Channel
management instance, about Fibre Channel links, including links which
terminate locally.
5. 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 as draft-ietf-ipfc-
fcmgmt-int-mib-0n.txt.
5.1. 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.
5.1.1. 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.
Expires August 2002 [Page 7]
Internet Draft Fibre Channel Management MIB February 2002
5.1.2. Virtual Circuits
This Fibre Channel MIB does not deal with virtual circuits.
5.1.3. ifRcvAddressTable
The ifRcvAddressTable does not apply to Fibre Channel interfaces.
5.1.4. ifType
The value of ifType for a Fibre Channel interface is 56.
5.1.5. 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).
5.1.6. 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 to an operational speed,
this object SHOULD reflect the maximum
speed supported by the interface.
Expires August 2002 [Page 8]
Internet Draft Fibre Channel Management MIB February 2002
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
which 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.
Expires August 2002 [Page 9]
Internet Draft Fibre Channel Management MIB February 2002
ifOutErrors This is the number of errors in
fcmPortOtherErrors which 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
to 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'.
5.2. Entity MIB
The Entity MIB [RFC2737] contains information about individual physical
components and any hierarchical relationship which 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 to 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.)
Expires August 2002 [Page 10]
Internet Draft Fibre Channel Management MIB February 2002
5.3. 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 has a row in the Host Resources
MIB), then the value of fcmInstanceSoftwareIndex is zero. (Note that an
implementation is not required to support a non-zero value of
fcmInstanceSoftwareIndex.)
Expires August 2002 [Page 11]
Internet Draft Fibre Channel Management MIB February 2002
6. Definitions
FC-MGMT-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE,
Integer32, Unsigned32, Counter32, Counter64, experimental
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 "200202280000Z"
ORGANIZATION "IETF IPS (IP-Storage) Working Group"
CONTACT-INFO
" Keith McCloghrie
Cisco Systems, Inc.
Tel: +1 408 526-5260
E-mail: kzm@cisco.com
Postal: 170 West Tasman Drive
San Jose, CA USA 95134
"
DESCRIPTION
"This module defines management information specific to
Fibre Channel-attached devices."
REVISION "200202280000Z"
DESCRIPTION
"Initial version of the Fibre Channel Management MIB
module."
::= { experimental 999999 } -- unassigned
fcmgmtObjects OBJECT IDENTIFIER ::= { fcMgmtMIB 1 }
fcmgmtNotifications OBJECT IDENTIFIER ::= { fcMgmtMIB 2 }
fcmgmtNotifPrefix OBJECT IDENTIFIER ::= { fcmgmtNotifications 0 }
fcmgmtConformance OBJECT IDENTIFIER ::= { fcMgmtMIB 3 }
Expires August 2002 [Page 12]
Internet Draft Fibre Channel Management MIB February 2002
--********************************
-- 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
where the WWN is unassigned/unknown."
SYNTAX OCTET STRING (SIZE(0 | 8 | 16))
FcAddressId ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"A Fibre Channel Address ID, a 24-bit value unique within
the address space of a Fabric."
SYNTAX OCTET STRING (SIZE(0 | 3))
DomainIdOrZero ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"The Domain Id (of a FC switch), or zero if the no Domain Id
has been assigned."
SYNTAX INTEGER(0..239)
FcPortType ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"The type of a Fibre Channel port."
SYNTAX INTEGER {
unknown(1),
other(2), -- none of the below
dynamic(3), -- determined dynamically
nPort(4),
nlPort(5),
fPort(6),
flPort(7),
ePort(8),
bPort(9)
}
Expires August 2002 [Page 13]
Internet Draft Fibre Channel Management MIB February 2002
FcClasses ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"A set of Fibre Channel classes of service."
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."
SYNTAX BITS {
other(0), -- none of the following
hub(1), -- passive unit supporting FC-FLA
switch(2), -- active element supporting FC-SW
bridge(3), -- encapsulates FC frames within
-- another protocol, e.g., FC-BB
gateway(4), -- translates FC into another
-- protocol, e.g., FC <-> iSCSI
host(5), -- host computer interface
storageSubsys(6), -- raid, library, etc
storageAccessDev(7), -- access to managed storage
nas(8) -- network attached storage
}
Expires August 2002 [Page 14]
Internet Draft Fibre Channel Management MIB February 2002
PhysicalIndexOrZero ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"The index value for a physical entity's row in the Entity
MIB's entPhysicalTable. A zero value indicates that no row
in the entPhysicalTable is applicable."
REFERENCE
"entPhysicalTable is defined in the Entity MIB, RFC 2737."
SYNTAX INTEGER (0..2147483647)
HrSWInstalledIndexOrZero ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"The index value for a software module's row in the Host
Resources MIB's hrSWInstalledTable. A zero value indicates
that no row in the hrSWInstalledTable is applicable."
REFERENCE
"hrSWInstalledTable is defined in the Host Resources MIB,
RFC 2790."
SYNTAX Integer32 (0..2147483647)
MilliSeconds ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"Time units in milliseconds."
SYNTAX Unsigned32
MicroSeconds ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"Time units in microseconds."
SYNTAX Unsigned32
Expires August 2002 [Page 15]
Internet Draft Fibre Channel Management MIB February 2002
--********************************
-- 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 PhysicalIndexOrZero,
fcmInstanceSoftwareIndex HrSWInstalledIndexOrZero,
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 which uniquely identifies this
instance amongst all local Fibre Channel management
instances.
Expires August 2002 [Page 16]
Internet Draft Fibre Channel Management MIB February 2002
It is mandatory that this value remain constant between
restarts of the agent. It is desirable that this value
remain constant across restarts. However, it is unrealistic
to think that it can remain constant across all re-
configurations of the local system and across all
replacements of 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 PhysicalIndexOrZero
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"If this management instance corresponds to a physical
component (or to a hierarchy of physical components), 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 which has an entPhysicalIndex
value), then the value of this object is zero."
REFERENCE
"entPhysicalIndex is defined in the Entity MIB, RFC 2737."
::= { fcmInstanceEntry 4 }
Expires August 2002 [Page 17]
Internet Draft Fibre Channel Management MIB February 2002
fcmInstanceSoftwareIndex OBJECT-TYPE
SYNTAX HrSWInstalledIndexOrZero
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"If this management instance corresponds to an installed
software module, 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
which 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
Expires August 2002 [Page 18]
Internet Draft Fibre Channel Management MIB February 2002
"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 which 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)."
::= { 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 which
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 which
is managed by the management instance given by
fcmInstanceIndex."
INDEX { fcmInstanceIndex, fcmSwitchIndex }
::= { fcmSwitchTable 1 }
Expires August 2002 [Page 19]
Internet Draft Fibre Channel Management MIB February 2002
FcmSwitchEntry ::=
SEQUENCE {
fcmSwitchIndex Unsigned32,
fcmSwitchDomainId DomainIdOrZero,
fcmSwitchPrincipal TruthValue
}
fcmSwitchIndex OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An arbitrary integer which uniquely identifies a Fibre
Channel switch amongst those managed by one Fibre Channel
management instance."
::= { fcmSwitchEntry 1 }
fcmSwitchDomainId OBJECT-TYPE
SYNTAX DomainIdOrZero
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 }
--********************************
-- The Fibre Channel Port Table
--
fcmPortTable OBJECT-TYPE
SYNTAX SEQUENCE OF FcmPortEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
Expires August 2002 [Page 20]
Internet Draft Fibre Channel Management MIB February 2002
"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 for 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
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
Expires August 2002 [Page 21]
Internet Draft Fibre Channel Management MIB February 2002
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 which 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. Each port
will typically only be able to support a subset of these
types."
::= { 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
Expires August 2002 [Page 22]
Internet Draft Fibre Channel Management MIB February 2002
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 Rev 7.01, 28 Nov 2000, sect 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
Expires August 2002 [Page 23]
Internet Draft Fibre Channel Management MIB February 2002
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 Rev 7.01, 28 Nov 2000, sect 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 Rev 7.01, 28 Nov 2000, sect 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 Rev 7.01, 28 Nov 2000, sect 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
Expires August 2002 [Page 24]
Internet Draft Fibre Channel Management MIB February 2002
"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 which are
capable of being 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 which are
Expires August 2002 [Page 25]
Internet Draft Fibre Channel Management MIB February 2002
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."
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,
Expires August 2002 [Page 26]
Internet Draft Fibre Channel Management MIB February 2002
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
Expires August 2002 [Page 27]
Internet Draft Fibre Channel Management MIB February 2002
"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
Expires August 2002 [Page 28]
Internet Draft Fibre Channel Management MIB February 2002
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
Expires August 2002 [Page 29]
Internet Draft Fibre Channel Management MIB February 2002
"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
Expires August 2002 [Page 30]
Internet Draft Fibre Channel Management MIB February 2002
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
Expires August 2002 [Page 31]
Internet Draft Fibre Channel Management MIB February 2002
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
-- which 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 which are a shadow of
the Counter64 statistics in the fcmPortStatsTable, for
systems which do not support Counter64."
::= { fcmgmtObjects 4 }
fcmPortLcStatsEntry OBJECT-TYPE
SYNTAX FcmPortLcStatsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
Expires August 2002 [Page 32]
Internet Draft Fibre Channel Management MIB February 2002
"An entry containing low-capacity (i.e., based on Counter32)
statistics for a Fibre Channel port."
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
Expires August 2002 [Page 33]
Internet Draft Fibre Channel Management MIB February 2002
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
Expires August 2002 [Page 34]
Internet Draft Fibre Channel Management MIB February 2002
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 }
Expires August 2002 [Page 35]
Internet Draft Fibre Channel Management MIB February 2002
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
Expires August 2002 [Page 36]
Internet Draft Fibre Channel Management MIB February 2002
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 }
Expires August 2002 [Page 37]
Internet Draft Fibre Channel Management MIB February 2002
--********************************
-- Port Error Counters
--
fcmPortErrorsTable OBJECT-TYPE
SYNTAX SEQUENCE OF FcmPortErrorsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Error counters for Fibre Channel ports."
::= { fcmgmtObjects 5 }
fcmPortErrorsEntry OBJECT-TYPE
SYNTAX FcmPortErrorsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Error counters for a Fibre Channel port."
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
Expires August 2002 [Page 38]
Internet Draft Fibre Channel Management MIB February 2002
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Link resets (LR primitives) received."
::= { fcmPortErrorsEntry 1 }
fcmPortTxLinkResets OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Link resets (LRs primitive) 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 Primitive OLS received at this port."
::= { fcmPortErrorsEntry 4 }
fcmPortTxOfflineSequences OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Offline Primitive OLS transmitted by this
port."
::= { fcmPortErrorsEntry 5 }
fcmPortLinkFailures OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
Expires August 2002 [Page 39]
Internet Draft Fibre Channel Management MIB February 2002
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."
::= { fcmPortErrorsEntry 7 }
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 12 }
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 11 }
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 10 }
fcmPortInvalidTxWords OBJECT-TYPE
Expires August 2002 [Page 40]
Internet Draft Fibre Channel Management MIB February 2002
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 9 }
fcmPortInvalidCRCs OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of frames received with 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 8 }
fcmPortInvalidOrderedSets OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of invalid ordered sets received at this port."
::= { fcmPortErrorsEntry 13 }
fcmPortFrameTooLongs OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of frames received at this port where 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 14 }
fcmPortTruncatedFrames OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
Expires August 2002 [Page 41]
Internet Draft Fibre Channel Management MIB February 2002
"The number of frames received at this port where 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 15 }
fcmPortAddressErrors OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of frames received with unknown addressing.
e.x. unknown SID or DID. the SID or DID is not known to the
routing algorithm."
::= { fcmPortErrorsEntry 16 }
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 17 }
fcmPortEncodingDisparityErrors OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of encoding disparity errors received at this
port."
::= { fcmPortErrorsEntry 18 }
fcmPortOtherErrors OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of errors which were detected on this port but
which were not counted by any other error counter in this
row."
::= { fcmPortErrorsEntry 19 }
Expires August 2002 [Page 42]
Internet Draft Fibre Channel Management MIB February 2002
--********************************
-- 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 which is
specific to Fx_Ports. This table will contain one entry for
each fcmPortTable entry which represents an Fx_Port."
::= { fcmgmtObjects 6 }
fcmFxPortEntry OBJECT-TYPE
SYNTAX FcmFxPortEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Each entry contains information for about a specific
Fx_Port."
INDEX { ifIndex }
::= { fcmFxPortTable 1 }
FcmFxPortEntry ::=
SEQUENCE {
fcmFxPortRatov MilliSeconds,
fcmFxPortEdtov MilliSeconds,
fcmFxPortRttov MilliSeconds,
fcmFxPortHoldTime MicroSeconds,
fcmFxPortCapBbCreditMax FcBbCredit,
fcmFxPortCapBbCreditMin FcBbCredit,
fcmFxPortCapDataFieldSizeMax FcDataFieldSize,
fcmFxPortCapDataFieldSizeMin FcDataFieldSize,
fcmFxPortCapClass2SeqDeliv TruthValue,
fcmFxPortCapClass3SeqDeliv TruthValue,
fcmFxPortCapHoldTimeMax MicroSeconds,
fcmFxPortCapHoldTimeMin MicroSeconds
}
fcmFxPortRatov OBJECT-TYPE
SYNTAX MilliSeconds
UNITS "milliseconds"
MAX-ACCESS read-only
STATUS current
Expires August 2002 [Page 43]
Internet Draft Fibre Channel Management MIB February 2002
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 MilliSeconds
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 MilliSeconds
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 Loss of
Synchronization."
::= { fcmFxPortEntry 3 }
fcmFxPortHoldTime OBJECT-TYPE
SYNTAX MicroSeconds
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
Expires August 2002 [Page 44]
Internet Draft Fibre Channel Management MIB February 2002
SYNTAX FcBbCredit
UNITS "buffers"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum number of receive buffers which 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 which 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
Expires August 2002 [Page 45]
Internet Draft Fibre Channel Management MIB February 2002
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 MicroSeconds
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 MicroSeconds
UNITS "microseconds"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The minimum holding time that this Fx_Port is capable of
supporting."
::= { fcmFxPortEntry 12 }
Expires August 2002 [Page 46]
Internet Draft Fibre Channel Management MIB February 2002
--********************************
-- The Fibre Channel E_Port Table
--
fcmEPortTable OBJECT-TYPE
SYNTAX SEQUENCE OF FcmEPortEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Additional information about Fibre Channel E_Ports. This
table will contain one entry for each fcmPortTable entry
which represents an E_Port."
::= { fcmgmtObjects 7 }
fcmEPortEntry OBJECT-TYPE
SYNTAX FcmEPortEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Each entry contains information for about a specific
E_Port."
INDEX { ifIndex }
::= { fcmEPortTable 1 }
FcmEPortEntry ::=
SEQUENCE {
fcmEPortClassFCredit FcBbCredit,
fcmEPortClassFDataFieldSize FcDataFieldSize
}
fcmEPortClassFCredit OBJECT-TYPE
SYNTAX FcBbCredit
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum number of Class F data frames which can be
transmitted by the E_Port without receipt of ACK or
Link_Response frames."
::= { fcmEPortEntry 1 }
fcmEPortClassFDataFieldSize OBJECT-TYPE
SYNTAX FcDataFieldSize
UNITS "bytes"
MAX-ACCESS read-only
STATUS current
Expires August 2002 [Page 47]
Internet Draft Fibre Channel Management MIB February 2002
DESCRIPTION
"The Receive Data Field Size which the E_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."
::= { fcmEPortEntry 2 }
--********************************
-- The Fabric Login table
--
-- This table contains the information held by FC switches
-- about the Nx_Ports which 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 8 }
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,
Expires August 2002 [Page 48]
Internet Draft Fibre Channel Management MIB February 2002
fcmFLoginClass2DataFieldSize FcDataFieldSize,
fcmFLoginClass3SeqDelivAgreed TruthValue,
fcmFLoginClass3DataFieldSize FcDataFieldSize
}
fcmFLoginNxPortIndex OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An arbitrary integer which uniquely identifies an Nx_Port
amongst all those attached to the Fx_Port indicated by
ifIndex."
::= { 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
Expires August 2002 [Page 49]
Internet Draft Fibre Channel Management MIB February 2002
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 which 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."
::= { fcmFLoginEntry 7 }
fcmFLoginClass2DataFieldSize OBJECT-TYPE
SYNTAX FcDataFieldSize
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The Receive Data Field Size which 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."
::= { 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."
Expires August 2002 [Page 50]
Internet Draft Fibre Channel Management MIB February 2002
::= { fcmFLoginEntry 9 }
fcmFLoginClass3DataFieldSize OBJECT-TYPE
SYNTAX FcDataFieldSize
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The Receive Data Field Size which 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."
::= { 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 which the agent knows
-- about Fibre Channel links, both those which terminate at
-- a local port, as well as 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 which
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 9 }
fcmLinkEntry OBJECT-TYPE
SYNTAX FcmLinkEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry containing information which a particular Fibre
Expires August 2002 [Page 51]
Internet Draft Fibre Channel Management MIB February 2002
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 FcAddressId
}
fcmLinkIndex OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An arbitrary integer which 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
Expires August 2002 [Page 52]
Internet Draft Fibre Channel Management MIB February 2002
"The physical port number of end1, or zero if unknown."
REFERENCE
"FC-GS-3 Rev 7.01, 28 Nov 2000, sect 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 Rev 7.01, 28 Nov 2000, sect 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
Expires August 2002 [Page 53]
Internet Draft Fibre Channel Management MIB February 2002
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The address of the SNMP agent for the Fibre Channel
Interconnect Element or Platform of which end2 is a part.
If the address is unknown, the value of this object is the
zero-length string."
REFERENCE
"FC-GS-3 Rev 7.01, 28 Nov 2000, sect 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 Rev 7.01, 28 Nov 2000, sect 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 Rev 7.01, 28 Nov 2000, sections 6.1.2.1.2
and 6.1.2.3.2"
::= { fcmLinkEntry 10 }
fcmLinkEnd2FcAddressId OBJECT-TYPE
SYNTAX FcAddressId
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The Fibre Channel Address ID of end2, or the zero-length
string if unknown."
::= { fcmLinkEntry 11 }
Expires August 2002 [Page 54]
Internet Draft Fibre Channel Management MIB February 2002
--********************************
-- 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,
fcmPortStatsGroup,
fcmPortErrorsGroup,
fcmLinkBasicGroup }
GROUP fcmPortClass23StatsGroup
DESCRIPTION
"This group is mandatory only for systems which
keep class-specific traffic statistics on Class 2
on Class 3 traffic."
GROUP fcmPortClassFStatsGroup
DESCRIPTION
"This group is mandatory only for FC switches which
keep statistics on Class F traffic."
GROUP fcmPortLcStatsGroup
DESCRIPTION
"This group is mandatory only for agents which
do not provide Counter64 counters."
GROUP fcmSwitchBasicGroup
DESCRIPTION
"This group is mandatory only for Fibre Channel
managed instances which manage Fibre Channel
switches."
GROUP fcmSwitchPortGroup
DESCRIPTION
"This group is mandatory only for Fibre Channel
managed instances which manage Fibre Channel
Expires August 2002 [Page 55]
Internet Draft Fibre Channel Management MIB February 2002
switches."
GROUP fcmSwitchLoginGroup
DESCRIPTION
"This group is mandatory only for Fibre Channel
managed instances which manage Fibre Channel
switches."
OBJECT fcmInstancePhysicalIndex
SYNTAX INTEGER (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."
::= { fcmgmtCompliances 1 }
Expires August 2002 [Page 56]
Internet Draft Fibre Channel Management MIB February 2002
--********************************
-- 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 }
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,
Expires August 2002 [Page 57]
Internet Draft Fibre Channel Management MIB February 2002
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."
Expires August 2002 [Page 58]
Internet Draft Fibre Channel Management MIB February 2002
::= { 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,
fcmEPortClassFCredit,
fcmEPortClassFDataFieldSize, }
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
Expires August 2002 [Page 59]
Internet Draft Fibre Channel Management MIB February 2002
"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
Expires August 2002 [Page 60]
Internet Draft Fibre Channel Management MIB February 2002
7. Intellectual Property
The IETF takes no position regarding the validity or scope of any
intellectual property 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; neither does it represent that it has made any
effort to identify any such rights. Information on the IETF's
procedures with respect to rights in standards-track and standards-
related documentation can be found in BCP-11. Copies of claims of
rights made available for publication 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
implementors or users of this specification can be obtained from the
IETF Secretariat.
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary rights
which may cover technology that may be required to practice this
standard. Please address the information to the IETF Executive
Director.
8. 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 as draft-ietf-ipfc-fcmgmt-int-mib-0n.txt, and partly
based on RFC 2837.
Feedback has been incorporated into this document based on the comments
of the following: Sudhir Pendse, SimpleSoft; Steve Senum, Cisco Systems;
and Kha Sin Teow, Brocade.
9. References
[RFC1155]
Rose, M., and K. McCloghrie, "Structure and Identification of
Management Information for TCP/IP-based Internets", RFC 1155,
Performance Systems International, Hughes LAN Systems, May 1990.
[RFC1157]
Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple Network
Management Protocol", RFC 1157, SNMP Research, Performance Systems
International, Performance Systems International, MIT Laboratory
for Computer Science, May 1990.
Expires August 2002 [Page 61]
Internet Draft Fibre Channel Management MIB February 2002
[RFC1212]
Rose, M., and K. McCloghrie, "Concise MIB Definitions", RFC 1212,
Performance Systems International, Hughes LAN Systems, March 1991.
[RFC1215]
M. Rose, "A Convention for Defining Traps for use with the SNMP",
RFC 1215, Performance Systems International, March 1991.
[RFC1901]
SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
Waldbusser, "Introduction to Community-based SNMPv2", RFC 1901,
SNMP Research, Inc., Cisco Systems, Inc., Dover Beach Consulting,
Inc., International Network Services, January 1996.
[RFC1905]
SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
Waldbusser, "Protocol Operations for Version 2 of the Simple
Network Management Protocol (SNMPv2)", RFC 1905, SNMP Research,
Inc., Cisco Systems, Inc., Dover Beach Consulting, Inc.,
International Network Services, January 1996.
[RFC1906]
SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
Waldbusser, "Transport Mappings for Version 2 of the Simple Network
Management Protocol (SNMPv2)", RFC 1906, SNMP Research, Inc., Cisco
Systems, Inc., Dover Beach Consulting, Inc., International Network
Services, January 1996.
[RFC2026]
Bradner, S., "The Internet Standards Process -- Revision 3", RFC
2026, Harvard University, October, 1996.
[RFC2570]
Case, J., Mundy, R., Partain, D., and B. Stewart, "Introduction to
Version 3 of the Internet-standard Network Management Framework",
RFC 2570, SNMP Research, Inc., TIS Labs at Network Associates,
Inc., Ericsson, Cisco Systems, April 1999.
[RFC2571]
Harrington, D., Presuhn, R., and B. Wijnen, "An Architecture for
Describing SNMP Management Frameworks", RFC 2571, Cabletron
Systems, Inc., BMC Software, Inc., IBM T. J. Watson Research, April
1999.
Expires August 2002 [Page 62]
Internet Draft Fibre Channel Management MIB February 2002
[RFC2572]
Case, J., Harrington D., Presuhn R., and B. Wijnen, "Message
Processing and Dispatching for the Simple Network Management
Protocol (SNMP)", RFC 2572, SNMP Research, Inc., Cabletron Systems,
Inc., BMC Software, Inc., IBM T. J. Watson Research, April 1999.
[RFC2573]
Levi, D., Meyer, P., and B. Stewart, "SNMPv3 Applications", RFC
2573, SNMP Research, Inc., Secure Computing Corporation, Cisco
Systems, April 1999.
[RFC2574]
Blumenthal, U., and B. Wijnen, "User-based Security Model (USM) for
version 3 of the Simple Network Management Protocol (SNMPv3)", RFC
2574, IBM T. J. Watson Research, April 1999.
[RFC2575]
Wijnen, B., Presuhn, R., and K. McCloghrie, "View-based Access
Control Model (VACM) for the Simple Network Management Protocol
(SNMP)", RFC 2575, IBM T. J. Watson Research, BMC Software, Inc.,
Cisco Systems, Inc., April 1999.
[RFC2578]
McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M.,
and S. Waldbusser, "Structure of Management Information Version 2
(SMIv2)", RFC 2578, STD 58, Cisco Systems, SNMPinfo, TU
Braunschweig, SNMP Research, First Virtual Holdings, International
Network Services, April 1999.
[RFC2579]
McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M.,
and S. Waldbusser, "Textual Conventions for SMIv2", RFC 2579, STD
58, Cisco Systems, SNMPinfo, TU Braunschweig, SNMP Research, First
Virtual Holdings, International Network Services, April 1999.
[RFC2580]
McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M.,
and S. Waldbusser, "Conformance Statements for SMIv2", RFC 2580,
STD 58, Cisco Systems, SNMPinfo, TU Braunschweig, SNMP Research,
First Virtual Holdings, International Network Services, April 1999.
[RFC2737]
McCloghrie, K., and A. Bierman, "Entity MIB (Version 2)", RFC 2737,
December 1999.
Expires August 2002 [Page 63]
Internet Draft Fibre Channel Management MIB February 2002
[RFC2741]
Daniele, M., Wijnen, B., Ellison, M., and D. Francisco. "Agent
Extensibility (AgentX) Protocol Version 1", RFC 2741, January 2000.
[RFC2790]
Waldbusser, S., and P. Grillo, "Host Resources MIB", RFC 2790,
March 2000.
[RFC2837]
Teow, K., "Definitions of Managed Objects for the Fabric Element in
Fibre Channel Standard", RFC 2837, May 2000.
[RFC2863]
McCloghrie, K., and F. Kastenholz, "The Interfaces Group MIB", RFC
2863, Cisco Systems, Argon Networks, June, 2000.
[FC-AL]
"Information Technology - Fibre Channel - Arbitrated Loop (FC-AL)",
ANSI X3.272, 1996.
[FC-AL-2]
"Fibre Channel - Arbitrated Loop (FC-AL-2)", ANSI NCITS 332-1999,
1999.
[FC-BB]
ANSI NCITS xxx-200x, "Fibre Channel - Backbone (FC-BB), T11/Project
1238D/Rev 4.8", February 2001.
[FCP]
"SCSI-3 Fibre Channel Protocol (FCP)", ANSI X3.269, 1996.
[FC-FLA]
"Fibre Channel - Fabric Loop Attachment (FC-FLA)", ANSI NCITS
TR-20-1998, 1998.
[FC-GS-3]
"Fibre Channel - Generic Services - 3 (FC-GS-3)" NCITS xxx-200x,
T11/Project 1356-D/Rev 7.01, 28 November 2000.
[FC-MI]
"Fibre Channel - Methodologies for Interconnects Technical Report
(FC-MI)" T11/Project 1377-DT/Rev 1.92, 4 December 2001.
[FC-PH]
"Information Technology - Fibre Channel Physical and Signaling
Expires August 2002 [Page 64]
Internet Draft Fibre Channel Management MIB February 2002
Interface (FC-PH)", ANSI X3.230, 1994.
[FC-SW]
"Fibre Channel - Switch Fabric (FC-SW)", ANSI NCITS 321-1998, 1998.
[FC-SW2]
"Fibre Channel - Switch Fabric - 2 (FC-SW-2)", T11/Project
1305D/Rev 5.3, ANSI NCITS xxx-200x, June 2001.
[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.
[SENSOR]
Bierman, A., Romascanu, D., and KC Norseth, "Entity Sensor
Management Information Base", Internet Draft, <draft-ietf-entmib-
sensor-mib-00.txt>, 18 January 2002.
10. Security Considerations
There are a number of management objects defined in this MIB that have a
MAX-ACCESS clause of read-write. Such objects may be considered
sensitive or vulnerable in some network environments. The support for
SET operations in a non-secure environment without proper protection can
have a negative effect on network operations.
There are a number of managed objects in this MIB that contain what
could be considered as sensitive information. In particular, the
objects which provide information on network topology:
fcmLinkEnd1NodeWwn
fcmLinkEnd1PhysPortNumber
fcmLinkEnd1PortWwn
fcmLinkEnd2NodeWwn
fcmLinkEnd2PhysPortNumber
fcmLinkEnd2PortWwn
Expires August 2002 [Page 65]
Internet Draft Fibre Channel Management MIB February 2002
fcmLinkEnd2AgentAddress
fcmLinkEnd2PortType
fcmLinkEnd2UnitType
fcmLinkEnd2FcAddressId
Therefore, it may be important in some environments to control read
access to these objects and possibly to even encrypt their values when
sending them over the network via SNMP. Not all versions of SNMP
provide features for such a secure environment.
SNMPv1 by itself is not a secure environment. 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.
It is recommended that the implementors consider the security features
as provided by the SNMPv3 framework. Specifically, the use of the User-
based Security Model RFC 2574 [RFC2574] and the View-based Access
Control Model RFC 2575 [RFC2575] is recommended.
It is then a customer/user responsibility to ensure that the SNMP entity
giving access to an instance of this MIB, 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.
Expires August 2002 [Page 66]
Internet Draft Fibre Channel Management MIB February 2002
11. Comparison to draft-ietf-ipfc-fcmgmt-int-mib-07.txt
The decision on whether this section is permanent will be made prior to
publication of this document as an RFC.
11.1. Problems with draft-ietf-ipfc-fcmgmt-int-mib-07.txt
The Fibre Channel Management Integration MIB 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-scaleable. 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 which 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 which 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). RFC 2837 doesn't do that, and nor did the Fibre Channel
Integration MIB.
- It incorrectly used the OCTET STRING syntax (instead of Counter32
or Counter64) for counters.
Expires August 2002 [Page 67]
Internet Draft Fibre Channel Management MIB February 2002
11.2. Detailed Changes
11.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 the
IETF's ENTITY MIB Working Group has produced a first draft of a Sensor
MIB, see [SENSOR].) This removed the need for:
connUnitSensorTable (and all its contents)
connUnitNumSensors
connUnitSensorStatusChange
11.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)
11.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
Expires August 2002 [Page 68]
Internet Draft Fibre Channel Management MIB February 2002
11.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
11.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
11.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
Expires August 2002 [Page 69]
Internet Draft Fibre Channel Management MIB February 2002
connUnitStatusChange
11.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)
11.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
Expires August 2002 [Page 70]
Internet Draft Fibre Channel Management MIB February 2002
connUnitPortControl ifAdminStatus
connUnitPortState ifAdminStatus
connUnitPortHWState ifOperStatus
connUnitPortStatus ifOperStatus
connUnitPortName ifAlias
connUnitPortStatObject ifSpecific
connUnitNumports ifNumber
connUnitPortStatusChange linkUp/linkDown
11.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 which the MIB contains pose a problem for the AgentX
environment. All the (remaining) scalars were therefore removed:
revisionNumber
uNumber
systemURL
11.2.10. FC Management Instance
The term "connectivity unit" was changed to "FC management instance".
The term "connectivity unit" was not properly defined in draft-ietf-
ipfc-fcmgmt-int-mib-07.txt, 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 "connectivity unit" was whatever
grouping was easiest in providing access to the management
functionality. (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
Expires August 2002 [Page 71]
Internet Draft Fibre Channel Management MIB February 2002
definition, then "FC management instance" is a better name because it is
more accurate and more representative of the definition, than is
"connectivity unit".
11.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
occurence of errors, even on a 10Gbs Fibre Channel interface, might wrap
faster than a hour, the fact that errors are occurring will almost
certainly be apparent from other MIB objects.)
11.2.12. Obsolete/Little-Used Fibre Channel features
Information relating to Fibre Channel features which 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 these objects:
connUnitPortStatCountFBSYFrames
connUnitPortStatCountPBSYFrames
connUnitPortStatCountFRJTFrames
connUnitPortStatCountPRJTFrames
have been deleted.
11.3. Name Server objects
A table of Name Server information was present in draft-ietf-ipfc-
fcmgmt-int-mib-07.txt. 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.
Expires August 2002 [Page 72]
Internet Draft Fibre Channel Management MIB February 2002
11.4. Additional objects
Support for Class F traffic, including 32-bit octet and frame counters,
has been added.
Expires August 2002 [Page 73]
Internet Draft Fibre Channel Management MIB February 2002
12. 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.
Expires August 2002 [Page 74]
Internet Draft Fibre Channel Management MIB February 2002
13. Author's Address
Keith McCloghrie
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA USA 95134
Phone: +1 408-526-5260
Email: kzm@cisco.com
14. Full Copyright Statement
Copyright (C) The Internet Society (2001). All Rights Reserved.
This document and translations of it may be copied and furnished to
others, and derivative works that comment on or otherwise explain it or
assist in its implementation may be prepared, copied, published and
distributed, in whole or in part, without restriction of any kind,
provided that the above copyright notice and this paragraph are included
on all such copies and derivative works. However, this document itself
may not be modified in any way, such as by removing the copyright notice
or references to the Internet Society or other Internet organizations,
except as needed for the purpose of developing Internet standards in
which case the procedures for copyrights defined in the Internet
Standards process must be followed, or as required to translate it into
languages other than English.
The limited permissions granted above are perpetual and will not be
revoked by the Internet Society or its successors or assigns.
This document and the information contained herein is provided on an "AS
IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK
FORCE DISCLAIMS 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.
Expires August 2002 [Page 75]