-- ***************************************************************** -- 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