mirror of
https://github.com/hsnodgrass/snmp_mib_archive.git
synced 2025-04-17 16:03:04 +00:00
459 lines
15 KiB
Plaintext
459 lines
15 KiB
Plaintext
-- *****************************************************************
|
|
-- CISCO-IMAGE-CHECK-MIB.my: Cisco Image Check MIB file
|
|
--
|
|
-- May 2003, Charuhas Ghatge
|
|
--
|
|
-- Copyright (c) 2003 by cisco Systems, Inc.
|
|
-- All rights reserved.
|
|
-- *****************************************************************
|
|
|
|
CISCO-IMAGE-CHECK-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY,
|
|
OBJECT-TYPE,
|
|
Integer32
|
|
FROM SNMPv2-SMI
|
|
SnmpAdminString
|
|
FROM SNMP-FRAMEWORK-MIB
|
|
RowStatus
|
|
FROM SNMPv2-TC
|
|
MODULE-COMPLIANCE,
|
|
OBJECT-GROUP
|
|
FROM SNMPv2-CONF
|
|
ciscoMgmt
|
|
FROM CISCO-SMI;
|
|
|
|
ciscoImageCheckMIB MODULE-IDENTITY
|
|
LAST-UPDATED "200305150000Z"
|
|
ORGANIZATION "Cisco Systems, Inc."
|
|
CONTACT-INFO
|
|
" Cisco Systems
|
|
Customer Service
|
|
|
|
Postal: 170 W. Tasman Drive
|
|
San Jose, CA 95134
|
|
USA
|
|
|
|
Tel: +1 800 553-NETS
|
|
|
|
E-mail: cs-snmp@cisco.com"
|
|
DESCRIPTION
|
|
"Initial version of Image Check MIB."
|
|
::= { ciscoMgmt 99990 }
|
|
|
|
|
|
ciscoImageCheckMIBObjects OBJECT IDENTIFIER
|
|
::= { ciscoImageCheckMIB 1 }
|
|
|
|
ciscoImageCheck OBJECT IDENTIFIER
|
|
::= { ciscoImageCheckMIBObjects 1 }
|
|
|
|
--
|
|
-- When a switch runs different versions of software on the active
|
|
-- and the standby supervisor, the behaviour of the two versions
|
|
-- of the software can be different.
|
|
-- The objective of this MIB is to perform a HA compatibility check
|
|
-- of the two versions of the software and list the incompatibilities
|
|
--
|
|
-- To achieve this goal, there are 2 tables defined in this MIB.
|
|
--
|
|
-- ciscoImageCheckOpTable, is an 'operations' table, in that this
|
|
-- table is used to invoke a command to perform a check on the
|
|
-- images.
|
|
--
|
|
-- ciscoImgChkResultsTable, is a read-only table where the results of
|
|
-- previous operation are read. It is this table that lists the
|
|
-- incompatibilities.
|
|
--
|
|
-- Terminology -
|
|
--
|
|
-- HA - High Availability
|
|
--
|
|
-- Feature - A software service like zoning, routing etc.
|
|
--
|
|
-- Capability - A configuration attribute mapping to some
|
|
-- hardware-dependent configuration. A
|
|
-- capability is described by this infrastructure if
|
|
-- it can be programmed in one version of the software
|
|
-- but it can't be programmed in some earlier version.
|
|
--
|
|
-- Strict and Loose incompatibility - An incompatibility exists
|
|
-- between the configuration of the software running
|
|
-- on the active supervisor and the configuration
|
|
-- supported by the standby supervisor when a specific
|
|
-- capability is enabled, but software on the standby
|
|
-- supervisor does not support it. The incompatibility
|
|
-- is said to be 'Strict', when a switchover to the
|
|
-- older version software release would cause some
|
|
-- unpredictable behaviour as long as the capability
|
|
-- is enabled. The incompatibility is said to be
|
|
-- 'Loose' when a switchover to the older release
|
|
-- would not cause an unpredictable behaviour or
|
|
-- instability in the system.
|
|
--
|
|
--
|
|
|
|
|
|
|
|
ciscoImageCheckOpTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CiscoImageCheckOpEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A table of Image check operation entries. Each
|
|
entry represents an Image check operation that
|
|
has been initiated.
|
|
"
|
|
::= { ciscoImageCheck 1 }
|
|
|
|
ciscoImageCheckOpEntry OBJECT-TYPE
|
|
SYNTAX CiscoImageCheckOpEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An Image check operation entry. Each entry consists
|
|
of an image name, current status of the check
|
|
operation and a row status.
|
|
|
|
A management station wishing to create an entry should
|
|
first generate a pseudo-random serial number to be used
|
|
as the index to this sparse table. The station should
|
|
then create the associated instance of the row status
|
|
object. It must also, create the associated instance
|
|
of the image name. This image is checked for
|
|
compatibility with the image already running on the
|
|
active supervisor.
|
|
|
|
Once the appropriate instances of all the mandatory
|
|
objects have been created, either by an explicit SNMP
|
|
set request or by default, the row status should be set
|
|
to active to initiate the operation. Note that this entire
|
|
procedure may be initiated via a single set request which
|
|
specifies a row status of createAndGo.
|
|
|
|
Once an operation has been activated, it cannot be
|
|
stopped.
|
|
|
|
Once the operation completes, the management station should
|
|
retrieve the value of the status object and delete the
|
|
entry. In order to prevent old entries from clogging the
|
|
table, entries will be aged out, but an entry will never
|
|
be deleted within 5 minutes of completing.
|
|
"
|
|
|
|
INDEX { ciscoImageCheckSerialNum }
|
|
::= { ciscoImageCheckOpTable 1 }
|
|
|
|
|
|
CiscoImageCheckOpEntry ::=
|
|
SEQUENCE {
|
|
ciscoImageCheckSerialNum Integer32,
|
|
ciscoImageCheckImageName SnmpAdminString,
|
|
ciscoImageCheckStatus INTEGER,
|
|
ciscoImageCheckEntryStatus RowStatus
|
|
}
|
|
|
|
ciscoImageCheckSerialNum OBJECT-TYPE
|
|
SYNTAX Integer32 (1..2147483647)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Object which specifies a unique entry in the
|
|
table. A management station wishing to initiate a
|
|
check operation should use a pseudo-random value for
|
|
this object when creating or modifying an instance of
|
|
a ciscoImageCheckOpEntry.
|
|
"
|
|
::= { ciscoImageCheckOpEntry 1 }
|
|
|
|
|
|
ciscoImageCheckImageName OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE (1..255))
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Image file name that needs the verification.
|
|
|
|
If the Image name is NULL then it is assumed that
|
|
the image check is to be done with the image on
|
|
standby supervisor.
|
|
"
|
|
::= { ciscoImageCheckOpEntry 2 }
|
|
|
|
|
|
ciscoImageCheckStatus OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
none(1),
|
|
inProgress(2),
|
|
inCompatLoose(3),
|
|
inCompatStrict(4),
|
|
compatible(5),
|
|
noStandby(6),
|
|
pssErr(7),
|
|
extractFail(8),
|
|
fileParseErr(9),
|
|
getIncompatErr(10)
|
|
}
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The current status of the image check operation.
|
|
|
|
If the status is inCompatLoose(3) or
|
|
inCompatStrict(4), one can look at the detail
|
|
reasons of incompatibilities by looking at
|
|
ciscoImgChkResultsTable described below.
|
|
|
|
If the status is compatible, then there is no
|
|
need to look at the ciscoImgChkResultsTable.
|
|
|
|
If the status is noStandby(6), pssErr(7),
|
|
extractFail(8), fileParseErr(9) or
|
|
getIncompatErr(10), there is some internal error
|
|
in even starting the check compatibility process,
|
|
and hence the ciscoImgChkResultsTable should not
|
|
be read for any details.
|
|
|
|
inProgress(2) - Image check is in progress
|
|
inCompatLoose(3) - Loose incompatibility
|
|
inCompatStrict(4) - Strict incompatibility
|
|
compatible(5) - images are compatible
|
|
noStandby(6) - standby supervisor is absent
|
|
pssErr(7) - internal error
|
|
extractFail(8) - Could not extract image
|
|
fileParseErr(9) - Could not parse image
|
|
getIncompatErr(10) - internal error in determining
|
|
incompatibilities.
|
|
|
|
"
|
|
::= { ciscoImageCheckOpEntry 3 }
|
|
|
|
|
|
ciscoImageCheckEntryStatus OBJECT-TYPE
|
|
SYNTAX RowStatus
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The status of this table entry."
|
|
::= { ciscoImageCheckOpEntry 4 }
|
|
|
|
|
|
-- Image Check results Table
|
|
|
|
|
|
ciscoImgChkResultsTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CiscoImgChkResultsEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table lists the features and capabilities
|
|
that are incompatible for the request that was
|
|
made corresponding to the instance of
|
|
ciscoImgChkFeatureIndex in the ciscoImageCheckOpTable."
|
|
::= { ciscoImageCheck 2 }
|
|
|
|
|
|
ciscoImgChkResultsEntry OBJECT-TYPE
|
|
SYNTAX CiscoImgChkResultsEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entry of ciscoImgChkResultsTable. "
|
|
INDEX {
|
|
ciscoImageCheckSerialNum,
|
|
ciscoImgChkFeatureIndex,
|
|
ciscoImgChkCapabIndex
|
|
}
|
|
::= { ciscoImgChkResultsTable 1 }
|
|
|
|
|
|
CiscoImgChkResultsEntry ::=
|
|
SEQUENCE {
|
|
ciscoImgChkFeatureIndex Integer32,
|
|
ciscoImgChkCapabIndex Integer32,
|
|
ciscoImgChkFeatureName SnmpAdminString,
|
|
ciscoImgChkCapabilityName SnmpAdminString,
|
|
ciscoImgChkCapabilityReq INTEGER,
|
|
ciscoImgChkInCompDescr SnmpAdminString
|
|
}
|
|
|
|
ciscoImgChkFeatureIndex OBJECT-TYPE
|
|
SYNTAX Integer32 (1..65535)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The index of the incompatible feature."
|
|
::= { ciscoImgChkResultsEntry 1 }
|
|
|
|
|
|
ciscoImgChkCapabIndex OBJECT-TYPE
|
|
SYNTAX Integer32 (1..65535)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The index of the incompatible capability."
|
|
::= { ciscoImgChkResultsEntry 2 }
|
|
|
|
|
|
ciscoImgChkFeatureName OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE (1..32))
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The name of the incompatible feature.
|
|
The list of features is subject to
|
|
implementation in a given software
|
|
release. The current list of features is
|
|
as follows -
|
|
|
|
fspf - FSPF Routing Protocol Application
|
|
fcmpls - Multi-Protocol Label Switching
|
|
fib - FIB Manager
|
|
flogi - F Port Server
|
|
rscn - RSCN Module
|
|
fcns - Name Server
|
|
fcdomain - Domain Manager
|
|
fc-tunnel - FC MPLS tunnel
|
|
ipfc - Ipfc Manager
|
|
ipconf - IP Configuration Manager
|
|
ips - IPS Manager
|
|
port - Port Manager
|
|
port-channel - Port Channel Manager
|
|
span - Switch Port Analyzer
|
|
sysmgr-ver - System Manager version controller
|
|
vrrp-cfg - VRRP Configuration
|
|
vsan - VSAN manager
|
|
zone - Zone Server
|
|
|
|
"
|
|
::= { ciscoImgChkResultsEntry 3 }
|
|
|
|
|
|
ciscoImgChkCapabilityName OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE (1..64))
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The name of the incompatible capability.
|
|
|
|
The list of capabilities is subject to
|
|
implementation in a given software
|
|
release. The current list of capabilities
|
|
is as follows -
|
|
|
|
CAP_FEATURE_SPAN_FCFWD_STBY_POP_ENABLED
|
|
CAP_FEATURE_SPAN_IF_VSAN_SRC_MIX_NOT_ALLOWED
|
|
CAP_FEATURE_SPAN_IF_SRC_VSAN_FILTER_NOT_ALLOWED
|
|
CAP_FEATURE_SPAN_FC_TUNNEL_CFG
|
|
CAP_FEATURE_SPAN_ST_PORT_CFG
|
|
CAP_FEATURE_SPAN_FCIP_SRC_CFG
|
|
CAP_FEATURE_SPAN_ISCSI_SRC_CFG
|
|
CAP_FEATURE_ZS_READ_ONLY_ZONING
|
|
CAP_FEATURE_ZS_LUN_ZONING
|
|
CAP_FEATURE_PORT_MODE_ST_CFG
|
|
CAP_FEATURE_FC_TUNNEL_CFG
|
|
CAP_FEATURE_PORT_PERFORMANCE_BUF
|
|
"
|
|
::= { ciscoImgChkResultsEntry 4 }
|
|
|
|
|
|
ciscoImgChkCapabilityReq OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
strict(1),
|
|
loose(2)
|
|
}
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Whether capability check is strict or loose. "
|
|
::= { ciscoImgChkResultsEntry 5 }
|
|
|
|
|
|
ciscoImgChkInCompDescr OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE (1..255))
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Description of the incompatibilty.
|
|
|
|
For example, if the name of the
|
|
incompatibilty (the instance of
|
|
ciscoImgChkCapabilityName) is
|
|
CAP_FEATURE_ZS_READ_ONLY_ZONING, then the
|
|
description will be -
|
|
|
|
'Zone Server - Read-only zoning configured'.
|
|
|
|
For each incompatibility name that appears in
|
|
ciscoImgChkCapabilityName, there will be a
|
|
corresponding description described by the
|
|
instance of this object.
|
|
"
|
|
::= { ciscoImgChkResultsEntry 6 }
|
|
|
|
|
|
|
|
-- Conformance information
|
|
|
|
ciscoImageCheckMIBConformance
|
|
OBJECT IDENTIFIER ::= { ciscoImageCheckMIB 2 }
|
|
|
|
ciscoImageCheckMIBCompliances
|
|
OBJECT IDENTIFIER ::= { ciscoImageCheckMIBConformance 1 }
|
|
|
|
ciscoImageCheckMIBGroups
|
|
OBJECT IDENTIFIER ::= { ciscoImageCheckMIBConformance 2 }
|
|
|
|
ciscoImageCheckMIBCompliance MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The compliance statement for entities which
|
|
implement the CISCO-IMAGE-CHECK-MIB."
|
|
MODULE MANDATORY-GROUPS {
|
|
ciscoImageCheckOpGroup,
|
|
ciscoImgChkResultsGroup
|
|
}
|
|
|
|
OBJECT ciscoImageCheckEntryStatus
|
|
SYNTAX INTEGER {
|
|
active(1),
|
|
createAndGo(4),
|
|
destroy(6)}
|
|
DESCRIPTION
|
|
"Only 'createAndGo', 'destroy' and 'active' need to
|
|
be supported."
|
|
::= { ciscoImageCheckMIBCompliances 1 }
|
|
|
|
|
|
-- Units of Conformance
|
|
|
|
ciscoImageCheckOpGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
ciscoImageCheckImageName,
|
|
ciscoImageCheckStatus,
|
|
ciscoImageCheckEntryStatus
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of objects for Image Check
|
|
Operations group."
|
|
::= { ciscoImageCheckMIBGroups 1 }
|
|
|
|
|
|
ciscoImgChkResultsGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
ciscoImgChkFeatureName,
|
|
ciscoImgChkCapabilityName,
|
|
ciscoImgChkCapabilityReq,
|
|
ciscoImgChkInCompDescr
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of objects for Image check results
|
|
group."
|
|
::= { ciscoImageCheckMIBGroups 2 }
|
|
|
|
|
|
END
|