idnits 2.17.1 draft-ietf-imss-fc-fspf-mib-03.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- ** It looks like you're using RFC 3978 boilerplate. You should update this to the boilerplate described in the IETF Trust License Policy document (see https://trustee.ietf.org/license-info), which is required now. -- Found old boilerplate from RFC 3978, Section 5.1 on line 16. -- Found old boilerplate from RFC 3978, Section 5.5 on line 1663. -- Found old boilerplate from RFC 3979, Section 5, paragraph 1 on line 1674. -- Found old boilerplate from RFC 3979, Section 5, paragraph 2 on line 1681. -- Found old boilerplate from RFC 3979, Section 5, paragraph 3 on line 1687. ** The document seems to lack an RFC 3978 Section 5.4 (updated by RFC 4748) Copyright Line. ** The document seems to lack an RFC 3978 Section 5.4 Reference to BCP 78. ** This document has an original RFC 3978 Section 5.5 Disclaimer, instead of the newer disclaimer which includes the IETF Trust according to RFC 4748. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- == No 'Intended status' indicated for this document; assuming Proposed Standard Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** The document seems to lack a both a reference to RFC 2119 and the recommended RFC 2119 boilerplate, even if it appears to use RFC 2119 keywords. RFC 2119 keyword, line 1612: '... It is RECOMMENDED that implementors...' RFC 2119 keyword, line 1618: '... RECOMMENDED. Instead, it is RECOMM...' Miscellaneous warnings: ---------------------------------------------------------------------------- -- The document seems to lack a disclaimer for pre-RFC5378 work, but may have content which was first submitted before 10 November 2008. If you have contacted all the original authors and they are all willing to grant the BCP78 rights to the IETF Trust, then this is fine, and you can ignore this comment. If not, you may need to add the pre-RFC5378 disclaimer. (See the Legal Provisions document at https://trustee.ietf.org/license-info for more information.) -- The document date (1 May 2006) is 6569 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) -- Possible downref: Non-RFC (?) normative reference: ref. 'FC-FS' -- Possible downref: Non-RFC (?) normative reference: ref. 'FC-SW-4' -- No information found for draft-ietf-imss-fc-fam-mib-nn - is the name correct? -- Possible downref: Normative reference to a draft: ref. 'FC-FAM-MIB' -- No information found for draft-ietf-imss-fc-rtm-mib-nn - is the name correct? -- Possible downref: Normative reference to a draft: ref. 'FC-RTM-MIB' -- Obsolete informational reference (is this intentional?): RFC 2837 (Obsoleted by RFC 4044) Summary: 5 errors (**), 0 flaws (~~), 1 warning (==), 14 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 1 Internet Draft C. DeSanti 2 V. Gaonkar 3 K. McCloghrie 4 Cisco Systems 5 S. Gai 6 1 May 2006 8 MIB for Fibre-Channel's Fabric Shortest Path First Protocol 9 draft-ietf-imss-fc-fspf-mib-03.txt 11 Status of this Memo 13 By submitting this Internet-Draft, each author represents that any 14 applicable patent or other IPR claims of which he or she is aware 15 have been or will be disclosed, and any of which he or she becomes 16 aware will be disclosed, in accordance with Section 6 of BCP 79. 18 Internet-Drafts are working documents of the Internet Engineering 19 Task Force (IETF), its areas, and its working groups. Note that 20 other groups may also distribute working documents as Internet- 21 Drafts. 23 Internet-Drafts are draft documents valid for a maximum of six months 24 and may be updated, replaced, or obsoleted by other documents at any 25 time. It is inappropriate to use Internet-Drafts as reference 26 material or to cite them other than as "work in progress". 28 The list of current Internet-Drafts can be accessed at 29 http://www.ietf.org/ietf/1id-abstracts.txt. 31 The list of Internet-Draft Shadow Directories can be accessed at 32 http://www.ietf.org/shadow.html. 34 Abstract 36 This memo defines a portion of the Management Information Base (MIB) 37 for use with network management protocols in the Internet community. 38 In particular, it describes managed objects for information related 39 to the Fibre Channel network's Fabric Shortest Path First (FSPF) 40 routing protocol. 42 Table of Contents 44 1 Introduction ................................................. 3 45 2 The Internet-Standard Management Framework ................... 3 46 3 Short Overview of Fibre Channel .............................. 3 47 4 Relationship to Other MIBs ................................... 5 48 5 MIB Overview ................................................. 6 49 5.1 Fibre Channel management instance .......................... 6 50 5.2 Switch Index ............................................... 6 51 5.3 Fabric Index ............................................... 6 52 5.4 The MIB Groups ............................................. 7 53 5.4.1 The t11FspfGeneralGroup group ............................ 7 54 5.4.2 The t11FspfIfGroup group ................................. 7 55 5.4.3 The t11FspfDatabaseGroup group ........................... 7 56 5.4.4 The t11FspfNotificationGroup group ....................... 7 57 6 The T11-FC-FSPF-MIB Module ................................... 8 58 7 Intellectual Property ........................................ 34 59 8 Acknowledgements ............................................. 34 60 9 Normative References ......................................... 35 61 10 Informative References ...................................... 36 62 11 IANA Considerations ......................................... 36 63 12 Security Considerations ..................................... 36 64 13 Authors' Addresses .......................................... 38 66 1. Introduction 68 This memo defines a portion of the Management Information Base (MIB) 69 for use with network management protocols in the Internet community. 70 In particular, it describes managed objects for information related 71 to the Fibre Channel network's Fabric Shortest Path First (FSPF) 72 routing protocol, which is specified in [FC-SW-4]. 74 2. The Internet-Standard Management Framework 76 For a detailed overview of the documents that describe the current 77 Internet-Standard Management Framework, please refer to section 7 of 78 RFC 3410 [RFC3410]. 80 Managed objects are accessed via a virtual information store, termed 81 the Management Information Base or MIB. MIB objects are generally 82 accessed through the Simple Network Management Protocol (SNMP). 83 Objects in the MIB are defined using the mechanisms defined in the 84 Structure of Management Information (SMI). This memo specifies a MIB 85 module that is compliant to the SMIv2, which is described in STD 58, 86 RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 87 [RFC2580]. 89 3. Short Overview of Fibre Channel 91 The Fibre Channel (FC) is logically a bidirectional point-to-point 92 serial data channel, structured for high performance. Fibre Channel 93 provides a general transport vehicle for higher level protocols such 94 as Small Computer System Interface (SCSI) command sets, the High- 95 Performance Parallel Interface (HIPPI) data framing, IP (Internet 96 Protocol), IEEE 802.2, and others. 98 Physically, Fibre Channel is an interconnection of multiple 99 communication points, called N_Ports, interconnected either by a 100 switching network, called a Fabric, or by a point-to-point link. A 101 Fibre Channel "node" consists of one or more N_Ports. A Fabric may 102 consist of multiple Interconnect Elements, some of which are 103 switches. An N_Port connects to the Fabric via a port on a switch 104 called an F_Port. When multiple FC nodes are connected to a single 105 port on a switch via an "Arbitrated Loop" topology, the switch port 106 is called an FL_Port, and the nodes' ports are called NL_Ports. The 107 term Nx_Port is used to refer to either an N_Port or an NL_Port. The 108 term Fx_Port is used to refer to either an F_Port or an FL_Port. A 109 switch port, which is interconnected to another switch port via an 110 Inter-Switch Link (ISL), is called an E_Port. A B_Port connects a 111 bridge device with an E_Port on a switch; a B_Port provides a subset 112 of E_Port functionality. 114 Many Fibre Channel components, including the fabric, each node, and 115 most ports, have globally-unique names. These globally-unique names 116 are typically formatted as World Wide Names (WWNs). More information 117 on WWNs can be found in [FC-FS]. WWNs are expected to be persistent 118 across agent and unit resets. 120 Fibre Channel frames contain 24-bit address identifiers which 121 identify the frame's source and destination ports. Each FC port has 122 both an address identifier and a WWN. When a fabric is in use, the 123 FC address identifiers are dynamic and are assigned by a switch. 124 Each octet of a 24-bit address represents a level in an address 125 hierarchy, with a Domain_ID being the highest level of the hierarchy. 127 The routing of frames within the Fabric is normally based on a 128 routing protocol called Fabric Shortest Path First (FSPF). FSPF is a 129 link state path selection protocol, which is defined in section 8 of 130 [FC-SW-4]. FSPF keeps track of the state of the links on all 131 switches in the Fabric and associates a cost with each link. The 132 protocol computes paths from a switch to all the other switches in 133 the Fabric by adding the cost of all the links traversed by the path, 134 and choosing the path that minimizes the cost. The collection of link 135 states (including cost) of all the switches in a Fabric constitutes 136 the topology database (or link-state database). 138 FSPF has four major components: 140 a) A Hello protocol, used to establish connectivity with a 141 neighbor switch, to establish the identity of the neighbor switch, 142 and to exchange FSPF parameters and capabilities; 144 b) A replicated topology database, with the protocols and 145 mechanisms to keep the databases synchronized across the Fabric; 147 c) A path computation algorithm (e.g., Dijkstra's algorithm); 149 d) A routing table update. 151 The topology database synchronization in turn consists of two major 152 components: an initial database synchronization, and an update 153 mechanism. The initial database synchronization is used when a switch 154 is initialized, or when an Inter-Switch Link (ISL) comes up. The 155 update mechanism is used in two circumstances: 157 a) When there is a link state change, for example an ISL going 158 down or coming up; 160 b) On a periodic basis, to prevent switches from deleting topology 161 information from the database. 163 Also note that all connections between Fibre Channel switches are 164 point-to-point. 166 The latest standard for an interconnecting Fabric containing multiple 167 Fabric Switch elements is [FC-SW-4]. [FC-SW-4] carries forward the 168 previous version's specification for the operation of a single Fabric 169 in a physical infrastructure, augmenting it with the definition of 170 Virtual Fabrics and with the specification of how multiple Virtual 171 Fabrics can operate within one (or more) physical infrastructures. 172 The use of Virtual Fabrics provides for each frame to be tagged in 173 its header to indicate which one of several Virtual Fabrics that 174 frame is being transmitted on. All frames entering a particular 175 "Core Switch" [FC-SW-4] (i.e., a physical switch) on the same Virtual 176 Fabric are processed by the same "Virtual Switch" within that Core 177 switch. 179 4. Relationship to Other MIBs 181 The first standardized MIB module for Fibre Channel [RFC2837] was 182 focussed on Fibre Channel switches. It is being replaced by the more 183 generic Fibre Channel Management MIB [FC-MGMT] which defines basic 184 information for Fibre Channel hosts and switches, including 185 extensions to the standard IF-MIB [RFC2863] for Fibre Channel 186 interfaces. 188 This MIB module extends beyond [FC-MGMT] to cover the operation of 189 the FSPF routing protocol in Fibre Channel switches. 191 This MIB module only contains information specific to FSPF. 192 Information which would still be applicable if any other routing 193 protocol were to be used, is specified in a separate MIB module [FC- 194 RTM-MIB]. 196 This MIB module imports some common Textual Conventions from T11-TC- 197 MIB, defined in [FC-FAM-MIB]. 199 5. MIB Overview 201 This MIB module provides the means for monitoring the operation of, 202 and configuring some parameters of, one or more instances of the FSPF 203 protocol. 205 5.1. Fibre Channel management instance 207 A Fibre Channel management instance is defined in [FC-MGMT] as a 208 separable managed instance of Fibre Channel functionality. Fibre 209 Channel functionality may be grouped into Fibre Channel management 210 instances in whatever way is most convenient for the 211 implementation(s). For example, one such grouping accommodates a 212 single SNMP agent having multiple AgentX [RFC2741] sub-agents, with 213 each sub-agent implementing a different Fibre Channel management 214 instance. 216 The object, fcmInstanceIndex, is IMPORTed from the FC-MGMT-MIB 217 [FC-MGMT] as the index value to uniquely identify each Fibre Channel 218 management instance within the same SNMP context ([RFC3411] section 219 3.3.1). 221 5.2. Switch Index 223 The FC-MGMT-MIB [FC-MGMT] defines the fcmSwitchTable as a table of 224 information about Fibre Channel switches which are managed by Fibre 225 Channel management instances. Each Fibre Channel management instance 226 can manage one or more Fibre Channel switches. The Switch Index, 227 fcmSwitchIndex, is IMPORTed from the FC-MGMT-MIB as the index value 228 to uniquely identify a Fibre Channel switch amongst those (one or 229 more) managed by the same Fibre Channel management instance. 231 5.3. Fabric Index 233 Whether operating on a physical Fabric (i.e., without Virtual 234 Fabrics) or within a Virtual Fabric, the operation of FSPF within a 235 Fabric is identical. Therefore, this MIB module defines all Fabric- 236 related information in tables which are INDEX-ed by an arbitrary 237 integer, named a "Fabric Index", the syntax of which is IMPORTed from 238 the T11-TC-MIB. When a device is connected to a single physical 239 Fabric, without use of any virtual Fabrics, the value of this Fabric 240 Index will always be 1. In an environment of multiple virtual and/or 241 physical Fabrics, this index provides a means to distinguish one 242 Fabric from another. 244 It is quite possible, and may even be likely, that a Fibre Channel 245 switch will have ports connected to multiple virtual and/or physical 246 Fabrics. Thus, in order to simplify a management protocol query 247 concerning all the Fabrics to which a single switch is connected, 248 fcmSwitchIndex will be listed before t11FspfFabricIndex when they 249 both appear in the same INDEX clause. 251 5.4. The MIB Groups 253 This section describes the four MIB groups contained in the MIB 254 module. 256 5.4.1. The t11FspfGeneralGroup group 258 This group provides for per-Fabric monitoring of the FSPF state and 259 per-Fabric monitoring/configuration of FSPF parameters. 261 5.4.2. The t11FspfIfGroup group 263 This group provides for per-interface monitoring of FSPF 264 state/statistics and per-interface monitoring/configuration of FSPF 265 parameters. 267 5.4.3. The t11FspfDatabaseGroup group 269 This group permits the monitoring of the information present in the 270 FSPF topology database. 272 5.4.4. The t11FspfNotificationGroup group 274 This group contains the notifications which are generated on 275 asynchronous events related to the operation of FSPF. 277 6. The T11-FC-FSPF-MIB Module 279 T11-FC-FSPF-MIB DEFINITIONS ::= BEGIN 280 -- 281 -- For management of FSPF, the Fibre Channel routing protocol. 282 -- 284 IMPORTS 285 MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, 286 Counter32, Integer32, Unsigned32, TimeTicks, 287 Gauge32, mib-2 FROM SNMPv2-SMI -- [RFC2578] 288 MODULE-COMPLIANCE, OBJECT-GROUP, 289 NOTIFICATION-GROUP FROM SNMPv2-CONF -- [RFC2580] 290 TEXTUAL-CONVENTION, RowStatus, StorageType, 291 TruthValue FROM SNMPv2-TC -- [RFC2579] 292 ifIndex, InterfaceIndex FROM IF-MIB -- [RFC2863] 293 fcmInstanceIndex, fcmSwitchIndex, 294 FcDomainIdOrZero FROM FC-MGMT-MIB -- [FC-MGMT] 295 T11FabricIndex FROM T11-TC-MIB -- [FC-FAM-MIB] 296 t11FamConfigDomainId 297 FROM T11-FC-FABRIC-ADDR-MGR-MIB; -- [FC-FAM-MIB] 299 t11FcFspfMIB MODULE-IDENTITY 300 LAST-UPDATED "200603130000Z" 301 ORGANIZATION "T11" 302 CONTACT-INFO 303 "Claudio DeSanti 304 Cisco Systems, Inc. 305 170 West Tasman Drive 306 San Jose, CA 95134 USA 307 EMail: cds@cisco.com 309 Keith McCloghrie 310 Cisco Systems, Inc. 311 170 West Tasman Drive 312 San Jose, CA USA 95134 313 Email: kzm@cisco.com" 314 DESCRIPTION 315 "The MIB module for managing the Fabric Shortest Path 316 First (FSPF) protocol. FSPF is specified in FC-SW-4. 318 Copyright (C) The Internet Society (2006). This version of 319 this MIB module is part of RFC yyyy; see the RFC itself for 320 full legal notices." 322 -- RFC Editor: replace yyyy with actual RFC number & remove this note 323 REVISION "200603130000Z" 324 DESCRIPTION 325 "Initial version of this MIB module, published as RFCyyyy." 326 -- RFC-Editor, replace yyyy with actual RFC number & remove this note 327 ::= { mib-2 XXX } -- to be assigned by IANA 328 -- RFC Editor: replace XXX with IANA-assigned number & remove this note 330 t11FspfNotifications OBJECT IDENTIFIER ::= { t11FcFspfMIB 0 } 331 t11FspfObjects OBJECT IDENTIFIER ::= { t11FcFspfMIB 1 } 332 t11FspfConformance OBJECT IDENTIFIER ::= { t11FcFspfMIB 2 } 333 t11FspfConfiguration OBJECT IDENTIFIER ::= { t11FspfObjects 1 } 334 t11FspfDatabase OBJECT IDENTIFIER ::= { t11FspfObjects 2 } 336 -- 337 -- TEXTUAL CONVENTIONS 339 T11FspfLsrType ::= TEXTUAL-CONVENTION 340 STATUS current 341 DESCRIPTION 342 "Type of the Link State Record. 344 FC-SW-4 defines two types of LSRs, and allows for the 345 possibility of more being defined in the future: 347 01 - Switch Link Record 348 02 - Obsolete 349 240-255 - Vendor Specific 350 others - Reserved. 351 " 352 REFERENCE 353 "Fibre Channel - Switch Fabric - 4 (FC-SW-4), 354 ANSI INCITS 418-2006, section 6.1.9.3." 355 SYNTAX Integer32 (0..255) 357 T11FspfLinkType ::= TEXTUAL-CONVENTION 358 STATUS current 359 DESCRIPTION 360 "Type of an the FSPF Link. Presently defined values: 362 1 - Point-to-Point 363 240-255 - Vendor Specific 364 all others - Reserved. 365 " 367 REFERENCE 368 "Fibre Channel - Switch Fabric - 4 (FC-SW-4), 369 ANSI INCITS 418-2006, section 6.1.9.4." 370 SYNTAX Integer32 (0..255) 372 T11FspfInterfaceState ::= TEXTUAL-CONVENTION 373 STATUS current 374 DESCRIPTION 375 "The state of the FSPF Neighbor Finite State Machine 376 for the neighbor (switch) on a particular interface. 377 Possible values are : 379 down(1) - Down 380 init(2) - Init 381 dbExchange(3) - Database Exchange 382 dbAckwait(4) - Database AckWait 383 dbWait(5) - Database Wait 384 full(6) - Full (Connected) 385 " 386 REFERENCE 387 "Fibre Channel - Switch Fabric - 4 (FC-SW-4), 388 ANSI INCITS 418-2006, section 8.7." 389 SYNTAX INTEGER { 390 down(1), 391 init(2), 392 dbExchange(3), 393 dbAckwait(4), 394 dbWait(5), 395 full(6) 396 } 398 T11FspfLastCreationTime ::= TEXTUAL-CONVENTION 399 STATUS current 400 DESCRIPTION 401 "This TC describes an object that stores the last time 402 it, and the row containing it, was created. 404 This can be used by management applications to determine 405 that a row has been deleted and re-created between reads, 406 causing an otherwise undetectable discontinuity in the 407 data." 408 SYNTAX TimeTicks 410 -- 411 -- t11FspfTable 413 t11FspfTable OBJECT-TYPE 414 SYNTAX SEQUENCE OF T11FspfEntry 415 MAX-ACCESS not-accessible 416 STATUS current 417 DESCRIPTION 418 "This table allows the users to configure and monitor FSPF's 419 per-Fabric parameters and statistics on all Fabrics known to 420 locally-managed switches. 422 Entries are created/removed by the agent if and when 423 (Virtual) Fabrics are created/deleted." 424 ::= { t11FspfConfiguration 1 } 426 t11FspfEntry OBJECT-TYPE 427 SYNTAX T11FspfEntry 428 MAX-ACCESS not-accessible 429 STATUS current 430 DESCRIPTION 431 "An entry containing FSPF variables, parameters and 432 statistics on a particular switch (identified by values 433 of fcmInstanceIndex and fcmSwitchIndex) for a particular 434 Fabric (identified by a t11FspfFabricIndex value). 436 (Note that the local switch's per-fabric Domain-ID is 437 available in t11FamConfigDomainId which is defined in 438 T11-FC-FABRIC-ADDR-MGR-MIB.)" 439 INDEX { fcmInstanceIndex, fcmSwitchIndex, t11FspfFabricIndex } 440 ::= { t11FspfTable 1 } 442 T11FspfEntry ::= SEQUENCE { 443 t11FspfFabricIndex T11FabricIndex, 444 t11FspfMinLsArrival Unsigned32, 445 t11FspfMinLsInterval Unsigned32, 446 t11FspfLsRefreshTime Unsigned32, 447 t11FspfMaxAge Unsigned32, 448 t11FspfMaxAgeDiscards Counter32, 449 t11FspfPathComputations Counter32, 450 t11FspfChecksumErrors Counter32, 451 t11FspfLsrs Gauge32, 452 t11FspfCreateTime T11FspfLastCreationTime, 453 t11FspfAdminStatus INTEGER, 454 t11FspfOperStatus INTEGER, 455 t11FspfNbrStateChangNotifyEnable TruthValue, 456 t11FspfSetToDefault INTEGER, 457 t11FspfStorageType StorageType 458 } 460 t11FspfFabricIndex OBJECT-TYPE 461 SYNTAX T11FabricIndex 462 MAX-ACCESS not-accessible 463 STATUS current 464 DESCRIPTION 465 "A unique index value which uniquely identifies a 466 particular Fabric. 468 In a Fabric conformant to FC-SW-4, multiple Virtual Fabrics 469 can operate within one (or more) physical infrastructures. 470 In such a case, index value is used to uniquely identify a 471 particular Fabric within a physical infrastructure. 473 In a Fabric which has (can have) only a single Fabric 474 operating within the physical infrastructure, the 475 value of this Fabric Index will always be 1." 476 ::= { t11FspfEntry 1 } 478 t11FspfMinLsArrival OBJECT-TYPE 479 SYNTAX Unsigned32 (0..65535) 480 UNITS "milliSeconds" 481 MAX-ACCESS read-write 482 STATUS current 483 DESCRIPTION 484 "The minimum time after accepting a Link State Record 485 (LSR) on this Fabric before accepting another update of 486 the same LSR on the same Fabric. 488 An LSR update that is not accepted because of this time 489 interval is discarded." 490 REFERENCE "Fibre Channel - Switch Fabric - 4 (FC-SW-4), 491 ANSI INCITS 418-2006, sections 8.6.4.5 & 15.1." 492 DEFVAL {1000} 493 ::= { t11FspfEntry 2 } 495 t11FspfMinLsInterval OBJECT-TYPE 496 SYNTAX Unsigned32 (0..65535) 497 UNITS "milliSeconds" 498 MAX-ACCESS read-write 499 STATUS current 500 DESCRIPTION 501 "The minimum time after this switch sends an LSR on this 502 Fabric before it will send another update of the same LSR 503 on the same Fabric." 504 REFERENCE "Fibre Channel - Switch Fabric - 4 (FC-SW-4), 505 ANSI INCITS 418-2006, section 15.1." 506 DEFVAL {5000} 507 ::= { t11FspfEntry 3 } 509 t11FspfLsRefreshTime OBJECT-TYPE 510 SYNTAX Unsigned32 511 UNITS "Minutes" 512 MAX-ACCESS read-only 513 STATUS current 514 DESCRIPTION 515 "The interval between transmission of refresh LSRs on this 516 Fabric." 517 REFERENCE "Fibre Channel - Switch Fabric - 4 (FC-SW-4), 518 ANSI INCITS 418-2006, sections 8.5.1 & 15.1." 519 DEFVAL {30} 520 ::= { t11FspfEntry 4 } 522 t11FspfMaxAge OBJECT-TYPE 523 SYNTAX Unsigned32 524 UNITS "Minutes" 525 MAX-ACCESS read-only 526 STATUS current 527 DESCRIPTION 528 "The maximum age an LSR will be retained in the FSPF 529 database on this Fabric. An LSR is removed from the 530 database after MaxAge is reached." 531 REFERENCE "Fibre Channel - Switch Fabric - 4 (FC-SW-4), 532 ANSI INCITS 418-2006, section 15.1." 533 DEFVAL {60} 534 ::= { t11FspfEntry 5 } 536 t11FspfMaxAgeDiscards OBJECT-TYPE 537 SYNTAX Counter32 538 MAX-ACCESS read-only 539 STATUS current 540 DESCRIPTION 541 "The number of LSRs discarded due to their age reaching 542 t11FspfMaxAge in this Fabric. The last discontinuity of 543 this counter is indicated by t11FspfCreateTime." 544 ::= { t11FspfEntry 6 } 546 t11FspfPathComputations OBJECT-TYPE 547 SYNTAX Counter32 548 MAX-ACCESS read-only 549 STATUS current 550 DESCRIPTION 551 "The number of times that the path computation algorithm 552 has been invoked by this Switch on this Fabric to compute 553 a set of minimum cost paths for this Fabric. The last 554 discontinuity of this counter is indicated by 555 t11FspfCreateTime." 556 REFERENCE "Fibre Channel - Switch Fabric - 4 (FC-SW-4), 557 ANSI INCITS 418-2006, section 8.1.1." 558 ::= { t11FspfEntry 7 } 560 t11FspfChecksumErrors OBJECT-TYPE 561 SYNTAX Counter32 562 MAX-ACCESS read-only 563 STATUS current 564 DESCRIPTION 565 "The number of FSPF checksum errors which were detected 566 locally (and therefore discarded) on this Fabric. 567 The last discontinuity of this counter is indicated by 568 t11FspfCreateTime." 569 REFERENCE "Fibre Channel - Switch Fabric - 4 (FC-SW-4), 570 ANSI INCITS 418-2006, section 8.5.4." 571 ::= { t11FspfEntry 8 } 573 t11FspfLsrs OBJECT-TYPE 574 SYNTAX Gauge32 575 MAX-ACCESS read-only 576 STATUS current 577 DESCRIPTION 578 "The current number of entries for this Fabric in the 579 t11FspfLsrTable." 580 ::= { t11FspfEntry 9 } 582 t11FspfCreateTime OBJECT-TYPE 583 SYNTAX T11FspfLastCreationTime 584 MAX-ACCESS read-only 585 STATUS current 586 DESCRIPTION 587 "The value of sysUpTime when this entry was last created." 588 ::= { t11FspfEntry 10 } 590 t11FspfAdminStatus OBJECT-TYPE 591 SYNTAX INTEGER { 592 up(1), 593 down(2) 594 } 595 MAX-ACCESS read-write 596 STATUS current 597 DESCRIPTION 598 "The desired state of FSPF in this Fabric. If value of 599 this object is set to 'up', then FSPF is enabled in 600 this Fabric. If set to 'down', then FSPF is disabled 601 in this Fabric -- when FSPF is disabled, FSPF provides 602 no routes to be included in the T11-FC-ROUTE-MIB module. 603 (see the T11-FC-ROUTE-MIB)." 604 REFERENCE "T11-FC-ROUTE-MIB, The Fibre-Channel Routing 605 Information MIB, RFCzzzz." 606 -- RFC Editor: pls replace zzzz with the RFC number & remove this note 607 DEFVAL {up} 608 ::= { t11FspfEntry 11 } 610 t11FspfOperStatus OBJECT-TYPE 611 SYNTAX INTEGER { 612 up(1), 613 down(2) 614 } 615 MAX-ACCESS read-only 616 STATUS current 617 DESCRIPTION 618 "State of FSPF in this Fabric. If 't11FspfAdminStatus' is 619 'down' then the 't11FspfOperStatus' should be 'down'. 620 If 't11FspfAdminStatus' is changed to 'up' then 621 't11FspfOperStatus' should change to 'up' as and when 622 FSPF is active in this Fabric." 623 ::= { t11FspfEntry 12 } 625 t11FspfNbrStateChangNotifyEnable OBJECT-TYPE 626 SYNTAX TruthValue 627 MAX-ACCESS read-write 628 STATUS current 629 DESCRIPTION 630 "Specifies whether or not the local agent should 631 issue the notification 't11FspfNbrStateChangNotify' 632 when the local switch learns of a change of state 633 in the FSPF Neighbor Finite State Machine on an 634 interface in this Fabric. 636 If the value of the object is 'true, then the 637 notification is generated. If the value is 'false', 638 notification is not generated." 639 DEFVAL { false } 640 ::= { t11FspfEntry 13 } 642 t11FspfSetToDefault OBJECT-TYPE 643 SYNTAX INTEGER { 644 default(1), 645 noOp(2) 646 } 647 MAX-ACCESS read-write 648 STATUS current 649 DESCRIPTION 650 "Setting this value to 'default' changes the value of each 651 and every write-able object in this row to its default 652 value. 654 No action is taken if this object is set to 'noOp'. 655 The value of the object when read is always 'noOp'." 656 ::= { t11FspfEntry 14 } 658 t11FspfStorageType OBJECT-TYPE 659 SYNTAX StorageType 660 MAX-ACCESS read-write 661 STATUS current 662 DESCRIPTION 663 "The storage type for read-write objects in this 664 conceptual row. 666 Conceptual rows having the value 'permanent' need not 667 allow write-access to any columnar objects in the row." 668 DEFVAL { nonVolatile } 669 ::= { t11FspfEntry 15 } 671 -- 672 -- t11FspfIfTable 674 t11FspfIfTable OBJECT-TYPE 675 SYNTAX SEQUENCE OF T11FspfIfEntry 676 MAX-ACCESS not-accessible 677 STATUS current 678 DESCRIPTION 679 "This table allows the users to configure and monitor 680 the FSPF parameters which are per-interface (identified 681 by a t11FspfIfIndex value), per-Fabric (identified by a 682 t11FspfFabricIndex value), and per-switch (identified by 683 values of fcmInstanceIndex and fcmSwitchIndex). 685 Creating a row in this table via t11FspfIfRowStatus 686 provides the means to specify non-default parameter value(s) 687 for an interface at a time when the relevant row in this 688 table would not otherwise exist because the interface is 689 either down or it is not an E_Port, but the corresponding 690 row in the t11FspfTable must already exist. 692 After the non-default values have been specified for a 693 port's parameters, they need to be retained in this table 694 even when the port becomes 'isolated'. However, having 695 unnecessary rows in this table clutters it up, and makes 696 those rows that are useful harder for an NMS to find. 697 Therefore, when an E_Port becomes isolated, its row get 698 deleted if and only if all of its parameter values are the 699 default values; also, when an E_Port becomes non-isolated 700 in a particular Fabric, a row in this table needs to exist 701 and is automatically created if necessary. 703 The specific conditions for an automated/implicit deletion 704 of a row are: 705 a) if the corresponding interface is no longer an E_Port 706 (e.g., a G_Port which is dynamically determined to be an 707 F_Port), and all configurable parameters have default 708 values; or 709 b) if the interface identified by t11FspfIfIndex no longer 710 exists (e.g., because a line-card is physically removed); 711 or 712 c) if the corresponding row in the t11FspfTable is deleted. 713 " 714 ::= { t11FspfConfiguration 2 } 716 t11FspfIfEntry OBJECT-TYPE 717 SYNTAX T11FspfIfEntry 718 MAX-ACCESS not-accessible 719 STATUS current 720 DESCRIPTION 721 "An entry containing FSPF information for the interface 722 identified by t11FspfIfIndex, on the fabric identified 723 by t11FspfFabricIndex, on the switch identified by 724 fcmSwitchIndex." 725 INDEX { fcmInstanceIndex, fcmSwitchIndex, 726 t11FspfFabricIndex, t11FspfIfIndex } 727 ::= { t11FspfIfTable 1 } 729 T11FspfIfEntry ::= SEQUENCE { 730 t11FspfIfIndex InterfaceIndex, 731 t11FspfIfHelloInterval Unsigned32, 732 t11FspfIfDeadInterval Unsigned32, 733 t11FspfIfRetransmitInterval Unsigned32, 734 t11FspfIfInLsuPkts Counter32, 735 t11FspfIfInLsaPkts Counter32, 736 t11FspfIfOutLsuPkts Counter32, 737 t11FspfIfOutLsaPkts Counter32, 738 t11FspfIfOutHelloPkts Counter32, 739 t11FspfIfInHelloPkts Counter32, 740 t11FspfIfRetransmittedLsuPkts Counter32, 741 t11FspfIfInErrorPkts Counter32, 742 t11FspfIfNbrState T11FspfInterfaceState, 743 t11FspfIfNbrDomainId FcDomainIdOrZero, 744 t11FspfIfNbrPortIndex Unsigned32, 745 t11FspfIfAdminStatus INTEGER, 746 t11FspfIfCreateTime T11FspfLastCreationTime, 747 t11FspfIfSetToDefault INTEGER, 748 t11FspfIfLinkCostFactor Unsigned32, 749 t11FspfIfStorageType StorageType, 750 t11FspfIfRowStatus RowStatus 751 } 753 t11FspfIfIndex OBJECT-TYPE 754 SYNTAX InterfaceIndex 755 MAX-ACCESS not-accessible 756 STATUS current 757 DESCRIPTION 758 "The value of ifIndex which identifies the local 759 Fibre Channel interface for which this entry 760 contains FSPF information." 761 ::= { t11FspfIfEntry 1 } 763 t11FspfIfHelloInterval OBJECT-TYPE 764 SYNTAX Unsigned32 (1..65535) 765 UNITS "Seconds" 766 MAX-ACCESS read-create 767 STATUS current 768 DESCRIPTION 769 "Interval between the periodic HELLO messages sent on this 770 interface in this Fabric to verify the link health. Note 771 that this value must be same at both ends of a link in 772 this Fabric." 773 DEFVAL {20} 774 ::= { t11FspfIfEntry 2 } 776 t11FspfIfDeadInterval OBJECT-TYPE 777 SYNTAX Unsigned32 (2..65535) 778 UNITS "Seconds" 779 MAX-ACCESS read-create 780 STATUS current 781 DESCRIPTION 782 "Maximum time for which no HELLO messages can be received 783 on this interface in this Fabric. After this time, the 784 interface is assumed to be broken and removed from the 785 database. Note that this value must be greater than the 786 HELLO interval specified on this interface in this Fabric." 787 DEFVAL {80} 788 ::= { t11FspfIfEntry 3 } 790 t11FspfIfRetransmitInterval OBJECT-TYPE 791 SYNTAX Unsigned32 (1..65535) 792 UNITS "Seconds" 793 MAX-ACCESS read-create 794 STATUS current 795 DESCRIPTION 796 "The time after which an unacknowledged LSR is 797 retransmitted on this interface in this Fabric." 798 DEFVAL {5} 799 ::= { t11FspfIfEntry 4 } 801 t11FspfIfInLsuPkts OBJECT-TYPE 802 SYNTAX Counter32 803 MAX-ACCESS read-only 804 STATUS current 805 DESCRIPTION 806 "Number of Link State Update (LSU) packets received on 807 this interface in this Fabric. The last discontinuity 808 of this counter is indicated by t11FspfIfCreateTime." 809 ::= { t11FspfIfEntry 5 } 811 t11FspfIfInLsaPkts OBJECT-TYPE 812 SYNTAX Counter32 813 MAX-ACCESS read-only 814 STATUS current 815 DESCRIPTION 816 "Number of Link State Acknowledgement (LSA) packets 817 received on this interface in this Fabric. The last 818 discontinuity of this counter is indicated by 819 t11FspfIfCreateTime." 820 ::= { t11FspfIfEntry 6 } 822 t11FspfIfOutLsuPkts OBJECT-TYPE 823 SYNTAX Counter32 824 MAX-ACCESS read-only 825 STATUS current 826 DESCRIPTION 827 "Number of Link State Update (LSU) packets transmitted 828 on this interface in this Fabric. The last 829 discontinuity of this counter is indicated by 830 t11FspfIfCreateTime." 831 ::= { t11FspfIfEntry 7 } 833 t11FspfIfOutLsaPkts OBJECT-TYPE 834 SYNTAX Counter32 835 MAX-ACCESS read-only 836 STATUS current 837 DESCRIPTION 838 "Number of Link State Acknowledgement (LSA) packets 839 transmitted on this interface in this Fabric. The 840 last discontinuity of this counter is indicated by 841 t11FspfIfCreateTime." 842 ::= { t11FspfIfEntry 8 } 844 t11FspfIfOutHelloPkts OBJECT-TYPE 845 SYNTAX Counter32 846 MAX-ACCESS read-only 847 STATUS current 848 DESCRIPTION 849 "Number of HELLO packets transmitted on this interface in 850 this Fabric. The last discontinuity of this counter is 851 indicated by t11FspfIfCreateTime." 852 ::= { t11FspfIfEntry 9 } 854 t11FspfIfInHelloPkts OBJECT-TYPE 855 SYNTAX Counter32 856 MAX-ACCESS read-only 857 STATUS current 858 DESCRIPTION 859 "Number of HELLO packets received on this interface in 860 this Fabric. The last discontinuity of this counter is 861 indicated by t11FspfIfCreateTime." 862 ::= { t11FspfIfEntry 10 } 864 t11FspfIfRetransmittedLsuPkts OBJECT-TYPE 865 SYNTAX Counter32 866 MAX-ACCESS read-only 867 STATUS current 868 DESCRIPTION 869 "The number of LSU packets which contained one or more 870 retransmitted LSRs, and which were transmitted on this 871 interface in this Fabric. The last discontinuity of 872 this counter is indicated by t11FspfIfCreateTime." 873 ::= { t11FspfIfEntry 11 } 875 t11FspfIfInErrorPkts OBJECT-TYPE 876 SYNTAX Counter32 877 MAX-ACCESS read-only 878 STATUS current 879 DESCRIPTION 880 "Number of invalid FSPF control packets received on this 881 interface in this Fabric. The last discontinuity of 882 this counter is indicated by t11FspfIfCreateTime." 883 ::= { t11FspfIfEntry 12 } 885 t11FspfIfNbrState OBJECT-TYPE 886 SYNTAX T11FspfInterfaceState 887 MAX-ACCESS read-only 888 STATUS current 889 DESCRIPTION 890 "The state of FSPF's 'neighbor state machine', which is 891 the operational state of the interaction with the 892 neighbor's interface which is connected to this interface. 894 If the 't11FspfIfAdminStatus' is 'down', then this object 895 should be 'down'. If the 't11FspfIfAdminStatus' is 'up' 896 then this object's value depends on the state of FSPF's 897 'neighbor state machine' on this interface in this 898 Fabric." 899 REFERENCE "Fibre Channel - Switch Fabric - 4 (FC-SW-4), 900 ANSI INCITS 418-2006, section 8.7" 901 ::= { t11FspfIfEntry 13 } 903 t11FspfIfNbrDomainId OBJECT-TYPE 904 SYNTAX FcDomainIdOrZero 905 MAX-ACCESS read-only 906 STATUS current 907 DESCRIPTION 908 "The Domain Id of the neighbor in this Fabric." 909 ::= { t11FspfIfEntry 14 } 911 t11FspfIfNbrPortIndex OBJECT-TYPE 912 SYNTAX Unsigned32 (0..16777215) 913 MAX-ACCESS read-only 914 STATUS current 915 DESCRIPTION 916 "The index, as known by the neighbor, of the neighbor's 917 interface which is connected to this interface in this 918 Fabric." 919 REFERENCE "Fibre Channel - Switch Fabric - 4 (FC-SW-4), 920 ANSI INCITS 418-2006, section 6.1.9.4." 921 ::= { t11FspfIfEntry 15 } 923 t11FspfIfAdminStatus OBJECT-TYPE 924 SYNTAX INTEGER { 925 up(1), 926 down(2) 927 } 928 MAX-ACCESS read-create 929 STATUS current 930 DESCRIPTION 931 "The desired state of FSPF on this interface in this 932 Fabric, whenever 't11FspfAdminStatus' is 'up'. 933 If value of this object is set to 'up', then FSPF is 934 enabled on this interface in this Fabric. If set to 935 'down', then FSPF is disabled on this interface in this 936 Fabric. Note that the operational state of FSPF on an 937 interface is given by t11FspfIfNbrState." 938 DEFVAL {up} 939 ::= { t11FspfIfEntry 16 } 941 t11FspfIfCreateTime OBJECT-TYPE 942 SYNTAX T11FspfLastCreationTime 943 MAX-ACCESS read-only 944 STATUS current 945 DESCRIPTION 946 "The value of sysUpTime when this entry was last 947 created." 948 ::= { t11FspfIfEntry 17 } 950 t11FspfIfSetToDefault OBJECT-TYPE 951 SYNTAX INTEGER { 952 default(1), 953 noOp(2) 954 } 955 MAX-ACCESS read-create 956 STATUS current 957 DESCRIPTION 958 "Setting this value to 'default' changes the value of each 959 and every write-able object in this row to its default 960 value. 962 If all the configuration parameters have their default 963 values and if the interface is down, then the row is 964 deleted automatically. 966 No action is taken if this object is set to 'noOp'. 967 The value of the object when read is always 'noOp'." 968 ::= { t11FspfIfEntry 18 } 970 t11FspfIfLinkCostFactor OBJECT-TYPE 971 SYNTAX Unsigned32 (1..65535) 972 MAX-ACCESS read-create 973 STATUS current 974 DESCRIPTION 975 "The administrative factor used in calculating the cost 976 of sending a frame on this interface in this Fabric. 978 The formula is used to calculate the link cost is: 980 Link Cost = S * (1.0625e12 / ifSpeed) 981 where: 982 S = (the value of this object / 100) 983 ifSpeed = interface speed (as defined in the IF-MIB). 984 " 985 REFERENCE 986 "Fibre Channel - Switch Fabric - 4 (FC-SW-4), 987 ANSI INCITS 418-2006, section 8.5.5; and 988 IF-MIB, RFC 2863." 989 DEFVAL { 100 } 990 ::= { t11FspfIfEntry 19 } 992 t11FspfIfStorageType OBJECT-TYPE 993 SYNTAX StorageType 994 MAX-ACCESS read-create 995 STATUS current 996 DESCRIPTION 997 "The storage type for this conceptual row. 998 Conceptual rows having the value 'permanent' need not 999 allow write-access to any columnar objects in the row." 1000 DEFVAL { nonVolatile } 1001 ::= { t11FspfIfEntry 20 } 1003 t11FspfIfRowStatus OBJECT-TYPE 1004 SYNTAX RowStatus 1005 MAX-ACCESS read-create 1006 STATUS current 1007 DESCRIPTION 1008 "The status of the conceptual row. 1010 This object can be used to create an entry only if there 1011 is an entry in the t11FspfTable for the corresponding 1012 Fabric, and the interface is either isolated or is a 1013 non-E_port. 1015 Setting this object to 'destroy' will typically fail; 1016 to reverse the creation process, set the corresponding 1017 instance of t11FspfIfSetToDefault to 'default'." 1018 ::= { t11FspfIfEntry 21 } 1020 -- 1021 -- t11FspfLsrTable 1023 t11FspfLsrTable OBJECT-TYPE 1024 SYNTAX SEQUENCE OF T11FspfLsrEntry 1025 MAX-ACCESS not-accessible 1026 STATUS current 1027 DESCRIPTION 1028 "This table is the database of all of the latest 1029 incarnations of the Link State Records (LSRs) which 1030 are currently contained in the topology database, 1031 for all interfaces on all Fabrics known to 1032 locally-managed switches. 1034 A Fabric's topology database contains the LSRs which 1035 have been either issued or received by a local switch on 1036 that Fabric, and which have not reached t11FspfMaxAge." 1037 ::= { t11FspfDatabase 1 } 1039 t11FspfLsrEntry OBJECT-TYPE 1040 SYNTAX T11FspfLsrEntry 1041 MAX-ACCESS not-accessible 1042 STATUS current 1043 DESCRIPTION 1044 "This gives information for the most recent update of an 1045 LSR. There is one entry for every LSR issued or received 1046 by a locally-managed switch (identified by 1047 fcmInstanceIndex and fcmSwitchIndex) in a Fabric 1048 (identified by t11FspfFabricIndex)." 1049 INDEX { fcmInstanceIndex, fcmSwitchIndex, t11FspfFabricIndex, 1050 t11FspfLsrDomainId, t11FspfLsrType } 1051 ::= { t11FspfLsrTable 1 } 1053 T11FspfLsrEntry ::= SEQUENCE { 1054 t11FspfLsrDomainId FcDomainIdOrZero, 1055 t11FspfLsrType T11FspfLsrType, 1056 t11FspfLsrAdvDomainId FcDomainIdOrZero, 1057 t11FspfLsrAge Unsigned32, 1058 t11FspfLsrIncarnationNumber Unsigned32, 1059 t11FspfLsrCheckSum Unsigned32, 1060 t11FspfLsrLinks Unsigned32 1061 } 1063 t11FspfLsrDomainId OBJECT-TYPE 1064 SYNTAX FcDomainIdOrZero 1065 MAX-ACCESS not-accessible 1066 STATUS current 1067 DESCRIPTION 1068 "Domain Id of the LSR owner in this Fabric. It is the 1069 Link State Id of this LSR." 1070 ::= { t11FspfLsrEntry 1 } 1072 t11FspfLsrType OBJECT-TYPE 1073 SYNTAX T11FspfLsrType 1074 MAX-ACCESS not-accessible 1075 STATUS current 1076 DESCRIPTION 1077 "Type of this LSR." 1078 ::= { t11FspfLsrEntry 2 } 1080 t11FspfLsrAdvDomainId OBJECT-TYPE 1081 SYNTAX FcDomainIdOrZero 1082 MAX-ACCESS read-only 1083 STATUS current 1084 DESCRIPTION 1085 "Domain Id of the switch that is advertising the LSR on 1086 the behalf of the switch owning it." 1087 ::= { t11FspfLsrEntry 3 } 1089 t11FspfLsrAge OBJECT-TYPE 1090 SYNTAX Unsigned32 (0..65535) 1091 UNITS "Seconds" 1092 MAX-ACCESS read-only 1093 STATUS current 1094 DESCRIPTION 1095 "The time since this LSR was inserted into the database." 1096 ::= { t11FspfLsrEntry 4 } 1098 t11FspfLsrIncarnationNumber OBJECT-TYPE 1099 SYNTAX Unsigned32 (0..4294967295) 1100 MAX-ACCESS read-only 1101 STATUS current 1102 DESCRIPTION 1103 "The link state incarnation number of this LSR. This is 1104 used to identify most recent instance of an LSR while 1105 updating the topology database when an LSR is received. 1106 The updating of an LSR includes incrementing its 1107 incarnation number prior to transmission of the updated 1108 LSR. So, the most recent LSR is the one with the 1109 largest incarnation number." 1110 ::= { t11FspfLsrEntry 5 } 1112 t11FspfLsrCheckSum OBJECT-TYPE 1113 SYNTAX Unsigned32 (0..65535) 1114 MAX-ACCESS read-only 1115 STATUS current 1116 DESCRIPTION 1117 "The checksum of the LSR." 1118 ::= { t11FspfLsrEntry 6 } 1120 t11FspfLsrLinks OBJECT-TYPE 1121 SYNTAX Unsigned32 (0..65355) 1122 MAX-ACCESS read-only 1123 STATUS current 1124 DESCRIPTION 1125 "Number of entries in the t11FspfLinkTable associated with 1126 this LSR." 1127 ::= { t11FspfLsrEntry 7 } 1129 -- 1130 -- t11FspfLinkTable 1132 t11FspfLinkNumber OBJECT-TYPE 1133 SYNTAX Unsigned32 (0..2147483647) 1134 MAX-ACCESS read-only 1135 STATUS current 1136 DESCRIPTION 1137 "The number of rows in the t11FspfLinkTable." 1138 ::= { t11FspfDatabase 3 } 1140 t11FspfLinkTable OBJECT-TYPE 1141 SYNTAX SEQUENCE OF T11FspfLinkEntry 1142 MAX-ACCESS not-accessible 1143 STATUS current 1144 DESCRIPTION 1145 "This table contains the list of Inter-Switch Links and 1146 their information which is part of an LSR, either 1147 received or transmitted." 1148 ::= { t11FspfDatabase 4 } 1150 t11FspfLinkEntry OBJECT-TYPE 1151 SYNTAX T11FspfLinkEntry 1152 MAX-ACCESS not-accessible 1153 STATUS current 1154 DESCRIPTION 1155 "An entry which contains information about a link 1156 contained in an LSR in this Fabric. An entry is created 1157 whenever a new link appears in an (issued or received) 1158 LSR. An entry is deleted when a link no longer appears 1159 in an (issued or received) LSR." 1160 INDEX { fcmInstanceIndex, fcmSwitchIndex, t11FspfFabricIndex, 1161 t11FspfLsrDomainId, t11FspfLsrType, t11FspfLinkIndex} 1162 ::= { t11FspfLinkTable 1 } 1164 T11FspfLinkEntry ::= SEQUENCE { 1165 t11FspfLinkIndex Unsigned32, 1166 t11FspfLinkNbrDomainId FcDomainIdOrZero, 1167 t11FspfLinkPortIndex Unsigned32, 1168 t11FspfLinkNbrPortIndex Unsigned32, 1169 t11FspfLinkType T11FspfLinkType, 1170 t11FspfLinkCost Integer32 1171 } 1173 t11FspfLinkIndex OBJECT-TYPE 1174 SYNTAX Unsigned32 (1..4294967295) 1175 MAX-ACCESS not-accessible 1176 STATUS current 1177 DESCRIPTION 1178 "An arbitrary index of this link." 1179 ::= { t11FspfLinkEntry 1 } 1181 t11FspfLinkNbrDomainId OBJECT-TYPE 1182 SYNTAX FcDomainIdOrZero 1183 MAX-ACCESS read-only 1184 STATUS current 1185 DESCRIPTION 1186 "The Domain Id of the neighbor on the other end of this 1187 link in this Fabric." 1188 ::= { t11FspfLinkEntry 2 } 1190 t11FspfLinkPortIndex OBJECT-TYPE 1191 SYNTAX Unsigned32 (0..16777215) 1192 MAX-ACCESS read-only 1193 STATUS current 1194 DESCRIPTION 1195 "The source E_port of this link, as indicated by the index 1196 value in the LSR received from the switch identified by 1197 't11FspfLsrDomainId'." 1198 ::= { t11FspfLinkEntry 3 } 1200 t11FspfLinkNbrPortIndex OBJECT-TYPE 1201 SYNTAX Unsigned32 (0..16777215) 1202 MAX-ACCESS read-only 1203 STATUS current 1204 DESCRIPTION 1205 "The destination E_port of this link, as indicated by the 1206 index value in the LSR received from the switch identified 1207 by 't11FspfLinkNbrDomainId'." 1208 ::= { t11FspfLinkEntry 4 } 1210 t11FspfLinkType OBJECT-TYPE 1211 SYNTAX T11FspfLinkType 1212 MAX-ACCESS read-only 1213 STATUS current 1214 DESCRIPTION 1215 "The type of this link." 1216 ::= { t11FspfLinkEntry 5 } 1218 t11FspfLinkCost OBJECT-TYPE 1219 SYNTAX Integer32 (0..65535) 1220 MAX-ACCESS read-only 1221 STATUS current 1222 DESCRIPTION 1223 "The cost of sending a frame on this link in this Fabric. 1224 Link cost is calculated using a formula: 1226 link cost = S * (1.0625e12 / Signalling Rate) 1228 For issued LSRs, S is determined by the value of 1229 t11FspfIfLinkCostFactor for the corresponding interface 1230 and Fabric." 1231 ::= { t11FspfLinkEntry 6 } 1233 -- 1234 -- Notification-related object 1236 t11FspfIfPrevNbrState OBJECT-TYPE 1237 SYNTAX T11FspfInterfaceState 1238 MAX-ACCESS accessible-for-notify 1239 STATUS current 1240 DESCRIPTION 1241 "The previous state of FSPF's Neighbor Finite State 1242 Machine on an interface. 1244 This object is only used in the 1245 't11FspfNbrStateChangNotify' notification." 1246 ::= { t11FspfConfiguration 3 } 1248 -- 1249 -- Notifications 1251 t11FspfNbrStateChangNotify NOTIFICATION-TYPE 1252 OBJECTS { ifIndex, 1253 t11FamConfigDomainId, 1254 t11FspfIfNbrDomainId, 1255 t11FspfIfNbrState, 1256 t11FspfIfPrevNbrState 1257 } 1258 STATUS current 1259 DESCRIPTION 1260 "This notification signifies that there has been a change in 1261 the state of an FSPF neighbor. This is generated when the 1262 FSPF state changes to a terminal state, either through 1263 regression (i.e., goes from Full to Init or Down) or 1264 progression (i.e., from any state to Full). The value of 1265 't11FspfIfNbrState' is the state of the neighbor after the 1266 change." 1267 ::= { t11FspfNotifications 1 } 1269 -- 1270 -- Conformance 1272 t11FspfMIBCompliances 1273 OBJECT IDENTIFIER ::= { t11FspfConformance 1 } 1275 t11FspfMIBGroups 1276 OBJECT IDENTIFIER ::= { t11FspfConformance 2 } 1278 t11FspfMIBCompliance MODULE-COMPLIANCE 1279 STATUS current 1280 DESCRIPTION 1281 "The compliance statement for entities which 1282 implement the FSPF." 1283 MODULE -- this module 1284 MANDATORY-GROUPS { t11FspfGeneralGroup, 1285 t11FspfIfGroup, 1286 t11FspfDatabaseGroup, 1287 t11FspfNotificationGroup } 1289 GROUP t11FspfIfCounterGroup 1290 DESCRIPTION 1291 "These counters, for particular FSPF-packet 1292 occurrences on an interface, are mandatory only 1293 for those systems which count such events." 1295 OBJECT t11FspfIfRowStatus 1296 SYNTAX INTEGER { active(1) } 1297 MIN-ACCESS read-only 1298 DESCRIPTION 1299 "Write access is not required, and so, only 1300 one value need to be supported." 1302 OBJECT t11FspfIfStorageType 1303 MIN-ACCESS read-only 1304 DESCRIPTION 1305 "Write access is not required." 1307 OBJECT t11FspfNbrStateChangNotifyEnable 1308 MIN-ACCESS read-only 1309 DESCRIPTION 1310 "Write access is not required." 1312 OBJECT t11FspfMinLsArrival 1313 MIN-ACCESS read-only 1314 DESCRIPTION 1315 "Write access is not required." 1317 OBJECT t11FspfMinLsInterval 1318 MIN-ACCESS read-only 1319 DESCRIPTION 1320 "Write access is not required." 1322 OBJECT t11FspfAdminStatus 1323 MIN-ACCESS read-only 1324 DESCRIPTION 1325 "Write access is not required." 1327 OBJECT t11FspfSetToDefault 1328 MIN-ACCESS read-only 1329 DESCRIPTION 1330 "Write access is not required." 1332 OBJECT t11FspfStorageType 1333 MIN-ACCESS read-only 1334 DESCRIPTION 1335 "Write access is not required." 1337 OBJECT t11FspfIfHelloInterval 1338 MIN-ACCESS read-only 1339 DESCRIPTION 1340 "Write access is not required." 1342 OBJECT t11FspfIfDeadInterval 1343 MIN-ACCESS read-only 1344 DESCRIPTION 1345 "Write access is not required." 1347 OBJECT t11FspfIfRetransmitInterval 1348 MIN-ACCESS read-only 1349 DESCRIPTION 1350 "Write access is not required." 1352 OBJECT t11FspfIfAdminStatus 1353 MIN-ACCESS read-only 1354 DESCRIPTION 1355 "Write access is not required." 1357 OBJECT t11FspfIfSetToDefault 1358 MIN-ACCESS read-only 1359 DESCRIPTION 1360 "Write access is not required." 1362 OBJECT t11FspfIfLinkCostFactor 1363 MIN-ACCESS read-only 1364 DESCRIPTION 1365 "Write access is not required." 1367 ::= { t11FspfMIBCompliances 1 } 1369 -- Units of Conformance 1371 t11FspfGeneralGroup OBJECT-GROUP 1372 OBJECTS { t11FspfMinLsArrival, 1373 t11FspfMinLsInterval, 1374 t11FspfLsRefreshTime, 1375 t11FspfMaxAge, 1376 t11FspfMaxAgeDiscards, 1377 t11FspfPathComputations, 1378 t11FspfChecksumErrors, 1379 t11FspfLsrs, 1380 t11FspfCreateTime, 1381 t11FspfAdminStatus, 1382 t11FspfOperStatus, 1383 t11FspfNbrStateChangNotifyEnable, 1384 t11FspfSetToDefault, 1385 t11FspfStorageType } 1386 STATUS current 1387 DESCRIPTION 1388 "A collection of objects for displaying and 1389 configuring FSPF parameters." 1390 ::= { t11FspfMIBGroups 1 } 1392 t11FspfIfGroup OBJECT-GROUP 1393 OBJECTS { t11FspfIfHelloInterval, 1394 t11FspfIfDeadInterval, 1395 t11FspfIfRetransmitInterval, 1396 t11FspfIfNbrState, 1397 t11FspfIfNbrDomainId, 1398 t11FspfIfNbrPortIndex, 1399 t11FspfIfAdminStatus, 1400 t11FspfIfCreateTime, 1401 t11FspfIfSetToDefault, 1402 t11FspfIfLinkCostFactor, 1403 t11FspfIfRowStatus, 1404 t11FspfIfStorageType, 1405 t11FspfIfPrevNbrState } 1406 STATUS current 1407 DESCRIPTION 1408 "A collection of objects for displaying the FSPF 1409 interface information." 1410 ::= { t11FspfMIBGroups 2 } 1412 t11FspfIfCounterGroup OBJECT-GROUP 1413 OBJECTS { t11FspfIfInLsuPkts, 1414 t11FspfIfInLsaPkts, 1415 t11FspfIfOutLsuPkts, 1416 t11FspfIfOutLsaPkts, 1417 t11FspfIfOutHelloPkts, 1418 t11FspfIfInHelloPkts, 1419 t11FspfIfRetransmittedLsuPkts, 1420 t11FspfIfInErrorPkts } 1421 STATUS current 1422 DESCRIPTION 1423 "A collection of objects for counting particular 1424 FSPF-packet occurrences on an interface." 1425 ::= { t11FspfMIBGroups 3 } 1427 t11FspfDatabaseGroup OBJECT-GROUP 1428 OBJECTS { t11FspfLsrAdvDomainId, 1429 t11FspfLsrAge, 1430 t11FspfLsrIncarnationNumber, 1431 t11FspfLsrCheckSum, 1432 t11FspfLsrLinks, 1433 t11FspfLinkNbrDomainId, 1434 t11FspfLinkPortIndex, 1435 t11FspfLinkNbrPortIndex, 1436 t11FspfLinkType, 1437 t11FspfLinkCost, 1438 t11FspfLinkNumber } 1439 STATUS current 1440 DESCRIPTION 1441 "A collection of objects for displaying the FSPF 1442 topology database information." 1443 ::= { t11FspfMIBGroups 4 } 1445 t11FspfNotificationGroup NOTIFICATION-GROUP 1446 NOTIFICATIONS { t11FspfNbrStateChangNotify } 1447 STATUS current 1448 DESCRIPTION 1449 "A collection of notifications for FSPF." 1450 ::= { t11FspfMIBGroups 5 } 1451 END 1453 7. Intellectual Property 1455 "The IETF takes no position regarding the validity or scope of any 1456 intellectual property or other rights that might be claimed to 1457 pertain to the implementation or use of the technology described in 1458 this document or the extent to which any license under such rights 1459 might or might not be available; neither does it represent that it 1460 has made any effort to identify any such rights. Information on the 1461 IETF's procedures with respect to rights in standards-track and 1462 standards-related documentation can be found in BCP-11. Copies of 1463 claims of rights made available for publication and any assurances of 1464 licenses to be made available, or the result of an attempt made to 1465 obtain a general license or permission for the use of such 1466 proprietary rights by implementors or users of this specification can 1467 be obtained from the IETF Secretariat." 1469 "The IETF invites any interested party to bring to its attention any 1470 copyrights, patents or patent applications, or other proprietary 1471 rights which may cover technology that may be required to practice 1472 this standard. Please address the information to the IETF Executive 1473 Director." 1475 8. Acknowledgements 1477 This document was originally developed and approved by the INCITS 1478 Task Group T11.5 (http://www.t11.org) as the SM-FSM project. We wish 1479 to acknowledge the many contributions and comments from the INCITS 1480 Technical Committee T11, including the following: 1482 T11 Chair: Robert Snively, Brocade 1483 T11 Vice Chair: Claudio DeSanti, Cisco Systems 1484 T11.5 Chair: Roger Cummings, Symantec 1485 T11.5 members, especially: 1486 Ken Hirata, Emulex 1487 Scott Kipp, McData 1488 Elizabeth G. Rodriguez, Dot Hill 1490 The document was subsequently approved by the IETF's IMSS Working Group, 1491 chaired by David Black (EMC Corporation). We also wish to acknowledge 1492 Bert Wijnen (Lucent Technologies), the IETF Area Director, for his 1493 review of the document. 1495 9. Normative References 1497 [RFC2578] 1498 McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M. 1499 and S. Waldbusser, "Structure of Management Information Version 2 1500 (SMIv2)", STD 58, RFC 2578, April 1999. 1502 [RFC2579] 1503 McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M. 1504 and S. Waldbusser, "Textual Conventions for SMIv2", STD 58, RFC 1505 2579, April 1999. 1507 [RFC2580] 1508 McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M. 1509 and S. Waldbusser, "Conformance Statements for SMIv2", STD 58, RFC 1510 2580, April 1999. 1512 [RFC2863] 1513 McCloghrie, K., and F. Kastenholz, "The Interface$ Group MIB", RFC 1514 2863, June 2000. 1516 [RFC3411] 1517 Harrington, D., Presuhn, R., and B. Wijnen, "An Architecture for 1518 Describing Simple Network Management Protocol (SNMP) Management 1519 Frameworks", STD 58, RFC 3411, December 2002. 1521 [FC-FS] 1522 "Fibre Channel - Framing and Signaling (FC-FS)" ANSI INCITS 1523 373-2003, April 2003. 1525 [FC-SW-4] 1526 "Fibre Channel - Switch Fabric - 4 (FC-SW-4)", ANSI INCITS 1527 418-2006, 2006. 1529 [FC-MGMT] 1530 K. McCloghrie, "Fibre Channel Management MIB", RFC 4044, May 2005. 1532 [FC-FAM-MIB] 1533 DeSanti, C., Gaonkar, V., McCloghrie, K., and S. Gai, "Fibre- 1534 Channel Fabric Address Manager MIB", Internet-Draft (draft-ietf- 1535 imss-fc-fam-mib-nn.txt), work-in-progress. 1537 [FC-RTM-MIB] 1538 DeSanti, C., Kode, S., McCloghrie, K., and S. Gai, "Fibre-Channel 1539 Routing Information MIB", Internet-Draft (draft-ietf-imss-fc-rtm- 1540 mib-nn.txt), work-in-progress. 1542 10. Informative References 1544 [RFC2741] 1545 Daniele, M., Wijnen, B., Ellison, M., and D. Francisco, "Agent 1546 Extensibility (AgentX) Protocol Version 1", RFC 2741, January 2000. 1548 [RFC2837] 1549 Teow, K., "Definitions of Managed Objects for the Fabric Element in 1550 Fibre Channel Standard", RFC 2837, May 2000. 1552 [RFC3410] 1553 Case, J., Mundy, R., Partain, D. and B. Stewart, "Introduction and 1554 Applicability Statements for Internet- Standard Management 1555 Framework", RFC 3410, December 2002. 1557 11. IANA Considerations 1559 IANA is requested to make a MIB OID assignment for the T11-FC-FSPF- 1560 MIB module under the appropriate subtree. 1562 12. Security Considerations 1564 There are several management objects defined in this MIB module with 1565 a MAX-ACCESS clause of read-write and/or read-create. Such objects 1566 may be considered sensitive or vulnerable in some network 1567 environments. The support for SET operations in a non-secure 1568 environment without proper protection can have a negative effect on 1569 network operations. These objects and their 1570 sensitivity/vulnerability are: 1572 t11FspfMinLsArrival, t11FspfMinLsInterval, 1573 t11FspfIfHelloInterval, t11FspfIfDeadInterval & 1574 t11FspfIfRetransmitInterval 1575 -- alter the responsiveness of the FSPF protocol 1577 t11FspfAdminStatus & t11FspfIfAdminStatus 1578 -- enable/disable dynamic routing via FSPF 1580 t11FspfSetToDefault & t11FspfIfSetToDefault 1581 -- nullify valid configuration changes 1583 t11FspfIfLinkCostFactor 1584 -- alter the choice of links 1586 t11FspfNbrStateChangNotifyEnable 1587 -- enable/disable notifications. 1589 The support for SET operations in a non-secure environment without 1590 proper protection can have a negative effect on network operations. 1592 Some of the readable objects in this MIB module (i.e., objects with a 1593 MAX-ACCESS other than not-accessible) may be considered sensitive or 1594 vulnerable in some network environments. It is thus important to 1595 control even GET and/or NOTIFY access to these objects and possibly 1596 to even encrypt the values of these objects when sending them over 1597 the network via SNMP. These are the tables and objects and their 1598 sensitivity/vulnerability: 1600 t11FspfTable -- contains per-Fabric parameters and statistics 1602 t11FspfIfTable -- contains per-interface parameters and statistics 1604 t11FspfLsrTable & t11FspfLinkTable -- database of LSR information, 1606 SNMP versions prior to SNMPv3 did not include adequate security. 1607 Even if the network itself is secure (for example by using IPSec), 1608 even then, there is no control as to who on the secure network is 1609 allowed to access and GET/SET (read/change/create/delete) the objects 1610 in this MIB module. 1612 It is RECOMMENDED that implementors consider the security features as 1613 provided by the SNMPv3 framework (see [RFC3410], section 8), 1614 including full support for the SNMPv3 cryptographic mechanisms (for 1615 authentication and privacy). 1617 Further, deployment of SNMP versions prior to SNMPv3 is NOT 1618 RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to 1619 enable cryptographic security. It is then a customer/operator 1620 responsibility to ensure that the SNMP entity giving access to an 1621 instance of this MIB module is properly configured to give access to 1622 the objects only to those principals (users) that have legitimate 1623 rights to indeed GET or SET (change/create/delete) them. 1625 13. Authors' Addresses 1627 Claudio DeSanti 1628 Cisco Systems, Inc. 1629 170 West Tasman Drive 1630 San Jose, CA 95134 USA 1631 Phone: +1 408 853-9172 1632 EMail: cds@cisco.com 1634 Vinay Gaonkar 1635 Cisco Systems, Inc. 1636 170 West Tasman Drive 1637 San Jose, CA 95134 USA 1638 Phone: +1 408 527-8576 1639 EMail: vgaonkar@cisco.com 1641 Keith McCloghrie 1642 Cisco Systems, Inc. 1643 170 West Tasman Drive 1644 San Jose, CA USA 95134 1645 Phone: +1 408-526-5260 1646 Email: kzm@cisco.com 1648 Silvano Gai 1649 Retired 1651 Full Copyright Statement 1653 Copyright (C) The Internet Society (2006). This document is subject 1654 to the rights, licenses and restrictions contained in BCP 78, and 1655 except as set forth therein, the authors retain all their rights. 1657 This document and the information contained herein are provided on an 1658 "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS 1659 OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET 1660 ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, 1661 INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE 1662 INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED 1663 WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 1665 Disclaimer of validity 1667 The IETF takes no position regarding the validity or scope of any 1668 Intellectual Property Rights or other rights that might be claimed to 1669 pertain to the implementation or use of the technology described in 1670 this document or the extent to which any license under such rights 1671 might or might not be available; nor does it represent that it has 1672 made any independent effort to identify any such rights. Information 1673 on the procedures with respect to rights in RFC documents can be 1674 found in BCP 78 and BCP 79. 1676 Copies of IPR disclosures made to the IETF Secretariat and any 1677 assurances of licenses to be made available, or the result of an 1678 attempt made to obtain a general license or permission for the use of 1679 such proprietary rights by implementers or users of this 1680 specification can be obtained from the IETF on-line IPR repository at 1681 http://www.ietf.org/ipr. 1683 The IETF invites any interested party to bring to its attention any 1684 copyrights, patents or patent applications, or other proprietary 1685 rights that may cover technology that may be required to implement 1686 this standard. Please address the information to the IETF at 1687 ietf-ipr@ietf.org. 1689 Acknowledgment 1691 Funding for the RFC Editor function is currently provided by the 1692 Internet Society.