mibs/MIBS/cisco/CISCO-ENTITY-ASSET-MIB

527 lines
19 KiB
Plaintext
Raw Permalink Normal View History

2023-12-05 12:25:34 +01:00
-- *****************************************************************
-- Extension to the ENTITY-MIB supporting entity asset information.
--
-- November 1997, Cliff L. Sojourner
--
-- Copyright (c) 1996-1999, 2002, 2003 by cisco Systems, Inc.
-- All rights reserved.
-- *****************************************************************
--
CISCO-ENTITY-ASSET-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY,
OBJECT-TYPE FROM SNMPv2-SMI
MODULE-COMPLIANCE,
OBJECT-GROUP FROM SNMPv2-CONF
TruthValue FROM SNMPv2-TC
entPhysicalIndex FROM ENTITY-MIB
ciscoMgmt FROM CISCO-SMI
SnmpAdminString FROM SNMP-FRAMEWORK-MIB;
ciscoEntityAssetMIB MODULE-IDENTITY
LAST-UPDATED "200309180000Z"
ORGANIZATION "Cisco Systems, Inc."
CONTACT-INFO "Cisco Systems
Customer Service
Postal: Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
Tel: +1 408 526 4000
E-mail: cs-snmp@cisco.com"
DESCRIPTION
"Monitor the asset information of items in the ENTITY-MIB
(RFC 2037) entPhysical table."
REVISION "200309180000Z"
DESCRIPTION
"Some of the Objects have been deprecated since
these are available in ENTITY-MIB(RFC 2737).
1. Following Objects have been deprecated.
ceAssetOEMString : superceded by entPhysicalMfgName
ceAssetSerialNumber : superceded by entPhysicalSerialNum
ceAssetOrderablePartNumber: superceded by entPhysicalModelName
ceAssetHardwareRevision : superceded by entPhysicalHardwareRev
ceAssetFirmwareID : superceded by entPhysicalFirmwareRev
ceAssetFirmwareRevision : superceded by entPhysicalFirmwareRev
ceAssetSoftwareID : superceded by entPhysicalSoftwareRev
ceAssetSoftwareRevision : superceded by entPhysicalSoftwareRev
ceAssetAlias : superceded by entPhysicalAlias
ceAssetTag : superceded by entPhysicalAssetID
ceAssetIsFRU : superceded by entPhysicalIsFRU.
2. ceAssetEntityGroup has been deprecated."
REVISION "200207231600Z"
DESCRIPTION
"Split the MIB objects of this MIB into two object groups."
REVISION "199906021600Z"
DESCRIPTION
"Initial version of this MIB module."
::= { ciscoMgmt 92 }
-- MIB Object Definitions
ciscoEntityAssetMIBObjects OBJECT IDENTIFIER ::=
{ ciscoEntityAssetMIB 1 }
-- Physical Entity Asset Table
ceAssetTable OBJECT-TYPE
SYNTAX SEQUENCE OF CeAssetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table lists the orderable part number, serial number,
hardware revision, manufacturing assembly number and revision,
firmwareID and revision if any, and softwareID and revision if
any, of relevant entities listed in the ENTITY-MIB
entPhysicalTable.
Entities for which none of this data is available are not
listed in this table. This is a sparse table so some of these
variables may not exist for a particular entity at a particular
time. For example, a powered-off module does not have
softwareID and revision; a power-supply would probably never
have firmware or software information.
Although the data may have other items encoded in it (for
example manufacturing-date in the serial number) please treat
all data items as monolithic. Do not decompose them or parse
them. Use only string equals and unequals operations on them."
::= { ciscoEntityAssetMIBObjects 1 }
ceAssetEntry OBJECT-TYPE
SYNTAX CeAssetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entAssetEntry entry describes the asset-tracking related
data for an entity."
INDEX { entPhysicalIndex }
::= { ceAssetTable 1 }
CeAssetEntry ::= SEQUENCE {
ceAssetOEMString SnmpAdminString,
ceAssetSerialNumber SnmpAdminString,
ceAssetOrderablePartNumber SnmpAdminString,
ceAssetHardwareRevision SnmpAdminString,
ceAssetMfgAssyNumber SnmpAdminString,
ceAssetMfgAssyRevision SnmpAdminString,
ceAssetFirmwareID SnmpAdminString,
ceAssetFirmwareRevision SnmpAdminString,
ceAssetSoftwareID SnmpAdminString,
ceAssetSoftwareRevision SnmpAdminString,
ceAssetCLEI SnmpAdminString,
ceAssetAlias SnmpAdminString,
ceAssetTag SnmpAdminString,
ceAssetIsFRU TruthValue
}
ceAssetOEMString OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS deprecated
DESCRIPTION
"This variable indicates the Original Equipment Manufacturer
of the entity."
::= { ceAssetEntry 1 }
ceAssetSerialNumber OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS deprecated
DESCRIPTION
"This variable indicates the serial number of the entity."
::= { ceAssetEntry 2 }
ceAssetOrderablePartNumber OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS deprecated
DESCRIPTION
"This variable indicates the part number you can use to order
the entity."
::= { ceAssetEntry 3 }
ceAssetHardwareRevision OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS deprecated
DESCRIPTION
"This variable indicates the engineering design revision of the
hardware of the entity."
::= { ceAssetEntry 4 }
ceAssetMfgAssyNumber OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This variable indicates the manufacturing assembly number,
which is the 'hardware' identification."
::= { ceAssetEntry 5 }
ceAssetMfgAssyRevision OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This variable indicates the revision of the entity, within
the ceAssetMfgAssyNumber."
::= { ceAssetEntry 6 }
ceAssetFirmwareID OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS deprecated
DESCRIPTION
"This variable indicates the firmware installed on this entity.
For IOS devices, this variable's value is in the IOS Image
Naming Convention format.
IOS Image Naming Convention
Software images are named according to a scheme that identifies
what's in the image and what platform it runs on. The names have
three parts, separated by dashes: e.g. xxxx-yyyy-ww.
xxxx = Platform
yyyy = Features
ww = Where it executes from and if compressed
"
::= { ceAssetEntry 7 }
ceAssetFirmwareRevision OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS deprecated
DESCRIPTION
"This variable indicates the revision of firmware installed on this
entity.
For IOS devices, this variable's value is in the NGRP external
customer-visible format.
NGRP external customer-visible revision strings have this format:
'x.y (z [p] ) [A] [ [ u ( v [ p ] ) ] ] [ q ]',
where:
- x.y Combination of two 1-2 digit numerics separated by a
'.' that identify the Software major release
- z 1-3 digit numeric that identifies the maintenance release
of x.y
- A 1-3 alpha letters, designator of the release train.
- u 1-2 digit numeric that identifies the version of the
ED-specific code
- v 1-2 digit numeric that identifies the maintenance release of
the ED-specific code
- v 1-2 digit numeric that identifies the maintenance release of
the ED-specific code
- p 1 alpha letter that identifies the unusual special case SW
Line Stop Fast Re-build by the Release Ops team to replace
the posted/shipping release in CCO and Mfg with a version
containing a critical catastrophic defect fix that cannot
wait until the next maintenance release
- q 3 alphanumeric optional suffix used as an indicator in the
image banner by the SW Line Stop Re-build process used
unusual special case situation when the renumber build has
occurred but the images have not been released (value always
blank unless these special circumstances require
its use).
"
::= { ceAssetEntry 8 }
ceAssetSoftwareID OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS deprecated
DESCRIPTION
"This variable indicates the software installed on this entity.
For IOS devices, this variable's value is in the IOS Image Naming
Convention format.
IOS Image Naming Convention
---------------------------
Software images are named according to a scheme that identifies
what's in the image and what platform it runs on. The names have
three parts, separated by dashes: e.g. xxxx-yyyy-ww.
xxxx = Platform
yyyy = Features
ww = Where it executes from and if compressed
"
::= { ceAssetEntry 9 }
ceAssetSoftwareRevision OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS deprecated
DESCRIPTION
"This variable indicates the revision of software installed on this
entity.
For IOS devices, this variable's value is in the NGRP external
customer-visible format.
NGRP external customer-visible revision strings have this format:
'x.y (z [p] ) [A] [ [ u ( v [ p ] ) ] ] [ q ]',
where:
- x.y Combination of two 1-2 digit numerics separated by a
'.' that identify the Software major release
- z 1-3 digit numeric that identifies the maintenance release
of x.y
- A 1-3 alpha letters, designator of the release train.
- u 1-2 digit numeric that identifies the version of the
ED-specific code
- v 1-2 digit numeric that identifies the maintenance release of
the ED-specific code
- p 1 alpha letter that identifies the unusual special case SW
Line Stop Fast Re-build by the Release Ops team to replace
the posted/shipping release in CCO and Mfg with a version
containing a critical catastrophic defect fix that cannot
wait until the next maintenance release
- q 3 alphanumeric optional suffix used as an indicator in the
image banner by the SW Line Stop Re-build process used
unusual special case situation when the renumber build has
occurred but the images have not been released (value always
blank unless these special circumstances require
its use).
"
::= { ceAssetEntry 10 }
ceAssetCLEI OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0|10))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object represents the CLEI (Common Language Equipment
Identifier) code for the physical entity.
If the physical entity is not present in the system, or does
not have an associated CLEI code, then the value of this
object will be a zero-length string."
REFERENCE
"Bellcore Technical reference GR-485-CORE, COMMON LANGUAGE
Equipment Processes and Guidelines, Issue 2, October, 1995."
::= { ceAssetEntry 11 }
ceAssetAlias OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-write
STATUS deprecated
DESCRIPTION
"This object is an 'alias' name for the physical entity as
specified by a network manager, and provides a non-volatile
'handle' for the physical entity.
On the first instantiation of an physical entity, the value
of entPhysicalAlias associated with that entity is set to
the zero-length string. However, agent may set the value to
a locally unique default value, instead of a zero-length
string.
If write access is implemented for an instance of
entPhysicalAlias, and a value is written into the instance,
the agent must retain the supplied value in the
entPhysicalAlias instance associated with the same physical
entity for as long as that entity remains instantiated. This
includes instantiations across all re-initializations/reboots
of the network management system, including those which result
in a change of the physical entity's entPhysicalIndex value."
::= { ceAssetEntry 12 }
ceAssetTag OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-write
STATUS deprecated
DESCRIPTION
"This object is a user-assigned asset tracking identifier
for the physical entity as specified by a network manager,
and provides non-volatile storage of this information.
On the first instantiation of an physical entity, the value
of ceasAssetID associated with that entity is set to the
zero-length string.
Not every physical component will have a asset tracking
identifier, or even need one. Physical entities for which
the associated value of the ceAssetIsFRU object is equal to
'false' (e.g., the repeater ports within a repeater module),
do not need their own unique asset tracking identifier. An
agent does not have to provide write access for such
entities, and may instead return a zero-length string.
If write access is implemented for an instance of
ceasAssetID, and a value is written into the instance, the
agent must retain the supplied value in the ceasAssetID
instance associated with the same physical entity for as
long as that entity remains instantiated. This includes
instantiations across all re-initializations/reboots of
the network management system, including those which result
in a change of the physical entity's entPhysicalIndex value.
If no asset tracking information is associated with the
physical component, then this object will contain a zero-
length string."
::= { ceAssetEntry 13 }
ceAssetIsFRU OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS deprecated
DESCRIPTION
"This object indicates whether or not this physical entity
is considered a 'field replaceable unit' by the vendor. If
this object contains the value 'true' then the corresponding
entPhysicalEntry identifies a field replaceable unit. For
all entPhysicalEntries which represent components that are
permanently contained within a field replaceable unit, the
value 'false' should be returned for this object."
::= { ceAssetEntry 14 }
-- Notifications
ciscoEntityAssetMIBNotificationsPrefix OBJECT IDENTIFIER ::=
{ ciscoEntityAssetMIB 2 }
ciscoEntityAssetMIBNotifications OBJECT IDENTIFIER ::=
{ ciscoEntityAssetMIBNotificationsPrefix 0 }
-- Conformance
ciscoEntityAssetMIBConformance OBJECT IDENTIFIER ::=
{ ciscoEntityAssetMIB 3 }
ciscoEntityAssetMIBCompliances OBJECT IDENTIFIER ::=
{ ciscoEntityAssetMIBConformance 1 }
ciscoEntityAssetMIBGroups OBJECT IDENTIFIER ::=
{ ciscoEntityAssetMIBConformance 2 }
-- Compliance
ciscoEntityAssetMIBCompliance MODULE-COMPLIANCE
STATUS deprecated -- superceded by
-- ciscoEntityAssetMIBComplianceRev1
DESCRIPTION
"An ENTITY-MIB implementation that lists entities with asset
information in its entPhysicalTable must implement this group."
MODULE -- this module
MANDATORY-GROUPS {
ceAssetGroup
}
::= { ciscoEntityAssetMIBCompliances 1 }
ciscoEntityAssetMIBComplianceRev1 MODULE-COMPLIANCE
STATUS deprecated -- superceded by
-- ciscoEntityAssetMIBComplianceRev2
DESCRIPTION
"An ENTITY-MIB implementation that lists entities with asset
information in its entPhysicalTable must implement this group."
MODULE -- this module
MANDATORY-GROUPS {
ceAssetGroupRev1
}
GROUP ceAssetEntityGroup
DESCRIPTION
"This group is mandatory only for the systems that support
ENTITY-MIB Version 1 (rfc2037)."
::= { ciscoEntityAssetMIBCompliances 2 }
ciscoEntityAssetMIBComplianceRev2 MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"An ENTITY-MIB implementation that lists entities with asset
information in its entPhysicalTable must implement this group."
MODULE -- this module
MANDATORY-GROUPS {
ceAssetGroupRev2
}
::= { ciscoEntityAssetMIBCompliances 3 }
-- Units of Conformance
ceAssetGroup OBJECT-GROUP
OBJECTS {
ceAssetOEMString,
ceAssetSerialNumber,
ceAssetOrderablePartNumber,
ceAssetHardwareRevision,
ceAssetMfgAssyNumber,
ceAssetMfgAssyRevision,
ceAssetFirmwareID,
ceAssetFirmwareRevision,
ceAssetSoftwareID,
ceAssetSoftwareRevision,
ceAssetCLEI,
ceAssetAlias,
ceAssetTag,
ceAssetIsFRU
}
STATUS deprecated -- superceded by ceAssetGroupRev1
DESCRIPTION
"The collection of objects which are used to describe and
monitor asset-related data of ENTITY-MIB
entPhysicalTable items."
::= { ciscoEntityAssetMIBGroups 1 }
ceAssetGroupRev1 OBJECT-GROUP
OBJECTS {
ceAssetOEMString,
ceAssetMfgAssyNumber,
ceAssetMfgAssyRevision,
ceAssetFirmwareID,
ceAssetSoftwareID,
ceAssetCLEI
}
STATUS deprecated -- superceded by ceAssetGroupRev2
DESCRIPTION
"The collection of objects which are used to describe and
monitor asset-related extension data of ENTITY-MIB (RFC 2737)
entPhysicalTable items."
::= { ciscoEntityAssetMIBGroups 2 }
ceAssetEntityGroup OBJECT-GROUP
OBJECTS {
ceAssetOrderablePartNumber,
ceAssetSerialNumber,
ceAssetHardwareRevision,
ceAssetFirmwareRevision,
ceAssetSoftwareRevision,
ceAssetAlias,
ceAssetTag,
ceAssetIsFRU
}
STATUS deprecated
DESCRIPTION
"The collection of objects which are duplicated from the
objects in the entPhysicalTable of ENTITY-MIB (RFC 2737)."
::= { ciscoEntityAssetMIBGroups 3 }
ceAssetGroupRev2 OBJECT-GROUP
OBJECTS {
ceAssetMfgAssyNumber,
ceAssetMfgAssyRevision,
ceAssetCLEI
}
STATUS current
DESCRIPTION
"The collection of objects which are used to describe and
monitor asset-related extension data of ENTITY-MIB (RFC 2737)
entPhysicalTable items."
::= { ciscoEntityAssetMIBGroups 4 }
END