draft-ietf-entmib-state-05.txt   draft-ietf-entmib-state-06.txt 
Entity MIB Working Group S. Chisholm Entity MIB Working Group S. Chisholm
Internet Draft Nortel Networks Internet Draft Nortel Networks
Document: draft-ietf-entmib-state-05.txt D. Perkins Document: draft-ietf-entmib-state-06.txt D. Perkins
Category: Standards Track SNMPinfo Category: Standards Track SNMPinfo
Expiration Date: March 2005 September 2004 Expiration Date: June 2005 December 2004
Entity State MIB Entity State MIB
Status of this Memo Status of this Memo
By submitting this Internet-Draft, I certify that any applicable By submitting this Internet-Draft, I certify that any applicable
patent or other IPR claims of which I am aware have been disclosed, or patent or other IPR claims of which I am aware have been disclosed, or
will be disclosed, and any of which I become aware will be disclosed, will be disclosed, and any of which I become aware will be disclosed,
in accordance with RFC 3668. in accordance with RFC 3668.
skipping to change at page 2, line 4 skipping to change at page 2, line 4
In particular, it describes extensions to the Entity MIB to In particular, it describes extensions to the Entity MIB to
provide information about the state of physical entities. provide information about the state of physical entities.
Table of Contents Table of Contents
1. The Internet-Standard Management Framework 1. The Internet-Standard Management Framework
2. Entity State 2. Entity State
2.1. Hierarchical State Management 2.1. Hierarchical State Management
2.2. Entity Redundancy 2.2. Entity Redundancy
2.3. Physical Entity Users 2.3. Physical Entity Users
Entity State MIB September 2004
2.4. Physical Class Behaviour 2.4. Physical Class Behaviour
3. Relationship to Other MIBs 3. Relationship to Other MIBs
3.1. Relation to Interfaces MIB 3.1. Relation to Interfaces MIB
3.2. Relation to Alarm MIB 3.2. Relation to Alarm MIB
3.3. Relation to Bridge MIB 3.3. Relation to Bridge MIB
3.4. Relation to Host Resource MIB 3.4. Relation to Host Resource MIB
4. Textual Conventions 4. Textual Conventions
5. Definitions 5. Definitions
6. Security Considerations 6. Security Considerations
7. Intellectual Property 7. Intellectual Property
8. Authors' Addresses 8. Authors' Addresses
9. Acknowledgements 9. Acknowledgements
10. References 10. References
11. Full Copyright Statement 11. Full Copyright Statement
Entity State MIB September 2004
1. The Internet-Standard Management Framework 1. The Internet-Standard Management Framework
For a detailed overview of the documents that describe the current For a detailed overview of the documents that describe the current
Internet-Standard Management Framework, please refer to section 7 of Internet-Standard Management Framework, please refer to section 7 of
RFC 3410 [RFC3410]. RFC 3410 [RFC3410].
Managed objects are accessed via a virtual information store, termed Managed objects are accessed via a virtual information store, termed
the Management Information Base or MIB. MIB objects are generally the Management Information Base or MIB. MIB objects are generally
accessed through the Simple Network Management Protocol (SNMP). accessed through the Simple Network Management Protocol (SNMP).
Objects in the MIB are defined using the mechanisms defined in the Objects in the MIB are defined using the mechanisms defined in the
skipping to change at page 3, line 46 skipping to change at page 3, line 44
against using the entity and is imposed through the management against using the entity and is imposed through the management
services. services.
Operational state indicates whether or not the entity is physically Operational state indicates whether or not the entity is physically
installed and working. Note that unlike the ifOperStatus [RFC2863], installed and working. Note that unlike the ifOperStatus [RFC2863],
this operational state is independent of the administrative state. this operational state is independent of the administrative state.
Usage state indicates whether or not the entity is in use at a Usage state indicates whether or not the entity is in use at a
specific instance, and if so, whether or not it currently has spare specific instance, and if so, whether or not it currently has spare
capacity to serve additional users. In the context of this MIB, the capacity to serve additional users. In the context of this MIB, the
user is equivalent to an entity, so this term is substituted. This usage state refers to the ability of an entity to service other
state refers to the ability of the entity to service other entities entities within its containment hierarchy.
within its containment hierarchy.
Alarm state indicates whether or not there are any alarms active Alarm state indicates whether or not there are any alarms active
against the entity. In addition to those alarm status defined in against the entity. In addition to those alarm states defined in
X.731 [X.731], warning and indeterminate status are also defined to X.731 [X.731], warning and indeterminate status are also defined to
provide a more complete mapping to the Alarm MIB [Alarm-MIB]. provide a more complete mapping to the Alarm MIB [Alarm-MIB].
Standby state indicates whether the entity is currently running as Standby state indicates whether the entity is currently running as
hot standby, cold standby or is currently providing service. hot standby, cold standby or is currently providing service.
Entity State MIB September 2004
The terms state and status are used interchangeably in this memo. The terms state and status are used interchangeably in this memo.
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [RFC2119]. document are to be interpreted as described in RFC 2119 [RFC2119].
2.1 Hierarchical State Management 2.1 Hierarchical State Management
Physical entities exist within a containment hierarchy. Physical Physical entities exist within a containment hierarchy. Physical
containment is defined by the entPhysicalContainedIn containment is defined by the entPhysicalContainedIn
object[RFC2737]. This raises some interesting issues not addressed object[RFC2737]. This raises some interesting issues not addressed
in existing work on state management [X.731]. in existing work on state management.
There are two types of state for an entity: There are two types of state for an entity:
1) The state of the entity independent of the states of its parents 1) The state of the entity independent of the states of its parents
and children in its containment hierarchy. This is often referred to and children in its containment hierarchy. This is often referred to
as raw state. as raw state.
2) The state of the entity, as it may be influenced by the state of 2) The state of the entity, as it may be influenced by the state of
its parents and children. This is often referred to as computed its parents and children. This is often referred to as computed
state. state.
skipping to change at page 5, line 5 skipping to change at page 5, line 5
2. Anywhere in physical hierarchy 2. Anywhere in physical hierarchy
3. As defined by a means outside the scope of this MIB. This could 3. As defined by a means outside the scope of this MIB. This could
include logical interfaces that could run on a port, software that include logical interfaces that could run on a port, software that
could run on a module, etc. could run on a module, etc.
Administrative, operational, alarm and standby state use all three Administrative, operational, alarm and standby state use all three
definitions of 'user'. Usage state only supports the concept of definitions of 'user'. Usage state only supports the concept of
direct containment to simplify implementations of this object. direct containment to simplify implementations of this object.
Entity State MIB September 2004
2.4 Physical Class Behaviour 2.4 Physical Class Behaviour
This MIB makes no effort to standardize on the behaviours and This MIB makes no effort to standardize on the behaviours and
characteristics of the various physical classes [RFC2737], but characteristics of the various physical classes [RFC2737], but
rather how this information is reported. In looking at real-world rather how this information is reported. In looking at real-world
products, items within the same physical class vary substantially. products, items within the same physical class vary substantially.
The MIB has therefore provided guidance on how to support objects The MIB has therefore provided guidance on how to support objects
where a particular instance of a physical class can not support part where a particular instance of a physical class can not support part
or all of a particular state. or all of a particular state.
skipping to change at page 6, line 5 skipping to change at page 6, line 5
within this objects containment hierarchy and other available within this objects containment hierarchy and other available
related states. related states.
3.2 Relation to Alarm MIB 3.2 Relation to Alarm MIB
The entStateAlarm object indicates whether or not there are any The entStateAlarm object indicates whether or not there are any
active alarms against this entity. If there are active alarms, then active alarms against this entity. If there are active alarms, then
the alarmActiveTable in the Alarm MIB [Alarm MIB] should be searched the alarmActiveTable in the Alarm MIB [Alarm MIB] should be searched
for alarmActiveResourceId that match this entPhysicalIndex. for alarmActiveResourceId that match this entPhysicalIndex.
Entity State MIB September 2004
Alternatively, if the alarmActiveTable is queried first and an Alternatively, if the alarmActiveTable is queried first and an
active alarm with a value of alarmActiveResourceId that matches this active alarm with a value of alarmActiveResourceId that matches this
entPhysicalIndex is found, then entStateAlarm can be used to quickly entPhysicalIndex is found, then entStateAlarm can be used to quickly
determine if there are additional active alarms against this determine if there are additional active alarms against this
physical entity. physical entity.
3.3 Relation to Bridge MIB 3.3 Relation to Bridge MIB
For entities of physical type of 'port' that support the For entities of physical type of 'port' that support the
dot1dStpPortEnable object in the Bridge MIB [RFC1493], a value of dot1dStpPortEnable object in the Bridge MIB [RFC1493], a value of
skipping to change at page 6, line 36 skipping to change at page 6, line 34
'unknown' for hrDeviceStatus corresponds to an entStateOper value of 'unknown' for hrDeviceStatus corresponds to an entStateOper value of
'unknown'. A value of 'running' corresponds to an entStateOper value 'unknown'. A value of 'running' corresponds to an entStateOper value
of 'enabled'. A value of 'warning' also corresponds to an of 'enabled'. A value of 'warning' also corresponds to an
entStateOper value of 'enabled', but with appropriate bits set in entStateOper value of 'enabled', but with appropriate bits set in
the entStateAlarm object to indicate the alarms corresponding to the the entStateAlarm object to indicate the alarms corresponding to the
unusual error condition detected. A value of 'testing' or 'down' is unusual error condition detected. A value of 'testing' or 'down' is
equivalent to an entStateOper value of 'disabled'. equivalent to an entStateOper value of 'disabled'.
4. Textual Conventions 4. Textual Conventions
ENTITY-STATE-TC DEFINITIONS ::= BEGIN ENTITY-STATE-TC-MIB DEFINITIONS ::= BEGIN
IMPORTS IMPORTS
MODULE-IDENTITY, mib-2 FROM SNMPv2-SMI MODULE-IDENTITY, mib-2 FROM SNMPv2-SMI
TEXTUAL-CONVENTION FROM SNMPv2-TC; TEXTUAL-CONVENTION FROM SNMPv2-TC;
entityStateTc MODULE-IDENTITY entityStateTc MODULE-IDENTITY
LAST-UPDATED "200407190000Z" LAST-UPDATED "200407190000Z"
ORGANIZATION "IETF Entity MIB Working Group" ORGANIZATION "IETF Entity MIB Working Group"
CONTACT-INFO CONTACT-INFO
"General Discussion: entmib@ietf.org "General Discussion: entmib@ietf.org
skipping to change at page 7, line 4 skipping to change at page 7, line 4
http://www.ietf.org/mailman/listinfo/entmib http://www.ietf.org/mailman/listinfo/entmib
http://www.ietf.org/html.charters/entmib-charter.html http://www.ietf.org/html.charters/entmib-charter.html
Sharon Chisholm Sharon Chisholm
Nortel Networks Nortel Networks
PO Box 3511 Station C PO Box 3511 Station C
Ottawa, Ont. K1Y 4H7 Ottawa, Ont. K1Y 4H7
Canada Canada
schishol@nortelnetworks.com schishol@nortelnetworks.com
Entity State MIB September 2004
David T. Perkins David T. Perkins
548 Qualbrook Ct 548 Qualbrook Ct
San Jose, CA 95110 San Jose, CA 95110
USA USA
Phone: 408 394-8702 Phone: 408 394-8702
dperkins@snmpinfo.com" dperkins@snmpinfo.com"
DESCRIPTION DESCRIPTION
"This MIB defines a state textual conventions. "This MIB defines state textual conventions.
Copyright (C) The Internet Society 2004. This version Copyright (C) The Internet Society 2004. This version
of this MIB module is part of RFC yyyy; see the RFC of this MIB module is part of RFC yyyy; see the RFC
itself for full legal notices." itself for full legal notices."
-- RFC Ed.: replace yyyy with actual RFC number & remove -- RFC Ed.: replace yyyy with actual RFC number & remove
-- this note -- this note
REVISION "200407190000Z" REVISION "200407190000Z"
DESCRIPTION DESCRIPTION
"Initial version, published as RFC yyyy." "Initial version, published as RFC yyyy."
-- RFC-Editor assigns yyyy -- RFC-Editor assigns yyyy
skipping to change at page 8, line 4 skipping to change at page 8, line 4
DESCRIPTION DESCRIPTION
" Represents the possible values of operational states. " Represents the possible values of operational states.
A value of 'disabled' means the resource is totally A value of 'disabled' means the resource is totally
inoperable. A value of 'enabled' means the resource inoperable. A value of 'enabled' means the resource
is partially or fully operable. A value of 'testing' is partially or fully operable. A value of 'testing'
means the resource is currently being tested means the resource is currently being tested
and cannot there fore report whether it is operational and cannot there fore report whether it is operational
or not. A value of 'unknown' means that this or not. A value of 'unknown' means that this
resource is unable to report operational state. " resource is unable to report operational state. "
Entity State MIB September 2004
SYNTAX INTEGER SYNTAX INTEGER
{ {
unknown (1), unknown (1),
disabled(2), disabled(2),
enabled(3), enabled(3),
testing (4) testing (4)
} }
EntityUsageState ::= TEXTUAL-CONVENTION EntityUsageState ::= TEXTUAL-CONVENTION
STATUS current STATUS current
skipping to change at page 8, line 42 skipping to change at page 8, line 39
busy(4) busy(4)
} }
EntityAlarmStatus ::= TEXTUAL-CONVENTION EntityAlarmStatus ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Represents the possible values of alarm status. "Represents the possible values of alarm status.
An Alarm [ALARM-MIB] is a persistent indication An Alarm [ALARM-MIB] is a persistent indication
of an error or warning condition. of an error or warning condition.
When no bits of this attribute are set, then none When no bits of this attribute are set, then no active
of the value of under repair is set, the resource is alarms are known against this entity and it is not under
currently being repaired, which depending on the repair.
When the 'value of underRepair' is set, the resource is
currently being repaired, which, depending on the
implementation, may make the other values in this bit implementation, may make the other values in this bit
string unreliable. string not meaningful.
When the value of 'critical' is set, one or more critical When the value of 'critical' is set, one or more critical
alarms are active against the resource. When the value alarms are active against the resource. When the value
of 'major' is set, one or more major alarms are active of 'major' is set, one or more major alarms are active
against the resource. When the value of 'minor' is set, against the resource. When the value of 'minor' is set,
one or more minor alarms are active against the resource. one or more minor alarms are active against the resource.
When the value of 'warning' is set, one or more warning When the value of 'warning' is set, one or more warning
alarms are active against the resource. When the value alarms are active against the resource. When the value
of 'indeterminate' is set, one or more alarms whose of of 'indeterminate' is set, one or more alarms whose of
perceived severity cannot be determined are active perceived severity cannot be determined are active
against this resource. against this resource.
Entity State MIB September 2004
A value of 'unknown' means that this resource is A value of 'unknown' means that this resource is
unable to report alarm state." unable to report alarm state."
SYNTAX BITS SYNTAX BITS
{ {
unknown (0), unknown (0),
underRepair(1), underRepair(1),
critical(2), critical(2),
major(3), major(3),
minor(4), minor(4),
-- The following are not defined in X.733 -- The following are not defined in X.733
skipping to change at page 9, line 56 skipping to change at page 10, line 6
END END
5. Definitions 5. Definitions
ENTITY-STATE-MIB DEFINITIONS ::= BEGIN ENTITY-STATE-MIB DEFINITIONS ::= BEGIN
IMPORTS IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, mib-2 MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, mib-2
FROM SNMPv2-SMI FROM SNMPv2-SMI
TEXTUAL-CONVENTION, DateAndTime DateAndTime
Entity State MIB September 2004
FROM SNMPv2-TC FROM SNMPv2-TC
MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
FROM SNMPv2-CONF FROM SNMPv2-CONF
entPhysicalIndex entPhysicalIndex
FROM ENTITY-MIB FROM ENTITY-MIB
EntityAdminState, EntityOperState, EntityUsageState, EntityAdminState, EntityOperState, EntityUsageState,
EntityAlarmStatus, EntityStandbyStatus EntityAlarmStatus, EntityStandbyStatus
FROM ENTITY-STATE-TC; FROM ENTITY-STATE-TC-MIB;
entityStateMIB MODULE-IDENTITY entityStateMIB MODULE-IDENTITY
LAST-UPDATED "200407190000Z" LAST-UPDATED "200407190000Z"
ORGANIZATION "IETF Entity MIB Working Group" ORGANIZATION "IETF Entity MIB Working Group"
CONTACT-INFO CONTACT-INFO
" General Discussion: entmib@ietf.org " General Discussion: entmib@ietf.org
To Subscribe: To Subscribe:
http://www.ietf.org/mailman/listinfo/entmib http://www.ietf.org/mailman/listinfo/entmib
http://www.ietf.org/html.charters/entmib-charter.html http://www.ietf.org/html.charters/entmib-charter.html
skipping to change at page 10, line 53 skipping to change at page 11, line 4
Copyright (C) The Internet Society 2004. This version Copyright (C) The Internet Society 2004. This version
of this MIB module is part of RFC yyyy; see the RFC of this MIB module is part of RFC yyyy; see the RFC
itself for full legal notices." itself for full legal notices."
-- RFC Ed.: replace yyyy with actual RFC number & remove -- RFC Ed.: replace yyyy with actual RFC number & remove
-- this note -- this note
REVISION "200407190000Z" REVISION "200407190000Z"
DESCRIPTION DESCRIPTION
"Initial version, published as RFC YYYY." "Initial version, published as RFC YYYY."
-- RFC-Editor assigns yyyy -- RFC-Editor assigns yyyy
::= { mib-2 XX} -- to be assigned by IANA ::= { mib-2 XX} -- to be assigned by IANA
-- Entity State Objects -- Entity State Objects
entStateObjects OBJECT IDENTIFIER ::= { entityStateMIB 1 } entStateObjects OBJECT IDENTIFIER ::= { entityStateMIB 1 }
Entity State MIB September 2004
entStateTable OBJECT-TYPE entStateTable OBJECT-TYPE
SYNTAX SEQUENCE OF EntStateEntry SYNTAX SEQUENCE OF EntStateEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A table of information about state/status of entities. "A table of information about state/status of entities.
This is a sparse augment of the entPhysicalTable. Entries This is a sparse augment of the entPhysicalTable. Entries
appear in this table for values of appear in this table for values of
entPhysicalClass [RFC2737] that in this implementation entPhysicalClass [RFC2737] that in this implementation
are able to report any of the state or status stored in are able to report any of the state or status stored in
skipping to change at page 11, line 55 skipping to change at page 12, line 5
time when the value of any of entStateAdmin, time when the value of any of entStateAdmin,
entStateOper, entStateUsage, entStateAlarm, entStateOper, entStateUsage, entStateAlarm,
or entStateStandby changed for this entity. or entStateStandby changed for this entity.
If there has been no change since If there has been no change since
the last re-initialization of the local system, the last re-initialization of the local system,
this object contains the date and time of this object contains the date and time of
local system initialization. If there has been local system initialization. If there has been
no change since the entity was added to the no change since the entity was added to the
local system, this object contains the date and local system, this object contains the date and
time of the insertion" time of the insertion."
::= { entStateEntry 1 } ::= { entStateEntry 1 }
Entity State MIB September 2004
entStateAdmin OBJECT-TYPE entStateAdmin OBJECT-TYPE
SYNTAX EntityAdminState SYNTAX EntityAdminState
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object refers to an entities administrative "The administrative state for this entity.
This object refers to an entities administrative
permission to service both other entities within permission to service both other entities within
its containment hierarchy as well other users of its containment hierarchy as well other users of
its services defined by means outside the scope its services defined by means outside the scope
of this MIB. of this MIB.
The administrative state for this entity.
Setting this object to 'notSupported' will result Setting this object to 'notSupported' will result
in an 'inconsistentValue' error. For entities that in an 'inconsistentValue' error. For entities that
do not support administrative state, all set do not support administrative state, all set
operations will result in an 'inconsistentValue' operations will result in an 'inconsistentValue'
error error.
Some physical entities exhibit only a subset of the Some physical entities exhibit only a subset of the
remaining administrative state values. Some entities remaining administrative state values. Some entities
cannot be locked, and hence this object exhibits only cannot be locked, and hence this object exhibits only
the 'unlocked' state. Other entities can not be shutdown the 'unlocked' state. Other entities can not be shutdown
gracefully, and hence this object does not exhibit the gracefully, and hence this object does not exhibit the
'shuttingDown' state. A value of 'inconsistentValue' 'shuttingDown' state. A value of 'inconsistentValue'
will be returned if attempts are made to set this will be returned if attempts are made to set this
object to values not supported by its administrative object to values not supported by its administrative
model." model."
skipping to change at page 12, line 49 skipping to change at page 12, line 51
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The operational state for this entity. "The operational state for this entity.
Note that unlike the state model used within the Note that unlike the state model used within the
Interfaces MIB [RFC2863], this object does not follow Interfaces MIB [RFC2863], this object does not follow
the administrative state. An administrative state of the administrative state. An administrative state of
down does not predict an operational state down does not predict an operational state
of disabled. of disabled.
A value of 'testing' means that entity currently being
tested and cannot there fore report whether it is
operational or not.
A value of 'disabled' means that an entity is totally A value of 'disabled' means that an entity is totally
inoperable and unable to provide service both to entities inoperable and unable to provide service both to entities
within its containment hierarchy, or to other receivers within its containment hierarchy, or to other receivers
of its service as defined in ways outside the scope of of its service as defined in ways outside the scope of
this MIB. this MIB.
A value of 'enabled' means that an entity is fully or A value of 'enabled' means that an entity is fully or
partially operable and able to provide service both to partially operable and able to provide service both to
entities within its containment hierarchy, or to other entities within its containment hierarchy, or to other
Entity State MIB September 2004
receivers of its service as defined in ways outside the receivers of its service as defined in ways outside the
scope of this MIB. scope of this MIB.
Note that some implementations may not be able to Note that some implementations may not be able to
accurately report entStateOper while the accurately report entStateOper while the
entStateAdmin object has a value other than 'unlocked'. entStateAdmin object has a value other than 'unlocked'.
In these cases, this object MUST have a value In these cases, this object MUST have a value
of 'unknown'." of 'unknown'."
::= { entStateEntry 3 } ::= { entStateEntry 3 }
skipping to change at page 13, line 53 skipping to change at page 14, line 6
entStateAlarm OBJECT-TYPE entStateAlarm OBJECT-TYPE
SYNTAX EntityAlarmStatus SYNTAX EntityAlarmStatus
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The alarm status for this entity. It does not include "The alarm status for this entity. It does not include
the alarms raised on child components within its the alarms raised on child components within its
containment hierarchy. containment hierarchy.
Note that this differs from 'indeterminate' which A value of 'unknown' means that this entity is
means that that alarm state is supported and there unable to report alarm state. Note that this differs
are alarms against this entity, but the severity of from 'indeterminate' which means that that alarm state
some of the alarms is not known. is supported and there are alarms against this entity,
but the severity of some of the alarms is not known
If no bits are set, then this entity supports reporting If no bits are set, then this entity supports reporting
Entity State MIB September 2004
of alarms, but there are currently no active alarms of alarms, but there are currently no active alarms
against this entity. against this entity.
" "
::= { entStateEntry 5 } ::= { entStateEntry 5 }
entStateStandby OBJECT-TYPE entStateStandby OBJECT-TYPE
SYNTAX EntityStandbyStatus SYNTAX EntityStandbyStatus
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
skipping to change at page 14, line 34 skipping to change at page 14, line 40
-- Notifications -- Notifications
entStateNotifications OBJECT IDENTIFIER ::= { entityStateMIB 0 } entStateNotifications OBJECT IDENTIFIER ::= { entityStateMIB 0 }
entStateOperEnabled NOTIFICATION-TYPE entStateOperEnabled NOTIFICATION-TYPE
OBJECTS { entStateAdmin, OBJECTS { entStateAdmin,
entStateAlarm entStateAlarm
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An entStateOperEnabled Notification signifies that the "An entStateOperEnabled notification signifies that the
SNMP entity, acting in an agent role, has detected that SNMP entity, acting in an agent role, has detected that
the entStateOper object for one of its entities has left the entStateOper object for one of its entities has
the 'disabled' state and transitioned into the 'enabled' transitioned into the 'enabled' state.
state.
The entity this notification refers can be identified by The entity this notification refers can be identified by
extracting the entPhysicalIndex from one of the extracting the entPhysicalIndex from one of the
variable bindings. The entStateAdmin and entStateAlarm variable bindings. The entStateAdmin and entStateAlarm
varbinds may be examined to find out additional varbinds may be examined to find out additional
information on the administrative state at the time of information on the administrative state at the time of
the operation state change as well to find out whether the operation state change as well to find out whether
there were any known alarms against the entity at that there were any known alarms against the entity at that
time that may explain why the physical entity has become time that may explain why the physical entity has become
operationally disabled." operationally disabled."
skipping to change at page 14, line 50 skipping to change at page 15, line 4
The entity this notification refers can be identified by The entity this notification refers can be identified by
extracting the entPhysicalIndex from one of the extracting the entPhysicalIndex from one of the
variable bindings. The entStateAdmin and entStateAlarm variable bindings. The entStateAdmin and entStateAlarm
varbinds may be examined to find out additional varbinds may be examined to find out additional
information on the administrative state at the time of information on the administrative state at the time of
the operation state change as well to find out whether the operation state change as well to find out whether
there were any known alarms against the entity at that there were any known alarms against the entity at that
time that may explain why the physical entity has become time that may explain why the physical entity has become
operationally disabled." operationally disabled."
::= { entStateNotifications 1 } ::= { entStateNotifications 1 }
entStateOperDisabled NOTIFICATION-TYPE entStateOperDisabled NOTIFICATION-TYPE
OBJECTS { entStateAdmin, OBJECTS { entStateAdmin,
entStateAlarm } entStateAlarm }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An entStateOperDisabled Notification signifies that the "An entStateOperDisabled notification signifies that the
SNMP entity, acting in an agent role, has detected that SNMP entity, acting in an agent role, has detected that
the entStateOper object for one of its entities has left the entStateOper object for one of its entities has
transitioned into the 'disabled' state.
Entity State MIB September 2004
the 'enabled' state and transitioned into the
'disabled' state.
The entity this notification refers can be identified by The entity this notification refers can be identified by
extracting the entPhysicalIndex from one of the extracting the entPhysicalIndex from one of the
variable bindings. The entStateAdmin and entStateAlarm variable bindings. The entStateAdmin and entStateAlarm
varbinds may be examined to find out additional varbinds may be examined to find out additional
information on the administrative state at the time of information on the administrative state at the time of
the operation state change as well to find out whether the operation state change as well to find out whether
there were any known alarms against the entity at that there were any known alarms against the entity at that
time that may have affect on the physical entity's time that may have affect on the physical entity's
ability to stay operationally enabled." ability to stay operationally enabled."
skipping to change at page 16, line 4 skipping to change at page 16, line 12
OBJECTS { OBJECTS {
entStateLastChanged, entStateLastChanged,
entStateAdmin, entStateAdmin,
entStateOper, entStateOper,
entStateUsage, entStateUsage,
entStateAlarm, entStateAlarm,
entStateStandby entStateStandby
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
Entity State MIB September 2004
"Standard Entity State group." "Standard Entity State group."
::= { entStateGroups 1} ::= { entStateGroups 1}
entStateNotificationsGroup NOTIFICATION-GROUP entStateNotificationsGroup NOTIFICATION-GROUP
NOTIFICATIONS { NOTIFICATIONS {
entStateOperEnabled, entStateOperEnabled,
entStateOperDisabled entStateOperDisabled
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
skipping to change at page 17, line 5 skipping to change at page 17, line 12
responsibility to ensure that the SNMP entity giving access to an responsibility to ensure that the SNMP entity giving access to an
instance of this MIB module is properly configured to give access to instance of this MIB module is properly configured to give access to
the objects only to those principals (entities) that have legitimate the objects only to those principals (entities) that have legitimate
rights to indeed GET or SET (change/create/delete) them. rights to indeed GET or SET (change/create/delete) them.
Note that setting the entStateAdmin to 'locked' or 'shuttingDown' Note that setting the entStateAdmin to 'locked' or 'shuttingDown'
can cause disruption of services ranging from those running on a can cause disruption of services ranging from those running on a
port to those on an entire device, depending on the type of entity. port to those on an entire device, depending on the type of entity.
Access to this object should be properly protected. Access to this object should be properly protected.
Entity State MIB September 2004
Access to the objects defined in this MIB allows one to figure out Access to the objects defined in this MIB allows one to figure out
what the active and standby resources in a network are. This what the active and standby resources in a network are. This
information can be used to optimize attacks on networks so even information can be used to optimize attacks on networks so even
read-only access to this MIB should be properly protected. read-only access to this MIB should be properly protected.
7. Intellectual Property 7. Intellectual Property
The IETF takes no position regarding the validity or scope of any The IETF takes no position regarding the validity or scope of any
intellectual property or other rights that might be claimed to intellectual property or other rights that might be claimed to
pertain to the implementation or use of the technology described in pertain to the implementation or use of the technology described in
skipping to change at page 18, line 5 skipping to change at page 18, line 11
USA USA
Phone: 408 394-8702 Phone: 408 394-8702
Email: dperkins@snmpinfo.com Email: dperkins@snmpinfo.com
9. Acknowledgments 9. Acknowledgments
This document is a product of the Entity MIB Working Group. This document is a product of the Entity MIB Working Group.
10. References 10. References
Entity State MIB September 2004
10.1 Normative 10.1 Normative
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997. Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., [RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
Rose, M. and S. Waldbusser, "Structure of Management Rose, M. and S. Waldbusser, "Structure of Management
Information Version 2 (SMIv2)", STD 58, RFC 2578, April Information Version 2 (SMIv2)", STD 58, RFC 2578, April
1999. 1999.
skipping to change at page 19, line 4 skipping to change at page 19, line 11
[X.731] ITU Recommendation X.731, "Information Technology - Open [X.731] ITU Recommendation X.731, "Information Technology - Open
Systems Interconnection - System Management: State Systems Interconnection - System Management: State
Management Function", 1992 Management Function", 1992
11. Full Copyright Statement 11. Full Copyright Statement
Copyright (C) The Internet Society (2004). This document is subject Copyright (C) The Internet Society (2004). This document is subject
to the rights, licenses and restrictions contained in BCP 78, and to the rights, licenses and restrictions contained in BCP 78, and
except as set forth therein, the authors retain all their rights." except as set forth therein, the authors retain all their rights."
Entity State MIB September 2004
"This document and the information contained herein are provided on "This document and the information contained herein are provided on
an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE
REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE
INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE." WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE."
 End of changes. 

This html diff was produced by rfcdiff 1.23, available from http://www.levkowetz.com/ietf/tools/rfcdiff/