-- ***************************************************************** -- CISCO-ENTITY-SENSOR-EXT-MIB.my -- -- Copyright (c) 2010 by cisco Systems Inc. -- All rights reserved. -- -- ***************************************************************** CISCO-ENTITY-SENSOR-EXT-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, Unsigned32 FROM SNMPv2-SMI MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF TEXTUAL-CONVENTION, TruthValue FROM SNMPv2-TC entPhysicalName, entPhysicalDescr, entPhysicalIndex FROM ENTITY-MIB EntitySensorValue, entPhySensorValue, entPhySensorType FROM ENTITY-SENSOR-MIB ciscoMgmt FROM CISCO-SMI; ciscoEntitySensorExtMIB MODULE-IDENTITY LAST-UPDATED "201006100000Z" ORGANIZATION "Cisco Systems, Inc." CONTACT-INFO "Postal: Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA Tel: +1 408 526 4000 E-mail: cs-snmp@cisco.com" DESCRIPTION "This MIB is extension to ENTITY-SENSOR-MIB(RFC 3433). This MIB also defines the notifications applicable for sensors reported in ENTITY-MIB(RFC 4133)." REVISION "201006090000Z" DESCRIPTION "Initial version of this MIB module." ::= { ciscoMgmt 745 } ciscoEntitySensorExtMIBNotifs OBJECT IDENTIFIER ::= { ciscoEntitySensorExtMIB 0 } ciscoEntitySensorExtMIBObjects OBJECT IDENTIFIER ::= { ciscoEntitySensorExtMIB 1 } ciscoEntitySensorExtMIBConform OBJECT IDENTIFIER ::= { ciscoEntitySensorExtMIB 2 } CiscoSensorThresholdSeverity ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "sensor threshold severity. Valid values are: other(1) : a severity other than those listed below. minor(10) : Minor Problem threshold. major(20) : Major Problem threshold. critical(30): Critical problem threshold. A system might shut down the sensor associated FRU automatically if the sensor value reach the critical problem threshold." SYNTAX INTEGER { other(1), minor(10), major(20), critical(30) } CiscoSensorThresholdRelation ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "sensor threshold relational operator types. valid values are: lessThan(1): if the sensor value is less than the threshold value lessOrEqual(2): if the sensor value is less than or equal to the threshold value greaterThan(3): if the sensor value is greater than the threshold value greaterOrEqual(4): if the sensor value is greater than or equal to the threshold value equalTo(5): if the sensor value is equal to the threshold value notEqualTo(6): if the sensor value is not equal to the threshold value" SYNTAX INTEGER { lessThan(1), lessOrEqual(2), greaterThan(3), greaterOrEqual(4), equalTo(5), notEqualTo(6) } -- ceSensorExtThresholdTable ceSensorExtThresholdTable OBJECT-TYPE SYNTAX SEQUENCE OF CeSensorExtThresholdEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table lists the threshold severity, relation, and comparison value, for a sensor entity listed in entPhysicalTable." REFERENCE "ENTITY-MIB contains definition for entPhysicalTable" ::= { ciscoEntitySensorExtMIBObjects 1 } ceSensorExtThresholdEntry OBJECT-TYPE SYNTAX CeSensorExtThresholdEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An ceSensorExtThresholdTable entry describes the thresholds for a sensor: the threshold severity, the threshold value, the relation, and the evaluation of the threshold. Only entities with entPhysicalClass 'sensor' are listed in this table. For non FRU entities the entries are created by the agent at system startup and entries are never deleted by the agent. For FRU entities the entries are created at system startup if FRU is inserted at system startup, else entries are created when FRU is inserted. Entries are deleted by the agent when FRU is removed." REFERENCE "ENTITY-MIB contains definition for entPhysicalClass" INDEX { entPhysicalIndex, ceSensorExtThresholdIndex } ::= { ceSensorExtThresholdTable 1 } CeSensorExtThresholdEntry ::= SEQUENCE { ceSensorExtThresholdIndex Unsigned32, ceSensorExtThresholdSeverity CiscoSensorThresholdSeverity, ceSensorExtThresholdRelation CiscoSensorThresholdRelation, ceSensorExtThresholdValue EntitySensorValue, ceSensorExtThresholdEvaluation TruthValue, ceSensorExtThresholdNotifEnable INTEGER } ceSensorExtThresholdIndex OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that uniquely identifies an entry in the ceSensorExtThresholdTable. This index permits the same sensor to have several different thresholds." ::= { ceSensorExtThresholdEntry 1 } ceSensorExtThresholdSeverity OBJECT-TYPE SYNTAX CiscoSensorThresholdSeverity MAX-ACCESS read-write STATUS current DESCRIPTION "This object specifies the severity of this threshold." ::= { ceSensorExtThresholdEntry 2 } ceSensorExtThresholdRelation OBJECT-TYPE SYNTAX CiscoSensorThresholdRelation MAX-ACCESS read-write STATUS current DESCRIPTION "This object specifies the boolean relation between sensor value (entPhySensorValue) and threshold value (ceSensorExtThresholdValue), required to trigger the alarm. in pseudo-code, the evaluation-alarm mechanism is: ... if (evaluate(entPhySensorValue, ceSensorExtThresholdRelation, ceSensorExtThresholdValue)) then if (((ceSensorExtThresholdNotifEnable == enabled) || (ceSensorExtThresholdNotifEnable == transparent)) && (ceSensorExtThresholdNotifGlobalEnable == enabled)) then raise_alarm(sensor's entPhysicalIndex); endif endif ..." ::= { ceSensorExtThresholdEntry 3 } ceSensorExtThresholdValue OBJECT-TYPE SYNTAX EntitySensorValue MAX-ACCESS read-write STATUS current DESCRIPTION "This object specifies the value of the threshold. The value of objects entPhySensorType, entPhysSensorScale and entPhySensorPrecision for this sensor entity defines how ceSensorExtThresholdValue can be displayed or intepreted by the user. entPhySensorValue can be compared with ceSensorExtThresholdValue without taking care of semantics of both objects." REFERENCE "ENTITY-SENSOR-MIB contains definitions for entPhysSensorScale and entPhySensorPrecision" ::= { ceSensorExtThresholdEntry 4 } ceSensorExtThresholdEvaluation OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "This object indicates the result of the most recent evaluation of the threshold. The agent will execute the below 'evaluate' function to generate the notification. 'evaluate' function returns a boolean value. evaluate(entPhySensorValue, ceSensorExtThresholdRelation, ceSensorExtThresholdValue) If evalute function returns true then ceSensorExtThresholdEvaluation is set to 'true' If evaluate function returns false then ceSensorExtThresholdEvaluation is set to 'false'. Thresholds are evaluated at the rate indicated by entPhySensorValueUpdateRate." REFERENCE "ENTITY-SENSOR-MIB contains definition for entPhySensorValueUpdateRate" ::= { ceSensorExtThresholdEntry 5 } ceSensorExtThresholdNotifEnable OBJECT-TYPE SYNTAX INTEGER { enabled(1), disabled(2), transparent(3) } MAX-ACCESS read-write STATUS current DESCRIPTION "A control object to activate/deactivate ceSensorExtThresholdNotification. This object should hold any of the below values. enabled(1) - The notification is enabled for this entity disabled(2) - The notification is disabled for this entity transparent(3)- The notification is enabled/disabled based on ceSensorExtThresholdNotifGlobalEnable object This object controls generation of ceSensorExtThresholdNotification for this threshold. An exception to this is, if this object is set to 'transparent' then ceSensorExtThresholdNotification for this threshold is controlled by ceSensorExtThresholdNotifGlobalEnable object. This truth table explains how ceSensorExtThresholdNotifEnable is related with ceSensorExtThresholdNotifGlobalEnable to control the ceSensorExtThresholdNotification for this threshold E = enabled, D = Disabled, T = Transparent local_flag = ceSensorExtThresholdNotifEnable global_flag = ceSensorExtThresholdNotifGlobalEnable local_flag global_flag outcome_per_interface --------------------------------------------- E E E E D D D E D D D D T E E T D D" DEFVAL { transparent } ::= { ceSensorExtThresholdEntry 6 } ciscoEntSensorExtGlobalObjects OBJECT IDENTIFIER ::= { ciscoEntitySensorExtMIBObjects 2 } -- Extended entity Sensor Global Objects ceSensorExtThresholdNotifGlobalEnable OBJECT-TYPE SYNTAX INTEGER { enabled(1), disabled(2) } MAX-ACCESS read-write STATUS current DESCRIPTION "A control object to activate/deactivate ceSensorExtThresholdNotification. This object should hold any of the below values. enabled(1) - The notification is enabled globally on the device disabled(2)- The notification is disabled globally on the device This object enables the generation of ceSensorExtThresholdNotification globally on the device. If this object value is 'disabled', then no ceSensorExtThresholdNotification will be generated on this device. If this object value is 'enabled', then whether a ceSensorExtThresholdNotification for a threshold will be generated or not depends on the instance value of ceSensorExtThresholdNotifEnable for that threshold." DEFVAL { disabled } ::= { ciscoEntSensorExtGlobalObjects 1 } -- Extended entity Sensor notifications ceSensorExtThresholdNotification NOTIFICATION-TYPE OBJECTS { entPhysicalName, entPhysicalDescr, entPhySensorValue, entPhySensorType, ceSensorExtThresholdValue } STATUS current DESCRIPTION "This notification is generated once each time the sensor value crosses the threshold value specified by ceSensorExtThresholdValue object." ::= { ciscoEntitySensorExtMIBNotifs 1 } -- conformance information ciscoEntSensorExtMIBCompliances OBJECT IDENTIFIER ::= { ciscoEntitySensorExtMIBConform 1 } ciscoEntSensorExtMIBGroups OBJECT IDENTIFIER ::= { ciscoEntitySensorExtMIBConform 2 } -- compliance statements ciscoEntSensorExtMIBCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "An ENTITY-MIB implementation that adds notification for sensors in the entPhysicalTable must implement this group." MODULE -- this module MANDATORY-GROUPS { ciscoEntSensorExtThresholdGroup } GROUP ciscoEntSensorExtNotificationCtrlGroup DESCRIPTION "This group is mandatory for the platforms which support global notification control on ceSensorExtThresholdNotification." GROUP ciscoEntSensorExtNotificationGroup DESCRIPTION "This group is mandatory for the platforms which support ceSensorExtThresholdTable and entPhySensorTable." ::= { ciscoEntSensorExtMIBCompliances 1 } -- units of conformance ciscoEntSensorExtThresholdGroup OBJECT-GROUP OBJECTS { ceSensorExtThresholdSeverity, ceSensorExtThresholdRelation, ceSensorExtThresholdValue, ceSensorExtThresholdEvaluation, ceSensorExtThresholdNotifEnable } STATUS current DESCRIPTION "The collection of objects which are used to describe and monitor thresholds for sensors." ::= { ciscoEntSensorExtMIBGroups 1 } ciscoEntSensorExtNotificationGroup NOTIFICATION-GROUP NOTIFICATIONS { ceSensorExtThresholdNotification } STATUS current DESCRIPTION "The collection of notifications used for monitoring sensor threshold activity." ::= { ciscoEntSensorExtMIBGroups 2 } ciscoEntSensorExtNotificationCtrlGroup OBJECT-GROUP OBJECTS { ceSensorExtThresholdNotifGlobalEnable } STATUS current DESCRIPTION "The collection of objects which provide the global notification control on ceSensorExtThresholdNotification." ::= { ciscoEntSensorExtMIBGroups 3 } END