idnits 2.17.1 draft-ietf-storm-iscsimib-02.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 (July 13, 2012) is 4277 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-05 -- 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: January 2013 HCL Technologies 5 Obsoletes: 4544 July 13, 2012 7 Definitions of Managed Objects for Internet Small Computer System 8 Interface (iSCSI) 9 draft-ietf-storm-iscsimib-02.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 January 13, 2013. 34 Copyright Notice 36 Copyright (c) 2012 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....................................5 79 6.2. iSCSI MIB Table Structure.................................6 80 6.3. iscsiInstance.............................................7 81 6.4. iscsiPortal...............................................8 82 6.5. iscsiTargetPortal.........................................9 83 6.6. iscsiInitiatorPortal......................................9 84 6.7. iscsiNode................................................10 85 6.8. iscsiTarget..............................................11 86 6.9. iscsiTgtAuthorization....................................11 87 6.10. iscsiInitiator..........................................11 88 6.11. iscsiIntrAuthorization..................................11 89 6.12. iscsiSession............................................11 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.......................................82 96 9. IANA Considerations...........................................83 97 10. References...................................................84 98 10.1. Normative References....................................84 99 10.2. Informative References..................................85 100 11. Acknowledgments..............................................85 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-03 & 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 . Changed the conformance statements to match the above 199 . Fixed the errata to [RFC4544] 201 6. Discussion 203 This MIB module structure supplies configuration, fault, and 204 statistics information for iSCSI devices [RFCcccc]. It is structured 205 around the well-known iSCSI objects, such as targets, initiators, 206 sessions, connections, and the like. 208 This MIB module may also be used to configure access to iSCSI 209 targets, by creating iSCSI Portals and authorization list entries. 211 It is worthwhile to note that this is an iSCSI MIB module and as such 212 reflects only iSCSI objects. This module does not contain 213 information about the SCSI-layer attributes of a device. If a SCSI 214 layer is present, the SCSI MIB module [RFC4455] 215 may be used to manage SCSI information for a device. 217 The iSCSI MIB module consists of several "objects", each of which is 218 represented by one or more tables. This section contains a brief 219 description of the "object" hierarchy and a description of each 220 object, followed by a discussion of the actual table structure within 221 the objects. 223 6.1. iSCSI MIB Object Model 225 The top-level object in this structure is the iSCSI instance, which 226 "contains" all of the other objects. 228 iscsiInstance 229 -- A distinct iSCSI entity within the managed system. 230 iscsiPortal 231 -- An IP address used by this instance 232 iscsiTargetPortal 233 -- Contains portal information relevant when the portal 234 -- is used to listen for connections to its targets. 235 iscsiInitiatorPortal 236 -- Contains portal information relevant when the portal 237 -- is used to initiate connections to other targets. 238 iscsiNode 239 -- An iSCSI node can act as an initiator, a target, or both. 240 -- Contains generic (non-role-specific) information. 241 iscsiTarget 242 -- Target-specific iSCSI node information. 243 iscsiTgtAuth 244 -- A list of initiator identities that are allowed 245 -- access to this target. 246 iscsiInitiator 247 -- Initiator-specific iSCSI node information. 248 iscsiIntrAuth 249 -- A list of target identities to which this initiator 250 -- is configured to establish sessions. 251 iscsiSession 252 -- An active iSCSI session between an initiator and target. 253 -- The session's direction may be Inbound (outside 254 -- initiator to our target) or Outbound (our initiator to 255 -- an outside target). 256 iscsiConnection 257 -- An active TCP connection within an iSCSI session. 259 An iSCSI node can be an initiator, a target, or both. The iSCSI 260 node's portals may be used to initiate connections (initiator) or 261 listen for connections (target), depending on whether the iSCSI node 262 is acting as an initiator or target. The iSCSI MIB module assumes 263 that any target may be accessed via any portal that can take on a 264 target role, although other access controls not reflected in the 265 module might limit this. 267 6.2. iSCSI MIB Table Structure 269 Each iSCSI object exports one or more tables: an attributes table, 270 and zero or more statistics tables, which augment the attributes 271 table. Since iSCSI is an evolving standard, it is much cleaner to 272 provide statistics and attributes as separate tables, allowing 273 attributes and statistics to be added independently. In a few cases, 274 there are multiple categories of statistics that will likely grow; in 275 this case, an object will contain multiple statistics tables. 277 iscsiObjects 278 iscsiDescriptors 279 iscsiInstance 280 iscsiInstanceAttributesTable 281 iscsiInstanceSsnErrorStatsTable 282 -- Counts abnormal session terminations 284 iscsiPortal 285 iscsiPortalAttributesTable 286 iscsiTargetPortal 287 iscsiTgtPortalAttributesTable 288 iscsiInitiatorPortal 289 iscsiIntrPortalAttributesTable 290 iscsiNode 291 iscsiNodeAttributesTable 292 iscsiTarget 293 iscsiTargetAttributesTable 294 iscsiTargetLoginStatsTable 295 -- Counts successful and unsuccessful logins 296 iscsiTargetLogoutStatsTable 297 -- Counts normal and abnormal logouts 298 iscsiTgtAuthorization 299 iscsiTgtAuthAttributesTable 300 iscsiInitiator 301 iscsiInitiatorAttributesTable 302 iscsiInitiatorLoginStatsTable 303 -- Counts successful and unsuccessful logins 304 iscsiInitiatorLogoutStatsTable 305 -- Counts normal and abnormal logouts 306 iscsiIntrAuthorization 307 iscsiIntrAuthAttributesTable 308 iscsiSession 309 iscsiSessionAttributesTable 310 iscsiSessionStatsTable 311 -- Performance-related counts (requests, responses, bytes) 312 iscsiSessionCxnErrorStatsTable 313 -- Counts digest errors, connection errors, etc. 314 iscsiConnection 315 iscsiConnectionAttributesTable 317 Note that this module does not attempt to count everything that could 318 be counted; it is designed to include only those counters that would 319 be useful for identifying performance, security, and fault problems 320 from a management station. 322 6.3. iscsiInstance 324 The iscsiInstanceAttributesTable is the primary table of the iSCSI 325 MIB module. Every table entry in this module is "owned" by exactly 326 one iSCSI instance; all other table entries in the module include 327 this table's index as their primary index. 329 Most implementations will include just one iSCSI instance row in this 330 table. However, this table exists to allow for multiple virtual 331 instances. For example, many IP routing products now allow multiple 332 virtual routers. The iSCSI MIB module has the same premise; a large 333 system could be "partitioned" into multiple, distinct virtual 334 systems. 336 This also allows a single SNMP agent to proxy for multiple 337 subsystems, perhaps a set of stackable devices, each of which has one 338 or even more instances. 340 The instance attributes include the iSCSI vendor and version, as well 341 as information on the last target or initiator at the other end of a 342 session that caused a session failure. 344 The iscsiInstanceSsnErrorStatsTable augments the attributes table and 345 provides statistics on session failures due to digest, connection, or 346 iSCSI format errors. 348 6.4. iscsiPortal 350 The iscsiPortalAttributesTable lists iSCSI portals that can be used 351 to listen for connections to targets, to initiate connections to 352 other targets, or to do both. 354 Each row in the table includes an IP address (either v4 or v6), and a 355 transport protocol (currently only TCP is defined). Each portal may 356 have additional attributes, depending on whether it is an initiator 357 portal, a target portal, or both. Initiator portals also have portal 358 tags; these are placed in corresponding rows in the 359 iscsiIntrPortalAttributesTable. Target portals have both portal tags 360 and ports (e.g., TCP listen ports if the transport protocol is TCP); 361 these are placed in rows in the iscsiTgtPortalAttributesTable. 363 Portal rows, along with their initiator and target portal 364 counterparts, may be created and destroyed through this MIB module by 365 a management station. Rows in the initiator and target portal tables 366 are created and destroyed automatically by the agent, whenever a row 367 is created or destroyed in the iscsiPortalAttributesTable, or if the 368 value of iscsiPortalRoles changes. Attributes in these tables may 369 then be modified by the management station if the agent 370 implementation allows. 372 When created by a management station, the iscsiPortalRoles attribute 373 is used to control row creation in the initiator and target portal 374 tables. Creating a row with the targetTypePortal bit set in 375 iscsiPortalRoles will cause the implementation to start listening for 376 iSCSI connections on the portal. Creating a row with the 377 initiatorTypePortal bit set in iscsiPortalRoles will not necessarily 378 cause connections to be established; it is left to the implementation 379 whether and when to make use of the portal. Both bits may be set if 380 the portal is to be used by both initiator and target nodes. 382 When deleting a row in the iscsiPortalAttibutesTable, all connections 383 associated with that row are terminated. The implementation may 384 either terminate the connection immediately or request a clean 385 shutdown as specified in [RFCcccc]. An outbound connection (when an 386 iscsiInitiatorPortal is deleted) matches the portal if its 387 iscsiCxnLocalAddr matches the iscsiPortalAddr. An inbound connection 388 (when an iscsiTargetPortal is deleted) matches the portal if its 389 iscsiCxnLocalAddr matches the iscsiPortalAddr, and its 390 iscsiCxnLocalPort matches the iscsiTargetPortalPort. 392 Individual objects within a row in this table may not be modified 393 while the row is active. For instance, changing the IP address of a 394 portal requires that the rows associated with the old IP address be 395 deleted, and new rows be created (in either order). 397 6.5. iscsiTargetPortal 399 The iscsiTgtPortalAttributesTable contains target-specific attributes 400 for iSCSI portals. Rows in this table use the same indices as their 401 corresponding rows in the iscsiPortalAttributesTable, with the 402 addition of iscsiNodeIndex. 404 Rows in this table are created when the targetTypePortal bit is set 405 in the iscsiPortalRoles attribute of the corresponding 406 iscsiPortalAttributesEntry; they are destroyed when this bit is 407 cleared. 409 This table contains the TCP (or other protocol) port on which the 410 socket is listening for incoming connections. It also includes a 411 portal group aggregation tag; iSCSI target portals within this 412 instance sharing the same tag can contain connections within the same 413 session. 415 This table will be empty for iSCSI instances that contain only 416 initiators (such as iSCSI host driver implementations). 418 Many implementations use the same target portal tag and protocol port 419 for all nodes accessed via a portal. These implementations will 420 create a single row in the iscsiTgtPortalAttributeTable, with an 421 iscsiNodeIndex of zero. 423 Other implementations do not use the same tag and/or port for all 424 nodes; these implementations will create a row in this table for each 425 (portal, node) tuple, using iscsiNodeIndex to designate the node for 426 this portal tag and port. 428 6.6. iscsiInitiatorPortal 430 The iscsiIntrPortalAttributesTable contains initiator-specific 431 objects for iSCSI portals. Rows in this table use the same indices 432 as their corresponding entries in the iscsiPortalAttributesTable. A 433 row in this table is created when the initiatorTypePortal bit is set 434 in the iscsiPortalRoles attribute; it is destroyed when this bit is 435 cleared. 437 Each row in this table contains a portal group aggregation tag, 438 indicating which portals an initiator may use together within a 439 multiple-connection session. 441 This table will be empty for iSCSI instances that contain only 442 targets (such as most iSCSI devices). 444 Many implementations use the same initiator tag for all nodes 445 accessing targets via a given portal. These implementations will 446 create a single row in iscsiIntrPortalAttributeTable, with an 447 iscsiNodeIndex of zero. 449 Other implementations do not use the same tag and/or port for all 450 nodes; these implementations will create a row in this table for each 451 (portal, node) tuple, using iscsiNodeIndex to designate the node for 452 this portal tag and port. 454 6.7. iscsiNode 456 The iscsiNodeAttributesTable contains a list of iSCSI nodes, each of 457 which may have an initiator role, a target role, or both. 459 This table contains the node's attributes that are common to both 460 roles, such as its iSCSI name and alias string. Attributes specific 461 to initiators or targets are available in the iscsiTarget and 462 iscsiInitiator objects. Each row in this table that can fulfill a 463 target role has a corresponding row in the iscsiTarget table; each 464 entry that fulfills an initiator role has a row in the iscsiInitiator 465 table. Nodes such as copy managers that can take on both roles have 466 a corresponding row in each table. 468 This table also contains the login negotiations preferences for this 469 node. These objects indicate the values this node will offer or 470 prefer in the operational negotiation phase of the login process. 472 For most implementations, each entry in the table also contains a 473 RowPointer to the transport table entry in the SCSI MIB module that 474 this iSCSI node represents. For implementations without a standard 475 SCSI layer above iSCSI, such as an iSCSI proxy or gateway, this 476 RowPointer can point to a row in an implementation-specific table 477 that this iSCSI node represents. 479 6.8. iscsiTarget 481 The iscsiTargetAttributesTable contains target-specific attributes 482 for iSCSI nodes. Each entry in this table uses the same index values 483 as its corresponding iscsiNode entry. 485 This table contains attributes used to indicate the last failure that 486 was (or should have been) sent as a notification. 488 This table is augmented by the iscsiTargetLoginStatsTable and the 489 iscsiTargetLogoutStatsTable, which count the numbers of normal and 490 abnormal logins and logouts to this target. 492 6.9. iscsiTgtAuthorization 494 The iscsiTgtAuthAttributesTable contains an entry for each initiator 495 identifier that will be allowed to access the target under which it 496 appears. Each entry contains a RowPointer to a user identity in the 497 IPS Authorization MIB module, which contains the name, address, and 498 credential information necessary to authenticate the initiator. 500 6.10. iscsiInitiator 502 The iscsiInitiatorAttributesTable contains a list of initiator- 503 specific attributes for iSCSI nodes. Each entry in this table uses 504 the same index values as its corresponding iscsiNode entry. 506 Most implementations will include a single entry in this table, 507 regardless of the number of physical interfaces the initiator may 508 use. 510 This table is augmented by the iscsiInitiatorLoginStatsTable and the 511 iscsiInitiatorLogoutStatsTable, which count the numbers of normal and 512 abnormal logins and logouts from this initiator. 514 6.11. iscsiIntrAuthorization 516 The iscsiIntrAuthAttributesTable contains an entry for each target 517 identifier to which the initiator is configured to establish a 518 session. 520 Each entry contains a RowPointer to a user identity in the IPS 521 Authorization MIB module, which contains the name, address, and 522 credential information necessary to identify (for discovery purposes) 523 and authenticate the target. 525 6.12. iscsiSession 527 The iscsiSessionAttributesTable contains a set of rows that list the 528 sessions known to be existing locally for each node in each iSCSI 529 instance. 531 The session type for each session indicates whether the session is 532 used for normal SCSI commands or for discovery using the SendTargets 533 text command. Discovery sessions that do not belong to any 534 particular node have a node index attribute of zero. 536 The session direction for each session indicates whether it is an 537 Inbound session or an Outbound session. Inbound sessions are from 538 some other initiator to the target node under which the session 539 appears. Outbound sessions are from the initiator node under which 540 the session appears to a target outside this iSCSI instance. 542 Many attributes may be negotiated when starting an iSCSI session. 543 Most of these attributes are included in the session object. 545 Some attributes, such as the integrity and authentication schemes, 546 have some standard values that can be extended by vendors to include 547 their own schemes. These contain an object identifier, rather than 548 the expected enumerated type, to allow these values to be extended by 549 other MIB modules, such as an enterprise MIB module. 551 The iscsiSessionStatsTable includes statistics related to 552 performance; it counts iSCSI data bytes and PDUs. 554 For implementations that support error recovery without terminating a 555 session, the iscsiSessionCxnErrorStatsTable contains counters for the 556 numbers of digest and connection errors that have occurred within the 557 session. 559 6.13. iscsiConnection 561 The iscsiConnectionAttributesTable contains a list of active 562 connections within each session. It contains the IP addresses and 563 TCP (or other protocol) ports of both the local and remote sides of 564 the connection. These may be used to locate other connection-related 565 information and statistics in the TCP MIB module [RFC4022]. 567 The attributes table also contains a connection state. This state is 568 not meant to directly map to the state tables included within the 569 iSCSI specification; they are meant to be simplified, higher-level 570 definitions of connection state that provide information more useful 571 to a user or network manager. 573 No statistics are kept for connections. 575 6.14. IP Addresses and TCP Port Numbers 577 The IP addresses in this module are represented by two attributes, 578 one of type InetAddressType, and the other of type InetAddress. 579 These are taken from [RFC4001], which specifies how to support 580 addresses that may be either IPv4 or IPv6. 582 The TCP port numbers that appear in a few of the structures are 583 described as simply port numbers, with a protocol attribute 584 indicating whether they are TCP ports or something else. This will 585 allow the module to be compatible with iSCSI over transports other 586 than TCP in the future. 588 6.15. Descriptors: Using OIDs in Place of Enumerated Types 590 The iSCSI MIB module has a few attributes, namely, the digest method 591 attributes, where an enumerated type would work well, except that an 592 implementation may need to extend the attribute and add types of its 593 own. To make this work, this MIB module defines a set of object 594 identities within the iscsiDescriptors subtree. Each of these object 595 identities is basically an enumerated type. 597 Attributes that make use of these object identities have a value that 598 is an Object Identifier (OID) instead of an enumerated type. These 599 OIDs can indicate either the object identities defined in this module 600 or object identities defined elsewhere, such as in an enterprise MIB 601 module. Those implementations that add their own digest methods 602 should also define a corresponding object identity for each of these 603 methods within their own enterprise MIB module, and return its OID 604 whenever one of these attributes is using that method. 606 6.16. Notifications 608 Three notifications are provided. One is sent by an initiator 609 detecting a critical login failure, another is sent by a target 610 detecting a critical login failure, and the third is sent upon a 611 session being terminated due to an abnormal connection or digest 612 failure. Critical failures are defined as those that may expose 613 security-related problems that may require immediate action, such as 614 failures due to authentication, authorization, or negotiation 615 problems. Attributes in the initiator, target, and instance objects 616 provide the information necessary to send in the notification, such 617 as the initiator or target name and IP address at the other end that 618 may have caused the failure. 620 To avoid sending an excessive number of notifications due to multiple 621 errors counted, an SNMP agent implementing the iSCSI MIB module 622 SHOULD NOT send more than three iSCSI notifications in any 10-second 623 period. 625 The 3-in-10 rule was chosen because one notification every three 626 seconds was deemed often enough, but should two or three different 627 notifications happen at the same time, it would not be desirable to 628 suppress them. Three notifications in 10 seconds is a happy medium, 629 where a short burst of notifications is allowed, without inundating 630 the network and/or notification host with a large number of 631 notifications. 633 7. MIB Definition 635 ISCSI-MIB DEFINITIONS ::= BEGIN 637 IMPORTS 638 MODULE-IDENTITY, OBJECT-TYPE, OBJECT-IDENTITY, NOTIFICATION-TYPE, 639 Unsigned32, Counter32, Counter64, Gauge32, 640 mib-2 641 FROM SNMPv2-SMI 643 TEXTUAL-CONVENTION, TruthValue, RowPointer, TimeStamp, RowStatus, 644 AutonomousType, StorageType 645 FROM SNMPv2-TC 647 MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP 648 FROM SNMPv2-CONF 650 SnmpAdminString 651 FROM SNMP-FRAMEWORK-MIB -- RFC 3411 653 InetAddressType, InetAddress, InetPortNumber 654 FROM INET-ADDRESS-MIB -- RFC 4001 655 ; 657 iscsiMibModule MODULE-IDENTITY 658 LAST-UPDATED "201207100000Z" -- July 10, 2012 659 ORGANIZATION "IETF STORage Maintenance (STORM) Working Group" 660 CONTACT-INFO " 661 Working Group Email : storm@ietf.org 662 Attn: Mark Bakke 663 Cisco Systems, Inc 664 Email: mbakke@cisco.com 666 Prakash Venkatesen 667 HCL Technologies 668 Email: prakashvn@hcl.com" 670 DESCRIPTION 671 "This module defines management information specific 672 to the iSCSI protocol. 674 Copyright (c) 2011 IETF Trust and the persons identified as 675 authors of the code. All rights reserved. 677 Redistribution and use in source and binary forms, with or 678 without modification, is permitted pursuant to, and subject 679 to the license terms contained in, the Simplified BSD 680 License set forth in Section 4.c of the IETF Trust's Legal 681 Provisions Relating to IETF Documents 682 (http://trustee.ietf.org/license-info)." 683 REVISION "201207100000Z" 684 DESCRIPTION 685 "Second version of the iSCSI Protocol MIB Module. 686 [RFCcccc] makes several updates to [RFC3720]. This 687 version makes corresponding updates to the MIB module. 688 This MIB module published as RFC xxxx." 689 -- RFC Editor: replace xxxx with actual RFC number & remove this note. 690 REVISION "200605220000Z" 691 DESCRIPTION 692 "Initial version of the iSCSI Protocol MIB module. 693 This MIB module published as RFC 4544." 695 ::= { mib-2 142 } 697 iscsiNotifications OBJECT IDENTIFIER ::= { iscsiMibModule 0 } 698 iscsiObjects OBJECT IDENTIFIER ::= { iscsiMibModule 1 } 699 iscsiConformance OBJECT IDENTIFIER ::= { iscsiMibModule 2 } 700 iscsiAdmin OBJECT IDENTIFIER ::= { iscsiMibModule 3 } 702 -- RFC Editor:replace cccc in RFC cccc at all the places in which it is 703 -- used in this document, with the RFC number assigned to 704 -- draft-ietf-storm-iscsi-cons-03 & remove this note. 706 -- Textual Conventions 708 IscsiTransportProtocol ::= TEXTUAL-CONVENTION 709 DISPLAY-HINT "d" 710 STATUS current 711 DESCRIPTION 712 "This data type is used to define the transport 713 protocols that will carry iSCSI PDUs. 714 Protocol numbers are assigned by IANA. A 715 current list of all assignments is available from 716 ." 718 SYNTAX Unsigned32 (0..255) 720 IscsiDigestMethod ::= TEXTUAL-CONVENTION 721 STATUS current 722 DESCRIPTION 723 "This data type represents the methods possible 724 for digest negotiation. 725 none - a placeholder for a secondary digest method 726 that means only the primary method can be 727 used. 728 other - a digest method other than those defined below. 729 noDigest - does not support digests (will operate without 730 a digest (Note: implementations must support 731 digests to be compliant with the RFCcccc). 732 CRC32c - require a CRC32C digest." 733 REFERENCE 734 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 736 SYNTAX INTEGER { 737 none(1), 738 other(2), 739 noDigest(3), 740 crc32c(4) 741 } 743 IscsiName ::= TEXTUAL-CONVENTION 744 DISPLAY-HINT "223t" 745 STATUS current 746 DESCRIPTION 747 "This data type is used for objects whose value is an 748 iSCSI name with the properties described in RFC cccc 749 section 4.2.7.1, and encoded as specified in RFC cccc 750 section 4.2.7.2. A zero-length string indicates the 751 absence of an iSCSI name." 752 REFERENCE 753 "RFC cccc, Section 4.2.7, iSCSI Names." 754 SYNTAX OCTET STRING (SIZE(0 | 16..223)) 756 --********************************************************************** 758 iscsiDescriptors OBJECT IDENTIFIER ::= { iscsiAdmin 1 } 760 iscsiHeaderIntegrityTypes OBJECT IDENTIFIER ::= { iscsiDescriptors 1 } 762 iscsiHdrIntegrityNone OBJECT-IDENTITY 763 STATUS current 764 DESCRIPTION 765 "The authoritative identifier when no integrity 766 scheme for the header is being used." 767 REFERENCE 768 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 769 ::= { iscsiHeaderIntegrityTypes 1 } 770 iscsiHdrIntegrityCrc32c OBJECT-IDENTITY 771 STATUS current 772 DESCRIPTION 773 "The authoritative identifier when the integrity 774 scheme for the header is CRC32c." 775 REFERENCE 776 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 777 ::= { iscsiHeaderIntegrityTypes 2 } 779 iscsiDataIntegrityTypes OBJECT IDENTIFIER ::= { iscsiDescriptors 2 } 781 iscsiDataIntegrityNone OBJECT-IDENTITY 782 STATUS current 783 DESCRIPTION 784 "The authoritative identifier when no integrity 785 scheme for the data is being used." 786 REFERENCE 787 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 788 ::= { iscsiDataIntegrityTypes 1 } 790 iscsiDataIntegrityCrc32c OBJECT-IDENTITY 791 STATUS current 792 DESCRIPTION 793 "The authoritative identifier when the integrity 794 scheme for the data is CRC32c." 795 REFERENCE 796 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 797 ::= { iscsiDataIntegrityTypes 2 } 799 --********************************************************************** 801 iscsiInstance OBJECT IDENTIFIER ::= { iscsiObjects 1 } 803 -- Instance Attributes Table 805 iscsiInstanceAttributesTable OBJECT-TYPE 806 SYNTAX SEQUENCE OF IscsiInstanceAttributesEntry 807 MAX-ACCESS not-accessible 808 STATUS current 809 DESCRIPTION 810 "A list of iSCSI instances present on the system." 811 ::= { iscsiInstance 1 } 813 iscsiInstanceAttributesEntry OBJECT-TYPE 814 SYNTAX IscsiInstanceAttributesEntry 815 MAX-ACCESS not-accessible 816 STATUS current 817 DESCRIPTION 818 "An entry (row) containing management information applicable 819 to a particular iSCSI instance." 820 INDEX { iscsiInstIndex } 821 ::= { iscsiInstanceAttributesTable 1 } 823 IscsiInstanceAttributesEntry ::= SEQUENCE { 824 iscsiInstIndex Unsigned32, 825 iscsiInstDescr SnmpAdminString, 826 iscsiInstVersionMin Unsigned32, 827 iscsiInstVersionMax Unsigned32, 828 iscsiInstVendorID SnmpAdminString, 829 iscsiInstVendorVersion SnmpAdminString, 830 iscsiInstPortalNumber Unsigned32, 831 iscsiInstNodeNumber Unsigned32, 832 iscsiInstSessionNumber Unsigned32, 833 iscsiInstSsnFailures Counter32, 834 iscsiInstLastSsnFailureType AutonomousType, 835 iscsiInstLastSsnRmtNodeName IscsiName, 836 iscsiInstDiscontinuityTime TimeStamp, 837 iscsiInstXNodeArchitecture SnmpAdminString 838 } 840 iscsiInstIndex OBJECT-TYPE 841 SYNTAX Unsigned32 (1..4294967295) 842 MAX-ACCESS not-accessible 843 STATUS current 844 DESCRIPTION 845 "An arbitrary integer used to uniquely identify a particular 846 iSCSI instance. This index value must not be modified or 847 reused by an agent unless a reboot has occurred. An agent 848 should attempt to keep this value persistent across reboots." 849 ::= { iscsiInstanceAttributesEntry 1 } 851 iscsiInstDescr OBJECT-TYPE 852 SYNTAX SnmpAdminString 853 MAX-ACCESS read-only 854 STATUS current 855 DESCRIPTION 856 "A UTF-8 string, determined by the implementation to 857 describe the iSCSI instance. When only a single instance 858 is present, this object may be set to the zero-length 859 string; with multiple iSCSI instances, it may be used in 860 an implementation-dependent manner to describe the purpose 861 of the respective instance." 863 ::= { iscsiInstanceAttributesEntry 2 } 865 iscsiInstVersionMin OBJECT-TYPE 866 SYNTAX Unsigned32 (0..255) 867 MAX-ACCESS read-only 868 STATUS current 869 DESCRIPTION 870 "The minimum version number of the iSCSI specification 871 such that this iSCSI instance supports this minimum 872 value, the maximum value indicated by the corresponding 873 instance in iscsiInstVersionMax, and all versions in 874 between." 875 REFERENCE 876 "RFC cccc, Section 11.12, Login Request" 877 ::= { iscsiInstanceAttributesEntry 3 } 879 iscsiInstVersionMax OBJECT-TYPE 880 SYNTAX Unsigned32 (0..255) 881 MAX-ACCESS read-only 882 STATUS current 883 DESCRIPTION 884 "The maximum version number of the iSCSI specification 885 such that this iSCSI instance supports this maximum 886 value, the minimum value indicated by the corresponding 887 instance in iscsiInstVersionMin, and all versions in 888 between." 889 REFERENCE 890 "RFC cccc, Section 11.12, Login Request" 891 ::= { iscsiInstanceAttributesEntry 4 } 893 iscsiInstVendorID OBJECT-TYPE 894 SYNTAX SnmpAdminString 895 MAX-ACCESS read-only 896 STATUS current 897 DESCRIPTION 898 "A UTF-8 string describing the manufacturer of the 899 implementation of this instance." 900 ::= { iscsiInstanceAttributesEntry 5 } 902 iscsiInstVendorVersion OBJECT-TYPE 903 SYNTAX SnmpAdminString 904 MAX-ACCESS read-only 905 STATUS current 906 DESCRIPTION 907 "A UTF-8 string set by the manufacturer describing the 908 version of the implementation of this instance. The 909 format of this string is determined solely by the 910 manufacturer, and is for informational purposes only. 911 It is unrelated to the iSCSI specification version numbers." 912 ::= { iscsiInstanceAttributesEntry 6 } 914 iscsiInstPortalNumber OBJECT-TYPE 915 SYNTAX Unsigned32 916 UNITS "transport endpoints" 917 MAX-ACCESS read-only 918 STATUS current 919 DESCRIPTION 920 "The number of rows in the iscsiPortalAttributesTable 921 that are currently associated with this iSCSI instance." 922 ::= { iscsiInstanceAttributesEntry 7 } 924 iscsiInstNodeNumber OBJECT-TYPE 925 SYNTAX Unsigned32 926 UNITS "iSCSI nodes" 927 MAX-ACCESS read-only 928 STATUS current 929 DESCRIPTION 930 "The number of rows in the iscsiNodeAttributesTable 931 that are currently associated with this iSCSI instance." 932 ::= { iscsiInstanceAttributesEntry 8 } 934 iscsiInstSessionNumber OBJECT-TYPE 935 SYNTAX Unsigned32 936 UNITS "sessions" 937 MAX-ACCESS read-only 938 STATUS current 939 DESCRIPTION 940 "The number of rows in the iscsiSessionAttributesTable 941 that are currently associated with this iSCSI instance." 942 ::= { iscsiInstanceAttributesEntry 9 } 944 iscsiInstSsnFailures OBJECT-TYPE 945 SYNTAX Counter32 946 UNITS "sessions" 947 MAX-ACCESS read-only 948 STATUS current 949 DESCRIPTION 950 "This object counts the number of times a session belonging 951 to this instance has failed. If this counter has 952 suffered a discontinuity, the time of the last discontinuity 953 is indicated in iscsiInstDiscontinuityTime." 954 REFERENCE 955 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 956 ::= { iscsiInstanceAttributesEntry 10 } 958 iscsiInstLastSsnFailureType OBJECT-TYPE 959 SYNTAX AutonomousType 960 MAX-ACCESS read-only 961 STATUS current 962 DESCRIPTION 963 "The counter object in the iscsiInstanceSsnErrorStatsTable 964 that was incremented when the last session failure occurred. 966 If the reason for failure is not found in the 967 iscsiInstanceSsnErrorStatsTable, the value { 0.0 } is 968 used instead." 969 ::= { iscsiInstanceAttributesEntry 11 } 971 iscsiInstLastSsnRmtNodeName OBJECT-TYPE 972 SYNTAX IscsiName 973 MAX-ACCESS read-only 974 STATUS current 975 DESCRIPTION 976 "The iSCSI name of the remote node from the failed 977 session." 978 ::= { iscsiInstanceAttributesEntry 12 } 980 iscsiInstDiscontinuityTime OBJECT-TYPE 981 SYNTAX TimeStamp 982 MAX-ACCESS read-only 983 STATUS current 984 DESCRIPTION 985 "The value of SysUpTime on the most recent occasion 986 at which any one or more of this instance's counters 987 suffered a discontinuity. 989 If no such discontinuities have occurred since the last 990 re-initialization of the local management subsystem, 991 then this object contains a zero value." 992 ::= { iscsiInstanceAttributesEntry 13 } 994 iscsiInstXNodeArchitecture OBJECT-TYPE 995 SYNTAX SnmpAdminString 996 MAX-ACCESS read-only 997 STATUS current 998 DESCRIPTION 999 "A UTF-8 string set by the manufacturer declaring the 1000 details of its iSCSI node architecture to the remote 1001 endpoint. These details may include, but are not limited 1002 to, iSCSI vendor software, firmware, or hardware versions, 1003 the OS version, or hardware architecture. 1004 The format of this string is determined solely by the 1005 manufacturer, and is for informational purposes only. 1006 It is unrelated to the iSCSI specification version numbers." 1007 REFERENCE 1008 "[RFCcccc], Section 13.26, X#NodeArchitecture" 1009 ::= { iscsiInstanceAttributesEntry 14 } 1011 -- Instance Session Failure Stats Table 1013 iscsiInstanceSsnErrorStatsTable OBJECT-TYPE 1014 SYNTAX SEQUENCE OF IscsiInstanceSsnErrorStatsEntry 1015 MAX-ACCESS not-accessible 1016 STATUS current 1017 DESCRIPTION 1018 "Statistics regarding the occurrences of error types 1019 that result in a session failure." 1020 ::= { iscsiInstance 2 } 1022 iscsiInstanceSsnErrorStatsEntry OBJECT-TYPE 1023 SYNTAX IscsiInstanceSsnErrorStatsEntry 1024 MAX-ACCESS not-accessible 1025 STATUS current 1026 DESCRIPTION 1027 "An entry (row) containing management information applicable 1028 to a particular iSCSI instance." 1029 AUGMENTS { iscsiInstanceAttributesEntry } 1030 ::= { iscsiInstanceSsnErrorStatsTable 1 } 1032 IscsiInstanceSsnErrorStatsEntry ::= SEQUENCE { 1033 iscsiInstSsnDigestErrors Counter32, 1034 iscsiInstSsnCxnTimeoutErrors Counter32, 1035 iscsiInstSsnFormatErrors Counter32 1036 } 1038 iscsiInstSsnDigestErrors OBJECT-TYPE 1039 SYNTAX Counter32 1040 UNITS "sessions" 1041 MAX-ACCESS read-only 1042 STATUS current 1043 DESCRIPTION 1044 "The count of sessions that failed due to receipt of 1045 a PDU containing header or data digest errors. If this 1046 counter has suffered a discontinuity, the time of the last 1047 discontinuity is indicated in iscsiInstDiscontinuityTime." 1048 REFERENCE 1049 "RFC cccc, Section 7.8, Digest Errors" 1050 ::= { iscsiInstanceSsnErrorStatsEntry 1 } 1052 iscsiInstSsnCxnTimeoutErrors OBJECT-TYPE 1053 SYNTAX Counter32 1054 UNITS "sessions" 1055 MAX-ACCESS read-only 1056 STATUS current 1057 DESCRIPTION 1058 "The count of sessions that failed due to a sequence 1059 exceeding a time limit. If this counter has suffered a 1060 discontinuity, the time of the last discontinuity 1061 is indicated in iscsiInstDiscontinuityTime." 1062 REFERENCE 1063 "RFC cccc, Section 7.5, Connection Timeout Management" 1065 ::= { iscsiInstanceSsnErrorStatsEntry 2 } 1067 iscsiInstSsnFormatErrors OBJECT-TYPE 1068 SYNTAX Counter32 1069 UNITS "sessions" 1070 MAX-ACCESS read-only 1071 STATUS current 1072 DESCRIPTION 1073 "The count of sessions that failed due to receipt of 1074 a PDU that contained a format error. If this counter has 1075 suffered a discontinuity, the time of the last discontinuity 1076 is indicated in iscsiInstDiscontinuityTime." 1077 REFERENCE 1078 "RFC cccc, Section 7.7, Format Errors" 1079 ::= { iscsiInstanceSsnErrorStatsEntry 3 } 1081 --********************************************************************** 1083 iscsiPortal OBJECT IDENTIFIER ::= { iscsiObjects 2 } 1085 -- Portal Attributes Table 1087 iscsiPortalAttributesTable OBJECT-TYPE 1088 SYNTAX SEQUENCE OF IscsiPortalAttributesEntry 1089 MAX-ACCESS not-accessible 1090 STATUS current 1091 DESCRIPTION 1092 "A list of transport endpoints (using TCP or another transport 1093 protocol) used by this iSCSI instance. An iSCSI instance may 1094 use a portal to listen for incoming connections to its targets, 1095 to initiate connections to other targets, or both." 1096 ::= { iscsiPortal 1 } 1098 iscsiPortalAttributesEntry OBJECT-TYPE 1099 SYNTAX IscsiPortalAttributesEntry 1100 MAX-ACCESS not-accessible 1101 STATUS current 1102 DESCRIPTION 1103 "An entry (row) containing management information applicable 1104 to a particular portal instance." 1105 INDEX { iscsiInstIndex, iscsiPortalIndex } 1106 ::= { iscsiPortalAttributesTable 1 } 1108 IscsiPortalAttributesEntry ::= SEQUENCE { 1109 iscsiPortalIndex Unsigned32, 1110 iscsiPortalRowStatus RowStatus, 1111 iscsiPortalRoles BITS, 1112 iscsiPortalAddrType InetAddressType, 1113 iscsiPortalAddr InetAddress, 1114 iscsiPortalProtocol IscsiTransportProtocol, 1115 iscsiPortalMaxRecvDataSegLength Unsigned32, 1116 iscsiPortalPrimaryHdrDigest IscsiDigestMethod, 1117 iscsiPortalPrimaryDataDigest IscsiDigestMethod, 1118 iscsiPortalSecondaryHdrDigest IscsiDigestMethod, 1119 iscsiPortalSecondaryDataDigest IscsiDigestMethod, 1120 iscsiPortalRecvMarker TruthValue, 1121 iscsiPortalStorageType StorageType 1122 } 1124 iscsiPortalIndex OBJECT-TYPE 1125 SYNTAX Unsigned32 (1..4294967295) 1126 MAX-ACCESS not-accessible 1127 STATUS current 1128 DESCRIPTION 1129 "An arbitrary integer used to uniquely identify a particular 1130 transport endpoint within this iSCSI instance. This index 1131 value must not be modified or reused by an agent unless a 1132 reboot has occurred. An agent should attempt to keep this 1133 value persistent across reboots." 1134 ::= { iscsiPortalAttributesEntry 1 } 1136 iscsiPortalRowStatus OBJECT-TYPE 1137 SYNTAX RowStatus 1138 MAX-ACCESS read-create 1139 STATUS current 1140 DESCRIPTION 1141 "This field allows entries to be dynamically added and 1142 removed from this table via SNMP. When adding a row to 1143 this table, all non-Index/RowStatus objects must be set. 1144 When the value of this object is 'active', the values of 1145 the other objects in this table cannot be changed. 1146 Rows may be discarded using RowStatus. 1148 Note that creating a row in this table will typically 1149 cause the agent to create one or more rows in 1150 iscsiTgtPortalAttributesTable and/or 1151 iscsiIntrPortalAttributesTable." 1152 ::= { iscsiPortalAttributesEntry 2 } 1154 iscsiPortalRoles OBJECT-TYPE 1155 SYNTAX BITS { 1156 targetTypePortal(0), 1157 initiatorTypePortal(1) 1158 } 1159 MAX-ACCESS read-create 1160 STATUS current 1161 DESCRIPTION 1162 "A portal can operate in one or both of two roles: 1164 as a target portal and/or an initiator portal. If 1165 the portal will operate in both roles, both bits 1166 must be set. 1168 This object will define a corresponding row that 1169 will exist or must be created in the 1170 iscsiTgtPortalAttributesTable, the 1171 iscsiIntrPortalAttributesTable or both. If the 1172 targetTypePortal bit is set, one or more corresponding 1173 iscsiTgtPortalAttributesEntry rows will be found or 1174 created. If the initiatorTypePortal bit is set, 1175 one or more corresponding iscsiIntrPortalAttributesEntry 1176 rows will be found or created. If both bits are set, one 1177 or more corresponding rows will be found or created in 1178 one of the above tables." 1179 ::= { iscsiPortalAttributesEntry 3 } 1181 iscsiPortalAddrType OBJECT-TYPE 1182 SYNTAX InetAddressType 1183 MAX-ACCESS read-create 1184 STATUS current 1185 DESCRIPTION 1186 "The type of Internet Network Address contained in the 1187 corresponding instance of the iscsiPortalAddr." 1188 DEFVAL { ipv4 } 1189 ::= { iscsiPortalAttributesEntry 4 } 1191 iscsiPortalAddr OBJECT-TYPE 1192 SYNTAX InetAddress 1193 MAX-ACCESS read-create 1194 STATUS current 1195 DESCRIPTION 1196 "The portal's Internet Network Address, of the type 1197 specified by the object iscsiPortalAddrType. If 1198 iscsiPortalAddrType has the value 'dns', this address 1199 gets resolved to an IP address whenever a new iSCSI 1200 connection is established using this portal." 1201 ::= { iscsiPortalAttributesEntry 5 } 1203 iscsiPortalProtocol OBJECT-TYPE 1204 SYNTAX IscsiTransportProtocol 1205 MAX-ACCESS read-create 1206 STATUS current 1207 DESCRIPTION 1208 "The portal's transport protocol." 1209 DEFVAL { 6 } -- TCP 1210 ::= { iscsiPortalAttributesEntry 6 } 1212 iscsiPortalMaxRecvDataSegLength OBJECT-TYPE 1213 SYNTAX Unsigned32 (512..16777215) 1214 UNITS "bytes" 1215 MAX-ACCESS read-create 1216 STATUS current 1217 DESCRIPTION 1218 "The maximum PDU length this portal can receive. 1219 This may be constrained by hardware characteristics 1220 and individual implementations may choose not to 1221 allow this object to be changed." 1222 REFERENCE 1223 "RFC cccc, Section 13.12, MaxRecvDataSegmentLength" 1224 DEFVAL { 8192 } 1225 ::= { iscsiPortalAttributesEntry 7 } 1227 iscsiPortalPrimaryHdrDigest OBJECT-TYPE 1228 SYNTAX IscsiDigestMethod 1229 MAX-ACCESS read-create 1230 STATUS current 1231 DESCRIPTION 1232 "The preferred header digest for this portal." 1233 DEFVAL { crc32c } 1234 ::= { iscsiPortalAttributesEntry 8 } 1236 iscsiPortalPrimaryDataDigest OBJECT-TYPE 1237 SYNTAX IscsiDigestMethod 1238 MAX-ACCESS read-create 1239 STATUS current 1240 DESCRIPTION 1241 "The preferred data digest method for this portal." 1242 DEFVAL { crc32c } 1243 ::= { iscsiPortalAttributesEntry 9 } 1245 iscsiPortalSecondaryHdrDigest OBJECT-TYPE 1246 SYNTAX IscsiDigestMethod 1247 MAX-ACCESS read-create 1248 STATUS current 1249 DESCRIPTION 1250 "An alternate header digest preference for this portal." 1251 DEFVAL { noDigest } 1252 ::= { iscsiPortalAttributesEntry 10 } 1254 iscsiPortalSecondaryDataDigest OBJECT-TYPE 1255 SYNTAX IscsiDigestMethod 1256 MAX-ACCESS read-create 1257 STATUS current 1258 DESCRIPTION 1259 "An alternate data digest preference for this portal." 1260 DEFVAL { noDigest } 1261 ::= { iscsiPortalAttributesEntry 11 } 1262 iscsiPortalRecvMarker OBJECT-TYPE 1263 SYNTAX TruthValue 1264 MAX-ACCESS read-create 1265 STATUS deprecated 1266 DESCRIPTION 1267 "This object indicates whether or not this portal will 1268 request markers in its incoming data stream." 1269 REFERENCE 1270 "[RFCcccc], 13.25 Obsoleted Keys." 1271 DEFVAL { false } 1272 ::= { iscsiPortalAttributesEntry 12 } 1274 iscsiPortalStorageType OBJECT-TYPE 1275 SYNTAX StorageType 1276 MAX-ACCESS read-create 1277 STATUS current 1278 DESCRIPTION 1279 "The storage type for this row. Rows in this table that were 1280 created through an external process (e.g. not created via 1281 this MIB) may have a storage type of readOnly or permanent. 1283 Conceptual rows having the value 'permanent' need not 1284 allow write access to any columnar objects in the row." 1285 DEFVAL { nonVolatile } 1286 ::= { iscsiPortalAttributesEntry 13 } 1288 --********************************************************************** 1289 iscsiTargetPortal OBJECT IDENTIFIER ::= { iscsiObjects 3 } 1291 -- Target Portal Attributes Table 1293 iscsiTgtPortalAttributesTable OBJECT-TYPE 1294 SYNTAX SEQUENCE OF IscsiTgtPortalAttributesEntry 1295 MAX-ACCESS not-accessible 1296 STATUS current 1297 DESCRIPTION 1298 "A list of transport endpoints (using TCP or another transport 1299 protocol) on which this iSCSI instance listens for incoming 1300 connections to its targets." 1301 ::= { iscsiTargetPortal 1 } 1303 iscsiTgtPortalAttributesEntry OBJECT-TYPE 1304 SYNTAX IscsiTgtPortalAttributesEntry 1305 MAX-ACCESS not-accessible 1306 STATUS current 1307 DESCRIPTION 1308 "An entry (row) containing management information applicable 1309 to a particular portal instance that is used to listen for 1310 incoming connections to local targets. One or more rows in 1311 this table is populated by the agent for each 1312 iscsiPortalAttributesEntry row that has the bit 1313 targetTypePortal set in its iscsiPortalRoles column." 1314 INDEX { iscsiInstIndex, iscsiPortalIndex, 1315 iscsiTgtPortalNodeIndexOrZero } 1316 ::= { iscsiTgtPortalAttributesTable 1 } 1318 IscsiTgtPortalAttributesEntry ::= SEQUENCE { 1319 iscsiTgtPortalNodeIndexOrZero Unsigned32, 1320 iscsiTgtPortalPort InetPortNumber, 1321 iscsiTgtPortalTag Unsigned32 1322 } 1324 iscsiTgtPortalNodeIndexOrZero OBJECT-TYPE 1325 SYNTAX Unsigned32 (0..4294967295) 1326 MAX-ACCESS not-accessible 1327 STATUS current 1328 DESCRIPTION 1329 "An arbitrary integer used to uniquely identify a 1330 particular node within an iSCSI instance present 1331 on the local system. 1333 For implementations where each {portal, node} tuple 1334 can have a different portal tag, this value will 1335 map to the iscsiNodeIndex. 1337 For implementations where the portal tag is the 1338 same for a given portal regardless of which node 1339 is using the portal, the value 0 (zero) is used." 1340 ::= { iscsiTgtPortalAttributesEntry 1 } 1342 iscsiTgtPortalPort OBJECT-TYPE 1343 SYNTAX InetPortNumber (1..65535) 1344 MAX-ACCESS read-write 1345 STATUS current 1346 DESCRIPTION 1347 "The portal's transport protocol port number on which the 1348 portal listens for incoming iSCSI connections when the 1349 portal is used as a target portal. This object's storage 1350 type is specified in iscsiPortalStorageType." 1351 ::= { iscsiTgtPortalAttributesEntry 2 } 1353 iscsiTgtPortalTag OBJECT-TYPE 1354 SYNTAX Unsigned32 (1..65535) 1355 MAX-ACCESS read-write 1356 STATUS current 1357 DESCRIPTION 1358 "The portal's aggregation tag when the portal is used as 1359 a target portal. Multiple-connection sessions may 1360 be aggregated over portals sharing an identical 1361 aggregation tag. This object's storage type is 1362 specified in iscsiPortalStorageType." 1363 REFERENCE 1364 "RFC cccc, Section 4.4.1, iSCSI Architectural Model" 1365 ::= { iscsiTgtPortalAttributesEntry 3 } 1367 --********************************************************************** 1369 iscsiInitiatorPortal OBJECT IDENTIFIER ::= { iscsiObjects 4 } 1371 -- Initiator Portal Attributes Table 1373 iscsiIntrPortalAttributesTable OBJECT-TYPE 1374 SYNTAX SEQUENCE OF IscsiIntrPortalAttributesEntry 1375 MAX-ACCESS not-accessible 1376 STATUS current 1377 DESCRIPTION 1378 "A list of Internet Network Addresses (using TCP or another 1379 transport protocol) from which this iSCSI instance may 1380 initiate connections to other targets." 1381 ::= { iscsiInitiatorPortal 1 } 1383 iscsiIntrPortalAttributesEntry OBJECT-TYPE 1384 SYNTAX IscsiIntrPortalAttributesEntry 1385 MAX-ACCESS not-accessible 1386 STATUS current 1387 DESCRIPTION 1388 "An entry (row) containing management information applicable 1389 to a particular portal instance that is used to initiate 1390 connections to iSCSI targets. One or more rows in 1391 this table is populated by the agent for each 1392 iscsiPortalAttributesEntry row that has the bit 1393 initiatorTypePortal set in its iscsiPortalRoles column." 1394 INDEX { iscsiInstIndex, iscsiPortalIndex, 1395 iscsiIntrPortalNodeIndexOrZero } 1396 ::= { iscsiIntrPortalAttributesTable 1 } 1398 IscsiIntrPortalAttributesEntry ::= SEQUENCE { 1399 iscsiIntrPortalNodeIndexOrZero Unsigned32, 1400 iscsiIntrPortalTag Unsigned32 1401 } 1403 iscsiIntrPortalNodeIndexOrZero OBJECT-TYPE 1404 SYNTAX Unsigned32 (0..4294967295) 1405 MAX-ACCESS not-accessible 1406 STATUS current 1407 DESCRIPTION 1408 "An arbitrary integer used to uniquely identify a 1409 particular node within an iSCSI instance present 1410 on the local system. 1412 For implementations where each {portal, node} tuple 1413 can have a different portal tag, this value will 1414 map to the iscsiNodeIndex. 1416 For implementations where the portal tag is the 1417 same for a given portal regardless of which node 1418 is using the portal, the value 0 (zero) is used." 1419 ::= { iscsiIntrPortalAttributesEntry 1 } 1421 iscsiIntrPortalTag OBJECT-TYPE 1422 SYNTAX Unsigned32 (1..65535) 1423 MAX-ACCESS read-write 1424 STATUS current 1425 DESCRIPTION 1426 "The portal's aggregation tag when the portal is used as 1427 an initiator portal. Multiple-connection sessions may 1428 be aggregated over portals sharing an identical 1429 aggregation tag. This object's storage type is 1430 specified in iscsiPortalStorageType." 1431 REFERENCE 1432 "RFC cccc, Section 4.4.1, iSCSI Architectural Model" 1433 ::= { iscsiIntrPortalAttributesEntry 2 } 1435 --********************************************************************** 1437 iscsiNode OBJECT IDENTIFIER ::= { iscsiObjects 5 } 1439 -- Node Attributes Table 1441 iscsiNodeAttributesTable OBJECT-TYPE 1442 SYNTAX SEQUENCE OF IscsiNodeAttributesEntry 1443 MAX-ACCESS not-accessible 1444 STATUS current 1445 DESCRIPTION 1446 "A list of iSCSI nodes belonging to each iSCSI instance 1447 present on the local system. An iSCSI node can act as 1448 an initiator, a target, or both." 1449 ::= { iscsiNode 1 } 1451 iscsiNodeAttributesEntry OBJECT-TYPE 1452 SYNTAX IscsiNodeAttributesEntry 1453 MAX-ACCESS not-accessible 1454 STATUS current 1455 DESCRIPTION 1456 "A conceptual row containing management information 1457 applicable to a particular iSCSI node." 1458 INDEX { iscsiInstIndex, iscsiNodeIndex } 1459 ::= { iscsiNodeAttributesTable 1 } 1461 IscsiNodeAttributesEntry ::= SEQUENCE { 1462 iscsiNodeIndex Unsigned32, 1463 iscsiNodeName IscsiName, 1464 iscsiNodeAlias SnmpAdminString, 1465 iscsiNodeRoles BITS, 1466 iscsiNodeTransportType RowPointer, 1467 iscsiNodeInitialR2T TruthValue, 1468 iscsiNodeImmediateData TruthValue, 1469 iscsiNodeMaxOutstandingR2T Unsigned32, 1470 iscsiNodeFirstBurstLength Unsigned32, 1471 iscsiNodeMaxBurstLength Unsigned32, 1472 iscsiNodeMaxConnections Unsigned32, 1473 iscsiNodeDataSequenceInOrder TruthValue, 1474 iscsiNodeDataPDUInOrder TruthValue, 1475 iscsiNodeDefaultTime2Wait Unsigned32, 1476 iscsiNodeDefaultTime2Retain Unsigned32, 1477 iscsiNodeErrorRecoveryLevel Unsigned32, 1478 iscsiNodeDiscontinuityTime TimeStamp, 1479 iscsiNodeStorageType StorageType 1480 } 1482 iscsiNodeIndex OBJECT-TYPE 1483 SYNTAX Unsigned32 (1..4294967295) 1484 MAX-ACCESS not-accessible 1485 STATUS current 1486 DESCRIPTION 1487 "An arbitrary integer used to uniquely identify a particular 1488 node within an iSCSI instance. This index value must not be 1489 modified or reused by an agent unless a reboot has occurred. 1490 An agent should attempt to keep this value persistent across 1491 reboots." 1492 ::= { iscsiNodeAttributesEntry 1 } 1494 iscsiNodeName OBJECT-TYPE 1495 SYNTAX IscsiName 1496 MAX-ACCESS read-only 1497 STATUS current 1498 DESCRIPTION 1499 "This node's iSCSI name, which is independent of the location 1500 of the node, and can be resolved into a set of addresses 1501 through various discovery services." 1502 ::= { iscsiNodeAttributesEntry 2 } 1504 iscsiNodeAlias OBJECT-TYPE 1505 SYNTAX SnmpAdminString 1506 MAX-ACCESS read-only 1507 STATUS current 1508 DESCRIPTION 1509 "A character string that is a human-readable name or 1510 description of the iSCSI node. If configured, this alias 1511 may be communicated to the initiator or target node at 1512 the remote end of the connection during a Login Request 1513 or Response message. This string is not used as an 1514 identifier, but can be displayed by the system's user 1515 interface in a list of initiators and/or targets to 1516 which it is connected. 1518 If no alias exists, the value is a zero-length string." 1519 REFERENCE 1520 "RFC cccc, Section 13.6, TargetAlias, 13.7, InitiatorAlias" 1521 ::= { iscsiNodeAttributesEntry 3 } 1523 iscsiNodeRoles OBJECT-TYPE 1524 SYNTAX BITS { 1525 targetTypeNode(0), 1526 initiatorTypeNode(1) 1527 } 1528 MAX-ACCESS read-only 1529 STATUS current 1530 DESCRIPTION 1531 "A node can operate in one or both of two roles: 1532 a target role and/or an initiator role. If the node 1533 will operate in both roles, both bits must be set. 1535 This object will also define the corresponding rows that 1536 will exist in the iscsiTargetAttributesTable, the 1537 iscsiInitiatorAttributesTable or both. If the 1538 targetTypeNode bit is set, there will be a corresponding 1539 iscsiTargetAttributesEntry. If the initiatorTypeNode bit 1540 is set, there will be a corresponding 1541 iscsiInitiatorAttributesEntry. If both bits are set, 1542 there will be a corresponding iscsiTgtPortalAttributesEntry 1543 and iscsiPortalAttributesEntry." 1544 ::= { iscsiNodeAttributesEntry 4 } 1546 iscsiNodeTransportType OBJECT-TYPE 1547 SYNTAX RowPointer 1548 MAX-ACCESS read-only 1549 STATUS current 1550 DESCRIPTION 1551 "A pointer to the corresponding row in the appropriate 1552 table for this SCSI transport, thereby allowing management 1553 stations to locate the SCSI-level device that is represented 1554 by this iscsiNode. For example, it will usually point to the 1555 corresponding scsiTrnspt object in the SCSI MIB module. 1556 If no corresponding row exists, the value 0.0 must be 1557 used to indicate this." 1558 REFERENCE 1559 "SCSI-MIB, RFC 4455 section 9, scsiTransportTypes" 1560 ::= { iscsiNodeAttributesEntry 5 } 1562 iscsiNodeInitialR2T OBJECT-TYPE 1563 SYNTAX TruthValue 1564 MAX-ACCESS read-only 1565 STATUS current 1566 DESCRIPTION 1567 "This object indicates the InitialR2T preference for this 1568 node: 1569 true = YES, 1570 false = will try to negotiate NO, will accept YES " 1571 REFERENCE 1572 "RFC cccc, Section 13.10, InitialR2T" 1573 ::= { iscsiNodeAttributesEntry 6 } 1575 iscsiNodeImmediateData OBJECT-TYPE 1576 SYNTAX TruthValue 1577 MAX-ACCESS read-write 1578 STATUS current 1579 DESCRIPTION 1580 "This object indicates ImmediateData preference for this 1581 node: 1582 true = YES (but will accept NO), 1583 false = NO " 1584 REFERENCE 1585 "RFC cccc, Section 13.11, ImmediateData" 1586 DEFVAL { true } 1587 ::= { iscsiNodeAttributesEntry 7 } 1589 iscsiNodeMaxOutstandingR2T OBJECT-TYPE 1590 SYNTAX Unsigned32 (1..65535) 1591 UNITS "R2Ts" 1592 MAX-ACCESS read-write 1593 STATUS current 1594 DESCRIPTION 1595 "Maximum number of outstanding requests-to-transmit (R2Ts) 1596 allowed per iSCSI task." 1597 REFERENCE 1598 "RFC cccc, Section 13.17, MaxOutstandingR2T" 1599 DEFVAL { 1 } 1600 ::= { iscsiNodeAttributesEntry 8 } 1602 iscsiNodeFirstBurstLength OBJECT-TYPE 1603 SYNTAX Unsigned32 (512..16777215) 1604 UNITS "bytes" 1605 MAX-ACCESS read-write 1606 STATUS current 1607 DESCRIPTION 1608 "The maximum length (bytes) supported for unsolicited data 1609 to/from this node." 1610 REFERENCE 1611 "RFC cccc, Section 13.14, FirstBurstLength" 1612 DEFVAL { 65536 } 1613 ::= { iscsiNodeAttributesEntry 9 } 1615 iscsiNodeMaxBurstLength OBJECT-TYPE 1616 SYNTAX Unsigned32 (512..16777215) 1617 UNITS "bytes" 1618 MAX-ACCESS read-write 1619 STATUS current 1620 DESCRIPTION 1621 "The maximum number of bytes that can be sent within 1622 a single sequence of Data-In or Data-Out PDUs." 1623 REFERENCE 1624 "RFC cccc, Section 13.13, MaxBurstLength" 1625 DEFVAL { 262144 } 1626 ::= { iscsiNodeAttributesEntry 10 } 1628 iscsiNodeMaxConnections OBJECT-TYPE 1629 SYNTAX Unsigned32 (1..65535) 1630 UNITS "connections" 1631 MAX-ACCESS read-write 1632 STATUS current 1633 DESCRIPTION 1634 "The maximum number of connections allowed in each 1635 session to and/or from this node." 1636 REFERENCE 1637 "RFC cccc, Section 13.2, MaxConnections" 1638 DEFVAL { 1 } 1639 ::= { iscsiNodeAttributesEntry 11 } 1641 iscsiNodeDataSequenceInOrder OBJECT-TYPE 1642 SYNTAX TruthValue 1643 MAX-ACCESS read-write 1644 STATUS current 1645 DESCRIPTION 1646 "The DataSequenceInOrder preference of this node. 1647 False (=No) indicates that iSCSI data PDU sequences may 1648 be transferred in any order. True (=Yes) indicates that 1649 data PDU sequences must be transferred using 1650 continuously increasing offsets, except during 1651 error recovery." 1652 REFERENCE 1653 "RFC cccc, Section 13.19, DataSequenceInOrder" 1654 DEFVAL { true } 1655 ::= { iscsiNodeAttributesEntry 12 } 1657 iscsiNodeDataPDUInOrder OBJECT-TYPE 1658 SYNTAX TruthValue 1659 MAX-ACCESS read-write 1660 STATUS current 1661 DESCRIPTION 1662 "The DataPDUInOrder preference of this node. 1663 False (=No) indicates that iSCSI data PDUs within sequences 1664 may be in any order. True (=Yes) indicates that data PDUs 1665 within sequences must be at continuously increasing 1666 addresses, with no gaps or overlay between PDUs." 1667 REFERENCE 1668 "RFC cccc, Section 13.18, DataPDUInOrder" 1669 DEFVAL { true } 1670 ::= { iscsiNodeAttributesEntry 13 } 1672 iscsiNodeDefaultTime2Wait OBJECT-TYPE 1673 SYNTAX Unsigned32 (0..3600) 1674 UNITS "seconds" 1675 MAX-ACCESS read-write 1676 STATUS current 1677 DESCRIPTION 1678 "The DefaultTime2Wait preference of this node. This is the 1679 minimum time, in seconds, to wait before attempting an 1680 explicit/implicit logout or active iSCSI task reassignment 1681 after an unexpected connection termination or a connection 1682 reset." 1683 REFERENCE 1684 "RFC cccc, Section 13.15, DefaultTime2Wait" 1685 DEFVAL { 2 } 1686 ::= { iscsiNodeAttributesEntry 14 } 1688 iscsiNodeDefaultTime2Retain OBJECT-TYPE 1689 SYNTAX Unsigned32 (0..3600) 1690 UNITS "seconds" 1691 MAX-ACCESS read-write 1692 STATUS current 1693 DESCRIPTION 1694 "The DefaultTime2Retain preference of this node. This is 1695 the maximum time, in seconds after an initial wait 1696 (Time2Wait), before which an active iSCSI task reassignment 1697 is still possible after an unexpected connection termination 1698 or a connection reset." 1699 REFERENCE 1700 "RFC cccc, Section 13.16, DefaultTime2Retain" 1701 DEFVAL { 20 } 1703 ::= { iscsiNodeAttributesEntry 15 } 1705 iscsiNodeErrorRecoveryLevel OBJECT-TYPE 1706 SYNTAX Unsigned32 (0..255) 1707 MAX-ACCESS read-write 1708 STATUS current 1709 DESCRIPTION 1710 "The ErrorRecoveryLevel preference of this node. 1711 Currently, only 0-2 are valid. 1713 This object is designed to accommodate future error recovery 1714 levels. 1716 Higher error recovery levels imply support in addition to 1717 support for the lower error level functions. In other words, 1718 error level 2 implies support for levels 0-1, since those 1719 functions are subsets of error level 2." 1720 REFERENCE 1721 "RFC cccc, Section 13.20, ErrorRecoveryLevel" 1722 DEFVAL { 0 } 1723 ::= { iscsiNodeAttributesEntry 16 } 1725 iscsiNodeDiscontinuityTime OBJECT-TYPE 1726 SYNTAX TimeStamp 1727 MAX-ACCESS read-only 1728 STATUS current 1729 DESCRIPTION 1730 "The value of SysUpTime on the most recent occasion 1731 at which any one or more of this node's counters 1732 suffered a discontinuity. 1734 If no such discontinuities have occurred since the last 1735 re-initialization of the local management subsystem, 1736 then this object contains a zero value." 1737 ::= { iscsiNodeAttributesEntry 17 } 1739 iscsiNodeStorageType OBJECT-TYPE 1740 SYNTAX StorageType 1741 MAX-ACCESS read-write 1742 STATUS current 1743 DESCRIPTION 1744 "The storage type for all read-write objects within this 1745 row. Rows in this table are always created via an 1746 external process (e.g. not created via this MIB module). 1747 Conceptual rows having the value 'permanent' need not allow 1748 Write access to any columnar objects in the row. 1750 If this object has the value 'volatile', modifications 1751 to read-write objects in this row are not persistent 1752 across reboots. If this object has the value 1753 'nonVolatile', modifications to objects in this row 1754 are persistent. 1756 An implementation may choose to allow this object 1757 to be set to either 'nonVolatile' or 'volatile', 1758 allowing the management application to choose this 1759 behavior." 1760 DEFVAL { volatile } 1761 ::= { iscsiNodeAttributesEntry 18 } 1763 --********************************************************************** 1765 iscsiTarget OBJECT IDENTIFIER ::= { iscsiObjects 6 } 1767 -- Target Attributes Table 1769 iscsiTargetAttributesTable OBJECT-TYPE 1770 SYNTAX SEQUENCE OF IscsiTargetAttributesEntry 1771 MAX-ACCESS not-accessible 1772 STATUS current 1773 DESCRIPTION 1774 "A list of iSCSI nodes that can take on a target role, 1775 belonging to each iSCSI instance present on the local 1776 system." 1777 ::= { iscsiTarget 1 } 1779 iscsiTargetAttributesEntry OBJECT-TYPE 1780 SYNTAX IscsiTargetAttributesEntry 1781 MAX-ACCESS not-accessible 1782 STATUS current 1783 DESCRIPTION 1784 "An entry (row) containing management information applicable 1785 to a particular node that can take on a target role." 1786 INDEX { iscsiInstIndex, iscsiNodeIndex } 1787 ::= { iscsiTargetAttributesTable 1 } 1789 IscsiTargetAttributesEntry ::= SEQUENCE { 1790 iscsiTgtLoginFailures Counter32, 1791 iscsiTgtLastFailureTime TimeStamp, 1792 iscsiTgtLastFailureType AutonomousType, 1793 iscsiTgtLastIntrFailureName IscsiName, 1794 iscsiTgtLastIntrFailureAddrType InetAddressType, 1795 iscsiTgtLastIntrFailureAddr InetAddress 1796 } 1798 iscsiTgtLoginFailures OBJECT-TYPE 1799 SYNTAX Counter32 1800 UNITS "failed login attempts" 1801 MAX-ACCESS read-only 1802 STATUS current 1803 DESCRIPTION 1804 "This object counts the number of times a login attempt to this 1805 local target has failed. 1806 If this counter has suffered a discontinuity, the time of the 1807 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1808 REFERENCE 1809 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 1810 ::= { iscsiTargetAttributesEntry 1 } 1812 iscsiTgtLastFailureTime OBJECT-TYPE 1813 SYNTAX TimeStamp 1814 MAX-ACCESS read-only 1815 STATUS current 1816 DESCRIPTION 1817 "The timestamp of the most recent failure of a login attempt 1818 to this target. A value of zero indicates that no such 1819 failures have occurred since the last system boot." 1820 ::= { iscsiTargetAttributesEntry 2 } 1822 iscsiTgtLastFailureType OBJECT-TYPE 1823 SYNTAX AutonomousType 1824 MAX-ACCESS read-only 1825 STATUS current 1826 DESCRIPTION 1827 "The type of the most recent failure of a login attempt 1828 to this target, represented as the OID of the counter 1829 object in iscsiTargetLoginStatsTable for which the 1830 relevant instance was incremented. If no such failures 1831 have occurred since the last system boot, this attribute 1832 will have the value 0.0. A value of 0.0 may also be used 1833 to indicate a type that is not represented by any of 1834 the counters in iscsiTargetLoginStatsTable." 1835 ::= { iscsiTargetAttributesEntry 3 } 1837 iscsiTgtLastIntrFailureName OBJECT-TYPE 1838 SYNTAX IscsiName 1839 MAX-ACCESS read-only 1840 STATUS current 1841 DESCRIPTION 1842 "The iSCSI name of the initiator that failed the last 1843 login attempt. If no such failures have occurred since 1844 the last system boot, this value is a zero-length string." 1845 ::= { iscsiTargetAttributesEntry 4 } 1847 iscsiTgtLastIntrFailureAddrType OBJECT-TYPE 1848 SYNTAX InetAddressType 1849 MAX-ACCESS read-only 1850 STATUS current 1851 DESCRIPTION 1852 "The type of Internet Network Address contained in the 1853 corresponding instance of the iscsiTgtLastIntrFailureAddr. 1854 The value 'dns' is not allowed. If no such failures have 1855 occurred since the last system boot, this value is zero." 1856 ::= { iscsiTargetAttributesEntry 5 } 1858 iscsiTgtLastIntrFailureAddr OBJECT-TYPE 1859 SYNTAX InetAddress 1860 MAX-ACCESS read-only 1861 STATUS current 1862 DESCRIPTION 1863 "An Internet Network Address, of the type specified by 1864 the object iscsiTgtLastIntrFailureAddrType, giving the 1865 host address of the initiator that failed the last login 1866 attempt. If no such failures have occurred since the last 1867 system boot, this value is a zero-length string." 1868 ::= { iscsiTargetAttributesEntry 6 } 1870 -- Target Login Stats Table 1872 iscsiTargetLoginStatsTable OBJECT-TYPE 1873 SYNTAX SEQUENCE OF IscsiTargetLoginStatsEntry 1874 MAX-ACCESS not-accessible 1875 STATUS current 1876 DESCRIPTION 1877 "A table of counters that keep a record of the results 1878 of initiators' login attempts to this target." 1879 ::= { iscsiTarget 2 } 1881 iscsiTargetLoginStatsEntry OBJECT-TYPE 1882 SYNTAX IscsiTargetLoginStatsEntry 1883 MAX-ACCESS not-accessible 1884 STATUS current 1885 DESCRIPTION 1886 "An entry (row) containing counters for each result of 1887 a login attempt to this target." 1888 AUGMENTS { iscsiTargetAttributesEntry } 1889 ::= { iscsiTargetLoginStatsTable 1 } 1891 IscsiTargetLoginStatsEntry ::= SEQUENCE { 1892 iscsiTgtLoginAccepts Counter32, 1893 iscsiTgtLoginOtherFails Counter32, 1894 iscsiTgtLoginRedirects Counter32, 1895 iscsiTgtLoginAuthorizeFails Counter32, 1896 iscsiTgtLoginAuthenticateFails Counter32, 1897 iscsiTgtLoginNegotiateFails Counter32 1898 } 1899 iscsiTgtLoginAccepts OBJECT-TYPE 1900 SYNTAX Counter32 1901 UNITS "successful logins" 1902 MAX-ACCESS read-only 1903 STATUS current 1904 DESCRIPTION 1905 "The count of Login Response PDUs with status 1906 0x0000, Accept Login, transmitted by this 1907 target. 1908 If this counter has suffered a discontinuity, the time of the 1909 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1910 REFERENCE 1911 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 1912 ::= { iscsiTargetLoginStatsEntry 1 } 1914 iscsiTgtLoginOtherFails OBJECT-TYPE 1915 SYNTAX Counter32 1916 UNITS "failed logins" 1917 MAX-ACCESS read-only 1918 STATUS current 1919 DESCRIPTION 1920 "The number of Login Response PDUs that were transmitted 1921 by this target and that were not counted by any other 1922 object in the row. 1923 If this counter has suffered a discontinuity, the time of the 1924 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1925 REFERENCE 1926 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 1927 ::= { iscsiTargetLoginStatsEntry 2 } 1929 iscsiTgtLoginRedirects OBJECT-TYPE 1930 SYNTAX Counter32 1931 UNITS "redirected logins" 1932 MAX-ACCESS read-only 1933 STATUS current 1934 DESCRIPTION 1935 "The count of Login Response PDUs with status class 0x01, 1936 Redirection, transmitted by this target. 1937 If this counter has suffered a discontinuity, the time of the 1938 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1939 REFERENCE 1940 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 1941 ::= { iscsiTargetLoginStatsEntry 3 } 1943 iscsiTgtLoginAuthorizeFails OBJECT-TYPE 1944 SYNTAX Counter32 1945 UNITS "failed logins" 1946 MAX-ACCESS read-only 1947 STATUS current 1948 DESCRIPTION 1949 "The count of Login Response PDUs with status 0x0202, 1950 Forbidden Target, transmitted by this target. 1952 If this counter is incremented, an iscsiTgtLoginFailure 1953 notification should be generated. 1954 If this counter has suffered a discontinuity, the time of the 1955 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1956 REFERENCE 1957 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 1958 ::= { iscsiTargetLoginStatsEntry 4 } 1960 iscsiTgtLoginAuthenticateFails OBJECT-TYPE 1961 SYNTAX Counter32 1962 UNITS "failed logins" 1963 MAX-ACCESS read-only 1964 STATUS current 1965 DESCRIPTION 1966 "The count of Login Response PDUs with status 0x0201, 1967 Authentication Failed, transmitted by this target. 1969 If this counter is incremented, an iscsiTgtLoginFailure 1970 notification should be generated. 1972 If this counter has suffered a discontinuity, the time of the 1973 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1974 REFERENCE 1975 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 1976 ::= { iscsiTargetLoginStatsEntry 5 } 1978 iscsiTgtLoginNegotiateFails OBJECT-TYPE 1979 SYNTAX Counter32 1980 UNITS "failed logins" 1981 MAX-ACCESS read-only 1982 STATUS current 1983 DESCRIPTION 1984 "The number of times a target has effectively refused a 1985 login because the parameter negotiation failed. 1986 If this counter is incremented, an iscsiTgtLoginFailure 1987 notification should be generated. 1988 If this counter has suffered a discontinuity, the time of the 1989 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1990 ::= { iscsiTargetLoginStatsEntry 6 } 1992 -- Target Logout Stats Table 1994 iscsiTargetLogoutStatsTable OBJECT-TYPE 1995 SYNTAX SEQUENCE OF IscsiTargetLogoutStatsEntry 1996 MAX-ACCESS not-accessible 1997 STATUS current 1998 DESCRIPTION 1999 "When a target receives a Logout command, it responds 2000 with a Logout Response that carries a status code. 2001 This table contains counters for both normal and 2002 abnormal logout requests received by this target." 2003 ::= { iscsiTarget 3 } 2005 iscsiTargetLogoutStatsEntry OBJECT-TYPE 2006 SYNTAX IscsiTargetLogoutStatsEntry 2007 MAX-ACCESS not-accessible 2008 STATUS current 2009 DESCRIPTION 2010 "An entry (row) containing counters of Logout Response 2011 PDUs that were received by this target." 2012 AUGMENTS { iscsiTargetAttributesEntry } 2013 ::= { iscsiTargetLogoutStatsTable 1 } 2015 IscsiTargetLogoutStatsEntry ::= SEQUENCE { 2016 iscsiTgtLogoutNormals Counter32, 2017 iscsiTgtLogoutOthers Counter32 2018 } 2020 iscsiTgtLogoutNormals OBJECT-TYPE 2021 SYNTAX Counter32 2022 UNITS "normal logouts" 2023 MAX-ACCESS read-only 2024 STATUS current 2025 DESCRIPTION 2026 "The count of Logout Command PDUs received by this target, 2027 with reason code 0 (closes the session). 2028 If this counter has suffered a discontinuity, the time of the 2029 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2030 REFERENCE 2031 "RFC cccc, Section 11.14.1, Reason Code" 2032 ::= { iscsiTargetLogoutStatsEntry 1 } 2034 iscsiTgtLogoutOthers OBJECT-TYPE 2035 SYNTAX Counter32 2036 UNITS "abnormal logouts" 2037 MAX-ACCESS read-only 2038 STATUS current 2039 DESCRIPTION 2040 "The count of Logout Command PDUs received by this target, 2041 with any reason code other than 0. 2042 If this counter has suffered a discontinuity, the time of the 2043 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2044 REFERENCE 2045 "RFC cccc, Section 11.14.1, Reason Code" 2046 ::= { iscsiTargetLogoutStatsEntry 2 } 2048 --********************************************************************** 2050 iscsiTgtAuthorization OBJECT IDENTIFIER ::= { iscsiObjects 7 } 2052 -- Target Authorization Attributes Table 2054 iscsiTgtAuthAttributesTable OBJECT-TYPE 2055 SYNTAX SEQUENCE OF IscsiTgtAuthAttributesEntry 2056 MAX-ACCESS not-accessible 2057 STATUS current 2058 DESCRIPTION 2059 "A list of initiator identities that are authorized to 2060 access each target node within each iSCSI instance 2061 present on the local system." 2062 ::= { iscsiTgtAuthorization 1 } 2064 iscsiTgtAuthAttributesEntry OBJECT-TYPE 2065 SYNTAX IscsiTgtAuthAttributesEntry 2066 MAX-ACCESS not-accessible 2067 STATUS current 2068 DESCRIPTION 2069 "An entry (row) containing management information 2070 applicable to a particular target node's authorized 2071 initiator identity." 2072 INDEX { iscsiInstIndex, iscsiNodeIndex, iscsiTgtAuthIndex } 2073 ::= { iscsiTgtAuthAttributesTable 1 } 2075 IscsiTgtAuthAttributesEntry ::= SEQUENCE { 2076 iscsiTgtAuthIndex Unsigned32, 2077 iscsiTgtAuthRowStatus RowStatus, 2078 iscsiTgtAuthIdentity RowPointer, 2079 iscsiTgtAuthStorageType StorageType 2080 } 2082 iscsiTgtAuthIndex OBJECT-TYPE 2083 SYNTAX Unsigned32 (1..4294967295) 2084 MAX-ACCESS not-accessible 2085 STATUS current 2086 DESCRIPTION 2087 "An arbitrary integer used to uniquely identify a particular 2088 target's authorized initiator identity within an iSCSI 2089 instance present on the local system. This index value must 2090 not be modified or reused by an agent unless a reboot has 2091 occurred. An agent should attempt to keep this value 2092 persistent across reboots." 2093 ::= { iscsiTgtAuthAttributesEntry 1 } 2094 iscsiTgtAuthRowStatus OBJECT-TYPE 2095 SYNTAX RowStatus 2096 MAX-ACCESS read-create 2097 STATUS current 2098 DESCRIPTION 2099 "This field allows entries to be dynamically added and 2100 removed from this table via SNMP. When adding a row to 2101 this table, all non-Index/RowStatus objects must be set. 2102 When the value of this object is 'active', the values of 2103 the other objects in this table cannot be changed. 2104 Rows may be discarded using RowStatus." 2105 ::= { iscsiTgtAuthAttributesEntry 2 } 2107 iscsiTgtAuthIdentity OBJECT-TYPE 2108 SYNTAX RowPointer 2109 MAX-ACCESS read-create 2110 STATUS current 2111 DESCRIPTION 2112 "A pointer to the corresponding user entry in the IPS-AUTH 2113 MIB module that will be allowed to access this iSCSI target." 2114 REFERENCE 2115 "IPS-AUTH MIB, RFC 4545, 7.3, ipsAuthIdentAttributeEntry" 2116 ::= { iscsiTgtAuthAttributesEntry 3 } 2118 iscsiTgtAuthStorageType OBJECT-TYPE 2119 SYNTAX StorageType 2120 MAX-ACCESS read-create 2121 STATUS current 2122 DESCRIPTION 2123 "The storage type for this row. Rows in this table that were 2124 created through an external process (e.g. not created via 2125 this MIB) may have a storage type of readOnly or permanent. 2127 Conceptual rows having the value 'permanent' need not 2128 allow write access to any columnar objects in the row." 2129 DEFVAL { nonVolatile } 2130 ::= { iscsiTgtAuthAttributesEntry 4 } 2132 --********************************************************************** 2134 iscsiInitiator OBJECT IDENTIFIER ::= { iscsiObjects 8 } 2136 -- Initiator Attributes Table 2138 iscsiInitiatorAttributesTable OBJECT-TYPE 2139 SYNTAX SEQUENCE OF IscsiInitiatorAttributesEntry 2140 MAX-ACCESS not-accessible 2141 STATUS current 2142 DESCRIPTION 2143 "A list of iSCSI nodes that can take on an initiator 2144 role, belonging to each iSCSI instance present on 2145 the local system." 2146 ::= { iscsiInitiator 1 } 2148 iscsiInitiatorAttributesEntry OBJECT-TYPE 2149 SYNTAX IscsiInitiatorAttributesEntry 2150 MAX-ACCESS not-accessible 2151 STATUS current 2152 DESCRIPTION 2153 "An entry (row) containing management information 2154 applicable to a particular iSCSI node that has 2155 initiator capabilities." 2156 INDEX { iscsiInstIndex, iscsiNodeIndex } 2157 ::= { iscsiInitiatorAttributesTable 1 } 2159 IscsiInitiatorAttributesEntry ::= SEQUENCE { 2160 iscsiIntrLoginFailures Counter32, 2161 iscsiIntrLastFailureTime TimeStamp, 2162 iscsiIntrLastFailureType AutonomousType, 2163 iscsiIntrLastTgtFailureName IscsiName, 2164 iscsiIntrLastTgtFailureAddrType InetAddressType, 2165 iscsiIntrLastTgtFailureAddr InetAddress 2166 } 2168 iscsiIntrLoginFailures OBJECT-TYPE 2169 SYNTAX Counter32 2170 UNITS "failed logins" 2171 MAX-ACCESS read-only 2172 STATUS current 2173 DESCRIPTION 2174 "This object counts the number of times a login attempt from 2175 this local initiator has failed. 2176 If this counter has suffered a discontinuity, the time of the 2177 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2178 REFERENCE 2179 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2180 ::= { iscsiInitiatorAttributesEntry 1 } 2182 iscsiIntrLastFailureTime OBJECT-TYPE 2183 SYNTAX TimeStamp 2184 MAX-ACCESS read-only 2185 STATUS current 2186 DESCRIPTION 2187 "The timestamp of the most recent failure of a login attempt 2188 from this initiator. A value of zero indicates that no such 2189 failures have occurred since the last system boot." 2190 ::= { iscsiInitiatorAttributesEntry 2 } 2191 iscsiIntrLastFailureType OBJECT-TYPE 2192 SYNTAX AutonomousType 2193 MAX-ACCESS read-only 2194 STATUS current 2195 DESCRIPTION 2196 "The type of the most recent failure of a login attempt 2197 from this initiator, represented as the OID of the counter 2198 object in iscsiInitiatorLoginStatsTable for which the 2199 relevant instance was incremented. If no such failures have 2200 occurred since the last system boot, this attribute will 2201 have the value 0.0. A value of 0.0 may also be used to 2202 indicate a type that is not represented by any of 2203 the counters in iscsiInitiatorLoginStatsTable." 2204 ::= { iscsiInitiatorAttributesEntry 3 } 2206 iscsiIntrLastTgtFailureName OBJECT-TYPE 2207 SYNTAX IscsiName 2208 MAX-ACCESS read-only 2209 STATUS current 2210 DESCRIPTION 2211 "A UTF-8 string giving the name of the target that failed 2212 the last login attempt. If no such failures have occurred 2213 since the last system boot, this value is a zero-length string." 2214 ::= { iscsiInitiatorAttributesEntry 4 } 2216 iscsiIntrLastTgtFailureAddrType OBJECT-TYPE 2217 SYNTAX InetAddressType 2218 MAX-ACCESS read-only 2219 STATUS current 2220 DESCRIPTION 2221 "The type of Internet Network Address contained in the 2222 corresponding instance of the iscsiIntrLastTgtFailureAddr. 2223 The value 'dns' is not allowed. If no such failures have 2224 occurred since the last system boot, this value is zero." 2225 ::= { iscsiInitiatorAttributesEntry 5 } 2227 iscsiIntrLastTgtFailureAddr OBJECT-TYPE 2228 SYNTAX InetAddress 2229 MAX-ACCESS read-only 2230 STATUS current 2231 DESCRIPTION 2232 "An Internet Network Address, of the type specified by the 2233 object iscsiIntrLastTgtFailureAddrType, giving the host 2234 address of the target that failed the last login attempt. 2235 If no such failures have occurred since the last system boot, 2236 this value is a zero-length string." 2237 ::= { iscsiInitiatorAttributesEntry 6 } 2238 -- Initiator Login Stats Table 2240 iscsiInitiatorLoginStatsTable OBJECT-TYPE 2241 SYNTAX SEQUENCE OF IscsiInitiatorLoginStatsEntry 2242 MAX-ACCESS not-accessible 2243 STATUS current 2244 DESCRIPTION 2245 "A table of counters which keep track of the results of 2246 this initiator's login attempts." 2247 ::= { iscsiInitiator 2 } 2249 iscsiInitiatorLoginStatsEntry OBJECT-TYPE 2250 SYNTAX IscsiInitiatorLoginStatsEntry 2251 MAX-ACCESS not-accessible 2252 STATUS current 2253 DESCRIPTION 2254 "An entry (row) containing counters of each result 2255 of this initiator's login attempts." 2256 AUGMENTS { iscsiInitiatorAttributesEntry } 2257 ::= { iscsiInitiatorLoginStatsTable 1 } 2259 IscsiInitiatorLoginStatsEntry ::= SEQUENCE { 2260 iscsiIntrLoginAcceptRsps Counter32, 2261 iscsiIntrLoginOtherFailRsps Counter32, 2262 iscsiIntrLoginRedirectRsps Counter32, 2263 iscsiIntrLoginAuthFailRsps Counter32, 2264 iscsiIntrLoginAuthenticateFails Counter32, 2265 iscsiIntrLoginNegotiateFails Counter32, 2266 iscsiIntrLoginAuthorizeFails Counter32 2267 } 2269 iscsiIntrLoginAcceptRsps OBJECT-TYPE 2270 SYNTAX Counter32 2271 UNITS "successful logins" 2272 MAX-ACCESS read-only 2273 STATUS current 2274 DESCRIPTION 2275 "The count of Login Response PDUs with status 2276 0x0000, Accept Login, received by this initiator. 2277 If this counter has suffered a discontinuity, the time of the 2278 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2279 REFERENCE 2280 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2281 ::= { iscsiInitiatorLoginStatsEntry 1 } 2283 iscsiIntrLoginOtherFailRsps OBJECT-TYPE 2284 SYNTAX Counter32 2285 UNITS "failed logins" 2286 MAX-ACCESS read-only 2287 STATUS current 2288 DESCRIPTION 2289 "The count of Login Response PDUs received by this 2290 initiator with any status code not counted in the 2291 objects below. 2292 If this counter has suffered a discontinuity, the time of the 2293 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2294 REFERENCE 2295 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2296 ::= { iscsiInitiatorLoginStatsEntry 2 } 2298 iscsiIntrLoginRedirectRsps OBJECT-TYPE 2299 SYNTAX Counter32 2300 UNITS "failed logins" 2301 MAX-ACCESS read-only 2302 STATUS current 2303 DESCRIPTION 2304 "The count of Login Response PDUs with status class 0x01, 2305 Redirection, received by this initiator. 2306 If this counter has suffered a discontinuity, the time of the 2307 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2308 REFERENCE 2309 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2310 ::= { iscsiInitiatorLoginStatsEntry 3 } 2312 iscsiIntrLoginAuthFailRsps OBJECT-TYPE 2313 SYNTAX Counter32 2314 UNITS "failed logins" 2315 MAX-ACCESS read-only 2316 STATUS current 2317 DESCRIPTION 2318 "The count of Login Response PDUs with status class 0x201, 2319 Authentication Failed, received by this initiator. 2320 If this counter has suffered a discontinuity, the time of the 2321 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2322 REFERENCE 2323 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2324 ::= { iscsiInitiatorLoginStatsEntry 4 } 2326 iscsiIntrLoginAuthenticateFails OBJECT-TYPE 2327 SYNTAX Counter32 2328 UNITS "failed logins" 2329 MAX-ACCESS read-only 2330 STATUS current 2331 DESCRIPTION 2332 "The number of times the initiator has aborted a 2333 login because the target could not be authenticated. 2335 No response is generated. 2337 If this counter is incremented, an iscsiIntrLoginFailure 2338 notification should be generated. 2339 If this counter has suffered a discontinuity, the time of the 2340 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2341 REFERENCE 2342 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2343 ::= { iscsiInitiatorLoginStatsEntry 5 } 2345 iscsiIntrLoginNegotiateFails OBJECT-TYPE 2346 SYNTAX Counter32 2347 UNITS "failed logins" 2348 MAX-ACCESS read-only 2349 STATUS current 2350 DESCRIPTION 2351 "The number of times the initiator has aborted a 2352 login because parameter negotiation with the target 2353 failed. 2355 No response is generated. 2357 If this counter is incremented, an iscsiIntrLoginFailure 2358 notification should be generated. 2359 If this counter has suffered a discontinuity, the time of the 2360 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2361 REFERENCE 2362 "RFC cccc, Section 7.12, Negotiation Failures" 2363 ::= { iscsiInitiatorLoginStatsEntry 6 } 2365 iscsiIntrLoginAuthorizeFails OBJECT-TYPE 2366 SYNTAX Counter32 2367 UNITS "failed logins" 2368 MAX-ACCESS read-only 2369 STATUS current 2370 DESCRIPTION 2371 "The count of Login Response PDUs with status 0x0202, 2372 Forbidden Target, received by this initiator. 2374 If this counter is incremented, an iscsiIntrLoginFailure 2375 notification should be generated. 2376 If this counter has suffered a discontinuity, the time of the 2377 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2378 REFERENCE 2379 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2380 ::= { iscsiInitiatorLoginStatsEntry 7 } 2382 -- Initiator Logout Stats Table 2383 iscsiInitiatorLogoutStatsTable OBJECT-TYPE 2384 SYNTAX SEQUENCE OF IscsiInitiatorLogoutStatsEntry 2385 MAX-ACCESS not-accessible 2386 STATUS current 2387 DESCRIPTION 2388 "When an initiator attempts to send a Logout command, the target 2389 responds with a Logout Response that carries a status code. 2390 This table contains a list of counters of Logout Response 2391 PDUs of each status code that was received by each 2392 initiator belonging to this iSCSI instance present on this 2393 system." 2394 ::= { iscsiInitiator 3 } 2396 iscsiInitiatorLogoutStatsEntry OBJECT-TYPE 2397 SYNTAX IscsiInitiatorLogoutStatsEntry 2398 MAX-ACCESS not-accessible 2399 STATUS current 2400 DESCRIPTION 2401 "An entry (row) containing counters of Logout Response 2402 PDUs of each status code that was generated by this 2403 initiator." 2404 AUGMENTS { iscsiInitiatorAttributesEntry } 2405 ::= { iscsiInitiatorLogoutStatsTable 1 } 2407 IscsiInitiatorLogoutStatsEntry ::= SEQUENCE { 2408 iscsiIntrLogoutNormals Counter32, 2409 iscsiIntrLogoutOthers Counter32 2410 } 2412 iscsiIntrLogoutNormals OBJECT-TYPE 2413 SYNTAX Counter32 2414 UNITS "normal logouts" 2415 MAX-ACCESS read-only 2416 STATUS current 2417 DESCRIPTION 2418 "The count of Logout Command PDUs generated by this initiator 2419 with reason code 0 (closes the session). 2420 If this counter has suffered a discontinuity, the time of the 2421 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2422 REFERENCE 2423 "RFC cccc, Section 11.14.1, Reason Code" 2424 ::= { iscsiInitiatorLogoutStatsEntry 1 } 2426 iscsiIntrLogoutOthers OBJECT-TYPE 2427 SYNTAX Counter32 2428 UNITS "abnormal logouts" 2429 MAX-ACCESS read-only 2430 STATUS current 2431 DESCRIPTION 2432 "The count of Logout Command PDUs generated by this initiator 2433 with any status code other than 0. 2434 If this counter has suffered a discontinuity, the time of the 2435 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2436 REFERENCE 2437 "RFC cccc, Section 11.14.1, Reason Code" 2439 ::= { iscsiInitiatorLogoutStatsEntry 2 } 2441 --********************************************************************** 2443 iscsiIntrAuthorization OBJECT IDENTIFIER ::= { iscsiObjects 9 } 2445 -- Initiator Authorization Attributes Table 2447 iscsiIntrAuthAttributesTable OBJECT-TYPE 2448 SYNTAX SEQUENCE OF IscsiIntrAuthAttributesEntry 2449 MAX-ACCESS not-accessible 2450 STATUS current 2451 DESCRIPTION 2452 "A list of target identities that each initiator 2453 on the local system may access." 2454 ::= { iscsiIntrAuthorization 1 } 2456 iscsiIntrAuthAttributesEntry OBJECT-TYPE 2457 SYNTAX IscsiIntrAuthAttributesEntry 2458 MAX-ACCESS not-accessible 2459 STATUS current 2460 DESCRIPTION 2461 "An entry (row) containing management information applicable 2462 to a particular initiator node's authorized target identity." 2463 INDEX { iscsiInstIndex, iscsiNodeIndex, iscsiIntrAuthIndex } 2464 ::= { iscsiIntrAuthAttributesTable 1 } 2466 IscsiIntrAuthAttributesEntry ::= SEQUENCE { 2467 iscsiIntrAuthIndex Unsigned32, 2468 iscsiIntrAuthRowStatus RowStatus, 2469 iscsiIntrAuthIdentity RowPointer, 2470 iscsiIntrAuthStorageType StorageType 2471 } 2473 iscsiIntrAuthIndex OBJECT-TYPE 2474 SYNTAX Unsigned32 (1..4294967295) 2475 MAX-ACCESS not-accessible 2476 STATUS current 2477 DESCRIPTION 2478 "An arbitrary integer used to uniquely identify a 2479 particular initiator node's authorized target 2480 identity within an iSCSI instance present on the 2481 local system. This index value must not be modified 2482 or reused by an agent unless a reboot has occurred. 2483 An agent should attempt to keep this value persistent 2484 across reboots." 2485 ::= { iscsiIntrAuthAttributesEntry 1 } 2487 iscsiIntrAuthRowStatus OBJECT-TYPE 2488 SYNTAX RowStatus 2489 MAX-ACCESS read-create 2490 STATUS current 2491 DESCRIPTION 2492 "This field allows entries to be dynamically added and 2493 removed from this table via SNMP. When adding a row to 2494 this table, all non-Index/RowStatus objects must be set. 2495 When the value of this object is 'active', the values of 2496 the other objects in this table cannot be changed. 2497 Rows may be discarded using RowStatus." 2498 ::= { iscsiIntrAuthAttributesEntry 2 } 2500 iscsiIntrAuthIdentity OBJECT-TYPE 2501 SYNTAX RowPointer 2502 MAX-ACCESS read-create 2503 STATUS current 2504 DESCRIPTION 2505 "A pointer to the corresponding user entry in the IPS-AUTH 2506 MIB module to which this initiator node should attempt to 2507 establish an iSCSI session." 2508 REFERENCE 2509 "IPS-AUTH MIB, RFC 4545, 7.3, ipsAuthInstanceAttributeEntry" 2510 ::= { iscsiIntrAuthAttributesEntry 3 } 2512 iscsiIntrAuthStorageType OBJECT-TYPE 2513 SYNTAX StorageType 2514 MAX-ACCESS read-create 2515 STATUS current 2516 DESCRIPTION 2517 "The storage type for this row. Rows in this table that were 2518 created through an external process (e.g. not created via 2519 this MIB) may have a storage type of readOnly or permanent. 2521 Conceptual rows having the value 'permanent' need not 2522 allow write access to any columnar objects in the row." 2523 DEFVAL { nonVolatile } 2524 ::= { iscsiIntrAuthAttributesEntry 4 } 2526 --********************************************************************** 2528 iscsiSession OBJECT IDENTIFIER ::= { iscsiObjects 10 } 2529 -- Session Attributes Table 2531 iscsiSessionAttributesTable OBJECT-TYPE 2532 SYNTAX SEQUENCE OF IscsiSessionAttributesEntry 2533 MAX-ACCESS not-accessible 2534 STATUS current 2535 DESCRIPTION 2536 "A list of sessions belonging to each iSCSI instance 2537 present on the system." 2538 ::= { iscsiSession 1 } 2540 iscsiSessionAttributesEntry OBJECT-TYPE 2541 SYNTAX IscsiSessionAttributesEntry 2542 MAX-ACCESS not-accessible 2543 STATUS current 2544 DESCRIPTION 2545 "An entry (row) containing management information applicable 2546 to a particular session. 2548 If this session is a discovery session that is not attached 2549 to any particular node, the iscsiSsnNodeIndex will be zero. 2550 Otherwise, the iscsiSsnNodeIndex will have the same value as 2551 iscsiNodeIndex." 2552 INDEX { iscsiInstIndex, iscsiSsnNodeIndex, iscsiSsnIndex } 2553 ::= { iscsiSessionAttributesTable 1 } 2555 IscsiSessionAttributesEntry ::= SEQUENCE { 2556 iscsiSsnNodeIndex Unsigned32, 2557 iscsiSsnIndex Unsigned32, 2558 iscsiSsnDirection INTEGER, 2559 iscsiSsnInitiatorName IscsiName, 2560 iscsiSsnTargetName IscsiName, 2561 iscsiSsnTSIH Unsigned32, 2562 iscsiSsnISID OCTET STRING, 2563 iscsiSsnInitiatorAlias SnmpAdminString, 2564 iscsiSsnTargetAlias SnmpAdminString, 2565 iscsiSsnInitialR2T TruthValue, 2566 iscsiSsnImmediateData TruthValue, 2567 iscsiSsnType INTEGER, 2568 iscsiSsnMaxOutstandingR2T Unsigned32, 2569 iscsiSsnFirstBurstLength Unsigned32, 2570 iscsiSsnMaxBurstLength Unsigned32, 2571 iscsiSsnConnectionNumber Gauge32, 2572 iscsiSsnAuthIdentity RowPointer, 2573 iscsiSsnDataSequenceInOrder TruthValue, 2574 iscsiSsnDataPDUInOrder TruthValue, 2575 iscsiSsnErrorRecoveryLevel Unsigned32, 2576 iscsiSsnDiscontinuityTime TimeStamp, 2577 iscsiSsnProtocolLevel Unsigned32, 2578 iscsiSsnTaskReporting BITS 2579 } 2581 iscsiSsnNodeIndex OBJECT-TYPE 2582 SYNTAX Unsigned32 (0..4294967295) 2583 MAX-ACCESS not-accessible 2584 STATUS current 2585 DESCRIPTION 2586 "An arbitrary integer used to uniquely identify a 2587 particular node within an iSCSI instance present 2588 on the local system. For normal, non-discovery 2589 sessions, this value will map to the iscsiNodeIndex. 2590 For discovery sessions that do not have a node 2591 associated, the value 0 (zero) is used." 2592 ::= { iscsiSessionAttributesEntry 1 } 2594 iscsiSsnIndex OBJECT-TYPE 2595 SYNTAX Unsigned32 (1..4294967295) 2596 MAX-ACCESS not-accessible 2597 STATUS current 2598 DESCRIPTION 2599 "An arbitrary integer used to uniquely identify a 2600 particular session within an iSCSI instance present 2601 on the local system. An agent should attempt to 2602 not reuse index values unless a reboot has occurred. 2603 iSCSI sessions are destroyed during a reboot; rows 2604 in this table are not persistent across reboots." 2605 ::= { iscsiSessionAttributesEntry 2 } 2607 iscsiSsnDirection OBJECT-TYPE 2608 SYNTAX INTEGER { 2609 inboundSession(1), 2610 outboundSession(2) 2611 } 2612 MAX-ACCESS read-only 2613 STATUS current 2614 DESCRIPTION 2615 "Direction of iSCSI session: 2616 inboundSession - session is established from an external 2617 initiator to a target within this iSCSI 2618 instance. 2619 outboundSession - session is established from an initiator 2620 within this iSCSI instance to an external 2621 target." 2622 ::= { iscsiSessionAttributesEntry 3 } 2624 iscsiSsnInitiatorName OBJECT-TYPE 2625 SYNTAX IscsiName 2626 MAX-ACCESS read-only 2627 STATUS current 2628 DESCRIPTION 2629 "If iscsiSsnDirection is Inbound, this object is a 2630 UTF-8 string that will contain the name of the remote 2631 initiator. If this session is a discovery session that 2632 does not specify a particular initiator, this object 2633 will contain a zero-length string. 2635 If iscsiSsnDirection is Outbound, this object will 2636 contain a zero-length string." 2637 ::= { iscsiSessionAttributesEntry 4 } 2639 iscsiSsnTargetName OBJECT-TYPE 2640 SYNTAX IscsiName 2641 MAX-ACCESS read-only 2642 STATUS current 2643 DESCRIPTION 2644 "If iscsiSsnDirection is Outbound, this object is a 2645 UTF-8 string that will contain the name of the remote 2646 target. If this session is a discovery session that 2647 does not specify a particular target, this object will 2648 contain a zero-length string. 2650 If iscsiSsnDirection is Inbound, this object will 2651 contain a zero-length string." 2652 ::= { iscsiSessionAttributesEntry 5 } 2654 iscsiSsnTSIH OBJECT-TYPE 2655 SYNTAX Unsigned32 (1..65535) 2656 MAX-ACCESS read-only 2657 STATUS current 2658 DESCRIPTION 2659 "The target-defined identification handle for this session." 2660 REFERENCE 2661 "RFC cccc, Section 11.12.6, TSIH" 2662 ::= { iscsiSessionAttributesEntry 6 } 2664 iscsiSsnISID OBJECT-TYPE 2665 SYNTAX OCTET STRING (SIZE(6)) 2666 MAX-ACCESS read-only 2667 STATUS current 2668 DESCRIPTION 2669 "The initiator-defined portion of the iSCSI Session ID." 2670 REFERENCE 2671 "RFC cccc, Section 11.12.5, ISID" 2672 ::= { iscsiSessionAttributesEntry 7 } 2674 iscsiSsnInitiatorAlias OBJECT-TYPE 2675 SYNTAX SnmpAdminString 2676 MAX-ACCESS read-only 2677 STATUS current 2678 DESCRIPTION 2679 "A UTF-8 string that gives the alias communicated by the 2680 initiator end of the session during the login phase. 2682 If no alias exists, the value is a zero-length string." 2683 REFERENCE 2684 "RFC cccc, Section 13.7, InitiatorAlias" 2685 ::= { iscsiSessionAttributesEntry 8 } 2687 iscsiSsnTargetAlias OBJECT-TYPE 2688 SYNTAX SnmpAdminString 2689 MAX-ACCESS read-only 2690 STATUS current 2691 DESCRIPTION 2692 "A UTF-8 string that gives the alias communicated by the 2693 target end of the session during the login phase. 2695 If no alias exists, the value is a zero-length string." 2696 REFERENCE 2697 "RFC cccc, Section 13.6, TargetAlias" 2698 ::= { iscsiSessionAttributesEntry 9 } 2700 iscsiSsnInitialR2T OBJECT-TYPE 2701 SYNTAX TruthValue 2702 MAX-ACCESS read-only 2703 STATUS current 2704 DESCRIPTION 2705 "If set to true, indicates that the initiator must wait 2706 for an R2T before sending to the target. If set to false, 2707 the initiator may send data immediately, within limits set 2708 by iscsiSsnFirstBurstLength and the expected data transfer 2709 length of the request." 2710 REFERENCE 2711 "RFC cccc, Section 13.10, InitialR2T" 2712 ::= { iscsiSessionAttributesEntry 10 } 2714 iscsiSsnImmediateData OBJECT-TYPE 2715 SYNTAX TruthValue 2716 MAX-ACCESS read-only 2717 STATUS current 2718 DESCRIPTION 2719 "Indicates whether the initiator and target have agreed to 2720 support immediate data on this session." 2721 REFERENCE 2722 "RFC cccc, Section 13.11, ImmediateData" 2723 ::= { iscsiSessionAttributesEntry 11 } 2724 iscsiSsnType OBJECT-TYPE 2725 SYNTAX INTEGER { 2726 normalSession(1), 2727 discoverySession(2) 2728 } 2729 MAX-ACCESS read-only 2730 STATUS current 2731 DESCRIPTION 2732 "Type of iSCSI session: 2733 normalSession - session is a normal iSCSI session 2734 discoverySession - session is being used only for discovery." 2735 REFERENCE 2736 "RFC cccc, Section 13.21, SessionType" 2737 ::= { iscsiSessionAttributesEntry 12 } 2739 iscsiSsnMaxOutstandingR2T OBJECT-TYPE 2740 SYNTAX Unsigned32 (1..65535) 2741 UNITS "R2Ts" 2742 MAX-ACCESS read-only 2743 STATUS current 2744 DESCRIPTION 2745 "The maximum number of outstanding requests-to-transmit 2746 (R2Ts) per iSCSI task within this session." 2747 REFERENCE 2748 "RFC cccc, Section 13.17, MaxOutstandingR2T" 2749 ::= { iscsiSessionAttributesEntry 13 } 2751 iscsiSsnFirstBurstLength OBJECT-TYPE 2752 SYNTAX Unsigned32 (512..16777215) 2753 UNITS "bytes" 2754 MAX-ACCESS read-only 2755 STATUS current 2756 DESCRIPTION 2757 "The maximum length supported for unsolicited data sent 2758 within this session." 2759 REFERENCE 2760 "RFC cccc, Section 13.14, FirstBurstLength" 2761 ::= { iscsiSessionAttributesEntry 14 } 2763 iscsiSsnMaxBurstLength OBJECT-TYPE 2764 SYNTAX Unsigned32 (512..16777215) 2765 UNITS "bytes" 2766 MAX-ACCESS read-only 2767 STATUS current 2768 DESCRIPTION 2769 "The maximum number of bytes that can be sent within 2770 a single sequence of Data-In or Data-Out PDUs." 2771 REFERENCE 2772 "RFC cccc, Section 13.13, MaxBurstLength" 2773 ::= { iscsiSessionAttributesEntry 15 } 2775 iscsiSsnConnectionNumber OBJECT-TYPE 2776 SYNTAX Gauge32 (1..65535) 2777 UNITS "connections" 2778 MAX-ACCESS read-only 2779 STATUS current 2780 DESCRIPTION 2781 "The number of transport protocol connections that currently 2782 belong to this session." 2783 ::= { iscsiSessionAttributesEntry 16 } 2785 iscsiSsnAuthIdentity OBJECT-TYPE 2786 SYNTAX RowPointer 2787 MAX-ACCESS read-only 2788 STATUS current 2789 DESCRIPTION 2790 "This object contains a pointer to a row in the 2791 IPS-AUTH MIB module that identifies the authentication 2792 identity being used on this session, as communicated 2793 during the login phase." 2794 REFERENCE 2795 "IPS-AUTH MIB, RFC 4545, 7.3, ipsAuthInstanceAttributeEntry" 2796 ::= { iscsiSessionAttributesEntry 17 } 2798 iscsiSsnDataSequenceInOrder OBJECT-TYPE 2799 SYNTAX TruthValue 2800 MAX-ACCESS read-only 2801 STATUS current 2802 DESCRIPTION 2803 "False indicates that iSCSI data PDU sequences may 2804 be transferred in any order. True indicates that 2805 data PDU sequences must be transferred using 2806 continuously increasing offsets, except during 2807 error recovery." 2808 REFERENCE 2809 "RFC cccc, Section 13.19, DataSequenceInOrder" 2810 ::= { iscsiSessionAttributesEntry 18 } 2812 iscsiSsnDataPDUInOrder OBJECT-TYPE 2813 SYNTAX TruthValue 2814 MAX-ACCESS read-only 2815 STATUS current 2816 DESCRIPTION 2817 "False indicates that iSCSI data PDUs within sequences 2818 may be in any order. True indicates that data PDUs 2819 within sequences must be at continuously increasing 2820 addresses, with no gaps or overlay between PDUs. 2822 Default is true." 2823 REFERENCE 2824 "RFC cccc, Section 13.18, DataPDUInOrder" 2825 ::= { iscsiSessionAttributesEntry 19 } 2827 iscsiSsnErrorRecoveryLevel OBJECT-TYPE 2828 SYNTAX Unsigned32 (0..255) 2829 MAX-ACCESS read-only 2830 STATUS current 2831 DESCRIPTION 2832 "The level of error recovery negotiated between 2833 the initiator and the target. Higher numbers 2834 represent more detailed recovery schemes." 2835 REFERENCE 2836 "RFC cccc, Section 13.20, ErrorRecoveryLevel" 2837 ::= { iscsiSessionAttributesEntry 20 } 2839 iscsiSsnDiscontinuityTime OBJECT-TYPE 2840 SYNTAX TimeStamp 2841 MAX-ACCESS read-only 2842 STATUS current 2843 DESCRIPTION 2844 "The value of SysUpTime on the most recent occasion 2845 at which any one or more of this session's counters 2846 suffered a discontinuity. 2847 When a session is established, and this object is 2848 created, it is initialized to the current value 2849 of SysUpTime." 2850 ::= { iscsiSessionAttributesEntry 21 } 2852 iscsiSsnProtocolLevel OBJECT-TYPE 2853 SYNTAX Unsigned32 (0..31) 2854 MAX-ACCESS read-only 2855 STATUS current 2856 DESCRIPTION 2857 "The iSCSI protocol level negotiated for this session." 2858 REFERENCE 2859 "RFC ssss, Section 7.1.1, iSCSIProtocolLevel" 2860 -- RFC Editor: replace ssss in RFC ssss with the RFC number assigned to 2861 -- draft-ietf-storm-iscsi-sam-05 & remove this note. 2863 DEFVAL { 1 } 2864 ::= { iscsiSessionAttributesEntry 22 } 2866 iscsiSsnTaskReporting OBJECT-TYPE 2867 SYNTAX BITS { 2868 taskReportingRfc3720(0), 2869 taskReportingResponseFence(1), 2870 taskReportingFastAbort(2) 2871 } 2872 MAX-ACCESS read-only 2873 STATUS current 2874 DESCRIPTION 2875 "This key is used to negotiate the task completion reporting 2876 semantics from the SCSI target. 2878 Default value is taskReportingRfc3720." 2879 REFERENCE 2880 "RFC cccc, Section 13.23, Task Reporting" 2881 ::= { iscsiSessionAttributesEntry 23 } 2883 -- Session Stats Table 2885 iscsiSessionStatsTable OBJECT-TYPE 2886 SYNTAX SEQUENCE OF IscsiSessionStatsEntry 2887 MAX-ACCESS not-accessible 2888 STATUS current 2889 DESCRIPTION 2890 "A list of general iSCSI traffic counters for each of the 2891 sessions present on the system." 2892 ::= { iscsiSession 2 } 2894 iscsiSessionStatsEntry OBJECT-TYPE 2895 SYNTAX IscsiSessionStatsEntry 2896 MAX-ACCESS not-accessible 2897 STATUS current 2898 DESCRIPTION 2899 "An entry (row) containing general iSCSI traffic counters 2900 for a particular session." 2901 AUGMENTS { iscsiSessionAttributesEntry } 2903 ::= { iscsiSessionStatsTable 1 } 2905 IscsiSessionStatsEntry ::= SEQUENCE { 2906 iscsiSsnCmdPDUs Counter32, 2907 iscsiSsnRspPDUs Counter32, 2908 iscsiSsnTxDataOctets Counter64, 2909 iscsiSsnRxDataOctets Counter64, 2910 iscsiSsnLCTxDataOctets Counter32, 2911 iscsiSsnLCRxDataOctets Counter32 2912 } 2914 iscsiSsnCmdPDUs OBJECT-TYPE 2915 SYNTAX Counter32 2916 UNITS "PDUs" 2917 MAX-ACCESS read-only 2918 STATUS current 2919 DESCRIPTION 2920 "The count of Command PDUs transferred on this session. 2921 If this counter has suffered a discontinuity, the time of the 2922 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 2923 ::= { iscsiSessionStatsEntry 1 } 2925 iscsiSsnRspPDUs OBJECT-TYPE 2926 SYNTAX Counter32 2927 UNITS "PDUs" 2928 MAX-ACCESS read-only 2929 STATUS current 2930 DESCRIPTION 2931 "The count of Response PDUs transferred on this session. 2932 If this counter has suffered a discontinuity, the time of the 2933 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 2934 ::= { iscsiSessionStatsEntry 2 } 2936 iscsiSsnTxDataOctets OBJECT-TYPE 2937 SYNTAX Counter64 2938 UNITS "octets" 2939 MAX-ACCESS read-only 2940 STATUS current 2941 DESCRIPTION 2942 "The count of data octets that were transmitted by 2943 the local iSCSI node on this session. 2944 If this counter has suffered a discontinuity, the time of the 2945 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 2946 ::= { iscsiSessionStatsEntry 3 } 2948 iscsiSsnRxDataOctets OBJECT-TYPE 2949 SYNTAX Counter64 2950 UNITS "octets" 2951 MAX-ACCESS read-only 2952 STATUS current 2953 DESCRIPTION 2954 "The count of data octets that were received by 2955 the local iSCSI node on this session. 2956 If this counter has suffered a discontinuity, the time of the 2957 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 2958 ::= { iscsiSessionStatsEntry 4 } 2960 iscsiSsnLCTxDataOctets OBJECT-TYPE 2961 SYNTAX Counter32 2962 UNITS "octets" 2963 MAX-ACCESS read-only 2964 STATUS current 2965 DESCRIPTION 2966 "A Low Capacity shadow object of iscsiSsnTxDataOctets 2967 for those systems which are accessible via SNMPv1 only. 2969 If this counter has suffered a discontinuity, the time of the 2970 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 2971 ::= { iscsiSessionStatsEntry 5 } 2973 iscsiSsnLCRxDataOctets OBJECT-TYPE 2974 SYNTAX Counter32 2975 UNITS "octets" 2976 MAX-ACCESS read-only 2977 STATUS current 2978 DESCRIPTION 2979 "A Low Capacity shadow object of iscsiSsnRxDataOctets 2980 for those systems which are accessible via SNMPv1 only. 2981 If this counter has suffered a discontinuity, the time of the 2982 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 2983 ::= { iscsiSessionStatsEntry 6 } 2985 -- Session Connection Error Stats Table 2987 iscsiSessionCxnErrorStatsTable OBJECT-TYPE 2988 SYNTAX SEQUENCE OF IscsiSessionCxnErrorStatsEntry 2989 MAX-ACCESS not-accessible 2990 STATUS current 2991 DESCRIPTION 2992 "A list of error counters for each of the sessions 2993 present on this system." 2994 ::= { iscsiSession 3 } 2996 iscsiSessionCxnErrorStatsEntry OBJECT-TYPE 2997 SYNTAX IscsiSessionCxnErrorStatsEntry 2998 MAX-ACCESS not-accessible 2999 STATUS current 3000 DESCRIPTION 3001 "An entry (row) containing error counters for 3002 a particular session." 3003 AUGMENTS { iscsiSessionAttributesEntry } 3004 ::= { iscsiSessionCxnErrorStatsTable 1 } 3006 IscsiSessionCxnErrorStatsEntry ::= SEQUENCE { 3007 iscsiSsnCxnDigestErrors Counter32, 3008 iscsiSsnCxnTimeoutErrors Counter32 3009 } 3011 iscsiSsnCxnDigestErrors OBJECT-TYPE 3012 SYNTAX Counter32 3013 UNITS "PDUs" 3014 MAX-ACCESS read-only 3015 STATUS current 3016 DESCRIPTION 3017 "The count of PDUs that were received on the session and 3018 contained header or data digest errors. 3019 If this counter has suffered a discontinuity, the time of the 3020 last discontinuity is indicated in iscsiSsnDiscontinuityTime. 3021 This counter is most likely provided when the error-recovery- 3022 level is 1 or 2" 3023 REFERENCE 3024 "RFC cccc, Section 7.8, Digest Errors" 3025 ::= { iscsiSessionCxnErrorStatsEntry 1 } 3027 iscsiSsnCxnTimeoutErrors OBJECT-TYPE 3028 SYNTAX Counter32 3029 UNITS "connections" 3030 MAX-ACCESS read-only 3031 STATUS current 3032 DESCRIPTION 3033 "The count of connections within this session 3034 that have been terminated due to timeout. 3035 If this counter has suffered a discontinuity, the time of the 3036 last discontinuity is indicated in iscsiSsnDiscontinuityTime. 3037 This counter is most likely provided when the error-recovery- 3038 level is 2" 3039 REFERENCE 3040 "RFC cccc, Section 7.5, Connection Timeout Management" 3041 ::= { iscsiSessionCxnErrorStatsEntry 2 } 3043 --********************************************************************** 3045 iscsiConnection OBJECT IDENTIFIER ::= { iscsiObjects 11 } 3047 -- Connection Attributes Table 3049 iscsiConnectionAttributesTable OBJECT-TYPE 3050 SYNTAX SEQUENCE OF IscsiConnectionAttributesEntry 3051 MAX-ACCESS not-accessible 3052 STATUS current 3053 DESCRIPTION 3054 "A list of connections belonging to each iSCSI instance 3055 present on the system." 3056 ::= { iscsiConnection 1 } 3058 iscsiConnectionAttributesEntry OBJECT-TYPE 3059 SYNTAX IscsiConnectionAttributesEntry 3060 MAX-ACCESS not-accessible 3061 STATUS current 3062 DESCRIPTION 3063 "An entry (row) containing management information applicable 3064 to a particular connection." 3065 INDEX { iscsiInstIndex, iscsiSsnNodeIndex, iscsiSsnIndex, 3066 iscsiCxnIndex } 3068 ::= { iscsiConnectionAttributesTable 1 } 3070 IscsiConnectionAttributesEntry ::= SEQUENCE { 3071 iscsiCxnIndex Unsigned32, 3072 iscsiCxnCid Unsigned32, 3073 iscsiCxnState INTEGER, 3074 iscsiCxnAddrType InetAddressType, 3075 iscsiCxnLocalAddr InetAddress, 3076 iscsiCxnProtocol IscsiTransportProtocol, 3077 iscsiCxnLocalPort InetPortNumber, 3078 iscsiCxnRemoteAddr InetAddress, 3079 iscsiCxnRemotePort InetPortNumber, 3080 iscsiCxnMaxRecvDataSegLength Unsigned32, 3081 iscsiCxnMaxXmitDataSegLength Unsigned32, 3082 iscsiCxnHeaderIntegrity IscsiDigestMethod, 3083 iscsiCxnDataIntegrity IscsiDigestMethod, 3084 iscsiCxnRecvMarker TruthValue, 3085 iscsiCxnSendMarker TruthValue, 3086 iscsiCxnVersionActive Unsigned32 3087 } 3089 iscsiCxnIndex OBJECT-TYPE 3090 SYNTAX Unsigned32 (1..4294967295) 3091 MAX-ACCESS not-accessible 3092 STATUS current 3093 DESCRIPTION 3094 "An arbitrary integer used to uniquely identify a 3095 particular connection of a particular session within 3096 an iSCSI instance present on the local system. An 3097 agent should attempt to not reuse index values unless 3098 a reboot has occurred. iSCSI connections are destroyed 3099 during a reboot; rows in this table are not persistent 3100 across reboots." 3102 ::= { iscsiConnectionAttributesEntry 1 } 3104 iscsiCxnCid OBJECT-TYPE 3105 SYNTAX Unsigned32 (1..65535) 3106 MAX-ACCESS read-only 3107 STATUS current 3108 DESCRIPTION 3109 "The iSCSI Connection ID for this connection." 3110 ::= { iscsiConnectionAttributesEntry 2 } 3112 iscsiCxnState OBJECT-TYPE 3113 SYNTAX INTEGER { 3114 login(1), 3115 full(2), 3116 logout(3) 3118 } 3119 MAX-ACCESS read-only 3120 STATUS current 3121 DESCRIPTION 3122 "The current state of this connection, from an iSCSI negotiation 3123 point of view. Here are the states: 3125 login - The transport protocol connection has been established, 3126 but a valid iSCSI login response with the final bit set 3127 has not been sent or received. 3128 full - A valid iSCSI login response with the final bit set 3129 has been sent or received. 3130 logout - A valid iSCSI logout command has been sent or 3131 received, but the transport protocol connection has 3132 not yet been closed." 3133 ::= { iscsiConnectionAttributesEntry 3 } 3135 iscsiCxnAddrType OBJECT-TYPE 3136 SYNTAX InetAddressType 3137 MAX-ACCESS read-only 3138 STATUS current 3139 DESCRIPTION 3140 "The type of Internet Network Addresses contained in the 3141 corresponding instances of iscsiCxnLocalAddr and 3142 iscsiCxnRemoteAddr. 3143 The value 'dns' is not allowed." 3144 ::= { iscsiConnectionAttributesEntry 4 } 3146 iscsiCxnLocalAddr OBJECT-TYPE 3147 SYNTAX InetAddress 3148 MAX-ACCESS read-only 3149 STATUS current 3150 DESCRIPTION 3151 "The local Internet Network Address, of the type specified 3152 by iscsiCxnAddrType, used by this connection." 3153 ::= { iscsiConnectionAttributesEntry 5 } 3155 iscsiCxnProtocol OBJECT-TYPE 3156 SYNTAX IscsiTransportProtocol 3157 MAX-ACCESS read-only 3158 STATUS current 3159 DESCRIPTION 3160 "The transport protocol over which this connection is 3161 running." 3162 ::= { iscsiConnectionAttributesEntry 6 } 3164 iscsiCxnLocalPort OBJECT-TYPE 3165 SYNTAX InetPortNumber 3166 MAX-ACCESS read-only 3167 STATUS current 3168 DESCRIPTION 3169 "The local transport protocol port used by this connection. 3170 This object cannot have the value zero, since it represents 3171 an established connection." 3172 ::= { iscsiConnectionAttributesEntry 7 } 3174 iscsiCxnRemoteAddr OBJECT-TYPE 3175 SYNTAX InetAddress 3176 MAX-ACCESS read-only 3177 STATUS current 3178 DESCRIPTION 3179 "The remote Internet Network Address, of the type specified 3180 by iscsiCxnAddrType, used by this connection." 3181 ::= { iscsiConnectionAttributesEntry 8 } 3183 iscsiCxnRemotePort OBJECT-TYPE 3184 SYNTAX InetPortNumber 3185 MAX-ACCESS read-only 3186 STATUS current 3187 DESCRIPTION 3188 "The remote transport protocol port used by this connection. 3189 This object cannot have the value zero, since it represents 3190 an established connection." 3191 ::= { iscsiConnectionAttributesEntry 9 } 3193 iscsiCxnMaxRecvDataSegLength OBJECT-TYPE 3194 SYNTAX Unsigned32 (512..16777215) 3195 UNITS "bytes" 3196 MAX-ACCESS read-only 3197 STATUS current 3198 DESCRIPTION 3199 "The maximum data payload size supported for command 3200 or data PDUs able to be received on this connection." 3201 REFERENCE 3202 "RFC cccc, Section 13.12, MaxRecvDataSegmentLength" 3203 ::= { iscsiConnectionAttributesEntry 10 } 3205 iscsiCxnMaxXmitDataSegLength OBJECT-TYPE 3206 SYNTAX Unsigned32 (512..16777215) 3207 UNITS "bytes" 3208 MAX-ACCESS read-only 3209 STATUS current 3210 DESCRIPTION 3211 "The maximum data payload size supported for command 3212 or data PDUs to be sent on this connection." 3213 REFERENCE 3214 "RFC cccc, Section 13.12, MaxRecvDataSegmentLength" 3215 ::= { iscsiConnectionAttributesEntry 11 } 3216 iscsiCxnHeaderIntegrity OBJECT-TYPE 3217 SYNTAX IscsiDigestMethod 3218 MAX-ACCESS read-only 3219 STATUS current 3220 DESCRIPTION 3221 "This object identifies the iSCSI header 3222 digest scheme in use within this connection." 3223 ::= { iscsiConnectionAttributesEntry 12 } 3225 iscsiCxnDataIntegrity OBJECT-TYPE 3226 SYNTAX IscsiDigestMethod 3227 MAX-ACCESS read-only 3228 STATUS current 3229 DESCRIPTION 3230 "This object identifies the iSCSI data 3231 digest scheme in use within this connection." 3232 ::= { iscsiConnectionAttributesEntry 13 } 3234 iscsiCxnRecvMarker OBJECT-TYPE 3235 SYNTAX TruthValue 3236 MAX-ACCESS read-only 3237 STATUS deprecated 3238 DESCRIPTION 3239 "This object indicates whether or not this connection 3240 is receiving markers in its incoming data stream." 3241 REFERENCE 3242 "[RFCcccc], 13.25 Obsoleted Keys." 3243 ::= { iscsiConnectionAttributesEntry 14 } 3245 iscsiCxnSendMarker OBJECT-TYPE 3246 SYNTAX TruthValue 3247 MAX-ACCESS read-only 3248 STATUS deprecated 3249 DESCRIPTION 3250 "This object indicates whether or not this connection 3251 is inserting markers in its outgoing data stream." 3252 REFERENCE 3253 "[RFCcccc], 13.25 Obsoleted Keys." 3254 ::= { iscsiConnectionAttributesEntry 15 } 3256 iscsiCxnVersionActive OBJECT-TYPE 3257 SYNTAX Unsigned32 (0..255) 3258 MAX-ACCESS read-only 3259 STATUS current 3260 DESCRIPTION 3261 "Active version number of the iSCSI specification negotiated 3262 on this connection." 3263 REFERENCE 3264 "RFC cccc, Section 11.12, Login Request" 3265 ::= { iscsiConnectionAttributesEntry 16 } 3267 --********************************************************************** 3268 -- Notifications 3270 iscsiTgtLoginFailure NOTIFICATION-TYPE 3271 OBJECTS { 3272 iscsiTgtLoginFailures, 3273 iscsiTgtLastFailureType, 3274 iscsiTgtLastIntrFailureName, 3275 iscsiTgtLastIntrFailureAddrType, 3276 iscsiTgtLastIntrFailureAddr 3277 } 3278 STATUS current 3279 DESCRIPTION 3280 "Sent when a login is failed by a target. 3282 To avoid sending an excessive number of notifications due 3283 to multiple errors counted, an SNMP agent implementing this 3284 notification SHOULD NOT send more than 3 notifications of 3285 this type in any 10-second time period." 3286 ::= { iscsiNotifications 1 } 3288 iscsiIntrLoginFailure NOTIFICATION-TYPE 3289 OBJECTS { 3290 iscsiIntrLoginFailures, 3291 iscsiIntrLastFailureType, 3292 iscsiIntrLastTgtFailureName, 3293 iscsiIntrLastTgtFailureAddrType, 3294 iscsiIntrLastTgtFailureAddr 3295 } 3296 STATUS current 3297 DESCRIPTION 3298 "Sent when a login is failed by an initiator. 3300 To avoid sending an excessive number of notifications due 3301 to multiple errors counted, an SNMP agent implementing this 3302 notification SHOULD NOT send more than 3 notifications of 3303 this type in any 10-second time period." 3304 ::= { iscsiNotifications 2 } 3306 iscsiInstSessionFailure NOTIFICATION-TYPE 3307 OBJECTS { 3308 iscsiInstSsnFailures, 3309 iscsiInstLastSsnFailureType, 3310 iscsiInstLastSsnRmtNodeName 3311 } 3312 STATUS current 3313 DESCRIPTION 3314 "Sent when an active session is failed by either the initiator 3315 or the target. 3317 To avoid sending an excessive number of notifications due 3318 to multiple errors counted, an SNMP agent implementing this 3319 notification SHOULD NOT send more than 3 notifications of 3320 this type in any 10-second time period." 3321 ::= { iscsiNotifications 3 } 3323 --********************************************************************** 3325 -- Conformance Statements 3327 iscsiCompliances OBJECT IDENTIFIER ::= { iscsiConformance 1 } 3328 iscsiGroups OBJECT IDENTIFIER ::= { iscsiConformance 2 } 3330 iscsiInstanceAttributesGroup OBJECT-GROUP 3331 OBJECTS { 3332 iscsiInstDescr, 3333 iscsiInstVersionMin, 3334 iscsiInstVersionMax, 3335 iscsiInstVendorID, 3336 iscsiInstVendorVersion, 3337 iscsiInstPortalNumber, 3338 iscsiInstNodeNumber, 3339 iscsiInstSessionNumber, 3340 iscsiInstSsnFailures, 3341 iscsiInstLastSsnFailureType, 3342 iscsiInstLastSsnRmtNodeName, 3343 iscsiInstDiscontinuityTime, 3344 iscsiInstXNodeArchitecture 3345 } 3346 STATUS current 3347 DESCRIPTION 3348 "A collection of objects providing information about iSCSI 3349 instances." 3350 ::= { iscsiGroups 1 } 3352 iscsiInstanceSsnErrorStatsGroup OBJECT-GROUP 3353 OBJECTS { 3354 iscsiInstSsnDigestErrors, 3355 iscsiInstSsnCxnTimeoutErrors, 3356 iscsiInstSsnFormatErrors 3357 } 3358 STATUS current 3359 DESCRIPTION 3360 "A collection of objects providing information about 3361 errors that have caused a session failure for an 3362 iSCSI instance." 3363 ::= { iscsiGroups 2 } 3365 iscsiPortalAttributesGroup OBJECT-GROUP 3366 OBJECTS { 3367 iscsiPortalRowStatus, 3368 iscsiPortalStorageType, 3369 iscsiPortalRoles, 3370 iscsiPortalAddrType, 3371 iscsiPortalAddr, 3372 iscsiPortalProtocol, 3373 iscsiPortalMaxRecvDataSegLength, 3374 iscsiPortalPrimaryHdrDigest, 3375 iscsiPortalPrimaryDataDigest, 3376 iscsiPortalSecondaryHdrDigest, 3377 iscsiPortalSecondaryDataDigest, 3378 iscsiPortalRecvMarker 3379 } 3380 STATUS deprecated 3381 DESCRIPTION 3382 "A collection of objects providing information about 3383 the transport protocol endpoints of the local targets. 3384 This object group is deprecated because the marker key 3385 is obsolete." 3386 REFERENCE 3387 "[RFCcccc], 13.25 Obsoleted Keys." 3388 ::= { iscsiGroups 3 } 3390 iscsiTgtPortalAttributesGroup OBJECT-GROUP 3391 OBJECTS { 3392 iscsiTgtPortalPort, 3393 iscsiTgtPortalTag 3394 } 3395 STATUS current 3396 DESCRIPTION 3397 "A collection of objects providing information about 3398 the transport protocol endpoints of the local targets." 3399 ::= { iscsiGroups 4 } 3401 iscsiIntrPortalAttributesGroup OBJECT-GROUP 3402 OBJECTS { 3403 iscsiIntrPortalTag 3404 } 3405 STATUS current 3406 DESCRIPTION 3407 "An object providing information about 3408 the portal tags used by the local initiators." 3409 ::= { iscsiGroups 5 } 3410 iscsiNodeAttributesGroup OBJECT-GROUP 3411 OBJECTS { 3412 iscsiNodeName, 3413 iscsiNodeAlias, 3414 iscsiNodeRoles, 3415 iscsiNodeTransportType, 3416 iscsiNodeInitialR2T, 3417 iscsiNodeImmediateData, 3418 iscsiNodeMaxOutstandingR2T, 3419 iscsiNodeFirstBurstLength, 3420 iscsiNodeMaxBurstLength, 3421 iscsiNodeMaxConnections, 3422 iscsiNodeDataSequenceInOrder, 3423 iscsiNodeDataPDUInOrder, 3424 iscsiNodeDefaultTime2Wait, 3425 iscsiNodeDefaultTime2Retain, 3426 iscsiNodeErrorRecoveryLevel, 3427 iscsiNodeDiscontinuityTime, 3428 iscsiNodeStorageType 3429 } 3430 STATUS current 3431 DESCRIPTION 3432 "A collection of objects providing information about all 3433 local targets." 3434 ::= { iscsiGroups 6 } 3436 iscsiTargetAttributesGroup OBJECT-GROUP 3437 OBJECTS { 3438 iscsiTgtLoginFailures, 3439 iscsiTgtLastFailureTime, 3440 iscsiTgtLastFailureType, 3441 iscsiTgtLastIntrFailureName, 3442 iscsiTgtLastIntrFailureAddrType, 3443 iscsiTgtLastIntrFailureAddr 3444 } 3445 STATUS current 3446 DESCRIPTION 3447 "A collection of objects providing information about all 3448 local targets." 3449 ::= { iscsiGroups 7 } 3451 iscsiTargetLoginStatsGroup OBJECT-GROUP 3452 OBJECTS { 3453 iscsiTgtLoginAccepts, 3454 iscsiTgtLoginOtherFails, 3455 iscsiTgtLoginRedirects, 3456 iscsiTgtLoginAuthorizeFails, 3457 iscsiTgtLoginAuthenticateFails, 3458 iscsiTgtLoginNegotiateFails 3460 } 3461 STATUS current 3462 DESCRIPTION 3463 "A collection of objects providing information about all 3464 login attempts by remote initiators to local targets." 3465 ::= { iscsiGroups 8 } 3467 iscsiTargetLogoutStatsGroup OBJECT-GROUP 3468 OBJECTS { 3469 iscsiTgtLogoutNormals, 3470 iscsiTgtLogoutOthers 3471 } 3472 STATUS current 3473 DESCRIPTION 3474 "A collection of objects providing information about all 3475 logout events between remote initiators and local targets." 3476 ::= { iscsiGroups 9 } 3478 iscsiTargetAuthGroup OBJECT-GROUP 3479 OBJECTS { 3480 iscsiTgtAuthRowStatus, 3481 iscsiTgtAuthStorageType, 3482 iscsiTgtAuthIdentity 3483 } 3484 STATUS current 3485 DESCRIPTION 3486 "A collection of objects providing information about all 3487 remote initiators that are authorized to connect to local 3488 targets." 3489 ::= { iscsiGroups 10 } 3491 iscsiInitiatorAttributesGroup OBJECT-GROUP 3492 OBJECTS { 3493 iscsiIntrLoginFailures, 3494 iscsiIntrLastFailureTime, 3495 iscsiIntrLastFailureType, 3496 iscsiIntrLastTgtFailureName, 3497 iscsiIntrLastTgtFailureAddrType, 3498 iscsiIntrLastTgtFailureAddr 3499 } 3500 STATUS current 3501 DESCRIPTION 3502 "A collection of objects providing information about 3503 all local initiators." 3504 ::= { iscsiGroups 11 } 3506 iscsiInitiatorLoginStatsGroup OBJECT-GROUP 3507 OBJECTS { 3508 iscsiIntrLoginAcceptRsps, 3509 iscsiIntrLoginOtherFailRsps, 3510 iscsiIntrLoginRedirectRsps, 3511 iscsiIntrLoginAuthFailRsps, 3512 iscsiIntrLoginAuthenticateFails, 3513 iscsiIntrLoginNegotiateFails, 3514 iscsiIntrLoginAuthorizeFails 3515 } 3516 STATUS current 3517 DESCRIPTION 3518 "A collection of objects providing information about all 3519 login attempts by local initiators to remote targets." 3520 ::= { iscsiGroups 12 } 3522 iscsiInitiatorLogoutStatsGroup OBJECT-GROUP 3523 OBJECTS { 3524 iscsiIntrLogoutNormals, 3525 iscsiIntrLogoutOthers 3526 } 3527 STATUS current 3528 DESCRIPTION 3529 "A collection of objects providing information about all 3530 logout events between local initiators and remote targets." 3531 ::= { iscsiGroups 13 } 3533 iscsiInitiatorAuthGroup OBJECT-GROUP 3534 OBJECTS { 3535 iscsiIntrAuthRowStatus, 3536 iscsiIntrAuthStorageType, 3537 iscsiIntrAuthIdentity 3538 } 3539 STATUS current 3540 DESCRIPTION 3541 "A collection of objects providing information about all 3542 remote targets that are initiators of the local system 3543 that they are authorized to access." 3544 ::= { iscsiGroups 14 } 3546 iscsiSessionAttributesGroup OBJECT-GROUP 3547 OBJECTS { 3548 iscsiSsnDirection, 3549 iscsiSsnInitiatorName, 3550 iscsiSsnTargetName, 3551 iscsiSsnTSIH, 3552 iscsiSsnISID, 3553 iscsiSsnInitiatorAlias, 3554 iscsiSsnTargetAlias, 3555 iscsiSsnInitialR2T, 3556 iscsiSsnImmediateData, 3557 iscsiSsnType, 3558 iscsiSsnMaxOutstandingR2T, 3559 iscsiSsnFirstBurstLength, 3560 iscsiSsnMaxBurstLength, 3561 iscsiSsnConnectionNumber, 3562 iscsiSsnAuthIdentity, 3563 iscsiSsnDataSequenceInOrder, 3564 iscsiSsnDataPDUInOrder, 3565 iscsiSsnErrorRecoveryLevel, 3566 iscsiSsnDiscontinuityTime, 3567 iscsiSsnProtocolLevel, 3568 iscsiSsnTaskReporting 3569 } 3570 STATUS current 3571 DESCRIPTION 3572 "A collection of objects providing information applicable to 3573 all sessions." 3574 ::= { iscsiGroups 15 } 3576 iscsiSessionPDUStatsGroup OBJECT-GROUP 3577 OBJECTS { 3578 iscsiSsnCmdPDUs, 3579 iscsiSsnRspPDUs 3580 } 3581 STATUS current 3582 DESCRIPTION 3583 "A collection of objects providing information about PDU 3584 traffic for each session." 3585 ::= { iscsiGroups 16 } 3587 iscsiSessionOctetStatsGroup OBJECT-GROUP 3588 OBJECTS { 3589 iscsiSsnTxDataOctets, 3590 iscsiSsnRxDataOctets 3591 } 3592 STATUS current 3593 DESCRIPTION 3594 "A collection of objects providing information about octet 3595 traffic for each session using a Counter64 data type." 3596 ::= { iscsiGroups 17 } 3598 iscsiSessionLCOctetStatsGroup OBJECT-GROUP 3599 OBJECTS { 3600 iscsiSsnLCTxDataOctets, 3601 iscsiSsnLCRxDataOctets 3602 } 3603 STATUS current 3604 DESCRIPTION 3605 "A collection of objects providing information about octet 3606 traffic for each session using a Counter32 data type." 3608 ::= { iscsiGroups 18 } 3610 iscsiSessionCxnErrorStatsGroup OBJECT-GROUP 3611 OBJECTS { 3612 iscsiSsnCxnDigestErrors, 3613 iscsiSsnCxnTimeoutErrors 3614 } 3615 STATUS current 3616 DESCRIPTION 3617 "A collection of objects providing information about connection 3618 errors for all sessions." 3619 ::= { iscsiGroups 19 } 3621 iscsiConnectionAttributesGroup OBJECT-GROUP 3622 OBJECTS { 3623 iscsiCxnCid, 3624 iscsiCxnState, 3625 iscsiCxnProtocol, 3626 iscsiCxnAddrType, 3627 iscsiCxnLocalAddr, 3628 iscsiCxnLocalPort, 3629 iscsiCxnRemoteAddr, 3630 iscsiCxnRemotePort, 3631 iscsiCxnMaxRecvDataSegLength, 3632 iscsiCxnMaxXmitDataSegLength, 3633 iscsiCxnHeaderIntegrity, 3634 iscsiCxnDataIntegrity, 3635 iscsiCxnRecvMarker, 3636 iscsiCxnSendMarker, 3637 iscsiCxnVersionActive 3638 } 3639 STATUS deprecated 3640 DESCRIPTION 3641 "A collection of objects providing information about all 3642 connections used by all sessions. 3643 This object group is deprecated because the marker key 3644 is obsolete." 3645 REFERENCE 3646 "[RFCcccc], 13.25 Obsoleted Keys." 3647 ::= { iscsiGroups 20 } 3649 iscsiTgtLgnNotificationsGroup NOTIFICATION-GROUP 3650 NOTIFICATIONS { 3651 iscsiTgtLoginFailure 3652 } 3653 STATUS current 3654 DESCRIPTION 3655 "A collection of notifications that indicate a login 3656 failure from a remote initiator to a local target." 3658 ::= { iscsiGroups 21 } 3660 iscsiIntrLgnNotificationsGroup NOTIFICATION-GROUP 3661 NOTIFICATIONS { 3662 iscsiIntrLoginFailure 3663 } 3664 STATUS current 3665 DESCRIPTION 3666 "A collection of notifications that indicate a login 3667 failure from a local initiator to a remote target." 3668 ::= { iscsiGroups 22 } 3670 iscsiSsnFlrNotificationsGroup NOTIFICATION-GROUP 3671 NOTIFICATIONS { 3672 iscsiInstSessionFailure 3673 } 3674 STATUS current 3675 DESCRIPTION 3676 "A collection of notifications that indicate session 3677 failures occurring after login." 3678 ::= { iscsiGroups 23 } 3680 iscsiPortalAttributesGroupV2 OBJECT-GROUP 3681 OBJECTS { 3682 iscsiPortalRowStatus, 3683 iscsiPortalStorageType, 3684 iscsiPortalRoles, 3685 iscsiPortalAddrType, 3686 iscsiPortalAddr, 3687 iscsiPortalProtocol, 3688 iscsiPortalMaxRecvDataSegLength, 3689 iscsiPortalPrimaryHdrDigest, 3690 iscsiPortalPrimaryDataDigest, 3691 iscsiPortalSecondaryHdrDigest, 3692 iscsiPortalSecondaryDataDigest 3693 } 3694 STATUS current 3695 DESCRIPTION 3696 "A collection of objects providing information about 3697 the transport protocol endpoints of the local targets." 3698 ::= { iscsiGroups 24 } 3700 iscsiConnectionAttributesGroupV2 OBJECT-GROUP 3701 OBJECTS { 3702 iscsiCxnCid, 3703 iscsiCxnState, 3704 iscsiCxnProtocol, 3705 iscsiCxnAddrType, 3706 iscsiCxnLocalAddr, 3707 iscsiCxnLocalPort, 3708 iscsiCxnRemoteAddr, 3709 iscsiCxnRemotePort, 3710 iscsiCxnMaxRecvDataSegLength, 3711 iscsiCxnMaxXmitDataSegLength, 3712 iscsiCxnHeaderIntegrity, 3713 iscsiCxnDataIntegrity, 3714 iscsiCxnVersionActive 3715 } 3717 STATUS current 3718 DESCRIPTION 3719 "A collection of objects providing information about all 3720 connections used by all sessions." 3721 ::= { iscsiGroups 25 } 3723 --********************************************************************** 3725 iscsiComplianceV1 MODULE-COMPLIANCE 3726 STATUS deprecated 3727 DESCRIPTION 3728 "Initial version of compliance statement. 3730 If an implementation can be both a target and an 3731 initiator, all groups are mandatory. 3732 This module compliance is deprecated because the 3733 marker keys are obsolete." 3734 REFERENCE 3735 "[RFCcccc], 13.25 Obsoleted Keys." 3736 MODULE -- this module 3737 MANDATORY-GROUPS { 3738 iscsiInstanceAttributesGroup, 3739 iscsiInstanceSsnErrorStatsGroup, 3740 iscsiPortalAttributesGroup, 3741 iscsiNodeAttributesGroup, 3742 iscsiSessionAttributesGroup, 3743 iscsiSessionPDUStatsGroup, 3744 iscsiSessionCxnErrorStatsGroup, 3745 iscsiConnectionAttributesGroup, 3746 iscsiSsnFlrNotificationsGroup 3747 } 3749 -- Conditionally mandatory groups depending on the ability 3750 -- to support Counter64 data types and/or to provide counter 3751 -- information to SNMPv1 applications. 3753 GROUP iscsiSessionOctetStatsGroup 3754 DESCRIPTION 3755 "This group is mandatory for all iSCSI implementations 3756 that can support Counter64 data types." 3758 GROUP iscsiSessionLCOctetStatsGroup 3759 DESCRIPTION 3760 "This group is mandatory for all iSCSI implementations 3761 that provide information to SNMPv1-only applications; 3762 this includes agents that cannot support Counter64 3763 data types." 3765 -- Conditionally mandatory groups to be included with 3766 -- the mandatory groups when the implementation has 3767 -- iSCSI target facilities. 3769 GROUP iscsiTgtPortalAttributesGroup 3770 DESCRIPTION 3771 "This group is mandatory for all iSCSI implementations 3772 that have iSCSI target facilities." 3774 OBJECT iscsiPortalMaxRecvDataSegLength 3775 MIN-ACCESS read-only 3776 DESCRIPTION 3777 "Write access is not required." 3779 OBJECT iscsiNodeStorageType 3780 MIN-ACCESS read-only 3781 DESCRIPTION 3782 "Write access is not required; an implementation may 3783 choose to allow this object to be set to 'volatile' 3784 or 'nonVolatile'." 3785 GROUP iscsiTargetAttributesGroup 3786 DESCRIPTION 3787 "This group is mandatory for all iSCSI implementations 3788 that have iSCSI target facilities." 3790 GROUP iscsiTargetLoginStatsGroup 3791 DESCRIPTION 3792 "This group is mandatory for all iSCSI implementations 3793 that have iSCSI target facilities." 3795 GROUP iscsiTargetLogoutStatsGroup 3796 DESCRIPTION 3797 "This group is mandatory for all iSCSI implementations 3798 that have iSCSI target facilities." 3800 GROUP iscsiTgtLgnNotificationsGroup 3801 DESCRIPTION 3802 "This group is mandatory for all iSCSI implementations 3803 that have iSCSI target facilities." 3805 GROUP iscsiTargetAuthGroup 3806 DESCRIPTION 3807 "This group is mandatory for all iSCSI implementations 3808 that have iSCSI target facilities." 3810 -- Conditionally mandatory groups to be included with 3811 -- the mandatory groups when the implementation has 3812 -- iSCSI initiator facilities. 3814 GROUP iscsiIntrPortalAttributesGroup 3815 DESCRIPTION 3816 "This group is mandatory for all iSCSI implementations 3817 that have iSCSI initiator facilities." 3819 GROUP iscsiInitiatorAttributesGroup 3820 DESCRIPTION 3821 "This group is mandatory for all iSCSI implementations 3822 that have iSCSI initiator facilities." 3824 GROUP iscsiInitiatorLoginStatsGroup 3825 DESCRIPTION 3826 "This group is mandatory for all iSCSI implementations 3827 that have iSCSI initiator facilities." 3829 GROUP iscsiInitiatorLogoutStatsGroup 3830 DESCRIPTION 3831 "This group is mandatory for all iSCSI implementations 3832 that have iSCSI initiator facilities." 3834 GROUP iscsiIntrLgnNotificationsGroup 3835 DESCRIPTION 3836 "This group is mandatory for all iSCSI implementations 3837 that have iSCSI initiator facilities." 3839 GROUP iscsiInitiatorAuthGroup 3840 DESCRIPTION 3841 "This group is mandatory for all iSCSI implementations 3842 that have iSCSI initiator facilities." 3844 OBJECT iscsiNodeErrorRecoveryLevel 3845 SYNTAX Unsigned32 (0..2) 3846 DESCRIPTION 3847 "Only values 0-2 are defined at present." 3849 ::= { iscsiCompliances 1 } 3851 iscsiComplianceV2 MODULE-COMPLIANCE 3852 STATUS current 3853 DESCRIPTION 3854 "Version 2 of compliance statement based on 3855 this revised version of the MIB module. 3857 If an implementation can be both a target and an 3858 initiator, all groups are mandatory." 3859 MODULE -- this module 3860 MANDATORY-GROUPS { 3861 iscsiInstanceAttributesGroup, 3862 iscsiInstanceSsnErrorStatsGroup, 3863 iscsiPortalAttributesGroupV2, 3864 iscsiNodeAttributesGroup, 3865 iscsiSessionAttributesGroup, 3866 iscsiSessionPDUStatsGroup, 3867 iscsiSessionCxnErrorStatsGroup, 3868 iscsiConnectionAttributesGroupV2, 3869 iscsiSsnFlrNotificationsGroup 3870 } 3872 -- Conditionally mandatory groups depending on the ability 3873 -- to support Counter64 data types and/or to provide counter 3874 -- information to SNMPv1 applications. 3876 GROUP iscsiSessionOctetStatsGroup 3877 DESCRIPTION 3878 "This group is mandatory for all iSCSI implementations 3879 that can support Counter64 data types." 3881 GROUP iscsiSessionLCOctetStatsGroup 3882 DESCRIPTION 3883 "This group is mandatory for all iSCSI implementations 3884 that provide information to SNMPv1-only applications; 3885 this includes agents that cannot support Counter64 3886 data types." 3888 -- Conditionally mandatory groups to be included with 3889 -- the mandatory groups when the implementation has 3890 -- iSCSI target facilities. 3892 GROUP iscsiTgtPortalAttributesGroup 3893 DESCRIPTION 3894 "This group is mandatory for all iSCSI implementations 3895 that have iSCSI target facilities." 3897 OBJECT iscsiPortalMaxRecvDataSegLength 3898 MIN-ACCESS read-only 3899 DESCRIPTION 3900 "Write access is not required." 3902 OBJECT iscsiNodeStorageType 3903 MIN-ACCESS read-only 3904 DESCRIPTION 3905 "Write access is not required; an implementation may 3906 choose to allow this object to be set to 'volatile' 3907 or 'nonVolatile'." 3909 GROUP iscsiTargetAttributesGroup 3910 DESCRIPTION 3911 "This group is mandatory for all iSCSI implementations 3912 that have iSCSI target facilities." 3914 GROUP iscsiTargetLoginStatsGroup 3915 DESCRIPTION 3916 "This group is mandatory for all iSCSI implementations 3917 that have iSCSI target facilities." 3919 GROUP iscsiTargetLogoutStatsGroup 3920 DESCRIPTION 3921 "This group is mandatory for all iSCSI implementations 3922 that have iSCSI target facilities." 3924 GROUP iscsiTgtLgnNotificationsGroup 3925 DESCRIPTION 3926 "This group is mandatory for all iSCSI implementations 3927 that have iSCSI target facilities." 3929 GROUP iscsiTargetAuthGroup 3930 DESCRIPTION 3931 "This group is mandatory for all iSCSI implementations 3932 that have iSCSI target facilities." 3934 -- Conditionally mandatory groups to be included with 3935 -- the mandatory groups when the implementation has 3936 -- iSCSI initiator facilities. 3938 GROUP iscsiIntrPortalAttributesGroup 3939 DESCRIPTION 3940 "This group is mandatory for all iSCSI implementations 3941 that have iSCSI initiator facilities." 3943 GROUP iscsiInitiatorAttributesGroup 3944 DESCRIPTION 3945 "This group is mandatory for all iSCSI implementations 3946 that have iSCSI initiator facilities." 3948 GROUP iscsiInitiatorLoginStatsGroup 3949 DESCRIPTION 3950 "This group is mandatory for all iSCSI implementations 3951 that have iSCSI initiator facilities." 3953 GROUP iscsiInitiatorLogoutStatsGroup 3954 DESCRIPTION 3955 "This group is mandatory for all iSCSI implementations 3956 that have iSCSI initiator facilities." 3958 GROUP iscsiIntrLgnNotificationsGroup 3959 DESCRIPTION 3960 "This group is mandatory for all iSCSI implementations 3961 that have iSCSI initiator facilities." 3963 GROUP iscsiInitiatorAuthGroup 3964 DESCRIPTION 3965 "This group is mandatory for all iSCSI implementations 3966 that have iSCSI initiator facilities." 3968 OBJECT iscsiNodeErrorRecoveryLevel 3969 SYNTAX Unsigned32 (0..2) 3970 DESCRIPTION 3971 "Only values 0-2 are defined at present." 3973 ::= { iscsiCompliances 2 } 3975 END 3977 8. Security Considerations 3979 There are a number of management objects defined in this MIB module 3980 with a MAX-ACCESS clause of read-write and/or read-create. Such 3981 objects may be considered sensitive or vulnerable in some network 3982 environments. The support for SET operations in a non-secure 3983 environment without proper protection can have a negative effect on 3984 network operations. These are the tables and objects and their 3985 sensitivity/vulnerability: 3987 iscsiPortalAttributesTable, iscsiTgtPortalAttributesTable, and 3988 iscsiIntrPortalAttributesTable can be used to add or remove IP 3989 addresses to be used by iSCSI. 3991 iscsiTgtAuthAttributesTable entries can be added or removed, to 3992 allow or disallow access to a target by an initiator. 3994 Some of the readable objects in this MIB module (i.e., objects with a 3995 MAX-ACCESS other than not-accessible) may be considered sensitive or 3996 vulnerable in some network environments. It is thus important to 3997 control even GET and/or NOTIFY access to these objects and possibly 3998 to even encrypt the values of these objects when sending them over 3999 the network via SNMP. These are the tables and objects and their 4000 sensitivity/vulnerability: 4002 iscsiNodeAttributesTable, iscsiTargetAttributesTable, and 4003 iscsiTgtAuthorization can be used to glean information needed to 4004 make connections to the iSCSI targets this module represents. 4005 However, it is the responsibility of the initiators and targets 4006 involved to authenticate each other to ensure that an 4007 inappropriately advertised or discovered initiator or target does 4008 not compromise their security. These issues are discussed in 4009 [RFCcccc]. 4011 SNMP versions prior to SNMPv3 did not include adequate security. 4012 Even if the network itself is secure (for example by using IPsec), 4013 even then, there is no control as to who on the secure network is 4014 allowed to access and GET/SET (read/change/create/delete) the objects 4015 in this MIB module. 4017 It is RECOMMENDED that implementers consider the security features as 4018 provided by the SNMPv3 framework (see [RFC3410], section 8), 4019 including full support for SNMPv3 cryptographic mechanisms (for 4020 authentication and privacy). 4022 Further, deployment of SNMP versions prior to SNMPv3 is NOT 4023 RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to 4024 enable cryptographic security. It is then a customer/operator 4025 responsibility to ensure that the SNMP entity giving access to an 4026 instance of this MIB module is properly configured to give access to 4027 the objects only to those principals (users) that have legitimate 4028 rights to indeed GET or SET (change/create/delete) them. 4030 9. IANA Considerations 4032 The MIB module in this document uses the following IANA-assigned 4033 OBJECT IDENTIFIER values recorded in the SMI Numbers registry: 4035 Descriptor OBJECT IDENTIFIER value 4036 ---------- ----------------------- 4038 iscsiMibModule { mib-2 142 } 4040 RFC Editor's Note (to be removed prior to publication): this draft 4041 makes no additional requests of the IANA. 4043 10. References 4045 10.1. Normative References 4047 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 4048 Requirement Levels", BCP 14, RFC 2119, March 1997. 4050 [RFC2578] McCloghrie, K., Perkins, D., and J. Schoenwaelder, 4051 "Structure of Management Information Version 2 (SMIv2)", 4052 STD 58, RFC 2578, April 1999. 4054 [RFC2579] McCloghrie, K., Perkins, D., and J. Schoenwaelder, 4055 "Textual Conventions for SMIv2", STD 58, RFC 2579, April 4056 1999. 4058 [RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder, 4059 "Conformance Statements for SMIv2", STD 58, RFC 2580, 4060 April 1999. 4062 [RFC3411] Harrington, D., Presuhn, R., and B. Wijnen, "An 4063 Architecture for Describing Simple Network Management 4064 Protocol (SNMP) Management Frameworks", STD 62, RFC 3411, 4065 December 2002. 4067 [RFC3720] Satran, J., Meth, K., Sapuntzakis, C., Chadalapaka, M., 4068 and E. Zeidner, "Internet Small Computer Systems 4069 Interface (iSCSI)", RFC 3720, March 2004. 4071 [RFC4001] Daniele, M., Haberman, B., Routhier, S., and J. 4072 Schoenwaelder, "Textual Conventions for Internet Network 4073 Addresses", RFC 4001, February 2005. 4075 [RFC4545] Bakke, M. and J. Muchow, "Definitions of Managed Objects 4076 for IP Storage User Identity Authorization", RFC 4545, 4077 May 2006. 4079 [RFCcccc] Chadalapaka, M., Satran, J., and K. Meth, "iSCSI 4080 Protocol (Consolidated)", RFC cccc, mmyy 4082 -- RFC Editor:replace cccc with the RFC number assigned to 4083 -- draft-ietf-storm-iscsi-cons-03 & remove this note. 4084 -- RFC Editor:replace mmyy with the RFC month and year assigned to 4085 -- draft-ietf-storm-iscsi-cons-03 & remove this note. 4087 [RFCssss] Knight, F., Chadalapaka, M., "Internet Small 4088 Computer Systems Interface (iSCSI) Update", RFC ssss, 4089 mmyy 4090 -- RFC Editor: replace ssss with the RFC number assigned to 4091 -- draft-ietf-storm-iscsi-sam-05 & remove this note. 4092 -- RFC Editor: replace mmyy with the RFC month and year assigned to 4093 -- draft-ietf-storm-iscsi-sam-05 & remove this note. 4095 10.2. Informative References 4097 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, 4098 "Introduction and Applicability Statements for Internet- 4099 Standard Management Framework", RFC 3410, December 2002. 4101 [RFC4022] Raghunarayan, R., "Management Information Base for the 4102 Transmission Control Protocol (TCP)", RFC 4022, March 4103 2005. 4105 [RFC4455] Hallak-Stamler, M., Bakke, M., Lederman, Y., Krueger, M., 4106 and K. McCloghrie, "Definition of Managed Objects for 4107 Small Computer System Interface (SCSI) Entities", RFC 4108 4455, April 2006. 4110 [RFC4544] Bakke, M., J. Muchow, M. Krueger and T. McSweeney, 4111 "Definitions of Managed Objects for iSCSI", RFC 4544, 4112 May 2006. 4114 11. Acknowledgments 4116 In addition to the authors, several people contributed to the 4117 development of this MIB module. Thanks especially to those who took 4118 the time to participate in our weekly conference calls to build our 4119 requirements, object models, table structures, and attributes: John 4120 Hufferd, Tom McSweeney (IBM), Kevin Gibbons (Nishan Systems), Chad 4121 Gregory (Intel), Jack Harwood (EMC), Hari Mudaliar (Adaptec), Ie Wei 4122 Njoo (Agilent), Lawrence Lamers (SAN Valley), Satish Mali (Stonefly 4123 Networks), and William Terrell (Troika). 4125 Special thanks to Tom McSweeney, Ie Wei Njoo, and Kevin Gibbons, who 4126 wrote the descriptions for many of the tables and attributes in this 4127 MIB module, to Ayman Ghanem for finding and suggesting changes for 4128 many problems in this module, and to Keith McCloghrie for serving as 4129 advisor to the team. 4131 Thanks to Mike MacFaden (VMWare), David Black (EMC) and Tom Talpey 4132 (Microsoft) for their valuable inputs. 4134 Authors' Address 4136 Mark Bakke 4137 Dell 4138 7625 Smetana Lane 4139 Eden Prairie, MN 4140 USA 55344 4142 E-mail: mark_bakke@dell.com 4144 Prakash Venkatesen 4145 HCL Technologies Ltd. 4146 50-53, Greams Road, 4147 Chennai - 600006 4148 India 4150 E-mail: prakashvn@hcl.com 4152 Authors of RFC 4544: 4154 Mark Bakke 4155 Dell 4156 7625 Smetana Lane 4157 Eden Prairie, MN 4158 USA 55344 4160 E-mail: mark_bakke@dell.com 4162 Marjorie Krueger 4163 Hewlett-Packard 4164 Networked Storage Architecture 4165 Networked Storage Solutions Org. 4166 8000 Foothills Blvd. 4167 Roseville, CA 4168 USA 95747 4170 E-mail: marjorie_krueger@hp.com 4172 Tom McSweeney 4173 IBM Corporation 4174 600 Park Offices Drive 4175 Research Triangle Park, NC 4176 USA 27709 4178 E-mail: tommcs@us.ibm.com 4180 James Muchow 4181 Qlogic Corp. 4182 6321 Bury Drive 4183 Eden Prairie, MN 4184 USA 55346 4186 E-mail: james.muchow@qlogic.com