B. Forbes Internet Draft D. Chung Document: draft-forbes-ibswitchmib-00.txt Brocade Communications Expires: December 31, 2001 July 11, 2001 Definitions of Managed Objects for the Switch in InfiniBand Standard Status of this Memo This document is an Internet-Draft and is in full conformance with all provisions of Section 10 of RFC2026. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet-Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as ``work in progress.'' The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt. The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. Abstract This memo defines an extension to the Management Information Base (MIB) for use with network management protocols in TCP/IP-based internets. In particular, it defines the objects for managing the operations of the Switch portion of the InfiniBand Standards. Copyright Notice Copyright (C) The Internet Society (2001). All Rights Reserved. Forbes Page 1 Internet Draft InfiniBand Switch MIB July 11, 2001 Table of Contents 1. The SNMP Management Framework...................................3 2. Overview........................................................4 2.1. Management View of a Switch...................................4 2.2. MAP-Specific Object Section...................................5 2.3. SAN-based Object Section......................................5 2.3. SAN-based SNMP Trap Section...................................6 3. Object Descriptions.............................................7 3.1. gswMisc Group.................................................7 3.2. gswSystem Group...............................................7 3.3. gswFabric Group..............................................13 3.4. gswModule Group..............................................14 3.5. gswPort Group................................................15 3.6. gswPortPerfGroup.............................................19 3.7. gswNs Group..................................................21 3.8. gswEvent Group...............................................22 3.10. gswEndDevice Group..........................................22 3.11. gswTrunk Group..............................................22 3.12. gswAgtCfg Group.............................................23 3.13. Traps Group.................................................24 -- Misc. Group....................................................28 -- System Group...................................................29 -- Fabric Group...................................................42 -- Port Group.....................................................45 -- Port Performance Group.........................................51 -- Name Service group.............................................55 -- Event Group....................................................56 -- EndDevice Group................................................57 -- SNMP Agent Configuration.......................................58 -- Traps Group....................................................59 5. Security Considerations........................................61 6. Intellectual Property..........................................61 7. Acknowledgements...............................................61 8. References.....................................................61 8.1. RFCs.........................................................61 8.2. InfiniBand References........................................63 9. Authors' Addresses.............................................63 10. Full Copyright Statement......................................63 Forbes Expires December 31, 2001 Page 2 Internet Draft InfiniBand Switch MIB July 11, 2001 1. The SNMP Management Framework The SNMP Management Framework presently consists of five major components: o An overall architecture, described in RFC 2571. o Mechanisms for describing and naming objects and events for the purpose of management. The first version of this Struc- ture of Management Information (SMI) is called SMIv1 and described in RFC 1155, RFC 1212 and RFC 1215. The second version, called SMIv2, is described in RFC 2578, RFC 2579 and RFC 2580. o Message protocols for transferring management information. The first version of the SNMP message protocol is called SNMPv1 and described in RFC 1157. A second version of the SNMP message protocol, which is not an Internet standards track protocol, is called SNMPv2c and described in RFC 1901 and RFC 1906. The third version of the message protocol is called SNMPv3 and described in RFC 1906, RFC 2572 and RFC 2574. o Protocol operations for accessing management information. The first set of protocol operations and associated PDU formats is described in RFC 1157. A second set of protocol opera- tions and associated PDU formats is described in RFC 1905. o A set of fundamental applications described in RFC 2573 and the view-based access control mechanism described in RFC 2575. A more detailed introduction to the current SNMP Management Framework can be found in RFC 2570. Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. Objects in the MIB are defined using the mechanisms defined in the SMI. This memo specifies a MIB module that is compliant to the SMIv2. A MIB conforming to the SMIv1 can be produced through the appropriate translations. The resulting translated MIB must be semantically equivalent, except where objects or events are omitted because no translation is possible (use of Counter64). Some machine readable information in SMIv2 will be converted into textual descriptions in SMIv1 during the translation process. However, this loss of machine-readable information is not considered to change the semantics of the MIB. Forbes Expires December 31, 2001 Page 3 Internet Draft InfiniBand Switch MIB July 11, 2001 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119]. 2. Overview InfiniBand is designed to support block I/O, inter-processor communications, and data communications traffic simultaneously. An InfiniBand Subnet can be part of a Server Area Network or a Storage Area Network, either of which can be referred to as a _SAN_. An InfiniBand subnet is an entity that interconnects InfiniBand ports on end nodes. It provides transport and forwarding functions allowing ports to communicate with one another over the links that connect them. All but the smallest subnets will contain one or more Switches to forward packets from link to link. A Switch can have from one to 255 ports, each connected to a different link. This memo shall define objects related to an InfiniBand Switch and its ports. It is based on Version 1.0 of the InfiniBand specification [1]. 2.1. Management View of a Switch The InfiniBand Switch MIB is derived from MIBs used to manage Fibre Channel fabrics. It is felt that Fibre Channel has enough similarities with InfiniBand that it is valuable to incorporate industry and vendor experience from the former to manage the latter. One significant difference between Fibre Channel and InfiniBand switches is that implementations of the former began with stand- alone products including chassis, environmental monitoring, etc. and only later evolved to imbedded implementations. In contrast, InfiniBand is expected to deliver both stand-alone products and embedded implementations from the start. Consequently, there may be ancillary Switch MIB data such as sensor tables that imbedded switches elect not to implement. Unlike its Fibre Channel predecessor, the Switch MIB is designed to support management of an entire subnet. It does this by supporting multiple switch elements within one MIB, and by providing structures to describe the physical connectivity of the switches. The Switch MIB is structured to eventually incorporate multiple interconnect technologies that are likely to coexist within a customer site, such as Fibre Channel and storage over IP. This represents an opportunity for site-wide interconnect management in an integrated manner. This memo only includes definitions of InfiniBand and Fibre Channel data at this time. Forbes Expires December 31, 2001 Page 4 Internet Draft InfiniBand Switch MIB July 11, 2001 All InfiniBand nodes including Switches are managed by means of Attributes, which are data structures that can be set and read over any InfiniBand link connected to that node. Management Attributes are defined in detail in Volume 1 of the Version 1.0 InfiniBand specification [1]. Many of the objects defined in this memo are based on those Attributes. The Switch MIB is organized into three sections. The first section contains MAP-specific objects. The second section contains SAN- based objects. The third section contains SAN-based SNMP trap registration and SNMP trap definitions. Figure 1 is an overview of how SAN-based objects are organized through an inventory table. The figure does not contain all the tables and variables for IBSWITCH. However, it shows an exemplary relationship between the inventory table, non-protocol-specific tables such as the sensor table, and protocol-based tables such as the InfiniBand-specific port table. 2.2. MAP-Specific Object Section The MAP-specific object section contains MIB information that is neither non-subnet based, or usage or usefulness of the information in SAN setting is questionable. For example, the Switch MIB contains MIB version information. It is possible to present Switch MIB version for all switches in the SAN. However, usefulness of the information is questionable since the type of information available is only dependent on the local MIB version. 2.3. SAN-based Object Section The SAN-base object section contains information for all switches in a SAN through the use of unique indexing for these objects. In order to accomplish this, the Switch MIB uses one level of indirection. At the top of the section, a table that contains switch names and corresponding unique IDs is defined. This table is referred as an inventory table. On all subsequent tables, the first index to be used is identical to the unique ID. For example, the first table contains gswname.1 and gswid.1 that return "IB switch 0" and "GUID0.IB" respectively. A subsequent switch sensor table may contain sensorDesc.GUID0.IB.1, which indicates first sensor description on switch "IB switch 0", and a query to the object returns "Temp 1: 25C". Certain sections of the MIB are dependent on the underlying fabric protocol. For example, port-related tables might contain different Forbes Expires December 31, 2001 Page 5 Internet Draft InfiniBand Switch MIB July 11, 2001 types of errors for Fibre Channel versus InfiniBand. Therefore the inventory table also contains information regarding protocol types handled by the interconnect element to flag which protocol-dependent tables are relevant. 2.3. SAN-based SNMP Trap Section SNMP traps are typically implemented as a switch-specific feature. When the feature is extended to SAN-based paradigm, it is important to provide the ability to suppress traps being sent. For example, SNMP management application "A" may be only be interested in traps from subnet "A" and SNMP management application "B" may only be interested in traps from subnet "B". Since there are many different cases of such occasions, the MIB must provide ways to manage different scenarios properly. Therefore, switch list information is also tied to each SNMP trap address configuration to figure out the proper IP address to send the traps to. Forbes Expires December 31, 2001 Page 6 Internet Draft InfiniBand Switch MIB July 11, 2001 3. Object Descriptions The following sections describe MIB groups, variables, tables, and traps. 3.1. gswMisc Group The GSW MISC group contains MAP-specific objects. gswMIBVersion - RO The object indicates the current version of the Switch MIB. gswMIBCurrentDate - RO The object indicates the current date on the platform running the SNMP agent that is responding to the MIB query, displayed in textual format. 3.2. gswSystem Group The GSW SYSTEM group contains subnet-based objects for switches. gswNumOfSwitch - RO The object indicates the number of switches represented in gswInventoryTable. gswInventoryTable This is a table that contains entries of switches in a SAN. A SAN may consist of InfiniBand subnets, Fibre Channel subnets, InfiniBand-InfiniBand routers, and InfiniBand-Fibre Channel edge routers. gswInventoryType _ RO This object is one of two indices used by gswInventoryTable. This index denotes the type of interconnect element. o Fibre Channel Switch (1) o InfiniBand Switch (2) o InfiniBand Router (3) o InfiniBand-Fibre Channel Edge Router (4) o iSCSI-based IP Switch (5) o InfiniBand-iSCSI Edge Router (6) o Fibre Channel-iSCSI Edge Router (7) gswInventoryId - RO The object is an index used by gswInventoryTable. If the gswInventoryType is Fibre Channel switch type, the gswInventoryId refers to the Worldwide Name (WWN) of the switch. If the gswInventoryType is InfiniBand switch, InfiniBand Router or InfiniBand-Fibre Channel Edge Router, the gswInventoryId refers to the Globally Unique ID (GUID) of the interconnect element. Since the index corresponds to either the WWN or GUID assigned to each interconnect element, it is unique but may not be contiguous. Forbes Expires December 31, 2001 Page 7 Internet Draft InfiniBand Switch MIB July 11, 2001 gswSwitchName - RW The object is the name of the interconnect element that corresponds to the combination of gswTypeIndex and gswIdIndex. gswSwitchGlobalId - RO The object is the unique global ID assigned to the switch expressed in array of 16 octets. It is the combination of GUID or WWN and the type of an interconnect element. gswSwitchEIP _ RO This object identifies the Ethernet IP address of the switch. gswSwitchIIP _ RO This object identifies the in-band IP address of the switch. gswSwitchIGW _ RO This object identifies the in-band gateway IP address of the switch. gswSwitchSANName _ RW The object is the name of the SAN the interconnect element resides in. gswSwitchFabricName _ RW The object is the name of the Fibre Channel fabric or the InfiniBand subnet the interconnect element resides in. gswSwitchComTable It is a table that contains common information on entries of switches in a SAN. A SAN may consist of InfiniBand subnets, Fibre Channel fabrics, InfiniBand-InfiniBand routers, and InfiniBand-Fibre Channel edge routers. gswSwitchSwitchId - RO The object is the unique global ID assigned to the switch expressed in array of 16 octets. It is the combination of GUID or WWN and type of an interconnect element. gswSwitchMaxPortNum _ RO This object indicates the number of maximum ports available on the switch. gswSensorsNum - RO The object indicates the number of sensors inside the switch. gswCurrentDate - RO The object is the current date and time of the switch, in displayable textual format. gswBootDate - RO The object is the date and time when the switch last booted, in displayable textual format. Forbes Expires December 31, 2001 Page 8 Internet Draft InfiniBand Switch MIB July 11, 2001 gswFWLastUpdated - RO The object indicates the date when the firmware was last updated, in displayable textual format. gswFlashLastUpdated - RO The object indicates the date when the FLASH was last updated, in displayable textual format. gswBootPromLastUpdated - RO The object indicates the date when the boot PROM was last updated, in displayable textual format. gswFirmwareVersion - RO The object indicates the current version of the firmware. gswHWRevision _ RO The object indicates the current revision of the hardware. gswOperStatus - RO The object indicates the current operational status of the switch. The states are as follow: o Online (1) means the switch is accessible by an external port. o Offline (2) means the switch is not accessible. o Testing (3) means the switch is in a built-in test mode and is not accessible by an external port. o Faulty (4) means the switch is not operational. gswAdmStatus - RW The object indicates the desired administrative status of the switch. A management station may place the switch in a desired state by setting this object accordingly. The states are as follows: o Online (1) means set the switch to be accessible by an external port. o Offline (2) means set the switch to be inaccessible. o Testing (3) means set the switch to run the built-in test. o Faulty (4) means set the switch to a 'soft' faulty condition. o Reboot (5) means set the switch to reboot in 1 second. o Fastboot (6) means set the switch to fastboot in 1 second. Fastboot would cause the switch to boot but skip over the POST. When the switch is in a faulty state, only three states can be set: Faulty, Reboot, and Fastboot. gswSsn - RW The object is the soft serial number of the switch. gswBeaconOperStatus - RO The object is the current operational status of the switch beacon. When beaconing is on the switch indicates, in an implementation- dependent manner, that it needs attention. Forbes Expires December 31, 2001 Page 9 Internet Draft InfiniBand Switch MIB July 11, 2001 gswBeaconAdmStatus - RW The object is the desired status of the switch beacon. When the beacon is set to on the switch indicates, in an implementation- dependent manner, that it needs attention. When the beacon is set to off, switch indicators will be in their normal state. gswDiagResult - RO The object indicates the result of the power-on self test (POST) diagnostics. A result of 1 indicates that the switch is OK. Any other result needs to be examined based on switch type. gswEventTrapLevel _ RW This object specifies the trap level in conjunction with an event's severity level. When an event occurs and if the severity is at or below the value specified, an SNMP trap is generated. gswEventNumEntries _ RO This object specifies the number of events logged in the event log. gswPortComTable It is a table that contains common fields for entries of ports on a switching platform. gswPortComEntry - RO An entry of the common switch port information table. gswPortComSwitchId - RO The object is the unique global ID assigned to the switch expressed in array of 16 octets. It is the combination of GUID or WWN and type of an interconnect element. gswPortComNum - RO This object indicates the physical port number. gswPortComType - RO This object indicates the bit mask of native Protocol supported by the port. The bits have the following definition: 0x00000000 - unknown 0x00000001 - FC 0x00000002 - IB gswPortComName - RO This object indicates the assigned port name. gswLicenseTable This table contains license information for the switch. The definition will be added in this document once it becomes available. gswChassisTable This table contains chassis information of the switch. To support modular or bladed Switch implementations, gswChassisSwitchId is Forbes Expires December 31, 2001 Page 10 Internet Draft InfiniBand Switch MIB July 11, 2001 defined to denote which switch chassis the blade or module belongs to, if any. gswSensorTable The table contains sensor entries. gswSensorSwitchId _ RO The object is one of two indexes used by gswSensorTable. This object corresponds to gswGlobalSwitchId. gswSensorIndex - RO This object is one of two indexes used by gswSensorTable. It identifies the sensor. gswSensorType - RO This object identifies the sensor type. gswSensorStatus - RO The object indicates the current status of the sensor. gswSensorValue - RO The object indicates the current value (reading) of the sensor. The value, -2147483648, represents an unknown quantity. It also means that the sensor does not have the capability to measure the actual value. gswSensorInfo - RO The object is the additional displayable information on the sensor. It contains the sensor type and number in textual format. For example, 'Temp 3', 'Fan 6'. gswIBNodeTable This table contains node information pertaining to the NodeDescription and NodeInfo attributes within the Subnet Management Agent. Therefore, this table only applies to InfiniBand node types as indicated by gswInventoryType in gswInventoryTable. gswIBNodeSwitchId - RO The object is the index used by gswIBNodeTable. This object corresponds to gswGlobalSwitchId. gswIBNodeString _ RO The object is a UNICODE string to describe the node in text format gswIBBaseVersion _ RO The object is the supported Management Datagram (MAD) Base Version. It indicates that this node supports up to and including this version. Forbes Expires December 31, 2001 Page 11 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBClassVersion _ RO The object is the supported Subnet Management Class (SMP) version. It indicates that this node supports up to and including this version. gswIBNodeType _ RO 1: Channel Adapter 2: Switch 3: Router 0, 4 - 255: Reserved gswIBNumPorts - RO The object indicates the number of physical ports on this node. Its maximum value is 255. gswIBNodeGUID - RO The object is the Globally Unique ID (GUID) of the switch. All ports on the same node shall report the same Node GUID. It provides a means to uniquely identify a node within a subnet and determine co-location of ports. gswIBPortGUID - RO The object is the GUID of this port itself. One port within a node can return the NodeGUID as its PortGUID if the port is an integral part of the node and is not field-replaceable. gswIBDeviceID - RO The object is the Device ID information as assigned by the device manufacturer. gswIBRevision _ RO The object is the device revision assigned by the manufacturer. gswIBVendorID - RO The object indicates the Device vendor, per IEEE. gswIBSwTable This table contains switch information pertaining to the SwitchInfo attribute within Subnet Management Agent. Therefore, this table only applies to InfiniBand node types as indicated by gswInventoryType in gswInventoryTable. gswIBSwSwitchId - RO The object is one of two indexes used by gswIBSwTable. This object corresponds to gswGlobalSwitchId. gswIBSwitchBadMKeyCounter _ RO This object returns the number of Management Key (M_Key) violations for the switch. Forbes Expires December 31, 2001 Page 12 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBSwitchBadBKeyCounter _ RO This object returns the number of Baseboard Management Key (B_Key) violations for the switch. gswIBSwitchChangeReason _ RO This object is mainly defined to support switch change traps. Reasons are: o Unknown (1) o Bad M_Key (2) o Bad B_Key (3) gswFCSwTable This table contains switch information pertaining to Fibre Channel switches. Therefore, this table only applies to Fibre Channel node types as indicated by gswInventoryType in gswInventoryTable. gswFCSwSwitchId - RO The object is one of two indexes used by gswFCSwTable. This object corresponds to gswGlobalSwitchId. gswFCDomainId - RW The object indicates the domain ID of the Fibre Channel switch. gswFCPrincipalSwitch - RO The object indicates if the Fibre Channel switch is the principal switch of the fabric or not. gswFCNumNbs - RO The object indicates the number of immediate Fibre Channel neighbor switches connected. gswFCNsLocalNumEntry - RO The object indicates the number of local devices in Name Server table. gswFCSwitchTrunkable - RW The object indicates if the Fibre Channel switch supports trunking, i.e. the ability to distribute traffic among parallel links. 3.3. gswFabric Group The GSW FABRIC group contains information regarding the topology of a SAN. gswTopoComTable The table contains information regarding how switches in the SAN are connected. Forbes Expires December 31, 2001 Page 13 Internet Draft InfiniBand Switch MIB July 11, 2001 gswTopoComSwitchId - RO The object is one of two indexes used by gswTopoComTable. This object corresponds to gswGlobalSwitchId. gswTopoComPortIndex _ RO This object is one of two indexes used by gswTopoComTable. This object corresponds to the port number the link is connected to. gswTopoComNbSwitchId - RO This object is the ID of the switch connected at the end of the port indicated by gswTopoComSwitchId and gswTopoComPortIndex. It corresponds to gswSwitchGlobalId. gswTopoComNbSwitchPort _ RO This object is the port of the switch connected at the end of the port indicated by gswTopoComSwitchId and gswTopoComPortIndex. gswTopoComSwitchStatus _ RO The object is defined mainly for trap support. The object can be set to switch-added (2), switch-deleted (3), link-added(4), or link- deleted(5) for a topology change trap. Query of the object returns no-change (1). gswIBTopoTable The table contains information specific to InfiniBand topologies. The table is mostly implemented to support traps. gswIBTopoSwitchId - RO The object is the index used by gswIBTopoTable. This object corresponds to gswGlobalSwitchId. gswIBTopoChangeReason _ RO This object is defined mainly for topology change trap support. The object can be set to: o Unknown (0) o Addition/removal of port (1) o Addition/removal of node (2) o Addition/removal of host (3) o Addition/removal of Subnet Manager (4) o Subnet Manager Failover (5) o Addition/removal of Controller (6) o Addition/removal of IO Unit (7) gswNbFCTable This table only applies to Fibre Channel Switch type indicated by gswTypeIndex in gswInventoryTable. gswGlobalSwitchId is used as an index. 3.4. gswModule Group This group is currently empty. Forbes Expires December 31, 2001 Page 14 Internet Draft InfiniBand Switch MIB July 11, 2001 3.5. gswPort Group The GSW PORT group contains information regarding individual ports. gswIBPortTable The object is a table that contains, in one entry for each switch port, configuration and service parameters of the port. This table mainly represents information contained in the PortInfo attribute within the Subnet Management Agent. Therefore, this table only applies to InfiniBand node types as indicated by gswInventoryType in gswInventoryTable. gswIBPortSwitchId _ RO The object is one of two indexes used by gswIBPortTable. This object corresponds to gswGlobalSwitchId. gswIBPortIndex - RO The object is one of two indexes used by gswIBPortTable. The object identifies the physical port number. gswIBGidPrefix _ RO The object is the Global ID (GID) prefix for this port. gswIBLID _ RO The object is the base Local ID (LID) of this port. gswIBMasterSMLID _ RO The object is the base LID of the master Subnet Manager (SM) that is managing this port. gswIBCapabilityMask _ RO The object indicates the supported capabilities of this node. A bit is set to 1 for affirmation of supported capability. 0: Reserved, shall be zero 1: IsSM 2: IsNoticeSupported 3: IsTrapSupported 4: IsResetSupported 5: IsAutomaticMigrationSupported 6: IsSLMappingSupported 7: IsMKeyNVRAM (supports M_Key in NVRAM) 8: IsPKeyNVRAM (supports P_Key in NVRAM) 9: IsLEDInfoSupported 10: IsSMdisabled 11 - 15: Reserved, shall be zero 16: IsConnectionManagementSupported 17: IsSNMPTunnelingSupported 18: Reserved, shall be zero 19: IsDeviceManagementSupported 20: IsVendorClassSupported Forbes Expires December 31, 2001 Page 15 Internet Draft InfiniBand Switch MIB July 11, 2001 21 - 31: Reserved, shall be zero gswIBDiagCode _ RO The object indicates the InfiniBand Diagnostic code. gswIBLinkWidthEnabled _ RO The object indicates the enabled link width, as follows: 0: No State Change (NOP) 1: 1x 2: 4x 3: 1x or 4x 8: 12x 9: 1x or 12x 10: 4x or 12x 11: 1x, 4x or 12x 4 - 7, 12 - 254: Reserved (Ignored) 255: Set to LinkWidthSupported value. When writing this field, only legal transitions are valid. See Volume 2 of the 1.0 InfiniBand specification [1]. gswIBLinkWidthSupported _ RO The object indicates the supported link width, as follows: 1: 1x 3: 1x or 4x 11: 1x, 4x or 12x 0, 2, 4-10, 12-255: Reserved gswIBLinkWidthActive _ RO The object is the currently active link width, as follows: 1: 1x 2: 4x 8: 12x 0, 3, 4-7, 9-255: Reserved gswIBLinkSpeedSupported _ RO The object indicates the supported link speed, as follows: 1: 2.5Gbps 0, 2 - 15: reserved gswIBPortState _ RO The object indicates the port state. Enumerated as: 0: No State Change (NOP) 1: Down (includes failed links) 2: Initialize 3: Armed 4: Active 5: 15: Reserved - ignored gswIBPortPhysicalState _ RO The object indicates the port physical state. Enumerated as: 0: No state change 1: Sleep Forbes Expires December 31, 2001 Page 16 Internet Draft InfiniBand Switch MIB July 11, 2001 2: Polling 3: Disabled 4: PortConfigurationTraining 5: LinkUp 6: LinkErrorRecovery0 7 - 15: Reserved - ignored gswIBLinkDownDefaultState _ RO The object indicates the link down default state. Enumerated as: 0: No state change 1: Sleep 2: Polling 3 - 15: Reserved - ignored gswIBLMC _ RO The object is the LID mask for multipath support. gswIBLinkSpeedActive _ RO The object indicates the currently active link speed, as follows: 1: 2.5Gbps 0, 2 - 15: reserved gswIBLinkSpeedEnabled _ RO The object indicates the enabled link speed, as follows: 0: No State Change (NOP) 1: 2.5 Gbps 2 - 14: Reserved (Ignored) 15: Set to LinkSpeedSupported value When writing this field, only legal transitions are valid. See Volume 2 of the 1.0 InfiniBand specification [1]. gswIBNeighborMTU _ RO The object indicates the active maximum MTU enabled on this port for transmit: 1: 256 2: 512 3: 1024 4: 2048 5: 4096 0, 6 - 15: reserved gswIBVLCap _ RO The object indicates the Virtual Lanes (VLs) supported on this port, as follows: 1: VL0 2: VL0, VL1 3: VL0 - VL3 4: VL0 - VL7 5: VL0 - VL14 0, 6 - 15: reserved Forbes Expires December 31, 2001 Page 17 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBMTUCap _ RO The object is the Maximum Transmission Unit (MTU) supported by this port. 1: 256 2: 512 3: 1024 4: 2048 5: 4096 0, 6 - 15: reserved gswIBOperationalVLs _ RO The object indicates the Virtual Lanes (VLs) operational on this port, as follows: 0: No change 1: VL0 2: VL0, VL1 3: VL0 - VL3 4: VL0 - VL7 5: VL0 - VL14 6 - 15: reserved gswIBMKeyViolations _ RO The object counts the number of SMP packets that have been received at this port that have had invalid M_Keys, since power-on or reset. Increments until count reaches all 1s and then must be set back to zero to re-enable incrementing. gswIBPKeyViolations _ RO The object counts the number of packets that have been received at this port that have had invalid P_Keys, since power-on or reset. Increments until count reaches all 1s and then must be set back to zero to re-enable incrementing. gswIBQKeyViolations _ RO The object counts the number of packets that have been received at this port that have had invalid Q_Keys, since power-on or reset. Increments until count reaches all 1s and then must be set back to zero to re-enable incrementing. gswIBLocalPhyErrors _ RO The object is the threshold value. When the count of marginal link errors exceeds this threshold, the local link integrity error shall be detected. gswIBOverrunErrors _ RO The object is the threshold value. When the count of buffer overruns over consecutive flow control update periods exceeds this threshold, the excessive buffer overrun error shall be detected. Forbes Expires December 31, 2001 Page 18 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBPortChangeReason - RO The object is mainly implemented to support traps. The object denotes the reason for trap generation. Reasons are: o Unknown (1) o Link integrity error (2) o Excessive buffer overrun error (3) o Flow control timeout (4) o Bad P_Key (5) gswFCPort Table This table contains information regarding individual FIBRE CHANNEL ports. Therefore, this table only applies to Fibre Channel Switches as indicated by gswTypeIndex in gswInventoryTable. The table mirrors the Fibre Channel MIB, extended by the additional index gswGlobalSwitchId. 3.6. gswPortPerfGroup This group contains information regarding port performance counters. gswBlmPerfALPAMntTable, gswBlmPerfEEMntTable, gswBlmFltMntTable: These tables only apply to Fibre Channel Switches as indicated by gswTypeIndex in gswInventoryTable. They mirror implementation of these tables in Fibre Channel except that gswGlobalSwitchId is added as an index. gswIBPortPerfTable The table contains information pertaining to the PortCounters attribute within the Performance Management Agent. Therefore, this table only applies to InfiniBand node types as indicated by gswInventoryType in gswInventoryTable. gswIBPortPerfSwitchId _ RO The object is one of two indexes used by gswIBPortPerfTable. This object corresponds to swGlobalSwitchId. gswIBPortPerfIndex - RO The object is one of two indexes used by gswIBPortPerfTable. The object identifies the physical port number. gswIBSymbolErrorCounter _ RO The object indicates total number of symbol errors detected on one or more lanes. gswIBLinkErrorRecoveryCounter _ RO The object indicates total number of times the Port Training state machine has successfully completed the link error recovery process. Forbes Expires December 31, 2001 Page 19 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBLinkDownedCounter _ RO The object indicates total number of times the Port Training state machine has failed the link error recovery process and downed the link. gswIBPortRcvErrors _ RO The object indicates total number of packets containing an error that were received on the port. These errors include: o Local physical errors (ICRC, VCRC, FCCRC, and all physical errors that cause entry into the BAD PACKET or BAD PACKET DISCARD states of the packet receiver state machine) o Malformed data packet errors (LVer, length, VL) o Malformed link packet errors (operand, length, VL) o Packets discarded due to buffer overrun gswIBPortRcvRemotePhysicalErrors _ RO The object indicates total number of packets marked with the EBP delimiter received on the port. gswIBPortRcvSwitchRelayErrors _ RO The object indicates total number of packets received on the port that were discarded because they could not be forwarded by the switch relay. Reasons for this include: o DLID mapping o VL mapping o Looping (output port = input port) gswIBPortXmitDiscards _ RO The object indicates total number of outbound packets discarded by the port because the port is down or congested. Reasons for this include: o Output port is in the inactive state o Packet length exceeded neighbor MTU o Switch lifetime limit exceeded o Switch Head of Queue (HOQ) limit exceeded gswIBPortXmitConstraintErrors _ RO The object indicates total number of packets not transmitted from the port for the following reasons: o FilterRawOutbound is true and packet is raw o PartitionEnforcementOutbound is true and packet fails partition key check, IP version check, or transport header version check gswIBPortRcvConstraintErrors _ RO The object indicates total number of packets received on the port that are discarded for the following reasons: o FilterRawInbound is true and packet is raw o PartitionEnforcementInbound is true and packet fails partition key check, IP version check, or transport header version check Forbes Expires December 31, 2001 Page 20 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBLocalLinkIntegrityErrors _ RO The object indicates the number of times that the frequency of packets containing local physical errors exceeded local_phy_errors. gswIBExcessiveBufferOverrunErrors _ RO The object indicates the number of times that overrun errors consecutive flow control update periods occurred with at least one overrun error in each period. gswIBVL15Dropped _ RO The object indicates the number of incoming VL15 packets dropped due to resource limitations on the port. gswIBPortXmitData _ RO The object indicates total number of data octets, divided by 4, transmitted on all VLs from the port. This includes all octets between (and not including) the start of packet delimiter and VCRC. It excludes all link packets. gswIBPortRcvData _ RO The object indicates total number of data octets, divided by 4, received on all VLs on the port. This includes all octets between (and not including) the start of packet delimiter and VCRC. It excludes all link packets. gswIBPortXmitPkts _ RO The object indicates total number of packets, excluding link packets, transmitted on all VLs from the port. gswIBPortRcvPkts _ RO The object indicates total number of packets, including packets containing errors and excluding link packets, received from all VLs on the port. 3.7. gswNs Group The GSW NS group contains Name Server and Directory Server information. gswNsLocalFCTable The table contains list of local Name Server entries for Fibre Channel switches. Therefore, this table only applies to Fibre Channel Switch type indicated by gswTypeIndex in gswInventoryTable. The table mirrors the implementation of swNsLocalTable in Fibre Channel, except gswGlobalSwitchId is added as an index. gswNsLocalIBTable The table contains list of local naming entries for InfiniBand interconnect elements. Therefore, this table applies to InfiniBand node types as indicated by gswTypeIndex in gswInventoryTable. Name Service related issues for InfiniBand have not been finalized yet. Forbes Expires December 31, 2001 Page 21 Internet Draft InfiniBand Switch MIB July 11, 2001 This table is to be filled appropriately, as the definition becomes concrete. gswNsLIBSwitchId _ RO The object is one of two indexes used by gswNsLocalIBTable. This object corresponds to gswGlobalSwitchId. gswNsLIBEntryIndex - RO The object is one of two indexes used by gswNsLocalIBTable. It identifies the Name Server database entry. 3.8. gswEvent Group The GSW EVENT group contains switch event information. gswEventTable The object is the table of event entries. gswEventSwitchId _ RO The object is one of two indexes used by gswEventTable. It corresponds to gswGlobalSwitchId. gswEventIndex - RO The object is one of two indexes used by gswEventTable. It identifies the event entry. gswEventTimeInfo - RO This object identifies the date and time when this event occurred, in textual format. gswEventLevel - RO This object identifies the severity level of this event entry. gswEventRepeatCount - RO This object identifies how many times this particular event has occurred. gswEventDescr - RO This object identifies the textual description of the event. 3.10. gswEndDevice Group This group contains information related to end devices. InfiniBand end device support has not been finalized and the group is to be appropriately filled, as the plan becomes concrete. gswFCEndDeviceRlsTable This table contains information pertaining to LESB block information of attached devices. (FC ONLY-- add IB version?) 3.11. gswTrunk Group This group contains information regarding trunking features. Forbes Expires December 31, 2001 Page 22 Internet Draft InfiniBand Switch MIB July 11, 2001 GswSwitchTrunkableTable GswTrunkTable gswTrunkGrpTable These tables only apply to Fibre Channel Switches as indicated by gswTypeIndex in gswInventoryTable. The gswTrunkTable and gswTrunkGrpTable mirror implementation of these tables in Fibre Channel except that gswGlobalSwitchId is added as an index. GswSwitchTrunkableTable is an expansion of the Fibre Channel scalar object swSwitchTrunkable. gswGlobalSwitchId is added as an index. 3.12. gswAgtCfg Group gswAgtCmtyTable This object is a table that contains, in one entry for each Community, the access control and parameters of the Community. gswAgtCmtySwitchId _ RO The object is one of two indexes used by gswAgtCmtyTable. It corresponds to gswGlobalSwitchId. gswAgtCmtyIdx - RO The object is one of two indexes used by gswAgtCmtyTable. It identifies the SNMPv1 Community entry. gswAgtCmtyStr - RW This is a Community string supported by the agent. If a new value is set successfully, it takes effect immediately. gswAgtTrapRcp - RW This is the trap recipient associated with the Community. If a new value is set successfully, it takes effect immediately. gswAgtTrapGroupTable This table defines the list of the group of switches from where SNMP traps should be forward to the trap recipient. gswAgtTGSwitchId _ RO The object is one of three indexes used by gswAgtTrapGroupTable. It corresponds to gswGlobalSwitchId. gswAgtTGCmtyIdx - RO The object is one of three indexes used by gswAgtTrapGroupTable. It corresponds to SwAgtCmtyIdx. gswAgtTGSwitchIdx _ RO This object is one of three indexes used by gswAgtTrapGroupTable. It corresponds to index of switches from which the traps should be forwarded to the trap recipient listed. Forbes Expires December 31, 2001 Page 23 Internet Draft InfiniBand Switch MIB July 11, 2001 gswAgtTGSwitchName _ RW This object is the name of switch from which the traps should be forwarded to the trap recipient. A name may be deleted by writing NULL string in the field. A name can be added by writing a valid switch name using gswAgtTGSwitchIdx of 1. 3.13. Traps Group gswTopoComTrap The trap reports changes to common topology change. The event includes addition or removal of switches. The trap includes the following objects: o gswTopoComSwitchId o gswTopoComNbSwitchId o gswTopoComSwitchStatus gswIBTopoTrap The trap reports changes to topology change. The event includes addition or removal of physical devices and SM fail-over. The trap includes the following objects: o gswIBTopoSwitchId o gswIBTopoChangeReason gswFCPortTrap The trap reports changes to Fibre Channel port state. gswIBPortTrap This trap reports InfiniBand-specific events. The event includes link integrity error, excessive buffer overrun error, flow control timeout, and bad P_Key. The trap includes the following objects: o gswIBPortSwitchId o gswIBPortIndex o gswIBPortChangeReason gswIBSwitchTrap This trap reports InfiniBand-specific events. The event includes bad M_Key and bad B_Key. The trap includes the following objects: o gswSwSwitchId o gswSwitchChangeReason gswEventTrap The trap reports events being logged. Forbes Expires December 31, 2001 Page 24 Internet Draft InfiniBand Switch MIB July 11, 2001 4. Object Definitions IBSWITCH-MIB DEFINITIONS ::= BEGIN IMPORTS enterprises, NetworkAddress FROM RFC1155-SMI OBJECT-TYPE FROM RFC1212 TRAP-TYPE FROM RFC-1215; -- additional textual conventions -- DisplayString: comment out the next line if your MIB compiler -- complains that it is already defined. DisplayString ::= OCTET STRING -- displayable octets (ASCII) GswType ::= INTEGER { fcSwitch (1), ibSwitch (2), ibRouter (3), ib2fcEdgeRouter (4), iSCSIBasedIPSwitch (5), ib2iSCSEdgeRouter (6), fc2iSCSIEdgeRouter (7) } GswLocalId ::= OCTET STRING (SIZE(8)) GswGlobalId ::= OCTET STRING (SIZE(16)) GswOlsName ::= OCTET STRING (SIZE(256)) GswFwVersion ::= OCTET STRING (SIZE(0..24)) -- example: -- v1.0.1 GswDate ::= OCTET STRING (SIZE(0..64)) -- example: -- Wed Mar 21 17:07:17 2001 Forbes Expires December 31, 2001 Page 25 Internet Draft InfiniBand Switch MIB July 11, 2001 GswSwitchStatus ::=INTEGER { online (1), -- switch is accessible by an -- external port. offline (2), -- switch is not accessible. testing (3), -- switch is in a built-in test -- mode and is not accessible by -- an external port. faulty (4), -- switch is not operational. reboot (5), -- set the switch to reboot in 1 -- second. fastboot (6) -- set the switch to fastboot in -- 1 second. -- Fastboot would cause the -- switch to boot but skip over -- the POST. When the switch is -- in faulty state, only three -- states can be set: -- faulty, reboot, and fastboot. } GswOnOff ::= INTEGER { on (1), off (2) } GswSensorTypeDef ::= INTEGER { temperature (1), fan (2), power-supply (3) } GswSensorStatusDef ::= INTEGER { unknown (1), faulty (2), below-min (3), nominal (4), above-max (5), absent (6) } GswIBNodeType ::= INTEGER { channelAdapter (1), switch (2), router (3) } GswIBGUID ::= OCTET STRING (SIZE(8)) GswIBGID ::= OCTET STRING (SIZE(8)) GswIBLID ::= OCTET STRING (SIZE(2)) GswIBLinkWidth ::= INTEGER { nop (1), lw1x (2), lw4x (3), lw1x-4x (4), Forbes Expires December 31, 2001 Page 26 Internet Draft InfiniBand Switch MIB July 11, 2001 lw12x (9), lw1x-12x (10), lw4x-12x (11), lw1x-4x-12x (12) } GswIBLinkSpeed ::= INTEGER { ls2-5gbps (1) } GswIBPortState ::= INTEGER { nop (1), down (2), initialize (3), armed (4), actived (5) } GswIBPortPhysState ::= INTEGER { nop (1), sleep (2), polling (3), disabled (4), portconftrain (5), linkup (6), linkerrorrec0 (7) } GswIBMTU ::= INTEGER { mtu256 (1), mtu512 (2), mtu1024 (3), mtu2048 (4), mtu4096 (5) } GswIBVL ::= INTEGER { vl0 (1), vl0vl1 (2), vl0vl3 (3), vl0vl7 (4), vl0vl14 (5) } GswEventSeverity ::= INTEGER { none (0), critical (1), error (2), warning (3), informational (4), debug (5) } -- 64 bit counter definition GswCounter64 ::= OCTET STRING (SIZE(16)) Forbes Expires December 31, 2001 Page 27 Internet Draft InfiniBand Switch MIB July 11, 2001 -- Product Lines or Generic Product information xrt OBJECT IDENTIFIER ::= { experimental } commDev OBJECT IDENTIFIER ::= { xrt 2 } genericSwitch OBJECT IDENTIFIER ::= { commDev 2 } gsw OBJECT IDENTIFIER ::= { genericSwitch 1 } ib1k OBJECT IDENTIFIER ::= { genericSwitch 2 } -- various groups gswMisc OBJECT IDENTIFIER ::= { gsw 1 } gswSystem OBJECT IDENTIFIER ::= { gsw 2 } gswFabric OBJECT IDENTIFIER ::= { gsw 5 } gswModule OBJECT IDENTIFIER ::= { gsw 6 } gswPort OBJECT IDENTIFIER ::= { gsw 10 } gswPortPerf OBJECT IDENTIFIER ::= { gsw 11 } gswNs OBJECT IDENTIFIER ::= { gsw 13 } gswEvent OBJECT IDENTIFIER ::= { gsw 15 } gswEndDevice OBJECT IDENTIFIER ::= { gsw 21 } gswAgtCfg OBJECT IDENTIFIER ::= { gsw 25 } -- -- Misc. Group -- gswMIBVersion OBJECT-TYPE SYNTAX DisplayString (SIZE (4)) ACCESS read-only STATUS mandatory DESCRIPTION "MIB version in textual format. example: version 1.0 is represented as 0100 version 1.1 is represented as 0101" ::= { gswMisc 1 } gswMIBCurrentDate OBJECT-TYPE SYNTAX GswDate ACCESS read-only STATUS mandatory DESCRIPTION "The current date information of the location of the MIB in displayable textual format." ::= { gswMisc 2 } -- -- End of Misc. Group -- Forbes Expires December 31, 2001 Page 28 Internet Draft InfiniBand Switch MIB July 11, 2001 -- -- System Group -- gswNumOfSwitch OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the number of switches represented in gswInventoryTable." ::= { gswSystem 1 } gswInventoryTable OBJECT-TYPE SYNTAX SEQUENCE OF GswInventoryEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "It is a table that contains entries of switches in a SAN. A SAN may consist of IB subnets, FC fabrics, IB-IB routers, and IB-FC edge routers." ::= { gswSystem 2 } gswInventoryEntry OBJECT-TYPE SYNTAX GswInventoryEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry of the switch information." INDEX { gswInventoryType, gswInventoryId } ::= { gswInventoryTable 1 } GswInventoryEntry ::= SEQUENCE { gswInventoryType GswType, gswInventoryId GswLocalId, gswSwitchName GswOlsName, gswSwitchGlobalId GswGlobalId, gswSwitchEIP NetworkAddress, gswSwitchIIP NetworkAddress, gswSwitchIGW NetworkAddress, gswSwitchSANName GswOlsName, gswSwitchFabricName GswOlsName } gswInventoryType OBJECT-TYPE SYNTAX GswType ACCESS read-only STATUS mandatory DESCRIPTION "This object is one of two indices used by gswInventoryTable. This index denotes the type of interconnect element." ::= { gswInventoryEntry 1 } Forbes Expires December 31, 2001 Page 29 Internet Draft InfiniBand Switch MIB July 11, 2001 gswInventoryId OBJECT-TYPE SYNTAX GswLocalId ACCESS read-only STATUS mandatory DESCRIPTION "The object is an index used by gswInventoryTable. If the gswInventoryType is FC switch type, the gswInventotyId refers to WWN of the switch. If the gswInventoryType is IB switch, IB Router or IB-FC Edge Router, the gswInventoryId refers to GUID of the interconnect element. Since the index corresponds to either WWN or GUID assigned to each interconnect element, it is unique but may not be contiguous." ::= { gswInventoryEntry 2 } gswSwitchName OBJECT-TYPE SYNTAX GswOlsName ACCESS read-write STATUS mandatory DESCRIPTION "The object is the name of the interconnect element that corresponds to the combination of gswTypeIndex and gswIdIndex." ::= { gswInventoryEntry 7 } gswSwitchGlobalId OBJECT-TYPE SYNTAX GswGlobalId ACCESS read-only STATUS mandatory DESCRIPTION "The object is the unique global ID assigned to the switch expressed in array of 16 octets. It is the combination of GUID or WWN and type of an interconnect element." ::= { gswInventoryEntry 8 } gswSwitchEIP OBJECT-TYPE SYNTAX NetworkAddress ACCESS read-only STATUS mandatory DESCRIPTION "This object identifies the ethernet IP address of the switch." ::= { gswInventoryEntry 9 } gswSwitchIIP OBJECT-TYPE SYNTAX NetworkAddress ACCESS read-only STATUS mandatory DESCRIPTION "This object identifies the in-band IP address of the switch." ::= { gswInventoryEntry 10 } Forbes Expires December 31, 2001 Page 30 Internet Draft InfiniBand Switch MIB July 11, 2001 gswSwitchIGW OBJECT-TYPE SYNTAX NetworkAddress ACCESS read-only STATUS mandatory DESCRIPTION "This object identifies the in-band gateway IP address of the switch." ::= { gswInventoryEntry 11 } gswSwitchSANName OBJECT-TYPE SYNTAX GswOlsName ACCESS read-write STATUS mandatory DESCRIPTION "The object is the name of the SAN the interconnect element resides in." ::= { gswInventoryEntry 12 } gswSwitchFabricName OBJECT-TYPE SYNTAX GswOlsName ACCESS read-write STATUS mandatory DESCRIPTION "The object is the name of the FC fabric or IB subnet the interconnect element resides in." ::= { gswInventoryEntry 13 } gswSwitchComTable OBJECT-TYPE SYNTAX SEQUENCE OF GswSwitchComEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "It is a table that contains common fields for entries of switches in a SAN. SAN may consist of IB subnets, FC fabrics, IB-IB routers, and IB-FC edge routers." ::= { gswSystem 3 } gswSwitchComEntry OBJECT-TYPE SYNTAX GswSwitchComEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry of the common switch information." INDEX { gswSwitchSwitchId } ::= { gswSwitchComTable 1 } GswSwitchComEntry ::= SEQUENCE { gswSwitchSwitchId GswGlobalId, gswSwitchMaxPortNum INTEGER, gswSensorsNum INTEGER, gswCurrentDate GswDate, gswBootDate GswDate, gswFWLastUpdated GswDate, gswFlashLastUpdated GswDate, gswBootPromLastUpdated GswDate, Forbes Expires December 31, 2001 Page 31 Internet Draft InfiniBand Switch MIB July 11, 2001 gswFirmwareVersion GswFwVersion, gswHWRevision DisplayString (SIZE (0..32)), gswOperStatus GswSwitchStatus, gswAdmStatus GswSwitchStatus, gswSsn DisplayString (SIZE (0..128)), gswBeaconOperStatus GswOnOff, gswBeaconAdmStatus GswOnOff, gswDiagResult INTEGER, gswEventTrapLevel GswEventSeverity, gswEventNumEntries INTEGER } gswSwitchSwitchId OBJECT-TYPE SYNTAX GswGlobalId ACCESS read-only STATUS mandatory DESCRIPTION "The object is the unique global ID assigned to the switch expressed in array of 16 octets. It is the combination of GUID or WWN and type of an interconnect element." ::= { gswSwitchComEntry 1 } gswSwitchMaxPortNum OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "This object indicates the maximum number of ports available on the switch." ::= { gswSwitchComEntry 2 } gswSensorsNum OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the number of sensors inside the switch." ::= { gswSwitchComEntry 3 } gswCurrentDate OBJECT-TYPE SYNTAX GswDate ACCESS read-only STATUS mandatory DESCRIPTION "The current date information of the switch in displayable textual format." ::= { gswSwitchComEntry 10 } Forbes Expires December 31, 2001 Page 32 Internet Draft InfiniBand Switch MIB July 11, 2001 gswBootDate OBJECT-TYPE SYNTAX GswDate ACCESS read-only STATUS mandatory DESCRIPTION "The object is the date and time when the switch last booted, in displayable textual format." ::= { gswSwitchComEntry 11 } gswFWLastUpdated OBJECT-TYPE SYNTAX GswDate ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the date when the firmware was last updated, in displayable textual format." ::= { gswSwitchComEntry 12 } gswFlashLastUpdated OBJECT-TYPE SYNTAX GswDate ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the date when the FLASH was last updated, in displayable textual format." ::= { gswSwitchComEntry 13 } gswBootPromLastUpdated OBJECT-TYPE SYNTAX GswDate ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the date when the boot PROM was last updated, in displayable textual format." ::= { gswSwitchComEntry 14 } gswFirmwareVersion OBJECT-TYPE SYNTAX GswFwVersion ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the current version of the firmware." ::= { gswSwitchComEntry 20 } gswHWRevision OBJECT-TYPE SYNTAX DisplayString(SIZE (0..32)) ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the current revision of the hardware." ::= { gswSwitchComEntry 21 } Forbes Expires December 31, 2001 Page 33 Internet Draft InfiniBand Switch MIB July 11, 2001 gswOperStatus OBJECT-TYPE SYNTAX GswSwitchStatus ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the current operational status of the switch." ::= { gswSwitchComEntry 22 } gswAdmStatus OBJECT-TYPE SYNTAX GswSwitchStatus ACCESS read-write STATUS mandatory DESCRIPTION "The object indicates the desired administrative status of the switch. A management station may place the switch in a desired state by setting this object accordingly." ::= { gswSwitchComEntry 23 } gswSsn OBJECT-TYPE SYNTAX DisplayString (SIZE (0..128)) ACCESS read-write STATUS mandatory DESCRIPTION "The object is the soft serial number of the switch." ::= { gswSwitchComEntry 26 } gswBeaconOperStatus OBJECT-TYPE SYNTAX GswOnOff ACCESS read-only STATUS mandatory DESCRIPTION "The object is the current operational status of the switch beacon. When the beacon is on, the switch will give an indication that it needs attention." ::= { gswSwitchComEntry 30 } gswBeaconAdmStatus OBJECT-TYPE SYNTAX GswOnOff ACCESS read-write STATUS mandatory DESCRIPTION "The object is the desired status of the switch beacon. When the beacon is on, the switch will give an indication that it needs attention." ::= { gswSwitchComEntry 31 } Forbes Expires December 31, 2001 Page 34 Internet Draft InfiniBand Switch MIB July 11, 2001 gswDiagResult OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the result of the power-on self test (POST) diagnostics. Result of 1 indicate that the switch is OK. Any other result needs to be examined based on switch type." ::= { gswSwitchComEntry 40 } gswEventTrapLevel OBJECT-TYPE SYNTAX GswEventSeverity ACCESS read-write STATUS mandatory DESCRIPTION "This object specifies the gswEventTrap level in conjunction with an event's severity level. When an event occurs and if its severity level is at or below the value specified by this object instance, the agent will send the associated gswEventTrap to configured recipients." ::= { gswSwitchComEntry 41 } gswEventNumEntries OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The number of entries in the Event Table." ::= { gswSwitchComEntry 42 } gswPortComTable OBJECT-TYPE SYNTAX SEQUENCE OF GswPortComEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "It is a table that contains common fields for entries of ports on a switching platform." ::= { gswSystem 4 } gswPortComEntry OBJECT-TYPE SYNTAX GswPortComEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry of the common switch port information." INDEX { gswPortComSwitchId, gswPortComNum } ::= { gswPortComTable 1 } GswPortComEntry ::= SEQUENCE { gswPortComSwitchId GswGlobalId, gswPortComNum INTEGER, gswPortComType INTEGER, gswPortComName GswOlsName Forbes Expires December 31, 2001 Page 35 Internet Draft InfiniBand Switch MIB July 11, 2001 } gswPortComSwitchId OBJECT-TYPE SYNTAX GswGlobalId ACCESS read-only STATUS mandatory DESCRIPTION "The object is the unique global ID assigned to the switch expressed in array of 16 octets. It is the combination of GUID or WWN and type of an interconnect element." ::= { gswPortComEntry 1 } gswPortComNum OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "This object indicates the physical port number." ::= { gswPortComEntry 2 } gswPortComType OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "This object indicates the bit mask of native Protocol supported by the port. The bits have the following definition: 0x00000000 - unknown 0x00000001 - FC 0x00000002 - IB" ::= { gswPortComEntry 3 } gswPortComName OBJECT-TYPE SYNTAX GswOlsName ACCESS read-only STATUS mandatory DESCRIPTION "This object indicates the assigned port name." ::= { gswPortComEntry 4 } -- operating environment sensors -- (temperature, fan, power supply...) gswSensorTable OBJECT-TYPE SYNTAX SEQUENCE OF GswSensorEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The table of sensor entries." ::= { gswSystem 10 } Forbes Expires December 31, 2001 Page 36 Internet Draft InfiniBand Switch MIB July 11, 2001 gswSensorEntry OBJECT-TYPE SYNTAX GswSensorEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry of the sensor information." INDEX { gswSensorSwitchId, gswSensorIndex } ::= { gswSensorTable 1 } GswSensorEntry ::= SEQUENCE { gswSensorSwitchId GswGlobalId, gswSensorIndex INTEGER, gswSensorType GswSensorTypeDef, gswSensorStatus GswSensorStatusDef, gswSensorValue INTEGER, gswSensorInfo DisplayString (SIZE(0..255)) } gswSensorSwitchId OBJECT-TYPE SYNTAX GswGlobalId ACCESS read-only STATUS mandatory DESCRIPTION "The object is one of two indexes used by gswSensorTable. This object corresponds to gswGlobal itchId." ::= { gswSensorEntry 1 } gswSensorIndex OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "This object identifies the sensor." ::= { gswSensorEntry 2 } gswSensorType OBJECT-TYPE SYNTAX GswSensorTypeDef ACCESS read-only STATUS mandatory DESCRIPTION "This object identifies the sensor type." ::= { gswSensorEntry 3 } gswSensorStatus OBJECT-TYPE SYNTAX GswSensorStatusDef ACCESS read-only STATUS mandatory DESCRIPTION "The current status of the sensor." ::= { gswSensorEntry 4 } Forbes Expires December 31, 2001 Page 37 Internet Draft InfiniBand Switch MIB July 11, 2001 gswSensorValue OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The current value (reading) of the sensor. The value, -2147483648, represents an unknown quantity. It also means that the sensor does not have the capability to measure the actual value." ::= { gswSensorEntry 5 } gswSensorInfo OBJECT-TYPE SYNTAX DisplayString (SIZE(0..255)) ACCESS read-only STATUS mandatory DESCRIPTION "Additional displayable information on the sensor. It contains the sensor type and number in textual format. For example, 'Temp 3', 'Fan 6'." ::= { gswSensorEntry 6 } gswIBNodeTable OBJECT-TYPE SYNTAX SEQUENCE OF GswIBNodeEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "This table contains node information pertaining to NodeDescription and NodeInfo within the Subnet Management Agent. Therefore, this table only applies to IB Switch, IB Router, and IB-FC Edge Router type indicated by gswInventoryType in gswInventoryTable." ::= { gswSystem 20 } gswIBNodeEntry OBJECT-TYPE SYNTAX GswIBNodeEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry of the IB node information." INDEX { gswIBNodeSwitchId } ::= { gswIBNodeTable 1 } SwIBNodeEntry ::= SEQUENCE { gswIBNodeSwitchId GswGlobalId, gswIBNodeString DisplayString (SIZE(0..64)), gswIBBaseVersion INTEGER, gswIBClassVersion INTEGER, gswIBNodeType GswIBNodeType, gswIBNumPorts INTEGER, gswIBNodeGUID GswIBGUID, gswIBPortGUID GswIBGUID, gswIBDeviceID INTEGER, gswIBRevision INTEGER, gswIBVendorID INTEGER } Forbes Expires December 31, 2001 Page 38 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBNodeSwitchId OBJECT-TYPE SYNTAX GswGlobalId ACCESS read-only STATUS mandatory DESCRIPTION "The object is the index used by gswIBNodeTable. This object corresponds to gswGlobalSwitchId." ::= { gswIBNodeEntry 1 } gswIBNodeString OBJECT-TYPE SYNTAX DisplayString (SIZE(0..64)) ACCESS read-only STATUS mandatory DESCRIPTION "The object is a UNICODE string to describe node in text format." ::= { gswIBNodeEntry 2 } gswIBBaseVersion OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object is the supported MAD Base Version. It indicates that this node supports up to and including this version." ::= { gswIBNodeEntry 3 } gswIBClassVersion OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object is the supported Subnet Management Class (SMP) Version. It indicates that this node supports up to and including this version." ::= { gswIBNodeEntry 4 } gswIBNodeType OBJECT-TYPE SYNTAX GswIBNodeType ACCESS read-only STATUS mandatory DESCRIPTION "The object is node type." ::= { gswIBNodeEntry 5 } gswIBNumPorts OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the number of physical ports on this node." ::= { gswIBNodeEntry 6 } Forbes Expires December 31, 2001 Page 39 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBNodeGUID OBJECT-TYPE SYNTAX GswIBGUID ACCESS read-only STATUS mandatory DESCRIPTION "The object is the GUID of the switch. All ports on the same node shall report the same Node-GUID. It provides a means to uniquely identify a node within a subnet and determine co-location of ports." ::= { gswIBNodeEntry 7 } gswIBPortGUID OBJECT-TYPE SYNTAX GswIBGUID ACCESS read-only STATUS mandatory DESCRIPTION "The object is the GUID of this port itself. One port within a node can return the NodeGUID as its PortGUID if the port is an integral part of the node and is not field-replaceable." ::= { gswIBNodeEntry 8 } gswIBDeviceID OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object is the Device ID information as assigned by device manufacturer." ::= { gswIBNodeEntry 9 } gswIBRevision OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object is the device resvision assigned by device manufacturer." ::= { gswIBNodeEntry 10 } gswIBVendorID OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the Device vendor, per IEEE." ::= { gswIBNodeEntry 11 } Forbes Expires December 31, 2001 Page 40 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBSwTable OBJECT-TYPE SYNTAX SEQUENCE OF GswIBSwEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "This table contains switch information pertaining to switchInfo within Subnet Management Agent. Therefore, this table only applies to IB Switch, IB Router, and IB-FC Edge Router type indicated by gswInventoryType in gswInventoryTable." ::= { gswSystem 25 } gswIBSwEntry OBJECT-TYPE SYNTAX GswIBSwEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry of the IB node information." INDEX { gswIBSwSwitchId } ::= { gswIBSwTable 1 } GswIBSwEntry ::= SEQUENCE { gswIBSwSwitchId GswGlobalId, gswIBBadMKeyCounter INTEGER, gswIBBadBKeyCounter INTEGER, gswIBSwitchChangeReason INTEGER } gswIBSwSwitchId OBJECT-TYPE SYNTAX GswGlobalId ACCESS read-only STATUS mandatory DESCRIPTION "The object is the index used by gswIBSwTable. This object corresponds to gswGlobalSwitchId." ::= { gswIBSwEntry 1 } gswIBBadMKeyCounter OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION " This object returns the number of M_Key violations for the switch." ::= { gswIBSwEntry 6 } gswIBBadBKeyCounter OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION " This object returns the number of M_Key violations for the switch." ::= { gswIBSwEntry 7 } Forbes Expires December 31, 2001 Page 41 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBSwitchChangeReason OBJECT-TYPE SYNTAX INTEGER { unknown (1), badMKey (2), badBKey (3) } ACCESS read-only STATUS mandatory DESCRIPTION "This object is mainly defined to support switch change traps." ::= { gswIBSwEntry 8 } -- -- End of System Group -- -- -- Fabric Group -- gswTopoComTable OBJECT-TYPE SYNTAX SEQUENCE OF GswTopoComEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The table contains information regarding how switches in the SAN are connected." ::= { gswFabric 1 } gswTopoComEntry OBJECT-TYPE SYNTAX GswTopoComEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry of the common topology information." INDEX { gswTopoComSwitchId, gswTopoComPortIndex } ::= { gswTopoComTable 1 } GswTopoComEntry ::= SEQUENCE { gswTopoComSwitchId GswGlobalId, gswTopoComPortIndex INTEGER, gswTopoComNbSwitchId INTEGER, gswTopoComNbSwitchPort INTEGER, gswTopoComSwitchStatus INTEGER } gswTopoComSwitchId OBJECT-TYPE SYNTAX GswGlobalId ACCESS read-only STATUS mandatory DESCRIPTION "The object is one of the two indexes used by gswTopoComTable. This object corresponds to gswGlobalSwitchId." Forbes Expires December 31, 2001 Page 42 Internet Draft InfiniBand Switch MIB July 11, 2001 ::= { gswTopoComEntry 1 } gswTopoComPortIndex OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "This object is one of two indexes used by gswTopoComTable. This object corresponds to the port number where the link it connected to." ::= { gswTopoComEntry 2 } gswTopoComNbSwitchId OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "This object is the ID of the switch connected at the end of the port indicated by gswSTSwitchId and gswSTPortIndex. It represents the gswSwitchGlobalId." ::= { gswTopoComEntry 3 } gswTopoComNbSwitchPort OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION " This object is the port of the switch connected at the end of the port indicated by gswTopoComSwitchId and gswTopoComPortIndex ." ::= { gswTopoComEntry 4 } gswTopoComSwitchStatus OBJECT-TYPE SYNTAX INTEGER { no-change (1), switch-added (2), switch-deleted (3), link-added (4), link-deleted (5) } ACCESS read-only STATUS mandatory DESCRIPTION "The object is defined mainly for trap support. The object can be set added (2) or deleted (3) for a topology change trap. Query of the object returns no-change (1)." ::= { gswTopoComEntry 5 } gswIBTopoTable OBJECT-TYPE SYNTAX SEQUENCE OF GswIBTopoEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The table contains IB-specific topology information." ::= { gswFabric 5 } Forbes Expires December 31, 2001 Page 43 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBTopoEntry OBJECT-TYPE SYNTAX GswIBTopoEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry of the IB topology information." INDEX { gswIBTopoSwitchId } ::= { gswIBTopoTable 1 } GswIBTopoEntry ::= SEQUENCE { gswIBTopoSwitchId GswGlobalId, gswIBTopoChangeReason INTEGER } gswIBTopoSwitchId OBJECT-TYPE SYNTAX GswGlobalId ACCESS read-only STATUS mandatory DESCRIPTION "The object is the index used by gswIBTopoTable. This object corresponds to gswGlobalSwitchId." ::= { gswIBTopoEntry 1 } gswIBTopoChangeReason OBJECT-TYPE SYNTAX INTEGER { unknown (1), add-remove-port (2), add-remove-node (3), add-remove-host (4), add-remove-SM (5), failover-SM (6), add-remove-controller (7), add-remove-iou (8) } ACCESS read-only STATUS mandatory DESCRIPTION "This object is defined mainly for topology change trap support." ::= { gswIBTopoEntry 2 } -- -- End of Fabric Group -- Forbes Expires December 31, 2001 Page 44 Internet Draft InfiniBand Switch MIB July 11, 2001 -- -- Port Group -- gswIBPortTable OBJECT-TYPE SYNTAX SEQUENCE OF GswIBPortEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The object is a table that contains, one entry for each switch port, configuration and service parameters of the port. This table mainly represents information contained in portInfo within Subnet Management Agent. Therefore, this table only applies to IB Switch, IB Router, and IB-FC Edge Router type indicated by gswInventoryType in gswInventoryTable." ::= { gswPort 5 } gswIBPortEntry OBJECT-TYPE SYNTAX GswIBPortEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry of the IB port information." INDEX { gswIBPortSwitchId, gswIBPortIndex } ::= { gswIBPortTable 1 } GswIBPortEntry ::= SEQUENCE { gswIBPortSwitchId GswGlobalId, gswIBPortIndex INTEGER, gswIBGidPrefix GswIBGID, gswIBLID GswIBLID, gswIBMasterSMLID GswIBLID, gswIBCapabilityMask INTEGER, gswIBDiagCode INTEGER, gswIBLinkWidthEnabled GswIBLinkWidth, gswIBLinkWidthSupported GswIBLinkWidth, gswIBLinkWidthActive GswIBLinkWidth, gswIBLinkSpeedSupported GswIBLinkSpeed, gswIBPortState GswIBPortState, gswIBPortPhysicalState GswIBPortPhysState, gswIBLinkDownDefaultState INTEGER, gswIBLMC INTEGER, gswIBLinkSpeedActive GswIBLinkSpeed, gswIBLinkSpeedEnabled GswIBLinkSpeed, gswIBNeighborMTU GswIBMTU, gswIBVLCap GswIBVL, gswIBMTUCap GswIBMTU, gswIBOperationalVLs GswIBVL, gswIBMKeyViolations INTEGER, gswIBPKeyViolations INTEGER, gswIBQKeyViolations INTEGER, gswIBLocalPhyErrors INTEGER, Forbes Expires December 31, 2001 Page 45 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBOverrunErrors INTEGER, gswIBPortChangeReason INTEGER } gswIBPortSwitchId OBJECT-TYPE SYNTAX GswGlobalId ACCESS read-only STATUS mandatory DESCRIPTION "The object is one of the two indexes used by gswIBPortTable. This object corresponds to gswGlobalSwitchId." ::= { gswIBPortEntry 1 } gswIBPortIndex OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object is one of two indexes used by gswIBPortTable. The object identifies the physical port number." ::= { gswIBPortEntry 2 } gswIBGidPrefix OBJECT-TYPE SYNTAX GswIBGID ACCESS read-only STATUS mandatory DESCRIPTION "The object is the GID prefix for this port." ::= { gswIBPortEntry 6 } gswIBLID OBJECT-TYPE SYNTAX GswIBLID ACCESS read-only STATUS mandatory DESCRIPTION "The object is the base LID of this port." ::= { gswIBPortEntry 7 } gswIBMasterSMLID OBJECT-TYPE SYNTAX GswIBLID ACCESS read-only STATUS mandatory DESCRIPTION "The object is the base LID of the master SM that is managing this port." ::= { gswIBPortEntry 8 } Forbes Expires December 31, 2001 Page 46 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBCapabilityMask OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the supported capabilities of this node. A bit set to 1 for affirmation of supported capability. 0: Reserved, shall be zero 1: IsSM 2: IsNoticeSupported 3: IsTrapSupported 4: IsResetSupported 5: IsAutomaticMigrationSupported 6: IsSLMappingSupported 7: IsMKeyNVRAM (supports M_Key in NVRAM) 8: IsPKeyNVRAM (supports P_Key in NVRAM) 9: IsLEDInfoSupported 10: IsSMdisabled 11 - 15: Reserved, shall be zero 16: IsConnectionManagementSupported 17: IsSNMPTunnelingSupported 18: Reserved, shall be zero 19: IsDeviceManagementSupported 20: IsVendorClassSupported 21 - 31: Reserved, shall be zero" ::= { gswIBPortEntry 9 } gswIBDiagCode OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the IB Diagnostic code." ::= { gswIBPortEntry 10 } gswIBLinkWidthEnabled OBJECT-TYPE SYNTAX GswIBLinkWidth ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the enabled link width." ::= { gswIBPortEntry 12 } gswIBLinkWidthSupported OBJECT-TYPE SYNTAX GswIBLinkWidth ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the supported link width." ::= { gswIBPortEntry 13 } Forbes Expires December 31, 2001 Page 47 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBLinkWidthActive OBJECT-TYPE SYNTAX GswIBLinkWidth ACCESS read-only STATUS mandatory DESCRIPTION "The object is the currently active link width." ::= { gswIBPortEntry 14 } gswIBLinkSpeedSupported OBJECT-TYPE SYNTAX GswIBLinkSpeed ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the supported link speed." ::= { gswIBPortEntry 15 } swIBPortState OBJECT-TYPE SYNTAX SwIBPortState ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the port state." ::= { gswIBPortEntry 16 } gswIBPortPhysicalState OBJECT-TYPE SYNTAX GswIBPortPhysState ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the port physical state." ::= { gswIBPortEntry 17 } gswIBLinkDownDefaultState OBJECT-TYPE SYNTAX INTEGER { nop (0), sleep (1), polling (2) } ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates port down default state." ::= { gswIBPortEntry 18 } gswIBLMC OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object is the LID mask for multipath support." ::= { gswIBPortEntry 20 } Forbes Expires December 31, 2001 Page 48 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBLinkSpeedActive OBJECT-TYPE SYNTAX GswIBLinkSpeed ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the currently active link speed." ::= { gswIBPortEntry 21 } gswIBLinkSpeedEnabled OBJECT-TYPE SYNTAX GswIBLinkSpeed ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the enabled link speed." ::= { gswIBPortEntry 22 } gswIBNeighborMTU OBJECT-TYPE SYNTAX GswIBMTU ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the active maximum MTU enabled on this port for transmit." ::= { gswIBPortEntry 23 } gswIBVLCap OBJECT-TYPE SYNTAX GswIBVL ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the virtual Lanes supported on this port." ::= { gswIBPortEntry 24 } gswIBMTUCap OBJECT-TYPE SYNTAX GswIBMTU ACCESS read-only STATUS mandatory DESCRIPTION "The object is the maximum MTU supported by this port." ::= { gswIBPortEntry 25 } gswIBOperationalVLs OBJECT-TYPE SYNTAX GswIBVL ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the virtual Lanes operational on this port." ::= { gswIBPortEntry 28 } Forbes Expires December 31, 2001 Page 49 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBMKeyViolations OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object counts the number of SMP packets that have been received at this port that have had invalid M_Keys, since power-on or reset. Increments till count reaches all 1s and then must be set back to zero to re-enable incrementing." ::= { gswIBPortEntry 29 } gswIBPKeyViolations OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object counts the number of packets that have been received at this port that have had invalid P_Keys, since power-on or reset. Increments till count reaches all 1s and then must be set back to zero to re-enable incrementing." ::= { gswIBPortEntry 30 } gswIBQKeyViolations OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object counts the number of packets that have been received at this port that have had invalid Q_Keys, since power-on or reset. Increments till count reaches all 1s and then must be set back to zero to re-enable incrementing." ::= { gswIBPortEntry 32 } gswIBLocalPhyErrors OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object is the threshold value. When the count of marginal link errors exceeds this threshold, the local link integrity error shall be detected." ::= { gswIBPortEntry 36 } gswIBOverrunErrors OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object is the threshold value. When the count of buffer overruns over consecutive flow control update periods exceeds this threshold, the excessive buffer overrun error shall be detected." ::= { gswIBPortEntry 37 } Forbes Expires December 31, 2001 Page 50 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBPortChangeReason OBJECT-TYPE SYNTAX INTEGER { unknown (0), link-integrity-error (1), excessive-buf-overrun (2), flow-control-timeout (3), bad-p-key (4) } ACCESS read-only STATUS mandatory DESCRIPTION "The object is mainly implemented to support traps." ::= { gswIBPortEntry 38 } -- -- End of Port group -- -- -- Port Performance Group -- gswIBPortPerfTable OBJECT-TYPE SYNTAX SEQUENCE OF GswIBPortPerfEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The table contains information pertaining to portCounters within Performance Management Agent. Therefore, this table only applies to IB Switch, IB Router, and IB-FC Edge Router type indicated by gswInventoryType in gswInventoryTable." ::= { gswPortPerf 5 } gswIBPortPerfEntry OBJECT-TYPE SYNTAX GswIBPortPerfEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry of the IB port information." INDEX { gswIBPortPerfSwitchId, gswIBPortPerfIndex } ::= { gswIBPortPerfTable 1 } Forbes Expires December 31, 2001 Page 51 Internet Draft InfiniBand Switch MIB July 11, 2001 GswIBPortPerfEntry ::= SEQUENCE { gswIBPortPerfSwitchId GswGlobalId, gswIBPortPerfIndex INTEGER, gswIBSymbolErrorCounter GswCounter64, gswIBLinkErrorRecoveryCounter GswCounter64, gswIBLinkDownedCounter GswCounter64, gswIBPortRcvErrors GswCounter64, gswIBPortRcvRemotePhysicalErrors GswCounter64, gswIBPortRcvSwitchRelayErrors GswCounter64, gswIBPortXmitDiscards GswCounter64, gswIBPortXmitConstraintErrors GswCounter64, gswIBPortRcvConstraintErrors GswCounter64, gswIBLocalLinkIntegrityErrors GswCounter64, gswIBExcessiveBufferOverrunErrors GswCounter64, gswIBVL15Dropped GswCounter64, gswIBPortXmitData GswCounter64, gswIBPortRcvData GswCounter64, gswIBPortXmitPkts GswCounter64, gswIBPortRcvPkts GswCounter64 } gswIBPortPerfSwitchId OBJECT-TYPE SYNTAX GswGlobalId ACCESS read-only STATUS mandatory DESCRIPTION "The object is one of the two indexes used by gswIBPortPerfTable. This object corresponds to gswGlobalSwitchId." ::= { gswIBPortPerfEntry 1 } gswIBPortPerfIndex OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object is one of two indexes used by gswIBPortPerfTable. The object identifies the physical port number." ::= { gswIBPortPerfEntry 2 } gswIBSymbolErrorCounter OBJECT-TYPE SYNTAX GswCounter64 ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates total number of symbol errors detected on one or more lanes." ::= { gswIBPortPerfEntry 3 } Forbes Expires December 31, 2001 Page 52 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBLinkErrorRecoveryCounter OBJECT-TYPE SYNTAX GswCounter64 ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates total number of times the Port Training state machine has successfully completed the link error recovery process." ::= { gswIBPortPerfEntry 4 } gswIBLinkDownedCounter OBJECT-TYPE SYNTAX GswCounter64 ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates total number of times the Port Training state machine has failed the link error recovery process and downed the link." ::= { gswIBPortPerfEntry 5 } gswIBPortRcvErrors OBJECT-TYPE SYNTAX GswCounter64 ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates total number of packets containing an error that were received on the port." ::= { gswIBPortPerfEntry 6 } gswIBPortRcvRemotePhysicalErrors OBJECT-TYPE SYNTAX GswCounter64 ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates total number of packets marked with the EBP delimiter received on the port." ::= { gswIBPortPerfEntry 7 } gswIBPortRcvSwitchRelayErrors OBJECT-TYPE SYNTAX GswCounter64 ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates total number of packets received on the port that were discarded because they could not be forwarded by the switch relay." ::= { gswIBPortPerfEntry 8 } gswIBPortXmitDiscards OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates total number of outbound packets discarded by the port because the port is down or congested." ::= { gswIBPortPerfEntry 9 } Forbes Expires December 31, 2001 Page 53 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBPortXmitConstraintErrors OBJECT-TYPE SYNTAX GswCounter64 ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates total number of packets not transmitted from the port." ::= { gswIBPortPerfEntry 10 } gswIBPortRcvConstraintErrors OBJECT-TYPE SYNTAX GswCounter64 ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates total number of packets received on the port that are discarded." ::= { gswIBPortPerfEntry 11 } gswIBLocalLinkIntegrityErrors OBJECT-TYPE SYNTAX GswCounter64 ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the number of times that the frequency of packets containing local physical errors exceeded local_phy_errors." ::= { gswIBPortPerfEntry 12 } gswIBExcessiveBufferOverrunErrors OBJECT-TYPE SYNTAX GswCounter64 ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the number of times that overrun errors consecutive flow control update periods occurred with at least one overrun error in each period." ::= { gswIBPortPerfEntry 13 } gswIBVL15Dropped OBJECT-TYPE SYNTAX GswCounter64 ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates the number of incoming VL15 packets dropped due to resource limitations on port." ::= { gswIBPortPerfEntry 14 } Forbes Expires December 31, 2001 Page 54 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBPortXmitData OBJECT-TYPE SYNTAX GswCounter64 ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates total number of data octets, divided by 4, transmitted on all VLs from the port. This includes all octets between (and not including) the start of packet delimiter and VCRC. It excludes all link packets." ::= { gswIBPortPerfEntry 15 } gswIBPortRcvData OBJECT-TYPE SYNTAX GswCounter64 ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates total number of data octets, divided by 4, received on all VLs on the port. This includes all octets between (and not including) the start of packet delimiter and VCRC. It excludes all link packets." ::= { gswIBPortPerfEntry 16 } gswIBPortXmitPkts OBJECT-TYPE SYNTAX GswCounter64 ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates total number of packets, excluding link packets, transmitted on all VLs from the port." ::= { gswIBPortPerfEntry 17 } gswIBPortRcvPkts OBJECT-TYPE SYNTAX GswCounter64 ACCESS read-only STATUS mandatory DESCRIPTION "The object indicates total number of packets, including packets containing errors and excluding link packets, received from all VLs on the port." ::= { gswIBPortPerfEntry 18 } -- -- End of Port Performance group -- -- -- Name Service group -- -- -- End of Name Service group -- Forbes Expires December 31, 2001 Page 55 Internet Draft InfiniBand Switch MIB July 11, 2001 -- -- Event Group -- -- NOTE -- Logically, gswEventTable is separate from the error log since -- it is essentially a view of the error log within a particular -- time window. -- The value of gswEventIndex shall indicate the event number that -- has occurred since the switch booted. The value will range -- from 1 through 2147383647 (2^31 - 1). -- gswEventTable OBJECT-TYPE SYNTAX SEQUENCE OF GswEventEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The table of event entries." ::= { gswEvent 1 } gswEventEntry OBJECT-TYPE SYNTAX GswEventEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry of the event table." INDEX { gswEventSwitchId, gswEventIndex } ::= { gswEventTable 1 } GswEventEntry ::= SEQUENCE { gswEventSwitchId GswGlobalId, gswEventIndex INTEGER, gswEventTimeInfo DisplayString, gswEventLevel GswEventSeverity, gswEventRepeatCount INTEGER, gswEventDescr DisplayString } gswEventSwitchId OBJECT-TYPE SYNTAX GswGlobalId ACCESS read-only STATUS mandatory DESCRIPTION "The object is the index used by gswEventTable. This object corresponds to gswGlobalSwitchId." ::= { gswEventEntry 1 } gswEventIndex OBJECT-TYPE SYNTAX INTEGER (1..30) ACCESS read-only STATUS mandatory DESCRIPTION "This object identifies the event entry." ::= { gswEventEntry 2 } Forbes Expires December 31, 2001 Page 56 Internet Draft InfiniBand Switch MIB July 11, 2001 gswEventTimeInfo OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "This object identifies the date and time when this event occurred, in textual format." ::= { gswEventEntry 3 } gswEventLevel OBJECT-TYPE SYNTAX GswEventSeverity ACCESS read-only STATUS mandatory DESCRIPTION "This object identifies the severity level of this event entry." ::= { gswEventEntry 4 } gswEventRepeatCount OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "This object identifies how many times this particular event has occurred." ::= { gswEventEntry 5 } gswEventDescr OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "This object identifies the textual description of the event." ::= { gswEventEntry 6 } -- -- End of Event Group -- -- -- EndDevice Group -- -- -- End of EndDevice Group -- Forbes Expires December 31, 2001 Page 57 Internet Draft InfiniBand Switch MIB July 11, 2001 -- -- SNMP Agent Configuration -- gswAgtCmtyTable OBJECT-TYPE SYNTAX SEQUENCE OF GswAgtCmtyEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A table that contains, one entry for each Community, the access control and parameters of the Community." ::= { gswAgtCfg 11 } gswAgtCmtyEntry OBJECT-TYPE SYNTAX GswAgtCmtyEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry containing the Community parameters." INDEX { gswAgtCmtySwitchId, gswAgtCmtyIdx } ::= { gswAgtCmtyTable 1 } GswAgtCmtyEntry ::= SEQUENCE { gswAgtCmtySwitchId GswGlobalId, gswAgtCmtyIdx INTEGER (1..6), gswAgtCmtyStr DisplayString (SIZE (0..16)), gswAgtTrapRcp NetworkAddress } gswAgtCmtySwitchId OBJECT-TYPE SYNTAX GswGlobalId ACCESS read-only STATUS mandatory DESCRIPTION "The object is the index used by gswAgtCmtyTable. This object corresponds to gswGlobalSwitchId." ::= { gswAgtCmtyEntry 1 } gswAgtCmtyIdx OBJECT-TYPE SYNTAX INTEGER (1..6) ACCESS read-only STATUS mandatory DESCRIPTION "This object identifies the SNMPv1 Community entry." ::= { gswAgtCmtyEntry 2 } Forbes Expires December 31, 2001 Page 58 Internet Draft InfiniBand Switch MIB July 11, 2001 gswAgtCmtyStr OBJECT-TYPE SYNTAX DisplayString (SIZE (0..16)) ACCESS read-write STATUS mandatory DESCRIPTION "This is a Community string supported by the agent. If a new value is set successfully, it takes effect immediately." ::= { gswAgtCmtyEntry 3 } gswAgtTrapRcp OBJECT-TYPE SYNTAX NetworkAddress ACCESS read-write STATUS mandatory DESCRIPTION "This is the trap recipient associated with the Community. If a new value is set successfully, it takes effect immediately." ::= { gswAgtCmtyEntry 4 } -- -- End of SNMP Agent Configuration Group -- -- -- Traps Group -- gswTopoComTrap TRAP-TYPE ENTERPRISE gsw VARIABLES { gswTopoComSwitchId, gswTopoComNbSwitchId, gswTopoComSwitchStatus } DESCRIPTION "This trap is generated when changes happen in a SAN." ::= 1 gswIBTopoTrap TRAP-TYPE ENTERPRISE gsw VARIABLES { gswIBTopoSwitchId, gswIBTopoChangeReason } DESCRIPTION "This trap is generated when changes happen in an IB subnet." ::= 2 gswIBPortTrap TRAP-TYPE ENTERPRISE gsw VARIABLES { gswIBPortSwitchId, gswIBPortIndex, gswIBPortChangeReason } DESCRIPTION "This trap is generated when changes happen in IB switch ports." ::= 5 Forbes Expires December 31, 2001 Page 59 Internet Draft InfiniBand Switch MIB July 11, 2001 gswIBSwitchTrap TRAP-TYPE ENTERPRISE gsw VARIABLES { gswIBSwSwitchId, gswIBSwitchChangeReason } DESCRIPTION "This trap is generated when changes happen in IB switches." ::= 8 gswEventTrap TRAP-TYPE ENTERPRISE gsw VARIABLES { gswEventSwitchId, gswEventIndex, gswEventTimeInfo, gswEventLevel, gswEventRepeatCount, gswEventDescr } DESCRIPTION "This trap is generated when an event whose level at or below gswEventTrapLevel occurs." ::= 10 END Forbes Expires December 31, 2001 Page 60 Internet Draft InfiniBand Switch MIB July 11, 2001 5. Security Considerations There are a number of management objects defined in this MIB that have a MAX-ACCESS clause of read-write. Such objects may be considered sensitive or vulnerable in some network environments. The support for SET operations in a non-secure environment without proper protection can have a negative effect on network operations. 6. Intellectual Property The IETF takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on the IETF's procedures with respect to rights in standards-track and standards-related documentation can be found in BCP-11. Copies of claims of rights made available for publication and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementors or users of this specification can be obtained from the IETF Secretariat. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights which may cover technology that may be required to practice this standard. Please address the information to the IETF Executive Director. 7. Acknowledgements The editors would like to thank the following individuals for their assistance and constructive comments: Ken Dziuba, BCSI Sanjeev Singh, BCSI Ashish Hanwadikar, BCSI 8. References 8.1. RFCs [RFC2571] Harrington, D., Presuhn, R., and B. Wijnen, "An Architecture for Describing SNMP Management Frameworks", RFC 2571, April 1999. [RFC1155] Rose, M., and K. McCloghrie, "Structure and Identification of Management Information for TCP/IP- Forbes Expires December 31, 2001 Page 61 Internet Draft InfiniBand Switch MIB July 11, 2001 based Internets", STD 16, RFC 1155, May 1990. [RFC1212] Rose, M., and K. McCloghrie, "Concise MIB Definitions", STD 16, RFC 1212, March 1991. [RFC1215] M. Rose, "A Convention for Defining Traps for use with the SNMP", RFC 1215, March 1991. [RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, "Structure of Management Information Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. [RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, "Textual Conventions for SMIv2", STD 58, RFC 2579, April 1999. [RFC2580] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, "Conformance Statements for SMIv2", STD 58, RFC 2580, April 1999. [RFC1157] Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple Network Management Protocol", STD 15, RFC 1157, May 1990. [RFC1901] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Introduction to Community-based SNMPv2", RFC 1901, January 1996. [RFC1906] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Transport Mappings for Version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1906, January 1996. [RFC2572] Case, J., Harrington D., Presuhn R., and B. Wijnen, "Message Processing and Dispatching for the Simple Network Management Protocol (SNMP)", RFC 2572, April 1999. [RFC2574] Blumenthal, U., and B. Wijnen, "User-based Security Model (USM) for version 3 of the Simple Network Management Protocol (SNMPv3)", RFC 2574, April 1999. [RFC1905] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol Operations for Version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1905, January 1996. [RFC2573] Levi, D., Meyer, P., and B. Stewart, "SNMPv3 Applications", RFC 2573, April 1999. [RFC2575] Wijnen, B., Presuhn, R., and K. McCloghrie, "View-based Access Control Model (VACM) for the Simple Network Management Protocol (SNMP)", RFC 2575, April 1999. Forbes Expires December 31, 2001 Page 62 Internet Draft InfiniBand Switch MIB July 11, 2001 [RFC2570] Case, J., Mundy, R., Partain, D., and B. Stewart, "Introduction to Version 3 of the Internet-standard Network Management Framework", RFC 2570, April 1999. 8.2. InfiniBand References [1] InfiniBand Trade Association, "InfiniBand Architecture Specification Release 1.0", October 24, 2000 9. Authors' Addresses Brian Forbes Brocade Communications 1745 Technology Drive Phone: 1-408-501-8796 San Jose, CA. USA Email: bforbes@brocade.com 10. Full Copyright Statement Copyright (C) The Internet Society (1999). All Rights Reserved. This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English. The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns. This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Forbes Expires December 31, 2001 Page 63