idnits 2.17.1 draft-ietf-storm-iscsimib-01.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 (October 25, 2011) is 4566 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-04 -- 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 Cisco Systems 3 Intended status: Proposed Standard Prakash Venkatesen 4 Expires: April 2012 HCL Technologies 5 Obsoletes: 4544 October 25, 2011 7 Definitions of Managed Objects for Internet Small Computer System 8 Interface (iSCSI) 9 draft-ietf-storm-iscsimib-01.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 April 25, 2012. 34 Copyright Notice 36 Copyright (c) 2011 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...................................................83 98 10.1. Normative References....................................83 99 10.2. Informative References..................................84 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 "201110210000Z" -- October 21, 2011 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) The IETF Trust (2011). This 675 version of this MIB module is part of RFC xxxx; 676 see the RFC itself for full legal notices." 677 -- RFC Editor: replace xxxx with actual RFC number & remove this note. 678 REVISION "201110210000Z" 679 DESCRIPTION 680 "Second version of the iSCSI Protocol MIB Module. 681 [RFCcccc] makes several updates to [RFC3720]. This 682 version makes corresponding updates to the MIB module. 683 This MIB module published as RFC xxxx." 684 -- RFC Editor: replace xxxx with actual RFC number & remove this note. 685 REVISION "200605220000Z" 686 DESCRIPTION 687 "Initial version of the iSCSI Protocol MIB module. 688 This MIB module published as RFC 4544." 690 ::= { mib-2 142 } 692 iscsiNotifications OBJECT IDENTIFIER ::= { iscsiMibModule 0 } 693 iscsiObjects OBJECT IDENTIFIER ::= { iscsiMibModule 1 } 694 iscsiConformance OBJECT IDENTIFIER ::= { iscsiMibModule 2 } 695 iscsiAdmin OBJECT IDENTIFIER ::= { iscsiMibModule 3 } 697 -- Textual Conventions 699 IscsiTransportProtocol ::= TEXTUAL-CONVENTION 700 DISPLAY-HINT "d" 701 STATUS current 702 DESCRIPTION 703 "This data type is used to define the transport 704 protocols that will carry iSCSI PDUs." 705 REFERENCE 706 "RFC791, RFC1700 708 The presently known, officially delegated numbers 709 can be found at: 710 http://www.iana.org/assignments/protocol-numbers" 712 SYNTAX Unsigned32 (0..255) 714 IscsiDigestMethod ::= TEXTUAL-CONVENTION 715 STATUS current 716 DESCRIPTION 717 "This data type represents the methods possible 718 for digest negotiation. 719 none - a placeholder for a secondary digest method 720 that means only the primary method can be 721 used. 723 other - a digest method other than those defined below. 724 noDigest - does not support digests (will operate without 725 a digest (Note: implementations must support 726 digests to be compliant with the RFCcccc). 727 CRC32c - require a CRC32C digest." 728 REFERENCE 729 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 731 SYNTAX INTEGER { 732 none(1), 733 other(2), 734 noDigest(3), 735 crc32c(4) 736 } 738 IscsiName ::= TEXTUAL-CONVENTION 739 DISPLAY-HINT "223t" 740 STATUS current 741 DESCRIPTION 742 "This data type is used for objects whose value is an 743 iSCSI name with the properties described in RFC cccc 744 section 4.2.7.1, and encoded as specified in RFC cccc 745 section 4.2.7.2. A zero-length string indicates the 746 absence of an iSCSI name." 747 REFERENCE 748 "RFC cccc, Section 4.2.7, iSCSI Names." 749 SYNTAX OCTET STRING (SIZE(0 | 16..223)) 751 --********************************************************************** 753 iscsiDescriptors OBJECT IDENTIFIER ::= { iscsiAdmin 1 } 755 iscsiHeaderIntegrityTypes OBJECT IDENTIFIER ::= { iscsiDescriptors 1 } 757 iscsiHdrIntegrityNone OBJECT-IDENTITY 758 STATUS current 759 DESCRIPTION 760 "The authoritative identifier when no integrity 761 scheme for the header is being used." 762 REFERENCE 763 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 764 ::= { iscsiHeaderIntegrityTypes 1 } 766 iscsiHdrIntegrityCrc32c OBJECT-IDENTITY 767 STATUS current 768 DESCRIPTION 769 "The authoritative identifier when the integrity 770 scheme for the header is CRC32c." 771 REFERENCE 772 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 773 ::= { iscsiHeaderIntegrityTypes 2 } 775 iscsiDataIntegrityTypes OBJECT IDENTIFIER ::= { iscsiDescriptors 2 } 777 iscsiDataIntegrityNone OBJECT-IDENTITY 778 STATUS current 779 DESCRIPTION 780 "The authoritative identifier when no integrity 781 scheme for the data is being used." 782 REFERENCE 783 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 784 ::= { iscsiDataIntegrityTypes 1 } 786 iscsiDataIntegrityCrc32c OBJECT-IDENTITY 787 STATUS current 788 DESCRIPTION 789 "The authoritative identifier when the integrity 790 scheme for the data is CRC32c." 791 REFERENCE 792 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 793 ::= { iscsiDataIntegrityTypes 2 } 795 --********************************************************************** 797 iscsiInstance OBJECT IDENTIFIER ::= { iscsiObjects 1 } 799 -- Instance Attributes Table 801 iscsiInstanceAttributesTable OBJECT-TYPE 802 SYNTAX SEQUENCE OF IscsiInstanceAttributesEntry 803 MAX-ACCESS not-accessible 804 STATUS current 805 DESCRIPTION 806 "A list of iSCSI instances present on the system." 807 ::= { iscsiInstance 1 } 809 iscsiInstanceAttributesEntry OBJECT-TYPE 810 SYNTAX IscsiInstanceAttributesEntry 811 MAX-ACCESS not-accessible 812 STATUS current 813 DESCRIPTION 814 "An entry (row) containing management information applicable 815 to a particular iSCSI instance." 816 INDEX { iscsiInstIndex } 817 ::= { iscsiInstanceAttributesTable 1 } 819 IscsiInstanceAttributesEntry ::= SEQUENCE { 820 iscsiInstIndex Unsigned32, 821 iscsiInstDescr SnmpAdminString, 822 iscsiInstVersionMin Unsigned32, 823 iscsiInstVersionMax Unsigned32, 824 iscsiInstVendorID SnmpAdminString, 825 iscsiInstVendorVersion SnmpAdminString, 826 iscsiInstPortalNumber Unsigned32, 827 iscsiInstNodeNumber Unsigned32, 828 iscsiInstSessionNumber Unsigned32, 829 iscsiInstSsnFailures Counter32, 830 iscsiInstLastSsnFailureType AutonomousType, 831 iscsiInstLastSsnRmtNodeName IscsiName, 832 iscsiInstDiscontinuityTime TimeStamp, 833 iscsiInstXNodeArchitecture SnmpAdminString 834 } 836 iscsiInstIndex OBJECT-TYPE 837 SYNTAX Unsigned32 (1..4294967295) 838 MAX-ACCESS not-accessible 839 STATUS current 840 DESCRIPTION 841 "An arbitrary integer used to uniquely identify a particular 842 iSCSI instance. This index value must not be modified or 843 reused by an agent unless a reboot has occurred. An agent 844 should attempt to keep this value persistent across reboots." 845 ::= { iscsiInstanceAttributesEntry 1 } 847 iscsiInstDescr OBJECT-TYPE 848 SYNTAX SnmpAdminString 849 MAX-ACCESS read-only 850 STATUS current 851 DESCRIPTION 852 "A UTF-8 string, determined by the implementation to 853 describe the iSCSI instance. When only a single instance 854 is present, this object may be set to the zero-length 855 string; with multiple iSCSI instances, it may be used in 856 an implementation-dependent manner to describe the purpose 857 of the respective instance." 859 ::= { iscsiInstanceAttributesEntry 2 } 861 iscsiInstVersionMin OBJECT-TYPE 862 SYNTAX Unsigned32 (0..255) 863 MAX-ACCESS read-only 864 STATUS current 865 DESCRIPTION 866 "The minimum version number of the iSCSI specification 867 such that this iSCSI instance supports this minimum 868 value, the maximum value indicated by the corresponding 869 instance in iscsiInstVersionMax, and all versions in 870 between." 871 REFERENCE 872 "RFC cccc, Section 11.12, Login Request" 873 ::= { iscsiInstanceAttributesEntry 3 } 875 iscsiInstVersionMax OBJECT-TYPE 876 SYNTAX Unsigned32 (0..255) 877 MAX-ACCESS read-only 878 STATUS current 879 DESCRIPTION 880 "The maximum version number of the iSCSI specification 881 such that this iSCSI instance supports this maximum 882 value, the minimum value indicated by the corresponding 883 instance in iscsiInstVersionMin, and all versions in 884 between." 885 REFERENCE 886 "RFC cccc, Section 11.12, Login Request" 887 ::= { iscsiInstanceAttributesEntry 4 } 889 iscsiInstVendorID OBJECT-TYPE 890 SYNTAX SnmpAdminString 891 MAX-ACCESS read-only 892 STATUS current 893 DESCRIPTION 894 "A UTF-8 string describing the manufacturer of the 895 implementation of this instance." 896 ::= { iscsiInstanceAttributesEntry 5 } 898 iscsiInstVendorVersion OBJECT-TYPE 899 SYNTAX SnmpAdminString 900 MAX-ACCESS read-only 901 STATUS current 902 DESCRIPTION 903 "A UTF-8 string set by the manufacturer describing the 904 version of the implementation of this instance. The 905 format of this string is determined solely by the 906 manufacturer, and is for informational purposes only. 907 It is unrelated to the iSCSI specification version numbers." 908 ::= { iscsiInstanceAttributesEntry 6 } 910 iscsiInstPortalNumber OBJECT-TYPE 911 SYNTAX Unsigned32 912 UNITS "transport endpoints" 913 MAX-ACCESS read-only 914 STATUS current 915 DESCRIPTION 916 "The number of rows in the iscsiPortalAttributesTable 917 that are currently associated with this iSCSI instance." 918 ::= { iscsiInstanceAttributesEntry 7 } 919 iscsiInstNodeNumber OBJECT-TYPE 920 SYNTAX Unsigned32 921 UNITS "iSCSI nodes" 922 MAX-ACCESS read-only 923 STATUS current 924 DESCRIPTION 925 "The number of rows in the iscsiNodeAttributesTable 926 that are currently associated with this iSCSI instance." 927 ::= { iscsiInstanceAttributesEntry 8 } 929 iscsiInstSessionNumber OBJECT-TYPE 930 SYNTAX Unsigned32 931 UNITS "sessions" 932 MAX-ACCESS read-only 933 STATUS current 934 DESCRIPTION 935 "The number of rows in the iscsiSessionAttributesTable 936 that are currently associated with this iSCSI instance." 937 ::= { iscsiInstanceAttributesEntry 9 } 939 iscsiInstSsnFailures OBJECT-TYPE 940 SYNTAX Counter32 941 UNITS "sessions" 942 MAX-ACCESS read-only 943 STATUS current 944 DESCRIPTION 945 "This object counts the number of times a session belonging 946 to this instance has failed. If this counter has 947 suffered a discontinuity, the time of the last discontinuity 948 is indicated in iscsiInstDiscontinuityTime." 949 REFERENCE 950 "RFC cccc, Section 13.1, HeaderDigest and DataDigest" 951 ::= { iscsiInstanceAttributesEntry 10 } 953 iscsiInstLastSsnFailureType OBJECT-TYPE 954 SYNTAX AutonomousType 955 MAX-ACCESS read-only 956 STATUS current 957 DESCRIPTION 958 "The counter object in the iscsiInstSsnErrorStatsTable 959 that was incremented when the last session failure occurred. 961 If the reason for failure is not found in the 962 iscsiInstSsnErrorStatsTable, the value { 0.0 } is 963 used instead." 964 ::= { iscsiInstanceAttributesEntry 11 } 966 iscsiInstLastSsnRmtNodeName OBJECT-TYPE 967 SYNTAX IscsiName 968 MAX-ACCESS read-only 969 STATUS current 970 DESCRIPTION 971 "The iSCSI name of the remote node from the failed 972 session." 973 ::= { iscsiInstanceAttributesEntry 12 } 975 iscsiInstDiscontinuityTime OBJECT-TYPE 976 SYNTAX TimeStamp 977 MAX-ACCESS read-only 978 STATUS current 979 DESCRIPTION 980 "The value of SysUpTime on the most recent occasion 981 at which any one or more of this instance's counters 982 suffered a discontinuity. 984 If no such discontinuities have occurred since the last 985 re-initialization of the local management subsystem, 986 then this object contains a zero value." 987 ::= { iscsiInstanceAttributesEntry 13 } 989 iscsiInstXNodeArchitecture OBJECT-TYPE 990 SYNTAX SnmpAdminString 991 MAX-ACCESS read-only 992 STATUS current 993 DESCRIPTION 994 "A UTF-8 string set by the manufacturer declaring the 995 details of its iSCSI node architecture to the remote 996 endpoint. These details may include, but are not limited 997 to, iSCSI vendor software, firmware, or hardware versions, 998 the OS version, or hardware architecture. 999 The format of this string is determined solely by the 1000 manufacturer, and is for informational purposes only. 1001 It is unrelated to the iSCSI specification version numbers." 1002 REFERENCE 1003 "[RFCcccc], Section 13.26, X#NodeArchitecture" 1004 ::= { iscsiInstanceAttributesEntry 14 } 1006 -- Instance Session Failure Stats Table 1008 iscsiInstanceSsnErrorStatsTable OBJECT-TYPE 1009 SYNTAX SEQUENCE OF IscsiInstanceSsnErrorStatsEntry 1010 MAX-ACCESS not-accessible 1011 STATUS current 1012 DESCRIPTION 1013 "Statistics regarding the occurrences of error types 1014 that result in a session failure." 1015 ::= { iscsiInstance 2 } 1016 iscsiInstanceSsnErrorStatsEntry OBJECT-TYPE 1017 SYNTAX IscsiInstanceSsnErrorStatsEntry 1018 MAX-ACCESS not-accessible 1019 STATUS current 1020 DESCRIPTION 1021 "An entry (row) containing management information applicable 1022 to a particular iSCSI instance." 1023 AUGMENTS { iscsiInstanceAttributesEntry } 1024 ::= { iscsiInstanceSsnErrorStatsTable 1 } 1026 IscsiInstanceSsnErrorStatsEntry ::= SEQUENCE { 1027 iscsiInstSsnDigestErrors Counter32, 1028 iscsiInstSsnCxnTimeoutErrors Counter32, 1029 iscsiInstSsnFormatErrors Counter32 1030 } 1032 iscsiInstSsnDigestErrors OBJECT-TYPE 1033 SYNTAX Counter32 1034 UNITS "sessions" 1035 MAX-ACCESS read-only 1036 STATUS current 1037 DESCRIPTION 1038 "The count of sessions that failed due to receipt of 1039 a PDU containing header or data digest errors. If this 1040 counter has suffered a discontinuity, the time of the last 1041 discontinuity is indicated in iscsiInstDiscontinuityTime." 1042 REFERENCE 1043 "RFC cccc, Section 7.8, Digest Errors" 1044 ::= { iscsiInstanceSsnErrorStatsEntry 1 } 1046 iscsiInstSsnCxnTimeoutErrors OBJECT-TYPE 1047 SYNTAX Counter32 1048 UNITS "sessions" 1049 MAX-ACCESS read-only 1050 STATUS current 1051 DESCRIPTION 1052 "The count of sessions that failed due to a sequence 1053 exceeding a time limit. If this counter has suffered a 1054 discontinuity, the time of the last discontinuity 1055 is indicated in iscsiInstDiscontinuityTime." 1056 REFERENCE 1057 "RFC cccc, Section 7.5, Connection Timeout Management" 1058 ::= { iscsiInstanceSsnErrorStatsEntry 2 } 1060 iscsiInstSsnFormatErrors OBJECT-TYPE 1061 SYNTAX Counter32 1062 UNITS "sessions" 1063 MAX-ACCESS read-only 1064 STATUS current 1065 DESCRIPTION 1066 "The count of sessions that failed due to receipt of 1067 a PDU that contained a format error. If this counter has 1068 suffered a discontinuity, the time of the last discontinuity 1069 is indicated in iscsiInstDiscontinuityTime." 1070 REFERENCE 1071 "RFC cccc, Section 7.7, Format Errors" 1072 ::= { iscsiInstanceSsnErrorStatsEntry 3 } 1074 --********************************************************************** 1076 iscsiPortal OBJECT IDENTIFIER ::= { iscsiObjects 2 } 1078 -- Portal Attributes Table 1080 iscsiPortalAttributesTable OBJECT-TYPE 1081 SYNTAX SEQUENCE OF IscsiPortalAttributesEntry 1082 MAX-ACCESS not-accessible 1083 STATUS current 1084 DESCRIPTION 1085 "A list of transport endpoints (using TCP or another transport 1086 protocol) used by this iSCSI instance. An iSCSI instance may 1087 use a portal to listen for incoming connections to its targets, 1088 to initiate connections to other targets, or both." 1089 ::= { iscsiPortal 1 } 1091 iscsiPortalAttributesEntry OBJECT-TYPE 1092 SYNTAX IscsiPortalAttributesEntry 1093 MAX-ACCESS not-accessible 1094 STATUS current 1095 DESCRIPTION 1096 "An entry (row) containing management information applicable 1097 to a particular portal instance." 1098 INDEX { iscsiInstIndex, iscsiPortalIndex } 1099 ::= { iscsiPortalAttributesTable 1 } 1101 IscsiPortalAttributesEntry ::= SEQUENCE { 1102 iscsiPortalIndex Unsigned32, 1103 iscsiPortalRowStatus RowStatus, 1104 iscsiPortalRoles BITS, 1105 iscsiPortalAddrType InetAddressType, 1106 iscsiPortalAddr InetAddress, 1107 iscsiPortalProtocol IscsiTransportProtocol, 1108 iscsiPortalMaxRecvDataSegLength Unsigned32, 1109 iscsiPortalPrimaryHdrDigest IscsiDigestMethod, 1110 iscsiPortalPrimaryDataDigest IscsiDigestMethod, 1111 iscsiPortalSecondaryHdrDigest IscsiDigestMethod, 1112 iscsiPortalSecondaryDataDigest IscsiDigestMethod, 1113 iscsiPortalRecvMarker TruthValue, 1114 iscsiPortalStorageType StorageType 1115 } 1117 iscsiPortalIndex OBJECT-TYPE 1118 SYNTAX Unsigned32 (1..4294967295) 1119 MAX-ACCESS not-accessible 1120 STATUS current 1121 DESCRIPTION 1122 "An arbitrary integer used to uniquely identify a particular 1123 transport endpoint within this iSCSI instance. This index 1124 value must not be modified or reused by an agent unless a 1125 reboot has occurred. An agent should attempt to keep this 1126 value persistent across reboots." 1127 ::= { iscsiPortalAttributesEntry 1 } 1129 iscsiPortalRowStatus OBJECT-TYPE 1130 SYNTAX RowStatus 1131 MAX-ACCESS read-create 1132 STATUS current 1133 DESCRIPTION 1134 "This field allows entries to be dynamically added and 1135 removed from this table via SNMP. When adding a row to 1136 this table, all non-Index/RowStatus objects must be set. 1137 When the value of this object is 'active', the values of 1138 the other objects in this table cannot be changed. 1139 Rows may be discarded using RowStatus. 1141 Note that creating a row in this table will typically 1142 cause the agent to create one or more rows in 1143 iscsiTgtPortalAttributesTable and/or 1144 iscsiIntrPortalAttributesTable." 1145 ::= { iscsiPortalAttributesEntry 2 } 1147 iscsiPortalRoles OBJECT-TYPE 1148 SYNTAX BITS { 1149 targetTypePortal(0), 1150 initiatorTypePortal(1) 1151 } 1152 MAX-ACCESS read-create 1153 STATUS current 1154 DESCRIPTION 1155 "A portal can operate in one or both of two roles: 1156 as a target portal and/or an initiator portal. If 1157 the portal will operate in both roles, both bits 1158 must be set. 1160 This object will define a corresponding row that 1161 will exist or must be created in the 1162 iscsiTgtPortalAttributesTable, the 1163 iscsiIntrPortalAttributesTable or both. If the 1164 targetTypePortal bit is set, one or more corresponding 1165 iscsiTgtPortalAttributesEntry rows will be found or 1166 created. If the initiatorTypePortal bit is set, 1167 one or more corresponding iscsiIntrPortalAttributesEntry 1168 rows will be found or created. If both bits are set, one 1169 or more corresponding rows will be found or created in 1170 one of the above tables." 1171 ::= { iscsiPortalAttributesEntry 3 } 1173 iscsiPortalAddrType OBJECT-TYPE 1174 SYNTAX InetAddressType 1175 MAX-ACCESS read-create 1176 STATUS current 1177 DESCRIPTION 1178 "The type of Internet Network Address contained in the 1179 corresponding instance of the iscsiPortalAddr." 1180 DEFVAL { ipv4 } 1181 ::= { iscsiPortalAttributesEntry 4 } 1183 iscsiPortalAddr OBJECT-TYPE 1184 SYNTAX InetAddress 1185 MAX-ACCESS read-create 1186 STATUS current 1187 DESCRIPTION 1188 "The portal's Internet Network Address, of the type 1189 specified by the object iscsiPortalAddrType. If 1190 iscsiPortalAddrType has the value 'dns', this address 1191 gets resolved to an IP address whenever a new iSCSI 1192 connection is established using this portal." 1193 ::= { iscsiPortalAttributesEntry 5 } 1195 iscsiPortalProtocol OBJECT-TYPE 1196 SYNTAX IscsiTransportProtocol 1197 MAX-ACCESS read-create 1198 STATUS current 1199 DESCRIPTION 1200 "The portal's transport protocol." 1201 DEFVAL { 6 } -- TCP 1202 ::= { iscsiPortalAttributesEntry 6 } 1204 iscsiPortalMaxRecvDataSegLength OBJECT-TYPE 1205 SYNTAX Unsigned32 (512..16777215) 1206 UNITS "bytes" 1207 MAX-ACCESS read-create 1208 STATUS current 1209 DESCRIPTION 1210 "The maximum PDU length this portal can receive. 1212 This may be constrained by hardware characteristics 1213 and individual implementations may choose not to 1214 allow this object to be changed." 1215 REFERENCE 1216 "RFC cccc, Section 13.12, MaxRecvDataSegmentLength" 1217 DEFVAL { 8192 } 1218 ::= { iscsiPortalAttributesEntry 7 } 1220 iscsiPortalPrimaryHdrDigest OBJECT-TYPE 1221 SYNTAX IscsiDigestMethod 1222 MAX-ACCESS read-create 1223 STATUS current 1224 DESCRIPTION 1225 "The preferred header digest for this portal." 1226 DEFVAL { crc32c } 1227 ::= { iscsiPortalAttributesEntry 8 } 1229 iscsiPortalPrimaryDataDigest OBJECT-TYPE 1230 SYNTAX IscsiDigestMethod 1231 MAX-ACCESS read-create 1232 STATUS current 1233 DESCRIPTION 1234 "The preferred data digest method for this portal." 1235 DEFVAL { crc32c } 1236 ::= { iscsiPortalAttributesEntry 9 } 1238 iscsiPortalSecondaryHdrDigest OBJECT-TYPE 1239 SYNTAX IscsiDigestMethod 1240 MAX-ACCESS read-create 1241 STATUS current 1242 DESCRIPTION 1243 "An alternate header digest preference for this portal." 1244 DEFVAL { noDigest } 1245 ::= { iscsiPortalAttributesEntry 10 } 1247 iscsiPortalSecondaryDataDigest OBJECT-TYPE 1248 SYNTAX IscsiDigestMethod 1249 MAX-ACCESS read-create 1250 STATUS current 1251 DESCRIPTION 1252 "An alternate data digest preference for this portal." 1253 DEFVAL { noDigest } 1254 ::= { iscsiPortalAttributesEntry 11 } 1256 iscsiPortalRecvMarker OBJECT-TYPE 1257 SYNTAX TruthValue 1258 MAX-ACCESS read-create 1259 STATUS deprecated 1260 DESCRIPTION 1261 "This object indicates whether or not this portal will 1262 request markers in its incoming data stream." 1263 REFERENCE 1264 "[RFCcccc], 13.25 Obsoleted Keys." 1265 DEFVAL { false } 1266 ::= { iscsiPortalAttributesEntry 12 } 1268 iscsiPortalStorageType OBJECT-TYPE 1269 SYNTAX StorageType 1270 MAX-ACCESS read-create 1271 STATUS current 1272 DESCRIPTION 1273 "The storage type for this row. Rows in this table that were 1274 created through an external process (e.g. not created via 1275 this MIB) may have a storage type of readOnly or permanent. 1277 Conceptual rows having the value 'permanent' need not 1278 allow write access to any columnar objects in the row." 1279 DEFVAL { nonVolatile } 1280 ::= { iscsiPortalAttributesEntry 13 } 1282 --********************************************************************** 1283 iscsiTargetPortal OBJECT IDENTIFIER ::= { iscsiObjects 3 } 1285 -- Target Portal Attributes Table 1287 iscsiTgtPortalAttributesTable OBJECT-TYPE 1288 SYNTAX SEQUENCE OF IscsiTgtPortalAttributesEntry 1289 MAX-ACCESS not-accessible 1290 STATUS current 1291 DESCRIPTION 1292 "A list of transport endpoints (using TCP or another transport 1293 protocol) on which this iSCSI instance listens for incoming 1294 connections to its targets." 1295 ::= { iscsiTargetPortal 1 } 1297 iscsiTgtPortalAttributesEntry OBJECT-TYPE 1298 SYNTAX IscsiTgtPortalAttributesEntry 1299 MAX-ACCESS not-accessible 1300 STATUS current 1301 DESCRIPTION 1302 "An entry (row) containing management information applicable 1303 to a particular portal instance that is used to listen for 1304 incoming connections to local targets. One or more rows in 1305 this table is populated by the agent for each 1306 iscsiPortalAttributesEntry row that has the bit 1307 targetTypePortal set in its iscsiPortalRoles column." 1308 INDEX { iscsiInstIndex, iscsiPortalIndex, 1309 iscsiTgtPortalNodeIndexOrZero } 1311 ::= { iscsiTgtPortalAttributesTable 1 } 1313 IscsiTgtPortalAttributesEntry ::= SEQUENCE { 1314 iscsiTgtPortalNodeIndexOrZero Unsigned32, 1315 iscsiTgtPortalPort InetPortNumber, 1316 iscsiTgtPortalTag Unsigned32 1317 } 1319 iscsiTgtPortalNodeIndexOrZero OBJECT-TYPE 1320 SYNTAX Unsigned32 (0..4294967295) 1321 MAX-ACCESS not-accessible 1322 STATUS current 1323 DESCRIPTION 1324 "An arbitrary integer used to uniquely identify a 1325 particular node within an iSCSI instance present 1326 on the local system. 1328 For implementations where each {portal, node} tuple 1329 can have a different portal tag, this value will 1330 map to the iscsiNodeIndex. 1332 For implementations where the portal tag is the 1333 same for a given portal regardless of which node 1334 is using the portal, the value 0 (zero) is used." 1335 ::= { iscsiTgtPortalAttributesEntry 1 } 1337 iscsiTgtPortalPort OBJECT-TYPE 1338 SYNTAX InetPortNumber (1..65535) 1339 MAX-ACCESS read-write 1340 STATUS current 1341 DESCRIPTION 1342 "The portal's transport protocol port number on which the 1343 portal listens for incoming iSCSI connections when the 1344 portal is used as a target portal. This object's storage 1345 type is specified in iscsiPortalStorageType." 1346 ::= { iscsiTgtPortalAttributesEntry 2 } 1348 iscsiTgtPortalTag OBJECT-TYPE 1349 SYNTAX Unsigned32 (1..65535) 1350 MAX-ACCESS read-write 1351 STATUS current 1352 DESCRIPTION 1353 "The portal's aggregation tag when the portal is used as 1354 a target portal. Multiple-connection sessions may 1355 be aggregated over portals sharing an identical 1356 aggregation tag. This object's storage type is 1357 specified in iscsiPortalStorageType." 1358 REFERENCE 1359 "RFC cccc, Section 4.4.1, iSCSI Architectural Model" 1361 ::= { iscsiTgtPortalAttributesEntry 3 } 1363 --********************************************************************** 1365 iscsiInitiatorPortal OBJECT IDENTIFIER ::= { iscsiObjects 4 } 1367 -- Initiator Portal Attributes Table 1369 iscsiIntrPortalAttributesTable OBJECT-TYPE 1370 SYNTAX SEQUENCE OF IscsiIntrPortalAttributesEntry 1371 MAX-ACCESS not-accessible 1372 STATUS current 1373 DESCRIPTION 1374 "A list of Internet Network Addresses (using TCP or another 1375 transport protocol) from which this iSCSI instance may 1376 initiate connections to other targets." 1377 ::= { iscsiInitiatorPortal 1 } 1379 iscsiIntrPortalAttributesEntry OBJECT-TYPE 1380 SYNTAX IscsiIntrPortalAttributesEntry 1381 MAX-ACCESS not-accessible 1382 STATUS current 1383 DESCRIPTION 1384 "An entry (row) containing management information applicable 1385 to a particular portal instance that is used to initiate 1386 connections to iSCSI targets. One or more rows in 1387 this table is populated by the agent for each 1388 iscsiPortalAttributesEntry row that has the bit 1389 initiatorTypePortal set in its iscsiPortalRoles column." 1390 INDEX { iscsiInstIndex, iscsiPortalIndex, 1391 iscsiIntrPortalNodeIndexOrZero } 1392 ::= { iscsiIntrPortalAttributesTable 1 } 1394 IscsiIntrPortalAttributesEntry ::= SEQUENCE { 1395 iscsiIntrPortalNodeIndexOrZero Unsigned32, 1396 iscsiIntrPortalTag Unsigned32 1397 } 1399 iscsiIntrPortalNodeIndexOrZero OBJECT-TYPE 1400 SYNTAX Unsigned32 (0..4294967295) 1401 MAX-ACCESS not-accessible 1402 STATUS current 1403 DESCRIPTION 1404 "An arbitrary integer used to uniquely identify a 1405 particular node within an iSCSI instance present 1406 on the local system. 1408 For implementations where each {portal, node} tuple 1409 can have a different portal tag, this value will 1410 map to the iscsiNodeIndex. 1412 For implementations where the portal tag is the 1413 same for a given portal regardless of which node 1414 is using the portal, the value 0 (zero) is used." 1415 ::= { iscsiIntrPortalAttributesEntry 1 } 1417 iscsiIntrPortalTag OBJECT-TYPE 1418 SYNTAX Unsigned32 (1..65535) 1419 MAX-ACCESS read-write 1420 STATUS current 1421 DESCRIPTION 1422 "The portal's aggregation tag when the portal is used as 1423 an initiator portal. Multiple-connection sessions may 1424 be aggregated over portals sharing an identical 1425 aggregation tag. This object's storage type is 1426 specified in iscsiPortalStorageType." 1427 REFERENCE 1428 "RFC cccc, Section 4.4.1, iSCSI Architectural Model" 1429 ::= { iscsiIntrPortalAttributesEntry 2 } 1431 --********************************************************************** 1433 iscsiNode OBJECT IDENTIFIER ::= { iscsiObjects 5 } 1435 -- Node Attributes Table 1437 iscsiNodeAttributesTable OBJECT-TYPE 1438 SYNTAX SEQUENCE OF IscsiNodeAttributesEntry 1439 MAX-ACCESS not-accessible 1440 STATUS current 1441 DESCRIPTION 1442 "A list of iSCSI nodes belonging to each iSCSI instance 1443 present on the local system. An iSCSI node can act as 1444 an initiator, a target, or both." 1445 ::= { iscsiNode 1 } 1447 iscsiNodeAttributesEntry OBJECT-TYPE 1448 SYNTAX IscsiNodeAttributesEntry 1449 MAX-ACCESS not-accessible 1450 STATUS current 1451 DESCRIPTION 1452 "An entry (row) containing management information applicable 1453 to a particular iSCSI node." 1454 INDEX { iscsiInstIndex, iscsiNodeIndex } 1455 ::= { iscsiNodeAttributesTable 1 } 1457 IscsiNodeAttributesEntry ::= SEQUENCE { 1458 iscsiNodeIndex Unsigned32, 1459 iscsiNodeName IscsiName, 1460 iscsiNodeAlias SnmpAdminString, 1461 iscsiNodeRoles BITS, 1462 iscsiNodeTransportType RowPointer, 1463 iscsiNodeInitialR2T TruthValue, 1464 iscsiNodeImmediateData TruthValue, 1465 iscsiNodeMaxOutstandingR2T Unsigned32, 1466 iscsiNodeFirstBurstLength Unsigned32, 1467 iscsiNodeMaxBurstLength Unsigned32, 1468 iscsiNodeMaxConnections Unsigned32, 1469 iscsiNodeDataSequenceInOrder TruthValue, 1470 iscsiNodeDataPDUInOrder TruthValue, 1471 iscsiNodeDefaultTime2Wait Unsigned32, 1472 iscsiNodeDefaultTime2Retain Unsigned32, 1473 iscsiNodeErrorRecoveryLevel Unsigned32, 1474 iscsiNodeDiscontinuityTime TimeStamp, 1475 iscsiNodeStorageType StorageType 1476 } 1478 iscsiNodeIndex OBJECT-TYPE 1479 SYNTAX Unsigned32 (1..4294967295) 1480 MAX-ACCESS not-accessible 1481 STATUS current 1482 DESCRIPTION 1483 "An arbitrary integer used to uniquely identify a particular 1484 node within an iSCSI instance. This index value must not be 1485 modified or reused by an agent unless a reboot has occurred. 1486 An agent should attempt to keep this value persistent across 1487 reboots." 1488 ::= { iscsiNodeAttributesEntry 1 } 1490 iscsiNodeName OBJECT-TYPE 1491 SYNTAX IscsiName 1492 MAX-ACCESS read-only 1493 STATUS current 1494 DESCRIPTION 1495 "This node's iSCSI name, which is independent of the location 1496 of the node, and can be resolved into a set of addresses 1497 through various discovery services." 1498 ::= { iscsiNodeAttributesEntry 2 } 1500 iscsiNodeAlias OBJECT-TYPE 1501 SYNTAX SnmpAdminString 1502 MAX-ACCESS read-only 1503 STATUS current 1504 DESCRIPTION 1505 "A character string that is a human-readable name or 1506 description of the iSCSI node. If configured, this alias 1507 may be communicated to the initiator or target node at 1508 the remote end of the connection during a Login Request 1509 or Response message. This string is not used as an 1510 identifier, but can be displayed by the system's user 1511 interface in a list of initiators and/or targets to 1512 which it is connected. 1514 If no alias exists, the value is a zero-length string." 1515 REFERENCE 1516 "RFC cccc, Section 13.6, TargetAlias, 13.7, InitiatorAlias" 1517 ::= { iscsiNodeAttributesEntry 3 } 1519 iscsiNodeRoles OBJECT-TYPE 1520 SYNTAX BITS { 1521 targetTypeNode(0), 1522 initiatorTypeNode(1) 1523 } 1524 MAX-ACCESS read-only 1525 STATUS current 1526 DESCRIPTION 1527 "A node can operate in one or both of two roles: 1528 a target role and/or an initiator role. If the node 1529 will operate in both roles, both bits must be set. 1531 This object will also define the corresponding rows that 1532 will exist in the iscsiTargetAttributesTable, the 1533 iscsiInitiatorAttributesTable or both. If the 1534 targetTypeNode bit is set, there will be a corresponding 1535 iscsiTargetAttributesEntry. If the initiatorTypeNode bit 1536 is set, there will be a corresponding 1537 iscsiInitiatorAttributesEntry. If both bits are set, 1538 there will be a corresponding iscsiTgtPortalAttributesEntry 1539 and iscsiPortalAttributesEntry." 1540 ::= { iscsiNodeAttributesEntry 4 } 1542 iscsiNodeTransportType OBJECT-TYPE 1543 SYNTAX RowPointer 1544 MAX-ACCESS read-only 1545 STATUS current 1546 DESCRIPTION 1547 "A pointer to the corresponding row in the appropriate 1548 table for this SCSI transport, thereby allowing management 1549 stations to locate the SCSI-level device that is represented 1550 by this iscsiNode. For example, it will usually point to the 1551 corresponding scsiTrnspt object in the SCSI MIB module. 1552 If no corresponding row exists, the value 0.0 must be 1553 used to indicate this." 1554 REFERENCE 1555 "SCSI-MIB" 1556 ::= { iscsiNodeAttributesEntry 5 } 1557 iscsiNodeInitialR2T OBJECT-TYPE 1558 SYNTAX TruthValue 1559 MAX-ACCESS read-only 1560 STATUS current 1561 DESCRIPTION 1562 "This object indicates the InitialR2T preference for this 1563 node: 1564 true = YES, 1565 false = will try to negotiate NO, will accept YES " 1566 REFERENCE 1567 "RFC cccc, Section 13.10, InitialR2T" 1568 ::= { iscsiNodeAttributesEntry 6 } 1570 iscsiNodeImmediateData OBJECT-TYPE 1571 SYNTAX TruthValue 1572 MAX-ACCESS read-write 1573 STATUS current 1574 DESCRIPTION 1575 "This object indicates ImmediateData preference for this 1576 node: 1577 true = YES (but will accept NO), 1578 false = NO " 1579 REFERENCE 1580 "RFC cccc, Section 13.11, ImmediateData" 1581 DEFVAL { true } 1582 ::= { iscsiNodeAttributesEntry 7 } 1584 iscsiNodeMaxOutstandingR2T OBJECT-TYPE 1585 SYNTAX Unsigned32 (1..65535) 1586 UNITS "R2Ts" 1587 MAX-ACCESS read-write 1588 STATUS current 1589 DESCRIPTION 1590 "Maximum number of outstanding requests-to-transmit (R2Ts) 1591 allowed per iSCSI task." 1592 REFERENCE 1593 "RFC cccc, Section 13.17, MaxOutstandingR2T" 1594 DEFVAL { 1 } 1595 ::= { iscsiNodeAttributesEntry 8 } 1597 iscsiNodeFirstBurstLength OBJECT-TYPE 1598 SYNTAX Unsigned32 (512..16777215) 1599 UNITS "bytes" 1600 MAX-ACCESS read-write 1601 STATUS current 1602 DESCRIPTION 1603 "The maximum length (bytes) supported for unsolicited data 1604 to/from this node." 1606 REFERENCE 1607 "RFC cccc, Section 13.14, FirstBurstLength" 1608 DEFVAL { 65536 } 1609 ::= { iscsiNodeAttributesEntry 9 } 1611 iscsiNodeMaxBurstLength OBJECT-TYPE 1612 SYNTAX Unsigned32 (512..16777215) 1613 UNITS "bytes" 1614 MAX-ACCESS read-write 1615 STATUS current 1616 DESCRIPTION 1617 "The maximum number of bytes that can be sent within 1618 a single sequence of Data-In or Data-Out PDUs." 1619 REFERENCE 1620 "RFC cccc, Section 13.13, MaxBurstLength" 1621 DEFVAL { 262144 } 1622 ::= { iscsiNodeAttributesEntry 10 } 1624 iscsiNodeMaxConnections OBJECT-TYPE 1625 SYNTAX Unsigned32 (1..65535) 1626 UNITS "connections" 1627 MAX-ACCESS read-write 1628 STATUS current 1629 DESCRIPTION 1630 "The maximum number of connections allowed in each 1631 session to and/or from this node." 1632 REFERENCE 1633 "RFC cccc, Section 13.2, MaxConnections" 1634 DEFVAL { 1 } 1635 ::= { iscsiNodeAttributesEntry 11 } 1637 iscsiNodeDataSequenceInOrder OBJECT-TYPE 1638 SYNTAX TruthValue 1639 MAX-ACCESS read-write 1640 STATUS current 1641 DESCRIPTION 1642 "The DataSequenceInOrder preference of this node. 1643 False (=No) indicates that iSCSI data PDU sequences may 1644 be transferred in any order. True (=Yes) indicates that 1645 data PDU sequences must be transferred using 1646 continuously increasing offsets, except during 1647 error recovery." 1648 REFERENCE 1649 "RFC cccc, Section 13.19, DataSequenceInOrder" 1650 DEFVAL { true } 1651 ::= { iscsiNodeAttributesEntry 12 } 1653 iscsiNodeDataPDUInOrder OBJECT-TYPE 1654 SYNTAX TruthValue 1655 MAX-ACCESS read-write 1656 STATUS current 1657 DESCRIPTION 1658 "The DataPDUInOrder preference of this node. 1659 False (=No) indicates that iSCSI data PDUs within sequences 1660 may be in any order. True (=Yes) indicates that data PDUs 1661 within sequences must be at continuously increasing 1662 addresses, with no gaps or overlay between PDUs." 1663 REFERENCE 1664 "RFC cccc, Section 13.18, DataPDUInOrder" 1665 DEFVAL { true } 1666 ::= { iscsiNodeAttributesEntry 13 } 1668 iscsiNodeDefaultTime2Wait OBJECT-TYPE 1669 SYNTAX Unsigned32 (0..3600) 1670 UNITS "seconds" 1671 MAX-ACCESS read-write 1672 STATUS current 1673 DESCRIPTION 1674 "The DefaultTime2Wait preference of this node. This is the 1675 minimum time, in seconds, to wait before attempting an 1676 explicit/implicit logout or active iSCSI task reassignment 1677 after an unexpected connection termination or a connection 1678 reset." 1679 REFERENCE 1680 "RFC cccc, Section 13.15, DefaultTime2Wait" 1681 DEFVAL { 2 } 1682 ::= { iscsiNodeAttributesEntry 14 } 1684 iscsiNodeDefaultTime2Retain OBJECT-TYPE 1685 SYNTAX Unsigned32 (0..3600) 1686 UNITS "seconds" 1687 MAX-ACCESS read-write 1688 STATUS current 1689 DESCRIPTION 1690 "The DefaultTime2Retain preference of this node. This is 1691 the maximum time, in seconds after an initial wait 1692 (Time2Wait), before which an active iSCSI task reassignment 1693 is still possible after an unexpected connection termination 1694 or a connection reset." 1695 REFERENCE 1696 "RFC cccc, Section 13.16, DefaultTime2Retain" 1697 DEFVAL { 20 } 1698 ::= { iscsiNodeAttributesEntry 15 } 1700 iscsiNodeErrorRecoveryLevel OBJECT-TYPE 1701 SYNTAX Unsigned32 (0..255) 1702 MAX-ACCESS read-write 1703 STATUS current 1704 DESCRIPTION 1705 "The ErrorRecoveryLevel preference of this node. 1706 Currently, only 0-2 are valid. 1708 This object is designed to accommodate future error recovery 1709 levels. 1711 Higher error recovery levels imply support in addition to 1712 support for the lower error level functions. In other words, 1713 error level 2 implies support for levels 0-1, since those 1714 functions are subsets of error level 2." 1715 REFERENCE 1716 "RFC cccc, Section 13.20, ErrorRecoveryLevel" 1717 DEFVAL { 0 } 1718 ::= { iscsiNodeAttributesEntry 16 } 1720 iscsiNodeDiscontinuityTime OBJECT-TYPE 1721 SYNTAX TimeStamp 1722 MAX-ACCESS read-only 1723 STATUS current 1724 DESCRIPTION 1725 "The value of SysUpTime on the most recent occasion 1726 at which any one or more of this node's counters 1727 suffered a discontinuity. 1729 If no such discontinuities have occurred since the last 1730 re-initialization of the local management subsystem, 1731 then this object contains a zero value." 1732 ::= { iscsiNodeAttributesEntry 17 } 1734 iscsiNodeStorageType OBJECT-TYPE 1735 SYNTAX StorageType 1736 MAX-ACCESS read-write 1737 STATUS current 1738 DESCRIPTION 1739 "The storage type for all read-write objects within this 1740 row. Rows in this table are always created via an 1741 external process (e.g. not created via this MIB). Conceptual 1742 rows having the value 'permanent' need not allow write 1743 access to any columnar objects in the row. 1745 If this object has the value 'volatile', modifications 1746 to read-write objects in this row are not persistent 1747 across reboots. If this object has the value 1748 'nonVolatile', modifications to objects in this row 1749 are persistent. 1751 An implementation may choose to allow this object 1752 to be set to either 'nonVolatile' or 'volatile', 1753 allowing the management application to choose this 1754 behavior." 1755 DEFVAL { volatile } 1756 ::= { iscsiNodeAttributesEntry 18 } 1758 --********************************************************************** 1760 iscsiTarget OBJECT IDENTIFIER ::= { iscsiObjects 6 } 1762 -- Target Attributes Table 1764 iscsiTargetAttributesTable OBJECT-TYPE 1765 SYNTAX SEQUENCE OF IscsiTargetAttributesEntry 1766 MAX-ACCESS not-accessible 1767 STATUS current 1768 DESCRIPTION 1769 "A list of iSCSI nodes that can take on a target role, 1770 belonging to each iSCSI instance present on the local 1771 system." 1772 ::= { iscsiTarget 1 } 1774 iscsiTargetAttributesEntry OBJECT-TYPE 1775 SYNTAX IscsiTargetAttributesEntry 1776 MAX-ACCESS not-accessible 1777 STATUS current 1778 DESCRIPTION 1779 "An entry (row) containing management information applicable 1780 to a particular node that can take on a target role." 1781 INDEX { iscsiInstIndex, iscsiNodeIndex } 1782 ::= { iscsiTargetAttributesTable 1 } 1784 IscsiTargetAttributesEntry ::= SEQUENCE { 1785 iscsiTgtLoginFailures Counter32, 1786 iscsiTgtLastFailureTime TimeStamp, 1787 iscsiTgtLastFailureType AutonomousType, 1788 iscsiTgtLastIntrFailureName IscsiName, 1789 iscsiTgtLastIntrFailureAddrType InetAddressType, 1790 iscsiTgtLastIntrFailureAddr InetAddress 1791 } 1793 iscsiTgtLoginFailures OBJECT-TYPE 1794 SYNTAX Counter32 1795 UNITS "failed login attempts" 1796 MAX-ACCESS read-only 1797 STATUS current 1798 DESCRIPTION 1799 "This object counts the number of times a login attempt to this 1800 local target has failed. 1801 If this counter has suffered a discontinuity, the time of the 1802 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1803 REFERENCE 1804 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 1805 ::= { iscsiTargetAttributesEntry 1 } 1807 iscsiTgtLastFailureTime OBJECT-TYPE 1808 SYNTAX TimeStamp 1809 MAX-ACCESS read-only 1810 STATUS current 1811 DESCRIPTION 1812 "The timestamp of the most recent failure of a login attempt 1813 to this target. A value of zero indicates that no such 1814 failures have occurred since the last system boot." 1815 ::= { iscsiTargetAttributesEntry 2 } 1817 iscsiTgtLastFailureType OBJECT-TYPE 1818 SYNTAX AutonomousType 1819 MAX-ACCESS read-only 1820 STATUS current 1821 DESCRIPTION 1822 "The type of the most recent failure of a login attempt 1823 to this target, represented as the OID of the counter 1824 object in iscsiTargetLoginStatsTable for which the 1825 relevant instance was incremented. If no such failures 1826 have occurred since the last system boot, this attribute 1827 will have the value 0.0. A value of 0.0 may also be used 1828 to indicate a type that is not represented by any of 1829 the counters in iscsiTargetLoginStatsTable." 1830 ::= { iscsiTargetAttributesEntry 3 } 1832 iscsiTgtLastIntrFailureName OBJECT-TYPE 1833 SYNTAX IscsiName 1834 MAX-ACCESS read-only 1835 STATUS current 1836 DESCRIPTION 1837 "The iSCSI name of the initiator that failed the last 1838 login attempt. If no such failures have occurred since 1839 the last system boot, this value is a zero-length string." 1840 ::= { iscsiTargetAttributesEntry 4 } 1842 iscsiTgtLastIntrFailureAddrType OBJECT-TYPE 1843 SYNTAX InetAddressType 1844 MAX-ACCESS read-only 1845 STATUS current 1846 DESCRIPTION 1847 "The type of Internet Network Address contained in the 1848 corresponding instance of the iscsiTgtLastIntrFailureAddr. 1849 The value 'dns' is not allowed. If no such failures have 1850 occurred since the last system boot, this value is zero." 1852 ::= { iscsiTargetAttributesEntry 5 } 1854 iscsiTgtLastIntrFailureAddr OBJECT-TYPE 1855 SYNTAX InetAddress 1856 MAX-ACCESS read-only 1857 STATUS current 1858 DESCRIPTION 1859 "An Internet Network Address, of the type specified by 1860 the object iscsiTgtLastIntrFailureAddrType, giving the 1861 host address of the initiator that failed the last login 1862 attempt. If no such failures have occurred since the last 1863 system boot, this value is a zero-length string." 1864 ::= { iscsiTargetAttributesEntry 6 } 1866 -- Target Login Stats Table 1868 iscsiTargetLoginStatsTable OBJECT-TYPE 1869 SYNTAX SEQUENCE OF IscsiTargetLoginStatsEntry 1870 MAX-ACCESS not-accessible 1871 STATUS current 1872 DESCRIPTION 1873 "A table of counters that keep a record of the results 1874 of initiators' login attempts to this target." 1875 ::= { iscsiTarget 2 } 1877 iscsiTargetLoginStatsEntry OBJECT-TYPE 1878 SYNTAX IscsiTargetLoginStatsEntry 1879 MAX-ACCESS not-accessible 1880 STATUS current 1881 DESCRIPTION 1882 "An entry (row) containing counters for each result of 1883 a login attempt to this target." 1884 AUGMENTS { iscsiTargetAttributesEntry } 1885 ::= { iscsiTargetLoginStatsTable 1 } 1887 IscsiTargetLoginStatsEntry ::= SEQUENCE { 1888 iscsiTgtLoginAccepts Counter32, 1889 iscsiTgtLoginOtherFails Counter32, 1890 iscsiTgtLoginRedirects Counter32, 1891 iscsiTgtLoginAuthorizeFails Counter32, 1892 iscsiTgtLoginAuthenticateFails Counter32, 1893 iscsiTgtLoginNegotiateFails Counter32 1894 } 1896 iscsiTgtLoginAccepts OBJECT-TYPE 1897 SYNTAX Counter32 1898 UNITS "successful logins" 1899 MAX-ACCESS read-only 1900 STATUS current 1901 DESCRIPTION 1902 "The count of Login Response PDUs with status 1903 0x0000, Accept Login, transmitted by this 1904 target. 1905 If this counter has suffered a discontinuity, the time of the 1906 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1907 REFERENCE 1908 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 1909 ::= { iscsiTargetLoginStatsEntry 1 } 1911 iscsiTgtLoginOtherFails OBJECT-TYPE 1912 SYNTAX Counter32 1913 UNITS "failed logins" 1914 MAX-ACCESS read-only 1915 STATUS current 1916 DESCRIPTION 1917 "The number of Login Response PDUs that were transmitted 1918 by this target and that were not counted by any other 1919 object in the row. 1920 If this counter has suffered a discontinuity, the time of the 1921 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1922 REFERENCE 1923 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 1924 ::= { iscsiTargetLoginStatsEntry 2 } 1926 iscsiTgtLoginRedirects OBJECT-TYPE 1927 SYNTAX Counter32 1928 UNITS "redirected logins" 1929 MAX-ACCESS read-only 1930 STATUS current 1931 DESCRIPTION 1932 "The count of Login Response PDUs with status class 0x01, 1933 Redirection, transmitted by this target. 1934 If this counter has suffered a discontinuity, the time of the 1935 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1936 REFERENCE 1937 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 1938 ::= { iscsiTargetLoginStatsEntry 3 } 1940 iscsiTgtLoginAuthorizeFails OBJECT-TYPE 1941 SYNTAX Counter32 1942 UNITS "failed logins" 1943 MAX-ACCESS read-only 1944 STATUS current 1945 DESCRIPTION 1946 "The count of Login Response PDUs with status 0x0202, 1947 Forbidden Target, transmitted by this target. 1949 If this counter is incremented, an iscsiTgtLoginFailure 1950 notification should be generated. 1951 If this counter has suffered a discontinuity, the time of the 1952 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1953 REFERENCE 1954 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 1955 ::= { iscsiTargetLoginStatsEntry 4 } 1957 iscsiTgtLoginAuthenticateFails OBJECT-TYPE 1958 SYNTAX Counter32 1959 UNITS "failed logins" 1960 MAX-ACCESS read-only 1961 STATUS current 1962 DESCRIPTION 1963 "The count of Login Response PDUs with status 0x0201, 1964 Authentication Failed, transmitted by this target. 1966 If this counter is incremented, an iscsiTgtLoginFailure 1967 notification should be generated. 1969 If this counter has suffered a discontinuity, the time of the 1970 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1971 REFERENCE 1972 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 1973 ::= { iscsiTargetLoginStatsEntry 5 } 1975 iscsiTgtLoginNegotiateFails OBJECT-TYPE 1976 SYNTAX Counter32 1977 UNITS "failed logins" 1978 MAX-ACCESS read-only 1979 STATUS current 1980 DESCRIPTION 1981 "The number of times a target has effectively refused a 1982 login because the parameter negotiation failed. 1983 If this counter is incremented, an iscsiTgtLoginFailure 1984 notification should be generated. 1985 If this counter has suffered a discontinuity, the time of the 1986 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 1987 ::= { iscsiTargetLoginStatsEntry 6 } 1989 -- Target Logout Stats Table 1991 iscsiTargetLogoutStatsTable OBJECT-TYPE 1992 SYNTAX SEQUENCE OF IscsiTargetLogoutStatsEntry 1993 MAX-ACCESS not-accessible 1994 STATUS current 1995 DESCRIPTION 1996 "When a target receives a Logout command, it responds 1997 with a Logout Response that carries a status code. 1998 This table contains counters for both normal and 1999 abnormal logout requests received by this target." 2000 ::= { iscsiTarget 3 } 2002 iscsiTargetLogoutStatsEntry OBJECT-TYPE 2003 SYNTAX IscsiTargetLogoutStatsEntry 2004 MAX-ACCESS not-accessible 2005 STATUS current 2006 DESCRIPTION 2007 "An entry (row) containing counters of Logout Response 2008 PDUs that were received by this target." 2009 AUGMENTS { iscsiTargetAttributesEntry } 2010 ::= { iscsiTargetLogoutStatsTable 1 } 2012 IscsiTargetLogoutStatsEntry ::= SEQUENCE { 2013 iscsiTgtLogoutNormals Counter32, 2014 iscsiTgtLogoutOthers Counter32 2015 } 2017 iscsiTgtLogoutNormals OBJECT-TYPE 2018 SYNTAX Counter32 2019 UNITS "normal logouts" 2020 MAX-ACCESS read-only 2021 STATUS current 2022 DESCRIPTION 2023 "The count of Logout Command PDUs received by this target, 2024 with reason code 0 (closes the session). 2025 If this counter has suffered a discontinuity, the time of the 2026 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2027 REFERENCE 2028 "RFC cccc, Section 11.14.1, Reason Code" 2029 ::= { iscsiTargetLogoutStatsEntry 1 } 2031 iscsiTgtLogoutOthers OBJECT-TYPE 2032 SYNTAX Counter32 2033 UNITS "abnormal logouts" 2034 MAX-ACCESS read-only 2035 STATUS current 2036 DESCRIPTION 2037 "The count of Logout Command PDUs received by this target, 2038 with any reason code other than 0. 2039 If this counter has suffered a discontinuity, the time of the 2040 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2041 REFERENCE 2042 "RFC cccc, Section 11.14.1, Reason Code" 2043 ::= { iscsiTargetLogoutStatsEntry 2 } 2045 --********************************************************************** 2047 iscsiTgtAuthorization OBJECT IDENTIFIER ::= { iscsiObjects 7 } 2048 -- Target Authorization Attributes Table 2050 iscsiTgtAuthAttributesTable OBJECT-TYPE 2051 SYNTAX SEQUENCE OF IscsiTgtAuthAttributesEntry 2052 MAX-ACCESS not-accessible 2053 STATUS current 2054 DESCRIPTION 2055 "A list of initiator identities that are authorized to 2056 access each target node within each iSCSI instance 2057 present on the local system." 2058 ::= { iscsiTgtAuthorization 1 } 2060 iscsiTgtAuthAttributesEntry OBJECT-TYPE 2061 SYNTAX IscsiTgtAuthAttributesEntry 2062 MAX-ACCESS not-accessible 2063 STATUS current 2064 DESCRIPTION 2065 "An entry (row) containing management information 2066 applicable to a particular target node's authorized 2067 initiator identity." 2068 INDEX { iscsiInstIndex, iscsiNodeIndex, iscsiTgtAuthIndex } 2069 ::= { iscsiTgtAuthAttributesTable 1 } 2071 IscsiTgtAuthAttributesEntry ::= SEQUENCE { 2072 iscsiTgtAuthIndex Unsigned32, 2073 iscsiTgtAuthRowStatus RowStatus, 2074 iscsiTgtAuthIdentity RowPointer, 2075 iscsiTgtAuthStorageType StorageType 2076 } 2078 iscsiTgtAuthIndex OBJECT-TYPE 2079 SYNTAX Unsigned32 (1..4294967295) 2080 MAX-ACCESS not-accessible 2081 STATUS current 2082 DESCRIPTION 2083 "An arbitrary integer used to uniquely identify a particular 2084 target's authorized initiator identity within an iSCSI 2085 instance present on the local system. This index value must 2086 not be modified or reused by an agent unless a reboot has 2087 occurred. An agent should attempt to keep this value 2088 persistent across reboots." 2089 ::= { iscsiTgtAuthAttributesEntry 1 } 2091 iscsiTgtAuthRowStatus OBJECT-TYPE 2092 SYNTAX RowStatus 2093 MAX-ACCESS read-create 2094 STATUS current 2095 DESCRIPTION 2096 "This field allows entries to be dynamically added and 2097 removed from this table via SNMP. When adding a row to 2098 this table, all non-Index/RowStatus objects must be set. 2099 When the value of this object is 'active', the values of 2100 the other objects in this table cannot be changed. 2101 Rows may be discarded using RowStatus." 2102 ::= { iscsiTgtAuthAttributesEntry 2 } 2104 iscsiTgtAuthIdentity OBJECT-TYPE 2105 SYNTAX RowPointer 2106 MAX-ACCESS read-create 2107 STATUS current 2108 DESCRIPTION 2109 "A pointer to the corresponding user entry in the IPS-AUTH 2110 MIB module that will be allowed to access this iSCSI target." 2111 REFERENCE 2112 "IPS-AUTH MIB, RFC 4545" 2113 ::= { iscsiTgtAuthAttributesEntry 3 } 2115 iscsiTgtAuthStorageType OBJECT-TYPE 2116 SYNTAX StorageType 2117 MAX-ACCESS read-create 2118 STATUS current 2119 DESCRIPTION 2120 "The storage type for this row. Rows in this table that were 2121 created through an external process (e.g. not created via 2122 this MIB) may have a storage type of readOnly or permanent. 2124 Conceptual rows having the value 'permanent' need not 2125 allow write access to any columnar objects in the row." 2126 DEFVAL { nonVolatile } 2127 ::= { iscsiTgtAuthAttributesEntry 4 } 2129 --********************************************************************** 2131 iscsiInitiator OBJECT IDENTIFIER ::= { iscsiObjects 8 } 2133 -- Initiator Attributes Table 2135 iscsiInitiatorAttributesTable OBJECT-TYPE 2136 SYNTAX SEQUENCE OF IscsiInitiatorAttributesEntry 2137 MAX-ACCESS not-accessible 2138 STATUS current 2139 DESCRIPTION 2140 "A list of iSCSI nodes that can take on an initiator 2141 role, belonging to each iSCSI instance present on 2142 the local system." 2143 ::= { iscsiInitiator 1 } 2144 iscsiInitiatorAttributesEntry OBJECT-TYPE 2145 SYNTAX IscsiInitiatorAttributesEntry 2146 MAX-ACCESS not-accessible 2147 STATUS current 2148 DESCRIPTION 2149 "An entry (row) containing management information 2150 applicable to a particular iSCSI node that has 2151 initiator capabilities." 2152 INDEX { iscsiInstIndex, iscsiNodeIndex } 2153 ::= { iscsiInitiatorAttributesTable 1 } 2155 IscsiInitiatorAttributesEntry ::= SEQUENCE { 2156 iscsiIntrLoginFailures Counter32, 2157 iscsiIntrLastFailureTime TimeStamp, 2158 iscsiIntrLastFailureType AutonomousType, 2159 iscsiIntrLastTgtFailureName IscsiName, 2160 iscsiIntrLastTgtFailureAddrType InetAddressType, 2161 iscsiIntrLastTgtFailureAddr InetAddress 2162 } 2164 iscsiIntrLoginFailures OBJECT-TYPE 2165 SYNTAX Counter32 2166 UNITS "failed logins" 2167 MAX-ACCESS read-only 2168 STATUS current 2169 DESCRIPTION 2170 "This object counts the number of times a login attempt from 2171 this local initiator has failed. 2172 If this counter has suffered a discontinuity, the time of the 2173 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2174 REFERENCE 2175 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2176 ::= { iscsiInitiatorAttributesEntry 1 } 2178 iscsiIntrLastFailureTime OBJECT-TYPE 2179 SYNTAX TimeStamp 2180 MAX-ACCESS read-only 2181 STATUS current 2182 DESCRIPTION 2183 "The timestamp of the most recent failure of a login attempt 2184 from this initiator. A value of zero indicates that no such 2185 failures have occurred since the last system boot." 2186 ::= { iscsiInitiatorAttributesEntry 2 } 2188 iscsiIntrLastFailureType OBJECT-TYPE 2189 SYNTAX AutonomousType 2190 MAX-ACCESS read-only 2191 STATUS current 2192 DESCRIPTION 2193 "The type of the most recent failure of a login attempt 2194 from this initiator, represented as the OID of the counter 2195 object in iscsiInitiatorLoginStatsTable for which the 2196 relevant instance was incremented. If no such failures have 2197 occurred since the last system boot, this attribute will 2198 have the value 0.0. A value of 0.0 may also be used to 2199 indicate a type that is not represented by any of 2200 the counters in iscsiInitiatorLoginStatsTable." 2201 ::= { iscsiInitiatorAttributesEntry 3 } 2203 iscsiIntrLastTgtFailureName OBJECT-TYPE 2204 SYNTAX IscsiName 2205 MAX-ACCESS read-only 2206 STATUS current 2207 DESCRIPTION 2208 "A UTF-8 string giving the name of the target that failed 2209 the last login attempt. If no such failures have occurred 2210 since the last system boot, this value is a zero-length string." 2211 ::= { iscsiInitiatorAttributesEntry 4 } 2213 iscsiIntrLastTgtFailureAddrType OBJECT-TYPE 2214 SYNTAX InetAddressType 2215 MAX-ACCESS read-only 2216 STATUS current 2217 DESCRIPTION 2218 "The type of Internet Network Address contained in the 2219 corresponding instance of the iscsiIntrLastTgtFailureAddr. 2220 The value 'dns' is not allowed. If no such failures have 2221 occurred since the last system boot, this value is zero." 2222 ::= { iscsiInitiatorAttributesEntry 5 } 2224 iscsiIntrLastTgtFailureAddr OBJECT-TYPE 2225 SYNTAX InetAddress 2226 MAX-ACCESS read-only 2227 STATUS current 2228 DESCRIPTION 2229 "An Internet Network Address, of the type specified by the 2230 object iscsiIntrLastTgtFailureAddrType, giving the host 2231 address of the target that failed the last login attempt. 2232 If no such failures have occurred since the last system boot, 2233 this value is a zero-length string." 2234 ::= { iscsiInitiatorAttributesEntry 6 } 2236 -- Initiator Login Stats Table 2238 iscsiInitiatorLoginStatsTable OBJECT-TYPE 2239 SYNTAX SEQUENCE OF IscsiInitiatorLoginStatsEntry 2240 MAX-ACCESS not-accessible 2241 STATUS current 2242 DESCRIPTION 2243 "A table of counters which keep track of the results of 2244 this initiator's login attempts." 2245 ::= { iscsiInitiator 2 } 2247 iscsiInitiatorLoginStatsEntry OBJECT-TYPE 2248 SYNTAX IscsiInitiatorLoginStatsEntry 2249 MAX-ACCESS not-accessible 2250 STATUS current 2251 DESCRIPTION 2252 "An entry (row) containing counters of each result 2253 of this initiator's login attempts." 2254 AUGMENTS { iscsiInitiatorAttributesEntry } 2255 ::= { iscsiInitiatorLoginStatsTable 1 } 2257 IscsiInitiatorLoginStatsEntry ::= SEQUENCE { 2258 iscsiIntrLoginAcceptRsps Counter32, 2259 iscsiIntrLoginOtherFailRsps Counter32, 2260 iscsiIntrLoginRedirectRsps Counter32, 2261 iscsiIntrLoginAuthFailRsps Counter32, 2262 iscsiIntrLoginAuthenticateFails Counter32, 2263 iscsiIntrLoginNegotiateFails Counter32, 2264 iscsiIntrLoginAuthorizeFails Counter32 2265 } 2267 iscsiIntrLoginAcceptRsps OBJECT-TYPE 2268 SYNTAX Counter32 2269 UNITS "successful logins" 2270 MAX-ACCESS read-only 2271 STATUS current 2272 DESCRIPTION 2273 "The count of Login Response PDUs with status 2274 0x0000, Accept Login, received by this initiator. 2275 If this counter has suffered a discontinuity, the time of the 2276 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2277 REFERENCE 2278 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2279 ::= { iscsiInitiatorLoginStatsEntry 1 } 2281 iscsiIntrLoginOtherFailRsps OBJECT-TYPE 2282 SYNTAX Counter32 2283 UNITS "failed logins" 2284 MAX-ACCESS read-only 2285 STATUS current 2286 DESCRIPTION 2287 "The count of Login Response PDUs received by this 2288 initiator with any status code not counted in the 2289 objects below. 2290 If this counter has suffered a discontinuity, the time of the 2291 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2292 REFERENCE 2293 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2294 ::= { iscsiInitiatorLoginStatsEntry 2 } 2296 iscsiIntrLoginRedirectRsps OBJECT-TYPE 2297 SYNTAX Counter32 2298 UNITS "failed logins" 2299 MAX-ACCESS read-only 2300 STATUS current 2301 DESCRIPTION 2302 "The count of Login Response PDUs with status class 0x01, 2303 Redirection, received by this initiator. 2304 If this counter has suffered a discontinuity, the time of the 2305 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2306 REFERENCE 2307 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2308 ::= { iscsiInitiatorLoginStatsEntry 3 } 2310 iscsiIntrLoginAuthFailRsps OBJECT-TYPE 2311 SYNTAX Counter32 2312 UNITS "failed logins" 2313 MAX-ACCESS read-only 2314 STATUS current 2315 DESCRIPTION 2316 "The count of Login Response PDUs with status class 0x201, 2317 Authentication Failed, received by this initiator. 2318 If this counter has suffered a discontinuity, the time of the 2319 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2320 REFERENCE 2321 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2322 ::= { iscsiInitiatorLoginStatsEntry 4 } 2324 iscsiIntrLoginAuthenticateFails OBJECT-TYPE 2325 SYNTAX Counter32 2326 UNITS "failed logins" 2327 MAX-ACCESS read-only 2328 STATUS current 2329 DESCRIPTION 2330 "The number of times the initiator has aborted a 2331 login because the target could not be authenticated. 2333 No response is generated. 2335 If this counter is incremented, an iscsiIntrLoginFailure 2336 notification should be generated. 2337 If this counter has suffered a discontinuity, the time of the 2338 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2339 REFERENCE 2340 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2341 ::= { iscsiInitiatorLoginStatsEntry 5 } 2343 iscsiIntrLoginNegotiateFails OBJECT-TYPE 2344 SYNTAX Counter32 2345 UNITS "failed logins" 2346 MAX-ACCESS read-only 2347 STATUS current 2348 DESCRIPTION 2349 "The number of times the initiator has aborted a 2350 login because parameter negotiation with the target 2351 failed. 2353 No response is generated. 2355 If this counter is incremented, an iscsiIntrLoginFailure 2356 notification should be generated. 2357 If this counter has suffered a discontinuity, the time of the 2358 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2359 REFERENCE 2360 "RFC cccc, Section 7.12, Negotiation Failures" 2361 ::= { iscsiInitiatorLoginStatsEntry 6 } 2363 iscsiIntrLoginAuthorizeFails OBJECT-TYPE 2364 SYNTAX Counter32 2365 UNITS "failed logins" 2366 MAX-ACCESS read-only 2367 STATUS current 2368 DESCRIPTION 2369 "The count of Login Response PDUs with status 0x0202, 2370 Forbidden Target, received by this initiator. 2372 If this counter is incremented, an iscsiIntrLoginFailure 2373 notification should be generated. 2374 If this counter has suffered a discontinuity, the time of the 2375 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2376 REFERENCE 2377 "RFC cccc, Section 11.13.5, Status-Class and Status-Detail" 2378 ::= { iscsiInitiatorLoginStatsEntry 7 } 2380 -- Initiator Logout Stats Table 2382 iscsiInitiatorLogoutStatsTable OBJECT-TYPE 2383 SYNTAX SEQUENCE OF IscsiInitiatorLogoutStatsEntry 2384 MAX-ACCESS not-accessible 2385 STATUS current 2386 DESCRIPTION 2387 "When an initiator attempts to send a Logout command, the target 2388 responds with a Logout Response that carries a status code. 2389 This table contains a list of counters of Logout Response 2390 PDUs of each status code that was received by each 2391 initiator belonging to this iSCSI instance present on this 2392 system." 2393 ::= { iscsiInitiator 3 } 2395 iscsiInitiatorLogoutStatsEntry OBJECT-TYPE 2396 SYNTAX IscsiInitiatorLogoutStatsEntry 2397 MAX-ACCESS not-accessible 2398 STATUS current 2399 DESCRIPTION 2400 "An entry (row) containing counters of Logout Response 2401 PDUs of each status code that was generated by this 2402 initiator." 2403 AUGMENTS { iscsiInitiatorAttributesEntry } 2404 ::= { iscsiInitiatorLogoutStatsTable 1 } 2406 IscsiInitiatorLogoutStatsEntry ::= SEQUENCE { 2407 iscsiIntrLogoutNormals Counter32, 2408 iscsiIntrLogoutOthers Counter32 2409 } 2411 iscsiIntrLogoutNormals OBJECT-TYPE 2412 SYNTAX Counter32 2413 UNITS "normal logouts" 2414 MAX-ACCESS read-only 2415 STATUS current 2416 DESCRIPTION 2417 "The count of Logout Command PDUs generated by this initiator 2418 with reason code 0 (closes the session). 2419 If this counter has suffered a discontinuity, the time of the 2420 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2421 REFERENCE 2422 "RFC cccc, Section 11.14.1, Reason Code" 2423 ::= { iscsiInitiatorLogoutStatsEntry 1 } 2425 iscsiIntrLogoutOthers OBJECT-TYPE 2426 SYNTAX Counter32 2427 UNITS "abnormal logouts" 2428 MAX-ACCESS read-only 2429 STATUS current 2430 DESCRIPTION 2431 "The count of Logout Command PDUs generated by this initiator 2432 with any status code other than 0. 2433 If this counter has suffered a discontinuity, the time of the 2434 last discontinuity is indicated in iscsiNodeDiscontinuityTime." 2435 REFERENCE 2436 "RFC cccc, Section 11.14.1, Reason Code" 2438 ::= { iscsiInitiatorLogoutStatsEntry 2 } 2440 --********************************************************************** 2442 iscsiIntrAuthorization OBJECT IDENTIFIER ::= { iscsiObjects 9 } 2444 -- Initiator Authorization Attributes Table 2446 iscsiIntrAuthAttributesTable OBJECT-TYPE 2447 SYNTAX SEQUENCE OF IscsiIntrAuthAttributesEntry 2448 MAX-ACCESS not-accessible 2449 STATUS current 2450 DESCRIPTION 2451 "A list of target identities that each initiator 2452 on the local system may access." 2453 ::= { iscsiIntrAuthorization 1 } 2455 iscsiIntrAuthAttributesEntry OBJECT-TYPE 2456 SYNTAX IscsiIntrAuthAttributesEntry 2457 MAX-ACCESS not-accessible 2458 STATUS current 2459 DESCRIPTION 2460 "An entry (row) containing management information applicable 2461 to a particular initiator node's authorized target identity." 2462 INDEX { iscsiInstIndex, iscsiNodeIndex, iscsiIntrAuthIndex } 2463 ::= { iscsiIntrAuthAttributesTable 1 } 2465 IscsiIntrAuthAttributesEntry ::= SEQUENCE { 2466 iscsiIntrAuthIndex Unsigned32, 2467 iscsiIntrAuthRowStatus RowStatus, 2468 iscsiIntrAuthIdentity RowPointer, 2469 iscsiIntrAuthStorageType StorageType 2470 } 2472 iscsiIntrAuthIndex OBJECT-TYPE 2473 SYNTAX Unsigned32 (1..4294967295) 2474 MAX-ACCESS not-accessible 2475 STATUS current 2476 DESCRIPTION 2477 "An arbitrary integer used to uniquely identify a 2478 particular initiator node's authorized target 2479 identity within an iSCSI instance present on the 2480 local system. This index value must not be modified 2481 or reused by an agent unless a reboot has occurred. 2482 An agent should attempt to keep this value persistent 2483 across reboots." 2484 ::= { iscsiIntrAuthAttributesEntry 1 } 2485 iscsiIntrAuthRowStatus OBJECT-TYPE 2486 SYNTAX RowStatus 2487 MAX-ACCESS read-create 2488 STATUS current 2489 DESCRIPTION 2490 "This field allows entries to be dynamically added and 2491 removed from this table via SNMP. When adding a row to 2492 this table, all non-Index/RowStatus objects must be set. 2493 When the value of this object is 'active', the values of 2494 the other objects in this table cannot be changed. 2495 Rows may be discarded using RowStatus." 2496 ::= { iscsiIntrAuthAttributesEntry 2 } 2498 iscsiIntrAuthIdentity OBJECT-TYPE 2499 SYNTAX RowPointer 2500 MAX-ACCESS read-create 2501 STATUS current 2502 DESCRIPTION 2503 "A pointer to the corresponding user entry in the IPS-AUTH 2504 MIB module to which this initiator node should attempt to 2505 establish an iSCSI session." 2506 REFERENCE 2507 "IPS-AUTH MIB, RFC 4545" 2508 ::= { iscsiIntrAuthAttributesEntry 3 } 2510 iscsiIntrAuthStorageType OBJECT-TYPE 2511 SYNTAX StorageType 2512 MAX-ACCESS read-create 2513 STATUS current 2514 DESCRIPTION 2515 "The storage type for this row. Rows in this table that were 2516 created through an external process (e.g. not created via 2517 this MIB) may have a storage type of readOnly or permanent. 2519 Conceptual rows having the value 'permanent' need not 2520 allow write access to any columnar objects in the row." 2521 DEFVAL { nonVolatile } 2522 ::= { iscsiIntrAuthAttributesEntry 4 } 2524 --********************************************************************** 2526 iscsiSession OBJECT IDENTIFIER ::= { iscsiObjects 10 } 2528 -- Session Attributes Table 2530 iscsiSessionAttributesTable OBJECT-TYPE 2531 SYNTAX SEQUENCE OF IscsiSessionAttributesEntry 2532 MAX-ACCESS not-accessible 2533 STATUS current 2534 DESCRIPTION 2535 "A list of sessions belonging to each iSCSI instance 2536 present on the system." 2537 ::= { iscsiSession 1 } 2539 iscsiSessionAttributesEntry OBJECT-TYPE 2540 SYNTAX IscsiSessionAttributesEntry 2541 MAX-ACCESS not-accessible 2542 STATUS current 2543 DESCRIPTION 2544 "An entry (row) containing management information applicable 2545 to a particular session. 2547 If this session is a discovery session that is not attached 2548 to any particular node, the iscsiSsnNodeIndex will be zero. 2549 Otherwise, the iscsiSsnNodeIndex will have the same value as 2550 iscsiNodeIndex." 2551 INDEX { iscsiInstIndex, iscsiSsnNodeIndex, iscsiSsnIndex } 2552 ::= { iscsiSessionAttributesTable 1 } 2554 IscsiSessionAttributesEntry ::= SEQUENCE { 2555 iscsiSsnNodeIndex Unsigned32, 2556 iscsiSsnIndex Unsigned32, 2557 iscsiSsnDirection INTEGER, 2558 iscsiSsnInitiatorName IscsiName, 2559 iscsiSsnTargetName IscsiName, 2560 iscsiSsnTSIH Unsigned32, 2561 iscsiSsnISID OCTET STRING, 2562 iscsiSsnInitiatorAlias SnmpAdminString, 2563 iscsiSsnTargetAlias SnmpAdminString, 2564 iscsiSsnInitialR2T TruthValue, 2565 iscsiSsnImmediateData TruthValue, 2566 iscsiSsnType INTEGER, 2567 iscsiSsnMaxOutstandingR2T Unsigned32, 2568 iscsiSsnFirstBurstLength Unsigned32, 2569 iscsiSsnMaxBurstLength Unsigned32, 2570 iscsiSsnConnectionNumber Gauge32, 2571 iscsiSsnAuthIdentity RowPointer, 2572 iscsiSsnDataSequenceInOrder TruthValue, 2573 iscsiSsnDataPDUInOrder TruthValue, 2574 iscsiSsnErrorRecoveryLevel Unsigned32, 2575 iscsiSsnDiscontinuityTime TimeStamp, 2576 iscsiSsnProtocolLevel Unsigned32, 2577 iscsiSsnTaskReporting BITS 2578 } 2580 iscsiSsnNodeIndex OBJECT-TYPE 2581 SYNTAX Unsigned32 (0..4294967295) 2582 MAX-ACCESS not-accessible 2583 STATUS current 2584 DESCRIPTION 2585 "An arbitrary integer used to uniquely identify a 2586 particular node within an iSCSI instance present 2587 on the local system. For normal, non-discovery 2588 sessions, this value will map to the iscsiNodeIndex. 2589 For discovery sessions that do not have a node 2590 associated, the value 0 (zero) is used." 2591 ::= { iscsiSessionAttributesEntry 1 } 2593 iscsiSsnIndex OBJECT-TYPE 2594 SYNTAX Unsigned32 (1..4294967295) 2595 MAX-ACCESS not-accessible 2596 STATUS current 2597 DESCRIPTION 2598 "An arbitrary integer used to uniquely identify a 2599 particular session within an iSCSI instance present 2600 on the local system. An agent should attempt to 2601 not reuse index values unless a reboot has occurred. 2602 iSCSI sessions are destroyed during a reboot; rows 2603 in this table are not persistent across reboots." 2604 ::= { iscsiSessionAttributesEntry 2 } 2606 iscsiSsnDirection OBJECT-TYPE 2607 SYNTAX INTEGER { 2608 inboundSession(1), 2609 outboundSession(2) 2610 } 2611 MAX-ACCESS read-only 2612 STATUS current 2613 DESCRIPTION 2614 "Direction of iSCSI session: 2615 inboundSession - session is established from an external 2616 initiator to a target within this iSCSI 2617 instance. 2618 outboundSession - session is established from an initiator 2619 within this iSCSI instance to an external 2620 target." 2621 ::= { iscsiSessionAttributesEntry 3 } 2623 iscsiSsnInitiatorName OBJECT-TYPE 2624 SYNTAX IscsiName 2625 MAX-ACCESS read-only 2626 STATUS current 2627 DESCRIPTION 2628 "If iscsiSsnDirection is Inbound, this object is a 2629 UTF-8 string that will contain the name of the remote 2630 initiator. If this session is a discovery session that 2631 does not specify a particular initiator, this object 2632 will contain a zero-length string. 2634 If iscsiSsnDirection is Outbound, this object will 2635 contain a zero-length string." 2636 ::= { iscsiSessionAttributesEntry 4 } 2638 iscsiSsnTargetName OBJECT-TYPE 2639 SYNTAX IscsiName 2640 MAX-ACCESS read-only 2641 STATUS current 2642 DESCRIPTION 2643 "If iscsiSsnDirection is Outbound, this object is a 2644 UTF-8 string that will contain the name of the remote 2645 target. If this session is a discovery session that 2646 does not specify a particular target, this object will 2647 contain a zero-length string. 2649 If iscsiSsnDirection is Inbound, this object will 2650 contain a zero-length string." 2651 ::= { iscsiSessionAttributesEntry 5 } 2653 iscsiSsnTSIH OBJECT-TYPE 2654 SYNTAX Unsigned32 (1..65535) 2655 MAX-ACCESS read-only 2656 STATUS current 2657 DESCRIPTION 2658 "The target-defined identification handle for this session." 2659 REFERENCE 2660 "RFC cccc, Section 11.12.6, TSIH" 2661 ::= { iscsiSessionAttributesEntry 6 } 2663 iscsiSsnISID OBJECT-TYPE 2664 SYNTAX OCTET STRING (SIZE(6)) 2665 MAX-ACCESS read-only 2666 STATUS current 2667 DESCRIPTION 2668 "The initiator-defined portion of the iSCSI Session ID." 2669 REFERENCE 2670 "RFC cccc, Section 11.12.5, ISID" 2671 ::= { iscsiSessionAttributesEntry 7 } 2673 iscsiSsnInitiatorAlias OBJECT-TYPE 2674 SYNTAX SnmpAdminString 2675 MAX-ACCESS read-only 2676 STATUS current 2677 DESCRIPTION 2678 "A UTF-8 string that gives the alias communicated by the 2679 initiator end of the session during the login phase. 2681 If no alias exists, the value is a zero-length string." 2682 REFERENCE 2683 "RFC cccc, Section 13.7, InitiatorAlias" 2684 ::= { iscsiSessionAttributesEntry 8 } 2686 iscsiSsnTargetAlias OBJECT-TYPE 2687 SYNTAX SnmpAdminString 2688 MAX-ACCESS read-only 2689 STATUS current 2690 DESCRIPTION 2691 "A UTF-8 string that gives the alias communicated by the 2692 target end of the session during the login phase. 2694 If no alias exists, the value is a zero-length string." 2695 REFERENCE 2696 "RFC cccc, Section 13.6, TargetAlias" 2697 ::= { iscsiSessionAttributesEntry 9 } 2699 iscsiSsnInitialR2T OBJECT-TYPE 2700 SYNTAX TruthValue 2701 MAX-ACCESS read-only 2702 STATUS current 2703 DESCRIPTION 2704 "If set to true, indicates that the initiator must wait 2705 for an R2T before sending to the target. If set to false, 2706 the initiator may send data immediately, within limits set 2707 by iscsiSsnFirstBurstLength and the expected data transfer 2708 length of the request." 2709 REFERENCE 2710 "RFC cccc, Section 13.10, InitialR2T" 2711 ::= { iscsiSessionAttributesEntry 10 } 2713 iscsiSsnImmediateData OBJECT-TYPE 2714 SYNTAX TruthValue 2715 MAX-ACCESS read-only 2716 STATUS current 2717 DESCRIPTION 2718 "Indicates whether the initiator and target have agreed to 2719 support immediate data on this session." 2720 REFERENCE 2721 "RFC cccc, Section 13.11, ImmediateData" 2722 ::= { iscsiSessionAttributesEntry 11 } 2724 iscsiSsnType OBJECT-TYPE 2725 SYNTAX INTEGER { 2726 normalSession(1), 2727 discoverySession(2) 2728 } 2730 MAX-ACCESS read-only 2731 STATUS current 2732 DESCRIPTION 2733 "Type of iSCSI session: 2734 normalSession - session is a normal iSCSI session 2735 discoverySession - session is being used only for discovery." 2736 REFERENCE 2737 "RFC cccc, Section 13.21, SessionType" 2738 ::= { iscsiSessionAttributesEntry 12 } 2740 iscsiSsnMaxOutstandingR2T OBJECT-TYPE 2741 SYNTAX Unsigned32 (1..65535) 2742 UNITS "R2Ts" 2743 MAX-ACCESS read-only 2744 STATUS current 2745 DESCRIPTION 2746 "The maximum number of outstanding requests-to-transmit 2747 (R2Ts) per iSCSI task within this session." 2748 REFERENCE 2749 "RFC cccc, Section 13.17, MaxOutstandingR2T" 2750 ::= { iscsiSessionAttributesEntry 13 } 2752 iscsiSsnFirstBurstLength OBJECT-TYPE 2753 SYNTAX Unsigned32 (512..16777215) 2754 UNITS "bytes" 2755 MAX-ACCESS read-only 2756 STATUS current 2757 DESCRIPTION 2758 "The maximum length supported for unsolicited data sent 2759 within this session." 2760 REFERENCE 2761 "RFC cccc, Section 13.14, FirstBurstLength" 2762 ::= { iscsiSessionAttributesEntry 14 } 2764 iscsiSsnMaxBurstLength OBJECT-TYPE 2765 SYNTAX Unsigned32 (512..16777215) 2766 UNITS "bytes" 2767 MAX-ACCESS read-only 2768 STATUS current 2769 DESCRIPTION 2770 "The maximum number of bytes that can be sent within 2771 a single sequence of Data-In or Data-Out PDUs." 2772 REFERENCE 2773 "RFC cccc, Section 13.13, MaxBurstLength" 2774 ::= { iscsiSessionAttributesEntry 15 } 2776 iscsiSsnConnectionNumber OBJECT-TYPE 2777 SYNTAX Gauge32 (1..65535) 2778 UNITS "connections" 2779 MAX-ACCESS read-only 2780 STATUS current 2781 DESCRIPTION 2782 "The number of transport protocol connections that currently 2783 belong to this session." 2784 ::= { iscsiSessionAttributesEntry 16 } 2786 iscsiSsnAuthIdentity OBJECT-TYPE 2787 SYNTAX RowPointer 2788 MAX-ACCESS read-only 2789 STATUS current 2790 DESCRIPTION 2791 "This object contains a pointer to a row in the 2792 IPS-AUTH MIB module that identifies the authentication 2793 identity being used on this session, as communicated 2794 during the login phase." 2795 REFERENCE 2796 "IPS-AUTH MIB, RFC 4545" 2797 ::= { iscsiSessionAttributesEntry 17 } 2799 iscsiSsnDataSequenceInOrder OBJECT-TYPE 2800 SYNTAX TruthValue 2801 MAX-ACCESS read-only 2802 STATUS current 2803 DESCRIPTION 2804 "False indicates that iSCSI data PDU sequences may 2805 be transferred in any order. True indicates that 2806 data PDU sequences must be transferred using 2807 continuously increasing offsets, except during 2808 error recovery." 2809 REFERENCE 2810 "RFC cccc, Section 13.19, DataSequenceInOrder" 2811 ::= { iscsiSessionAttributesEntry 18 } 2813 iscsiSsnDataPDUInOrder OBJECT-TYPE 2814 SYNTAX TruthValue 2815 MAX-ACCESS read-only 2816 STATUS current 2817 DESCRIPTION 2818 "False indicates that iSCSI data PDUs within sequences 2819 may be in any order. True indicates that data PDUs 2820 within sequences must be at continuously increasing 2821 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-04 & 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 } 2924 iscsiSsnRspPDUs OBJECT-TYPE 2925 SYNTAX Counter32 2926 UNITS "PDUs" 2927 MAX-ACCESS read-only 2928 STATUS current 2929 DESCRIPTION 2930 "The count of Response PDUs transferred on this session. 2931 If this counter has suffered a discontinuity, the time of the 2932 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 2933 ::= { iscsiSessionStatsEntry 2 } 2935 iscsiSsnTxDataOctets OBJECT-TYPE 2936 SYNTAX Counter64 2937 UNITS "octets" 2938 MAX-ACCESS read-only 2939 STATUS current 2940 DESCRIPTION 2941 "The count of data octets that were transmitted by 2942 the local iSCSI node on this session. 2943 If this counter has suffered a discontinuity, the time of the 2944 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 2945 ::= { iscsiSessionStatsEntry 3 } 2947 iscsiSsnRxDataOctets OBJECT-TYPE 2948 SYNTAX Counter64 2949 UNITS "octets" 2950 MAX-ACCESS read-only 2951 STATUS current 2952 DESCRIPTION 2953 "The count of data octets that were received by 2954 the local iSCSI node on this session. 2955 If this counter has suffered a discontinuity, the time of the 2956 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 2957 ::= { iscsiSessionStatsEntry 4 } 2959 iscsiSsnLCTxDataOctets OBJECT-TYPE 2960 SYNTAX Counter32 2961 UNITS "octets" 2962 MAX-ACCESS read-only 2963 STATUS current 2964 DESCRIPTION 2965 "A Low Capacity shadow object of iscsiSsnTxDataOctets 2966 for those systems that don't support Counter64. 2967 If this counter has suffered a discontinuity, the time of the 2968 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 2969 ::= { iscsiSessionStatsEntry 5 } 2971 iscsiSsnLCRxDataOctets OBJECT-TYPE 2972 SYNTAX Counter32 2973 UNITS "octets" 2974 MAX-ACCESS read-only 2975 STATUS current 2976 DESCRIPTION 2977 "A Low Capacity shadow object of iscsiSsnRxDataOctets 2978 for those systems that don't support Counter64. 2979 If this counter has suffered a discontinuity, the time of the 2980 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 2981 ::= { iscsiSessionStatsEntry 6 } 2983 -- Session Connection Error Stats Table 2985 iscsiSessionCxnErrorStatsTable OBJECT-TYPE 2986 SYNTAX SEQUENCE OF IscsiSessionCxnErrorStatsEntry 2987 MAX-ACCESS not-accessible 2988 STATUS current 2989 DESCRIPTION 2990 "A list of error counters for each of the sessions 2991 present on this system." 2992 ::= { iscsiSession 3 } 2994 iscsiSessionCxnErrorStatsEntry OBJECT-TYPE 2995 SYNTAX IscsiSessionCxnErrorStatsEntry 2996 MAX-ACCESS not-accessible 2997 STATUS current 2998 DESCRIPTION 2999 "An entry (row) containing error counters for 3000 a particular session." 3001 AUGMENTS { iscsiSessionAttributesEntry } 3002 ::= { iscsiSessionCxnErrorStatsTable 1 } 3004 IscsiSessionCxnErrorStatsEntry ::= SEQUENCE { 3005 iscsiSsnCxnDigestErrors Counter32, 3006 iscsiSsnCxnTimeoutErrors Counter32 3007 } 3009 iscsiSsnCxnDigestErrors OBJECT-TYPE 3010 SYNTAX Counter32 3011 UNITS "PDUs" 3012 MAX-ACCESS read-only 3013 STATUS current 3014 DESCRIPTION 3015 "The count of PDUs that were received on the session and 3016 contained header or data digest errors. 3017 If this counter has suffered a discontinuity, the time of the 3018 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 3019 REFERENCE 3020 "RFC cccc, Section 7.8, Digest Errors" 3021 ::= { iscsiSessionCxnErrorStatsEntry 1 } 3022 iscsiSsnCxnTimeoutErrors OBJECT-TYPE 3023 SYNTAX Counter32 3024 UNITS "connections" 3025 MAX-ACCESS read-only 3026 STATUS current 3027 DESCRIPTION 3028 "The count of connections within this session 3029 that have been terminated due to timeout. 3030 If this counter has suffered a discontinuity, the time of the 3031 last discontinuity is indicated in iscsiSsnDiscontinuityTime." 3032 REFERENCE 3033 "RFC cccc, Section 7.5, Connection Timeout Management" 3034 ::= { iscsiSessionCxnErrorStatsEntry 2 } 3036 --********************************************************************** 3038 iscsiConnection OBJECT IDENTIFIER ::= { iscsiObjects 11 } 3040 -- Connection Attributes Table 3042 iscsiConnectionAttributesTable OBJECT-TYPE 3043 SYNTAX SEQUENCE OF IscsiConnectionAttributesEntry 3044 MAX-ACCESS not-accessible 3045 STATUS current 3046 DESCRIPTION 3047 "A list of connections belonging to each iSCSI instance 3048 present on the system." 3049 ::= { iscsiConnection 1 } 3051 iscsiConnectionAttributesEntry OBJECT-TYPE 3052 SYNTAX IscsiConnectionAttributesEntry 3053 MAX-ACCESS not-accessible 3054 STATUS current 3055 DESCRIPTION 3056 "An entry (row) containing management information applicable 3057 to a particular connection." 3058 INDEX { iscsiInstIndex, iscsiSsnNodeIndex, iscsiSsnIndex, 3059 iscsiCxnIndex } 3060 ::= { iscsiConnectionAttributesTable 1 } 3062 IscsiConnectionAttributesEntry ::= SEQUENCE { 3063 iscsiCxnIndex Unsigned32, 3064 iscsiCxnCid Unsigned32, 3065 iscsiCxnState INTEGER, 3066 iscsiCxnAddrType InetAddressType, 3067 iscsiCxnLocalAddr InetAddress, 3068 iscsiCxnProtocol IscsiTransportProtocol, 3069 iscsiCxnLocalPort InetPortNumber, 3070 iscsiCxnRemoteAddr InetAddress, 3071 iscsiCxnRemotePort InetPortNumber, 3072 iscsiCxnMaxRecvDataSegLength Unsigned32, 3073 iscsiCxnMaxXmitDataSegLength Unsigned32, 3074 iscsiCxnHeaderIntegrity IscsiDigestMethod, 3075 iscsiCxnDataIntegrity IscsiDigestMethod, 3076 iscsiCxnRecvMarker TruthValue, 3077 iscsiCxnSendMarker TruthValue, 3078 iscsiCxnVersionActive Unsigned32 3079 } 3081 iscsiCxnIndex OBJECT-TYPE 3082 SYNTAX Unsigned32 (1..4294967295) 3083 MAX-ACCESS not-accessible 3084 STATUS current 3085 DESCRIPTION 3086 "An arbitrary integer used to uniquely identify a 3087 particular connection of a particular session within 3088 an iSCSI instance present on the local system. An 3089 agent should attempt to not reuse index values unless 3090 a reboot has occurred. iSCSI connections are destroyed 3091 during a reboot; rows in this table are not persistent 3092 across reboots." 3094 ::= { iscsiConnectionAttributesEntry 1 } 3096 iscsiCxnCid OBJECT-TYPE 3097 SYNTAX Unsigned32 (1..65535) 3098 MAX-ACCESS read-only 3099 STATUS current 3100 DESCRIPTION 3101 "The iSCSI Connection ID for this connection." 3102 ::= { iscsiConnectionAttributesEntry 2 } 3104 iscsiCxnState OBJECT-TYPE 3105 SYNTAX INTEGER { 3106 login(1), 3107 full(2), 3108 logout(3) 3109 } 3110 MAX-ACCESS read-only 3111 STATUS current 3112 DESCRIPTION 3113 "The current state of this connection, from an iSCSI negotiation 3114 point of view. Here are the states: 3116 login - The transport protocol connection has been established, 3117 but a valid iSCSI login response with the final bit set 3118 has not been sent or received. 3120 full - A valid iSCSI login response with the final bit set 3121 has been sent or received. 3122 logout - A valid iSCSI logout command has been sent or 3123 received, but the transport protocol connection has 3124 not yet been closed." 3125 ::= { iscsiConnectionAttributesEntry 3 } 3127 iscsiCxnAddrType OBJECT-TYPE 3128 SYNTAX InetAddressType 3129 MAX-ACCESS read-only 3130 STATUS current 3131 DESCRIPTION 3132 "The type of Internet Network Addresses contained in the 3133 corresponding instances of iscsiCxnLocalAddr and 3134 iscsiCxnRemoteAddr. 3135 The value 'dns' is not allowed." 3136 ::= { iscsiConnectionAttributesEntry 4 } 3138 iscsiCxnLocalAddr OBJECT-TYPE 3139 SYNTAX InetAddress 3140 MAX-ACCESS read-only 3141 STATUS current 3142 DESCRIPTION 3143 "The local Internet Network Address, of the type specified 3144 by iscsiCxnAddrType, used by this connection." 3145 ::= { iscsiConnectionAttributesEntry 5 } 3147 iscsiCxnProtocol OBJECT-TYPE 3148 SYNTAX IscsiTransportProtocol 3149 MAX-ACCESS read-only 3150 STATUS current 3151 DESCRIPTION 3152 "The transport protocol over which this connection is 3153 running." 3154 ::= { iscsiConnectionAttributesEntry 6 } 3156 iscsiCxnLocalPort OBJECT-TYPE 3157 SYNTAX InetPortNumber 3158 MAX-ACCESS read-only 3159 STATUS current 3160 DESCRIPTION 3161 "The local transport protocol port used by this connection. 3162 This object cannot have the value zero, since it represents 3163 an established connection." 3164 ::= { iscsiConnectionAttributesEntry 7 } 3166 iscsiCxnRemoteAddr OBJECT-TYPE 3167 SYNTAX InetAddress 3168 MAX-ACCESS read-only 3169 STATUS current 3170 DESCRIPTION 3171 "The remote Internet Network Address, of the type specified 3172 by iscsiCxnAddrType, used by this connection." 3173 ::= { iscsiConnectionAttributesEntry 8 } 3175 iscsiCxnRemotePort OBJECT-TYPE 3176 SYNTAX InetPortNumber 3177 MAX-ACCESS read-only 3178 STATUS current 3179 DESCRIPTION 3180 "The remote transport protocol port used by this connection. 3181 This object cannot have the value zero, since it represents 3182 an established connection." 3183 ::= { iscsiConnectionAttributesEntry 9 } 3185 iscsiCxnMaxRecvDataSegLength OBJECT-TYPE 3186 SYNTAX Unsigned32 (512..16777215) 3187 UNITS "bytes" 3188 MAX-ACCESS read-only 3189 STATUS current 3190 DESCRIPTION 3191 "The maximum data payload size supported for command 3192 or data PDUs able to be received on this connection." 3193 REFERENCE 3194 "RFC cccc, Section 13.12, MaxRecvDataSegmentLength" 3195 ::= { iscsiConnectionAttributesEntry 10 } 3197 iscsiCxnMaxXmitDataSegLength OBJECT-TYPE 3198 SYNTAX Unsigned32 (512..16777215) 3199 UNITS "bytes" 3200 MAX-ACCESS read-only 3201 STATUS current 3202 DESCRIPTION 3203 "The maximum data payload size supported for command 3204 or data PDUs to be sent on this connection." 3205 REFERENCE 3206 "RFC cccc, Section 13.12, MaxRecvDataSegmentLength" 3207 ::= { iscsiConnectionAttributesEntry 11 } 3209 iscsiCxnHeaderIntegrity OBJECT-TYPE 3210 SYNTAX IscsiDigestMethod 3211 MAX-ACCESS read-only 3212 STATUS current 3213 DESCRIPTION 3214 "This object identifies the iSCSI header 3215 digest scheme in use within this connection." 3216 ::= { iscsiConnectionAttributesEntry 12 } 3217 iscsiCxnDataIntegrity OBJECT-TYPE 3218 SYNTAX IscsiDigestMethod 3219 MAX-ACCESS read-only 3220 STATUS current 3221 DESCRIPTION 3222 "This object identifies the iSCSI data 3223 digest scheme in use within this connection." 3224 ::= { iscsiConnectionAttributesEntry 13 } 3226 iscsiCxnRecvMarker OBJECT-TYPE 3227 SYNTAX TruthValue 3228 MAX-ACCESS read-only 3229 STATUS deprecated 3230 DESCRIPTION 3231 "This object indicates whether or not this connection 3232 is receiving markers in its incoming data stream." 3233 REFERENCE 3234 "[RFCcccc], 13.25 Obsoleted Keys." 3235 ::= { iscsiConnectionAttributesEntry 14 } 3237 iscsiCxnSendMarker OBJECT-TYPE 3238 SYNTAX TruthValue 3239 MAX-ACCESS read-only 3240 STATUS deprecated 3241 DESCRIPTION 3242 "This object indicates whether or not this connection 3243 is inserting markers in its outgoing data stream." 3244 REFERENCE 3245 "[RFCcccc], 13.25 Obsoleted Keys." 3246 ::= { iscsiConnectionAttributesEntry 15 } 3248 iscsiCxnVersionActive OBJECT-TYPE 3249 SYNTAX Unsigned32 (0..255) 3250 MAX-ACCESS read-only 3251 STATUS current 3252 DESCRIPTION 3253 "Active version number of the iSCSI specification negotiated 3254 on this connection." 3255 REFERENCE 3256 "RFC cccc, Section 11.12, Login Request" 3257 ::= { iscsiConnectionAttributesEntry 16 } 3259 --********************************************************************** 3260 -- Notifications 3262 iscsiTgtLoginFailure NOTIFICATION-TYPE 3263 OBJECTS { 3264 iscsiTgtLoginFailures, 3265 iscsiTgtLastFailureType, 3266 iscsiTgtLastIntrFailureName, 3267 iscsiTgtLastIntrFailureAddrType, 3268 iscsiTgtLastIntrFailureAddr 3269 } 3270 STATUS current 3271 DESCRIPTION 3272 "Sent when a login is failed by a target. 3274 To avoid sending an excessive number of notifications due 3275 to multiple errors counted, an SNMP agent implementing this 3276 notification SHOULD NOT send more than 3 notifications of 3277 this type in any 10-second time period." 3278 ::= { iscsiNotifications 1 } 3280 iscsiIntrLoginFailure NOTIFICATION-TYPE 3281 OBJECTS { 3282 iscsiIntrLoginFailures, 3283 iscsiIntrLastFailureType, 3284 iscsiIntrLastTgtFailureName, 3285 iscsiIntrLastTgtFailureAddrType, 3286 iscsiIntrLastTgtFailureAddr 3287 } 3288 STATUS current 3289 DESCRIPTION 3290 "Sent when a login is failed by an initiator. 3292 To avoid sending an excessive number of notifications due 3293 to multiple errors counted, an SNMP agent implementing this 3294 notification SHOULD NOT send more than 3 notifications of 3295 this type in any 10-second time period." 3296 ::= { iscsiNotifications 2 } 3298 iscsiInstSessionFailure NOTIFICATION-TYPE 3299 OBJECTS { 3300 iscsiInstSsnFailures, 3301 iscsiInstLastSsnFailureType, 3302 iscsiInstLastSsnRmtNodeName 3303 } 3304 STATUS current 3305 DESCRIPTION 3306 "Sent when an active session is failed by either the initiator 3307 or the target. 3309 To avoid sending an excessive number of notifications due 3310 to multiple errors counted, an SNMP agent implementing this 3311 notification SHOULD NOT send more than 3 notifications of 3312 this type in any 10-second time period." 3313 ::= { iscsiNotifications 3 } 3314 --********************************************************************** 3316 -- Conformance Statements 3318 iscsiCompliances OBJECT IDENTIFIER ::= { iscsiConformance 1 } 3319 iscsiGroups OBJECT IDENTIFIER ::= { iscsiConformance 2 } 3321 iscsiInstanceAttributesGroup OBJECT-GROUP 3322 OBJECTS { 3323 iscsiInstDescr, 3324 iscsiInstVersionMin, 3325 iscsiInstVersionMax, 3326 iscsiInstVendorID, 3327 iscsiInstVendorVersion, 3328 iscsiInstPortalNumber, 3329 iscsiInstNodeNumber, 3330 iscsiInstSessionNumber, 3331 iscsiInstSsnFailures, 3332 iscsiInstLastSsnFailureType, 3333 iscsiInstLastSsnRmtNodeName, 3334 iscsiInstDiscontinuityTime, 3335 iscsiInstXNodeArchitecture 3336 } 3337 STATUS current 3338 DESCRIPTION 3339 "A collection of objects providing information about iSCSI 3340 instances." 3341 ::= { iscsiGroups 1 } 3343 iscsiInstanceSsnErrorStatsGroup OBJECT-GROUP 3344 OBJECTS { 3345 iscsiInstSsnDigestErrors, 3346 iscsiInstSsnCxnTimeoutErrors, 3347 iscsiInstSsnFormatErrors 3348 } 3349 STATUS current 3350 DESCRIPTION 3351 "A collection of objects providing information about 3352 errors that have caused a session failure for an 3353 iSCSI instance." 3354 ::= { iscsiGroups 2 } 3356 iscsiPortalAttributesGroup OBJECT-GROUP 3357 OBJECTS { 3358 iscsiPortalRowStatus, 3359 iscsiPortalStorageType, 3360 iscsiPortalRoles, 3361 iscsiPortalAddrType, 3362 iscsiPortalAddr, 3363 iscsiPortalProtocol, 3364 iscsiPortalMaxRecvDataSegLength, 3365 iscsiPortalPrimaryHdrDigest, 3366 iscsiPortalPrimaryDataDigest, 3367 iscsiPortalSecondaryHdrDigest, 3368 iscsiPortalSecondaryDataDigest, 3369 iscsiPortalRecvMarker 3370 } 3371 STATUS deprecated 3372 DESCRIPTION 3373 "A collection of objects providing information about 3374 the transport protocol endpoints of the local targets. 3375 This object group is deprecated because the marker key 3376 is obsolete." 3377 REFERENCE 3378 "[RFCcccc], 13.25 Obsoleted Keys." 3379 ::= { iscsiGroups 3 } 3381 iscsiTgtPortalAttributesGroup OBJECT-GROUP 3382 OBJECTS { 3383 iscsiTgtPortalPort, 3384 iscsiTgtPortalTag 3385 } 3386 STATUS current 3387 DESCRIPTION 3388 "A collection of objects providing information about 3389 the transport protocol endpoints of the local targets." 3390 ::= { iscsiGroups 4 } 3392 iscsiIntrPortalAttributesGroup OBJECT-GROUP 3393 OBJECTS { 3394 iscsiIntrPortalTag 3395 } 3396 STATUS current 3397 DESCRIPTION 3398 "An object providing information about 3399 the portal tags used by the local initiators." 3400 ::= { iscsiGroups 5 } 3402 iscsiNodeAttributesGroup OBJECT-GROUP 3403 OBJECTS { 3404 iscsiNodeName, 3405 iscsiNodeAlias, 3406 iscsiNodeRoles, 3407 iscsiNodeTransportType, 3408 iscsiNodeInitialR2T, 3409 iscsiNodeImmediateData, 3410 iscsiNodeMaxOutstandingR2T, 3411 iscsiNodeFirstBurstLength, 3412 iscsiNodeMaxBurstLength, 3413 iscsiNodeMaxConnections, 3414 iscsiNodeDataSequenceInOrder, 3415 iscsiNodeDataPDUInOrder, 3416 iscsiNodeDefaultTime2Wait, 3417 iscsiNodeDefaultTime2Retain, 3418 iscsiNodeErrorRecoveryLevel, 3419 iscsiNodeDiscontinuityTime, 3420 iscsiNodeStorageType 3421 } 3422 STATUS current 3423 DESCRIPTION 3424 "A collection of objects providing information about all 3425 local targets." 3426 ::= { iscsiGroups 6 } 3428 iscsiTargetAttributesGroup OBJECT-GROUP 3429 OBJECTS { 3430 iscsiTgtLoginFailures, 3431 iscsiTgtLastFailureTime, 3432 iscsiTgtLastFailureType, 3433 iscsiTgtLastIntrFailureName, 3434 iscsiTgtLastIntrFailureAddrType, 3435 iscsiTgtLastIntrFailureAddr 3436 } 3437 STATUS current 3438 DESCRIPTION 3439 "A collection of objects providing information about all 3440 local targets." 3441 ::= { iscsiGroups 7 } 3443 iscsiTargetLoginStatsGroup OBJECT-GROUP 3444 OBJECTS { 3445 iscsiTgtLoginAccepts, 3446 iscsiTgtLoginOtherFails, 3447 iscsiTgtLoginRedirects, 3448 iscsiTgtLoginAuthorizeFails, 3449 iscsiTgtLoginAuthenticateFails, 3450 iscsiTgtLoginNegotiateFails 3451 } 3452 STATUS current 3453 DESCRIPTION 3454 "A collection of objects providing information about all 3455 login attempts by remote initiators to local targets." 3456 ::= { iscsiGroups 8 } 3458 iscsiTargetLogoutStatsGroup OBJECT-GROUP 3459 OBJECTS { 3460 iscsiTgtLogoutNormals, 3461 iscsiTgtLogoutOthers 3462 } 3463 STATUS current 3464 DESCRIPTION 3465 "A collection of objects providing information about all 3466 logout events between remote initiators and local targets." 3467 ::= { iscsiGroups 9 } 3469 iscsiTargetAuthGroup OBJECT-GROUP 3470 OBJECTS { 3471 iscsiTgtAuthRowStatus, 3472 iscsiTgtAuthStorageType, 3473 iscsiTgtAuthIdentity 3474 } 3475 STATUS current 3476 DESCRIPTION 3477 "A collection of objects providing information about all 3478 remote initiators that are authorized to connect to local 3479 targets." 3480 ::= { iscsiGroups 10 } 3482 iscsiInitiatorAttributesGroup OBJECT-GROUP 3483 OBJECTS { 3484 iscsiIntrLoginFailures, 3485 iscsiIntrLastFailureTime, 3486 iscsiIntrLastFailureType, 3487 iscsiIntrLastTgtFailureName, 3488 iscsiIntrLastTgtFailureAddrType, 3489 iscsiIntrLastTgtFailureAddr 3490 } 3491 STATUS current 3492 DESCRIPTION 3493 "A collection of objects providing information about 3494 all local initiators." 3495 ::= { iscsiGroups 11 } 3497 iscsiInitiatorLoginStatsGroup OBJECT-GROUP 3498 OBJECTS { 3499 iscsiIntrLoginAcceptRsps, 3500 iscsiIntrLoginOtherFailRsps, 3501 iscsiIntrLoginRedirectRsps, 3502 iscsiIntrLoginAuthFailRsps, 3503 iscsiIntrLoginAuthenticateFails, 3504 iscsiIntrLoginNegotiateFails, 3505 iscsiIntrLoginAuthorizeFails 3506 } 3507 STATUS current 3508 DESCRIPTION 3509 "A collection of objects providing information about all 3510 login attempts by local initiators to remote targets." 3511 ::= { iscsiGroups 12 } 3513 iscsiInitiatorLogoutStatsGroup OBJECT-GROUP 3514 OBJECTS { 3515 iscsiIntrLogoutNormals, 3516 iscsiIntrLogoutOthers 3517 } 3518 STATUS current 3519 DESCRIPTION 3520 "A collection of objects providing information about all 3521 logout events between local initiators and remote targets." 3522 ::= { iscsiGroups 13 } 3524 iscsiInitiatorAuthGroup OBJECT-GROUP 3525 OBJECTS { 3526 iscsiIntrAuthRowStatus, 3527 iscsiIntrAuthStorageType, 3528 iscsiIntrAuthIdentity 3529 } 3530 STATUS current 3531 DESCRIPTION 3532 "A collection of objects providing information about all 3533 remote targets that are initiators of the local system 3534 that they are authorized to access." 3535 ::= { iscsiGroups 14 } 3537 iscsiSessionAttributesGroup OBJECT-GROUP 3538 OBJECTS { 3539 iscsiSsnDirection, 3540 iscsiSsnInitiatorName, 3541 iscsiSsnTargetName, 3542 iscsiSsnTSIH, 3543 iscsiSsnISID, 3544 iscsiSsnInitiatorAlias, 3545 iscsiSsnTargetAlias, 3546 iscsiSsnInitialR2T, 3547 iscsiSsnImmediateData, 3548 iscsiSsnType, 3549 iscsiSsnMaxOutstandingR2T, 3550 iscsiSsnFirstBurstLength, 3551 iscsiSsnMaxBurstLength, 3552 iscsiSsnConnectionNumber, 3553 iscsiSsnAuthIdentity, 3554 iscsiSsnDataSequenceInOrder, 3555 iscsiSsnDataPDUInOrder, 3556 iscsiSsnErrorRecoveryLevel, 3557 iscsiSsnDiscontinuityTime, 3558 iscsiSsnProtocolLevel, 3559 iscsiSsnTaskReporting 3560 } 3561 STATUS current 3562 DESCRIPTION 3563 "A collection of objects providing information applicable to 3564 all sessions." 3565 ::= { iscsiGroups 15 } 3567 iscsiSessionPDUStatsGroup OBJECT-GROUP 3568 OBJECTS { 3569 iscsiSsnCmdPDUs, 3570 iscsiSsnRspPDUs 3571 } 3572 STATUS current 3573 DESCRIPTION 3574 "A collection of objects providing information about PDU 3575 traffic for each session." 3576 ::= { iscsiGroups 16 } 3578 iscsiSessionOctetStatsGroup OBJECT-GROUP 3579 OBJECTS { 3580 iscsiSsnTxDataOctets, 3581 iscsiSsnRxDataOctets 3582 } 3583 STATUS current 3584 DESCRIPTION 3585 "A collection of objects providing information about octet 3586 traffic for each session using a Counter64 data type." 3587 ::= { iscsiGroups 17 } 3589 iscsiSessionLCOctetStatsGroup OBJECT-GROUP 3590 OBJECTS { 3591 iscsiSsnLCTxDataOctets, 3592 iscsiSsnLCRxDataOctets 3593 } 3594 STATUS current 3595 DESCRIPTION 3596 "A collection of objects providing information about octet 3597 traffic for each session using a Counter32 data type." 3598 ::= { iscsiGroups 18 } 3600 iscsiSessionCxnErrorStatsGroup OBJECT-GROUP 3601 OBJECTS { 3602 iscsiSsnCxnDigestErrors, 3603 iscsiSsnCxnTimeoutErrors 3604 } 3605 STATUS current 3606 DESCRIPTION 3607 "A collection of objects providing information about connection 3608 errors for all sessions." 3609 ::= { iscsiGroups 19 } 3611 iscsiConnectionAttributesGroup OBJECT-GROUP 3612 OBJECTS { 3613 iscsiCxnCid, 3614 iscsiCxnState, 3615 iscsiCxnProtocol, 3616 iscsiCxnAddrType, 3617 iscsiCxnLocalAddr, 3618 iscsiCxnLocalPort, 3619 iscsiCxnRemoteAddr, 3620 iscsiCxnRemotePort, 3621 iscsiCxnMaxRecvDataSegLength, 3622 iscsiCxnMaxXmitDataSegLength, 3623 iscsiCxnHeaderIntegrity, 3624 iscsiCxnDataIntegrity, 3625 iscsiCxnRecvMarker, 3626 iscsiCxnSendMarker, 3627 iscsiCxnVersionActive 3628 } 3629 STATUS deprecated 3630 DESCRIPTION 3631 "A collection of objects providing information about all 3632 connections used by all sessions. 3633 This object group is deprecated because the marker key 3634 is obsolete." 3635 REFERENCE 3636 "[RFCcccc], 13.25 Obsoleted Keys." 3637 ::= { iscsiGroups 20 } 3639 iscsiTgtLgnNotificationsGroup NOTIFICATION-GROUP 3640 NOTIFICATIONS { 3641 iscsiTgtLoginFailure 3642 } 3643 STATUS current 3644 DESCRIPTION 3645 "A collection of notifications that indicate a login 3646 failure from a remote initiator to a local target." 3647 ::= { iscsiGroups 21 } 3649 iscsiIntrLgnNotificationsGroup NOTIFICATION-GROUP 3650 NOTIFICATIONS { 3651 iscsiIntrLoginFailure 3652 } 3653 STATUS current 3654 DESCRIPTION 3655 "A collection of notifications that indicate a login 3656 failure from a local initiator to a remote target." 3658 ::= { iscsiGroups 22 } 3660 iscsiSsnFlrNotificationsGroup NOTIFICATION-GROUP 3661 NOTIFICATIONS { 3662 iscsiInstSessionFailure 3663 } 3664 STATUS current 3665 DESCRIPTION 3666 "A collection of notifications that indicate session 3667 failures occurring after login." 3668 ::= { iscsiGroups 23 } 3670 iscsiPortalAttributesGroupV2 OBJECT-GROUP 3671 OBJECTS { 3672 iscsiPortalRowStatus, 3673 iscsiPortalStorageType, 3674 iscsiPortalRoles, 3675 iscsiPortalAddrType, 3676 iscsiPortalAddr, 3677 iscsiPortalProtocol, 3678 iscsiPortalMaxRecvDataSegLength, 3679 iscsiPortalPrimaryHdrDigest, 3680 iscsiPortalPrimaryDataDigest, 3681 iscsiPortalSecondaryHdrDigest, 3682 iscsiPortalSecondaryDataDigest 3683 } 3684 STATUS current 3685 DESCRIPTION 3686 "A collection of objects providing information about 3687 the transport protocol endpoints of the local targets." 3688 ::= { iscsiGroups 24 } 3690 iscsiConnectionAttributesGroupV2 OBJECT-GROUP 3691 OBJECTS { 3692 iscsiCxnCid, 3693 iscsiCxnState, 3694 iscsiCxnProtocol, 3695 iscsiCxnAddrType, 3696 iscsiCxnLocalAddr, 3697 iscsiCxnLocalPort, 3698 iscsiCxnRemoteAddr, 3699 iscsiCxnRemotePort, 3700 iscsiCxnMaxRecvDataSegLength, 3701 iscsiCxnMaxXmitDataSegLength, 3702 iscsiCxnHeaderIntegrity, 3703 iscsiCxnDataIntegrity, 3704 iscsiCxnVersionActive 3705 } 3706 STATUS current 3707 DESCRIPTION 3708 "A collection of objects providing information about all 3709 connections used by all sessions." 3710 ::= { iscsiGroups 25 } 3712 --********************************************************************** 3714 iscsiComplianceV1 MODULE-COMPLIANCE 3715 STATUS deprecated 3716 DESCRIPTION 3717 "Initial version of compliance statement based on 3718 initial version of this MIB module. 3720 If an implementation can be both a target and an 3721 initiator, all groups are mandatory. 3722 This module compliance is deprecated because the 3723 marker keys are obsolete." 3724 REFERENCE 3725 "[RFCcccc], 13.25 Obsoleted Keys." 3726 MODULE -- this module 3727 MANDATORY-GROUPS { 3728 iscsiInstanceAttributesGroup, 3729 iscsiInstanceSsnErrorStatsGroup, 3730 iscsiPortalAttributesGroup, 3731 iscsiNodeAttributesGroup, 3732 iscsiSessionAttributesGroup, 3733 iscsiSessionPDUStatsGroup, 3734 iscsiSessionCxnErrorStatsGroup, 3735 iscsiConnectionAttributesGroup, 3736 iscsiSsnFlrNotificationsGroup 3737 } 3739 -- Conditionally mandatory groups depending on the ability 3740 -- to support Counter64 data types and/or to provide counter 3741 -- information to SNMPv1 applications. 3743 GROUP iscsiSessionOctetStatsGroup 3744 DESCRIPTION 3745 "This group is mandatory for all iSCSI implementations 3746 that can support Counter64 data types." 3748 GROUP iscsiSessionLCOctetStatsGroup 3749 DESCRIPTION 3750 "This group is mandatory for all iSCSI implementations 3751 that provide information to SNMPv1-only applications; 3752 this includes agents that cannot support Counter64 3753 data types." 3755 -- Conditionally mandatory groups to be included with 3756 -- the mandatory groups when the implementation has 3757 -- iSCSI target facilities. 3759 GROUP iscsiTgtPortalAttributesGroup 3760 DESCRIPTION 3761 "This group is mandatory for all iSCSI implementations 3762 that have iSCSI target facilities." 3764 OBJECT iscsiPortalMaxRecvDataSegLength 3765 MIN-ACCESS read-only 3766 DESCRIPTION 3767 "Write access is not required." 3769 OBJECT iscsiNodeStorageType 3770 MIN-ACCESS read-only 3771 DESCRIPTION 3772 "Write access is not required; an implementation may 3773 choose to allow this object to be set to 'volatile' 3774 or 'nonVolatile'." 3775 GROUP iscsiTargetAttributesGroup 3776 DESCRIPTION 3777 "This group is mandatory for all iSCSI implementations 3778 that have iSCSI target facilities." 3780 GROUP iscsiTargetLoginStatsGroup 3781 DESCRIPTION 3782 "This group is mandatory for all iSCSI implementations 3783 that have iSCSI target facilities." 3785 GROUP iscsiTargetLogoutStatsGroup 3786 DESCRIPTION 3787 "This group is mandatory for all iSCSI implementations 3788 that have iSCSI target facilities." 3790 GROUP iscsiTgtLgnNotificationsGroup 3791 DESCRIPTION 3792 "This group is mandatory for all iSCSI implementations 3793 that have iSCSI target facilities." 3795 GROUP iscsiTargetAuthGroup 3796 DESCRIPTION 3797 "This group is mandatory for all iSCSI implementations 3798 that have iSCSI target facilities." 3800 -- Conditionally mandatory groups to be included with 3801 -- the mandatory groups when the implementation has 3802 -- iSCSI initiator facilities. 3804 GROUP iscsiIntrPortalAttributesGroup 3805 DESCRIPTION 3806 "This group is mandatory for all iSCSI implementations 3807 that have iSCSI initiator facilities." 3809 GROUP iscsiInitiatorAttributesGroup 3810 DESCRIPTION 3811 "This group is mandatory for all iSCSI implementations 3812 that have iSCSI initiator facilities." 3814 GROUP iscsiInitiatorLoginStatsGroup 3815 DESCRIPTION 3816 "This group is mandatory for all iSCSI implementations 3817 that have iSCSI initiator facilities." 3819 GROUP iscsiInitiatorLogoutStatsGroup 3820 DESCRIPTION 3821 "This group is mandatory for all iSCSI implementations 3822 that have iSCSI initiator facilities." 3824 GROUP iscsiIntrLgnNotificationsGroup 3825 DESCRIPTION 3826 "This group is mandatory for all iSCSI implementations 3827 that have iSCSI initiator facilities." 3829 GROUP iscsiInitiatorAuthGroup 3830 DESCRIPTION 3831 "This group is mandatory for all iSCSI implementations 3832 that have iSCSI initiator facilities." 3834 OBJECT iscsiNodeErrorRecoveryLevel 3835 SYNTAX Unsigned32 (0..2) 3836 DESCRIPTION 3837 "Only values 0-2 are defined at present." 3839 ::= { iscsiCompliances 1 } 3841 iscsiComplianceV2 MODULE-COMPLIANCE 3842 STATUS current 3843 DESCRIPTION 3844 "Initial version of compliance statement based on 3845 initial version of this MIB module. 3847 If an implementation can be both a target and an 3848 initiator, all groups are mandatory." 3849 MODULE -- this module 3850 MANDATORY-GROUPS { 3851 iscsiInstanceAttributesGroup, 3852 iscsiInstanceSsnErrorStatsGroup, 3853 iscsiPortalAttributesGroupV2, 3854 iscsiNodeAttributesGroup, 3855 iscsiSessionAttributesGroup, 3856 iscsiSessionPDUStatsGroup, 3857 iscsiSessionCxnErrorStatsGroup, 3858 iscsiConnectionAttributesGroupV2, 3859 iscsiSsnFlrNotificationsGroup 3860 } 3862 -- Conditionally mandatory groups depending on the ability 3863 -- to support Counter64 data types and/or to provide counter 3864 -- information to SNMPv1 applications. 3866 GROUP iscsiSessionOctetStatsGroup 3867 DESCRIPTION 3868 "This group is mandatory for all iSCSI implementations 3869 that can support Counter64 data types." 3871 GROUP iscsiSessionLCOctetStatsGroup 3872 DESCRIPTION 3873 "This group is mandatory for all iSCSI implementations 3874 that provide information to SNMPv1-only applications; 3875 this includes agents that cannot support Counter64 3876 data types." 3878 -- Conditionally mandatory groups to be included with 3879 -- the mandatory groups when the implementation has 3880 -- iSCSI target facilities. 3882 GROUP iscsiTgtPortalAttributesGroup 3883 DESCRIPTION 3884 "This group is mandatory for all iSCSI implementations 3885 that have iSCSI target facilities." 3887 OBJECT iscsiPortalMaxRecvDataSegLength 3888 MIN-ACCESS read-only 3889 DESCRIPTION 3890 "Write access is not required." 3892 OBJECT iscsiNodeStorageType 3893 MIN-ACCESS read-only 3894 DESCRIPTION 3895 "Write access is not required; an implementation may 3896 choose to allow this object to be set to 'volatile' 3897 or 'nonVolatile'." 3899 GROUP iscsiTargetAttributesGroup 3900 DESCRIPTION 3901 "This group is mandatory for all iSCSI implementations 3902 that have iSCSI target facilities." 3904 GROUP iscsiTargetLoginStatsGroup 3905 DESCRIPTION 3906 "This group is mandatory for all iSCSI implementations 3907 that have iSCSI target facilities." 3909 GROUP iscsiTargetLogoutStatsGroup 3910 DESCRIPTION 3911 "This group is mandatory for all iSCSI implementations 3912 that have iSCSI target facilities." 3914 GROUP iscsiTgtLgnNotificationsGroup 3915 DESCRIPTION 3916 "This group is mandatory for all iSCSI implementations 3917 that have iSCSI target facilities." 3919 GROUP iscsiTargetAuthGroup 3920 DESCRIPTION 3921 "This group is mandatory for all iSCSI implementations 3922 that have iSCSI target facilities." 3924 -- Conditionally mandatory groups to be included with 3925 -- the mandatory groups when the implementation has 3926 -- iSCSI initiator facilities. 3928 GROUP iscsiIntrPortalAttributesGroup 3929 DESCRIPTION 3930 "This group is mandatory for all iSCSI implementations 3931 that have iSCSI initiator facilities." 3933 GROUP iscsiInitiatorAttributesGroup 3934 DESCRIPTION 3935 "This group is mandatory for all iSCSI implementations 3936 that have iSCSI initiator facilities." 3938 GROUP iscsiInitiatorLoginStatsGroup 3939 DESCRIPTION 3940 "This group is mandatory for all iSCSI implementations 3941 that have iSCSI initiator facilities." 3943 GROUP iscsiInitiatorLogoutStatsGroup 3944 DESCRIPTION 3945 "This group is mandatory for all iSCSI implementations 3946 that have iSCSI initiator facilities." 3948 GROUP iscsiIntrLgnNotificationsGroup 3949 DESCRIPTION 3950 "This group is mandatory for all iSCSI implementations 3951 that have iSCSI initiator facilities." 3953 GROUP iscsiInitiatorAuthGroup 3954 DESCRIPTION 3955 "This group is mandatory for all iSCSI implementations 3956 that have iSCSI initiator facilities." 3958 OBJECT iscsiNodeErrorRecoveryLevel 3959 SYNTAX Unsigned32 (0..2) 3960 DESCRIPTION 3961 "Only values 0-2 are defined at present." 3963 ::= { iscsiCompliances 2 } 3965 END 3967 8. Security Considerations 3969 There are a number of management objects defined in this MIB module 3970 with a MAX-ACCESS clause of read-write and/or read-create. Such 3971 objects may be considered sensitive or vulnerable in some network 3972 environments. The support for SET operations in a non-secure 3973 environment without proper protection can have a negative effect on 3974 network operations. These are the tables and objects and their 3975 sensitivity/vulnerability: 3977 iscsiPortalAttributesTable, iscsiTgtPortalAttributesTable, and 3978 iscsiIntrPortalAttributesTable can be used to add or remove IP 3979 addresses to be used by iSCSI. 3981 iscsiTgtAuthAttributesTable entries can be added or removed, to 3982 allow or disallow access to a target by an initiator. 3984 Some of the readable objects in this MIB module (i.e., objects with a 3985 MAX-ACCESS other than not-accessible) may be considered sensitive or 3986 vulnerable in some network environments. It is thus important to 3987 control even GET and/or NOTIFY access to these objects and possibly 3988 to even encrypt the values of these objects when sending them over 3989 the network via SNMP. These are the tables and objects and their 3990 sensitivity/vulnerability: 3992 iscsiNodeAttributesTable, iscsiTargetAttributesTable, and 3993 iscsiTgtAuthorization can be used to glean information needed to 3994 make connections to the iSCSI targets this module represents. 3995 However, it is the responsibility of the initiators and targets 3996 involved to authenticate each other to ensure that an 3997 inappropriately advertised or discovered initiator or target does 3998 not compromise their security. These issues are discussed in 3999 [RFCcccc]. 4001 SNMP versions prior to SNMPv3 did not include adequate security. 4002 Even if the network itself is secure (for example by using IPsec), 4003 even then, there is no control as to who on the secure network is 4004 allowed to access and GET/SET (read/change/create/delete) the objects 4005 in this MIB module. 4007 It is RECOMMENDED that implementers consider the security features as 4008 provided by the SNMPv3 framework (see [RFC3410], section 8), 4009 including full support for SNMPv3 cryptographic mechanisms (for 4010 authentication and privacy). 4012 Further, deployment of SNMP versions prior to SNMPv3 is NOT 4013 RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to 4014 enable cryptographic security. It is then a customer/operator 4015 responsibility to ensure that the SNMP entity giving access to an 4016 instance of this MIB module is properly configured to give access to 4017 the objects only to those principals (users) that have legitimate 4018 rights to indeed GET or SET (change/create/delete) them. 4020 9. IANA Considerations 4022 The MIB module in this document uses the following IANA-assigned 4023 OBJECT IDENTIFIER values recorded in the SMI Numbers registry: 4025 Descriptor OBJECT IDENTIFIER value 4026 ---------- ----------------------- 4028 iscsiMibModule { mib-2 142 } 4030 10. References 4032 10.1. Normative References 4034 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 4035 Requirement Levels", BCP 14, RFC 2119, March 1997. 4037 [RFC2578] McCloghrie, K., Perkins, D., and J. Schoenwaelder, 4038 "Structure of Management Information Version 2 (SMIv2)", 4039 STD 58, RFC 2578, April 1999. 4041 [RFC2579] McCloghrie, K., Perkins, D., and J. Schoenwaelder, 4042 "Textual Conventions for SMIv2", STD 58, RFC 2579, April 4043 1999. 4045 [RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder, 4046 "Conformance Statements for SMIv2", STD 58, RFC 2580, 4047 April 1999. 4049 [RFC3411] Harrington, D., Presuhn, R., and B. Wijnen, "An 4050 Architecture for Describing Simple Network Management 4051 Protocol (SNMP) Management Frameworks", STD 62, RFC 3411, 4052 December 2002. 4054 [RFC3720] Satran, J., Meth, K., Sapuntzakis, C., Chadalapaka, M., 4055 and E. Zeidner, "Internet Small Computer Systems 4056 Interface (iSCSI)", RFC 3720, March 2004. 4058 [RFC4001] Daniele, M., Haberman, B., Routhier, S., and J. 4059 Schoenwaelder, "Textual Conventions for Internet Network 4060 Addresses", RFC 4001, February 2005. 4062 [RFC4545] Bakke, M. and J. Muchow, "Definitions of Managed Objects 4063 for IP Storage User Identity Authorization", RFC 4545, 4064 May 2006. 4066 [RFCcccc] Chadalapaka, M., Satran, J., and K. Meth, "iSCSI 4067 Protocol (Consolidated)", RFC cccc, mmyy 4069 -- RFC Editor: replace cccc with the RFC number assigned to 4070 -- draft-ietf-storm-iscsi-cons-03 & remove this note. 4071 -- RFC Editor: replace mmyy with the RFC month and year assigned to 4072 -- draft-ietf-storm-iscsi-cons-03 & remove this note. 4074 [RFCssss] Knight, F., Chadalapaka, M., "Internet Small 4075 Computer Systems Interface (iSCSI) Update", RFC ssss, 4076 mmyy 4077 -- RFC Editor: replace ssss with the RFC number assigned to 4078 -- draft-ietf-storm-iscsi-sam-04 & remove this note. 4079 -- RFC Editor: replace mmyy with the RFC month and year assigned to 4080 -- draft-ietf-storm-iscsi-sam-04 & remove this note. 4082 10.2. Informative References 4084 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, 4085 "Introduction and Applicability Statements for Internet- 4086 Standard Management Framework", RFC 3410, December 2002. 4088 [RFC4022] Raghunarayan, R., "Management Information Base for the 4089 Transmission Control Protocol (TCP)", RFC 4022, March 4090 2005. 4092 [RFC4455] Hallak-Stamler, M., Bakke, M., Lederman, Y., Krueger, M., 4093 and K. McCloghrie, "Definition of Managed Objects for 4094 Small Computer System Interface (SCSI) Entities", RFC 4095 4455, April 2006. 4097 [RFC4544] Bakke, M., J. Muchow, M. Krueger and T. McSweeney, 4098 "Definitions of Managed Objects for iSCSI", RFC 4544, 4099 May 2006. 4101 11. Acknowledgments 4103 In addition to the authors, several people contributed to the 4104 development of this MIB module. Thanks especially to those who took 4105 the time to participate in our weekly conference calls to build our 4106 requirements, object models, table structures, and attributes: John 4107 Hufferd, Tom McSweeney (IBM), Kevin Gibbons (Nishan Systems), Chad 4108 Gregory (Intel), Jack Harwood (EMC), Hari Mudaliar (Adaptec), Ie Wei 4109 Njoo (Agilent), Lawrence Lamers (SAN Valley), Satish Mali (Stonefly 4110 Networks), and William Terrell (Troika). 4112 Special thanks to Tom McSweeney, Ie Wei Njoo, and Kevin Gibbons, who 4113 wrote the descriptions for many of the tables and attributes in this 4114 MIB module, to Ayman Ghanem for finding and suggesting changes for 4115 many problems in this module, and to Keith McCloghrie for serving as 4116 advisor to the team. 4118 Thanks to David Black (EMC) and Tom Talpey (Microsoft) for their 4119 valuable inputs. 4121 Authors' Address 4123 Mark Bakke 4124 Cisco Systems, Inc 4125 7900 International Drive, Suite 400 4126 Bloomington, MN 4127 USA 55425 4129 EMail: mbakke@cisco.com 4131 Prakash Venkatesen 4132 HCL Technologies Ltd. 4133 50-53, Greams Road, 4134 Chennai - 600006 4135 India 4136 EMail: prakashvn@hcl.com 4138 Authors of RFC 4544: 4140 Mark Bakke 4141 Cisco Systems, Inc 4142 7900 International Drive, Suite 400 4143 Bloomington, MN 4144 USA 55425 4146 EMail: mbakke@cisco.com 4148 Marjorie Krueger 4149 Hewlett-Packard 4150 Networked Storage Architecture 4151 Networked Storage Solutions Org. 4152 8000 Foothills Blvd. 4153 Roseville, CA 4154 USA 95747 4156 EMail: marjorie_krueger@hp.com 4158 Tom McSweeney 4159 IBM Corporation 4160 600 Park Offices Drive 4161 Research Triangle Park, NC 4162 USA 27709 4164 EMail: tommcs@us.ibm.com 4166 James Muchow 4167 Qlogic Corp. 4168 6321 Bury Drive 4169 Eden Prairie, MN 4170 USA 55346 4172 EMail: james.muchow@qlogic.com