Request for Comments: 4626 V. Gaonkar
Category: Standards Track K. McCloghrie
Cisco Systems
S. Gai
Retired
September 2006
MIB for Fibre Channel’s Fabric Shortest Path First (FSPF) Protocol
Status of This Memo
This document specifies an Internet standards track protocol for the
Internet community, and requests discussion and suggestions for
improvements. Please refer to the current edition of the "Internet
Official Protocol Standards" (STD 1) for the standardization state
and status of this protocol. Distribution of this memo is unlimited.
Copyright Notice
Copyright (C) The Internet Society (2006).
Abstract
This memo defines a portion of the Management Information Base (MIB)
for use with network management protocols in the Internet community.
In particular, it describes managed objects for information related
to the Fibre Channel network’s Fabric Shortest Path First (FSPF)
routing protocol.
Table of Contents
1. Introduction ....................................................2
2. The Internet-Standard Management Framework ......................2
3. Short Overview of Fibre Channel .................................3
3.1. Introduction ...............................................3
3.2. FSPF Protocol ..............................................4
3.3. Virtual Fabrics ............................................4
4. Relationship to Other MIBs ......................................5
5. MIB Overview ....................................................5
5.1. Fibre Channel Management Instance ..........................5
5.2. Switch Index ...............................................6
5.3. Fabric Index ...............................................6
5.4. The MIB Groups .............................................6
5.4.1. The t11FspfGeneralGroup Group .......................6
5.4.2. The t11FspfIfGroup Group ............................7
5.4.3. The t11FspfDatabaseGroup Group ......................7
5.4.4. The t11FspfNotificationGroup Group ..................7
6. The T11-FC-FSPF-MIB Module ......................................7
7. Acknowledgements ...............................................31
8. IANA Considerations ............................................32
9. Security Considerations ........................................32
10. Normative References ..........................................33
11. Informative References ........................................34
1. Introduction
This memo defines a portion of the Management Information Base (MIB)
for use with network management protocols in the Internet community.
In particular, it describes managed objects for information related
to the Fibre Channel network’s Fabric Shortest Path First (FSPF)
routing protocol, which is specified in [FC-SW-4].
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [RFC2119].
2. The Internet-Standard Management Framework
For a detailed overview of the documents that describe the current
Internet-Standard Management Framework, please refer to section 7 of
RFC 3410 [RFC3410].
Managed objects are accessed via a virtual information store, termed
the Management Information Base or MIB. MIB objects are generally
accessed through the Simple Network Management Protocol (SNMP).
Objects in the MIB are defined using the mechanisms defined in the
Structure of Management Information (SMI). This memo specifies a MIB
module that is compliant to the SMIv2, which is described in STD 58,
RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580
[RFC2580].
3. Short Overview of Fibre Channel
3.1. Introduction
The Fibre Channel (FC) is logically a bidirectional point-to-point
serial data channel, structured for high performance. Fibre Channel
provides a general transport vehicle for higher-level protocols, such
as 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 is interconnected to another switch port via an
Inter-Switch Link (ISL), 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 [FC-FS]. WWNs are expected to be persistent
across agent and unit resets.
Fibre Channel frames contain 24-bit address identifiers that identify
the frame’s source and destination ports. Each FC port has both an
address identifier and a WWN. When a fabric is in use, the FC
address identifiers are dynamic and are assigned by a switch. Each
octet of a 24-bit address represents a level in an address hierarchy,
a Domain_ID being the highest level of the hierarchy.
The routing of frames within the Fabric is normally based on a
routing protocol called Fabric Shortest Path First (FSPF). FSPF is a
link state path selection protocol, which is defined in Section 8 of
[FC-SW-4]. FSPF keeps track of the state of the links on all
switches in the Fabric and associates a cost with each link. The
protocol computes paths from a switch to all the other switches in
the Fabric by adding the cost of all the links traversed by the path,
and choosing the path that minimizes the cost. The collection of
link states (including cost) of all the switches in a Fabric
constitutes the topology database (or link-state database).
3.2. FSPF Protocol
FSPF has four major components:
a) A Hello protocol, used to establish connectivity with a neighbor
switch, to establish the identity of the neighbor switch, and to
exchange FSPF parameters and capabilities;
b) A replicated topology database, with protocols and mechanisms to
keep the databases synchronized across the Fabric;
c) A path computation algorithm (e.g., Dijkstra’s algorithm);
d) A routing table update.
The topology database synchronization in turn consists of two major
components: an initial database synchronization and an update
mechanism. The initial database synchronization is used when a
switch is initialized, or when an Inter-Switch Link (ISL) comes up.
The update mechanism is used in two circumstances:
a) When there is a link state change; for example, an ISL going down
or coming up;
b) On a periodic basis, to prevent switches from deleting topology
information from the database.
Also note that all connections between Fibre Channel switches are
point-to-point.
3.3. Virtual Fabrics
The latest standard for an interconnecting Fabric containing multiple
Fabric Switch elements is [FC-SW-4]. [FC-SW-4] carries forward the
previous version’s specification for the operation of a single Fabric
in a physical infrastructure, augmenting it with the definition of
Virtual Fabrics and with the specification of how multiple Virtual
Fabrics can operate within one (or more) physical infrastructures.
The use of Virtual Fabrics provides for each frame to be tagged in
its header to indicate which one of several Virtual Fabrics that
frame is being transmitted on. All frames entering a particular
"Core Switch" [FC-SW-4] (i.e., a physical switch) on the same Virtual
Fabric are processed by the same "Virtual Switch" within that Core
switch.
4. Relationship to Other MIBs
The first standardized MIB module for Fibre Channel [RFC4044] was
focussed on Fibre Channel switches. It is being replaced by the more
generic Fibre Channel Management MIB [FC-MGMT] which defines basic
information for Fibre Channel hosts and switches, including
extensions to the standard IF-MIB [RFC2863] for Fibre Channel
interfaces.
This MIB module extends beyond [FC-MGMT] to cover the operation of
the FSPF routing protocol in Fibre Channel switches.
This MIB module only contains information specific to FSPF.
Information that would still be applicable if any other routing
protocol were used is specified in a separate MIB module.
This MIB module imports some common Textual Conventions from T11-TC-
MIB, defined in [RFC4439].
5. MIB Overview
This MIB module provides the means for monitoring the operation of,
and configuring some parameters of, one or more instances of the FSPF
protocol.
5.1. Fibre Channel Management Instance
A Fibre Channel management instance is defined in [FC-MGMT] 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 with multiple AgentX [RFC2741] sub-agents, with
each sub-agent implementing a different Fibre Channel management
instance.
The object, fcmInstanceIndex, is IMPORTed from the FC-MGMT-MIB
[FC-MGMT] as the index value that uniquely identifies each Fibre
Channel management instance within the same SNMP context ([RFC3411],
Section 3.3.1).
5.2. Switch Index
The FC-MGMT-MIB [FC-MGMT] defines the fcmSwitchTable as a table of
information about Fibre Channel switches that are managed by Fibre
Channel management instances. Each Fibre Channel management instance
can manage one or more Fibre Channel switches. The Switch Index,
fcmSwitchIndex, is IMPORTed from the FC-MGMT-MIB as the index value
that uniquely identifies a Fibre Channel switch among those (one or
more) managed by the same Fibre Channel management instance.
5.3. Fabric Index
Whether operating on a physical Fabric (i.e., without Virtual
Fabrics) or within a Virtual Fabric, the operation of FSPF within a
Fabric is identical. Therefore, this MIB module defines all Fabric-
related information in tables that are INDEX-ed by an arbitrary
integer, named a "Fabric Index", the syntax of which is IMPORTed from
the T11-TC-MIB. When a device is connected to a single physical
Fabric, without use of any virtual Fabrics, the value of this Fabric
Index will always be 1. In an environment of multiple virtual and/or
physical Fabrics, this index provides a means to distinguish one
Fabric from another.
It is quite possible, and may even be likely, that a Fibre Channel
switch will have ports connected to multiple virtual and/or physical
Fabrics. Thus, in order to simplify a management protocol query
concerning all the Fabrics to which a single switch is connected,
fcmSwitchIndex will be listed before t11FspfFabricIndex when they
both appear in the same INDEX clause.
5.4. The MIB Groups
This section describes the four MIB groups contained in the MIB
module.
5.4.1. The t11FspfGeneralGroup Group
This group provides for per-Fabric monitoring of the FSPF state and
per-Fabric monitoring/configuration of FSPF parameters.
5.4.2. The t11FspfIfGroup Group
This group provides for per-interface monitoring of FSPF
state/statistics and per-interface monitoring/configuration of FSPF
parameters.
5.4.3. The t11FspfDatabaseGroup Group
This group permits the monitoring of the information present in the
FSPF topology database.
5.4.4. The t11FspfNotificationGroup Group
This group contains the notifications that are generated on
asynchronous events related to the operation of FSPF.
6. The T11-FC-FSPF-MIB Module
T11-FC-FSPF-MIB DEFINITIONS ::= BEGIN
--
-- For management of FSPF, the Fibre Channel routing protocol.
--
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
Counter32, Integer32, Unsigned32, TimeTicks,
Gauge32, mib-2 FROM SNMPv2-SMI -- [RFC2578]
MODULE-COMPLIANCE, OBJECT-GROUP,
NOTIFICATION-GROUP FROM SNMPv2-CONF -- [RFC2580]
TEXTUAL-CONVENTION, RowStatus, StorageType,
TruthValue FROM SNMPv2-TC -- [RFC2579]
ifIndex, InterfaceIndex FROM IF-MIB -- [RFC2863]
fcmInstanceIndex, fcmSwitchIndex,
FcDomainIdOrZero FROM FC-MGMT-MIB -- [FC-MGMT]
T11FabricIndex FROM T11-TC-MIB -- [RFC4439]
t11FamConfigDomainId
FROM T11-FC-FABRIC-ADDR-MGR-MIB; -- [RFC4439]
t11FcFspfMIB MODULE-IDENTITY
LAST-UPDATED "200608140000Z"
ORGANIZATION "T11"
CONTACT-INFO
"Claudio DeSanti
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134 USA
EMail: cds@cisco.com
Keith McCloghrie
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA USA 95134
Email: kzm@cisco.com"
DESCRIPTION
"The MIB module for managing the Fabric Shortest Path
First (FSPF) protocol. FSPF is specified in FC-SW-4.
Copyright (C) The Internet Society (2006). This version of
this MIB module is part of RFC 4626; see the RFC itself for
full legal notices."
REVISION "200608140000Z"
DESCRIPTION
"Initial version of this MIB module published as RFC4626."
::= { mib-2 143 }
t11FspfNotifications OBJECT IDENTIFIER ::= { t11FcFspfMIB 0 }
t11FspfObjects OBJECT IDENTIFIER ::= { t11FcFspfMIB 1 }
t11FspfConformance OBJECT IDENTIFIER ::= { t11FcFspfMIB 2 }
t11FspfConfiguration OBJECT IDENTIFIER ::= { t11FspfObjects 1 }
t11FspfDatabase OBJECT IDENTIFIER ::= { t11FspfObjects 2 }
--
-- TEXTUAL CONVENTIONS
T11FspfLsrType ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"Type of the Link State Record.
FC-SW-4 defines two types of LSRs and allows for the
possibility for more will be defined in the future:
01 - Switch Link Record
02 - Obsolete
240 - 255 - Vendor Specific
others - Reserved.
"
REFERENCE
"Fibre Channel - Switch Fabric - 4 (FC-SW-4),
ANSI INCITS 418-2006, section 6.1.9.3."
SYNTAX Integer32 (0..255)
T11FspfLinkType ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"Type of an the FSPF Link. Presently defined values:
1 - Point-to-Point
240-255 - Vendor Specific
all others - Reserved.
"
REFERENCE
"Fibre Channel - Switch Fabric - 4 (FC-SW-4),
ANSI INCITS 418-2006, section 6.1.9.4."
SYNTAX Integer32 (0..255)
T11FspfInterfaceState ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"The state of the FSPF Neighbor Finite State Machine
for the neighbor (switch) on a particular interface.
Possible values are :
down(1) - Down
init(2) - Init
dbExchange(3) - Database Exchange
dbAckwait(4) - Database AckWait
dbWait(5) - Database Wait
full(6) - Full (Connected)
"
REFERENCE
"Fibre Channel - Switch Fabric - 4 (FC-SW-4),
ANSI INCITS 418-2006, section 8.7."
SYNTAX INTEGER {
down(1),
init(2),
dbExchange(3),
dbAckwait(4),
dbWait(5),
full(6)
}
T11FspfLastCreationTime ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"This TC describes an object that stores the last time
it, and the row containing it, was created.
This can be used by management applications to determine
that a row has been deleted and re-created between reads,
causing an otherwise undetectable discontinuity in the
data."
SYNTAX TimeTicks
--
-- t11FspfTable
t11FspfTable OBJECT-TYPE
SYNTAX SEQUENCE OF T11FspfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table allows the users to configure and monitor FSPF’s
per-Fabric parameters and statistics on all Fabrics known to
locally managed switches.
Entries are created/removed by the agent if and when
(Virtual) Fabrics are created/deleted."
::= { t11FspfConfiguration 1 }
t11FspfEntry OBJECT-TYPE
SYNTAX T11FspfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry containing FSPF variables, parameters, and
statistics on a particular switch (identified by values
of fcmInstanceIndex and fcmSwitchIndex) for a particular
Fabric (identified by a t11FspfFabricIndex value).
(Note that the local switch’s per-fabric Domain-ID is
available in t11FamConfigDomainId, which is defined in
T11-FC-FABRIC-ADDR-MGR-MIB.)"
INDEX { fcmInstanceIndex, fcmSwitchIndex, t11FspfFabricIndex }
::= { t11FspfTable 1 }
T11FspfEntry ::= SEQUENCE {
t11FspfFabricIndex T11FabricIndex,
t11FspfMinLsArrival Unsigned32,
t11FspfMinLsInterval Unsigned32,
t11FspfLsRefreshTime Unsigned32,
t11FspfMaxAge Unsigned32,
t11FspfMaxAgeDiscards Counter32,
t11FspfPathComputations Counter32,
t11FspfChecksumErrors Counter32,
t11FspfLsrs Gauge32,
t11FspfCreateTime T11FspfLastCreationTime,
t11FspfAdminStatus INTEGER,
t11FspfOperStatus INTEGER,
t11FspfNbrStateChangNotifyEnable TruthValue,
t11FspfSetToDefault INTEGER,
t11FspfStorageType StorageType
}
t11FspfFabricIndex OBJECT-TYPE
SYNTAX T11FabricIndex
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A unique index value that uniquely identifies a
particular Fabric.
In a Fabric conformant to FC-SW-4, multiple Virtual Fabrics
can operate within one (or more) physical infrastructures.
In such a case, index value is used to uniquely identify a
particular Fabric within a physical infrastructure.
In a Fabric that has (can have) only a single Fabric
operating within the physical infrastructure, the
value of this Fabric Index will always be 1."
::= { t11FspfEntry 1 }
t11FspfMinLsArrival OBJECT-TYPE
SYNTAX Unsigned32 (0..65535)
UNITS "milliSeconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The minimum time after accepting a Link State Record
(LSR) on this Fabric before accepting another update of
the same LSR on the same Fabric.
An LSR update that is not accepted because of this time
interval is discarded."
REFERENCE "Fibre Channel - Switch Fabric - 4 (FC-SW-4),
ANSI INCITS 418-2006, sections 8.6.4.5 & 15.1."
DEFVAL {1000}
::= { t11FspfEntry 2 }
t11FspfMinLsInterval OBJECT-TYPE
SYNTAX Unsigned32 (0..65535)
UNITS "milliSeconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The minimum time after this switch sends an LSR on this
Fabric before it will send another update of the same LSR
on the same Fabric."
REFERENCE "Fibre Channel - Switch Fabric - 4 (FC-SW-4),
ANSI INCITS 418-2006, section 15.1."
DEFVAL {5000}
::= { t11FspfEntry 3 }
t11FspfLsRefreshTime OBJECT-TYPE
SYNTAX Unsigned32
UNITS "Minutes"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The interval between transmission of refresh LSRs on this
Fabric."
REFERENCE "Fibre Channel - Switch Fabric - 4 (FC-SW-4),
ANSI INCITS 418-2006, sections 8.5.1 & 15.1."
DEFVAL {30}
::= { t11FspfEntry 4 }
t11FspfMaxAge OBJECT-TYPE
SYNTAX Unsigned32