Internet Draft C. DeSanti V. Gaonkar K. McCloghrie S. Gai Cisco Systems 22 August 2005 MIB for Fibre-Channel's Fabric Shortest Path First Protocol draft-ietf-imss-fc-fspf-mib-00.txt Status of this Memo "By submitting this Internet-Draft, each author represents that any applicable patent or other IPR claims of which he or she is aware have been or will be disclosed, and any of which he or she becomes aware will be disclosed, in accordance with Section 6 of BCP 79." 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. Copyright Notice Copyright (C) The Internet Society (2005). All Rights Reserved. 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. This memo was originally developed as the SM-FSM project of T11.5 (http://www.t11.org). With the approval of SM-FSM, the memo was forwarded to, and has become a work item of, IETF's IMSS working group. Expires February 2006 [Page 1] Internet Draft Fibre-Channel FSPF MIB August 2005 Table of Contents 1 Introduction ................................................. 3 2 The Internet-Standard Management Framework ................... 3 3 Short Overview of Fibre Channel .............................. 3 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 ............................................. 7 5.4.1 The t11FspfGeneralGroup group ............................ 7 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 ................................... 8 7 Intellectual Property ........................................ 34 8 Acknowledgements ............................................. 34 9 Normative References ......................................... 34 10 Informative References ...................................... 35 11 IANA Considerations ......................................... 36 12 Security Considerations ..................................... 36 13 Authors' Addresses .......................................... 37 Expires February 2006 [Page 2] Internet Draft Fibre-Channel FSPF MIB August 2005 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]. 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 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 Expires February 2006 [Page 3] Internet Draft Fibre-Channel FSPF MIB August 2005 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 which 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, with 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). 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 the 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 Expires February 2006 [Page 4] Internet Draft Fibre-Channel FSPF MIB August 2005 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. 4. Relationship to Other MIBs The first standardized MIB for Fibre Channel [RFC2837] 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 for Fibre Channel interfaces. This MIB extends beyond [FC-MGMT] to cover the operation of the FSPF routing protocol in Fibre Channel switches. This MIB only contains information specific to FSPF. Information which would still be applicable if any other routing protocol were to be used, is specified in a separate MIB [FC-RTM-MIB]. This MIB imports some common Textual Conventions from T11-TC-MIB, defined in [FC-FAM-MIB]. 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. (Note that there are no definitions in this MIB module of "managed actions" which can be invoked via SNMP.) 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 Expires February 2006 [Page 5] Internet Draft Fibre-Channel FSPF MIB August 2005 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. The object, fcmInstanceIndex, is IMPORTed from the FC-MGMT-MIB [FC-MGMT] as the index value to uniquely identify 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 which 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 to uniquely identify a Fibre Channel switch amongst those (one or more) managed by the same Fibre Channel management instance. 5.3. Fabric Index The latest standard for an interconnecting Fabric containing multiple Fabric Switch elements is [FC-SW-4]. [FC-SW-4] specifies the operation of both a single Fabric in a physical infrastructure, as well as the support of multiple Virtual Fabrics operating within one (or more) physical infrastructures. 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 defines all Fabric-related information in tables which 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. Expires February 2006 [Page 6] Internet Draft Fibre-Channel FSPF MIB August 2005 5.4. The MIB Groups This section describes the four MIB groups contained in the MIB. 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 which are generated on asynchronous events related to the operation of FSPF. Expires February 2006 [Page 7] Internet Draft Fibre-Channel FSPF MIB August 2005 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 -- [FC-FAM-MIB] t11FamConfigDomainId FROM T11-FC-FABRIC-ADDR-MGR-MIB; -- [FC-FAM-MIB] t11FcFspfMIB MODULE-IDENTITY LAST-UPDATED "200501040000Z" 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." REVISION "200501040000Z" DESCRIPTION "Initial version of this MIB module." Expires February 2006 [Page 8] Internet Draft Fibre-Channel FSPF MIB August 2005 ::= { mib-2 nnn } -- to be determined later 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 T11FspfARegionNum ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "The AR number of an autonomous region. The backbone region has zero as its AR number." REFERENCE "FC-SW-4 section D.2." SYNTAX Integer32 (0..255) 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 of more being defined in the future: 01 - Switch Link Record 02 - Obsolete 240-255 - Vendor Specific others - Reserved. " REFERENCE "FC-SW-4, rev 7.5, section 6.1.9.3." SYNTAX Integer32 (0..255) T11FspfLinkType ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Type of an the FSPF Link. Presently defined values: 01 - Point-to-Point 240-255 - Vendor Specific others - Reserved. " REFERENCE "FC-SW-4, section 6.1.9.4." Expires February 2006 [Page 9] Internet Draft Fibre-Channel FSPF MIB August 2005 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 "FC-SW-4, 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 Expires February 2006 [Page 10] Internet Draft Fibre-Channel FSPF MIB August 2005 -- -- 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, t11FspfARegionNum T11FspfARegionNum, t11FspfMinLsArrival Unsigned32, t11FspfMinLsInterval Unsigned32, t11FspfLsRefreshTime Unsigned32, t11FspfMaxAge Unsigned32, t11FspfMaxAgeDiscards Counter32, t11FspfPathComputations Counter32, t11FspfChecksumErrors Counter32, t11FspfLsrs Gauge32, t11FspfCreateTime T11FspfLastCreationTime, t11FspfAdminStatus INTEGER, Expires February 2006 [Page 11] Internet Draft Fibre-Channel FSPF MIB August 2005 t11FspfOperStatus INTEGER, t11FspfLsrNumber Unsigned32, t11FspfNbrStateChangNotifyEnable TruthValue, t11FspfSetToDefault INTEGER } t11FspfFabricIndex OBJECT-TYPE SYNTAX T11FabricIndex MAX-ACCESS not-accessible STATUS current DESCRIPTION "A unique index value which uniquely identifies a particular Fabric. In a Fabric conformant to FC-SW-3, only a single Fabric can operate within a physical infrastructure, and thus, the value of this Fabric Index will always be 1. 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." ::= { t11FspfEntry 1 } t11FspfARegionNum OBJECT-TYPE SYNTAX T11FspfARegionNum MAX-ACCESS read-write STATUS current DESCRIPTION "The AR number of this switch in this Fabric." REFERENCE "FC-SW-4, section D.3.1." DEFVAL {0} ::= { t11FspfEntry 2 } 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 Expires February 2006 [Page 12] Internet Draft Fibre-Channel FSPF MIB August 2005 interval is discarded." REFERENCE "FC-SW-4, sections 8.6.4.5 & 13.1." DEFVAL {1000} ::= { t11FspfEntry 4 } 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 "FC-SW-4, section 13.1." DEFVAL {5000} ::= { t11FspfEntry 5 } 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 "FC-SW-4, sections 8.5.1 & 13.1." DEFVAL {30} ::= { t11FspfEntry 6 } t11FspfMaxAge OBJECT-TYPE SYNTAX Unsigned32 UNITS "Minutes" MAX-ACCESS read-only STATUS current DESCRIPTION "The maximum age an LSR will be retained in the FSPF database on this Fabric. An LSR is removed from the database after MaxAge is reached." REFERENCE "FC-SW-4, section 13.1." DEFVAL {60} ::= { t11FspfEntry 7 } t11FspfMaxAgeDiscards OBJECT-TYPE SYNTAX Counter32 Expires February 2006 [Page 13] Internet Draft Fibre-Channel FSPF MIB August 2005 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of LSRs discarded due to their age reaching t11FspfMaxAge in this Fabric since the time indicated by t11FspfCreateTime." ::= { t11FspfEntry 8 } t11FspfPathComputations OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times that the path computation algorithm has been invoked by this Switch on this Fabric to compute a set of minimum cost paths for this Fabric since the time indicated by t11FspfCreateTime." REFERENCE "FC-SW-4, section 8.1.1." ::= { t11FspfEntry 9 } t11FspfChecksumErrors OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of FSPF checksum errors which were detected locally (and therefore discarded) on this Fabric since the time indicated by t11FspfCreateTime." REFERENCE "FC-SW-4, section 8.5.4." ::= { t11FspfEntry 10 } t11FspfLsrs OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "The current number of entries for this Fabric in the t11FspfLsrTable." ::= { t11FspfEntry 19 } t11FspfCreateTime OBJECT-TYPE SYNTAX T11FspfLastCreationTime MAX-ACCESS read-only STATUS current DESCRIPTION Expires February 2006 [Page 14] Internet Draft Fibre-Channel FSPF MIB August 2005 "The value of sysUpTime when this entry was last created." ::= { t11FspfEntry 20 } t11FspfAdminStatus OBJECT-TYPE SYNTAX INTEGER { up(1), down(2) } MAX-ACCESS read-write STATUS current DESCRIPTION "The desired state of FSPF in this Fabric. If value of this object is set to 'up', then FSPF is enabled in this Fabric. If set to 'down', then FSPF is disabled in this Fabric -- when FSPF is disabled, FSPF provides no routes to be included in the T11-FC-ROUTE-MIB module. (see [FC-RTM-MIB])." REFERENCE "[FC-RTM-MIB] - The Fibre-Channel Routing Information MIB, T11-FC-ROUTE-MIB." DEFVAL {up} ::= { t11FspfEntry 21 } t11FspfOperStatus OBJECT-TYPE SYNTAX INTEGER { up(1), down(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "State of FSPF in this Fabric. If 't11FspfAdminStatus' is 'down' then the 't11FspfOperStatus' should be 'down'. If 't11FspfAdminStatus' is changed to 'up' then 't11FspfOperStatus' should change to 'up' as and when FSPF is active in this Fabric." ::= { t11FspfEntry 22 } t11FspfLsrNumber OBJECT-TYPE SYNTAX Unsigned32 (0..2147483647) MAX-ACCESS read-only STATUS current DESCRIPTION "The current number of rows for this fabric in the t11FspfLsrTable." ::= { t11FspfEntry 23 } Expires February 2006 [Page 15] Internet Draft Fibre-Channel FSPF MIB August 2005 t11FspfNbrStateChangNotifyEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "Specifies whether or not the local agent should issue the notification 't11FspfNbrStateChangNotify' when the local switch learns of a change of state in the FSPF Neighbor Finite State Machine on an interface in this Fabric. If the value of the object is 'true, then the notification is generated. If the value is 'false', notification is not generated." DEFVAL { false } ::= { t11FspfEntry 24 } t11FspfSetToDefault OBJECT-TYPE SYNTAX INTEGER { default(1), noOp(2) } MAX-ACCESS read-write STATUS current DESCRIPTION "Setting this value to 'default' changes the value of each and every write-able object in this row to its default value. No action is taken if this object is set to 'noOp'. The value of the object when read is always 'noOp'." ::= { t11FspfEntry 25 } -- -- t11FspfIfTable t11FspfIfTable OBJECT-TYPE SYNTAX SEQUENCE OF T11FspfIfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table allows the users to configure and monitor the FSPF parameters which are per-interface (identified by a t11FspfIfIndex value), per-Fabric (identified by a t11FspfFabricIndex value), and per-switch (identified by Expires February 2006 [Page 16] Internet Draft Fibre-Channel FSPF MIB August 2005 values of fcmInstanceIndex and fcmSwitchIndex). An entry is automatically created in this table when an E_Port becomes non-isolated in a particular Fabric. An entry is automatically deleted from this table if: a) the corresponding interface is no longer an E_Port (e.g., a G_Port which is dynamically determined to be an F_Port), and all configurable parameters have default values; or b) the interface identified by t11FspfIfIndex no longer exists (e.g., because a line-card is physically removed); or c) the corresponding row in the t11FspfTable is deleted. Creating an entry in this table via t11FspfIfRowStatus provides the means to specify non-default parameter value(s) for an interface at a time when the relevant row in this table does not exist because the interface is either down or it is not an E_Port, but the corresponding row in the t11FspfTable must already exist." ::= { t11FspfConfiguration 2 } t11FspfIfEntry OBJECT-TYPE SYNTAX T11FspfIfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry containing FSPF information for the interface identified by t11FspfIfIndex, on the fabric identified by t11FspfFabricIndex, on the switch identified by fcmSwitchIndex." INDEX { fcmInstanceIndex, fcmSwitchIndex, t11FspfFabricIndex, t11FspfIfIndex } ::= { t11FspfIfTable 1 } T11FspfIfEntry ::= SEQUENCE { t11FspfIfIndex InterfaceIndex, t11FspfIfHelloInterval Unsigned32, t11FspfIfDeadInterval Unsigned32, t11FspfIfRetransmitInterval Unsigned32, t11FspfIfInLsuPkts Counter32, t11FspfIfInLsaPkts Counter32, t11FspfIfOutLsuPkts Counter32, t11FspfIfOutLsaPkts Counter32, t11FspfIfOutHelloPkts Counter32, Expires February 2006 [Page 17] Internet Draft Fibre-Channel FSPF MIB August 2005 t11FspfIfInHelloPkts Counter32, t11FspfIfRetransmittedLsuPkts Counter32, t11FspfIfInErrorPkts Counter32, t11FspfIfNbrState T11FspfInterfaceState, t11FspfIfNbrDomainId FcDomainIdOrZero, t11FspfIfNbrPortIndex Unsigned32, t11FspfIfAdminStatus INTEGER, t11FspfIfCreateTime T11FspfLastCreationTime, t11FspfIfSetToDefault INTEGER, t11FspfIfLinkCostFactor Unsigned32, t11FspfIfStorageType StorageType, t11FspfIfRowStatus RowStatus } t11FspfIfIndex OBJECT-TYPE SYNTAX InterfaceIndex MAX-ACCESS not-accessible STATUS current DESCRIPTION "The value of ifIndex which identifies the local Fibre Channel interface for which this entry contains FSPF information." ::= { t11FspfIfEntry 1 } t11FspfIfHelloInterval OBJECT-TYPE SYNTAX Unsigned32 (1..65535) UNITS "Seconds" MAX-ACCESS read-create STATUS current DESCRIPTION "Interval between the periodic HELLO messages sent on this interface in this Fabric to verify the link health. Note that this value must be same at both ends of a link in this Fabric." DEFVAL {20} ::= { t11FspfIfEntry 2 } t11FspfIfDeadInterval OBJECT-TYPE SYNTAX Unsigned32 (2..65535) UNITS "Seconds" MAX-ACCESS read-create STATUS current DESCRIPTION "Maximum time for which no HELLO messages can be received on this interface in this Fabric. After this time, the Expires February 2006 [Page 18] Internet Draft Fibre-Channel FSPF MIB August 2005 interface is assumed to be broken and removed from the database. Note that this value must be greater than the HELLO interval specified on this interface in this Fabric." DEFVAL {80} ::= { t11FspfIfEntry 3 } t11FspfIfRetransmitInterval OBJECT-TYPE SYNTAX Unsigned32 (1..65535) UNITS "Seconds" MAX-ACCESS read-create STATUS current DESCRIPTION "The time after which an unacknowledged LSR is retransmitted on this interface in this Fabric." DEFVAL {5} ::= { t11FspfIfEntry 4 } t11FspfIfInLsuPkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Link State Update (LSU) packets received on this interface in this Fabric since the time indicated by t11FspfCreateTime." ::= { t11FspfIfEntry 5 } t11FspfIfInLsaPkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Link State Acknowledgement (LSA) packets received on this interface in this Fabric since the time indicated by t11FspfCreateTime." ::= { t11FspfIfEntry 6 } t11FspfIfOutLsuPkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Link State Update (LSU) packets transmitted on this interface in this Fabric since the time indicated by t11FspfCreateTime." Expires February 2006 [Page 19] Internet Draft Fibre-Channel FSPF MIB August 2005 ::= { t11FspfIfEntry 7 } t11FspfIfOutLsaPkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Link State Acknowledgement (LSA) packets transmitted on this interface in this Fabric since the time indicated by t11FspfCreateTime." ::= { t11FspfIfEntry 8 } t11FspfIfOutHelloPkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of HELLO packets transmitted on this interface in this Fabric since the time indicated by t11FspfCreateTime." ::= { t11FspfIfEntry 9 } t11FspfIfInHelloPkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of HELLO packets received on this interface in this Fabric since the time indicated by t11FspfCreateTime." ::= { t11FspfIfEntry 10 } t11FspfIfRetransmittedLsuPkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of LSU packets which contained one or more retransmitted LSRs, and which were transmitted on this interface in this Fabric since the time indicated by t11FspfCreateTime." ::= { t11FspfIfEntry 11 } t11FspfIfInErrorPkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current Expires February 2006 [Page 20] Internet Draft Fibre-Channel FSPF MIB August 2005 DESCRIPTION "Number of invalid FSPF control packets received on this interface in this Fabric since the time indicated by t11FspfCreateTime." ::= { t11FspfIfEntry 12 } t11FspfIfNbrState OBJECT-TYPE SYNTAX T11FspfInterfaceState MAX-ACCESS read-only STATUS current DESCRIPTION "The state of FSPF's 'neighbor state machine', which is the operational state of the interaction with the neighbor's interface which is connected to this interface. If the 't11FspfIfAdminStatus' is 'down', then this object should be 'down'. If the 't11FspfIfAdminStatus' is 'up' then this object's value depends on the state of FSPF's 'neighbor state machine' on this interface in this Fabric." REFERENCE "FC-SW-4, section 8.7" ::= { t11FspfIfEntry 13 } t11FspfIfNbrDomainId OBJECT-TYPE SYNTAX FcDomainIdOrZero MAX-ACCESS read-only STATUS current DESCRIPTION "The Domain Id of the neighbor in this Fabric." ::= { t11FspfIfEntry 14 } t11FspfIfNbrPortIndex OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS read-only STATUS current DESCRIPTION "The index, as known by the neighbor, of the neighbor's interface which is connected to this interface in this Fabric." REFERENCE "FC-SW-4, section 6.1.9.4." ::= { t11FspfIfEntry 15 } t11FspfIfAdminStatus OBJECT-TYPE SYNTAX INTEGER { up(1), Expires February 2006 [Page 21] Internet Draft Fibre-Channel FSPF MIB August 2005 down(2) } MAX-ACCESS read-create STATUS current DESCRIPTION "The desired state of FSPF on this interface in this Fabric, whenever 't11FspfAdminStatus' is 'up'. If value of this object is set to 'up', then FSPF is enabled on this interface in this Fabric. If set to 'down', then FSPF is disabled on this interface in this Fabric. Note that the operational state of FSPF on an interface is given by t11FspfIfNbrState." DEFVAL {up} ::= { t11FspfIfEntry 16 } t11FspfIfCreateTime OBJECT-TYPE SYNTAX T11FspfLastCreationTime MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime when this entry was last created." ::= { t11FspfIfEntry 17 } t11FspfIfSetToDefault OBJECT-TYPE SYNTAX INTEGER { default(1), noOp(2) } MAX-ACCESS read-create STATUS current DESCRIPTION "Setting this value to 'default' changes the value of each and every write-able object in this row to its default value. If all the configuration parameters have their default values and if the interface is down, then the row is deleted automatically. No action is taken if this object is set to 'noOp'. The value of the object when read is always 'noOp'." ::= { t11FspfIfEntry 18 } t11FspfIfLinkCostFactor OBJECT-TYPE Expires February 2006 [Page 22] Internet Draft Fibre-Channel FSPF MIB August 2005 SYNTAX Unsigned32 (1..65535) MAX-ACCESS read-create STATUS current DESCRIPTION "The administrative factor used in calculating the cost of sending a frame on this interface in this Fabric. The formula is used to calculate the link cost is: Link Cost = S * (1.0625e12 / ifSpeed) where: S = (the value of this object / 100) ifSpeed = interface speed (as defined in the IF-MIB). " REFERENCE "FC-SW-4, section 8.5.5; IF-MIB is defined in RFC 2863." DEFVAL { 100 } ::= { t11FspfIfEntry 19 } t11FspfIfStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-create STATUS current DESCRIPTION "The storage type for this conceptual row. Conceptual rows having the value 'permanent' need not allow write-access to any columnar objects in the row." DEFVAL { nonVolatile } ::= { t11FspfIfEntry 20 } t11FspfIfRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of the conceptual row. This object can be used to create an entry only if there is an entry in the t11FspfTable for the corresponding Fabric, and the interface is either isolated or is a non-E_port. Setting this object to 'destroy' will typically fail; to reverse the creation process, set the corresponding Expires February 2006 [Page 23] Internet Draft Fibre-Channel FSPF MIB August 2005 instance of t11FspfIfSetToDefault to 'default'." ::= { t11FspfIfEntry 21 } -- -- t11FspfLsrTable t11FspfLsrTable OBJECT-TYPE SYNTAX SEQUENCE OF T11FspfLsrEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table is the database of all of the latest incarnations of the Link State Records (LSRs) which are currently contained in the topology database, for all interfaces on all Fabrics known to locally-managed switches. A Fabric's topology database contains the LSRs which have been either issued or received by a local switch on that Fabric, and which have not reached t11FspfMaxAge." ::= { t11FspfDatabase 1 } t11FspfLsrEntry OBJECT-TYPE SYNTAX T11FspfLsrEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This gives information for the most recent update of an LSR. There is one entry for every LSR issued or received by a locally-managed switch (identified by fcmInstanceIndex and fcmSwitchIndex) in a Fabric (identified by t11FspfFabricIndex)." INDEX { fcmInstanceIndex, fcmSwitchIndex, t11FspfFabricIndex, t11FspfLsrDomainId, t11FspfLsrType } ::= { t11FspfLsrTable 1 } T11FspfLsrEntry ::= SEQUENCE { t11FspfLsrDomainId FcDomainIdOrZero, t11FspfLsrType T11FspfLsrType, t11FspfLsrAdvDomainId FcDomainIdOrZero, t11FspfLsrAge Unsigned32, t11FspfLsrIncarnationNumber Unsigned32, t11FspfLsrCheckSum Unsigned32, t11FspfLsrLinks Unsigned32 } Expires February 2006 [Page 24] Internet Draft Fibre-Channel FSPF MIB August 2005 t11FspfLsrDomainId OBJECT-TYPE SYNTAX FcDomainIdOrZero MAX-ACCESS not-accessible STATUS current DESCRIPTION "Domain Id of the LSR owner in this Fabric. It is the Link State Id of this LSR." ::= { t11FspfLsrEntry 1 } t11FspfLsrType OBJECT-TYPE SYNTAX T11FspfLsrType MAX-ACCESS not-accessible STATUS current DESCRIPTION "Type of this LSR." ::= { t11FspfLsrEntry 2 } t11FspfLsrAdvDomainId OBJECT-TYPE SYNTAX FcDomainIdOrZero MAX-ACCESS read-only STATUS current DESCRIPTION "Domain Id of the switch that is advertising the LSR on the behalf of the switch owning it." ::= { t11FspfLsrEntry 3 } t11FspfLsrAge OBJECT-TYPE SYNTAX Unsigned32 (0..65535) UNITS "Seconds" MAX-ACCESS read-only STATUS current DESCRIPTION "The time since this LSR was inserted into the database." ::= { t11FspfLsrEntry 4 } t11FspfLsrIncarnationNumber OBJECT-TYPE SYNTAX Unsigned32 (0..4294967295) MAX-ACCESS read-only STATUS current DESCRIPTION "The link state incarnation number of this LSR. This is used to identify most recent instance of an LSR while updating the topology database when an LSR is received. The updating of an LSR includes incrementing its incarnation number prior to transmission of the updated Expires February 2006 [Page 25] Internet Draft Fibre-Channel FSPF MIB August 2005 LSR. So, the most recent LSR is the one with the largest incarnation number." ::= { t11FspfLsrEntry 5 } t11FspfLsrCheckSum OBJECT-TYPE SYNTAX Unsigned32 (0..65535) MAX-ACCESS read-only STATUS current DESCRIPTION "The checksum of the LSR." ::= { t11FspfLsrEntry 6 } t11FspfLsrLinks OBJECT-TYPE SYNTAX Unsigned32 (0..65355) MAX-ACCESS read-only STATUS current DESCRIPTION "Number of entries in the t11FspfLinkTable associated with this LSR." ::= { t11FspfLsrEntry 7 } -- -- t11FspfLinkTable t11FspfLinkNumber OBJECT-TYPE SYNTAX Unsigned32 (0..2147483647) MAX-ACCESS read-only STATUS current DESCRIPTION "The number of rows in the t11FspfLinkTable." ::= { t11FspfDatabase 3 } t11FspfLinkTable OBJECT-TYPE SYNTAX SEQUENCE OF T11FspfLinkEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains the list of Inter-Switch Links and their information which is part of an LSR, either received or transmitted." ::= { t11FspfDatabase 4 } t11FspfLinkEntry OBJECT-TYPE SYNTAX T11FspfLinkEntry MAX-ACCESS not-accessible Expires February 2006 [Page 26] Internet Draft Fibre-Channel FSPF MIB August 2005 STATUS current DESCRIPTION "An entry which contains information about a link contained in an LSR in this Fabric. An entry is created whenever a new link appears in an (issued or received) LSR. An entry is deleted when a link no longer appears in an (issued or received) LSR." INDEX { fcmInstanceIndex, fcmSwitchIndex, t11FspfFabricIndex, t11FspfLsrDomainId, t11FspfLsrType, t11FspfLinkIndex} ::= { t11FspfLinkTable 1 } T11FspfLinkEntry ::= SEQUENCE { t11FspfLinkIndex Unsigned32, t11FspfLinkNbrDomainId FcDomainIdOrZero, t11FspfLinkPortIndex Unsigned32, t11FspfLinkNbrPortIndex Unsigned32, t11FspfLinkType T11FspfLinkType, t11FspfLinkCost Integer32 } t11FspfLinkIndex OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS not-accessible STATUS current DESCRIPTION "An arbitrary index of this link." ::= { t11FspfLinkEntry 1 } t11FspfLinkNbrDomainId OBJECT-TYPE SYNTAX FcDomainIdOrZero MAX-ACCESS read-only STATUS current DESCRIPTION "The Domain Id of the neighbor on the other end of this link in this Fabric." ::= { t11FspfLinkEntry 2 } t11FspfLinkPortIndex OBJECT-TYPE SYNTAX Unsigned32 (0..16777215) MAX-ACCESS read-only STATUS current DESCRIPTION "The source E_port of this link, as indicated by the index value in the LSR received from the switch identified by 't11FspfLsrDomainId'." Expires February 2006 [Page 27] Internet Draft Fibre-Channel FSPF MIB August 2005 ::= { t11FspfLinkEntry 3 } t11FspfLinkNbrPortIndex OBJECT-TYPE SYNTAX Unsigned32 (0..16777215) MAX-ACCESS read-only STATUS current DESCRIPTION "The destination E_port of this link, as indicated by the index value in the LSR received from the switch identified by 't11FspfLinkNbrDomainId'." ::= { t11FspfLinkEntry 4 } t11FspfLinkType OBJECT-TYPE SYNTAX T11FspfLinkType MAX-ACCESS read-only STATUS current DESCRIPTION "The type of this link." ::= { t11FspfLinkEntry 5 } t11FspfLinkCost OBJECT-TYPE SYNTAX Integer32 (0..65535) MAX-ACCESS read-only STATUS current DESCRIPTION "The cost of sending a frame on this link in this Fabric. Link cost is calculated using a formula: link cost = S * (1.0625e12 / Signalling Rate) For issued LSRs, S is determined by the value of t11FspfIfLinkCostFactor for the corresponding interface and Fabric." ::= { t11FspfLinkEntry 6 } -- -- Notification-related object t11FspfIfPrevNbrState OBJECT-TYPE SYNTAX T11FspfInterfaceState MAX-ACCESS accessible-for-notify STATUS current DESCRIPTION "The previous state of FSPF's Neighbor Finite State Machine on an interface. Expires February 2006 [Page 28] Internet Draft Fibre-Channel FSPF MIB August 2005 This object is only used in the 't11FspfNbrStateChangNotify' notification." ::= { t11FspfConfiguration 3 } -- -- Notifications t11FspfNbrStateChangNotify NOTIFICATION-TYPE OBJECTS { ifIndex, t11FamConfigDomainId, t11FspfIfNbrDomainId, t11FspfIfNbrState, t11FspfIfPrevNbrState } STATUS current DESCRIPTION "This notification signifies that there has been a change in the state of an FSPF neighbor. This is generated when the FSPF state changes to a terminal state, either through regression (i.e., goes from Full to Init or Down) or progression (i.e., from any state to Full). The value of 't11FspfIfNbrState' is the state of the neighbor after the change." ::= { t11FspfNotifications 1 } -- -- Conformance t11FspfMIBCompliances OBJECT IDENTIFIER ::= { t11FspfConformance 1 } t11FspfMIBGroups OBJECT IDENTIFIER ::= { t11FspfConformance 2 } t11FspfMIBCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for entities which implement the FSPF." MODULE -- this module MANDATORY-GROUPS { t11FspfGeneralGroup, t11FspfIfGroup, t11FspfDatabaseGroup, t11FspfNotificationGroup } Expires February 2006 [Page 29] Internet Draft Fibre-Channel FSPF MIB August 2005 GROUP t11FspfIfCounterGroup DESCRIPTION "These counters, for particular FSPF-packet occurrences on an interface, are mandatory only for those systems which count such events." OBJECT t11FspfIfRowStatus SYNTAX INTEGER { active(1) } MIN-ACCESS read-only DESCRIPTION "Write access is not required, and so, only one value need to be supported." OBJECT t11FspfIfStorageType MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11FspfNbrStateChangNotifyEnable MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11FspfARegionNum MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11FspfMinLsArrival MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11FspfMinLsInterval MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11FspfAdminStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11FspfSetToDefault MIN-ACCESS read-only Expires February 2006 [Page 30] Internet Draft Fibre-Channel FSPF MIB August 2005 DESCRIPTION "Write access is not required." OBJECT t11FspfIfHelloInterval MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11FspfIfDeadInterval MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11FspfIfRetransmitInterval MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11FspfIfAdminStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11FspfIfSetToDefault MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11FspfIfLinkCostFactor MIN-ACCESS read-only DESCRIPTION "Write access is not required." ::= { t11FspfMIBCompliances 1 } -- Units of Conformance t11FspfGeneralGroup OBJECT-GROUP OBJECTS { t11FspfARegionNum, t11FspfMinLsArrival, t11FspfMinLsInterval, t11FspfLsRefreshTime, t11FspfMaxAge, t11FspfMaxAgeDiscards, t11FspfPathComputations, Expires February 2006 [Page 31] Internet Draft Fibre-Channel FSPF MIB August 2005 t11FspfChecksumErrors, t11FspfLsrs, t11FspfCreateTime, t11FspfAdminStatus, t11FspfOperStatus, t11FspfLsrNumber, t11FspfNbrStateChangNotifyEnable, t11FspfSetToDefault } STATUS current DESCRIPTION "A collection of objects for displaying and configuring FSPF parameters." ::= { t11FspfMIBGroups 1 } t11FspfIfGroup OBJECT-GROUP OBJECTS { t11FspfIfHelloInterval, t11FspfIfDeadInterval, t11FspfIfRetransmitInterval, t11FspfIfNbrState, t11FspfIfNbrDomainId, t11FspfIfNbrPortIndex, t11FspfIfAdminStatus, t11FspfIfCreateTime, t11FspfIfSetToDefault, t11FspfIfLinkCostFactor, t11FspfIfRowStatus, t11FspfIfStorageType, t11FspfIfPrevNbrState } STATUS current DESCRIPTION "A collection of objects for displaying the FSPF interface information." ::= { t11FspfMIBGroups 2 } t11FspfIfCounterGroup OBJECT-GROUP OBJECTS { t11FspfIfInLsuPkts, t11FspfIfInLsaPkts, t11FspfIfOutLsuPkts, t11FspfIfOutLsaPkts, t11FspfIfOutHelloPkts, t11FspfIfInHelloPkts, t11FspfIfRetransmittedLsuPkts, t11FspfIfInErrorPkts } STATUS current DESCRIPTION Expires February 2006 [Page 32] Internet Draft Fibre-Channel FSPF MIB August 2005 "A collection of objects for counting particular FSPF-packet occurrences on an interface." ::= { t11FspfMIBGroups 3 } t11FspfDatabaseGroup OBJECT-GROUP OBJECTS { t11FspfLsrAdvDomainId, t11FspfLsrAge, t11FspfLsrIncarnationNumber, t11FspfLsrCheckSum, t11FspfLsrLinks, t11FspfLinkNbrDomainId, t11FspfLinkPortIndex, t11FspfLinkNbrPortIndex, t11FspfLinkType, t11FspfLinkCost, t11FspfLinkNumber } STATUS current DESCRIPTION "A collection of objects for displaying the FSPF topology database information." ::= { t11FspfMIBGroups 4 } t11FspfNotificationGroup NOTIFICATION-GROUP NOTIFICATIONS { t11FspfNbrStateChangNotify } STATUS current DESCRIPTION "A collection of notifications for FSPF." ::= { t11FspfMIBGroups 5 } END Expires February 2006 [Page 33] Internet Draft Fibre-Channel FSPF MIB August 2005 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 document was originally developed and approved by the INCITS Task Group T11.5. 9. Normative References [RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M. and S. Waldbusser, "Structure of Management Information Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. [RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M. and S. Waldbusser, "Textual Conventions for SMIv2", STD 58, RFC 2579, April 1999. [RFC2580] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M. and S. Waldbusser, "Conformance Statements for SMIv2", STD 58, RFC 2580, April 1999. Expires February 2006 [Page 34] Internet Draft Fibre-Channel FSPF MIB August 2005 [RFC2863] McCloghrie, K., and F. Kastenholz, "The Interface$ Group MIB", RFC 2863, June 2000. [RFC3411] Harrington, D., Presuhn, R., and B. Wijnen, "An Architecture for Describing Simple Network Management Protocol (SNMP) Management Frameworks", STD 58, RFC 3411, December 2002. [FC-FS] "Fibre Channel - Framing and Signaling (FC-FS)" ANSI INCITS 373-2003, April 2003. [FC-SW-3] "Fibre Channel - Switch Fabric - 3 (FC-SW-3)", ANSI INCITS 384-2004, January 2004. [FC-SW-4] "Fibre Channel - Switch Fabric - 4 (FC-SW-4)", ANSI NCITS xxx-xxxx, T11/Project 1674-D/Rev 7.4, May 2005. [FC-MGMT] K. McCloghrie, "Fibre Channel Management MIB", RFC 4044, May 2005. [FC-FAM-MIB] DeSanti, C., Gaonkar, V., McCloghrie, K., and S. Gai, "Fibre- Channel Fabric Address Manager MIB", Internet-Draft (draft-ietf- imss-fc-fam-mib-nn.txt), work-in-progress. [FC-RTM-MIB] DeSanti, C., Kode, S., McCloghrie, K., and S. Gai, "Fibre-Channel Routing Information MIB", Internet-Draft (draft-ietf-imss-fc-rtm- mib-nn.txt), work-in-progress. 10. Informative References [RFC2837] Teow, K., "Definitions of Managed Objects for the Fabric Element in Fibre Channel Standard", RFC 2837, May 2000. [RFC3410] Case, J., Mundy, R., Partain, D. and B. Stewart, "Introduction and Applicability Statements for Internet- Standard Management Framework", RFC 3410, December 2002. Expires February 2006 [Page 35] Internet Draft Fibre-Channel FSPF MIB August 2005 11. IANA Considerations IANA is requested to make the OID assignment for the MIB module under the appropriate subtree. 12. Security Considerations There are several management objects defined in this MIB module with a MAX-ACCESS clause of read-write and/or read-create. 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. These objects and their sensitivity/vulnerability are: t11FspfARegionNum, t11FspfMinLsArrival, t11FspfMinLsInterval, t11FspfIfHelloInterval, t11FspfIfDeadInterval & t11FspfIfRetransmitInterval -- alter the responsiveness of the FSPF protocol t11FspfAdminStatus & t11FspfIfAdminStatus -- enable/disable dynamic routing via FSPF t11FspfSetToDefault & t11FspfIfSetToDefault -- nullify valid configuration changes t11FspfIfLinkCostFactor -- alter the choice of links t11FspfNbrStateChangNotifyEnable -- enable/disable notifications. The support for SET operations in a non-secure environment without proper protection can have a negative effect on network operations. Some of the readable objects in this MIB module (i.e., objects with a MAX-ACCESS other than not-accessible) may be considered sensitive or vulnerable in some network environments. It is thus important to control even GET and/or NOTIFY access to these objects and possibly to even encrypt the values of these objects when sending them over the network via SNMP. These are the tables and objects and their sensitivity/vulnerability: t11FspfTable -- contains per-Fabric parameters and statistics Expires February 2006 [Page 36] Internet Draft Fibre-Channel FSPF MIB August 2005 t11FspfIfTable -- contains per-interface parameters and statistics t11FspfLsrTable & t11FspfLinkTable -- database of LSR information, SNMP versions prior to SNMPv3 did not include adequate security. Even if the network itself is secure (for example by using IPSec), even then, there is no control as to who on the secure network is allowed to access and GET/SET (read/change/create/delete) the objects in this MIB module. It is RECOMMENDED that implementors consider the security features as provided by the SNMPv3 framework (see [RFC3410], section 8), including full support for the SNMPv3 cryptographic mechanisms (for authentication and privacy). Further, deployment of SNMP versions prior to SNMPv3 is NOT RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to enable cryptographic security. It is then a customer/operator responsibility to ensure that the SNMP entity giving access to an instance of this MIB module is properly configured to give access to the objects only to those principals (users) that have legitimate rights to indeed GET or SET (change/create/delete) them. 13. Authors' Addresses Claudio DeSanti Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134 USA Phone: +1 408 853-9172 EMail: cds@cisco.com Vinay Gaonkar Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134 USA Phone: +1 408 527-8576 EMail: vgaonkar@cisco.com Keith McCloghrie Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA USA 95134 Phone: +1 408-526-5260 Expires February 2006 [Page 37] Internet Draft Fibre-Channel FSPF MIB August 2005 Email: kzm@cisco.com Silvano Gai Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA USA 95134 Phone: +1 408-526-7269 Email: sgai@cisco.com 14. Full Copyright Statement Copyright (C) The Internet Society (2005). This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights. "This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE." 15. Disclaimer of validity The IETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79. Copies of IPR disclosures made to the IETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementors or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement Expires February 2006 [Page 38] Internet Draft Fibre-Channel FSPF MIB August 2005 this standard. Please address the information to the IETF at ietf-ipr@ietf.org. Acknowledgment Funding for the RFC Editor function is currently provided by the Internet Society. Expires February 2006 [Page 39]