Graham McIntire
b4f8b40b7f
- Remove PVC volume mount from k8s/deployment.yaml - Delete k8s/mib-pvc.yaml (no longer needed) - Update .gitignore to commit MIB files to git - Add mix import_mibs task to copy MIBs from LibreNMS - Add all MIB files from priv/mibs/ to git This fixes the multi-attach volume error in Kubernetes where new pods couldn't start because the RWO (ReadWriteOnce) PVC was attached to the old pod. MIBs are now part of the Docker image and can be used by all pods simultaneously.
458 lines
18 KiB
Text
458 lines
18 KiB
Text
ENTITY-STATE-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, mib-2
|
|
FROM SNMPv2-SMI
|
|
DateAndTime, TEXTUAL-CONVENTION
|
|
FROM SNMPv2-TC
|
|
MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
|
|
FROM SNMPv2-CONF
|
|
entPhysicalIndex
|
|
FROM ENTITY-MIB;
|
|
|
|
entityStateMIB MODULE-IDENTITY
|
|
LAST-UPDATED "200609060000Z"
|
|
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@nortel.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 at The Internet Society 2005. This version
|
|
of this MIB module is part of RFC 4268; see the RFC
|
|
itself for full legal notices."
|
|
REVISION "200609060000Z"
|
|
DESCRIPTION
|
|
"Initial version, published as RFC 4268."
|
|
::= { mib-2 131 }
|
|
|
|
|
|
-- Entity State Objects
|
|
|
|
entStateObjects OBJECT IDENTIFIER ::= { entityStateMIB 1 }
|
|
|
|
-- Textual Conventions
|
|
EntityAdminState ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
" Represents the various possible administrative states.
|
|
A value of 'locked' means the resource is administratively
|
|
prohibited from use. A value of 'shuttingDown' means that
|
|
usage is administratively limited to current instances of
|
|
use. A value of 'unlocked' means the resource is not
|
|
administratively prohibited from use. A value of
|
|
'unknown' means that this resource is unable to
|
|
report administrative state."
|
|
SYNTAX INTEGER
|
|
{
|
|
unknown (1),
|
|
locked (2),
|
|
shuttingDown (3),
|
|
unlocked (4)
|
|
}
|
|
|
|
EntityOperState ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
" Represents the possible values of operational states.
|
|
A value of 'disabled' means the resource is totally
|
|
inoperable. A value of 'enabled' means the resource
|
|
is partially or fully operable. A value of 'testing'
|
|
means the resource is currently being tested
|
|
and cannot therefore report whether it is operational
|
|
or not. A value of 'unknown' means that this
|
|
resource is unable to report operational state."
|
|
SYNTAX INTEGER
|
|
{
|
|
unknown (1),
|
|
disabled (2),
|
|
enabled (3),
|
|
testing (4)
|
|
}
|
|
|
|
EntityUsageState ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
" Represents the possible values of usage states.
|
|
A value of 'idle' means the resource is servicing no
|
|
users. A value of 'active' means the resource is
|
|
currently in use and it has sufficient spare capacity
|
|
to provide for additional users. A value of 'busy'
|
|
means the resource is currently in use, but it
|
|
currently has no spare capacity to provide for
|
|
additional users. A value of 'unknown' means
|
|
that this resource is unable to report usage state."
|
|
SYNTAX INTEGER
|
|
{
|
|
unknown (1),
|
|
idle (2),
|
|
active (3),
|
|
busy (4)
|
|
}
|
|
|
|
EntityAlarmStatus ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
" Represents the possible values of alarm status.
|
|
An Alarm [RFC 3877] is a persistent indication
|
|
of an error or warning condition.
|
|
|
|
When no bits of this attribute are set, then no active
|
|
alarms are known against this entity and it is not under
|
|
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
|
|
string not meaningful.
|
|
|
|
When the value of 'critical' is set, one or more critical
|
|
alarms are active against the resource. When the value
|
|
of 'major' is set, one or more major alarms are active
|
|
against the resource. When the value of 'minor' is set,
|
|
one or more minor alarms are active against the resource.
|
|
When the value of 'warning' is set, one or more warning
|
|
alarms are active against the resource. When the value
|
|
of 'indeterminate' is set, one or more alarms of whose
|
|
perceived severity cannot be determined are active
|
|
against this resource.
|
|
|
|
A value of 'unknown' means that this resource is
|
|
unable to report alarm state."
|
|
SYNTAX BITS
|
|
{
|
|
unknown (0),
|
|
underRepair (1),
|
|
critical(2),
|
|
major(3),
|
|
minor(4),
|
|
-- The following are not defined in X.733
|
|
warning (5),
|
|
indeterminate (6)
|
|
}
|
|
|
|
|
|
EntityStandbyStatus ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
" Represents the possible values of standby status.
|
|
|
|
A value of 'hotStandby' means the resource is not
|
|
providing service, but it will be immediately able to
|
|
take over the role of the resource to be backed up,
|
|
without the need for initialization activity, and will
|
|
contain the same information as the resource to be
|
|
backed up. A value of 'coldStandy' means that the
|
|
resource is to back up another resource, but will not
|
|
be immediately able to take over the role of a resource
|
|
to be backed up, and will require some initialization
|
|
activity. A value of 'providingService' means the
|
|
resource is providing service. A value of
|
|
'unknown' means that this resource is unable to
|
|
report standby state."
|
|
SYNTAX INTEGER
|
|
{
|
|
unknown (1),
|
|
hotStandby (2),
|
|
coldStandby (3),
|
|
providingService (4)
|
|
}
|
|
--entity State Table
|
|
|
|
entStateTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF EntStateEntry
|
|
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 [RFC 4133] that in this implementation
|
|
are able to report any of the state or status stored in
|
|
this table. "
|
|
|
|
::= { entStateObjects 1 }
|
|
|
|
|
|
entStateEntry OBJECT-TYPE
|
|
SYNTAX EntStateEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"State information about this physical entity."
|
|
INDEX { entPhysicalIndex }
|
|
::= { entStateTable 1 }
|
|
|
|
EntStateEntry ::= SEQUENCE {
|
|
entStateLastChanged DateAndTime,
|
|
entStateAdmin EntityAdminState,
|
|
entStateOper EntityOperState,
|
|
entStateUsage EntityUsageState,
|
|
entStateAlarm EntityAlarmStatus,
|
|
entStateStandby EntityStandbyStatus
|
|
}
|
|
|
|
entStateLastChanged 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 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 }
|
|
|
|
entStateAdmin 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 cannot 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."
|
|
::= { entStateEntry 2 }
|
|
|
|
entStateOper 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 [RFC 2863], 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 therefore 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 entStateOper while the
|
|
entStateAdmin object has a value other than 'unlocked'.
|
|
In these cases, this object MUST have a value
|
|
of 'unknown'."
|
|
::= { entStateEntry 3 }
|
|
|
|
entStateUsage 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'."
|
|
::= { entStateEntry 4 }
|
|
|
|
entStateAlarm 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 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."
|
|
::= { entStateEntry 5 }
|
|
|
|
entStateStandby 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'."
|
|
::= { entStateEntry 6 }
|
|
|
|
-- Notifications
|
|
entStateNotifications OBJECT IDENTIFIER ::= { entityStateMIB 0 }
|
|
|
|
entStateOperEnabled NOTIFICATION-TYPE
|
|
OBJECTS { entStateAdmin,
|
|
entStateAlarm
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entStateOperEnabled notification signifies that the
|
|
SNMP entity, acting in an agent role, has detected that
|
|
the entStateOper 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 entStateAdmin and entStateAlarm
|
|
varbinds may be examined to find out additional
|
|
information on the administrative state at the time of
|
|
the operation state change as well as 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
|
|
OBJECTS { entStateAdmin,
|
|
entStateAlarm }
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entStateOperDisabled notification signifies that the
|
|
SNMP entity, acting in an agent role, has detected that
|
|
the entStateOper 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 entStateAdmin and entStateAlarm
|
|
varbinds may be examined to find out additional
|
|
information on the administrative state at the time of
|
|
the operation state change as well as to find out whether
|
|
there were any known alarms against the entity at that
|
|
time that may affect the physical entity's
|
|
ability to stay operationally enabled."
|
|
::= { entStateNotifications 2 }
|
|
|
|
-- Conformance and Compliance
|
|
|
|
entStateConformance OBJECT IDENTIFIER ::= { entityStateMIB 2 }
|
|
|
|
entStateCompliances OBJECT IDENTIFIER
|
|
::= { entStateConformance 1 }
|
|
|
|
entStateCompliance MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The compliance statement for systems supporting
|
|
the Entity State MIB."
|
|
MODULE -- this module
|
|
MANDATORY-GROUPS {
|
|
entStateGroup
|
|
}
|
|
GROUP entStateNotificationsGroup
|
|
DESCRIPTION
|
|
"This group is optional."
|
|
OBJECT entStateAdmin
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"Write access is not required."
|
|
::= { entStateCompliances 1 }
|
|
|
|
entStateGroups OBJECT IDENTIFIER ::= { entStateConformance 2 }
|
|
|
|
|
|
|
|
entStateGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
entStateLastChanged,
|
|
entStateAdmin,
|
|
entStateOper,
|
|
entStateUsage,
|
|
entStateAlarm,
|
|
entStateStandby
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Standard Entity State group."
|
|
::= { entStateGroups 1}
|
|
|
|
entStateNotificationsGroup NOTIFICATION-GROUP
|
|
NOTIFICATIONS {
|
|
entStateOperEnabled,
|
|
entStateOperDisabled
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Standard Entity State Notification group."
|
|
::= { entStateGroups 2}
|
|
|
|
END
|