idnits 2.17.1 draft-ietf-ips-ifcp-mib-04.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- ** Looks like you're using RFC 2026 boilerplate. This must be updated to follow RFC 3978/3979, as updated by 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 == The page length should not exceed 58 lines per page, but there was 20 longer pages, the longest (page 3) being 59 lines Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** The document seems to lack an IANA Considerations section. (See Section 2.2 of https://www.ietf.org/id-info/checklist for how to handle the case when there are no actions for IANA.) ** 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 1029: '... It is RECOMMENDED that implementers...' RFC 2119 keyword, line 1035: '... RECOMMENDED. Instead, it is RECOMM...' Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the RFC 3978 Section 5.4 Copyright Line does not match the current year -- 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 (March 2003) is 7712 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) == Missing Reference: 'RFC1213' is mentioned on line 135, but not defined == Unused Reference: 'IFCP001' is defined on line 1044, but no explicit reference was found in the text == Unused Reference: 'ISNS001' is defined on line 1049, but no explicit reference was found in the text == Unused Reference: 'RFC2737' is defined on line 1060, but no explicit reference was found in the text == Unused Reference: 'RFC2851' is defined on line 1063, but no explicit reference was found in the text == Unused Reference: 'RFC2571' is defined on line 1067, but no explicit reference was found in the text == Unused Reference: 'T11FCGS3' is defined on line 1088, but no explicit reference was found in the text -- Possible downref: Non-RFC (?) normative reference: ref. 'IFCP001' -- Possible downref: Non-RFC (?) normative reference: ref. 'ISNS001' -- Possible downref: Non-RFC (?) normative reference: ref. 'FCMGT01' ** Obsolete normative reference: RFC 2737 (Obsoleted by RFC 4133) ** Obsolete normative reference: RFC 2851 (Obsoleted by RFC 3291) ** Obsolete normative reference: RFC 2571 (Obsoleted by RFC 3411) Summary: 6 errors (**), 0 flaws (~~), 10 warnings (==), 5 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 Kevin Gibbons 3 Internet Draft Charles Monia 4 Josh Tseng 5 Expires: September 2003 Nishan Systems 7 Franco Travostino 8 Nortel 10 March 2003 12 Definitions of Managed Objects 13 For iFCP 15 Status of this Memo 17 This document is an Internet-Draft and is in full conformance with 18 all provisions of Section 10 of RFC2026. 20 Internet-Drafts are working documents of the Internet Engineering 21 Task Force (IETF), its areas, and its working groups. Note that 22 other groups may also distribute working documents as Internet- 23 Drafts. 25 Internet-Drafts are draft documents valid for a maximum of six 26 months and may be updated, replaced, or obsoleted by other 27 documents at any time. It is inappropriate to use Internet-Drafts 28 as reference material or to cite them other than as "work in 29 progress." 31 The list of current Internet-Drafts can be accessed at 32 http://www.ietf.org/ietf/1id-abstracts.txt. 34 The list of Internet-Draft Shadow Directories can be accessed at 35 http://www.ietf.org/shadow.html. 37 Copyright Notice 39 Copyright (C) The Internet Society (2003). All Rights Reserved. 41 Abstract 43 The iFCP protocol provides Fibre Channel fabric functionality on an 44 IP network in which TCP/IP switching and routing elements replace 45 Fibre Channel components. This draft provides a mechanism to 46 monitor and control iFCP Gateway instances, and their associated 47 sessions, using SNMP. 49 This memo is a product of the IP Storage (IPS) working group within 50 the Internet Engineering Task Force. Comments are solicited and 51 should be addressed to the working group's mailing list at 52 ips@ece.cmu.edu and/or the authors. 54 Gibbons Expires September 2003 1 55 Table of Contents 57 Status of this Memo...............................................1 58 Copyright Notice..................................................1 59 Abstract..........................................................1 60 Table of Contents.................................................2 61 1. The Internet-Standard Management Framework....................3 62 2. Overview......................................................3 63 3. Technical Description.........................................3 64 4. MIB Definition................................................4 65 5. Security Considerations......................................19 66 6. Normative References.........................................20 67 7. Informative References.......................................21 68 8. Authors' Addresses...........................................21 69 9. Full Copyright Statement.....................................21 71 Gibbons Expires September 2003 2 72 1. The Internet-Standard Management Framework 74 For a detailed overview of the documents that describe the current 75 Internet-Standard Management Framework, please refer to section 7 76 of RFC 3410 [RFC3410]. 78 Managed objects are accessed via a virtual information store, 79 termed the Management Information Base or MIB. MIB objects are 80 generally accessed through the Simple Network Management Protocol 81 (SNMP). Objects in the MIB are defined using the mechanisms 82 defined in the Structure of Management Information (SMI). This 83 memo specifies a MIB module that is compliant to the SMIv2, which 84 is described in STD 58, RFC 2578 [RFC2578], STD 58, RFC 2579 85 [RFC2579] and STD 58, RFC 2580 [RFC2580]. 87 2. Overview 89 The iFCP protocol can be used by FC to IP based storage gateways 90 for FCP storage interconnects. Figure 1 provides an example 91 interconnect between iFCP gateways. 93 Gateway Region Gateway Region 94 +--------+ +--------+ +--------+ +--------+ 95 | FC | | FC | | FC | | FC | 96 | Device | | Device | | Device | | Device | Fibre 97 |........| |........| FC |........| |........| Channel 98 | N_PORT | | N_PORT |<.........>| N_PORT | | N_PORT | Device 99 +---+----+ +---+----+ Traffic +----+---+ +----+---+ Domain 100 | | | | ^ 101 +---+----+ +---+----+ +----+---+ +----+---+ | 102 | F_PORT | | F_PORT | | F_PORT | | F_PORT | | 103 =+========+==+========+===========+========+==+========+========== 104 | iFCP Layer |<--------->| iFCP Layer | | 105 |....................| ^ |....................| | 106 | iFCP Portal | | | iFCP Portal | v 107 +--------+-----------+ | +----------+---------+ IP 108 iFCP|Gateway Control iFCP|Gateway Network 109 | Data | 110 | | 111 | | 112 |<------Encapsulated Frames------->| 113 | +------------------+ | 114 | | | | 115 +------+ IP Network +--------+ 116 | | 117 +------------------+ 119 The iFCP MIB is designed to allow SNMP to be used to monitor and 120 manage local iFCP gateway instances, including the configuration of 121 iFCP sessions between gateways. 123 3. Technical Description 125 Gibbons Expires September 2003 3 126 The MIB is divided into sections for iFCP local gateway instance 127 management, iFCP session management, and iFCP session statistics. 129 The section for iFCP gateway management provides default settings 130 and information about each local instance. A single management 131 entity can monitor multiple local gateway instances. Each local 132 gateway is conceptually an independent gateway that has both Fibre 133 Channel and IP interfaces. Other standard MIBs, such as the Fibre 134 Management MIB [FCMGT01], the Interfaces Group MIB [RFC2863] and 135 MIB II [RFC1213] can be used to manage non-iFCP specific gateway 136 parameters. The local gateway instance section provides iFCP 137 specific information as well as optional links to other standard 138 management MIBs. 140 The iFCP session management section provides information on iFCP 141 sessions that are using one of the local iFCP gateway instances. 142 This section allows the management of specific iFCP parameters. 144 The iFCP session statistics section provides statistical 145 information on the iFCP sessions that are using one of the local 146 iFCP gateways. These tables augment the session management table. 147 Additional statistical information for an iFCP gateway or session, 148 that is not iFCP specific, can be obtained using other standard 149 MIBs. The iFCP statistics are provided in both standard and low- 150 capacity (counter32) methods. 152 4. MIB Definition 154 IFCP-MGMT-MIB DEFINITIONS ::= BEGIN 155 -- 156 -- IETF iFCP Management Information Base (MIB) 157 -- 158 IMPORTS 159 MODULE-IDENTITY, 160 OBJECT-TYPE, 161 Counter32, 162 Counter64, 163 Integer32, 164 Unsigned32, 165 experimental 166 FROM SNMPv2-SMI 168 OBJECT-GROUP, 169 MODULE-COMPLIANCE 170 FROM SNMPv2-CONF 172 TEXTUAL-CONVENTION, 173 TruthValue 174 FROM SNMPv2-TC 176 -- From RFC 2571 177 SnmpAdminString 178 FROM SNMP-FRAMEWORK-MIB 180 Gibbons Expires September 2003 4 181 -- From RFC 2851 182 InetAddressType, 183 InetAddress 184 FROM INET-ADDRESS-MIB 186 -- From IETF Fibre Channel Management MIB, RFC TBD 187 FcNameIdOrZero, 188 FcAddressId 189 FROM FC-MGMT-MIB 190 ; 192 ifcpMgmtMIB MODULE-IDENTITY 193 LAST-UPDATED "200303010000Z" 194 ORGANIZATION "IETF IPS Working Group" 195 CONTACT-INFO " 196 Attn: Kevin Gibbons 197 Nishan Systems 198 3850 North First Street 199 San Jose, CA 95134 200 USA 201 Tel : +1 408 519-3700 202 email : kgibbons@nishansystems.com 204 Charles Monia 205 Nishan Systems 206 3850 North First Street 207 San Jose, CA 95134 208 USA 209 Tel : +1 408 519-3700 210 email : cmonia@nishansystems.com 212 Josh Tseng 213 Nishan Systems 214 3850 North First Street 215 San Jose, CA 95134 216 USA 217 Tel : +1 408 519-3700 218 email : jtseng@nishansystems.com 220 Franco Travostino 221 Nortel Networks 222 3 Federal Street 223 Billerica, MA 01821 224 USA 225 Tel : +1 978 288-7708 226 email : travos@nortelnetworks.com 227 " 228 DESCRIPTION "The MIB for internet Fibre Channel Protocol 229 (iFCP) management." 230 REVISION "200303010000Z" 231 DESCRIPTION "Initial version of iFCP Management Module. 232 This MIB published as RFC nnnn." 233 -- (to be assigned by RFC Editor) 234 ::= {experimental 4371} 236 Gibbons Expires September 2003 5 237 -- an IETF number has not yet been assigned 239 IfIndexType ::= TEXTUAL-CONVENTION 240 STATUS current 241 DESCRIPTION "Represents possible interface indexes that 242 can be used on the iFCP gateway. This can 243 be used as an index for the IF-MIB ifTable, 244 if supported by the system, or other 245 interface table, to obtain additional 246 information about the interface." 247 REFERENCE "RFC 2863, The Interfaces Group MIB (IF-MIB)" 248 SYNTAX Integer32 (1..2147483647) 250 IfcpVersionType ::= TEXTUAL-CONVENTION 251 STATUS current 252 DESCRIPTION "Represents the iFCP version supported." 253 SYNTAX Unsigned32 (0..255) 255 PortType ::= TEXTUAL-CONVENTION 256 STATUS current 257 DESCRIPTION "The value for a TCP Port being used for 258 an iFCP session. The canonical port for 259 iFCP is 3420." 260 REFERENCE "iFCP Protocol Specification, RFC XXXX" 261 SYNTAX Unsigned32 (0..65535) 263 IpTOVor0Type ::= TEXTUAL-CONVENTION 264 STATUS current 265 DESCRIPTION "The maximum propagation delay, in seconds, 266 for an encapsulated FC frame to traverse the 267 IP network. A value of 0 implies fibre 268 channel frame lifetime limits will not be 269 enforced." 270 REFERENCE "iFCP Protocol Specification, RFC XXXX" 271 SYNTAX Unsigned32 (0..3600) 273 LTIor0Type ::= TEXTUAL-CONVENTION 274 STATUS current 275 DESCRIPTION "The value for the Liveness Test Interval 276 (LTI) being used in an iFCP connection, in 277 seconds. A value of 0 implies no Liveness 278 Test Interval will be used." 279 REFERENCE "iFCP Protocol Specification, RFC XXXX" 280 SYNTAX Unsigned32 (0..65535) 282 IfcpSessionStateType ::= TEXTUAL-CONVENTION 283 STATUS current 284 DESCRIPTION "The value for an iFCP session state." 285 SYNTAX INTEGER {down(0), openPending(1), open(2)} 287 IfcpAddressModeType ::= TEXTUAL-CONVENTION 288 STATUS current 289 DESCRIPTION "The values for iFCP Address Translation 290 Mode." 292 Gibbons Expires September 2003 6 293 REFERENCE "iFCP Protocol Specification, RFC XXXX" 294 SYNTAX INTEGER {addressTransparent(0), 295 addressTranslation(1)} 297 -- 298 -- Internet Fibre Channel Protocol (iFCP) 299 -- 301 ifcpGatewayObj OBJECT IDENTIFIER ::= {ifcpMgmtMIB 1} 302 ifcpGatewayConformance OBJECT IDENTIFIER ::= {ifcpMgmtMIB 2} 304 -- 305 -- Local iFCP Gateway Instance Information ================== 306 -- 308 ifcpLclGatewayObjInfo OBJECT IDENTIFIER ::= {ifcpGatewayObj 1} 310 ifcpLclGtwyInstTable OBJECT-TYPE 311 SYNTAX SEQUENCE OF IfcpLclGtwyInstEntry 312 MAX-ACCESS not-accessible 313 STATUS current 314 DESCRIPTION 315 "Information about all local iFCP Gateway instances that can be 316 monitored and controled. This table contains an entry for each 317 local iFCP Gateway instance that is being managed." 318 ::= {ifcpLclGatewayObjInfo 1} 320 ifcpLclGtwyInstEntry OBJECT-TYPE 321 SYNTAX IfcpLclGtwyInstEntry 322 MAX-ACCESS not-accessible 323 STATUS current 324 DESCRIPTION 325 "An entry in the local iFCP Gateway Instance table. 326 Parameters and settings for the gateway are found here." 327 INDEX { ifcpLclGtwyInstIndex } 328 ::= {ifcpLclGtwyInstTable 1} 330 IfcpLclGtwyInstEntry ::= SEQUENCE { 331 ifcpLclGtwyInstIndex Unsigned32, 332 ifcpLclGtwyInstPhyIndex Unsigned32, 333 ifcpLclGtwyInstVersionMin IfcpVersionType, 334 ifcpLclGtwyInstVersionMax IfcpVersionType, 335 ifcpLclGtwyInstAddrTransMode IfcpAddressModeType, 336 ifcpLclGtwyInstFcBrdcstSupport TruthValue, 337 ifcpLclGtwyInstDefaultIpTOV IpTOVor0Type, 338 ifcpLclGtwyInstDefaultLTInterval LTIor0Type, 339 ifcpLclGtwyInstDescr SnmpAdminString, 340 ifcpLclGtwyInstNumActiveSessions Unsigned32 341 } 343 ifcpLclGtwyInstIndex OBJECT-TYPE 344 SYNTAX Unsigned32 (1..2147483647) 345 MAX-ACCESS not-accessible 346 STATUS current 348 Gibbons Expires September 2003 7 349 DESCRIPTION 350 "An arbitrary integer value to uniquely identify this iFCP 351 Gateway from other local Gateway instances." 352 ::= {ifcpLclGtwyInstEntry 1} 354 ifcpLclGtwyInstPhyIndex OBJECT-TYPE 355 SYNTAX Unsigned32 (0..2147483647) 356 MAX-ACCESS read-only 357 STATUS current 358 DESCRIPTION 359 "An index indicating the location of this local gateway within 360 a larger entity, if one exists. If supported, this is the 361 entPhysicalIndex from the Entity MIB (Version 2), for this iFCP 362 Gateway. If not supported it is either an index into a chassis 363 MIB, as supported by the system, or 0." 364 REFERENCE "RFC 2737, Entity MIB (Version 2)" 365 ::= {ifcpLclGtwyInstEntry 2} 367 ifcpLclGtwyInstVersionMin OBJECT-TYPE 368 SYNTAX IfcpVersionType 369 MAX-ACCESS read-only 370 STATUS current 371 DESCRIPTION 372 "The minimum iFCP protocol version supported by the local iFCP 373 gateway instance." 374 REFERENCE "iFCP Protocol Specification, RFC XXXX" 375 ::= {ifcpLclGtwyInstEntry 3} 377 ifcpLclGtwyInstVersionMax OBJECT-TYPE 378 SYNTAX IfcpVersionType 379 MAX-ACCESS read-only 380 STATUS current 381 DESCRIPTION 382 "The maximum iFCP protocol version supported by the local iFCP 383 gateway instance." 384 REFERENCE "iFCP Protocol Specification, RFC XXXX" 385 ::= {ifcpLclGtwyInstEntry 4} 387 ifcpLclGtwyInstAddrTransMode OBJECT-TYPE 388 SYNTAX IfcpAddressModeType 389 MAX-ACCESS read-write 390 STATUS current 391 DESCRIPTION 392 "The local iFCP gateway operating mode. Changing this value may 393 cause existing sessions to be disrupted." 394 DEFVAL { addressTranslation } 395 ::= {ifcpLclGtwyInstEntry 5} 397 ifcpLclGtwyInstFcBrdcstSupport OBJECT-TYPE 398 SYNTAX TruthValue 399 MAX-ACCESS read-write 400 STATUS current 401 DESCRIPTION 402 "Whether the local iFCP gateway supports FC Broadcast. Changing 404 Gibbons Expires September 2003 8 405 this value may cause existing sessions to be disrupted." 406 DEFVAL { false } 407 ::= {ifcpLclGtwyInstEntry 6} 409 ifcpLclGtwyInstDefaultIpTOV OBJECT-TYPE 410 SYNTAX IpTOVor0Type 411 MAX-ACCESS read-write 412 STATUS current 413 DESCRIPTION 414 "The default IP_TOV used for iFCP sessions at this gateway. 415 This is the default maximum propagation delay that will be 416 used for an iFCP session. The value can be changed on a 417 per-session basis. The valid range is 0 - 3600 seconds. 418 A value of 0 implies that fibre channel frame lifetime limits 419 will not be enforced." 420 DEFVAL { 6 } 421 ::= {ifcpLclGtwyInstEntry 7} 423 ifcpLclGtwyInstDefaultLTInterval OBJECT-TYPE 424 SYNTAX LTIor0Type 425 MAX-ACCESS read-write 426 STATUS current 427 DESCRIPTION 428 "The default Liveness Test Interval (LTI), in seconds, used 429 for iFCP sessions at this gateway. This is the default 430 value for an iFCP session and can be changed on a 431 per-session basis. The valid range is 0 - 65535 seconds. 432 A value of 0 implies no Liveness Test Interval will be 433 performed on a session." 434 DEFVAL { 10 } 435 ::= {ifcpLclGtwyInstEntry 8} 437 ifcpLclGtwyInstDescr OBJECT-TYPE 438 SYNTAX SnmpAdminString (SIZE (0..64)) 439 MAX-ACCESS read-write 440 STATUS current 441 DESCRIPTION 442 "A user entered description for this iFCP Gateway." 443 DEFVAL { "" } 444 ::= {ifcpLclGtwyInstEntry 9} 446 ifcpLclGtwyInstNumActiveSessions OBJECT-TYPE 447 SYNTAX Unsigned32 (0..4294967295) 448 MAX-ACCESS read-only 449 STATUS current 450 DESCRIPTION 451 "The current total number of iFCP sessions in the open or 452 open-pending state." 453 ::= {ifcpLclGtwyInstEntry 10} 455 -- 456 -- iFCP N Port Session Information ============================ 457 -- 459 Gibbons Expires September 2003 9 460 ifcpNportSessionInfo OBJECT IDENTIFIER ::= {ifcpGatewayObj 2} 462 ifcpSessionAttributesTable OBJECT-TYPE 463 SYNTAX SEQUENCE OF 464 IfcpSessionAttributesEntry 465 MAX-ACCESS not-accessible 466 STATUS current 467 DESCRIPTION 468 "An iFCP session consists of the pair of N_PORTs comprising 469 the session endpoints joined by a single TCP/IP connection. 470 This table provides information on each iFCP session currently 471 using a local iFCP Gateway instance. iFCP sessions are created 472 and removed by the iFCP Gateway instances, which are reflected 473 in this table." 474 ::= {ifcpNportSessionInfo 1} 476 ifcpSessionAttributesEntry OBJECT-TYPE 477 SYNTAX IfcpSessionAttributesEntry 478 MAX-ACCESS not-accessible 479 STATUS current 480 DESCRIPTION 481 "An entry in the session table." 482 INDEX { ifcpLclGtwyInstIndex, ifcpSessionIndex } 483 ::= {ifcpSessionAttributesTable 1} 485 IfcpSessionAttributesEntry ::= SEQUENCE { 486 ifcpSessionIndex Integer32, 487 ifcpSessionLclPrtlIfIndex IfIndexType, 488 ifcpSessionLclPrtlAddrType InetAddressType, 489 ifcpSessionLclPrtlAddr InetAddress, 490 ifcpSessionLclPrtlTcpPort PortType, 491 ifcpSessionLclNpWwun FcNameIdOrZero, 492 ifcpSessionLclNpFcid FcAddressId, 493 ifcpSessionRmtNpWwun FcNameIdOrZero, 494 ifcpSessionRmtPrtlIfAddrType InetAddressType, 495 ifcpSessionRmtPrtlIfAddr InetAddress, 496 ifcpSessionRmtPrtlTcpPort PortType, 497 ifcpSessionRmtNpFcid FcAddressId, 498 ifcpSessionRmtNpFcidAlias FcAddressId, 499 ifcpSessionIpTOV IpTOVor0Type, 500 ifcpSessionLclLTIntvl LTIor0Type, 501 ifcpSessionRmtLTIntvl LTIor0Type, 502 ifcpSessionBound TruthValue 503 } 505 ifcpSessionIndex OBJECT-TYPE 506 SYNTAX Integer32 (1..2147483647) 507 MAX-ACCESS not-accessible 508 STATUS current 509 DESCRIPTION 510 "The iFCP session index is a unique value used as an index 511 to the table, along with a specific local iFCP Gateway 512 instance. This index is used because the local N Port and 513 remote N Port information would create an complex index that 515 Gibbons Expires September 2003 10 516 would be difficult to implement." 517 ::= {ifcpSessionAttributesEntry 1} 519 ifcpSessionLclPrtlIfIndex OBJECT-TYPE 520 SYNTAX IfIndexType 521 MAX-ACCESS read-only 522 STATUS current 523 DESCRIPTION 524 "This is the local interface in the ifTable being used as the 525 local portal in this session, as described in the IF-MIB. 526 This can be used as an index for the ifTable to obtain 527 additional information about the interface." 528 REFERENCE "RFC 2863, The Interfaces Group MIB (IF-MIB)" 529 ::= {ifcpSessionAttributesEntry 2} 531 ifcpSessionLclPrtlAddrType OBJECT-TYPE 532 SYNTAX InetAddressType 533 MAX-ACCESS read-only 534 STATUS current 535 DESCRIPTION 536 "The type of address in ifcpSessionLclIfAddr." 537 ::= {ifcpSessionAttributesEntry 3} 539 ifcpSessionLclPrtlAddr OBJECT-TYPE 540 SYNTAX InetAddress 541 MAX-ACCESS read-only 542 STATUS current 543 DESCRIPTION 544 "This is the external IP address of the interface being used 545 for the iFCP local portal in this session." 546 ::= {ifcpSessionAttributesEntry 4} 548 ifcpSessionLclPrtlTcpPort OBJECT-TYPE 549 SYNTAX PortType 550 MAX-ACCESS read-only 551 STATUS current 552 DESCRIPTION 553 "This is the TCP port number that is being used for the iFCP 554 local portal in this session. This is normally an ephemeral 555 port number selected by the gateway." 556 ::= {ifcpSessionAttributesEntry 5} 558 ifcpSessionLclNpWwun OBJECT-TYPE 559 SYNTAX FcNameIdOrZero 560 MAX-ACCESS read-only 561 STATUS current 562 DESCRIPTION 563 "World Wide Unique Name of the local N Port. For an unbound 564 session this variable will be empty." 565 DEFVAL { "" } 566 ::= {ifcpSessionAttributesEntry 6} 568 ifcpSessionLclNpFcid OBJECT-TYPE 569 SYNTAX FcAddressId 571 Gibbons Expires September 2003 11 572 MAX-ACCESS read-only 573 STATUS current 574 DESCRIPTION 575 "Fibre Channel Identifier of the local N Port. For an unbound 576 session this variable will be empty" 577 ::= {ifcpSessionAttributesEntry 7} 579 ifcpSessionRmtNpWwun OBJECT-TYPE 580 SYNTAX FcNameIdOrZero 581 MAX-ACCESS read-only 582 STATUS current 583 DESCRIPTION 584 "World Wide Unique Name of the remote N Port. For an unbound 585 session this variable will be empty." 586 DEFVAL { "" } 587 ::= {ifcpSessionAttributesEntry 8} 589 ifcpSessionRmtPrtlIfAddrType OBJECT-TYPE 590 SYNTAX InetAddressType 591 MAX-ACCESS read-only 592 STATUS current 593 DESCRIPTION 594 "The type of address in ifcpSessionRmtPrtlIfAddr." 595 ::= {ifcpSessionAttributesEntry 9} 597 ifcpSessionRmtPrtlIfAddr OBJECT-TYPE 598 SYNTAX InetAddress 599 MAX-ACCESS read-only 600 STATUS current 601 DESCRIPTION 602 "This is the remote gateway IP address being used for the 603 portal on the remote iFCP gateway." 604 ::= {ifcpSessionAttributesEntry 10} 606 ifcpSessionRmtPrtlTcpPort OBJECT-TYPE 607 SYNTAX PortType 608 MAX-ACCESS read-only 609 STATUS current 610 DESCRIPTION 611 "This is the TCP port number being used for the portal on the 612 remote iFCP gateway. Generally, this will be the iFCP 613 canonical port." 614 DEFVAL { 3420 } 615 ::= {ifcpSessionAttributesEntry 11} 617 ifcpSessionRmtNpFcid OBJECT-TYPE 618 SYNTAX FcAddressId 619 MAX-ACCESS read-only 620 STATUS current 621 DESCRIPTION 622 "Fibre Channel Identifier of the remote N Port. For an unbound 623 session this variable will be empty." 624 ::= {ifcpSessionAttributesEntry 12} 626 Gibbons Expires September 2003 12 627 ifcpSessionRmtNpFcidAlias OBJECT-TYPE 628 SYNTAX FcAddressId 629 MAX-ACCESS read-only 630 STATUS current 631 DESCRIPTION 632 "Fibre Channel Identifier Alias assigned by the local gateway 633 for the remote N Port. For an unbound session this variable 634 will be empty." 635 ::= {ifcpSessionAttributesEntry 13} 637 ifcpSessionIpTOV OBJECT-TYPE 638 SYNTAX IpTOVor0Type 639 MAX-ACCESS read-write 640 STATUS current 641 DESCRIPTION 642 "The IP_TOV being used for this iFCP session. This is the 643 maximum propagation delay that will be used for the iFCP 644 session. The value can be changed on a per-session basis 645 and initially defaults to ifcpLclGtwyInstDefaultIpTOV for 646 the local gateway instance. The valid range is 0 - 3600 647 seconds. A value of 0 implies fibre channel frame lifetime 648 limits will not be enforced." 649 ::= {ifcpSessionAttributesEntry 14} 651 ifcpSessionLclLTIntvl OBJECT-TYPE 652 SYNTAX LTIor0Type 653 MAX-ACCESS read-only 654 STATUS current 655 DESCRIPTION 656 "The Liveness Test Interval (LTI) used for this iFCP session. 657 The value can be changed on a per-session basis and initially 658 defaults to ifcpLclGtwyInstDefaultLTInterval for the local 659 gateway instance. The valid range is 0 - 65535 seconds. 660 A value of 0 implies that the gateway will not originate 661 Liveness Test messages for the session." 662 ::= {ifcpSessionAttributesEntry 15} 664 ifcpSessionRmtLTIntvl OBJECT-TYPE 665 SYNTAX LTIor0Type 666 MAX-ACCESS read-only 667 STATUS current 668 DESCRIPTION 669 "The Liveness Test Interval (LTI) as requested by the remote 670 gateway instance to use for this iFCP session. This value may 671 change over the life of the session. The valid range is 0 - 672 65535 seconds. A value of 0 implies that the remote gateway 673 has not been requested to originate Liveness Test messages for 674 the session." 675 ::= {ifcpSessionAttributesEntry 16} 677 ifcpSessionBound OBJECT-TYPE 678 SYNTAX TruthValue 679 MAX-ACCESS read-only 680 STATUS current 682 Gibbons Expires September 2003 13 683 DESCRIPTION 684 "This value indicates whether this session is bound to a 685 specific local and remote N Port. Sessions by default are 686 unbound and ready for future assignment to a local and remote 687 N Port." 688 ::= {ifcpSessionAttributesEntry 17} 690 -- 691 -- Local iFCP Gateway Instance Session Statistics ============= 692 -- 694 ifcpSessionStatsTable OBJECT-TYPE 695 SYNTAX SEQUENCE OF 696 IfcpSessionStatsEntry 697 MAX-ACCESS not-accessible 698 STATUS current 699 DESCRIPTION 700 "This table provides statistics on an iFCP session." 701 ::= {ifcpNportSessionInfo 2} 703 ifcpSessionStatsEntry OBJECT-TYPE 704 SYNTAX IfcpSessionStatsEntry 705 MAX-ACCESS not-accessible 706 STATUS current 707 DESCRIPTION 708 "iFCP specific statistics per session." 709 AUGMENTS {ifcpSessionAttributesEntry} 710 ::= {ifcpSessionStatsTable 1} 712 IfcpSessionStatsEntry ::= SEQUENCE { 713 ifcpSessionState IfcpSessionStateType, 714 ifcpSessionDuration Unsigned32, 715 ifcpSessionTxFrames Counter64, 716 ifcpSessionRxFrames Counter64, 717 ifcpSessionStaleFrames Counter64, 718 ifcpSessionHeaderCRCErrors Counter64, 719 ifcpSessionFcPayloadCRCErrors Counter64, 720 ifcpSessionOtherErrors Counter64 721 } 723 ifcpSessionState OBJECT-TYPE 724 SYNTAX IfcpSessionStateType 725 MAX-ACCESS read-only 726 STATUS current 727 DESCRIPTION 728 "The current session operating state." 729 ::= {ifcpSessionStatsEntry 1} 731 ifcpSessionDuration OBJECT-TYPE 732 SYNTAX Unsigned32 (0..4294967295) 733 MAX-ACCESS read-only 734 STATUS current 735 DESCRIPTION 736 "This indicates, in seconds, how long the iFCP session has 738 Gibbons Expires September 2003 14 739 been in an open or open-pending state. When a session is 740 down the value is reset to 0." 741 ::= {ifcpSessionStatsEntry 2} 743 ifcpSessionTxFrames OBJECT-TYPE 744 SYNTAX Counter64 745 MAX-ACCESS read-only 746 STATUS current 747 DESCRIPTION 748 "The total number of iFCP frames transmitted since the 749 connection was first established." 750 ::= {ifcpSessionStatsEntry 3} 752 ifcpSessionRxFrames OBJECT-TYPE 753 SYNTAX Counter64 754 MAX-ACCESS read-only 755 STATUS current 756 DESCRIPTION 757 "The total number of iFCP frames received since the 758 connection was first established." 759 ::= {ifcpSessionStatsEntry 4} 761 ifcpSessionStaleFrames OBJECT-TYPE 762 SYNTAX Counter64 763 MAX-ACCESS read-only 764 STATUS current 765 DESCRIPTION 766 "The total number of received iFCP frames that were stale and 767 discarded since the connection was first established." 768 ::= {ifcpSessionStatsEntry 5} 770 ifcpSessionHeaderCRCErrors OBJECT-TYPE 771 SYNTAX Counter64 772 MAX-ACCESS read-only 773 STATUS current 774 DESCRIPTION 775 "The total number of CRC errors that occurred in the frame 776 header, detected since the connection was first established. 777 Usually, a single Header CRC error is sufficient to 778 terminate an iFCP session." 779 ::= {ifcpSessionStatsEntry 6} 781 ifcpSessionFcPayloadCRCErrors OBJECT-TYPE 782 SYNTAX Counter64 783 MAX-ACCESS read-only 784 STATUS current 785 DESCRIPTION 786 "The total number of CRC errors that occurred in the Fibre 787 Channel frame payload detected since the connection was first 788 established." 789 ::= {ifcpSessionStatsEntry 7} 791 ifcpSessionOtherErrors OBJECT-TYPE 792 SYNTAX Counter64 794 Gibbons Expires September 2003 15 795 MAX-ACCESS read-only 796 STATUS current 797 DESCRIPTION 798 "The total number of errors, other then errors explicitly 799 measured, detected since the connection was first established." 800 ::= {ifcpSessionStatsEntry 8} 802 -- 803 -- Low Capacity Statistics 804 -- 806 ifcpSessionLcStatsTable OBJECT-TYPE 807 SYNTAX SEQUENCE OF 808 IfcpSessionLcStatsEntry 809 MAX-ACCESS not-accessible 810 STATUS current 811 DESCRIPTION 812 "This table provides low capacity statistics on an iFCP session. 813 This is provided for backward compatibility with systems that 814 do not support Counter64." 815 ::= {ifcpNportSessionInfo 3} 817 ifcpSessionLcStatsEntry OBJECT-TYPE 818 SYNTAX IfcpSessionLcStatsEntry 819 MAX-ACCESS not-accessible 820 STATUS current 821 DESCRIPTION 822 "iFCP specific statistics per session." 823 AUGMENTS {ifcpSessionAttributesEntry} 824 ::= {ifcpSessionLcStatsTable 1} 826 IfcpSessionLcStatsEntry ::= SEQUENCE { 827 ifcpSessionLcTxFrames Counter32, 828 ifcpSessionLcRxFrames Counter32, 829 ifcpSessionLcStaleFrames Counter32, 830 ifcpSessionLcHeaderCRCErrors Counter32, 831 ifcpSessionLcFcPayloadCRCErrors Counter32, 832 ifcpSessionLcOtherErrors Counter32 833 } 835 ifcpSessionLcTxFrames OBJECT-TYPE 836 SYNTAX Counter32 837 MAX-ACCESS read-only 838 STATUS current 839 DESCRIPTION 840 "The total number of iFCP frames transmitted since the 841 connection was first established." 842 ::= {ifcpSessionLcStatsEntry 1} 844 ifcpSessionLcRxFrames OBJECT-TYPE 845 SYNTAX Counter32 846 MAX-ACCESS read-only 847 STATUS current 848 DESCRIPTION 850 Gibbons Expires September 2003 16 851 "The total number of iFCP frames received since the 852 connection was first established." 853 ::= {ifcpSessionLcStatsEntry 2} 855 ifcpSessionLcStaleFrames OBJECT-TYPE 856 SYNTAX Counter32 857 MAX-ACCESS read-only 858 STATUS current 859 DESCRIPTION 860 "The total number of received iFCP frames that were stale and 861 discarded since the connection was first established." 862 ::= {ifcpSessionLcStatsEntry 3} 864 ifcpSessionLcHeaderCRCErrors OBJECT-TYPE 865 SYNTAX Counter32 866 MAX-ACCESS read-only 867 STATUS current 868 DESCRIPTION 869 "The total number of CRC errors that occurred in the frame 870 header, detected since the connection was first established. 871 Usually, a single Header CRC error is sufficient to 872 terminate an iFCP session." 873 ::= {ifcpSessionLcStatsEntry 4} 875 ifcpSessionLcFcPayloadCRCErrors OBJECT-TYPE 876 SYNTAX Counter32 877 MAX-ACCESS read-only 878 STATUS current 879 DESCRIPTION 880 "The total number of CRC errors that occurred in the Fibre 881 Channel frame payload detected since the connection was first 882 established." 883 ::= {ifcpSessionLcStatsEntry 5} 885 ifcpSessionLcOtherErrors OBJECT-TYPE 886 SYNTAX Counter32 887 MAX-ACCESS read-only 888 STATUS current 889 DESCRIPTION 890 "The total number of errors, other then errors explicitly 891 measured, detected since the connection was first established." 892 ::= {ifcpSessionLcStatsEntry 6} 894 --========================================================== 896 ifcpGroups OBJECT IDENTIFIER ::= {ifcpGatewayConformance 1} 898 ifcpLclGatewayGroup OBJECT-GROUP 899 OBJECTS { 900 ifcpLclGtwyInstPhyIndex, 901 ifcpLclGtwyInstVersionMin, 902 ifcpLclGtwyInstVersionMax, 903 ifcpLclGtwyInstAddrTransMode, 904 ifcpLclGtwyInstFcBrdcstSupport, 906 Gibbons Expires September 2003 17 907 ifcpLclGtwyInstDefaultIpTOV, 908 ifcpLclGtwyInstDefaultLTInterval, 909 ifcpLclGtwyInstDescr, 910 ifcpLclGtwyInstNumActiveSessions 911 } 912 STATUS current 913 DESCRIPTION 914 "iFCP local device info group" 915 ::= {ifcpGroups 1} 917 ifcpLclGatewaySessionGroup OBJECT-GROUP 918 OBJECTS { 919 ifcpSessionLclPrtlIfIndex, 920 ifcpSessionLclPrtlAddrType, 921 ifcpSessionLclPrtlAddr, 922 ifcpSessionLclPrtlTcpPort, 923 ifcpSessionLclNpWwun, 924 ifcpSessionLclNpFcid, 925 ifcpSessionRmtNpWwun, 926 ifcpSessionRmtPrtlIfAddrType, 927 ifcpSessionRmtPrtlIfAddr, 928 ifcpSessionRmtPrtlTcpPort, 929 ifcpSessionRmtNpFcid, 930 ifcpSessionRmtNpFcidAlias, 931 ifcpSessionIpTOV, 932 ifcpSessionLclLTIntvl, 933 ifcpSessionRmtLTIntvl, 934 ifcpSessionBound 935 } 936 STATUS current 937 DESCRIPTION 938 "iFCP Session group" 939 ::= {ifcpGroups 4} 941 ifcpLclGatewaySessionStatsGroup OBJECT-GROUP 942 OBJECTS { 943 ifcpSessionState, 944 ifcpSessionDuration, 945 ifcpSessionTxFrames, 946 ifcpSessionRxFrames, 947 ifcpSessionStaleFrames, 948 ifcpSessionHeaderCRCErrors, 949 ifcpSessionFcPayloadCRCErrors, 950 ifcpSessionOtherErrors 951 } 952 STATUS current 953 DESCRIPTION 954 "iFCP Session Statistics group" 955 ::= {ifcpGroups 5} 957 ifcpLclGatewaySessionLcStatsGroup OBJECT-GROUP 958 OBJECTS { 959 ifcpSessionLcTxFrames, 960 ifcpSessionLcRxFrames, 962 Gibbons Expires September 2003 18 963 ifcpSessionLcStaleFrames, 964 ifcpSessionLcHeaderCRCErrors, 965 ifcpSessionLcFcPayloadCRCErrors, 966 ifcpSessionLcOtherErrors 967 } 968 STATUS current 969 DESCRIPTION 970 "iFCP Session Low Capacity Statistics group" 971 ::= {ifcpGroups 6} 973 ifcpCompliances OBJECT IDENTIFIER ::= {ifcpGatewayConformance 2} 975 ifcpGatewayComplianceV1 MODULE-COMPLIANCE 976 STATUS current 977 DESCRIPTION 978 "Minimum implementation for iFCP MIB compliance." 979 MODULE -- this module 980 MANDATORY-GROUPS { 981 ifcpLclGatewayGroup 982 } 983 ::= {ifcpCompliances 1} 985 END 987 5. Security Considerations 989 There are a number of management objects defined in this MIB module 990 with a MAX-ACCESS clause of read-write and/or read-create. Such 991 objects may be considered sensitive or vulnerable in some network 992 environments. The support for SET operations in a non-secure 993 environment without proper protection can have a negative effect on 994 network operations. 996 Changing the following object values, with a MAX-ACCESS of read- 997 write, may cause disruption in storage traffic: 998 ifcpLclGtwyInstAddrTransMode 999 ifcpLclGtwyInstFcBrdcstSupport 1000 ifcpLclGtwyInstDefaultIpTOV 1001 ifcpLclGtwyInstDefaultLTInterval 1002 ifcpSessionIpTOV 1004 Changing the following object value, with a MAX-ACCESS of read- 1005 write, may cause a user to lose track of the iFCP gateway: 1006 ifcpLclGtwyInstDescr 1008 Some of the readable objects in this MIB module (i.e., objects with 1009 a MAX-ACCESS other than not-accessible) may be considered sensitive 1010 or vulnerable in some network environments. It is thus important 1011 to control even GET and/or NOTIFY access to these objects and 1012 possibly to even encrypt the values of these objects when sending 1013 them over the network via SNMP. These are the tables and objects 1014 and their sensitivity/vulnerability: 1016 Gibbons Expires September 2003 19 1017 The following object tables provide information about storage 1018 traffic sessions, and can indicate to a user who is communicating 1019 and exchanging storage data: 1020 ifcpLclGtwyInstTable 1021 ifcpSessionAttributesTable 1023 SNMP versions prior to SNMPv3 did not include adequate security. 1024 Even if the network itself is secure (for example by using IPSec), 1025 even then, there is no control as to who on the secure network is 1026 allowed to access and GET/SET (read/change/create/delete) the 1027 objects in this MIB module. 1029 It is RECOMMENDED that implementers consider the security features 1030 as provided by the SNMPv3 framework (see [RFC3410], section 8), 1031 including full support for the SNMPv3 cryptographic mechanisms (for 1032 authentication and privacy). 1034 Further, deployment of SNMP versions prior to SNMPv3 is NOT 1035 RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to 1036 enable cryptographic security. It is then a customer/operator 1037 responsibility to ensure that the SNMP entity giving access to an 1038 instance of this MIB module is properly configured to give access 1039 to the objects only to those principals (users) that have 1040 legitimate rights to indeed GET or SET (change/create/delete) them. 1042 6. Normative References 1044 [IFCP001] Charles Monia, Rod Mullendore, Franco Travostino, 1045 Wayland Jeong, Mark Edwards, "iFCP - A Protocol for 1046 Internet Fibre Channel Storage Networking", , Expires February 2003 1049 [ISNS001] Josh Tseng, Kevin Gibbons, Franco Travostino, Curt Du 1050 Laney, Joe Souza "iSNS Internet Storage Name Service", 1051 , Expires March 2003 1053 [FCMGT01] Keith McCloghrie, "Fibre Channel Management MIB", 1054 , Expires December 1055 2002 1057 [RFC2863] McCloghrie, K., Kastenholz, F., "The Interfaces Group 1058 MIB (IF-MIB)", RFC 2863, June 2000. 1060 [RFC2737] McCloghrie, K., Bierman, A., "Entity MIB (Version 2)", 1061 RFC 2737, December 1999. 1063 [RFC2851] M. Daniele, B. Haberman, S. Routhier, J. Schoenwaelder 1064 "Textual Conventions for Internet Network Addresses", 1065 RFC 2851, June 2000. 1067 [RFC2571] Harrington, D., Presuhn, R., and B. Wijnen, "An 1068 Architecture for Describing SNMP Management Frameworks", 1069 RFC 2571, April 1999. 1071 Gibbons Expires September 2003 20 1073 [RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, 1074 J., Rose, M. and S. Waldbusser, "Structure of Management 1075 Information Version 2 (SMIv2)", STD 58, RFC 2578, April 1076 1999. 1078 [RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, 1079 J., Rose, M. and S. Waldbusser, "Textual Conventions for 1080 SMIv2", STD 58, RFC 2579, April 1999. 1082 [RFC2580] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, 1083 J., Rose, M. and S. Waldbusser, "Conformance Statements 1084 for SMIv2", STD 58, RFC 2580, April 1999. 1086 7. Informative References 1088 [T11FCGS3] Fibre Channel - Generic Services 3, NCITS 348-2000. 1090 [RFC3410] Case, J., Mundy, R., Partain, D. and B. Stewart, 1091 "Introduction and Applicability Statements for Internet- 1092 Standard Management Framework", RFC 3410, December 2002. 1094 8. Authors' Addresses 1096 Kevin Gibbons 1097 E-mail: kgibbons@NishanSystems.com, 1098 Charles Monia 1099 E-mail: cmonia@NishanSystems.com, 1100 Josh Tseng 1101 E-mail: jtseng@NishanSystems.com, 1102 Postal: Nishan Systems 1103 3850 North First Street 1104 San Jose, CA 95134-1702 1105 USA 1107 Tel: (408) 519-3700 1108 Fax: (408) 519-3705 1110 Franco Travostino 1111 Nortel Networks 1112 3 Federal Street 1113 Billerica, MA 01821 1114 USA 1116 Tel: (978) 288-7708 1118 E-mail: travos@nortelnetworks.com 1120 9. Full Copyright Statement 1122 "Copyright (C) The Internet Society 2002. All Rights Reserved. 1123 This document and translations of it may be copied and furnished 1124 to others, and derivative works that comment on or otherwise 1126 Gibbons Expires September 2003 21 1127 explain it or assist in its implementation may be prepared, 1128 copied, published and distributed, in whole or in part, without 1129 restriction of any kind, provided that the above copyright notice 1130 and this paragraph are included on all such copies and derivative 1131 works. However, this document itself may not be modified in any 1132 way, such as by removing the copyright notice or references to 1133 the Internet Society or other Internet organizations, except as 1134 needed for the purpose of developing Internet standards in which 1135 case the procedures for copyrights defined in the Internet 1136 Standards process must be followed, or as required to translate 1137 it into languages other than English. 1139 The limited permissions granted above are perpetual and will not 1140 be revoked by the Internet Society or its successors or assigns. 1142 This document and the information contained herein is provided on 1143 An "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET 1144 ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR 1145 IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE 1146 OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY 1147 IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR 1148 PURPOSE." 1150 Gibbons Expires September 2003 22