draft-ietf-entmib-state-02.txt   draft-ietf-entmib-state-03.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-02.txt D. Perkins Document: draft-ietf-entmib-state-03.txt D. Perkins
Category: Standards Track SNMPinfo Category: Standards Track SNMPinfo
Expiration Date: June 2004 December 2003 Expiration Date: August 2004 February 2004
Entity State MIB Entity State MIB
Status of this Memo Status of this Memo
This document is an Internet-Draft and is in full conformance This document is an Internet-Draft and is in full conformance
with all provisions of Section 10 of RFC2026. with all provisions of Section 10 of RFC2026.
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that Task Force (IETF), its areas, and its working groups. Note that
skipping to change at page 1, line 38 skipping to change at page 1, line 38
http://www.ietf.org/ietf/1id-abstracts.txt http://www.ietf.org/ietf/1id-abstracts.txt
The list of Internet-Draft Shadow Directories can be accessed at The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html. http://www.ietf.org/shadow.html.
Abstract Abstract
This memo defines a portion of the Management Information Base (MIB) This memo defines a portion of the Management Information Base (MIB)
for use with network management protocols in the Internet community. for use with network management protocols in the Internet community.
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 the entity. 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
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. Definitions 4. Definitions
5. Security Considerations 5. Security Considerations
6. Intellectual Property 6. Intellectual Property
7. Authors' Addresses 7. Authors' Addresses
8. Acknowledgements 8. Acknowledgements
9. References 9. References
10. Full Copyright Statement 10. Full Copyright Statement
1. 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
Structure of Management Information (SMI). This memo specifies a MIB Structure of Management Information (SMI). This memo specifies a MIB
skipping to change at page 4, line 13 skipping to change at page 4, line 13
hot standby, cold standby or is currently providing service. hot standby, cold standby or is currently providing service.
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. This raises Physical entities exist within a containment hierarchy. Physical
some interesting issues not addressed in existing work on state containment is defined by the entPhysicalContainedIn
management [X.731]. object[RFC2737]. This raises some interesting issues not addressed
in existing work on state management [X.731].
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 9 skipping to change at page 5, line 10
'shuttingDown', depending on a systems interpretation of 'down'. 'shuttingDown', depending on a systems interpretation of 'down'.
An ifOperStatus of 'up' is equivalent to an entStateOper value of An ifOperStatus of 'up' is equivalent to an entStateOper value of
'enabled'. An ifOperStatus of 'down' due to operational failure is 'enabled'. An ifOperStatus of 'down' due to operational failure is
equivalent to an entStateOper value of 'disabled'. An ifOperStatus equivalent to an entStateOper value of 'disabled'. An ifOperStatus
of 'down' due to being administratively disabled is equivalent to an of 'down' due to being administratively disabled is equivalent to an
entStateAdmin value of 'locked' and an entStateOper value of either entStateAdmin value of 'locked' and an entStateOper value of either
'enabled' or 'disabled' depending on whether there are any known 'enabled' or 'disabled' depending on whether there are any known
issues that would prevent the entity from becoming operational when issues that would prevent the entity from becoming operational when
its entStateAdmin is set to 'unlocked'. An ifOperStatus of its entStateAdmin is set to 'unlocked'. An ifOperStatus of
'unknown' is equivalent to an entStateOper value of 'notSupported'. 'unknown' is equivalent to an entStateOper value of 'unavailable'.
The ifOperStatus values of 'testing' and 'dormant' are not The ifOperStatus values of 'testing' and 'dormant' are not
explicitly supported by this MIB, but the state objects will be able explicitly supported by this MIB, but the state objects will be able
to reflect other aspects of the entities administrative and to reflect other aspects of the entities administrative and
operational state. The ifOperStatus values of 'notPresent' and operational state. The ifOperStatus values of 'notPresent' and
'lowerLayerDown' are in some ways computed states and so are 'lowerLayerDown' are in some ways computed states and so are
therefore not supported in this MIB. They can though be computed by therefore not supported in this MIB. They can though be computed by
examining the states of entities within this objects containment examining the states of entities within this objects containment
hierarchy and other available related states. hierarchy and other available 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.
Alternatively, if the alarmActiveTable is queried first and an
active alarm with a value of alarmActiveResourceId that matches this
entPhysicalIndex is found, then entStateAlarm can be used to quickly
determine if there are additional active alarms against this
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
'enabled' is equivalent to setting the entStateAdmin object to 'enabled' is equivalent to setting the entStateAdmin object to
'unlocked'. Setting dot1dStpPortEnable to 'disabled' is equivalent 'unlocked'. Setting dot1dStpPortEnable to 'disabled' is equivalent
to setting the entStateAdmin object to 'locked'. to setting the entStateAdmin object to 'locked'.
3.4 Relation to the Host Resources MIB 3.4 Relation to the Host Resources MIB
The hrDeviceStatus object in the Host Resources MIB [RFC2790] The hrDeviceStatus object in the Host Resources MIB [RFC2790]
provides an operational state for devices. For entities that provides an operational state for devices. For entities that
logically correspond to the concept of a device, a value of logically correspond to the concept of a device, a value of
'unknown' for hrDeviceStatus corresponds to an entStateOper value of 'unknown' for hrDeviceStatus corresponds to an entStateOper value of
'notSupported'. A value of 'running' corresponds to an entStateOper 'unavailable'. A value of 'running' corresponds to an entStateOper
value of 'enabled'. A value of 'warning' also corresponds to an value 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. Definitions 4. Definitions
ENTITY-STATE-MIB DEFINITIONS ::= BEGIN ENTITY-STATE-MIB DEFINITIONS ::= BEGIN
skipping to change at page 6, line 12 skipping to change at page 6, line 20
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 TEXTUAL-CONVENTION, DateAndTime
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;
entityStateMIB MODULE-IDENTITY entityStateMIB MODULE-IDENTITY
LAST-UPDATED "200312180000Z" LAST-UPDATED "200402150000Z"
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
Sharon Chisholm Sharon Chisholm
Nortel Networks Nortel Networks
skipping to change at page 6, line 38 skipping to change at page 6, line 46
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 extension to the Entity MIB. "This MIB defines a state extension to the Entity MIB.
Copyright (C) The Internet Society 2003. 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 "200312180000Z" REVISION "200402150000Z"
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
-- Textual conventions -- Textual conventions
AdminState ::= TEXTUAL-CONVENTION AdminState ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" Represents the various possible administrative states. " Represents the various possible administrative states.
A value of 'locked' means the resource is administratively A value of 'locked' means the resource is administratively
prohibited from use. A value of 'shuttingDown' means that prohibited from use. A value of 'shuttingDown' means that
usage is administratively limited to current instances of usage is administratively limited to current instances of
skipping to change at page 7, line 10 skipping to change at page 7, line 15
AdminState ::= TEXTUAL-CONVENTION AdminState ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" Represents the various possible administrative states. " Represents the various possible administrative states.
A value of 'locked' means the resource is administratively A value of 'locked' means the resource is administratively
prohibited from use. A value of 'shuttingDown' means that prohibited from use. A value of 'shuttingDown' means that
usage is administratively limited to current instances of usage is administratively limited to current instances of
use. A value of 'unlocked' means the resource is not use. A value of 'unlocked' means the resource is not
administratively prohibited from use." administratively prohibited from use. A value of
'unavailable' means that this resource is unable to
report administrative state."
REFERENCE REFERENCE
"ITU Recommendation X.731, 'Information Technology - Open "ITU Recommendation X.731, 'Information Technology - Open
Systems Interconnection - System Management: State Systems Interconnection - System Management: State
Management Function', 1992" Management Function', 1992"
SYNTAX INTEGER SYNTAX INTEGER
{ {
notSupported(1), unavailable(1),
locked(2), locked(2),
shuttingDown(3), shuttingDown(3),
unlocked(4) unlocked(4)
} }
OperState ::= TEXTUAL-CONVENTION OperState ::= TEXTUAL-CONVENTION
STATUS current STATUS current
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." is partially or fully operable. A value of 'testing'
means the resource is currently being tested
and cannot there fore report whether it is operational
or not. A value of 'unavailable' means that this
resource is unable to report operational state. "
REFERENCE REFERENCE
"ITU Recommendation X.731, 'Information Technology - Open "ITU Recommendation X.731, 'Information Technology - Open
Systems Interconnection - System Management: State Systems Interconnection - System Management: State
Management Function', 1992" Management Function', 1992"
SYNTAX INTEGER SYNTAX INTEGER
{ {
notSupported (1), unavailable (1),
disabled(2), disabled(2),
enabled(3) enabled(3),
testing (4)
} }
UsageState ::= TEXTUAL-CONVENTION UsageState ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" Represents the possible values of usage states. " Represents the possible values of usage states.
A value of 'idle' means the resource is servicing no A value of 'idle' means the resource is servicing no
users. A value of 'active' means the resource is users. A value of 'active' means the resource is
currently in use and it has sufficient spare capacity currently in use and it has sufficient spare capacity
to provide for additional users. A value of 'busy' to provide for additional users. A value of 'busy'
means the resource is currently in use, but it means the resource is currently in use, but it
currently has no spare capacity to provide for currently has no spare capacity to provide for
skipping to change at page 7, line 52 skipping to change at page 8, line 14
UsageState ::= TEXTUAL-CONVENTION UsageState ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" Represents the possible values of usage states. " Represents the possible values of usage states.
A value of 'idle' means the resource is servicing no A value of 'idle' means the resource is servicing no
users. A value of 'active' means the resource is users. A value of 'active' means the resource is
currently in use and it has sufficient spare capacity currently in use and it has sufficient spare capacity
to provide for additional users. A value of 'busy' to provide for additional users. A value of 'busy'
means the resource is currently in use, but it means the resource is currently in use, but it
currently has no spare capacity to provide for currently has no spare capacity to provide for
additional users." additional users. A value of 'unavailable' means
that this resource is unable to report usage state."
REFERENCE REFERENCE
"ITU Recommendation X.731, 'Information Technology - Open "ITU Recommendation X.731, 'Information Technology - Open
Systems Interconnection - System Management: State Systems Interconnection - System Management: State
Management Function', 1992" Management Function', 1992"
SYNTAX INTEGER SYNTAX INTEGER
{ {
notSupported (1), unavailable (1),
idle(2), idle(2),
active(3), active(3),
busy(4) busy(4)
} }
AlarmStatus ::= TEXTUAL-CONVENTION AlarmStatus ::= 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
of an error or warning condition.
When no bits of this attribute are set, then none of the When no bits of this attribute are set, then none
status conditions described below are present. When the of the value of under repair is set, the resource is
value of under repair is set, the resource is currently currently being repaired, which depending on the
being repaired. implementation, may make the other values in this bit
string unreliable.
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 of alarms are active against the resource. When the value
'major' is set, one or more major alarms are active against of 'major' is set, one or more major alarms are active
the resource. When the value of 'minor' is set, one or more against the resource. When the value of 'minor' is set,
minor alarms are active against the resource. When the one or more minor alarms are active against the resource.
value of 'warning' is set, one or more warning alarms are When the value of 'warning' is set, one or more warning
active against the resource. When the value of alarms are active against the resource. When the value
'indeterminate' is set, one or more alarms of of 'indeterminate' is set, one or more alarms whose of
indeterminate severity are active against the resource. perceived severity cannot be determined are active
against this resource.
When the value of 'alarmOutstanding' is set, one or more When the value of 'alarmOutstanding' is set, one or more
alarms is active against the resource. The fault may or may alarms is active against the resource. The fault may
not be disabling. " or may not be disabling. This bit provides a high-level
summary that can be used to determine whether or not
to examine the rest of the values. A value of
'unavailable' means that this resource is unable to
report alarm state."
REFERENCE REFERENCE
"ITU Recommendation X.731, 'Information Technology - Open "ITU Recommendation X.731, 'Information Technology - Open
Systems Interconnection - System Management: State Systems Interconnection - System Management: State
Management Function', 1992" Management Function', 1992"
SYNTAX BITS SYNTAX BITS
{ {
notSupported (0), unavailable (0),
underRepair(1), underRepair(1),
critical(2), critical(2),
major(3), major(3),
minor(4), minor(4),
alarmOutstanding(5), alarmOutstanding(5),
-- The following are not defined in X.733 -- The following are not defined in X.733
warning (6), warning (6),
indeterminate (7) indeterminate (7)
} }
StandbyStatus ::= TEXTUAL-CONVENTION StandbyStatus ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" Represents the possible values of standby status. " Represents the possible values of standby status.
A value of 'hotStandby' means the resource is not A value of 'hotStandby' means the resource is not
providing service, but is will be immediately able to providing service, but it will be immediately able to
take over the role of the resource to be backed-up, take over the role of the resource to be backed-up,
without the need for initialization activity, and will without the need for initialization activity, and will
contain the same information as the resource to be contain the same information as the resource to be
backed up. A value of 'coldStandy' means that the backed up. A value of 'coldStandy' means that the
resource is to back-up another resource, but will not resource is to back-up another resource, but will not
be immediately able to take over the role of a resource be immediately able to take over the role of a resource
to be backed up, and will require some initialization to be backed up, and will require some initialization
activity. A value of 'providingService' means the activity. A value of 'providingService' means the
resource is providing service." resource is providing service. A value of
'unavailable' means that this resource is unable to
report standby state."
REFERENCE REFERENCE
"ITU Recommendation X.731, 'Information Technology - Open "ITU Recommendation X.731, 'Information Technology - Open
Systems Interconnection - System Management: State Systems Interconnection - System Management: State
Management Function', 1992" Management Function', 1992"
SYNTAX INTEGER SYNTAX INTEGER
{ {
notSupported (1), unavailable (1),
hotStandby(2), hotStandby(2),
coldStandby(3), coldStandby(3),
providingService(4) providingService(4)
} }
-- Entity State Objects -- Entity State Objects
entStateObjects OBJECT IDENTIFIER ::= { entityStateMIB 1 } entStateObjects OBJECT IDENTIFIER ::= { entityStateMIB 1 }
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.
skipping to change at page 9, line 41 skipping to change at page 10, line 14
-- Entity State Objects -- Entity State Objects
entStateObjects OBJECT IDENTIFIER ::= { entityStateMIB 1 } entStateObjects OBJECT IDENTIFIER ::= { entityStateMIB 1 }
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. This is a sparse augment of the entPhysicalTable. Entries
appear in this table for values of
entPhysicalClass [RFC2737] that in this implementation
are able to report any of the state or status stored in
this table.
" "
::= { entStateObjects 1 } ::= { entStateObjects 1 }
entStateEntry OBJECT-TYPE entStateEntry OBJECT-TYPE
SYNTAX EntStateEntry SYNTAX EntStateEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION "State information about this entity." DESCRIPTION
"State information about this physical entity."
INDEX { entPhysicalIndex } INDEX { entPhysicalIndex }
::= { entStateTable 1 } ::= { entStateTable 1 }
EntStateEntry ::= SEQUENCE { EntStateEntry ::= SEQUENCE {
entStateLastChanged DateAndTime, entStateLastChanged DateAndTime,
entStateAdmin AdminState, entStateAdmin AdminState,
entStateOper OperState, entStateOper OperState,
entStateUsage UsageState, entStateUsage UsageState,
entStateAlarm AlarmStatus, entStateAlarm AlarmStatus,
entStateStandby StandbyStatus entStateStandby StandbyStatus
} }
entStateLastChanged OBJECT-TYPE entStateLastChanged OBJECT-TYPE
SYNTAX DateAndTime SYNTAX DateAndTime
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION "The value of this object is the date and DESCRIPTION
time when state/status of the entity "The value of this object is the date and
last changed, or zero." time when the value of any of entStateAdmin,
entStateOper, entStateUsage, entStateAlarm,
or entStateStandby changed for this entity.
If there has been no change since
the last re-initialization of the local system,
this object contains the date and time of
local system initialization. If there has been
no change since the entity was added to the
local system, this object contains the date and
time of the insertion"
::= { entStateEntry 1 } ::= { entStateEntry 1 }
entStateAdmin OBJECT-TYPE entStateAdmin OBJECT-TYPE
SYNTAX AdminState SYNTAX AdminState
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The administrative state for this entity. A value "The administrative state for this entity.
of 'notSupported' means that this entity is unable Setting this object to 'notSupported' will result
to report administrative state. This object can not in an 'inconsistentValue' error. For entities that
be administratively set to 'notSupported'. For do not support administrative state, all set
entities that do not support administrative state, operations will result in an 'inconsistentValue'
changing the value of this object to something other error
than 'notSupported' is not permitted. A value of
'inconsistentValue' will be returned in either case.
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."
::= { entStateEntry 2 } ::= { entStateEntry 2 }
entStateOper OBJECT-TYPE entStateOper OBJECT-TYPE
SYNTAX OperState SYNTAX OperState
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The operational state for this entity. A value "The operational state for this entity.
of 'notSupported' means that this entity is unable
to report operational state.
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 '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, as defined by having within its containment hierarchy, or to other receivers
a value of entPhysicalContainedIn that refers to this of its service as defined in ways outside the scope of
entity, or to other receivers of its service as defined this MIB.
in ways outside the scope of 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, as defined entities within its containment hierarchy, or to other
by having a value of entPhysicalContainedIn that receivers of its service as defined in ways outside the
refers to this entity, or to other receivers of its scope of this MIB.
service as defined in ways outside the scope of this
MIB." Note that some implementations may not be able to
accurately report entStateOper while the
entStateAdmin object has a value other than 'unlocked'.
In these cases, this object MUST have a value
of 'unavailable'."
::= { entStateEntry 3 } ::= { entStateEntry 3 }
entStateUsage OBJECT-TYPE entStateUsage OBJECT-TYPE
SYNTAX UsageState SYNTAX UsageState
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The usage state for this entity. A value of "The usage state for this entity.
'notSupported' means that this entity is unable to
report usage state.
Note that in the context of a physical entity, this Note that in the context of a physical entity, this
object refers to an entity's ability to service more object refers to an entity's ability to service more
physical entities in a containment hierarchy. A value physical entities in a containment hierarchy. A value
of 'idle' means this entity is able to contain other of 'idle' means this entity is able to contain other
entities but that no other entity is currently entities but that no other entity is currently
contained within this entity, as would have been contained within this entity.
demonstrated by a value of entPhysicalContainedIn
that referenced this entity.
A value of 'active' means that at least one entity is A value of 'active' means that at least one entity is
contained within this entity and therefore has a value contained within this entity, but that it could handle
of entPhysicalContainedIn that references this entity, more. A value of 'busy' means that the entity is unable
but that it could handle more. A value of 'busy' means to handle any additional entities being contained in it.
that the entity is unable to handle any additional
entities being contained in it, as demonstrated by
having a value of entPhysicalContainedIn that refers to
this entity.
Some entities will exhibit only a subset of the Some entities will exhibit only a subset of the
usage state values. Entities that are unable to ever usage state values. Entities that are unable to ever
service any entities within a containment hierarchy will service any entities within a containment hierarchy will
always have a usage state of 'busy'. Some entities will always have a usage state of 'busy'. Some entities will
only ever be able to support one entity within its only ever be able to support one entity within its
containment hierarchy and will therefore only exhibit containment hierarchy and will therefore only exhibit
values of 'idle' and 'busy'." values of 'idle' and 'busy'."
::= { entStateEntry 4 } ::= { entStateEntry 4 }
entStateAlarm OBJECT-TYPE entStateAlarm OBJECT-TYPE
SYNTAX AlarmStatus SYNTAX AlarmStatus
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, as defined by a value of containment hierarchy.
entPhysicalContainedIn that references this entity.
A value of 'notSupported' means that this entity is Note that this differs from 'indeterminate' which
unable to report alarm state. Note that this differs means that that alarm state is supported and there
from 'indeterminate' which means that that alarm state are alarms against this entity, but the severity of
is supported and there are alarms against this entity, some of the alarms is not known.
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
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 StandbyStatus SYNTAX StandbyStatus
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The standby status for this entity. A value of "The standby status for this entity.
'notSupported' means that this entity is unable to
report standby state.
Some entities will exhibit only a subset of the Some entities will exhibit only a subset of the
remaining standby state values. If this entity does remaining standby state values. If this entity
not have a standby, this object will always be cannot operate in a standby role, the value of this
'providingService'." object will always be 'providingService'."
::= { entStateEntry 6 } ::= { entStateEntry 6 }
-- Notifications -- Notifications
entStateNotifications OBJECT IDENTIFIER ::= { entityStateMIB 0 }
entStateTraps OBJECT IDENTIFIER ::= { entityStateMIB 2 }
entStateTrapPrefix OBJECT IDENTIFIER ::= { entStateTraps 0 }
entStateOperEnabled NOTIFICATION-TYPE entStateOperEnabled NOTIFICATION-TYPE
OBJECTS { entStateAdmin, OBJECTS { entStateAdmin,
entStateAlarm entStateAlarm
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An entStateOperEnabled trap signifies that the SNMP "An entStateOperEnabled Notification signifies that the
entity, acting in an agent role, has detected that the SNMP entity, acting in an agent role, has detected that
entStateOper object for one of its entities has left the entStateOper object for one of its entities has left
the 'disabled' state and transitioned into the 'enabled' the 'disabled' state and 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." variable bindings. The entStateAdmin and entStateAlarm
varbinds may be examined to find out additional
::= { entStateTrapPrefix 1 } information on the administrative state at the time of
the operation state change as well to find out whether
there were any known alarms against the entity at that
time that may explain why the physical entity has become
operationally disabled."
::= { entStateNotifications 1 }
entStateOperDisabled NOTIFICATION-TYPE entStateOperDisabled NOTIFICATION-TYPE
OBJECTS { entStateAdmin, OBJECTS { entStateAdmin,
entStateAlarm } entStateAlarm }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An entStateOperDisabled trap signifies that the SNMP "An entStateOperDisabled Notification signifies that the
entity, acting in an agent role, has detected that the SNMP entity, acting in an agent role, has detected that
entStateOper object for one of its entities has left the entStateOper object for one of its entities has left
the 'enabled' state and transitioned into the the 'enabled' state and transitioned into the
'disabled' state. '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." variable bindings. The entStateAdmin and entStateAlarm
::= { entStateTrapPrefix 2 } varbinds may be examined to find out additional
information on the administrative state at the time of
the operation state change as well to find out whether
there were any known alarms against the entity at that
time that may have affect on the physical entity's
ability to stay operationally enabled."
::= { entStateNotifications 2 }
-- Conformance and Compliance -- Conformance and Compliance
entStateConformance OBJECT IDENTIFIER ::= { entityStateMIB 3 } entStateConformance OBJECT IDENTIFIER ::= { entityStateMIB 3 }
entStateCompliances OBJECT IDENTIFIER entStateCompliances OBJECT IDENTIFIER
::= { entStateConformance 1 } ::= { entStateConformance 1 }
entStateCompliance MODULE-COMPLIANCE entStateCompliance MODULE-COMPLIANCE
STATUS current STATUS current
skipping to change at page 14, line 21 skipping to change at page 15, line 4
entStateAdmin, entStateAdmin,
entStateOper, entStateOper,
entStateUsage, entStateUsage,
entStateAlarm, entStateAlarm,
entStateStandby entStateStandby
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Standard Entity State group." "Standard Entity State group."
::= { entStateGroups 1} ::= { entStateGroups 1}
entStateNotificationsGroup NOTIFICATION-GROUP
entStateNotificationGroup NOTIFICATION-GROUP
NOTIFICATIONS { NOTIFICATIONS {
entStateOperEnabled, entStateOperEnabled,
entStateOperDisabled entStateOperDisabled
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Standard Entity State Notification group." "Standard Entity State Notification group."
::= { entStateGroups 2} ::= { entStateGroups 2}
END END
skipping to change at page 16, line 17 skipping to change at page 16, line 52
8. Acknowledgments 8. Acknowledgments
This document is a product of the Entity MIB Working Group. This document is a product of the Entity MIB Working Group.
9. References 9. References
9.1 Normative 9.1 Normative
[ALARM-MIB] Chisholm, S., Romascanu, D., "Alarm MIB", [ALARM-MIB] Chisholm, S., Romascanu, D., "Alarm MIB",
draft-ietf-disman-alarm-mib-16.txt, November 2003 draft-ietf-disman-alarm-mib-18.txt, February 2004
[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.
[RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., [RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
skipping to change at page 17, line 4 skipping to change at page 17, line 37
[RFC1493] Decker, E., Langille, P., Rijsinghani, A., McCloghrie, K., [RFC1493] Decker, E., Langille, P., Rijsinghani, A., McCloghrie, K.,
"Definitions of Managed Objects for Bridges", RFC 1493, "Definitions of Managed Objects for Bridges", RFC 1493,
July 1993 July 1993
[RFC2790] Waldbusser, S., Grillo, P., "Host Resources MIB", [RFC2790] Waldbusser, S., Grillo, P., "Host Resources MIB",
RFC 2790, March 2000 RFC 2790, March 2000
[RFC2863] McCloghrie, K., Kastenholz, F., "The Interfaces Group [RFC2863] McCloghrie, K., Kastenholz, F., "The Interfaces Group
MIB using SMIv2", RFC2863, June 2000 MIB using SMIv2", RFC2863, June 2000
[RFC3410] Case, J., Mundy, R., Partain, D. and B. Stewart, [RFC3410] Case, J., Mundy, R., Partain, D. and B. Stewart,
"Introduction and Applicability Statements for Internet- "Introduction and Applicability Statements for Internet-
Standard Management Framework", RFC 3410, December 2002. Standard Management Framework", RFC 3410, December 2002.
10. Full Copyright Statement 10. Full Copyright Statement
Copyright (C) The Internet Society (2003). All Rights Reserved. Copyright (C) The Internet Society (2004). All Rights Reserved.
This document and translations of it may be copied and furnished to This document and translations of it may be copied and furnished to
others, and derivative works that comment on or otherwise explain it others, and derivative works that comment on or otherwise explain it
or assist in its implementation may be prepared, copied, published or assist in its implementation may be prepared, copied, published
and distributed, in whole or in part, without restriction of any kind, and distributed, in whole or in part, without restriction of any kind,
provided that the above copyright notice and this paragraph are provided that the above copyright notice and this paragraph are
included on all such copies and derivative works. However, this included on all such copies and derivative works. However, this
document itself may not be modified in any way, such as by removing document itself may not be modified in any way, such as by removing
the copyright notice or references to the Internet Society or other the copyright notice or references to the Internet Society or other
Internet organizations, except as needed for the purpose of Internet organizations, except as needed for the purpose of
 End of changes. 

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