idnits 2.17.1 draft-ietf-storm-iscsimib-04.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- No issues found here. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year == The document seems to contain a disclaimer for pre-RFC5378 work, but was first submitted on or after 10 November 2008. The disclaimer is usually necessary only for documents that revise or obsolete older RFCs, and that take significant amounts of text from those RFCs. If you can contact all authors of the source material and they are willing to grant the BCP78 rights to the IETF Trust, you can and should remove the disclaimer. Otherwise, the disclaimer is needed and you can ignore this comment. (See the Legal Provisions document at https://trustee.ietf.org/license-info for more information.) -- The document date (April 2, 2013) is 4036 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) ** Obsolete normative reference: RFC 3720 (Obsoleted by RFC 7143) -- Possible downref: Non-RFC (?) normative reference: ref. 'RFCcccc' == Outdated reference: A later version (-09) exists of draft-ietf-storm-iscsi-sam-06 -- Obsolete informational reference (is this intentional?): RFC 4544 (Obsoleted by RFC 7147) Summary: 1 error (**), 0 flaws (~~), 3 warnings (==), 3 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 1 INTERNET-DRAFT Mark Bakke 2 STORM Working Group Dell 3 Intended status: Proposed Standard Prakash Venkatesen 4 Expires: October 2013 HCL Technologies 5 Obsoletes: 4544 April 2, 2013 7 Definitions of Managed Objects for Internet Small Computer System 8 Interface (iSCSI) 9 draft-ietf-storm-iscsimib-04.txt 11 Status of this Memo 13 This Internet-Draft is submitted to IETF in full conformance with the 14 provisions of BCP 78 and BCP 79. 16 Internet-Drafts are working documents of the Internet Engineering 17 Task Force (IETF), its areas, and its working groups. Note that 18 other groups may also distribute working documents as Internet- 19 Drafts. 21 Internet-Drafts are draft documents valid for a maximum of six months 22 and may be updated, replaced, or obsoleted by other documents at any 23 time. It is inappropriate to use Internet-Drafts as reference 24 material or to cite them other than as "work in progress." 26 The list of current Internet-Drafts can be accessed at 27 http://www.ietf.org/ietf/1id-abstracts.txt 29 The list of Internet-Draft Shadow Directories can be accessed at 30 http://www.ietf.org/shadow.html 32 This Internet-Draft will expire on October 2, 2013. 34 Copyright Notice 36 Copyright (c) 2013 IETF Trust and the persons identified as the 37 document authors. All rights reserved. 39 This document is subject to BCP 78 and the IETF Trust's Legal 40 Provisions Relating to IETF Documents 41 (http://trustee.ietf.org/license-info) in effect on the date of 42 publication of this document. Please review these documents 43 carefully, as they describe your rights and restrictions with respect 44 to this document. Code Components extracted from this document must 45 include Simplified BSD License text as described in Section 4.e of 46 the Trust Legal Provisions and are provided without warranty as 47 described in the Simplified BSD License. 49 This document may contain material from IETF Documents or IETF 50 Contributions published or made publicly available before November 51 10, 2008. The person(s) controlling the copyright in some of this 52 material may not have granted the IETF Trust the right to allow 53 modifications of such material outside the IETF Standards Process. 54 Without obtaining an adequate license from the person(s) controlling 55 the copyright in such materials, this document may not be modified 56 outside the IETF Standards Process, and derivative works of it may 57 not be created outside the IETF Standards Process, except to format 58 it for publication as an RFC or to translate it into languages other 59 than English. 61 Abstract 63 This document defines a portion of the Management Information Base 64 (MIB) for use with network management protocols. In particular, it 65 defines objects for managing a client using the Internet Small 66 Computer System Interface (iSCSI) protocol (SCSI over TCP). 68 This document obsoletes RFC4544. 70 Table of Contents 72 1. The Internet-Standard Management Framework.....................3 73 2. Introduction...................................................3 74 3. Relationship to Other MIB Modules..............................3 75 4. Relationship to SNMP Contexts..................................4 76 5. Differences from RFC 4544......................................5 77 6. Discussion.....................................................5 78 6.1. iSCSI MIB Object Model....................................6 79 6.2. iSCSI MIB Table Structure.................................7 80 6.3. iscsiInstance.............................................8 81 6.4. iscsiPortal...............................................8 82 6.5. iscsiTargetPortal.........................................9 83 6.6. iscsiInitiatorPortal.....................................10 84 6.7. iscsiNode................................................10 85 6.8. iscsiTarget..............................................11 86 6.9. iscsiTgtAuthorization....................................11 87 6.10. iscsiInitiator..........................................11 88 6.11. iscsiIntrAuthorization..................................12 89 6.12. iscsiSession............................................12 90 6.13. iscsiConnection.........................................12 91 6.14. IP Addresses and TCP Port Numbers.......................13 92 6.15. Descriptors: Using OIDs in Place of Enumerated Types....13 93 6.16. Notifications...........................................13 94 7. MIB Definition................................................14 95 8. Security Considerations.......................................85 96 9. IANA Considerations...........................................86 97 10. References...................................................87 98 10.1. Normative References....................................87 99 10.2. Informative References..................................88 100 11. Acknowledgments..............................................89 102 1. The Internet-Standard Management Framework 104 For a detailed overview of the documents that describe the current 105 Internet-Standard Management Framework, please refer to section 7 of 106 RFC 3410 [RFC3410]. 108 Managed objects are accessed via a virtual information store, termed 109 the Management Information Base or MIB. MIB objects are generally 110 accessed through the Simple Network Management Protocol (SNMP). 111 Objects in the MIB are defined using the mechanisms defined in the 112 Structure of Management Information (SMI). This memo specifies a MIB 113 module that is compliant to the SMIv2, which is described in STD 58, 114 RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 115 [RFC2580]. 117 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 118 "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and 119 "OPTIONAL" in this document are to be interpreted as described in 120 [RFC2119]. 122 2. Introduction 124 -- RFC Editor:replace cccc in RFCcccc at all the places in which it is 125 -- used in this document, with the RFC number assigned to 126 -- draft-ietf-storm-iscsi-cons-08 & remove this note. 128 This document defines a MIB module for iSCSI [RFCcccc], used to 129 manage devices that implement the iSCSI protocol. It obsoletes RFC 130 4544 [RFC4544]. 132 3. Relationship to Other MIB Modules 134 The iSCSI MIB module is normally layered between the SCSI MIB module 135 [RFC4455] and the TCP MIB module [RFC4022], and makes use of the IP 136 Storage (IPS) Identity Authentication MIB module [RFC4545]. Here is 137 how these modules are related: 139 SCSI MIB Within systems where a SCSI layer is present, each 140 iscsiNode, whether it has an initiator role, target role, 141 or both, is related to one SCSI device within the SCSI MIB 142 module. In this case, the iscsiNodeTransportType attribute 143 points to the SCSI transport object within the SCSI MIB 144 module, which in turn contains an attribute that points 145 back to the iscsiNode. In this way, a management station 146 can navigate between the two MIB modules. In systems where 147 a SCSI layer is not present, such as within an iSCSI proxy 148 device, the iscsiNodeTransportType attribute points to the 149 appropriate corresponding object within the appropriate 150 MIB, or is left blank. 152 TCP MIB Each iSCSI connection is related to one transport-level 153 connection. Currently, iSCSI uses only TCP; the iSCSI 154 connection is related to a TCP connection using its normal 155 (protocol, source address, source port, destination 156 address, destination port) 5-tuple. 158 AUTH MIB Each iSCSI node that serves a target role can have a list 159 of authorized initiators. Each of the entries in this list 160 points to an identity within the IPS Identity 161 Authentication MIB module that will be allowed to access 162 the target. iSCSI nodes that serve in an initiator role 163 can also have a list of authorized targets. Each of the 164 entries in this list points to an identity within the Auth 165 MIB module to which the initiator should attempt to 166 establish sessions. The Auth MIB module includes 167 information used to identify initiators and targets by 168 their iSCSI name, IP address, and/or credentials. 170 This MIB module imports objects from RFCs 2578 [RFC2578], 2579 171 [RFC2579], 2580 [RFC2580], and 3411 [RFC3411]. It also imports 172 textual conventions from the INET-ADDRESS-MIB [RFC4001]. 174 4. Relationship to SNMP Contexts 176 Each non-scalar object in the iSCSI MIB module is indexed first by an 177 iSCSI Instance. Each instance is a collection of nodes, portals, 178 sessions, etc., that can define a physical or virtual partitioning of 179 an iSCSI-capable device. The use of an instance works well with 180 partitionable or hierarchical storage devices and fits in logically 181 with other management schemes. Instances do not replace SNMP 182 contexts, however they do provide a very simple way to assign a 183 virtual or physical partition of a device to one or more SNMP 184 contexts, without having to do so for each individual node, portal, 185 and session row. 187 5. Differences from RFC 4544 189 [RFCcccc] updates several RFCs, including [RFC3720]. This document 190 updates the iSCSI MIB correspondingly. The document uses 191 iSCSIProtocolLevel as defined in [RFCssss]. It obsoletes [RFC4544]. 192 Below is a brief description of the changes: 194 . Added iscsiInstXNodeArchitecture to InstanceAttributes 195 . Added iscsiSsnTaskReporting of type BITS to SessionAttributes 196 . Added iscsiSsnProtocolLevel to SessionAttributes 197 . Deprecated the marker objects 198 . Fixed the errata to [RFC4544] 199 . Added NOP counters at iSCSI session scope for heartbeat tracking 200 . Added port number to the iscsiTgtLoginFailure and 201 iscsiIntrLoginFailure notifications, and to the last failure info 202 in iscsiInitiatorAttributesEntry 203 . Added description string to the iSCSI portal 204 . Added iscsiInstSsnTgtUnmappedErrors to support "Target Unmapped" 205 session failure reporting in the iscsiInstSessionFailure 206 notification 207 . Added iscsiTgtLogoutCxnClosed and iscsiTgtLogoutCxnRemoved which 208 maintain the count of Logout Command PDUs received by the target 209 with reason codes 1 and 2 respectively 210 . Changed the conformance statements to match the above 212 6. Discussion 214 This MIB module structure supplies configuration, fault, and 215 statistics information for iSCSI devices [RFCcccc]. It is structured 216 around the well-known iSCSI objects, such as targets, initiators, 217 sessions, connections, and the like. 219 This MIB module may also be used to configure access to iSCSI 220 targets, by creating iSCSI Portals and authorization list entries. 222 It is worthwhile to note that this is an iSCSI MIB module and as such 223 reflects only iSCSI objects. This module does not contain 224 information about the SCSI-layer attributes of a device. If a SCSI 225 layer is present, the SCSI MIB module [RFC4455] 226 may be used to manage SCSI information for a device. 228 The iSCSI MIB module consists of several "objects", each of which is 229 represented by one or more tables. This section contains a brief 230 description of the "object" hierarchy and a description of each 231 object, followed by a discussion of the actual table structure within 232 the objects. 234 6.1. iSCSI MIB Object Model 236 The top-level object in this structure is the iSCSI instance, which 237 "contains" all of the other objects. 239 iscsiInstance 240 -- A distinct iSCSI entity within the managed system. 241 iscsiPortal 242 -- An IP address used by this instance 243 iscsiTargetPortal 244 -- Contains portal information relevant when the portal 245 -- is used to listen for connections to its targets. 246 iscsiInitiatorPortal 247 -- Contains portal information relevant when the portal 248 -- is used to initiate connections to other targets. 249 iscsiNode 250 -- An iSCSI node can act as an initiator, a target, or both. 251 -- Contains generic (non-role-specific) information. 252 iscsiTarget 253 -- Target-specific iSCSI node information. 254 iscsiTgtAuth 255 -- A list of initiator identities that are allowed 256 -- access to this target. 257 iscsiInitiator 258 -- Initiator-specific iSCSI node information. 259 iscsiIntrAuth 260 -- A list of target identities to which this initiator 261 -- is configured to establish sessions. 262 iscsiSession 263 -- An active iSCSI session between an initiator and target. 264 -- The session's direction may be Inbound (outside 265 -- initiator to our target) or Outbound (our initiator to 266 -- an outside target). 267 iscsiConnection 268 -- An active TCP connection within an iSCSI session. 270 An iSCSI node can be an initiator, a target, or both. The iSCSI 271 node's portals may be used to initiate connections (initiator) or 272 listen for connections (target), depending on whether the iSCSI node 273 is acting as an initiator or target. The iSCSI MIB module assumes 274 that any target may be accessed via any portal that can take on a 275 target role, although other access controls not reflected in the 276 module might limit this. 278 6.2. iSCSI MIB Table Structure 280 Each iSCSI object exports one or more tables: an attributes table, 281 and zero or more statistics tables, which augment the attributes 282 table. Since iSCSI is an evolving standard, it is much cleaner to 283 provide statistics and attributes as separate tables, allowing 284 attributes and statistics to be added independently. In a few cases, 285 there are multiple categories of statistics that will likely grow; in 286 this case, an object will contain multiple statistics tables. 288 iscsiObjects 289 iscsiDescriptors 290 iscsiInstance 291 iscsiInstanceAttributesTable 292 iscsiInstanceSsnErrorStatsTable 293 -- Counts abnormal session terminations 294 iscsiPortal 295 iscsiPortalAttributesTable 296 iscsiTargetPortal 297 iscsiTgtPortalAttributesTable 298 iscsiInitiatorPortal 299 iscsiIntrPortalAttributesTable 300 iscsiNode 301 iscsiNodeAttributesTable 302 iscsiTarget 303 iscsiTargetAttributesTable 304 iscsiTargetLoginStatsTable 305 -- Counts successful and unsuccessful logins 306 iscsiTargetLogoutStatsTable 307 -- Counts normal and abnormal logouts 308 iscsiTgtAuthorization 309 iscsiTgtAuthAttributesTable 310 iscsiInitiator 311 iscsiInitiatorAttributesTable 312 iscsiInitiatorLoginStatsTable 313 -- Counts successful and unsuccessful logins 314 iscsiInitiatorLogoutStatsTable 315 -- Counts normal and abnormal logouts 316 iscsiIntrAuthorization 317 iscsiIntrAuthAttributesTable 318 iscsiSession 319 iscsiSessionAttributesTable 320 iscsiSessionStatsTable 321 -- Performance-related counts (requests, responses, bytes) 322 iscsiSessionCxnErrorStatsTable 323 -- Counts digest errors, connection errors, etc. 324 iscsiConnection 325 iscsiConnectionAttributesTable 327 Note that this module does not attempt to count everything that could 328 be counted; it is designed to include only those counters that would 329 be useful for identifying performance, security, and fault problems 330 from a management station. 332 6.3. iscsiInstance 334 The iscsiInstanceAttributesTable is the primary table of the iSCSI 335 MIB module. Every table entry in this module is "owned" by exactly 336 one iSCSI instance; all other table entries in the module include 337 this table's index as their primary index. 339 Most implementations will include just one iSCSI instance row in this 340 table. However, this table exists to allow for multiple virtual 341 instances. For example, many IP routing products now allow multiple 342 virtual routers. The iSCSI MIB module has the same premise; a large 343 system could be "partitioned" into multiple, distinct virtual 344 systems. 346 This also allows a single SNMP agent to proxy for multiple 347 subsystems, perhaps a set of stackable devices, each of which has one 348 or even more instances. 350 The instance attributes include the iSCSI vendor and version, as well 351 as information on the last target or initiator at the other end of a 352 session that caused a session failure. 354 The iscsiInstanceSsnErrorStatsTable augments the attributes table and 355 provides statistics on session failures due to digest, connection, or 356 iSCSI format errors. 358 6.4. iscsiPortal 360 The iscsiPortalAttributesTable lists iSCSI portals that can be used 361 to listen for connections to targets, to initiate connections to 362 other targets, or to do both. 364 Each row in the table includes an IP address (either v4 or v6), and a 365 transport protocol (currently only TCP is defined). Each portal may 366 have additional attributes, depending on whether it is an initiator 367 portal, a target portal, or both. Initiator portals also have portal 368 tags; these are placed in corresponding rows in the 369 iscsiIntrPortalAttributesTable. Target portals have both portal tags 370 and ports (e.g., TCP listen ports if the transport protocol is TCP); 371 these are placed in rows in the iscsiTgtPortalAttributesTable. 373 Portal rows, along with their initiator and target portal 374 counterparts, may be created and destroyed through this MIB module by 375 a management station. Rows in the initiator and target portal tables 376 are created and destroyed automatically by the agent, whenever a row 377 is created or destroyed in the iscsiPortalAttributesTable, or if the 378 value of iscsiPortalRoles changes. Attributes in these tables may 379 then be modified by the management station if the agent 380 implementation allows. 382 When created by a management station, the iscsiPortalRoles attribute 383 is used to control row creation in the initiator and target portal 384 tables. Creating a row with the targetTypePortal bit set in 385 iscsiPortalRoles will cause the implementation to start listening for 386 iSCSI connections on the portal. Creating a row with the 387 initiatorTypePortal bit set in iscsiPortalRoles will not necessarily 388 cause connections to be established; it is left to the implementation 389 whether and when to make use of the portal. Both bits may be set if 390 the portal is to be used by both initiator and target nodes. 392 When deleting a row in the iscsiPortalAttibutesTable, all connections 393 associated with that row are terminated. The implementation may 394 either terminate the connection immediately or request a clean 395 shutdown as specified in [RFCcccc]. An outbound connection (when an 396 iscsiInitiatorPortal is deleted) matches the portal if its 397 iscsiCxnLocalAddr matches the iscsiPortalAddr. An inbound connection 398 (when an iscsiTargetPortal is deleted) matches the portal if its 399 iscsiCxnLocalAddr matches the iscsiPortalAddr, and its 400 iscsiCxnLocalPort matches the iscsiTargetPortalPort. 402 Individual objects within a row in this table may not be modified 403 while the row is active. For instance, changing the IP address of a 404 portal requires that the rows associated with the old IP address be 405 deleted, and new rows be created (in either order). 407 6.5. iscsiTargetPortal 409 The iscsiTgtPortalAttributesTable contains target-specific attributes 410 for iSCSI portals. Rows in this table use the same indices as their 411 corresponding rows in the iscsiPortalAttributesTable, with the 412 addition of iscsiNodeIndex. 414 Rows in this table are created when the targetTypePortal bit is set 415 in the iscsiPortalRoles attribute of the corresponding 416 iscsiPortalAttributesEntry; they are destroyed when this bit is 417 cleared. 419 This table contains the TCP (or other protocol) port on which the 420 socket is listening for incoming connections. It also includes a 421 portal group aggregation tag; iSCSI target portals within this 422 instance sharing the same tag can contain connections within the same 423 session. 425 This table will be empty for iSCSI instances that contain only 426 initiators (such as iSCSI host driver implementations). 428 Many implementations use the same target portal tag and protocol port 429 for all nodes accessed via a portal. These implementations will 430 create a single row in the iscsiTgtPortalAttributeTable, with an 431 iscsiNodeIndex of zero. 433 Other implementations do not use the same tag and/or port for all 434 nodes; these implementations will create a row in this table for each 435 (portal, node) tuple, using iscsiNodeIndex to designate the node for 436 this portal tag and port. 438 6.6. iscsiInitiatorPortal 440 The iscsiIntrPortalAttributesTable contains initiator-specific 441 objects for iSCSI portals. Rows in this table use the same indices 442 as their corresponding entries in the iscsiPortalAttributesTable. A 443 row in this table is created when the initiatorTypePortal bit is set 444 in the iscsiPortalRoles attribute; it is destroyed when this bit is 445 cleared. 447 Each row in this table contains a portal group aggregation tag, 448 indicating which portals an initiator may use together within a 449 multiple-connection session. 451 This table will be empty for iSCSI instances that contain only 452 targets (such as most iSCSI devices). 454 Many implementations use the same initiator tag for all nodes 455 accessing targets via a given portal. These implementations will 456 create a single row in iscsiIntrPortalAttributeTable, with an 457 iscsiNodeIndex of zero. 459 Other implementations do not use the same tag and/or port for all 460 nodes; these implementations will create a row in this table for each 461 (portal, node) tuple, using iscsiNodeIndex to designate the node for 462 this portal tag and port. 464 6.7. iscsiNode 466 The iscsiNodeAttributesTable contains a list of iSCSI nodes, each of 467 which may have an initiator role, a target role, or both. 469 This table contains the node's attributes that are common to both 470 roles, such as its iSCSI name and alias string. Attributes specific 471 to initiators or targets are available in the iscsiTarget and 472 iscsiInitiator objects. Each row in this table that can fulfill a 473 target role has a corresponding row in the iscsiTarget table; each 474 entry that fulfills an initiator role has a row in the iscsiInitiator 475 table. Nodes such as copy managers that can take on both roles have 476 a corresponding row in each table. 478 This table also contains the login negotiations preferences for this 479 node. These objects indicate the values this node will offer or 480 prefer in the operational negotiation phase of the login process. 482 For most implementations, each entry in the table also contains a 483 RowPointer to the transport table entry in the SCSI MIB module that 484 this iSCSI node represents. For implementations without a standard 485 SCSI layer above iSCSI, such as an iSCSI proxy or gateway, this 486 RowPointer can point to a row in an implementation-specific table 487 that this iSCSI node represents. 489 6.8. iscsiTarget 491 The iscsiTargetAttributesTable contains target-specific attributes 492 for iSCSI nodes. Each entry in this table uses the same index values 493 as its corresponding iscsiNode entry. 495 This table contains attributes used to indicate the last failure that 496 was (or should have been) sent as a notification. 498 This table is augmented by the iscsiTargetLoginStatsTable and the 499 iscsiTargetLogoutStatsTable, which count the numbers of normal and 500 abnormal logins and logouts to this target. 502 6.9. iscsiTgtAuthorization 504 The iscsiTgtAuthAttributesTable contains an entry for each initiator 505 identifier that will be allowed to access the target under which it 506 appears. Each entry contains a RowPointer to a user identity in the 507 IPS Authorization MIB module, which contains the name, address, and 508 credential information necessary to authenticate the initiator. 510 6.10. iscsiInitiator 512 The iscsiInitiatorAttributesTable contains a list of initiator- 513 specific attributes for iSCSI nodes. Each entry in this table uses 514 the same index values as its corresponding iscsiNode entry. 516 Most implementations will include a single entry in this table, 517 regardless of the number of physical interfaces the initiator may 518 use. 520 This table is augmented by the iscsiInitiatorLoginStatsTable and the 521 iscsiInitiatorLogoutStatsTable, which count the numbers of normal and 522 abnormal logins and logouts from this initiator. 524 6.11. iscsiIntrAuthorization 526 The iscsiIntrAuthAttributesTable contains an entry for each target 527 identifier to which the initiator is configured to establish a 528 session. 530 Each entry contains a RowPointer to a user identity in the IPS 531 Authorization MIB module, which contains the name, address, and 532 credential information necessary to identify (for discovery purposes) 533 and authenticate the target. 535 6.12. iscsiSession 537 The iscsiSessionAttributesTable contains a set of rows that list the 538 sessions known to be existing locally for each node in each iSCSI 539 instance. 541 The session type for each session indicates whether the session is 542 used for normal SCSI commands or for discovery using the SendTargets 543 text command. Discovery sessions that do not belong to any 544 particular node have a node index attribute of zero. 546 The session direction for each session indicates whether it is an 547 Inbound session or an Outbound session. Inbound sessions are from 548 some other initiator to the target node under which the session 549 appears. Outbound sessions are from the initiator node under which 550 the session appears to a target outside this iSCSI instance. 552 Many attributes may be negotiated when starting an iSCSI session. 553 Most of these attributes are included in the session object. 555 Some attributes, such as the integrity and authentication schemes, 556 have some standard values that can be extended by vendors to include 557 their own schemes. These contain an object identifier, rather than 558 the expected enumerated type, to allow these values to be extended by 559 other MIB modules, such as an enterprise MIB module. 561 The iscsiSessionStatsTable includes statistics related to 562 performance; it counts iSCSI data bytes and PDUs. 564 For implementations that support error recovery without terminating a 565 session, the iscsiSessionCxnErrorStatsTable contains counters for the 566 numbers of digest and connection errors that have occurred within the 567 session. 569 6.13. iscsiConnection 571 The iscsiConnectionAttributesTable contains a list of active 572 connections within each session. It contains the IP addresses and 573 TCP (or other protocol) ports of both the local and remote sides of 574 the connection. These may be used to locate other connection-related 575 information and statistics in the TCP MIB module [RFC4022]. 577 The attributes table also contains a connection state. This state is 578 not meant to directly map to the state tables included within the 579 iSCSI specification; they are meant to be simplified, higher-level 580 definitions of connection state that provide information more useful 581 to a user or network manager. 583 No statistics are kept for connections. 585 6.14. IP Addresses and TCP Port Numbers 587 The IP addresses in this module are represented by two attributes, 588 one of type InetAddressType, and the other of type InetAddress. 589 These are taken from [RFC4001], which specifies how to support 590 addresses that may be either IPv4 or IPv6. 592 The TCP port numbers that appear in a few of the structures are 593 described as simply port numbers, with a protocol attribute 594 indicating whether they are TCP ports or something else. This will 595 allow the module to be compatible with iSCSI over transports other 596 than TCP in the future. 598 6.15. Descriptors: Using OIDs in Place of Enumerated Types 600 The iSCSI MIB module has a few attributes, namely, the digest method 601 attributes, where an enumerated type would work well, except that an 602 implementation may need to extend the attribute and add types of its 603 own. To make this work, this MIB module defines a set of object 604 identities within the iscsiDescriptors subtree. Each of these object 605 identities is basically an enumerated type. 607 Attributes that make use of these object identities have a value that 608 is an Object Identifier (OID) instead of an enumerated type. These 609 OIDs can indicate either the object identities defined in this module 610 or object identities defined elsewhere, such as in an enterprise MIB 611 module. Those implementations that add their own digest methods 612 should also define a corresponding object identity for each of these 613 methods within their own enterprise MIB module, and return its OID 614 whenever one of these attributes is using that method. 616 6.16. Notifications 618 Three notifications are provided. One is sent by an initiator 619 detecting a critical login failure, another is sent by a target 620 detecting a critical login failure, and the third is sent upon a 621 session being terminated due to an abnormal connection or digest 622 failure. Critical failures are defined as those that may expose 623 security-related problems that may require immediate action, such as 624 failures due to authentication, authorization, or negotiation 625 problems. Attributes in the initiator, target, and instance objects 626 provide the information necessary to send in the notification, such 627 as the initiator or target name and IP address at the other end that 628 may have caused the failure. 630 To avoid sending an excessive number of notifications due to multiple 631 errors counted, an SNMP agent implementing the iSCSI MIB module 632 SHOULD NOT send more than three iSCSI notifications in any 10-second 633 period. 635 The 3-in-10 rule was chosen because one notification every three 636 seconds was deemed often enough, but should two or three different 637 notifications happen at the same time, it would not be desirable to 638 suppress them. Three notifications in 10 seconds is a happy medium, 639 where a short burst of notifications is allowed, without inundating 640 the network and/or notification host with a large number of 641 notifications. 643 7. MIB Definition 645 ISCSI-MIB DEFINITIONS ::= BEGIN 647 IMPORTS 648 MODULE-IDENTITY, OBJECT-TYPE, OBJECT-IDENTITY, NOTIFICATION-TYPE, 649 Unsigned32, Counter32, Counter64, Gauge32, 650 mib-2 651 FROM SNMPv2-SMI 653 TEXTUAL-CONVENTION, TruthValue, RowPointer, TimeStamp, RowStatus, 654 AutonomousType, StorageType 655 FROM SNMPv2-TC 657 MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP 658 FROM SNMPv2-CONF 660 SnmpAdminString 661 FROM SNMP-FRAMEWORK-MIB -- RFC 3411 663 InetAddressType, InetAddress, InetPortNumber 664 FROM INET-ADDRESS-MIB -- RFC 4001 665 ; 667 iscsiMibModule MODULE-IDENTITY 668 LAST-UPDATED "201210030000Z" -- October 3, 2012 669 ORGANIZATION "IETF STORage Maintenance (STORM) Working Group" 670 CONTACT-INFO " 671 Working Group Email : storm@ietf.org 672 Attn: Mark Bakke 673 Cisco Systems, Inc 674 Email: mbakke@cisco.com 676 Prakash Venkatesen 677 HCL Technologies 678 Email: prakashvn@hcl.com" 680 DESCRIPTION 681 "This module defines management information specific 682 to the iSCSI protocol. 684 Copyright (c) 2012 IETF Trust and the persons identified as 685 authors of the code. All rights reserved. 687 Redistribution and use in source and binary forms, with or 688 without modification, is permitted pursuant to, and subject 689 to the license terms contained in, the Simplified BSD 690 License set forth in Section 4.c of the IETF Trust's Legal 691 Provisions Relating to IETF Documents 692 (http://trustee.ietf.org/license-info)." 693 REVISION "201210030000Z" 694 DESCRIPTION 695 "Second version of the iSCSI Protocol MIB Module. 696 [RFCcccc] makes several updates to [RFC3720]. This 697 version makes corresponding updates to the MIB module. 698 This MIB module published as RFC xxxx." 699 -- RFC Editor: replace xxxx with actual RFC number & remove this note. 700 REVISION "200605220000Z" 701 DESCRIPTION 702 "Initial version of the iSCSI Protocol MIB module. 703 This MIB module published as RFC 4544." 705 ::= { mib-2 142 } 707 iscsiNotifications OBJECT IDENTIFIER ::= { iscsiMibModule 0 } 708 iscsiObjects OBJECT IDENTIFIER ::= { iscsiMibModule 1 } 709 iscsiConformance OBJECT IDENTIFIER ::= { iscsiMibModule 2 } 710 iscsiAdmin OBJECT IDENTIFIER ::= { iscsiMibModule 3 } 712 -- RFC Editor:replace cccc in RFC cccc at all the places in which it is 713 -- used in this document, with the RFC number assigned to 714 -- draft-ietf-storm-iscsi-cons-03 & remove this note. 716 -- Textual Conventions 718 IscsiTransportProtocol ::= TEXTUAL-CONVENTION 719 DISPLAY-HINT "d" 720 STATUS current 721 DESCRIPTION 722 "This data type is used to define the transport 723 protocols that will carry iSCSI PDUs. 724 Protocol numbers are assigned by IANA. A 725 current list of all assignments is available from 726 ." 728 SYNTAX Unsigned32 (0..255) 730 IscsiDigestMethod ::= TEXTUAL-CONVENTION 731 STATUS current 732 DESCRIPTION 733 "This data type represents the methods possible 734 for digest negotiation. 735 none - a placeholder for a secondary digest method 736 that means only the primary method can be 737 used. 738 other - a digest method other than those defined below. 739 noDigest - does not support digests (will operate without 740 a digest (Note: implementations must support 741 digests to be compliant with the RFCcccc). 742 CRC32c - require a CRC32C digest." 743 REFERENCE 744 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 746 SYNTAX INTEGER { 747 none(1), 748 other(2), 749 noDigest(3), 750 crc32c(4) 751 } 753 IscsiName ::= TEXTUAL-CONVENTION 754 DISPLAY-HINT "223t" 755 STATUS current 756 DESCRIPTION 757 "This data type is used for objects whose value is an 758 iSCSI name with the properties described in RFC cccc 759 section 4.2.7.1, and encoded as specified in RFC cccc 760 section 4.2.7.2. A zero-length string indicates the 761 absence of an iSCSI name." 762 REFERENCE 763 "RFC cccc, Section 4.2.7, iSCSI Names." 764 SYNTAX OCTET STRING (SIZE(0 | 16..223)) 766 --********************************************************************** 767 iscsiDescriptors OBJECT IDENTIFIER ::= { iscsiAdmin 1 } 769 iscsiHeaderIntegrityTypes OBJECT IDENTIFIER ::= { iscsiDescriptors 1 } 771 iscsiHdrIntegrityNone OBJECT-IDENTITY 772 STATUS current 773 DESCRIPTION 774 "The authoritative identifier when no integrity 775 scheme for the header is being used." 776 REFERENCE 777 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 778 ::= { iscsiHeaderIntegrityTypes 1 } 780 iscsiHdrIntegrityCrc32c OBJECT-IDENTITY 781 STATUS current 782 DESCRIPTION 783 "The authoritative identifier when the integrity 784 scheme for the header is CRC32c." 785 REFERENCE 786 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 787 ::= { iscsiHeaderIntegrityTypes 2 } 789 iscsiDataIntegrityTypes OBJECT IDENTIFIER ::= { iscsiDescriptors 2 } 791 iscsiDataIntegrityNone OBJECT-IDENTITY 792 STATUS current 793 DESCRIPTION 794 "The authoritative identifier when no integrity 795 scheme for the data is being used." 796 REFERENCE 797 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 798 ::= { iscsiDataIntegrityTypes 1 } 800 iscsiDataIntegrityCrc32c OBJECT-IDENTITY 801 STATUS current 802 DESCRIPTION 803 "The authoritative identifier when the integrity 804 scheme for the data is CRC32c." 805 REFERENCE 806 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 807 ::= { iscsiDataIntegrityTypes 2 } 809 --********************************************************************** 811 iscsiInstance OBJECT IDENTIFIER ::= { iscsiObjects 1 } 813 -- Instance Attributes Table 815 iscsiInstanceAttributesTable OBJECT-TYPE 816 SYNTAX SEQUENCE OF IscsiInstanceAttributesEntry 817 MAX-ACCESS not-accessible 818 STATUS current 819 DESCRIPTION 820 "A list of iSCSI instances present on the system." 821 ::= { iscsiInstance 1 } 823 iscsiInstanceAttributesEntry OBJECT-TYPE 824 SYNTAX IscsiInstanceAttributesEntry 825 MAX-ACCESS not-accessible 826 STATUS current 827 DESCRIPTION 828 "An entry (row) containing management information applicable 829 to a particular iSCSI instance." 830 INDEX { iscsiInstIndex } 831 ::= { iscsiInstanceAttributesTable 1 } 833 IscsiInstanceAttributesEntry ::= SEQUENCE { 834 iscsiInstIndex Unsigned32, 835 iscsiInstDescr SnmpAdminString, 836 iscsiInstVersionMin Unsigned32, 837 iscsiInstVersionMax Unsigned32, 838 iscsiInstVendorID SnmpAdminString, 839 iscsiInstVendorVersion SnmpAdminString, 840 iscsiInstPortalNumber Unsigned32, 841 iscsiInstNodeNumber Unsigned32, 842 iscsiInstSessionNumber Unsigned32, 843 iscsiInstSsnFailures Counter32, 844 iscsiInstLastSsnFailureType AutonomousType, 845 iscsiInstLastSsnRmtNodeName IscsiName, 846 iscsiInstDiscontinuityTime TimeStamp, 847 iscsiInstXNodeArchitecture SnmpAdminString 848 } 850 iscsiInstIndex OBJECT-TYPE 851 SYNTAX Unsigned32 (1..4294967295) 852 MAX-ACCESS not-accessible 853 STATUS current 854 DESCRIPTION 855 "An arbitrary integer used to uniquely identify a particular 856 iSCSI instance. This index value must not be modified or 857 reused by an agent unless a reboot has occurred. An agent 858 should attempt to keep this value persistent across reboots." 859 ::= { iscsiInstanceAttributesEntry 1 } 861 iscsiInstDescr OBJECT-TYPE 862 SYNTAX SnmpAdminString 863 MAX-ACCESS read-only 864 STATUS current 865 DESCRIPTION 866 "A UTF-8 string, determined by the implementation to 867 describe the iSCSI instance. When only a single instance 868 is present, this object may be set to the zero-length 869 string; with multiple iSCSI instances, it may be used in 870 an implementation-dependent manner to describe the purpose 871 of the respective instance." 873 ::= { iscsiInstanceAttributesEntry 2 } 875 iscsiInstVersionMin OBJECT-TYPE 876 SYNTAX Unsigned32 (0..255) 877 MAX-ACCESS read-only 878 STATUS current 879 DESCRIPTION 880 "The minimum version number of the iSCSI specification 881 such that this iSCSI instance supports this minimum 882 value, the maximum value indicated by the corresponding 883 instance in iscsiInstVersionMax, and all versions in 884 between." 885 REFERENCE 886 "RFC cccc, Section 11.12, Login Request" 887 ::= { iscsiInstanceAttributesEntry 3 } 889 iscsiInstVersionMax OBJECT-TYPE 890 SYNTAX Unsigned32 (0..255) 891 MAX-ACCESS read-only 892 STATUS current 893 DESCRIPTION 894 "The maximum version number of the iSCSI specification 895 such that this iSCSI instance supports this maximum 896 value, the minimum value indicated by the corresponding 897 instance in iscsiInstVersionMin, and all versions in 898 between." 899 REFERENCE 900 "RFC cccc, Section 11.12, Login Request" 901 ::= { iscsiInstanceAttributesEntry 4 } 903 iscsiInstVendorID OBJECT-TYPE 904 SYNTAX SnmpAdminString 905 MAX-ACCESS read-only 906 STATUS current 907 DESCRIPTION 908 "A UTF-8 string describing the manufacturer of the 909 implementation of this instance." 910 ::= { iscsiInstanceAttributesEntry 5 } 912 iscsiInstVendorVersion OBJECT-TYPE 913 SYNTAX SnmpAdminString 914 MAX-ACCESS read-only 915 STATUS current 916 DESCRIPTION 917 "A UTF-8 string set by the manufacturer describing the 918 version of the implementation of this instance. The 919 format of this string is determined solely by the 920 manufacturer, and is for informational purposes only. 921 It is unrelated to the iSCSI specification version numbers." 922 ::= { iscsiInstanceAttributesEntry 6 } 924 iscsiInstPortalNumber OBJECT-TYPE 925 SYNTAX Unsigned32 926 UNITS "transport endpoints" 927 MAX-ACCESS read-only 928 STATUS current 929 DESCRIPTION 930 "The number of rows in the iscsiPortalAttributesTable 931 that are currently associated with this iSCSI instance." 932 ::= { iscsiInstanceAttributesEntry 7 } 934 iscsiInstNodeNumber OBJECT-TYPE 935 SYNTAX Unsigned32 936 UNITS "iSCSI nodes" 937 MAX-ACCESS read-only 938 STATUS current 939 DESCRIPTION 940 "The number of rows in the iscsiNodeAttributesTable 941 that are currently associated with this iSCSI instance." 942 ::= { iscsiInstanceAttributesEntry 8 } 944 iscsiInstSessionNumber OBJECT-TYPE 945 SYNTAX Unsigned32 946 UNITS "sessions" 947 MAX-ACCESS read-only 948 STATUS current 949 DESCRIPTION 950 "The number of rows in the iscsiSessionAttributesTable 951 that are currently associated with this iSCSI instance." 952 ::= { iscsiInstanceAttributesEntry 9 } 954 iscsiInstSsnFailures OBJECT-TYPE 955 SYNTAX Counter32 956 UNITS "sessions" 957 MAX-ACCESS read-only 958 STATUS current 959 DESCRIPTION 960 "This object counts the number of times a session belonging 961 to this instance has failed. If this counter has 962 suffered a discontinuity, the time of the last discontinuity 963 is indicated in iscsiInstDiscontinuityTime." 964 REFERENCE 965 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 966 ::= { iscsiInstanceAttributesEntry 10 } 968 iscsiInstLastSsnFailureType OBJECT-TYPE 969 SYNTAX AutonomousType 970 MAX-ACCESS read-only 971 STATUS current 972 DESCRIPTION 973 "The counter object in the iscsiInstanceSsnErrorStatsTable 974 that was incremented when the last session failure occurred. 976 If the reason for failure is not found in the 977 iscsiInstanceSsnErrorStatsTable, the value { 0.0 } is 978 used instead." 979 ::= { iscsiInstanceAttributesEntry 11 } 981 iscsiInstLastSsnRmtNodeName OBJECT-TYPE 982 SYNTAX IscsiName 983 MAX-ACCESS read-only 984 STATUS current 985 DESCRIPTION 986 "The iSCSI name of the remote node from the failed 987 session." 988 ::= { iscsiInstanceAttributesEntry 12 } 990 iscsiInstDiscontinuityTime OBJECT-TYPE 991 SYNTAX TimeStamp 992 MAX-ACCESS read-only 993 STATUS current 994 DESCRIPTION 995 "The value of SysUpTime on the most recent occasion 996 at which any one or more of this instance's counters 997 suffered a discontinuity. 999 If no such discontinuities have occurred since the last 1000 re-initialization of the local management subsystem, 1001 then this object contains a zero value." 1002 ::= { iscsiInstanceAttributesEntry 13 } 1004 iscsiInstXNodeArchitecture OBJECT-TYPE 1005 SYNTAX SnmpAdminString 1006 MAX-ACCESS read-only 1007 STATUS current 1008 DESCRIPTION 1009 "A UTF-8 string set by the manufacturer declaring the 1010 details of its iSCSI node architecture to the remote 1011 endpoint. These details may include, but are not limited 1012 to, iSCSI vendor software, firmware, or hardware versions, 1013 the OS version, or hardware architecture. 1014 The format of this string is determined solely by the 1015 manufacturer, and is for informational purposes only. 1016 It is unrelated to the iSCSI specification version numbers." 1017 REFERENCE 1018 "[RFCcccc], Section 13.26, X#NodeArchitecture" 1019 ::= { iscsiInstanceAttributesEntry 14 } 1021 -- Instance Session Failure Stats Table 1023 iscsiInstanceSsnErrorStatsTable OBJECT-TYPE 1024 SYNTAX SEQUENCE OF IscsiInstanceSsnErrorStatsEntry 1025 MAX-ACCESS not-accessible 1026 STATUS current 1027 DESCRIPTION 1028 "Statistics regarding the occurrences of error types 1029 that result in a session failure." 1030 ::= { iscsiInstance 2 } 1032 iscsiInstanceSsnErrorStatsEntry OBJECT-TYPE 1033 SYNTAX IscsiInstanceSsnErrorStatsEntry 1034 MAX-ACCESS not-accessible 1035 STATUS current 1036 DESCRIPTION 1037 "An entry (row) containing management information applicable 1038 to a particular iSCSI instance." 1039 AUGMENTS { iscsiInstanceAttributesEntry } 1040 ::= { iscsiInstanceSsnErrorStatsTable 1 } 1042 IscsiInstanceSsnErrorStatsEntry ::= SEQUENCE { 1043 iscsiInstSsnDigestErrors Counter32, 1044 iscsiInstSsnCxnTimeoutErrors Counter32, 1045 iscsiInstSsnFormatErrors Counter32, 1046 iscsiInstSsnTgtUnmappedErrors Counter32 1047 } 1049 iscsiInstSsnDigestErrors OBJECT-TYPE 1050 SYNTAX Counter32 1051 UNITS "sessions" 1052 MAX-ACCESS read-only 1053 STATUS current 1054 DESCRIPTION 1055 "The count of sessions that failed due to receipt of 1056 a PDU containing header or data digest errors. If this 1057 counter has suffered a discontinuity, the time of the last 1058 discontinuity is indicated in iscsiInstDiscontinuityTime." 1059 REFERENCE 1060 "RFC cccc, Section 7.8, Digest Errors" 1062 ::= { iscsiInstanceSsnErrorStatsEntry 1 } 1064 iscsiInstSsnCxnTimeoutErrors OBJECT-TYPE 1065 SYNTAX Counter32 1066 UNITS "sessions" 1067 MAX-ACCESS read-only 1068 STATUS current 1069 DESCRIPTION 1070 "The count of sessions that failed due to a sequence 1071 exceeding a time limit. If this counter has suffered a 1072 discontinuity, the time of the last discontinuity 1073 is indicated in iscsiInstDiscontinuityTime." 1074 REFERENCE 1075 "RFC cccc, Section 7.5, Connection Timeout Management" 1076 ::= { iscsiInstanceSsnErrorStatsEntry 2 } 1078 iscsiInstSsnFormatErrors OBJECT-TYPE 1079 SYNTAX Counter32 1080 UNITS "sessions" 1081 MAX-ACCESS read-only 1082 STATUS current 1083 DESCRIPTION 1084 "The count of sessions that failed due to receipt of 1085 a PDU that contained a format error. If this counter has 1086 suffered a discontinuity, the time of the last discontinuity 1087 is indicated in iscsiInstDiscontinuityTime." 1088 REFERENCE 1089 "RFC cccc, Section 7.7, Format Errors" 1090 ::= { iscsiInstanceSsnErrorStatsEntry 3 } 1092 iscsiInstSsnTgtUnmappedErrors OBJECT-TYPE 1093 SYNTAX Counter32 1094 UNITS "sessions" 1095 MAX-ACCESS read-only 1096 STATUS current 1097 DESCRIPTION 1098 "The count of sessions that failed due to the target 1099 becoming unmapped. If this counter has 1100 suffered a discontinuity, the time of the last discontinuity 1101 is indicated in iscsiInstDiscontinuityTime." 1102 ::= { iscsiInstanceSsnErrorStatsEntry 4 } 1103 --********************************************************************** 1105 iscsiPortal OBJECT IDENTIFIER ::= { iscsiObjects 2 } 1107 -- Portal Attributes Table 1109 iscsiPortalAttributesTable OBJECT-TYPE 1110 SYNTAX SEQUENCE OF IscsiPortalAttributesEntry 1111 MAX-ACCESS not-accessible 1112 STATUS current 1113 DESCRIPTION 1114 "A list of transport endpoints (using TCP or another transport 1115 protocol) used by this iSCSI instance. An iSCSI instance may 1116 use a portal to listen for incoming connections to its targets, 1117 to initiate connections to other targets, or both." 1118 ::= { iscsiPortal 1 } 1120 iscsiPortalAttributesEntry OBJECT-TYPE 1121 SYNTAX IscsiPortalAttributesEntry 1122 MAX-ACCESS not-accessible 1123 STATUS current 1124 DESCRIPTION 1125 "An entry (row) containing management information applicable 1126 to a particular portal instance." 1127 INDEX { iscsiInstIndex, iscsiPortalIndex } 1128 ::= { iscsiPortalAttributesTable 1 } 1130 IscsiPortalAttributesEntry ::= SEQUENCE { 1131 iscsiPortalIndex Unsigned32, 1132 iscsiPortalRowStatus RowStatus, 1133 iscsiPortalRoles BITS, 1134 iscsiPortalAddrType InetAddressType, 1135 iscsiPortalAddr InetAddress, 1136 iscsiPortalProtocol IscsiTransportProtocol, 1137 iscsiPortalMaxRecvDataSegLength Unsigned32, 1138 iscsiPortalPrimaryHdrDigest IscsiDigestMethod, 1139 iscsiPortalPrimaryDataDigest IscsiDigestMethod, 1140 iscsiPortalSecondaryHdrDigest IscsiDigestMethod, 1141 iscsiPortalSecondaryDataDigest IscsiDigestMethod, 1142 iscsiPortalRecvMarker TruthValue, 1143 iscsiPortalStorageType StorageType, 1144 iscsiPortalDescr SnmpAdminString 1145 } 1147 iscsiPortalIndex OBJECT-TYPE 1148 SYNTAX Unsigned32 (1..4294967295) 1149 MAX-ACCESS not-accessible 1150 STATUS current 1151 DESCRIPTION 1152 "An arbitrary integer used to uniquely identify a particular 1153 transport endpoint within this iSCSI instance. This index 1154 value must not be modified or reused by an agent unless a 1155 reboot has occurred. An agent should attempt to keep this 1156 value persistent across reboots." 1157 ::= { iscsiPortalAttributesEntry 1 } 1159 iscsiPortalRowStatus OBJECT-TYPE 1160 SYNTAX RowStatus 1161 MAX-ACCESS read-create 1162 STATUS current 1163 DESCRIPTION 1164 "This field allows entries to be dynamically added and 1165 removed from this table via SNMP. When adding a row to 1166 this table, all non-Index/RowStatus objects must be set. 1167 When the value of this object is 'active', the values of 1168 the other objects in this table cannot be changed. 1169 Rows may be discarded using RowStatus. 1171 Note that creating a row in this table will typically 1172 cause the agent to create one or more rows in 1173 iscsiTgtPortalAttributesTable and/or 1174 iscsiIntrPortalAttributesTable." 1175 ::= { iscsiPortalAttributesEntry 2 } 1177 iscsiPortalRoles OBJECT-TYPE 1178 SYNTAX BITS { 1179 targetTypePortal(0), 1180 initiatorTypePortal(1) 1181 } 1182 MAX-ACCESS read-create 1183 STATUS current 1184 DESCRIPTION 1185 "A portal can operate in one or both of two roles: 1186 as a target portal and/or an initiator portal. If 1187 the portal will operate in both roles, both bits 1188 must be set. 1190 This object will define a corresponding row that 1191 will exist or must be created in the 1192 iscsiTgtPortalAttributesTable, the 1193 iscsiIntrPortalAttributesTable or both. If the 1194 targetTypePortal bit is set, one or more corresponding 1195 iscsiTgtPortalAttributesEntry rows will be found or 1196 created. If the initiatorTypePortal bit is set, 1197 one or more corresponding iscsiIntrPortalAttributesEntry 1198 rows will be found or created. If both bits are set, one 1199 or more corresponding rows will be found or created in 1200 one of the above tables." 1201 ::= { iscsiPortalAttributesEntry 3 } 1203 iscsiPortalAddrType OBJECT-TYPE 1204 SYNTAX InetAddressType 1205 MAX-ACCESS read-create 1206 STATUS current 1207 DESCRIPTION 1208 "The type of Internet Network Address contained in the 1209 corresponding instance of the iscsiPortalAddr." 1210 DEFVAL { ipv4 } 1211 ::= { iscsiPortalAttributesEntry 4 } 1213 iscsiPortalAddr OBJECT-TYPE 1214 SYNTAX InetAddress 1215 MAX-ACCESS read-create 1216 STATUS current 1217 DESCRIPTION 1218 "The portal's Internet Network Address, of the type 1219 specified by the object iscsiPortalAddrType. If 1220 iscsiPortalAddrType has the value 'dns', this address 1221 gets resolved to an IP address whenever a new iSCSI 1222 connection is established using this portal." 1223 ::= { iscsiPortalAttributesEntry 5 } 1225 iscsiPortalProtocol OBJECT-TYPE 1226 SYNTAX IscsiTransportProtocol 1227 MAX-ACCESS read-create 1228 STATUS current 1229 DESCRIPTION 1230 "The portal's transport protocol." 1231 DEFVAL { 6 } -- TCP 1232 ::= { iscsiPortalAttributesEntry 6 } 1234 iscsiPortalMaxRecvDataSegLength OBJECT-TYPE 1235 SYNTAX Unsigned32 (512..16777215) 1236 UNITS "bytes" 1237 MAX-ACCESS read-create 1238 STATUS current 1239 DESCRIPTION 1240 "The maximum PDU length this portal can receive. 1241 This may be constrained by hardware characteristics 1242 and individual implementations may choose not to 1243 allow this object to be changed." 1244 REFERENCE 1245 "RFC cccc, Section 13.12, MaxRecvDataSegmentLength" 1246 DEFVAL { 8192 } 1247 ::= { iscsiPortalAttributesEntry 7 } 1249 iscsiPortalPrimaryHdrDigest OBJECT-TYPE 1250 SYNTAX IscsiDigestMethod 1251 MAX-ACCESS read-create 1252 STATUS current 1253 DESCRIPTION 1254 "The preferred header digest for this portal." 1255 DEFVAL { crc32c } 1256 ::= { iscsiPortalAttributesEntry 8 } 1257 iscsiPortalPrimaryDataDigest OBJECT-TYPE 1258 SYNTAX IscsiDigestMethod 1259 MAX-ACCESS read-create 1260 STATUS current 1261 DESCRIPTION 1262 "The preferred data digest method for this portal." 1263 DEFVAL { crc32c } 1264 ::= { iscsiPortalAttributesEntry 9 } 1266 iscsiPortalSecondaryHdrDigest OBJECT-TYPE 1267 SYNTAX IscsiDigestMethod 1268 MAX-ACCESS read-create 1269 STATUS current 1270 DESCRIPTION 1271 "An alternate header digest preference for this portal." 1272 DEFVAL { noDigest } 1273 ::= { iscsiPortalAttributesEntry 10 } 1275 iscsiPortalSecondaryDataDigest OBJECT-TYPE 1276 SYNTAX IscsiDigestMethod 1277 MAX-ACCESS read-create 1278 STATUS current 1279 DESCRIPTION 1280 "An alternate data digest preference for this portal." 1281 DEFVAL { noDigest } 1282 ::= { iscsiPortalAttributesEntry 11 } 1284 iscsiPortalRecvMarker OBJECT-TYPE 1285 SYNTAX TruthValue 1286 MAX-ACCESS read-create 1287 STATUS deprecated 1288 DESCRIPTION 1289 "This object indicates whether or not this portal will 1290 request markers in its incoming data stream." 1291 REFERENCE 1292 "[RFCcccc], 13.25 Obsoleted Keys." 1293 DEFVAL { false } 1294 ::= { iscsiPortalAttributesEntry 12 } 1296 iscsiPortalStorageType OBJECT-TYPE 1297 SYNTAX StorageType 1298 MAX-ACCESS read-create 1299 STATUS current 1300 DESCRIPTION 1301 "The storage type for this row. Rows in this table that were 1302 created through an external process (e.g. not created via 1303 this MIB) may have a storage type of readOnly or permanent. 1305 Conceptual rows having the value 'permanent' need not 1306 allow write access to any columnar objects in the row." 1307 DEFVAL { nonVolatile } 1308 ::= { iscsiPortalAttributesEntry 13 } 1310 iscsiPortalDescr OBJECT-TYPE 1311 SYNTAX SnmpAdminString 1312 MAX-ACCESS read-only 1313 STATUS current 1314 DESCRIPTION 1315 "A UTF-8 string, determined by the implementation to 1316 describe the iSCSI portal. When only a single instance 1317 is present, this object may be set to the zero-length 1318 string; with multiple iSCSI portals, it may be used in 1319 an implementation-dependent manner to describe the 1320 respective portal, and could include information such as 1321 HBA model, description and version or software driver and 1322 version." 1323 ::= { iscsiPortalAttributesEntry 14 } 1325 --********************************************************************** 1326 iscsiTargetPortal OBJECT IDENTIFIER ::= { iscsiObjects 3 } 1328 -- Target Portal Attributes Table 1330 iscsiTgtPortalAttributesTable OBJECT-TYPE 1331 SYNTAX SEQUENCE OF IscsiTgtPortalAttributesEntry 1332 MAX-ACCESS not-accessible 1333 STATUS current 1334 DESCRIPTION 1335 "A list of transport endpoints (using TCP or another transport 1336 protocol) on which this iSCSI instance listens for incoming 1337 connections to its targets." 1338 ::= { iscsiTargetPortal 1 } 1340 iscsiTgtPortalAttributesEntry OBJECT-TYPE 1341 SYNTAX IscsiTgtPortalAttributesEntry 1342 MAX-ACCESS not-accessible 1343 STATUS current 1344 DESCRIPTION 1345 "An entry (row) containing management information applicable 1346 to a particular portal instance that is used to listen for 1347 incoming connections to local targets. One or more rows in 1348 this table is populated by the agent for each 1349 iscsiPortalAttributesEntry row that has the bit 1350 targetTypePortal set in its iscsiPortalRoles column." 1351 INDEX { iscsiInstIndex, iscsiPortalIndex, 1352 iscsiTgtPortalNodeIndexOrZero } 1353 ::= { iscsiTgtPortalAttributesTable 1 } 1354 IscsiTgtPortalAttributesEntry ::= SEQUENCE { 1355 iscsiTgtPortalNodeIndexOrZero Unsigned32, 1356 iscsiTgtPortalPort InetPortNumber, 1357 iscsiTgtPortalTag Unsigned32 1358 } 1360 iscsiTgtPortalNodeIndexOrZero OBJECT-TYPE 1361 SYNTAX Unsigned32 (0..4294967295) 1362 MAX-ACCESS not-accessible 1363 STATUS current 1364 DESCRIPTION 1365 "An arbitrary integer used to uniquely identify a 1366 particular node within an iSCSI instance present 1367 on the local system. 1369 For implementations where each {portal, node} tuple 1370 can have a different portal tag, this value will 1371 map to the iscsiNodeIndex. 1373 For implementations where the portal tag is the 1374 same for a given portal regardless of which node 1375 is using the portal, the value 0 (zero) is used." 1376 ::= { iscsiTgtPortalAttributesEntry 1 } 1378 iscsiTgtPortalPort OBJECT-TYPE 1379 SYNTAX InetPortNumber (1..65535) 1380 MAX-ACCESS read-write 1381 STATUS current 1382 DESCRIPTION 1383 "The portal's transport protocol port number on which the 1384 portal listens for incoming iSCSI connections when the 1385 portal is used as a target portal. This object's storage 1386 type is specified in iscsiPortalStorageType." 1387 ::= { iscsiTgtPortalAttributesEntry 2 } 1389 iscsiTgtPortalTag OBJECT-TYPE 1390 SYNTAX Unsigned32 (1..65535) 1391 MAX-ACCESS read-write 1392 STATUS current 1393 DESCRIPTION 1394 "The portal's aggregation tag when the portal is used as 1395 a target portal. Multiple-connection sessions may 1396 be aggregated over portals sharing an identical 1397 aggregation tag. This object's storage type is 1398 specified in iscsiPortalStorageType." 1399 REFERENCE 1400 "RFC cccc, Section 4.4.1, iSCSI Architectural Model" 1401 ::= { iscsiTgtPortalAttributesEntry 3 } 1402 --********************************************************************** 1404 iscsiInitiatorPortal OBJECT IDENTIFIER ::= { iscsiObjects 4 } 1406 -- Initiator Portal Attributes Table 1408 iscsiIntrPortalAttributesTable OBJECT-TYPE 1409 SYNTAX SEQUENCE OF IscsiIntrPortalAttributesEntry 1410 MAX-ACCESS not-accessible 1411 STATUS current 1412 DESCRIPTION 1413 "A list of Internet Network Addresses (using TCP or another 1414 transport protocol) from which this iSCSI instance may 1415 initiate connections to other targets." 1416 ::= { iscsiInitiatorPortal 1 } 1418 iscsiIntrPortalAttributesEntry OBJECT-TYPE 1419 SYNTAX IscsiIntrPortalAttributesEntry 1420 MAX-ACCESS not-accessible 1421 STATUS current 1422 DESCRIPTION 1423 "An entry (row) containing management information applicable 1424 to a particular portal instance that is used to initiate 1425 connections to iSCSI targets. One or more rows in 1426 this table is populated by the agent for each 1427 iscsiPortalAttributesEntry row that has the bit 1428 initiatorTypePortal set in its iscsiPortalRoles column." 1429 INDEX { iscsiInstIndex, iscsiPortalIndex, 1430 iscsiIntrPortalNodeIndexOrZero } 1431 ::= { iscsiIntrPortalAttributesTable 1 } 1433 IscsiIntrPortalAttributesEntry ::= SEQUENCE { 1434 iscsiIntrPortalNodeIndexOrZero Unsigned32, 1435 iscsiIntrPortalTag Unsigned32 1436 } 1438 iscsiIntrPortalNodeIndexOrZero OBJECT-TYPE 1439 SYNTAX Unsigned32 (0..4294967295) 1440 MAX-ACCESS not-accessible 1441 STATUS current 1442 DESCRIPTION 1443 "An arbitrary integer used to uniquely identify a 1444 particular node within an iSCSI instance present 1445 on the local system. 1447 For implementations where each {portal, node} tuple 1448 can have a different portal tag, this value will 1449 map to the iscsiNodeIndex. 1451 For implementations where the portal tag is the 1452 same for a given portal regardless of which node 1453 is using the portal, the value 0 (zero) is used." 1454 ::= { iscsiIntrPortalAttributesEntry 1 } 1456 iscsiIntrPortalTag OBJECT-TYPE 1457 SYNTAX Unsigned32 (1..65535) 1458 MAX-ACCESS read-write 1459 STATUS current 1460 DESCRIPTION 1461 "The portal's aggregation tag when the portal is used as 1462 an initiator portal. Multiple-connection sessions may 1463 be aggregated over portals sharing an identical 1464 aggregation tag. This object's storage type is 1465 specified in iscsiPortalStorageType." 1466 REFERENCE 1467 "RFC cccc, Section 4.4.1, iSCSI Architectural Model" 1468 ::= { iscsiIntrPortalAttributesEntry 2 } 1470 --********************************************************************** 1472 iscsiNode OBJECT IDENTIFIER ::= { iscsiObjects 5 } 1474 -- Node Attributes Table 1476 iscsiNodeAttributesTable OBJECT-TYPE 1477 SYNTAX SEQUENCE OF IscsiNodeAttributesEntry 1478 MAX-ACCESS not-accessible 1479 STATUS current 1480 DESCRIPTION 1481 "A list of iSCSI nodes belonging to each iSCSI instance 1482 present on the local system. An iSCSI node can act as 1483 an initiator, a target, or both." 1484 ::= { iscsiNode 1 } 1486 iscsiNodeAttributesEntry OBJECT-TYPE 1487 SYNTAX IscsiNodeAttributesEntry 1488 MAX-ACCESS not-accessible 1489 STATUS current 1490 DESCRIPTION 1491 "A conceptual row containing management information 1492 applicable to a particular iSCSI node." 1493 INDEX { iscsiInstIndex, iscsiNodeIndex } 1494 ::= { iscsiNodeAttributesTable 1 } 1496 IscsiNodeAttributesEntry ::= SEQUENCE { 1497 iscsiNodeIndex Unsigned32, 1498 iscsiNodeName IscsiName, 1499 iscsiNodeAlias SnmpAdminString, 1500 iscsiNodeRoles BITS, 1501 iscsiNodeTransportType RowPointer, 1502 iscsiNodeInitialR2T TruthValue, 1503 iscsiNodeImmediateData TruthValue, 1504 iscsiNodeMaxOutstandingR2T Unsigned32, 1505 iscsiNodeFirstBurstLength Unsigned32, 1506 iscsiNodeMaxBurstLength Unsigned32, 1507 iscsiNodeMaxConnections Unsigned32, 1508 iscsiNodeDataSequenceInOrder TruthValue, 1509 iscsiNodeDataPDUInOrder TruthValue, 1510 iscsiNodeDefaultTime2Wait Unsigned32, 1511 iscsiNodeDefaultTime2Retain Unsigned32, 1512 iscsiNodeErrorRecoveryLevel Unsigned32, 1513 iscsiNodeDiscontinuityTime TimeStamp, 1514 iscsiNodeStorageType StorageType 1515 } 1517 iscsiNodeIndex OBJECT-TYPE 1518 SYNTAX Unsigned32 (1..4294967295) 1519 MAX-ACCESS not-accessible 1520 STATUS current 1521 DESCRIPTION 1522 "An arbitrary integer used to uniquely identify a particular 1523 node within an iSCSI instance. This index value must not be 1524 modified or reused by an agent unless a reboot has occurred. 1525 An agent should attempt to keep this value persistent across 1526 reboots." 1527 ::= { iscsiNodeAttributesEntry 1 } 1529 iscsiNodeName OBJECT-TYPE 1530 SYNTAX IscsiName 1531 MAX-ACCESS read-only 1532 STATUS current 1533 DESCRIPTION 1534 "This node's iSCSI name, which is independent of the location 1535 of the node, and can be resolved into a set of addresses 1536 through various discovery services." 1537 ::= { iscsiNodeAttributesEntry 2 } 1539 iscsiNodeAlias OBJECT-TYPE 1540 SYNTAX SnmpAdminString 1541 MAX-ACCESS read-only 1542 STATUS current 1543 DESCRIPTION 1544 "A character string that is a human-readable name or 1545 description of the iSCSI node. If configured, this alias 1546 may be communicated to the initiator or target node at 1547 the remote end of the connection during a Login Request 1548 or Response message. This string is not used as an 1549 identifier, but can be displayed by the system's user 1550 interface in a list of initiators and/or targets to 1551 which it is connected. 1553 If no alias exists, the value is a zero-length string." 1554 REFERENCE 1555 "RFC cccc, Section 13.6, TargetAlias, 13.7, InitiatorAlias" 1556 ::= { iscsiNodeAttributesEntry 3 } 1558 iscsiNodeRoles OBJECT-TYPE 1559 SYNTAX BITS { 1560 targetTypeNode(0), 1561 initiatorTypeNode(1) 1562 } 1563 MAX-ACCESS read-only 1564 STATUS current 1565 DESCRIPTION 1566 "A node can operate in one or both of two roles: 1567 a target role and/or an initiator role. If the node 1568 will operate in both roles, both bits must be set. 1570 This object will also define the corresponding rows that 1571 will exist in the iscsiTargetAttributesTable, the 1572 iscsiInitiatorAttributesTable or both. If the 1573 targetTypeNode bit is set, there will be a corresponding 1574 iscsiTargetAttributesEntry. If the initiatorTypeNode bit 1575 is set, there will be a corresponding 1576 iscsiInitiatorAttributesEntry. If both bits are set, 1577 there will be a corresponding iscsiTgtPortalAttributesEntry 1578 and iscsiPortalAttributesEntry." 1579 ::= { iscsiNodeAttributesEntry 4 } 1581 iscsiNodeTransportType OBJECT-TYPE 1582 SYNTAX RowPointer 1583 MAX-ACCESS read-only 1584 STATUS current 1585 DESCRIPTION 1586 "A pointer to the corresponding row in the appropriate 1587 table for this SCSI transport, thereby allowing management 1588 stations to locate the SCSI-level device that is represented 1589 by this iscsiNode. For example, it will usually point to the 1590 corresponding scsiTrnspt object in the SCSI MIB module. 1591 If no corresponding row exists, the value 0.0 must be 1592 used to indicate this." 1593 REFERENCE 1594 "SCSI-MIB, RFC 4455 section 9, scsiTransportTypes" 1595 ::= { iscsiNodeAttributesEntry 5 } 1597 iscsiNodeInitialR2T OBJECT-TYPE 1598 SYNTAX TruthValue 1599 MAX-ACCESS read-only 1600 STATUS current 1601 DESCRIPTION 1602 "This object indicates the InitialR2T preference for this 1603 node: 1604 true = YES, 1605 false = will try to negotiate NO, will accept YES " 1606 REFERENCE 1607 "RFC cccc, Section 13.10, InitialR2T" 1608 ::= { iscsiNodeAttributesEntry 6 } 1610 iscsiNodeImmediateData OBJECT-TYPE 1611 SYNTAX TruthValue 1612 MAX-ACCESS read-write 1613 STATUS current 1614 DESCRIPTION 1615 "This object indicates ImmediateData preference for this 1616 node: 1617 true = YES (but will accept NO), 1618 false = NO " 1619 REFERENCE 1620 "RFC cccc, Section 13.11, ImmediateData" 1621 DEFVAL { true } 1622 ::= { iscsiNodeAttributesEntry 7 } 1624 iscsiNodeMaxOutstandingR2T OBJECT-TYPE 1625 SYNTAX Unsigned32 (1..65535) 1626 UNITS "R2Ts" 1627 MAX-ACCESS read-write 1628 STATUS current 1629 DESCRIPTION 1630 "Maximum number of outstanding requests-to-transmit (R2Ts) 1631 allowed per iSCSI task." 1632 REFERENCE 1633 "RFC cccc, Section 13.17, MaxOutstandingR2T" 1634 DEFVAL { 1 } 1635 ::= { iscsiNodeAttributesEntry 8 } 1637 iscsiNodeFirstBurstLength OBJECT-TYPE 1638 SYNTAX Unsigned32 (512..16777215) 1639 UNITS "bytes" 1640 MAX-ACCESS read-write 1641 STATUS current 1642 DESCRIPTION 1643 "The maximum length (bytes) supported for unsolicited data 1644 to/from this node." 1645 REFERENCE 1646 "RFC cccc, Section 13.14, FirstBurstLength" 1648 DEFVAL { 65536 } 1649 ::= { iscsiNodeAttributesEntry 9 } 1651 iscsiNodeMaxBurstLength OBJECT-TYPE 1652 SYNTAX Unsigned32 (512..16777215) 1653 UNITS "bytes" 1654 MAX-ACCESS read-write 1655 STATUS current 1656 DESCRIPTION 1657 "The maximum number of bytes that can be sent within 1658 a single sequence of Data-In or Data-Out PDUs." 1659 REFERENCE 1660 "RFC cccc, Section 13.13, MaxBurstLength" 1661 DEFVAL { 262144 } 1662 ::= { iscsiNodeAttributesEntry 10 } 1664 iscsiNodeMaxConnections OBJECT-TYPE 1665 SYNTAX Unsigned32 (1..65535) 1666 UNITS "connections" 1667 MAX-ACCESS read-write 1668 STATUS current 1669 DESCRIPTION 1670 "The maximum number of connections allowed in each 1671 session to and/or from this node." 1672 REFERENCE 1673 "RFC cccc, Section 13.2, MaxConnections" 1674 DEFVAL { 1 } 1675 ::= { iscsiNodeAttributesEntry 11 } 1677 iscsiNodeDataSequenceInOrder OBJECT-TYPE 1678 SYNTAX TruthValue 1679 MAX-ACCESS read-write 1680 STATUS current 1681 DESCRIPTION 1682 "The DataSequenceInOrder preference of this node. 1683 False (=No) indicates that iSCSI data PDU sequences may 1684 be transferred in any order. True (=Yes) indicates that 1685 data PDU sequences must be transferred using 1686 continuously increasing offsets, except during 1687 error recovery." 1688 REFERENCE 1689 "RFC cccc, Section 13.19, DataSequenceInOrder" 1690 DEFVAL { true } 1691 ::= { iscsiNodeAttributesEntry 12 } 1693 iscsiNodeDataPDUInOrder OBJECT-TYPE 1694 SYNTAX TruthValue 1695 MAX-ACCESS read-write 1696 STATUS current 1697 DESCRIPTION 1698 "The DataPDUInOrder preference of this node. 1699 False (=No) indicates that iSCSI data PDUs within sequences 1700 may be in any order. True (=Yes) indicates that data PDUs 1701 within sequences must be at continuously increasing 1702 addresses, with no gaps or overlay between PDUs." 1703 REFERENCE 1704 "RFC cccc, Section 13.18, DataPDUInOrder" 1705 DEFVAL { true } 1706 ::= { iscsiNodeAttributesEntry 13 } 1708 iscsiNodeDefaultTime2Wait OBJECT-TYPE 1709 SYNTAX Unsigned32 (0..3600) 1710 UNITS "seconds" 1711 MAX-ACCESS read-write 1712 STATUS current 1713 DESCRIPTION 1714 "The DefaultTime2Wait preference of this node. This is the 1715 minimum time, in seconds, to wait before attempting an 1716 explicit/implicit logout or active iSCSI task reassignment 1717 after an unexpected connection termination or a connection 1718 reset." 1719 REFERENCE 1720 "RFC cccc, Section 13.15, DefaultTime2Wait" 1721 DEFVAL { 2 } 1722 ::= { iscsiNodeAttributesEntry 14 } 1724 iscsiNodeDefaultTime2Retain OBJECT-TYPE 1725 SYNTAX Unsigned32 (0..3600) 1726 UNITS "seconds" 1727 MAX-ACCESS read-write 1728 STATUS current 1729 DESCRIPTION 1730 "The DefaultTime2Retain preference of this node. This is 1731 the maximum time, in seconds after an initial wait 1732 (Time2Wait), before which an active iSCSI task reassignment 1733 is still possible after an unexpected connection termination 1734 or a connection reset." 1735 REFERENCE 1736 "RFC cccc, Section 13.16, DefaultTime2Retain" 1737 DEFVAL { 20 } 1738 ::= { iscsiNodeAttributesEntry 15 } 1740 iscsiNodeErrorRecoveryLevel OBJECT-TYPE 1741 SYNTAX Unsigned32 (0..255) 1742 MAX-ACCESS read-write 1743 STATUS current 1744 DESCRIPTION 1745 "The ErrorRecoveryLevel preference of this node. 1747 Currently, only 0-2 are valid. 1749 This object is designed to accommodate future error recovery 1750 levels. 1752 Higher error recovery levels imply support in addition to 1753 support for the lower error level functions. In other words, 1754 error level 2 implies support for levels 0-1, since those 1755 functions are subsets of error level 2." 1756 REFERENCE 1757 "RFC cccc, Section 13.20, ErrorRecoveryLevel" 1758 DEFVAL { 0 } 1759 ::= { iscsiNodeAttributesEntry 16 } 1761 iscsiNodeDiscontinuityTime OBJECT-TYPE 1762 SYNTAX TimeStamp 1763 MAX-ACCESS read-only 1764 STATUS current 1765 DESCRIPTION 1766 "The value of SysUpTime on the most recent occasion 1767 at which any one or more of this node's counters 1768 suffered a discontinuity. 1770 If no such discontinuities have occurred since the last 1771 re-initialization of the local management subsystem, 1772 then this object contains a zero value." 1773 ::= { iscsiNodeAttributesEntry 17 } 1775 iscsiNodeStorageType OBJECT-TYPE 1776 SYNTAX StorageType 1777 MAX-ACCESS read-write 1778 STATUS current 1779 DESCRIPTION 1780 "The storage type for all read-write objects within this 1781 row. Rows in this table are always created via an 1782 external process (e.g. not created via this MIB module). 1783 Conceptual rows having the value 'permanent' need not allow 1784 Write access to any columnar objects in the row. 1786 If this object has the value 'volatile', modifications 1787 to read-write objects in this row are not persistent 1788 across reboots. If this object has the value 1789 'nonVolatile', modifications to objects in this row 1790 are persistent. 1792 An implementation may choose to allow this object 1793 to be set to either 'nonVolatile' or 'volatile', 1794 allowing the management application to choose this 1795 behavior." 1797 DEFVAL { volatile } 1798 ::= { iscsiNodeAttributesEntry 18 } 1800 --********************************************************************** 1802 iscsiTarget OBJECT IDENTIFIER ::= { iscsiObjects 6 } 1804 -- Target Attributes Table 1806 iscsiTargetAttributesTable OBJECT-TYPE 1807 SYNTAX SEQUENCE OF IscsiTargetAttributesEntry 1808 MAX-ACCESS not-accessible 1809 STATUS current 1810 DESCRIPTION 1811 "A list of iSCSI nodes that can take on a target role, 1812 belonging to each iSCSI instance present on the local 1813 system." 1814 ::= { iscsiTarget 1 } 1816 iscsiTargetAttributesEntry OBJECT-TYPE 1817 SYNTAX IscsiTargetAttributesEntry 1818 MAX-ACCESS not-accessible 1819 STATUS current 1820 DESCRIPTION 1821 "An entry (row) containing management information applicable 1822 to a particular node that can take on a target role." 1823 INDEX { iscsiInstIndex, iscsiNodeIndex } 1824 ::= { iscsiTargetAttributesTable 1 } 1826 IscsiTargetAttributesEntry ::= SEQUENCE { 1827 iscsiTgtLoginFailures Counter32, 1828 iscsiTgtLastFailureTime TimeStamp, 1829 iscsiTgtLastFailureType AutonomousType, 1830 iscsiTgtLastIntrFailureName IscsiName, 1831 iscsiTgtLastIntrFailureAddrType InetAddressType, 1832 iscsiTgtLastIntrFailureAddr InetAddress, 1833 iscsiTgtLastIntrFailurePort InetPortNumber 1834 } 1836 iscsiTgtLoginFailures OBJECT-TYPE 1837 SYNTAX Counter32 1838 UNITS "failed login attempts" 1839 MAX-ACCESS read-only 1840 STATUS current 1841 DESCRIPTION 1842 "This object counts the number of times a login attempt to this 1843 local target has failed. 1844 If this counter has suffered a discontinuity, the time of the 1845 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1847 REFERENCE 1848 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 1849 ::= { iscsiTargetAttributesEntry 1 } 1851 iscsiTgtLastFailureTime OBJECT-TYPE 1852 SYNTAX TimeStamp 1853 MAX-ACCESS read-only 1854 STATUS current 1855 DESCRIPTION 1856 "The timestamp of the most recent failure of a login attempt 1857 to this target. A value of zero indicates that no such 1858 failures have occurred since the last system boot." 1859 ::= { iscsiTargetAttributesEntry 2 } 1861 iscsiTgtLastFailureType OBJECT-TYPE 1862 SYNTAX AutonomousType 1863 MAX-ACCESS read-only 1864 STATUS current 1865 DESCRIPTION 1866 "The type of the most recent failure of a login attempt 1867 to this target, represented as the OID of the counter 1868 object in iscsiTargetLoginStatsTable for which the 1869 relevant instance was incremented. If no such failures 1870 have occurred since the last system boot, this attribute 1871 will have the value 0.0. A value of 0.0 may also be used 1872 to indicate a type that is not represented by any of 1873 the counters in iscsiTargetLoginStatsTable." 1874 ::= { iscsiTargetAttributesEntry 3 } 1876 iscsiTgtLastIntrFailureName OBJECT-TYPE 1877 SYNTAX IscsiName 1878 MAX-ACCESS read-only 1879 STATUS current 1880 DESCRIPTION 1881 "The iSCSI name of the initiator that failed the last 1882 login attempt. If no such failures have occurred since 1883 the last system boot, this value is a zero-length string." 1884 ::= { iscsiTargetAttributesEntry 4 } 1886 iscsiTgtLastIntrFailureAddrType OBJECT-TYPE 1887 SYNTAX InetAddressType 1888 MAX-ACCESS read-only 1889 STATUS current 1890 DESCRIPTION 1891 "The type of Internet Network Address contained in the 1892 corresponding instance of the iscsiTgtLastIntrFailureAddr. 1893 The value 'dns' is not allowed. If no such failures have 1894 occurred since the last system boot, this value is zero." 1895 ::= { iscsiTargetAttributesEntry 5 } 1896 iscsiTgtLastIntrFailureAddr OBJECT-TYPE 1897 SYNTAX InetAddress 1898 MAX-ACCESS read-only 1899 STATUS current 1900 DESCRIPTION 1901 "An Internet Network Address, of the type specified by 1902 the object iscsiTgtLastIntrFailureAddrType, giving the 1903 host address of the initiator that failed the last login 1904 attempt. If no such failures have occurred since the last 1905 system boot, this value is a zero-length string." 1906 ::= { iscsiTargetAttributesEntry 6 } 1908 iscsiTgtLastIntrFailurePort OBJECT-TYPE 1909 SYNTAX InetPortNumber 1910 MAX-ACCESS read-only 1911 STATUS current 1912 DESCRIPTION 1913 "The transport protocol port number used by the initiator 1914 that failed the last login attempt. If no such failures 1915 have occurred since the last system boot, this value is a 1916 zero-length string." 1917 ::= { iscsiTargetAttributesEntry 7 } 1919 -- Target Login Stats Table 1921 iscsiTargetLoginStatsTable OBJECT-TYPE 1922 SYNTAX SEQUENCE OF IscsiTargetLoginStatsEntry 1923 MAX-ACCESS not-accessible 1924 STATUS current 1925 DESCRIPTION 1926 "A table of counters that keep a record of the results 1927 of initiators' login attempts to this target." 1928 ::= { iscsiTarget 2 } 1930 iscsiTargetLoginStatsEntry OBJECT-TYPE 1931 SYNTAX IscsiTargetLoginStatsEntry 1932 MAX-ACCESS not-accessible 1933 STATUS current 1934 DESCRIPTION 1935 "An entry (row) containing counters for each result of 1936 a login attempt to this target." 1937 AUGMENTS { iscsiTargetAttributesEntry } 1938 ::= { iscsiTargetLoginStatsTable 1 } 1940 IscsiTargetLoginStatsEntry ::= SEQUENCE { 1941 iscsiTgtLoginAccepts Counter32, 1942 iscsiTgtLoginOtherFails Counter32, 1943 iscsiTgtLoginRedirects Counter32, 1944 iscsiTgtLoginAuthorizeFails Counter32, 1945 iscsiTgtLoginAuthenticateFails Counter32, 1946 iscsiTgtLoginNegotiateFails Counter32 1947 } 1949 iscsiTgtLoginAccepts OBJECT-TYPE 1950 SYNTAX Counter32 1951 UNITS "successful logins" 1952 MAX-ACCESS read-only 1953 STATUS current 1954 DESCRIPTION 1955 "The count of Login Response PDUs with status 1956 0x0000, Accept Login, transmitted by this 1957 target. 1958 If this counter has suffered a discontinuity, the time of the 1959 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1960 REFERENCE 1961 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 1962 ::= { iscsiTargetLoginStatsEntry 1 } 1964 iscsiTgtLoginOtherFails OBJECT-TYPE 1965 SYNTAX Counter32 1966 UNITS "failed logins" 1967 MAX-ACCESS read-only 1968 STATUS current 1969 DESCRIPTION 1970 "The number of Login Response PDUs that were transmitted 1971 by this target and that were not counted by any other 1972 object in the row. 1973 If this counter has suffered a discontinuity, the time of the 1974 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1975 REFERENCE 1976 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 1977 ::= { iscsiTargetLoginStatsEntry 2 } 1979 iscsiTgtLoginRedirects OBJECT-TYPE 1980 SYNTAX Counter32 1981 UNITS "redirected logins" 1982 MAX-ACCESS read-only 1983 STATUS current 1984 DESCRIPTION 1985 "The count of Login Response PDUs with status class 0x01, 1986 Redirection, transmitted by this target. 1987 If this counter has suffered a discontinuity, the time of the 1988 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1989 REFERENCE 1990 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 1991 ::= { iscsiTargetLoginStatsEntry 3 } 1992 iscsiTgtLoginAuthorizeFails OBJECT-TYPE 1993 SYNTAX Counter32 1994 UNITS "failed logins" 1995 MAX-ACCESS read-only 1996 STATUS current 1997 DESCRIPTION 1998 "The count of Login Response PDUs with status 0x0202, 1999 Forbidden Target, transmitted by this target. 2001 If this counter is incremented, an iscsiTgtLoginFailure 2002 notification should be generated. 2003 If this counter has suffered a discontinuity, the time of the 2004 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2005 REFERENCE 2006 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2007 ::= { iscsiTargetLoginStatsEntry 4 } 2009 iscsiTgtLoginAuthenticateFails OBJECT-TYPE 2010 SYNTAX Counter32 2011 UNITS "failed logins" 2012 MAX-ACCESS read-only 2013 STATUS current 2014 DESCRIPTION 2015 "The count of Login Response PDUs with status 0x0201, 2016 Authentication Failed, transmitted by this target. 2018 If this counter is incremented, an iscsiTgtLoginFailure 2019 notification should be generated. 2021 If this counter has suffered a discontinuity, the time of the 2022 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2023 REFERENCE 2024 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2025 ::= { iscsiTargetLoginStatsEntry 5 } 2027 iscsiTgtLoginNegotiateFails OBJECT-TYPE 2028 SYNTAX Counter32 2029 UNITS "failed logins" 2030 MAX-ACCESS read-only 2031 STATUS current 2032 DESCRIPTION 2033 "The number of times a target has effectively refused a 2034 login because the parameter negotiation failed. 2035 If this counter is incremented, an iscsiTgtLoginFailure 2036 notification should be generated. 2037 If this counter has suffered a discontinuity, the time of the 2038 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2039 ::= { iscsiTargetLoginStatsEntry 6 } 2040 -- Target Logout Stats Table 2042 iscsiTargetLogoutStatsTable OBJECT-TYPE 2043 SYNTAX SEQUENCE OF IscsiTargetLogoutStatsEntry 2044 MAX-ACCESS not-accessible 2045 STATUS current 2046 DESCRIPTION 2047 "When a target receives a Logout command, it responds 2048 with a Logout Response that carries a status code. 2049 This table contains counters for both normal and 2050 abnormal logout requests received by this target." 2051 ::= { iscsiTarget 3 } 2053 iscsiTargetLogoutStatsEntry OBJECT-TYPE 2054 SYNTAX IscsiTargetLogoutStatsEntry 2055 MAX-ACCESS not-accessible 2056 STATUS current 2057 DESCRIPTION 2058 "An entry (row) containing counters of Logout Response 2059 PDUs that were received by this target." 2060 AUGMENTS { iscsiTargetAttributesEntry } 2061 ::= { iscsiTargetLogoutStatsTable 1 } 2063 IscsiTargetLogoutStatsEntry ::= SEQUENCE { 2064 iscsiTgtLogoutNormals Counter32, 2065 iscsiTgtLogoutOthers Counter32, 2066 iscsiTgtLogoutCxnClosed Counter32, 2067 iscsiTgtLogoutCxnRemoved Counter32 2069 } 2071 iscsiTgtLogoutNormals OBJECT-TYPE 2072 SYNTAX Counter32 2073 UNITS "normal logouts" 2074 MAX-ACCESS read-only 2075 STATUS current 2076 DESCRIPTION 2077 "The count of Logout Command PDUs received by this target, 2078 with reason code 0 (closes the session). 2079 If this counter has suffered a discontinuity, the time of the 2080 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2081 REFERENCE 2082 "RFC cccc, Section 11.14.1, Reason Code" 2083 ::= { iscsiTargetLogoutStatsEntry 1 } 2085 iscsiTgtLogoutOthers OBJECT-TYPE 2086 SYNTAX Counter32 2087 UNITS "abnormal logouts" 2088 MAX-ACCESS read-only 2089 STATUS current 2090 DESCRIPTION 2091 "The count of Logout Command PDUs received by this target, 2092 with any reason code other than 0. 2093 If this counter has suffered a discontinuity, the time of the 2094 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2095 REFERENCE 2096 "RFC cccc, Section 11.14.1, Reason Code" 2097 ::= { iscsiTargetLogoutStatsEntry 2 } 2099 iscsiTgtLogoutCxnClosed OBJECT-TYPE 2100 SYNTAX Counter32 2101 UNITS "abnormal logouts" 2102 MAX-ACCESS read-only 2103 STATUS current 2104 DESCRIPTION 2105 "The count of Logout Command PDUs received by this target, 2106 with reason code 1 (closes the connection). 2107 If this counter has suffered a discontinuity, the time of the 2108 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2109 REFERENCE 2110 "RFC cccc, Section 11.14.1, Reason Code" 2111 ::= { iscsiTargetLogoutStatsEntry 3 } 2113 iscsiTgtLogoutCxnRemoved OBJECT-TYPE 2114 SYNTAX Counter32 2115 UNITS "abnormal logouts" 2116 MAX-ACCESS read-only 2117 STATUS current 2118 DESCRIPTION 2119 "The count of Logout Command PDUs received by this target, 2120 with reason code 2 (removes the connection). 2121 If this counter has suffered a discontinuity, the time of the 2122 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2123 REFERENCE 2124 "RFC cccc, Section 11.14.1, Reason Code" 2125 ::= { iscsiTargetLogoutStatsEntry 4 } 2127 --********************************************************************** 2129 iscsiTgtAuthorization OBJECT IDENTIFIER ::= { iscsiObjects 7 } 2131 -- Target Authorization Attributes Table 2133 iscsiTgtAuthAttributesTable OBJECT-TYPE 2134 SYNTAX SEQUENCE OF IscsiTgtAuthAttributesEntry 2135 MAX-ACCESS not-accessible 2136 STATUS current 2137 DESCRIPTION 2138 "A list of initiator identities that are authorized to 2139 access each target node within each iSCSI instance 2140 present on the local system." 2141 ::= { iscsiTgtAuthorization 1 } 2143 iscsiTgtAuthAttributesEntry OBJECT-TYPE 2144 SYNTAX IscsiTgtAuthAttributesEntry 2145 MAX-ACCESS not-accessible 2146 STATUS current 2147 DESCRIPTION 2148 "An entry (row) containing management information 2149 applicable to a particular target node's authorized 2150 initiator identity." 2151 INDEX { iscsiInstIndex, iscsiNodeIndex, iscsiTgtAuthIndex } 2152 ::= { iscsiTgtAuthAttributesTable 1 } 2154 IscsiTgtAuthAttributesEntry ::= SEQUENCE { 2155 iscsiTgtAuthIndex Unsigned32, 2156 iscsiTgtAuthRowStatus RowStatus, 2157 iscsiTgtAuthIdentity RowPointer, 2158 iscsiTgtAuthStorageType StorageType 2159 } 2161 iscsiTgtAuthIndex OBJECT-TYPE 2162 SYNTAX Unsigned32 (1..4294967295) 2163 MAX-ACCESS not-accessible 2164 STATUS current 2165 DESCRIPTION 2166 "An arbitrary integer used to uniquely identify a particular 2167 target's authorized initiator identity within an iSCSI 2168 instance present on the local system. This index value must 2169 not be modified or reused by an agent unless a reboot has 2170 occurred. An agent should attempt to keep this value 2171 persistent across reboots." 2172 ::= { iscsiTgtAuthAttributesEntry 1 } 2174 iscsiTgtAuthRowStatus OBJECT-TYPE 2175 SYNTAX RowStatus 2176 MAX-ACCESS read-create 2177 STATUS current 2178 DESCRIPTION 2179 "This field allows entries to be dynamically added and 2180 removed from this table via SNMP. When adding a row to 2181 this table, all non-Index/RowStatus objects must be set. 2182 When the value of this object is 'active', the values of 2183 the other objects in this table cannot be changed. 2184 Rows may be discarded using RowStatus." 2185 ::= { iscsiTgtAuthAttributesEntry 2 } 2186 iscsiTgtAuthIdentity OBJECT-TYPE 2187 SYNTAX RowPointer 2188 MAX-ACCESS read-create 2189 STATUS current 2190 DESCRIPTION 2191 "A pointer to the corresponding user entry in the IPS-AUTH 2192 MIB module that will be allowed to access this iSCSI target." 2193 REFERENCE 2194 "IPS-AUTH MIB, RFC 4545, 7.3, ipsAuthIdentAttributeEntry" 2195 ::= { iscsiTgtAuthAttributesEntry 3 } 2197 iscsiTgtAuthStorageType OBJECT-TYPE 2198 SYNTAX StorageType 2199 MAX-ACCESS read-create 2200 STATUS current 2201 DESCRIPTION 2202 "The storage type for this row. Rows in this table that were 2203 created through an external process (e.g. not created via 2204 this MIB) may have a storage type of readOnly or permanent. 2206 Conceptual rows having the value 'permanent' need not 2207 allow write access to any columnar objects in the row." 2208 DEFVAL { nonVolatile } 2209 ::= { iscsiTgtAuthAttributesEntry 4 } 2211 --********************************************************************** 2213 iscsiInitiator OBJECT IDENTIFIER ::= { iscsiObjects 8 } 2215 -- Initiator Attributes Table 2217 iscsiInitiatorAttributesTable OBJECT-TYPE 2218 SYNTAX SEQUENCE OF IscsiInitiatorAttributesEntry 2219 MAX-ACCESS not-accessible 2220 STATUS current 2221 DESCRIPTION 2222 "A list of iSCSI nodes that can take on an initiator 2223 role, belonging to each iSCSI instance present on 2224 the local system." 2225 ::= { iscsiInitiator 1 } 2227 iscsiInitiatorAttributesEntry OBJECT-TYPE 2228 SYNTAX IscsiInitiatorAttributesEntry 2229 MAX-ACCESS not-accessible 2230 STATUS current 2231 DESCRIPTION 2232 "An entry (row) containing management information 2233 applicable to a particular iSCSI node that has 2234 initiator capabilities." 2236 INDEX { iscsiInstIndex, iscsiNodeIndex } 2237 ::= { iscsiInitiatorAttributesTable 1 } 2239 IscsiInitiatorAttributesEntry ::= SEQUENCE { 2240 iscsiIntrLoginFailures Counter32, 2241 iscsiIntrLastFailureTime TimeStamp, 2242 iscsiIntrLastFailureType AutonomousType, 2243 iscsiIntrLastTgtFailureName IscsiName, 2244 iscsiIntrLastTgtFailureAddrType InetAddressType, 2245 iscsiIntrLastTgtFailureAddr InetAddress, 2246 iscsiIntrLastTgtFailurePort InetPortNumber 2247 } 2249 iscsiIntrLoginFailures OBJECT-TYPE 2250 SYNTAX Counter32 2251 UNITS "failed logins" 2252 MAX-ACCESS read-only 2253 STATUS current 2254 DESCRIPTION 2255 "This object counts the number of times a login attempt from 2256 this local initiator has failed. 2257 If this counter has suffered a discontinuity, the time of the 2258 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2259 REFERENCE 2260 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2261 ::= { iscsiInitiatorAttributesEntry 1 } 2263 iscsiIntrLastFailureTime OBJECT-TYPE 2264 SYNTAX TimeStamp 2265 MAX-ACCESS read-only 2266 STATUS current 2267 DESCRIPTION 2268 "The timestamp of the most recent failure of a login attempt 2269 from this initiator. A value of zero indicates that no such 2270 failures have occurred since the last system boot." 2271 ::= { iscsiInitiatorAttributesEntry 2 } 2273 iscsiIntrLastFailureType OBJECT-TYPE 2274 SYNTAX AutonomousType 2275 MAX-ACCESS read-only 2276 STATUS current 2277 DESCRIPTION 2278 "The type of the most recent failure of a login attempt 2279 from this initiator, represented as the OID of the counter 2280 object in iscsiInitiatorLoginStatsTable for which the 2281 relevant instance was incremented. If no such failures have 2282 occurred since the last system boot, this attribute will 2283 have the value 0.0. A value of 0.0 may also be used to 2284 indicate a type that is not represented by any of 2285 the counters in iscsiInitiatorLoginStatsTable." 2286 ::= { iscsiInitiatorAttributesEntry 3 } 2288 iscsiIntrLastTgtFailureName OBJECT-TYPE 2289 SYNTAX IscsiName 2290 MAX-ACCESS read-only 2291 STATUS current 2292 DESCRIPTION 2293 "A UTF-8 string giving the name of the target that failed 2294 the last login attempt. If no such failures have occurred 2295 since the last system boot, this value is a zero-length string." 2296 ::= { iscsiInitiatorAttributesEntry 4 } 2298 iscsiIntrLastTgtFailureAddrType OBJECT-TYPE 2299 SYNTAX InetAddressType 2300 MAX-ACCESS read-only 2301 STATUS current 2302 DESCRIPTION 2303 "The type of Internet Network Address contained in the 2304 corresponding instance of the iscsiIntrLastTgtFailureAddr. 2305 The value 'dns' is not allowed. If no such failures have 2306 occurred since the last system boot, this value is zero." 2307 ::= { iscsiInitiatorAttributesEntry 5 } 2309 iscsiIntrLastTgtFailureAddr OBJECT-TYPE 2310 SYNTAX InetAddress 2311 MAX-ACCESS read-only 2312 STATUS current 2313 DESCRIPTION 2314 "An Internet Network Address, of the type specified by the 2315 object iscsiIntrLastTgtFailureAddrType, giving the host 2316 address of the target that failed the last login attempt. 2317 If no such failures have occurred since the last system boot, 2318 this value is a zero-length string." 2319 ::= { iscsiInitiatorAttributesEntry 6 } 2321 iscsiIntrLastTgtFailurePort OBJECT-TYPE 2322 SYNTAX InetPortNumber 2323 MAX-ACCESS read-only 2324 STATUS current 2325 DESCRIPTION 2326 "The transport protocol port number used by the target 2327 that failed the last login attempt. 2328 If no such failures have occurred since the last system boot, 2329 this value is a zero-length string." 2330 ::= { iscsiInitiatorAttributesEntry 7 } 2332 -- Initiator Login Stats Table 2333 iscsiInitiatorLoginStatsTable OBJECT-TYPE 2334 SYNTAX SEQUENCE OF IscsiInitiatorLoginStatsEntry 2335 MAX-ACCESS not-accessible 2336 STATUS current 2337 DESCRIPTION 2338 "A table of counters which keep track of the results of 2339 this initiator's login attempts." 2340 ::= { iscsiInitiator 2 } 2342 iscsiInitiatorLoginStatsEntry OBJECT-TYPE 2343 SYNTAX IscsiInitiatorLoginStatsEntry 2344 MAX-ACCESS not-accessible 2345 STATUS current 2346 DESCRIPTION 2347 "An entry (row) containing counters of each result 2348 of this initiator's login attempts." 2349 AUGMENTS { iscsiInitiatorAttributesEntry } 2350 ::= { iscsiInitiatorLoginStatsTable 1 } 2352 IscsiInitiatorLoginStatsEntry ::= SEQUENCE { 2353 iscsiIntrLoginAcceptRsps Counter32, 2354 iscsiIntrLoginOtherFailRsps Counter32, 2355 iscsiIntrLoginRedirectRsps Counter32, 2356 iscsiIntrLoginAuthFailRsps Counter32, 2357 iscsiIntrLoginAuthenticateFails Counter32, 2358 iscsiIntrLoginNegotiateFails Counter32, 2359 iscsiIntrLoginAuthorizeFails Counter32 2360 } 2362 iscsiIntrLoginAcceptRsps OBJECT-TYPE 2363 SYNTAX Counter32 2364 UNITS "successful logins" 2365 MAX-ACCESS read-only 2366 STATUS current 2367 DESCRIPTION 2368 "The count of Login Response PDUs with status 2369 0x0000, Accept Login, received by this initiator. 2370 If this counter has suffered a discontinuity, the time of the 2371 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2372 REFERENCE 2373 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2374 ::= { iscsiInitiatorLoginStatsEntry 1 } 2376 iscsiIntrLoginOtherFailRsps OBJECT-TYPE 2377 SYNTAX Counter32 2378 UNITS "failed logins" 2379 MAX-ACCESS read-only 2380 STATUS current 2381 DESCRIPTION 2382 "The count of Login Response PDUs received by this 2383 initiator with any status code not counted in the 2384 objects below. 2385 If this counter has suffered a discontinuity, the time of the 2386 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2387 REFERENCE 2388 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2389 ::= { iscsiInitiatorLoginStatsEntry 2 } 2391 iscsiIntrLoginRedirectRsps OBJECT-TYPE 2392 SYNTAX Counter32 2393 UNITS "failed logins" 2394 MAX-ACCESS read-only 2395 STATUS current 2396 DESCRIPTION 2397 "The count of Login Response PDUs with status class 0x01, 2398 Redirection, received by this initiator. 2399 If this counter has suffered a discontinuity, the time of the 2400 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2401 REFERENCE 2402 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2403 ::= { iscsiInitiatorLoginStatsEntry 3 } 2405 iscsiIntrLoginAuthFailRsps OBJECT-TYPE 2406 SYNTAX Counter32 2407 UNITS "failed logins" 2408 MAX-ACCESS read-only 2409 STATUS current 2410 DESCRIPTION 2411 "The count of Login Response PDUs with status class 0x201, 2412 Authentication Failed, received by this initiator. 2413 If this counter has suffered a discontinuity, the time of the 2414 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2415 REFERENCE 2416 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2417 ::= { iscsiInitiatorLoginStatsEntry 4 } 2419 iscsiIntrLoginAuthenticateFails OBJECT-TYPE 2420 SYNTAX Counter32 2421 UNITS "failed logins" 2422 MAX-ACCESS read-only 2423 STATUS current 2424 DESCRIPTION 2425 "The number of times the initiator has aborted a 2426 login because the target could not be authenticated. 2428 No response is generated. 2430 If this counter is incremented, an iscsiIntrLoginFailure 2431 notification should be generated. 2432 If this counter has suffered a discontinuity, the time of the 2433 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2434 REFERENCE 2435 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2436 ::= { iscsiInitiatorLoginStatsEntry 5 } 2438 iscsiIntrLoginNegotiateFails OBJECT-TYPE 2439 SYNTAX Counter32 2440 UNITS "failed logins" 2441 MAX-ACCESS read-only 2442 STATUS current 2443 DESCRIPTION 2444 "The number of times the initiator has aborted a 2445 login because parameter negotiation with the target 2446 failed. 2448 No response is generated. 2450 If this counter is incremented, an iscsiIntrLoginFailure 2451 notification should be generated. 2452 If this counter has suffered a discontinuity, the time of the 2453 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2454 REFERENCE 2455 "RFC cccc, Section 7.12, Negotiation Failures" 2456 ::= { iscsiInitiatorLoginStatsEntry 6 } 2458 iscsiIntrLoginAuthorizeFails OBJECT-TYPE 2459 SYNTAX Counter32 2460 UNITS "failed logins" 2461 MAX-ACCESS read-only 2462 STATUS current 2463 DESCRIPTION 2464 "The count of Login Response PDUs with status 0x0202, 2465 Forbidden Target, received by this initiator. 2467 If this counter is incremented, an iscsiIntrLoginFailure 2468 notification should be generated. 2469 If this counter has suffered a discontinuity, the time of the 2470 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2471 REFERENCE 2472 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2473 ::= { iscsiInitiatorLoginStatsEntry 7 } 2475 -- Initiator Logout Stats Table 2477 iscsiInitiatorLogoutStatsTable OBJECT-TYPE 2478 SYNTAX SEQUENCE OF IscsiInitiatorLogoutStatsEntry 2479 MAX-ACCESS not-accessible 2480 STATUS current 2481 DESCRIPTION 2482 "When an initiator attempts to send a Logout command, the target 2483 responds with a Logout Response that carries a status code. 2484 This table contains a list of counters of Logout Response 2485 PDUs of each status code that was received by each 2486 initiator belonging to this iSCSI instance present on this 2487 system." 2488 ::= { iscsiInitiator 3 } 2490 iscsiInitiatorLogoutStatsEntry OBJECT-TYPE 2491 SYNTAX IscsiInitiatorLogoutStatsEntry 2492 MAX-ACCESS not-accessible 2493 STATUS current 2494 DESCRIPTION 2495 "An entry (row) containing counters of Logout Response 2496 PDUs of each status code that was generated by this 2497 initiator." 2498 AUGMENTS { iscsiInitiatorAttributesEntry } 2499 ::= { iscsiInitiatorLogoutStatsTable 1 } 2501 IscsiInitiatorLogoutStatsEntry ::= SEQUENCE { 2502 iscsiIntrLogoutNormals Counter32, 2503 iscsiIntrLogoutOthers Counter32 2504 } 2506 iscsiIntrLogoutNormals OBJECT-TYPE 2507 SYNTAX Counter32 2508 UNITS "normal logouts" 2509 MAX-ACCESS read-only 2510 STATUS current 2511 DESCRIPTION 2512 "The count of Logout Command PDUs generated by this initiator 2513 with reason code 0 (closes the session). 2514 If this counter has suffered a discontinuity, the time of the 2515 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2516 REFERENCE 2517 "RFC cccc, Section 11.14.1, Reason Code" 2518 ::= { iscsiInitiatorLogoutStatsEntry 1 } 2520 iscsiIntrLogoutOthers OBJECT-TYPE 2521 SYNTAX Counter32 2522 UNITS "abnormal logouts" 2523 MAX-ACCESS read-only 2524 STATUS current 2525 DESCRIPTION 2526 "The count of Logout Command PDUs generated by this initiator 2527 with any status code other than 0. 2528 If this counter has suffered a discontinuity, the time of the 2529 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2530 REFERENCE 2531 "RFC cccc, Section 11.14.1, Reason Code" 2533 ::= { iscsiInitiatorLogoutStatsEntry 2 } 2535 --********************************************************************** 2537 iscsiIntrAuthorization OBJECT IDENTIFIER ::= { iscsiObjects 9 } 2539 -- Initiator Authorization Attributes Table 2541 iscsiIntrAuthAttributesTable OBJECT-TYPE 2542 SYNTAX SEQUENCE OF IscsiIntrAuthAttributesEntry 2543 MAX-ACCESS not-accessible 2544 STATUS current 2545 DESCRIPTION 2546 "A list of target identities that each initiator 2547 on the local system may access." 2548 ::= { iscsiIntrAuthorization 1 } 2550 iscsiIntrAuthAttributesEntry OBJECT-TYPE 2551 SYNTAX IscsiIntrAuthAttributesEntry 2552 MAX-ACCESS not-accessible 2553 STATUS current 2554 DESCRIPTION 2555 "An entry (row) containing management information applicable 2556 to a particular initiator node's authorized target identity." 2557 INDEX { iscsiInstIndex, iscsiNodeIndex, iscsiIntrAuthIndex } 2558 ::= { iscsiIntrAuthAttributesTable 1 } 2560 IscsiIntrAuthAttributesEntry ::= SEQUENCE { 2561 iscsiIntrAuthIndex Unsigned32, 2562 iscsiIntrAuthRowStatus RowStatus, 2563 iscsiIntrAuthIdentity RowPointer, 2564 iscsiIntrAuthStorageType StorageType 2565 } 2567 iscsiIntrAuthIndex OBJECT-TYPE 2568 SYNTAX Unsigned32 (1..4294967295) 2569 MAX-ACCESS not-accessible 2570 STATUS current 2571 DESCRIPTION 2572 "An arbitrary integer used to uniquely identify a 2573 particular initiator node's authorized target 2574 identity within an iSCSI instance present on the 2575 local system. This index value must not be modified 2576 or reused by an agent unless a reboot has occurred. 2577 An agent should attempt to keep this value persistent 2578 across reboots." 2579 ::= { iscsiIntrAuthAttributesEntry 1 } 2581 iscsiIntrAuthRowStatus OBJECT-TYPE 2582 SYNTAX RowStatus 2583 MAX-ACCESS read-create 2584 STATUS current 2585 DESCRIPTION 2586 "This field allows entries to be dynamically added and 2587 removed from this table via SNMP. When adding a row to 2588 this table, all non-Index/RowStatus objects must be set. 2589 When the value of this object is 'active', the values of 2590 the other objects in this table cannot be changed. 2591 Rows may be discarded using RowStatus." 2592 ::= { iscsiIntrAuthAttributesEntry 2 } 2594 iscsiIntrAuthIdentity OBJECT-TYPE 2595 SYNTAX RowPointer 2596 MAX-ACCESS read-create 2597 STATUS current 2598 DESCRIPTION 2599 "A pointer to the corresponding user entry in the IPS-AUTH 2600 MIB module to which this initiator node should attempt to 2601 establish an iSCSI session." 2602 REFERENCE 2603 "IPS-AUTH MIB, RFC 4545, 7.3, ipsAuthInstanceAttributeEntry" 2604 ::= { iscsiIntrAuthAttributesEntry 3 } 2606 iscsiIntrAuthStorageType OBJECT-TYPE 2607 SYNTAX StorageType 2608 MAX-ACCESS read-create 2609 STATUS current 2610 DESCRIPTION 2611 "The storage type for this row. Rows in this table that were 2612 created through an external process (e.g. not created via 2613 this MIB) may have a storage type of readOnly or permanent. 2615 Conceptual rows having the value 'permanent' need not 2616 allow write access to any columnar objects in the row." 2617 DEFVAL { nonVolatile } 2618 ::= { iscsiIntrAuthAttributesEntry 4 } 2620 --********************************************************************** 2622 iscsiSession OBJECT IDENTIFIER ::= { iscsiObjects 10 } 2624 -- Session Attributes Table 2625 iscsiSessionAttributesTable OBJECT-TYPE 2626 SYNTAX SEQUENCE OF IscsiSessionAttributesEntry 2627 MAX-ACCESS not-accessible 2628 STATUS current 2629 DESCRIPTION 2630 "A list of sessions belonging to each iSCSI instance 2631 present on the system." 2632 ::= { iscsiSession 1 } 2634 iscsiSessionAttributesEntry OBJECT-TYPE 2635 SYNTAX IscsiSessionAttributesEntry 2636 MAX-ACCESS not-accessible 2637 STATUS current 2638 DESCRIPTION 2639 "An entry (row) containing management information applicable 2640 to a particular session. 2642 If this session is a discovery session that is not attached 2643 to any particular node, the iscsiSsnNodeIndex will be zero. 2644 Otherwise, the iscsiSsnNodeIndex will have the same value as 2645 iscsiNodeIndex." 2646 INDEX { iscsiInstIndex, iscsiSsnNodeIndex, iscsiSsnIndex } 2647 ::= { iscsiSessionAttributesTable 1 } 2649 IscsiSessionAttributesEntry ::= SEQUENCE { 2650 iscsiSsnNodeIndex Unsigned32, 2651 iscsiSsnIndex Unsigned32, 2652 iscsiSsnDirection INTEGER, 2653 iscsiSsnInitiatorName IscsiName, 2654 iscsiSsnTargetName IscsiName, 2655 iscsiSsnTSIH Unsigned32, 2656 iscsiSsnISID OCTET STRING, 2657 iscsiSsnInitiatorAlias SnmpAdminString, 2658 iscsiSsnTargetAlias SnmpAdminString, 2659 iscsiSsnInitialR2T TruthValue, 2660 iscsiSsnImmediateData TruthValue, 2661 iscsiSsnType INTEGER, 2662 iscsiSsnMaxOutstandingR2T Unsigned32, 2663 iscsiSsnFirstBurstLength Unsigned32, 2664 iscsiSsnMaxBurstLength Unsigned32, 2665 iscsiSsnConnectionNumber Gauge32, 2666 iscsiSsnAuthIdentity RowPointer, 2667 iscsiSsnDataSequenceInOrder TruthValue, 2668 iscsiSsnDataPDUInOrder TruthValue, 2669 iscsiSsnErrorRecoveryLevel Unsigned32, 2670 iscsiSsnDiscontinuityTime TimeStamp, 2671 iscsiSsnProtocolLevel Unsigned32, 2672 iscsiSsnTaskReporting BITS 2674 } 2676 iscsiSsnNodeIndex OBJECT-TYPE 2677 SYNTAX Unsigned32 (0..4294967295) 2678 MAX-ACCESS not-accessible 2679 STATUS current 2680 DESCRIPTION 2681 "An arbitrary integer used to uniquely identify a 2682 particular node within an iSCSI instance present 2683 on the local system. For normal, non-discovery 2684 sessions, this value will map to the iscsiNodeIndex. 2685 For discovery sessions that do not have a node 2686 associated, the value 0 (zero) is used." 2687 ::= { iscsiSessionAttributesEntry 1 } 2689 iscsiSsnIndex OBJECT-TYPE 2690 SYNTAX Unsigned32 (1..4294967295) 2691 MAX-ACCESS not-accessible 2692 STATUS current 2693 DESCRIPTION 2694 "An arbitrary integer used to uniquely identify a 2695 particular session within an iSCSI instance present 2696 on the local system. An agent should attempt to 2697 not reuse index values unless a reboot has occurred. 2698 iSCSI sessions are destroyed during a reboot; rows 2699 in this table are not persistent across reboots." 2700 ::= { iscsiSessionAttributesEntry 2 } 2702 iscsiSsnDirection OBJECT-TYPE 2703 SYNTAX INTEGER { 2704 inboundSession(1), 2705 outboundSession(2) 2706 } 2707 MAX-ACCESS read-only 2708 STATUS current 2709 DESCRIPTION 2710 "Direction of iSCSI session: 2711 inboundSession - session is established from an external 2712 initiator to a target within this iSCSI 2713 instance. 2714 outboundSession - session is established from an initiator 2715 within this iSCSI instance to an external 2716 target." 2717 ::= { iscsiSessionAttributesEntry 3 } 2719 iscsiSsnInitiatorName OBJECT-TYPE 2720 SYNTAX IscsiName 2721 MAX-ACCESS read-only 2722 STATUS current 2723 DESCRIPTION 2724 "If iscsiSsnDirection is Inbound, this object is a 2725 UTF-8 string that will contain the name of the remote 2726 initiator. If this session is a discovery session that 2727 does not specify a particular initiator, this object 2728 will contain a zero-length string. 2730 If iscsiSsnDirection is Outbound, this object will 2731 contain a zero-length string." 2732 ::= { iscsiSessionAttributesEntry 4 } 2734 iscsiSsnTargetName OBJECT-TYPE 2735 SYNTAX IscsiName 2736 MAX-ACCESS read-only 2737 STATUS current 2738 DESCRIPTION 2739 "If iscsiSsnDirection is Outbound, this object is a 2740 UTF-8 string that will contain the name of the remote 2741 target. If this session is a discovery session that 2742 does not specify a particular target, this object will 2743 contain a zero-length string. 2745 If iscsiSsnDirection is Inbound, this object will 2746 contain a zero-length string." 2747 ::= { iscsiSessionAttributesEntry 5 } 2749 iscsiSsnTSIH OBJECT-TYPE 2750 SYNTAX Unsigned32 (1..65535) 2751 MAX-ACCESS read-only 2752 STATUS current 2753 DESCRIPTION 2754 "The target-defined identification handle for this session." 2755 REFERENCE 2756 "RFC cccc, Section 11.12.6, TSIH" 2757 ::= { iscsiSessionAttributesEntry 6 } 2759 iscsiSsnISID OBJECT-TYPE 2760 SYNTAX OCTET STRING (SIZE(6)) 2761 MAX-ACCESS read-only 2762 STATUS current 2763 DESCRIPTION 2764 "The initiator-defined portion of the iSCSI Session ID." 2765 REFERENCE 2766 "RFC cccc, Section 11.12.5, ISID" 2767 ::= { iscsiSessionAttributesEntry 7 } 2769 iscsiSsnInitiatorAlias OBJECT-TYPE 2770 SYNTAX SnmpAdminString 2771 MAX-ACCESS read-only 2772 STATUS current 2773 DESCRIPTION 2774 "A UTF-8 string that gives the alias communicated by the 2775 initiator end of the session during the login phase. 2777 If no alias exists, the value is a zero-length string." 2778 REFERENCE 2779 "RFC cccc, Section 13.7, InitiatorAlias" 2780 ::= { iscsiSessionAttributesEntry 8 } 2782 iscsiSsnTargetAlias OBJECT-TYPE 2783 SYNTAX SnmpAdminString 2784 MAX-ACCESS read-only 2785 STATUS current 2786 DESCRIPTION 2787 "A UTF-8 string that gives the alias communicated by the 2788 target end of the session during the login phase. 2790 If no alias exists, the value is a zero-length string." 2791 REFERENCE 2792 "RFC cccc, Section 13.6, TargetAlias" 2793 ::= { iscsiSessionAttributesEntry 9 } 2795 iscsiSsnInitialR2T OBJECT-TYPE 2796 SYNTAX TruthValue 2797 MAX-ACCESS read-only 2798 STATUS current 2799 DESCRIPTION 2800 "If set to true, indicates that the initiator must wait 2801 for an R2T before sending to the target. If set to false, 2802 the initiator may send data immediately, within limits set 2803 by iscsiSsnFirstBurstLength and the expected data transfer 2804 length of the request." 2805 REFERENCE 2806 "RFC cccc, Section 13.10, InitialR2T" 2807 ::= { iscsiSessionAttributesEntry 10 } 2809 iscsiSsnImmediateData OBJECT-TYPE 2810 SYNTAX TruthValue 2811 MAX-ACCESS read-only 2812 STATUS current 2813 DESCRIPTION 2814 "Indicates whether the initiator and target have agreed to 2815 support immediate data on this session." 2816 REFERENCE 2817 "RFC cccc, Section 13.11, ImmediateData" 2818 ::= { iscsiSessionAttributesEntry 11 } 2820 iscsiSsnType OBJECT-TYPE 2821 SYNTAX INTEGER { 2822 normalSession(1), 2823 discoverySession(2) 2824 } 2825 MAX-ACCESS read-only 2826 STATUS current 2827 DESCRIPTION 2828 "Type of iSCSI session: 2829 normalSession - session is a normal iSCSI session 2830 discoverySession - session is being used only for discovery." 2831 REFERENCE 2832 "RFC cccc, Section 13.21, SessionType" 2833 ::= { iscsiSessionAttributesEntry 12 } 2835 iscsiSsnMaxOutstandingR2T OBJECT-TYPE 2836 SYNTAX Unsigned32 (1..65535) 2837 UNITS "R2Ts" 2838 MAX-ACCESS read-only 2839 STATUS current 2840 DESCRIPTION 2841 "The maximum number of outstanding requests-to-transmit 2842 (R2Ts) per iSCSI task within this session." 2843 REFERENCE 2844 "RFC cccc, Section 13.17, MaxOutstandingR2T" 2845 ::= { iscsiSessionAttributesEntry 13 } 2847 iscsiSsnFirstBurstLength OBJECT-TYPE 2848 SYNTAX Unsigned32 (512..16777215) 2849 UNITS "bytes" 2850 MAX-ACCESS read-only 2851 STATUS current 2852 DESCRIPTION 2853 "The maximum length supported for unsolicited data sent 2854 within this session." 2855 REFERENCE 2856 "RFC cccc, Section 13.14, FirstBurstLength" 2857 ::= { iscsiSessionAttributesEntry 14 } 2859 iscsiSsnMaxBurstLength OBJECT-TYPE 2860 SYNTAX Unsigned32 (512..16777215) 2861 UNITS "bytes" 2862 MAX-ACCESS read-only 2863 STATUS current 2864 DESCRIPTION 2865 "The maximum number of bytes that can be sent within 2866 a single sequence of Data-In or Data-Out PDUs." 2867 REFERENCE 2868 "RFC cccc, Section 13.13, MaxBurstLength" 2869 ::= { iscsiSessionAttributesEntry 15 } 2870 iscsiSsnConnectionNumber OBJECT-TYPE 2871 SYNTAX Gauge32 (1..65535) 2872 UNITS "connections" 2873 MAX-ACCESS read-only 2874 STATUS current 2875 DESCRIPTION 2876 "The number of transport protocol connections that currently 2877 belong to this session." 2878 ::= { iscsiSessionAttributesEntry 16 } 2880 iscsiSsnAuthIdentity OBJECT-TYPE 2881 SYNTAX RowPointer 2882 MAX-ACCESS read-only 2883 STATUS current 2884 DESCRIPTION 2885 "This object contains a pointer to a row in the 2886 IPS-AUTH MIB module that identifies the authentication 2887 identity being used on this session, as communicated 2888 during the login phase." 2889 REFERENCE 2890 "IPS-AUTH MIB, RFC 4545, 7.3, ipsAuthInstanceAttributeEntry" 2891 ::= { iscsiSessionAttributesEntry 17 } 2893 iscsiSsnDataSequenceInOrder OBJECT-TYPE 2894 SYNTAX TruthValue 2895 MAX-ACCESS read-only 2896 STATUS current 2897 DESCRIPTION 2898 "False indicates that iSCSI data PDU sequences may 2899 be transferred in any order. True indicates that 2900 data PDU sequences must be transferred using 2901 continuously increasing offsets, except during 2902 error recovery." 2903 REFERENCE 2904 "RFC cccc, Section 13.19, DataSequenceInOrder" 2905 ::= { iscsiSessionAttributesEntry 18 } 2907 iscsiSsnDataPDUInOrder OBJECT-TYPE 2908 SYNTAX TruthValue 2909 MAX-ACCESS read-only 2910 STATUS current 2911 DESCRIPTION 2912 "False indicates that iSCSI data PDUs within sequences 2913 may be in any order. True indicates that data PDUs 2914 within sequences must be at continuously increasing 2915 addresses, with no gaps or overlay between PDUs. 2916 Default is true." 2917 REFERENCE 2918 "RFC cccc, Section 13.18, DataPDUInOrder" 2919 ::= { iscsiSessionAttributesEntry 19 } 2921 iscsiSsnErrorRecoveryLevel OBJECT-TYPE 2922 SYNTAX Unsigned32 (0..255) 2923 MAX-ACCESS read-only 2924 STATUS current 2925 DESCRIPTION 2926 "The level of error recovery negotiated between 2927 the initiator and the target. Higher numbers 2928 represent more detailed recovery schemes." 2929 REFERENCE 2930 "RFC cccc, Section 13.20, ErrorRecoveryLevel" 2931 ::= { iscsiSessionAttributesEntry 20 } 2933 iscsiSsnDiscontinuityTime OBJECT-TYPE 2934 SYNTAX TimeStamp 2935 MAX-ACCESS read-only 2936 STATUS current 2937 DESCRIPTION 2938 "The value of SysUpTime on the most recent occasion 2939 at which any one or more of this session's counters 2940 suffered a discontinuity. 2941 When a session is established, and this object is 2942 created, it is initialized to the current value 2943 of SysUpTime." 2944 ::= { iscsiSessionAttributesEntry 21 } 2946 iscsiSsnProtocolLevel OBJECT-TYPE 2947 SYNTAX Unsigned32 (0..31) 2948 MAX-ACCESS read-only 2949 STATUS current 2950 DESCRIPTION 2951 "The iSCSI protocol level negotiated for this session." 2952 REFERENCE 2953 "RFC ssss, Section 7.1.1, iSCSIProtocolLevel" 2954 -- RFC Editor: replace ssss in RFC ssss with the RFC number assigned to 2955 -- draft-ietf-storm-iscsi-sam-05 & remove this note. 2957 DEFVAL { 1 } 2958 ::= { iscsiSessionAttributesEntry 22 } 2960 iscsiSsnTaskReporting OBJECT-TYPE 2961 SYNTAX BITS { 2962 taskReportingRfc3720(0), 2963 taskReportingResponseFence(1), 2964 taskReportingFastAbort(2) 2965 } 2967 MAX-ACCESS read-only 2968 STATUS current 2969 DESCRIPTION 2970 "This key is used to negotiate the task completion reporting 2971 semantics from the SCSI target. 2973 Default value is taskReportingRfc3720." 2974 REFERENCE 2975 "RFC cccc, Section 13.23, Task Reporting" 2976 ::= { iscsiSessionAttributesEntry 23 } 2978 -- Session Stats Table 2980 iscsiSessionStatsTable OBJECT-TYPE 2981 SYNTAX SEQUENCE OF IscsiSessionStatsEntry 2982 MAX-ACCESS not-accessible 2983 STATUS current 2984 DESCRIPTION 2985 "A list of general iSCSI traffic counters for each of the 2986 sessions present on the system." 2987 ::= { iscsiSession 2 } 2989 iscsiSessionStatsEntry OBJECT-TYPE 2990 SYNTAX IscsiSessionStatsEntry 2991 MAX-ACCESS not-accessible 2992 STATUS current 2993 DESCRIPTION 2994 "An entry (row) containing general iSCSI traffic counters 2995 for a particular session." 2996 AUGMENTS { iscsiSessionAttributesEntry } 2998 ::= { iscsiSessionStatsTable 1 } 3000 IscsiSessionStatsEntry ::= SEQUENCE { 3001 iscsiSsnCmdPDUs Counter32, 3002 iscsiSsnRspPDUs Counter32, 3003 iscsiSsnTxDataOctets Counter64, 3004 iscsiSsnRxDataOctets Counter64, 3005 iscsiSsnLCTxDataOctets Counter32, 3006 iscsiSsnLCRxDataOctets Counter32, 3007 iscsiSsnNopReceivedPDUs Counter32, 3008 iscsiSsnNopSentPDUs Counter32 3009 } 3011 iscsiSsnCmdPDUs OBJECT-TYPE 3012 SYNTAX Counter32 3013 UNITS "PDUs" 3014 MAX-ACCESS read-only 3015 STATUS current 3016 DESCRIPTION 3017 "The count of Command PDUs transferred on this session. 3018 If this counter has suffered a discontinuity, the time of the 3019 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 3020 ::= { iscsiSessionStatsEntry 1 } 3022 iscsiSsnRspPDUs OBJECT-TYPE 3023 SYNTAX Counter32 3024 UNITS "PDUs" 3025 MAX-ACCESS read-only 3026 STATUS current 3027 DESCRIPTION 3028 "The count of Response PDUs transferred on this session. 3029 If this counter has suffered a discontinuity, the time of the 3030 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 3031 ::= { iscsiSessionStatsEntry 2 } 3033 iscsiSsnTxDataOctets OBJECT-TYPE 3034 SYNTAX Counter64 3035 UNITS "octets" 3036 MAX-ACCESS read-only 3037 STATUS current 3038 DESCRIPTION 3039 "The count of data octets that were transmitted by 3040 the local iSCSI node on this session. 3041 If this counter has suffered a discontinuity, the time of the 3042 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 3043 ::= { iscsiSessionStatsEntry 3 } 3045 iscsiSsnRxDataOctets OBJECT-TYPE 3046 SYNTAX Counter64 3047 UNITS "octets" 3048 MAX-ACCESS read-only 3049 STATUS current 3050 DESCRIPTION 3051 "The count of data octets that were received by 3052 the local iSCSI node on this session. 3053 If this counter has suffered a discontinuity, the time of the 3054 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 3055 ::= { iscsiSessionStatsEntry 4 } 3057 iscsiSsnLCTxDataOctets OBJECT-TYPE 3058 SYNTAX Counter32 3059 UNITS "octets" 3060 MAX-ACCESS read-only 3061 STATUS current 3062 DESCRIPTION 3063 "A Low Capacity shadow object of iscsiSsnTxDataOctets 3064 for those systems which are accessible via SNMPv1 only. 3066 If this counter has suffered a discontinuity, the time of the 3067 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 3068 ::= { iscsiSessionStatsEntry 5 } 3070 iscsiSsnLCRxDataOctets OBJECT-TYPE 3071 SYNTAX Counter32 3072 UNITS "octets" 3073 MAX-ACCESS read-only 3074 STATUS current 3075 DESCRIPTION 3076 "A Low Capacity shadow object of iscsiSsnRxDataOctets 3077 for those systems which are accessible via SNMPv1 only. 3078 If this counter has suffered a discontinuity, the time of the 3079 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 3080 ::= { iscsiSessionStatsEntry 6 } 3082 iscsiSsnNopReceivedPDUs OBJECT-TYPE 3083 SYNTAX Counter32 3084 UNITS "PDUs" 3085 MAX-ACCESS read-only 3086 STATUS current 3087 DESCRIPTION 3088 "The count of NOP-In or NOP-Out PDUs received on this session. 3089 If this counter has suffered a discontinuity, the time of the 3090 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 3091 ::= { iscsiSessionStatsEntry 7 } 3093 iscsiSsnNopSentPDUs OBJECT-TYPE 3094 SYNTAX Counter32 3095 UNITS "PDUs" 3096 MAX-ACCESS read-only 3097 STATUS current 3098 DESCRIPTION 3099 "The count of NOP-In or NOP-Out PDUs sent on this session. 3100 If this counter has suffered a discontinuity, the time of the 3101 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 3102 ::= { iscsiSessionStatsEntry 8 } 3104 -- Session Connection Error Stats Table 3106 iscsiSessionCxnErrorStatsTable OBJECT-TYPE 3107 SYNTAX SEQUENCE OF IscsiSessionCxnErrorStatsEntry 3108 MAX-ACCESS not-accessible 3109 STATUS current 3110 DESCRIPTION 3111 "A list of error counters for each of the sessions 3112 present on this system." 3113 ::= { iscsiSession 3 } 3114 iscsiSessionCxnErrorStatsEntry OBJECT-TYPE 3115 SYNTAX IscsiSessionCxnErrorStatsEntry 3116 MAX-ACCESS not-accessible 3117 STATUS current 3118 DESCRIPTION 3119 "An entry (row) containing error counters for 3120 a particular session." 3121 AUGMENTS { iscsiSessionAttributesEntry } 3122 ::= { iscsiSessionCxnErrorStatsTable 1 } 3124 IscsiSessionCxnErrorStatsEntry ::= SEQUENCE { 3125 iscsiSsnCxnDigestErrors Counter32, 3126 iscsiSsnCxnTimeoutErrors Counter32 3127 } 3129 iscsiSsnCxnDigestErrors OBJECT-TYPE 3130 SYNTAX Counter32 3131 UNITS "PDUs" 3132 MAX-ACCESS read-only 3133 STATUS current 3134 DESCRIPTION 3135 "The count of PDUs that were received on the session and 3136 contained header or data digest errors. 3137 If this counter has suffered a discontinuity, the time of the 3138 last discontinuity is indicated in iscsiSsnDiscontinuityTime. 3139 This counter is most likely provided when the error-recovery- 3140 level is 1 or 2" 3141 REFERENCE 3142 "RFC cccc, Section 7.8, Digest Errors" 3143 ::= { iscsiSessionCxnErrorStatsEntry 1 } 3145 iscsiSsnCxnTimeoutErrors OBJECT-TYPE 3146 SYNTAX Counter32 3147 UNITS "connections" 3148 MAX-ACCESS read-only 3149 STATUS current 3150 DESCRIPTION 3151 "The count of connections within this session 3152 that have been terminated due to timeout. 3153 If this counter has suffered a discontinuity, the time of the 3154 last discontinuity is indicated in iscsiSsnDiscontinuityTime. 3155 This counter is most likely provided when the error-recovery- 3156 level is 2" 3157 REFERENCE 3158 "RFC cccc, Section 7.5, Connection Timeout Management" 3159 ::= { iscsiSessionCxnErrorStatsEntry 2 } 3161 --********************************************************************** 3162 iscsiConnection OBJECT IDENTIFIER ::= { iscsiObjects 11 } 3164 -- Connection Attributes Table 3166 iscsiConnectionAttributesTable OBJECT-TYPE 3167 SYNTAX SEQUENCE OF IscsiConnectionAttributesEntry 3168 MAX-ACCESS not-accessible 3169 STATUS current 3170 DESCRIPTION 3171 "A list of connections belonging to each iSCSI instance 3172 present on the system." 3173 ::= { iscsiConnection 1 } 3175 iscsiConnectionAttributesEntry OBJECT-TYPE 3176 SYNTAX IscsiConnectionAttributesEntry 3177 MAX-ACCESS not-accessible 3178 STATUS current 3179 DESCRIPTION 3180 "An entry (row) containing management information applicable 3181 to a particular connection." 3182 INDEX { iscsiInstIndex, iscsiSsnNodeIndex, iscsiSsnIndex, 3183 iscsiCxnIndex } 3184 ::= { iscsiConnectionAttributesTable 1 } 3186 IscsiConnectionAttributesEntry ::= SEQUENCE { 3187 iscsiCxnIndex Unsigned32, 3188 iscsiCxnCid Unsigned32, 3189 iscsiCxnState INTEGER, 3190 iscsiCxnAddrType InetAddressType, 3191 iscsiCxnLocalAddr InetAddress, 3192 iscsiCxnProtocol IscsiTransportProtocol, 3193 iscsiCxnLocalPort InetPortNumber, 3194 iscsiCxnRemoteAddr InetAddress, 3195 iscsiCxnRemotePort InetPortNumber, 3196 iscsiCxnMaxRecvDataSegLength Unsigned32, 3197 iscsiCxnMaxXmitDataSegLength Unsigned32, 3198 iscsiCxnHeaderIntegrity IscsiDigestMethod, 3199 iscsiCxnDataIntegrity IscsiDigestMethod, 3200 iscsiCxnRecvMarker TruthValue, 3201 iscsiCxnSendMarker TruthValue, 3202 iscsiCxnVersionActive Unsigned32 3203 } 3205 iscsiCxnIndex OBJECT-TYPE 3206 SYNTAX Unsigned32 (1..4294967295) 3207 MAX-ACCESS not-accessible 3208 STATUS current 3209 DESCRIPTION 3210 "An arbitrary integer used to uniquely identify a 3211 particular connection of a particular session within 3212 an iSCSI instance present on the local system. An 3213 agent should attempt to not reuse index values unless 3214 a reboot has occurred. iSCSI connections are destroyed 3215 during a reboot; rows in this table are not persistent 3216 across reboots." 3218 ::= { iscsiConnectionAttributesEntry 1 } 3220 iscsiCxnCid OBJECT-TYPE 3221 SYNTAX Unsigned32 (1..65535) 3222 MAX-ACCESS read-only 3223 STATUS current 3224 DESCRIPTION 3225 "The iSCSI Connection ID for this connection." 3226 ::= { iscsiConnectionAttributesEntry 2 } 3228 iscsiCxnState OBJECT-TYPE 3229 SYNTAX INTEGER { 3230 login(1), 3231 full(2), 3232 logout(3) 3233 } 3234 MAX-ACCESS read-only 3235 STATUS current 3236 DESCRIPTION 3237 "The current state of this connection, from an iSCSI negotiation 3238 point of view. Here are the states: 3240 login - The transport protocol connection has been established, 3241 but a valid iSCSI login response with the final bit set 3242 has not been sent or received. 3243 full - A valid iSCSI login response with the final bit set 3244 has been sent or received. 3245 logout - A valid iSCSI logout command has been sent or 3246 received, but the transport protocol connection has 3247 not yet been closed." 3248 ::= { iscsiConnectionAttributesEntry 3 } 3250 iscsiCxnAddrType OBJECT-TYPE 3251 SYNTAX InetAddressType 3252 MAX-ACCESS read-only 3253 STATUS current 3254 DESCRIPTION 3255 "The type of Internet Network Addresses contained in the 3256 corresponding instances of iscsiCxnLocalAddr and 3257 iscsiCxnRemoteAddr. 3258 The value 'dns' is not allowed." 3259 ::= { iscsiConnectionAttributesEntry 4 } 3260 iscsiCxnLocalAddr OBJECT-TYPE 3261 SYNTAX InetAddress 3262 MAX-ACCESS read-only 3263 STATUS current 3264 DESCRIPTION 3265 "The local Internet Network Address, of the type specified 3266 by iscsiCxnAddrType, used by this connection." 3267 ::= { iscsiConnectionAttributesEntry 5 } 3269 iscsiCxnProtocol OBJECT-TYPE 3270 SYNTAX IscsiTransportProtocol 3271 MAX-ACCESS read-only 3272 STATUS current 3273 DESCRIPTION 3274 "The transport protocol over which this connection is 3275 running." 3276 ::= { iscsiConnectionAttributesEntry 6 } 3278 iscsiCxnLocalPort OBJECT-TYPE 3279 SYNTAX InetPortNumber 3280 MAX-ACCESS read-only 3281 STATUS current 3282 DESCRIPTION 3283 "The local transport protocol port used by this connection. 3284 This object cannot have the value zero, since it represents 3285 an established connection." 3286 ::= { iscsiConnectionAttributesEntry 7 } 3288 iscsiCxnRemoteAddr OBJECT-TYPE 3289 SYNTAX InetAddress 3290 MAX-ACCESS read-only 3291 STATUS current 3292 DESCRIPTION 3293 "The remote Internet Network Address, of the type specified 3294 by iscsiCxnAddrType, used by this connection." 3295 ::= { iscsiConnectionAttributesEntry 8 } 3297 iscsiCxnRemotePort OBJECT-TYPE 3298 SYNTAX InetPortNumber 3299 MAX-ACCESS read-only 3300 STATUS current 3301 DESCRIPTION 3302 "The remote transport protocol port used by this connection. 3303 This object cannot have the value zero, since it represents 3304 an established connection." 3305 ::= { iscsiConnectionAttributesEntry 9 } 3307 iscsiCxnMaxRecvDataSegLength OBJECT-TYPE 3308 SYNTAX Unsigned32 (512..16777215) 3309 UNITS "bytes" 3310 MAX-ACCESS read-only 3311 STATUS current 3312 DESCRIPTION 3313 "The maximum data payload size supported for command 3314 or data PDUs able to be received on this connection." 3315 REFERENCE 3316 "RFC cccc, Section 13.12, MaxRecvDataSegmentLength" 3317 ::= { iscsiConnectionAttributesEntry 10 } 3319 iscsiCxnMaxXmitDataSegLength OBJECT-TYPE 3320 SYNTAX Unsigned32 (512..16777215) 3321 UNITS "bytes" 3322 MAX-ACCESS read-only 3323 STATUS current 3324 DESCRIPTION 3325 "The maximum data payload size supported for command 3326 or data PDUs to be sent on this connection." 3327 REFERENCE 3328 "RFC cccc, Section 13.12, MaxRecvDataSegmentLength" 3329 ::= { iscsiConnectionAttributesEntry 11 } 3331 iscsiCxnHeaderIntegrity OBJECT-TYPE 3332 SYNTAX IscsiDigestMethod 3333 MAX-ACCESS read-only 3334 STATUS current 3335 DESCRIPTION 3336 "This object identifies the iSCSI header 3337 digest scheme in use within this connection." 3338 ::= { iscsiConnectionAttributesEntry 12 } 3340 iscsiCxnDataIntegrity OBJECT-TYPE 3341 SYNTAX IscsiDigestMethod 3342 MAX-ACCESS read-only 3343 STATUS current 3344 DESCRIPTION 3345 "This object identifies the iSCSI data 3346 digest scheme in use within this connection." 3347 ::= { iscsiConnectionAttributesEntry 13 } 3349 iscsiCxnRecvMarker OBJECT-TYPE 3350 SYNTAX TruthValue 3351 MAX-ACCESS read-only 3352 STATUS deprecated 3353 DESCRIPTION 3354 "This object indicates whether or not this connection 3355 is receiving markers in its incoming data stream." 3356 REFERENCE 3357 "[RFCcccc], 13.25 Obsoleted Keys." 3358 ::= { iscsiConnectionAttributesEntry 14 } 3360 iscsiCxnSendMarker OBJECT-TYPE 3361 SYNTAX TruthValue 3362 MAX-ACCESS read-only 3363 STATUS deprecated 3364 DESCRIPTION 3365 "This object indicates whether or not this connection 3366 is inserting markers in its outgoing data stream." 3367 REFERENCE 3368 "[RFCcccc], 13.25 Obsoleted Keys." 3369 ::= { iscsiConnectionAttributesEntry 15 } 3371 iscsiCxnVersionActive OBJECT-TYPE 3372 SYNTAX Unsigned32 (0..255) 3373 MAX-ACCESS read-only 3374 STATUS current 3375 DESCRIPTION 3376 "Active version number of the iSCSI specification negotiated 3377 on this connection." 3378 REFERENCE 3379 "RFC cccc, Section 11.12, Login Request" 3380 ::= { iscsiConnectionAttributesEntry 16 } 3382 --********************************************************************** 3383 -- Notifications 3385 iscsiTgtLoginFailure NOTIFICATION-TYPE 3386 OBJECTS { 3387 iscsiTgtLoginFailures, 3388 iscsiTgtLastFailureType, 3389 iscsiTgtLastIntrFailureName, 3390 iscsiTgtLastIntrFailureAddrType, 3391 iscsiTgtLastIntrFailureAddr, 3392 iscsiTgtLastIntrFailurePort 3393 } 3394 STATUS current 3395 DESCRIPTION 3396 "Sent when a login is failed by a target. 3398 To avoid sending an excessive number of notifications due 3399 to multiple errors counted, an SNMP agent implementing this 3400 notification SHOULD NOT send more than 3 notifications of 3401 this type in any 10-second time period." 3402 ::= { iscsiNotifications 1 } 3404 iscsiIntrLoginFailure NOTIFICATION-TYPE 3405 OBJECTS { 3406 iscsiIntrLoginFailures, 3407 iscsiIntrLastFailureType, 3408 iscsiIntrLastTgtFailureName, 3409 iscsiIntrLastTgtFailureAddrType, 3410 iscsiIntrLastTgtFailureAddr, 3411 iscsiIntrLastTgtFailurePort 3412 } 3413 STATUS current 3414 DESCRIPTION 3415 "Sent when a login is failed by an initiator. 3417 To avoid sending an excessive number of notifications due 3418 to multiple errors counted, an SNMP agent implementing this 3419 notification SHOULD NOT send more than 3 notifications of 3420 this type in any 10-second time period." 3421 ::= { iscsiNotifications 2 } 3423 iscsiInstSessionFailure NOTIFICATION-TYPE 3424 OBJECTS { 3425 iscsiInstSsnFailures, 3426 iscsiInstLastSsnFailureType, 3427 iscsiInstLastSsnRmtNodeName 3428 } 3429 STATUS current 3430 DESCRIPTION 3431 "Sent when an active session is failed by either the initiator 3432 or the target. 3434 To avoid sending an excessive number of notifications due 3435 to multiple errors counted, an SNMP agent implementing this 3436 notification SHOULD NOT send more than 3 notifications of 3437 this type in any 10-second time period." 3438 ::= { iscsiNotifications 3 } 3440 --********************************************************************** 3442 -- Conformance Statements 3444 iscsiCompliances OBJECT IDENTIFIER ::= { iscsiConformance 1 } 3445 iscsiGroups OBJECT IDENTIFIER ::= { iscsiConformance 2 } 3447 iscsiInstanceAttributesGroup OBJECT-GROUP 3448 OBJECTS { 3449 iscsiInstDescr, 3450 iscsiInstVersionMin, 3451 iscsiInstVersionMax, 3452 iscsiInstVendorID, 3453 iscsiInstVendorVersion, 3454 iscsiInstPortalNumber, 3455 iscsiInstNodeNumber, 3456 iscsiInstSessionNumber, 3457 iscsiInstSsnFailures, 3458 iscsiInstLastSsnFailureType, 3459 iscsiInstLastSsnRmtNodeName, 3460 iscsiInstDiscontinuityTime, 3461 iscsiInstXNodeArchitecture 3462 } 3463 STATUS current 3464 DESCRIPTION 3465 "A collection of objects providing information about iSCSI 3466 instances." 3467 ::= { iscsiGroups 1 } 3469 iscsiInstanceSsnErrorStatsGroup OBJECT-GROUP 3470 OBJECTS { 3471 iscsiInstSsnDigestErrors, 3472 iscsiInstSsnCxnTimeoutErrors, 3473 iscsiInstSsnFormatErrors 3474 } 3475 STATUS current 3476 DESCRIPTION 3477 "A collection of objects providing information about 3478 errors that have caused a session failure for an 3479 iSCSI instance." 3480 ::= { iscsiGroups 2 } 3482 iscsiPortalAttributesGroup OBJECT-GROUP 3483 OBJECTS { 3484 iscsiPortalRowStatus, 3485 iscsiPortalStorageType, 3486 iscsiPortalRoles, 3487 iscsiPortalAddrType, 3488 iscsiPortalAddr, 3489 iscsiPortalProtocol, 3490 iscsiPortalMaxRecvDataSegLength, 3491 iscsiPortalPrimaryHdrDigest, 3492 iscsiPortalPrimaryDataDigest, 3493 iscsiPortalSecondaryHdrDigest, 3494 iscsiPortalSecondaryDataDigest, 3495 iscsiPortalRecvMarker 3496 } 3497 STATUS deprecated 3498 DESCRIPTION 3499 "A collection of objects providing information about 3500 the transport protocol endpoints of the local targets. 3501 This object group is deprecated because the marker key 3502 is obsolete." 3503 REFERENCE 3504 "[RFCcccc], 13.25 Obsoleted Keys." 3505 ::= { iscsiGroups 3 } 3507 iscsiTgtPortalAttributesGroup OBJECT-GROUP 3508 OBJECTS { 3509 iscsiTgtPortalPort, 3510 iscsiTgtPortalTag 3511 } 3512 STATUS current 3513 DESCRIPTION 3514 "A collection of objects providing information about 3515 the transport protocol endpoints of the local targets." 3516 ::= { iscsiGroups 4 } 3518 iscsiIntrPortalAttributesGroup OBJECT-GROUP 3519 OBJECTS { 3520 iscsiIntrPortalTag 3521 } 3522 STATUS current 3523 DESCRIPTION 3524 "An object providing information about 3525 the portal tags used by the local initiators." 3526 ::= { iscsiGroups 5 } 3528 iscsiNodeAttributesGroup OBJECT-GROUP 3529 OBJECTS { 3530 iscsiNodeName, 3531 iscsiNodeAlias, 3532 iscsiNodeRoles, 3533 iscsiNodeTransportType, 3534 iscsiNodeInitialR2T, 3535 iscsiNodeImmediateData, 3536 iscsiNodeMaxOutstandingR2T, 3537 iscsiNodeFirstBurstLength, 3538 iscsiNodeMaxBurstLength, 3539 iscsiNodeMaxConnections, 3540 iscsiNodeDataSequenceInOrder, 3541 iscsiNodeDataPDUInOrder, 3542 iscsiNodeDefaultTime2Wait, 3543 iscsiNodeDefaultTime2Retain, 3544 iscsiNodeErrorRecoveryLevel, 3545 iscsiNodeDiscontinuityTime, 3546 iscsiNodeStorageType 3547 } 3548 STATUS current 3549 DESCRIPTION 3550 "A collection of objects providing information about all 3551 local targets." 3552 ::= { iscsiGroups 6 } 3553 iscsiTargetAttributesGroup OBJECT-GROUP 3554 OBJECTS { 3555 iscsiTgtLoginFailures, 3556 iscsiTgtLastFailureTime, 3557 iscsiTgtLastFailureType, 3558 iscsiTgtLastIntrFailureName, 3559 iscsiTgtLastIntrFailureAddrType, 3560 iscsiTgtLastIntrFailureAddr 3561 } 3562 STATUS current 3563 DESCRIPTION 3564 "A collection of objects providing information about all 3565 local targets." 3566 ::= { iscsiGroups 7 } 3568 iscsiTargetLoginStatsGroup OBJECT-GROUP 3569 OBJECTS { 3570 iscsiTgtLoginAccepts, 3571 iscsiTgtLoginOtherFails, 3572 iscsiTgtLoginRedirects, 3573 iscsiTgtLoginAuthorizeFails, 3574 iscsiTgtLoginAuthenticateFails, 3575 iscsiTgtLoginNegotiateFails 3576 } 3577 STATUS current 3578 DESCRIPTION 3579 "A collection of objects providing information about all 3580 login attempts by remote initiators to local targets." 3581 ::= { iscsiGroups 8 } 3583 iscsiTargetLogoutStatsGroup OBJECT-GROUP 3584 OBJECTS { 3585 iscsiTgtLogoutNormals, 3586 iscsiTgtLogoutOthers 3587 } 3588 STATUS current 3589 DESCRIPTION 3590 "A collection of objects providing information about all 3591 logout events between remote initiators and local targets." 3592 ::= { iscsiGroups 9 } 3594 iscsiTargetAuthGroup OBJECT-GROUP 3595 OBJECTS { 3596 iscsiTgtAuthRowStatus, 3597 iscsiTgtAuthStorageType, 3598 iscsiTgtAuthIdentity 3599 } 3600 STATUS current 3601 DESCRIPTION 3602 "A collection of objects providing information about all 3603 remote initiators that are authorized to connect to local 3604 targets." 3605 ::= { iscsiGroups 10 } 3607 iscsiInitiatorAttributesGroup OBJECT-GROUP 3608 OBJECTS { 3609 iscsiIntrLoginFailures, 3610 iscsiIntrLastFailureTime, 3611 iscsiIntrLastFailureType, 3612 iscsiIntrLastTgtFailureName, 3613 iscsiIntrLastTgtFailureAddrType, 3614 iscsiIntrLastTgtFailureAddr 3615 } 3616 STATUS current 3617 DESCRIPTION 3618 "A collection of objects providing information about 3619 all local initiators." 3620 ::= { iscsiGroups 11 } 3622 iscsiInitiatorLoginStatsGroup OBJECT-GROUP 3623 OBJECTS { 3624 iscsiIntrLoginAcceptRsps, 3625 iscsiIntrLoginOtherFailRsps, 3626 iscsiIntrLoginRedirectRsps, 3627 iscsiIntrLoginAuthFailRsps, 3628 iscsiIntrLoginAuthenticateFails, 3629 iscsiIntrLoginNegotiateFails, 3630 iscsiIntrLoginAuthorizeFails 3631 } 3632 STATUS current 3633 DESCRIPTION 3634 "A collection of objects providing information about all 3635 login attempts by local initiators to remote targets." 3636 ::= { iscsiGroups 12 } 3638 iscsiInitiatorLogoutStatsGroup OBJECT-GROUP 3639 OBJECTS { 3640 iscsiIntrLogoutNormals, 3641 iscsiIntrLogoutOthers 3642 } 3643 STATUS current 3644 DESCRIPTION 3645 "A collection of objects providing information about all 3646 logout events between local initiators and remote targets." 3647 ::= { iscsiGroups 13 } 3649 iscsiInitiatorAuthGroup OBJECT-GROUP 3650 OBJECTS { 3651 iscsiIntrAuthRowStatus, 3652 iscsiIntrAuthStorageType, 3653 iscsiIntrAuthIdentity 3654 } 3655 STATUS current 3656 DESCRIPTION 3657 "A collection of objects providing information about all 3658 remote targets that are initiators of the local system 3659 that they are authorized to access." 3660 ::= { iscsiGroups 14 } 3662 iscsiSessionAttributesGroup OBJECT-GROUP 3663 OBJECTS { 3664 iscsiSsnDirection, 3665 iscsiSsnInitiatorName, 3666 iscsiSsnTargetName, 3667 iscsiSsnTSIH, 3668 iscsiSsnISID, 3669 iscsiSsnInitiatorAlias, 3670 iscsiSsnTargetAlias, 3671 iscsiSsnInitialR2T, 3672 iscsiSsnImmediateData, 3673 iscsiSsnType, 3674 iscsiSsnMaxOutstandingR2T, 3675 iscsiSsnFirstBurstLength, 3676 iscsiSsnMaxBurstLength, 3677 iscsiSsnConnectionNumber, 3678 iscsiSsnAuthIdentity, 3679 iscsiSsnDataSequenceInOrder, 3680 iscsiSsnDataPDUInOrder, 3681 iscsiSsnErrorRecoveryLevel, 3682 iscsiSsnDiscontinuityTime, 3683 iscsiSsnProtocolLevel, 3684 iscsiSsnTaskReporting 3685 } 3686 STATUS current 3687 DESCRIPTION 3688 "A collection of objects providing information applicable to 3689 all sessions." 3690 ::= { iscsiGroups 15 } 3692 iscsiSessionPDUStatsGroup OBJECT-GROUP 3693 OBJECTS { 3694 iscsiSsnCmdPDUs, 3695 iscsiSsnRspPDUs 3696 } 3697 STATUS current 3698 DESCRIPTION 3699 "A collection of objects providing information about PDU 3700 traffic for each session." 3701 ::= { iscsiGroups 16 } 3703 iscsiSessionOctetStatsGroup OBJECT-GROUP 3704 OBJECTS { 3705 iscsiSsnTxDataOctets, 3706 iscsiSsnRxDataOctets 3707 } 3708 STATUS current 3709 DESCRIPTION 3710 "A collection of objects providing information about octet 3711 traffic for each session using a Counter64 data type." 3712 ::= { iscsiGroups 17 } 3714 iscsiSessionLCOctetStatsGroup OBJECT-GROUP 3715 OBJECTS { 3716 iscsiSsnLCTxDataOctets, 3717 iscsiSsnLCRxDataOctets 3718 } 3719 STATUS current 3720 DESCRIPTION 3721 "A collection of objects providing information about octet 3722 traffic for each session using a Counter32 data type." 3723 ::= { iscsiGroups 18 } 3725 iscsiSessionCxnErrorStatsGroup OBJECT-GROUP 3726 OBJECTS { 3727 iscsiSsnCxnDigestErrors, 3728 iscsiSsnCxnTimeoutErrors 3729 } 3730 STATUS current 3731 DESCRIPTION 3732 "A collection of objects providing information about connection 3733 errors for all sessions." 3734 ::= { iscsiGroups 19 } 3736 iscsiConnectionAttributesGroup OBJECT-GROUP 3737 OBJECTS { 3738 iscsiCxnCid, 3739 iscsiCxnState, 3740 iscsiCxnProtocol, 3741 iscsiCxnAddrType, 3742 iscsiCxnLocalAddr, 3743 iscsiCxnLocalPort, 3744 iscsiCxnRemoteAddr, 3745 iscsiCxnRemotePort, 3746 iscsiCxnMaxRecvDataSegLength, 3747 iscsiCxnMaxXmitDataSegLength, 3748 iscsiCxnHeaderIntegrity, 3749 iscsiCxnDataIntegrity, 3750 iscsiCxnRecvMarker, 3751 iscsiCxnSendMarker, 3752 iscsiCxnVersionActive 3753 } 3754 STATUS deprecated 3755 DESCRIPTION 3756 "A collection of objects providing information about all 3757 connections used by all sessions. 3758 This object group is deprecated because the marker key 3759 is obsolete." 3760 REFERENCE 3761 "[RFCcccc], 13.25 Obsoleted Keys." 3762 ::= { iscsiGroups 20 } 3764 iscsiTgtLgnNotificationsGroup NOTIFICATION-GROUP 3765 NOTIFICATIONS { 3766 iscsiTgtLoginFailure 3767 } 3768 STATUS current 3769 DESCRIPTION 3770 "A collection of notifications that indicate a login 3771 failure from a remote initiator to a local target." 3772 ::= { iscsiGroups 21 } 3774 iscsiIntrLgnNotificationsGroup NOTIFICATION-GROUP 3775 NOTIFICATIONS { 3776 iscsiIntrLoginFailure 3777 } 3778 STATUS current 3779 DESCRIPTION 3780 "A collection of notifications that indicate a login 3781 failure from a local initiator to a remote target." 3782 ::= { iscsiGroups 22 } 3784 iscsiSsnFlrNotificationsGroup NOTIFICATION-GROUP 3785 NOTIFICATIONS { 3786 iscsiInstSessionFailure 3787 } 3788 STATUS current 3789 DESCRIPTION 3790 "A collection of notifications that indicate session 3791 failures occurring after login." 3792 ::= { iscsiGroups 23 } 3794 iscsiPortalAttributesGroupV2 OBJECT-GROUP 3795 OBJECTS { 3796 iscsiPortalRowStatus, 3797 iscsiPortalStorageType, 3798 iscsiPortalRoles, 3799 iscsiPortalAddrType, 3800 iscsiPortalAddr, 3801 iscsiPortalProtocol, 3802 iscsiPortalMaxRecvDataSegLength, 3803 iscsiPortalPrimaryHdrDigest, 3804 iscsiPortalPrimaryDataDigest, 3805 iscsiPortalSecondaryHdrDigest, 3806 iscsiPortalSecondaryDataDigest 3807 } 3808 STATUS current 3809 DESCRIPTION 3810 "A collection of objects providing information about 3811 the transport protocol endpoints of the local targets." 3812 ::= { iscsiGroups 24 } 3814 iscsiConnectionAttributesGroupV2 OBJECT-GROUP 3815 OBJECTS { 3816 iscsiCxnCid, 3817 iscsiCxnState, 3818 iscsiCxnProtocol, 3819 iscsiCxnAddrType, 3820 iscsiCxnLocalAddr, 3821 iscsiCxnLocalPort, 3822 iscsiCxnRemoteAddr, 3823 iscsiCxnRemotePort, 3824 iscsiCxnMaxRecvDataSegLength, 3825 iscsiCxnMaxXmitDataSegLength, 3826 iscsiCxnHeaderIntegrity, 3827 iscsiCxnDataIntegrity, 3828 iscsiCxnVersionActive 3829 } 3831 STATUS current 3832 DESCRIPTION 3833 "A collection of objects providing information about all 3834 connections used by all sessions." 3835 ::= { iscsiGroups 25 } 3837 iscsiNewObjectsV2 OBJECT-GROUP 3838 OBJECTS { 3839 iscsiInstXNodeArchitecture, 3840 iscsiSsnTaskReporting, 3841 iscsiSsnProtocolLevel, 3842 iscsiSsnNopReceivedPDUs, 3843 iscsiSsnNopSentPDUs, 3844 iscsiIntrLastTgtFailurePort, 3845 iscsiTgtLastIntrFailurePort, 3846 iscsiPortalDescr, 3847 iscsiInstSsnTgtUnmappedErrors, 3848 iscsiTgtLogoutCxnClosed, 3849 iscsiTgtLogoutCxnRemoved 3850 } 3852 STATUS current 3853 DESCRIPTION 3854 "A collection of objects added in the second version of the 3855 iSCSI MIB." 3856 ::= { iscsiGroups 26 } 3858 --********************************************************************** 3860 iscsiComplianceV1 MODULE-COMPLIANCE 3861 STATUS deprecated 3862 DESCRIPTION 3863 "Initial version of compliance statement. 3865 If an implementation can be both a target and an 3866 initiator, all groups are mandatory. 3867 This module compliance is deprecated because the 3868 marker keys are obsolete." 3869 REFERENCE 3870 "[RFCcccc], 13.25 Obsoleted Keys." 3871 MODULE -- this module 3872 MANDATORY-GROUPS { 3873 iscsiInstanceAttributesGroup, 3874 iscsiInstanceSsnErrorStatsGroup, 3875 iscsiPortalAttributesGroup, 3876 iscsiNodeAttributesGroup, 3877 iscsiSessionAttributesGroup, 3878 iscsiSessionPDUStatsGroup, 3879 iscsiSessionCxnErrorStatsGroup, 3880 iscsiConnectionAttributesGroup, 3881 iscsiSsnFlrNotificationsGroup 3882 } 3884 -- Conditionally mandatory groups depending on the ability 3885 -- to support Counter64 data types and/or to provide counter 3886 -- information to SNMPv1 applications. 3888 GROUP iscsiSessionOctetStatsGroup 3889 DESCRIPTION 3890 "This group is mandatory for all iSCSI implementations 3891 that can support Counter64 data types." 3893 GROUP iscsiSessionLCOctetStatsGroup 3894 DESCRIPTION 3895 "This group is mandatory for all iSCSI implementations 3896 that provide information to SNMPv1-only applications; 3897 this includes agents that cannot support Counter64 3898 data types." 3900 -- Conditionally mandatory groups to be included with 3901 -- the mandatory groups when the implementation has 3902 -- iSCSI target facilities. 3904 GROUP iscsiTgtPortalAttributesGroup 3905 DESCRIPTION 3906 "This group is mandatory for all iSCSI implementations 3907 that have iSCSI target facilities." 3909 OBJECT iscsiPortalMaxRecvDataSegLength 3910 MIN-ACCESS read-only 3911 DESCRIPTION 3912 "Write access is not required." 3914 OBJECT iscsiNodeStorageType 3915 MIN-ACCESS read-only 3916 DESCRIPTION 3917 "Write access is not required; an implementation may 3918 choose to allow this object to be set to 'volatile' 3919 or 'nonVolatile'." 3920 GROUP iscsiTargetAttributesGroup 3921 DESCRIPTION 3922 "This group is mandatory for all iSCSI implementations 3923 that have iSCSI target facilities." 3925 GROUP iscsiTargetLoginStatsGroup 3926 DESCRIPTION 3927 "This group is mandatory for all iSCSI implementations 3928 that have iSCSI target facilities." 3930 GROUP iscsiTargetLogoutStatsGroup 3931 DESCRIPTION 3932 "This group is mandatory for all iSCSI implementations 3933 that have iSCSI target facilities." 3935 GROUP iscsiTgtLgnNotificationsGroup 3936 DESCRIPTION 3937 "This group is mandatory for all iSCSI implementations 3938 that have iSCSI target facilities." 3940 GROUP iscsiTargetAuthGroup 3941 DESCRIPTION 3942 "This group is mandatory for all iSCSI implementations 3943 that have iSCSI target facilities." 3945 -- Conditionally mandatory groups to be included with 3946 -- the mandatory groups when the implementation has 3947 -- iSCSI initiator facilities. 3949 GROUP iscsiIntrPortalAttributesGroup 3950 DESCRIPTION 3951 "This group is mandatory for all iSCSI implementations 3952 that have iSCSI initiator facilities." 3954 GROUP iscsiInitiatorAttributesGroup 3955 DESCRIPTION 3956 "This group is mandatory for all iSCSI implementations 3957 that have iSCSI initiator facilities." 3959 GROUP iscsiInitiatorLoginStatsGroup 3960 DESCRIPTION 3961 "This group is mandatory for all iSCSI implementations 3962 that have iSCSI initiator facilities." 3964 GROUP iscsiInitiatorLogoutStatsGroup 3965 DESCRIPTION 3966 "This group is mandatory for all iSCSI implementations 3967 that have iSCSI initiator facilities." 3969 GROUP iscsiIntrLgnNotificationsGroup 3970 DESCRIPTION 3971 "This group is mandatory for all iSCSI implementations 3972 that have iSCSI initiator facilities." 3974 GROUP iscsiInitiatorAuthGroup 3975 DESCRIPTION 3976 "This group is mandatory for all iSCSI implementations 3977 that have iSCSI initiator facilities." 3979 OBJECT iscsiNodeErrorRecoveryLevel 3980 SYNTAX Unsigned32 (0..2) 3981 DESCRIPTION 3982 "Only values 0-2 are defined at present." 3984 ::= { iscsiCompliances 1 } 3986 iscsiComplianceV2 MODULE-COMPLIANCE 3987 STATUS current 3988 DESCRIPTION 3989 "Version 2 of compliance statement based on 3990 this revised version of the MIB module. 3992 If an implementation can be both a target and an 3993 initiator, all groups are mandatory." 3994 MODULE -- this module 3995 MANDATORY-GROUPS { 3996 iscsiInstanceAttributesGroup, 3997 iscsiInstanceSsnErrorStatsGroup, 3998 iscsiPortalAttributesGroupV2, 3999 iscsiNodeAttributesGroup, 4000 iscsiSessionAttributesGroup, 4001 iscsiSessionPDUStatsGroup, 4002 iscsiSessionCxnErrorStatsGroup, 4003 iscsiConnectionAttributesGroupV2, 4004 iscsiSsnFlrNotificationsGroup 4005 } 4007 -- Conditionally mandatory groups depending on the ability 4008 -- to support Counter64 data types and/or to provide counter 4009 -- information to SNMPv1 applications. 4011 GROUP iscsiSessionOctetStatsGroup 4012 DESCRIPTION 4013 "This group is mandatory for all iSCSI implementations 4014 that can support Counter64 data types." 4016 GROUP iscsiSessionLCOctetStatsGroup 4017 DESCRIPTION 4018 "This group is mandatory for all iSCSI implementations 4019 that provide information to SNMPv1-only applications; 4020 this includes agents that cannot support Counter64 4021 data types." 4023 -- Conditionally mandatory groups to be included with 4024 -- the mandatory groups when the implementation has 4025 -- iSCSI target facilities. 4027 GROUP iscsiTgtPortalAttributesGroup 4028 DESCRIPTION 4029 "This group is mandatory for all iSCSI implementations 4030 that have iSCSI target facilities." 4032 OBJECT iscsiPortalMaxRecvDataSegLength 4033 MIN-ACCESS read-only 4034 DESCRIPTION 4035 "Write access is not required." 4037 OBJECT iscsiNodeStorageType 4038 MIN-ACCESS read-only 4039 DESCRIPTION 4040 "Write access is not required; an implementation may 4041 choose to allow this object to be set to 'volatile' 4042 or 'nonVolatile'." 4044 GROUP iscsiTargetAttributesGroup 4045 DESCRIPTION 4046 "This group is mandatory for all iSCSI implementations 4047 that have iSCSI target facilities." 4049 GROUP iscsiTargetLoginStatsGroup 4050 DESCRIPTION 4051 "This group is mandatory for all iSCSI implementations 4052 that have iSCSI target facilities." 4054 GROUP iscsiTargetLogoutStatsGroup 4055 DESCRIPTION 4056 "This group is mandatory for all iSCSI implementations 4057 that have iSCSI target facilities." 4059 GROUP iscsiTgtLgnNotificationsGroup 4060 DESCRIPTION 4061 "This group is mandatory for all iSCSI implementations 4062 that have iSCSI target facilities." 4064 GROUP iscsiTargetAuthGroup 4065 DESCRIPTION 4066 "This group is mandatory for all iSCSI implementations 4067 that have iSCSI target facilities." 4069 -- Conditionally mandatory groups to be included with 4070 -- the mandatory groups when the implementation has 4071 -- iSCSI initiator facilities. 4073 GROUP iscsiIntrPortalAttributesGroup 4074 DESCRIPTION 4075 "This group is mandatory for all iSCSI implementations 4076 that have iSCSI initiator facilities." 4078 GROUP iscsiInitiatorAttributesGroup 4079 DESCRIPTION 4080 "This group is mandatory for all iSCSI implementations 4081 that have iSCSI initiator facilities." 4083 GROUP iscsiInitiatorLoginStatsGroup 4084 DESCRIPTION 4085 "This group is mandatory for all iSCSI implementations 4086 that have iSCSI initiator facilities." 4088 GROUP iscsiInitiatorLogoutStatsGroup 4089 DESCRIPTION 4090 "This group is mandatory for all iSCSI implementations 4091 that have iSCSI initiator facilities." 4093 GROUP iscsiIntrLgnNotificationsGroup 4094 DESCRIPTION 4095 "This group is mandatory for all iSCSI implementations 4096 that have iSCSI initiator facilities." 4098 GROUP iscsiInitiatorAuthGroup 4099 DESCRIPTION 4100 "This group is mandatory for all iSCSI implementations 4101 that have iSCSI initiator facilities." 4103 OBJECT iscsiNodeErrorRecoveryLevel 4104 SYNTAX Unsigned32 (0..2) 4105 DESCRIPTION 4106 "Only values 0-2 are defined at present." 4108 GROUP iscsiNewObjectsV2 4109 DESCRIPTION 4110 "This group is mandatory for all iSCSI implementations 4111 that support a value of the iSCSIProtocolLevel key of 4112 2 or greater." 4114 ::= { iscsiCompliances 2 } 4116 END 4118 8. Security Considerations 4120 There are a number of management objects defined in this MIB module 4121 with a MAX-ACCESS clause of read-write and/or read-create. Such 4122 objects may be considered sensitive or vulnerable in some network 4123 environments. The support for SET operations in a non-secure 4124 environment without proper protection can have a negative effect on 4125 network operations. These are the tables and objects and their 4126 sensitivity/vulnerability: 4128 iscsiPortalAttributesTable, iscsiTgtPortalAttributesTable, and 4129 iscsiIntrPortalAttributesTable can be used to add or remove IP 4130 addresses to be used by iSCSI. 4132 iscsiTgtAuthAttributesTable entries can be added or removed, to 4133 allow or disallow access to a target by an initiator. 4135 Some of the readable objects in this MIB module (i.e., objects with a 4136 MAX-ACCESS other than not-accessible) may be considered sensitive or 4137 vulnerable in some network environments. It is thus important to 4138 control even GET and/or NOTIFY access to these objects and possibly 4139 to even encrypt the values of these objects when sending them over 4140 the network via SNMP. These are the tables and objects and their 4141 sensitivity/vulnerability: 4143 iscsiNodeAttributesTable, iscsiTargetAttributesTable, and 4144 iscsiTgtAuthorization can be used to glean information needed to 4145 make connections to the iSCSI targets this module represents. 4146 However, it is the responsibility of the initiators and targets 4147 involved to authenticate each other to ensure that an 4148 inappropriately advertised or discovered initiator or target does 4149 not compromise their security. These issues are discussed in 4150 [RFCcccc]. 4152 SNMP versions prior to SNMPv3 did not include adequate security. 4153 Even if the network itself is secure (for example by using IPsec), 4154 even then, there is no control as to who on the secure network is 4155 allowed to access and GET/SET (read/change/create/delete) the objects 4156 in this MIB module. 4158 Implementations SHOULD provide the security features described by the 4159 SNMPv3 framework (see [RFC3410]), and implementations claiming 4160 compliance to the SNMPv3 standard MUST include full support for 4161 authentication and privacy via the User-based Security Model (USM) 4162 [RFC3414] with the AES cipher algorithm [RFC3826]. Implementations 4163 MAY also provide support for the Transport Security Model (TSM) 4164 [RFC5591] in combination with a secure transport such as SSH[RFC5592] 4165 or TLS/DTLS [RFC6353]. 4167 Further, deployment of SNMP versions prior to SNMPv3 is NOT 4168 RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to 4169 enable cryptographic security. It is then a customer/operator 4170 responsibility to ensure that the SNMP entity giving access to an 4171 instance of this MIB module is properly configured to give access to 4172 the objects only to those principals (users) that have legitimate 4173 rights to indeed GET or SET (change/create/delete) them. 4175 9. IANA Considerations 4177 The MIB module in this document uses the following IANA-assigned 4178 OBJECT IDENTIFIER values recorded in the SMI Numbers registry: 4180 Descriptor OBJECT IDENTIFIER value 4181 ---------- ----------------------- 4183 iscsiMibModule { mib-2 142 } 4185 RFC Editor's Note (to be removed prior to publication): this draft 4186 makes no additional requests of the IANA. IANA is required to update 4187 the reference for the mib-2 142 to this document. 4189 10. References 4191 10.1. Normative References 4193 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 4194 Requirement Levels", BCP 14, RFC 2119, March 1997. 4196 [RFC2578] McCloghrie, K., Perkins, D., and J. Schoenwaelder, 4197 "Structure of Management Information Version 2 (SMIv2)", 4198 STD 58, RFC 2578, April 1999. 4200 [RFC2579] McCloghrie, K., Perkins, D., and J. Schoenwaelder, 4201 "Textual Conventions for SMIv2", STD 58, RFC 2579, April 4202 1999. 4204 [RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder, 4205 "Conformance Statements for SMIv2", STD 58, RFC 2580, 4206 April 1999. 4208 [RFC3411] Harrington, D., Presuhn, R., and B. Wijnen, "An 4209 Architecture for Describing Simple Network Management 4210 Protocol (SNMP) Management Frameworks", STD 62, RFC 3411, 4211 December 2002. 4213 [RFC3414] Blumenthal, U., and B. Wijnen, 4214 "User-based Security Model (USM) for version 3 of the 4215 Simple Network Management Protocol (SNMPv3)", RFC 3414, 4216 December 2002. 4218 [RFC3720] Satran, J., Meth, K., Sapuntzakis, C., Chadalapaka, M., 4219 and E. Zeidner, "Internet Small Computer Systems 4220 Interface (iSCSI)", RFC 3720, March 2004. 4222 [RFC3826] Blumenthal, U., Maino, F., and K. McCloghrie, 4223 "The Advanced Encryption Standard (AES) Cipher 4224 Algorithm in the SNMP User-based Security Model", 4225 RFC 3826, June 2004. 4227 [RFC4001] Daniele, M., Haberman, B., Routhier, S., and J. 4228 Schoenwaelder, "Textual Conventions for Internet Network 4229 Addresses", RFC 4001, February 2005. 4231 [RFC4545] Bakke, M. and J. Muchow, "Definitions of Managed Objects 4232 for IP Storage User Identity Authorization", RFC 4545, 4233 May 2006. 4235 [RFC5591] Harrington, D., and W. Hardaker, 4236 "Transport Security Model for the Simple Network 4237 Management Protocol (SNMP)", June 2009. 4239 [RFC5592] Harrington, D., Saloway, J., and W. Hardaker, 4240 "Secure Shell Transport Model for the Simple Network 4241 Management Protocol (SNMP)", June 2009. 4243 [RFC6353] W. Hardaker, "Transport Layer Security (TLS) Transport 4244 Model for the Simple Network Management Protocol (SNMP)", 4245 July 2011. 4247 [RFCcccc] Chadalapaka, M., Satran, J., and K. Meth, "iSCSI 4248 Protocol (Consolidated)", RFC cccc, mmyy. 4250 -- RFC Editor:replace cccc with the RFC number assigned to 4251 -- draft-ietf-storm-iscsi-cons-08 & remove this note. 4252 -- RFC Editor:replace mmyy with the RFC month and year assigned to 4253 -- draft-ietf-storm-iscsi-cons-08 & remove this note. 4255 [RFCssss] Knight, F., Chadalapaka, M., "Internet Small 4256 Computer Systems Interface (iSCSI) Update", RFC ssss, 4257 mmyy. 4258 -- RFC Editor: replace ssss with the RFC number assigned to 4259 -- draft-ietf-storm-iscsi-sam-06 & remove this note. 4260 -- RFC Editor: replace mmyy with the RFC month and year assigned to 4261 -- draft-ietf-storm-iscsi-sam-06 & remove this note. 4263 10.2. Informative References 4265 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, 4266 "Introduction and Applicability Statements for Internet- 4267 Standard Management Framework", RFC 3410, December 2002. 4269 [RFC4022] Raghunarayan, R., "Management Information Base for the 4270 Transmission Control Protocol (TCP)", RFC 4022, March 4271 2005. 4273 [RFC4455] Hallak-Stamler, M., Bakke, M., Lederman, Y., Krueger, M., 4274 and K. McCloghrie, "Definition of Managed Objects for 4275 Small Computer System Interface (SCSI) Entities", RFC 4276 4455, April 2006. 4278 [RFC4544] Bakke, M., J. Muchow, M. Krueger and T. McSweeney, 4279 "Definitions of Managed Objects for iSCSI", RFC 4544, 4280 May 2006. 4282 11. Acknowledgments 4284 In addition to the authors, several people contributed to the 4285 development of this MIB module. Thanks especially to those who took 4286 the time to participate in our weekly conference calls to build our 4287 requirements, object models, table structures, and attributes: John 4288 Hufferd, Tom McSweeney (IBM), Kevin Gibbons (Nishan Systems), Chad 4289 Gregory (Intel), Jack Harwood (EMC), Hari Mudaliar (Adaptec), Ie Wei 4290 Njoo (Agilent), Lawrence Lamers (SAN Valley), Satish Mali (Stonefly 4291 Networks), and William Terrell (Troika). 4293 Special thanks to Tom McSweeney, Ie Wei Njoo, and Kevin Gibbons, who 4294 wrote the descriptions for many of the tables and attributes in this 4295 MIB module, to Ayman Ghanem for finding and suggesting changes for 4296 many problems in this module, and to Keith McCloghrie for serving as 4297 advisor to the team. 4299 Thanks to Mike MacFaden (VMWare), David Black (EMC) and Tom Talpey 4300 (Microsoft) for their valuable inputs. 4302 Authors' Address 4304 Mark Bakke 4305 Dell 4306 7625 Smetana Lane 4307 Eden Prairie, MN 4308 USA 55344 4310 E-mail: mark_bakke@dell.com 4312 Prakash Venkatesen 4313 HCL Technologies Ltd. 4314 50-53, Greams Road, 4315 Chennai - 600006 4316 India 4318 E-mail: prakashvn@hcl.com 4320 Authors of RFC 4544: 4322 Mark Bakke 4323 Dell 4324 7625 Smetana Lane 4325 Eden Prairie, MN 4326 USA 55344 4328 E-mail: mark_bakke@dell.com 4330 Marjorie Krueger 4331 Hewlett-Packard 4332 Networked Storage Architecture 4333 Networked Storage Solutions Org. 4334 8000 Foothills Blvd. 4335 Roseville, CA 4336 USA 95747 4338 E-mail: marjorie_krueger@hp.com 4340 Tom McSweeney 4341 IBM Corporation 4342 600 Park Offices Drive 4343 Research Triangle Park, NC 4344 USA 27709 4346 E-mail: tommcs@us.ibm.com 4348 James Muchow 4349 Qlogic Corp. 4350 6321 Bury Drive 4351 Eden Prairie, MN 4352 USA 55346 4354 E-mail: james.muchow@qlogic.com