t11FspfLsrIncarnationNumber Unsigned32,
t11FspfLsrCheckSum Unsigned32,
t11FspfLsrLinks Unsigned32
}
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
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 that is part of an LSR, either
received or transmitted."
::= { t11FspfDatabase 4 }
t11FspfLinkEntry OBJECT-TYPE
SYNTAX T11FspfLinkEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry that 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 (1..4294967295)
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’."
::= { 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 the 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.
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, through either
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 that
implement the FSPF."
MODULE -- this module
MANDATORY-GROUPS { t11FspfGeneralGroup,
t11FspfIfGroup,
t11FspfDatabaseGroup,
t11FspfNotificationGroup }
GROUP t11FspfIfCounterGroup
DESCRIPTION
"These counters, for particular FSPF-packet
occurrences on an interface, are mandatory only
for those systems that count such events."
OBJECT t11FspfIfRowStatus
SYNTAX INTEGER { active(1) }
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required, so only
one value needs 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 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
DESCRIPTION
"Write access is not required."
OBJECT t11FspfStorageType
MIN-ACCESS read-only
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 { t11FspfMinLsArrival,
t11FspfMinLsInterval,
t11FspfLsRefreshTime,
t11FspfMaxAge,
t11FspfMaxAgeDiscards,
t11FspfPathComputations,
t11FspfChecksumErrors,
t11FspfLsrs,
t11FspfCreateTime,
t11FspfAdminStatus,
t11FspfOperStatus,
t11FspfNbrStateChangNotifyEnable,
t11FspfSetToDefault,
t11FspfStorageType }
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
"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
7. Acknowledgements
This document was originally developed and approved by the INCITS
Task Group T11.5 (http://www.t11.org) as the SM-FSM project. We wish
to acknowledge the many contributions and comments from the INCITS
Technical Committee T11, including the following:
T11 Chair: Robert Snively, Brocade
T11 Vice Chair: Claudio DeSanti, Cisco Systems
T11.5 Chair: Roger Cummings, Symantec
T11.5 members, especially:
Ken Hirata, Emulex
Scott Kipp, McData
Elizabeth G. Rodriguez, Dot Hill
The document was subsequently approved by the IETF’s IMSS Working
Group, chaired by David Black (EMC Corporation). We also wish to
acknowledge Bert Wijnen (Lucent Technologies), the IETF Area
Director, for his review of the document.
8. IANA Considerations
The IANA assigned a MIB OID for the T11-FC-FSPF-MIB module under the
appropriate subtree.
9. 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:
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
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.
10. Normative References
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[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.
[RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group
MIB", RFC 2863, June 2000.
[RFC3411] Harrington, D., Presuhn, R., and B. Wijnen, "An
Architecture for Describing Simple Network Management
Protocol (SNMP) Management Frameworks", STD 62, RFC 3411,
December 2002.
[FC-FS] "Fibre Channel - Framing and Signaling (FC-FS)" ANSI
INCITS 373-2003, April 2003.
[FC-SW-4] "Fibre Channel - Switch Fabric - 4 (FC-SW-4)", ANSI INCITS
418-2006, 2006.
[FC-MGMT] McCloghrie, K., "Fibre Channel Management MIB", RFC 4044,
May 2005.
[RFC4439] DeSanti, C., Gaonkar, V., McCloghrie, K., and S. Gai,
"Fibre Channel Fabric Address Manager MIB", RFC 4439,
March 2006.
11. Informative References
[RFC2741] Daniele, M., Wijnen, B., Ellison, M., and D. Francisco,
"Agent Extensibility (AgentX) Protocol Version 1", RFC
2741, January 2000.
[RFC4044] McCloghrie, K., "Fibre Channel Management MIB", RFC 4044,
May 2005.
[RFC3410] Case, J., Mundy, R., Partain, D. and B. Stewart,
"Introduction and Applicability Statements for Internet-
Standard Management Framework", RFC 3410, December 2002.
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
EMail: kzm@cisco.com
Silvano Gai
Retired
Full Copyright Statement
Copyright (C) The Internet Society (2006).
This document is subject to the rights, licenses and restrictions
contained in BCP 78, and except as set forth therein, the authors
retain all their rights.
This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Intellectual Property
The IETF takes no position regarding the validity or scope of any
Intellectual Property Rights or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; nor does it represent that it has
made any independent effort to identify any such rights. Information
on the procedures with respect to rights in RFC documents can be
found in BCP 78 and BCP 79.
Copies of IPR disclosures made to the IETF Secretariat and any
assurances of licenses to be made available, or the result of an
attempt made to obtain a general license or permission for the use of
such proprietary rights by implementers or users of this
specification can be obtained from the IETF on-line IPR repository at
http://www.ietf.org/ipr.
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights that may cover technology that may be required to implement
this standard. Please address the information to the IETF at
ietf-ipr@ietf.org.
Acknowledgement
Funding for the RFC Editor function is provided by the IETF
Administrative Support Activity (IASA).