343 lines
13 KiB
Plaintext
343 lines
13 KiB
Plaintext
CTRON-ENTITY-STATE-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, mib-2
|
|
FROM SNMPv2-SMI
|
|
DateAndTime
|
|
FROM SNMPv2-TC
|
|
MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
|
|
FROM SNMPv2-CONF
|
|
entPhysicalIndex
|
|
FROM ENTITY-MIB
|
|
EntityAdminState, EntityOperState, EntityUsageState,
|
|
EntityAlarmStatus, EntityStandbyStatus
|
|
FROM CTRON-ENTITY-STATE-TC-MIB
|
|
-- Place this MIB on CTRON experimental branch until it is an RFC.
|
|
ctEntityStateMib
|
|
FROM CTRON-MIB-NAMES;
|
|
|
|
ctEntityStateMIB MODULE-IDENTITY
|
|
LAST-UPDATED "200501230000Z"
|
|
ORGANIZATION "IETF Entity MIB Working Group"
|
|
CONTACT-INFO
|
|
" General Discussion: entmib@ietf.org
|
|
To Subscribe:
|
|
http://www.ietf.org/mailman/listinfo/entmib
|
|
|
|
http://www.ietf.org/html.charters/entmib-charter.html
|
|
|
|
Sharon Chisholm
|
|
Nortel Networks
|
|
PO Box 3511 Station C
|
|
Ottawa, Ont. K1Y 4H7
|
|
Canada
|
|
schishol@nortelnetworks.com
|
|
|
|
David T. Perkins
|
|
548 Qualbrook Ct
|
|
San Jose, CA 95110
|
|
USA
|
|
Phone: 408 394-8702
|
|
dperkins@snmpinfo.com
|
|
"
|
|
DESCRIPTION
|
|
"This MIB defines a state extension to the Entity MIB.
|
|
|
|
Copyright (C) The Internet Society 2005. This version
|
|
of this MIB module is part of RFC yyyy; see the RFC
|
|
itself for full legal notices."
|
|
-- RFC Ed.: replace yyyy with actual RFC number & remove
|
|
-- this note
|
|
REVISION "200501230000Z"
|
|
DESCRIPTION
|
|
"Initial version, published as RFC YYYY."
|
|
-- RFC-Editor assigns yyyy
|
|
-- ::= { mib-2 XX } to be assigned by IANA
|
|
::= { ctEntityStateMib 1 }
|
|
|
|
|
|
|
|
|
|
-- Entity State Objects
|
|
|
|
ctEntStateObjects OBJECT IDENTIFIER ::= { ctEntityStateMIB 1 }
|
|
|
|
ctEntStateTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CtEntStateEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A table of information about state/status of entities.
|
|
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.
|
|
"
|
|
::= { ctEntStateObjects 1 }
|
|
|
|
|
|
ctEntStateEntry OBJECT-TYPE
|
|
SYNTAX CtEntStateEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"State information about this physical entity."
|
|
INDEX { entPhysicalIndex }
|
|
::= { ctEntStateTable 1 }
|
|
|
|
CtEntStateEntry ::= SEQUENCE {
|
|
ctEntStateLastChanged DateAndTime,
|
|
ctEntStateAdmin EntityAdminState,
|
|
ctEntStateOper EntityOperState,
|
|
ctEntStateUsage EntityUsageState,
|
|
ctEntStateAlarm EntityAlarmStatus,
|
|
ctEntStateStandby EntityStandbyStatus
|
|
}
|
|
|
|
ctEntStateLastChanged OBJECT-TYPE
|
|
SYNTAX DateAndTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object is the date and
|
|
time when the value of any of ctEntStateAdmin,
|
|
ctEntStateOper, ctEntStateUsage, ctEntStateAlarm,
|
|
or ctEntStateStandby 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."
|
|
::= { ctEntStateEntry 1 }
|
|
|
|
ctEntStateAdmin OBJECT-TYPE
|
|
SYNTAX EntityAdminState
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The administrative state for this entity.
|
|
|
|
This object refers to an entities administrative
|
|
permission to service both other entities within
|
|
its containment hierarchy as well other users of
|
|
its services defined by means outside the scope
|
|
of this MIB.
|
|
|
|
Setting this object to 'notSupported' will result
|
|
in an 'inconsistentValue' error. For entities that
|
|
do not support administrative state, all set
|
|
operations will result in an 'inconsistentValue'
|
|
error.
|
|
|
|
Some physical entities exhibit only a subset of the
|
|
remaining administrative state values. Some entities
|
|
cannot be locked, and hence this object exhibits only
|
|
the 'unlocked' state. Other entities can not be shutdown
|
|
gracefully, and hence this object does not exhibit the
|
|
'shuttingDown' state. A value of 'inconsistentValue'
|
|
will be returned if attempts are made to set this
|
|
object to values not supported by its administrative
|
|
model."
|
|
::= { ctEntStateEntry 2 }
|
|
|
|
ctEntStateOper OBJECT-TYPE
|
|
SYNTAX EntityOperState
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The operational state for this entity.
|
|
|
|
Note that unlike the state model used within the
|
|
Interfaces MIB [RFC2863], this object does not follow
|
|
the administrative state. An administrative state of
|
|
down does not predict an operational state
|
|
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
|
|
inoperable and unable to provide service both to entities
|
|
within its containment hierarchy, or to other receivers
|
|
of its service as defined in ways outside the scope of
|
|
this MIB.
|
|
|
|
A value of 'enabled' means that an entity is fully or
|
|
partially operable and able to provide service both to
|
|
entities within its containment hierarchy, or to other
|
|
receivers of its service as defined in ways outside the
|
|
scope of this MIB.
|
|
|
|
Note that some implementations may not be able to
|
|
accurately report ctEntStateOper while the
|
|
ctEntStateAdmin object has a value other than 'unlocked'.
|
|
In these cases, this object MUST have a value
|
|
of 'unknown'."
|
|
::= { ctEntStateEntry 3 }
|
|
|
|
ctEntStateUsage OBJECT-TYPE
|
|
SYNTAX EntityUsageState
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The usage state for this entity.
|
|
|
|
This object refers to an entity's ability to service more
|
|
physical entities in a containment hierarchy. A value
|
|
of 'idle' means this entity is able to contain other
|
|
entities but that no other entity is currently
|
|
contained within this entity.
|
|
|
|
A value of 'active' means that at least one entity is
|
|
contained within this entity, but that it could handle
|
|
more. A value of 'busy' means that the entity is unable
|
|
to handle any additional entities being contained in it.
|
|
|
|
Some entities will exhibit only a subset of the
|
|
usage state values. Entities that are unable to ever
|
|
service any entities within a containment hierarchy will
|
|
always have a usage state of 'busy'. Some entities will
|
|
only ever be able to support one entity within its
|
|
containment hierarchy and will therefore only exhibit
|
|
values of 'idle' and 'busy'."
|
|
::= { ctEntStateEntry 4 }
|
|
|
|
ctEntStateAlarm OBJECT-TYPE
|
|
SYNTAX EntityAlarmStatus
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The alarm status for this entity. It does not include
|
|
the alarms raised on child components within its
|
|
containment hierarchy.
|
|
|
|
A value of 'unknown' means that this entity is
|
|
unable to report alarm state. Note that this differs
|
|
from 'indeterminate' which means that that alarm state
|
|
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
|
|
of alarms, but there are currently no active alarms
|
|
against this entity.
|
|
"
|
|
::= { ctEntStateEntry 5 }
|
|
|
|
ctEntStateStandby OBJECT-TYPE
|
|
SYNTAX EntityStandbyStatus
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The standby status for this entity.
|
|
|
|
Some entities will exhibit only a subset of the
|
|
remaining standby state values. If this entity
|
|
cannot operate in a standby role, the value of this
|
|
object will always be 'providingService'."
|
|
::= { ctEntStateEntry 6 }
|
|
|
|
-- Notifications
|
|
ctEntStateNotifications OBJECT IDENTIFIER ::= { ctEntityStateMIB 0 }
|
|
|
|
ctEntStateOperEnabled NOTIFICATION-TYPE
|
|
OBJECTS { ctEntStateAdmin,
|
|
ctEntStateAlarm
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An ctEntStateOperEnabled notification signifies that the
|
|
SNMP entity, acting in an agent role, has detected that
|
|
the ctEntStateOper object for one of its entities has
|
|
transitioned into the 'enabled' state.
|
|
|
|
|
|
The entity this notification refers can be identified by
|
|
extracting the entPhysicalIndex from one of the
|
|
variable bindings. The ctEntStateAdmin and ctEntStateAlarm
|
|
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 explain why the physical entity has become
|
|
operationally disabled."
|
|
::= { ctEntStateNotifications 1 }
|
|
|
|
ctEntStateOperDisabled NOTIFICATION-TYPE
|
|
OBJECTS { ctEntStateAdmin,
|
|
ctEntStateAlarm }
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An ctEntStateOperDisabled notification signifies that the
|
|
SNMP entity, acting in an agent role, has detected that
|
|
the ctEntStateOper object for one of its entities has
|
|
transitioned into the 'disabled' state.
|
|
|
|
The entity this notification refers can be identified by
|
|
extracting the entPhysicalIndex from one of the
|
|
variable bindings. The ctEntStateAdmin and ctEntStateAlarm
|
|
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."
|
|
::= { ctEntStateNotifications 2 }
|
|
|
|
-- Conformance and Compliance
|
|
|
|
ctEntStateConformance OBJECT IDENTIFIER ::= { ctEntityStateMIB 2 }
|
|
|
|
ctEntStateCompliances OBJECT IDENTIFIER
|
|
::= { ctEntStateConformance 1 }
|
|
|
|
ctEntStateCompliance MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The compliance statement for systems supporting
|
|
the Entity State MIB."
|
|
MODULE -- this module
|
|
MANDATORY-GROUPS {
|
|
ctEntStateGroup
|
|
}
|
|
GROUP ctEntStateNotificationsGroup
|
|
DESCRIPTION
|
|
"This group is optional."
|
|
OBJECT ctEntStateAdmin
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"Write access is not required."
|
|
::= { ctEntStateCompliances 1 }
|
|
|
|
ctEntStateGroups OBJECT IDENTIFIER ::= { ctEntStateConformance 2 }
|
|
|
|
ctEntStateGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
ctEntStateLastChanged,
|
|
ctEntStateAdmin,
|
|
ctEntStateOper,
|
|
ctEntStateUsage,
|
|
ctEntStateAlarm,
|
|
ctEntStateStandby
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Standard Entity State group."
|
|
::= { ctEntStateGroups 1}
|
|
|
|
ctEntStateNotificationsGroup NOTIFICATION-GROUP
|
|
NOTIFICATIONS {
|
|
ctEntStateOperEnabled,
|
|
ctEntStateOperDisabled
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Standard Entity State Notification group."
|
|
::= { ctEntStateGroups 2}
|
|
|
|
END
|