CISCO-SEU-MITIGATION-MIB

2009-06-24

This MIB reports the status of non-automatic and automatic, rate-adaptive Single Event Upset (SEU) mitigation algorithms and adjusts their parameters, as well as reports the effects of those mitigations on memories, caches, and registers. SEU mitigation allows Cisco IOS to run on radiation tolerant hardware deployed in a geosynchronous Earth orbit satellites for IP communications. One of the challenges in deploying equipment in such an environment is the impact that radiation has on digital circuits. A Single Event Upset (SEU) occurs when the hardware is exposed to energetic ions and protons in the space environment. The value stored in a bit of information can change when a large enough charge is deposited on the digital circuit. This leads to adverse effects in the operation of the software; in this case Cisco IOS. While steps have been taken to reduce the occurrence of SEUs through the use of radiation tolerant hardware, these steps do not eliminate the threat. A critical requirement in running IOS on such platforms is the utilization of SEU mitigation strategies to reduce the impact of such events on the operation of the Cisco device. GLOSSARY SEU : Acronym for 'Single Event Upset' : A hardware disruption caused when hardware is exposed to energetic ions and protons. scrub : An algorithm that periodically refreshes memory, cache or register contents by various means.

Download CISCO-SEU-MITIGATION-MIB.txt Open CISCO-SEU-MITIGATION-MIB.txt in a new tab

SCALARS (1) · TABLES (3) · TRAPS (1)

Scalars (1)

Name	OID
csmSeuEventLogMaxEntries	1.3.6.1.4.1.9.9.701.1.3

Tables (3)

Name	OID
csmScrubTable	1.3.6.1.4.1.9.9.701.1.1
csmScrubErrorsTable	1.3.6.1.4.1.9.9.701.1.2
csmSeuEventLogTable	1.3.6.1.4.1.9.9.701.1.4

Traps (1)

Name	OID
csmSeuScrubAlert	1.3.6.1.4.1.9.9.701.0.1

END OF TOC

Scalar details

csmSeuEventLogMaxEntries

1.3.6.1.4.1.9.9.701.1.3

Unsigned32 (1..65535)

This object represents the maximum number of entries in the csmSeuEventLogTable.

Table details

csmScrubTable

1.3.6.1.4.1.9.9.701.1.1

Index: csmScrubIndex

This table provides the configuration settings for the scrub algorithms. All entries are added with the SEU subsystem is initialized.

csmScrubIndex

1.3.6.1.4.1.9.9.701.1.1.1.1

Unsigned32 (1..1000)

This object uniquely identifies the csmScrubEntry.

csmScrubEntPhysicalIndex

1.3.6.1.4.1.9.9.701.1.1.1.2

EntPhysicalIndexOrZeroThis textual convention is an extension of entPhysicalIndex. If non-zero, the object is an entPhysicalIndex. If zero, no appropriate entPhysicalIndex exists. Any additional semantics are object specific. (0..2147483647) · Integer32

This object represents the EntityPhysicalIndex (from the ENTITY-MIB) corresponding to the physical entity upon which the scrub or SEU-mitigation is being performed.

csmScrubScrubName

1.3.6.1.4.1.9.9.701.1.1.1.3

DisplayStringRepresents textual information taken from the NVT ASCII character set, as defined in pages 4, 10-11 of RFC 854. To summarize RFC 854, the NVT ASCII repertoire specifies: - the use of character codes 0-127 (decimal) - the graphics characters (32-126) are interpreted as US ASCII - NUL, LF, CR, BEL, BS, HT, VT and FF have the special meanings specified in RFC 854 - the other 25 codes have no standard interpretation - the sequence 'CR LF' means newline - the sequence 'CR NUL' means carriage-return - an 'LF' not preceded by a 'CR' means moving to the same column on the next line. - the sequence 'CR x' for any x other than LF or NUL is illegal. (Note that this also means that a string may end with either 'CR LF' or 'CR NUL', but not with CR.) Any object defined using this syntax may not exceed 255 characters in length. SIZE (0..255) · OCTET STRING · hint 255a

This object represents the name of the particular scrub or SEU algorithm, such as Memory Scrub, Register Scrub, etc.

csmScrubRateAdaptive

1.3.6.1.4.1.9.9.701.1.1.1.4

TruthValue1 = true2 = falseRepresents a boolean value. · Integer32

This object indicates whether the scrub or SEU algorithm is rate-adaptive. The values provided by objects csmScrubDeltaInterval, csmScrubRetryInterval, and csmScrubThresholdInterval are only applicable when this object is set to 'true'. true : Algorithm is rate-adaptive. false : Algorithm is NOT rate-adaptive.

csmScrubAlgorithmEnabled

1.3.6.1.4.1.9.9.701.1.1.1.5

TruthValue1 = true2 = falseRepresents a boolean value. · Integer32

This object indicates whether the SEU algorithm is enabled. true : Algorithm is enabled false : Algorithm is disabled

csmScrubRunInterval

1.3.6.1.4.1.9.9.701.1.1.1.6

Unsigned32

This object represents the amount of wait time between when a scrub algorithm finishes its current run and begins its next run.

csmScrubRunIntervalUnits

1.3.6.1.4.1.9.9.701.1.1.1.7

This object represents the units for csmScrubRunInterval.

csmScrubDeltaInterval

1.3.6.1.4.1.9.9.701.1.1.1.8

Unsigned32

This object represents the amount of time that a rate-adaptive scrub algorithm increases or decreases the csmScrubRunInterval. The scrub interval is decreased when an error interrupt occurs and the cScrubThresholdIntervalCount is exceeded. The scrub interval is increased when the scrub retry timer expires.

csmScrubDeltaIntervalUnits

1.3.6.1.4.1.9.9.701.1.1.1.9

This object represents the units for csmScrubDeltaInterval.

csmScrubRetryInterval

1.3.6.1.4.1.9.9.701.1.1.1.10

Unsigned32

This object represents the amount of time a rate-adaptive scrub algorithm waits before increasing the csmScrubRunInterval.

csmScrubRetryIntervalUnits

1.3.6.1.4.1.9.9.701.1.1.1.11

This object represents the units for csmScrubConfigRetryInterval.

csmScrubCurrentInterval

1.3.6.1.4.1.9.9.701.1.1.1.12

Unsigned32

This object represents the current interval between which scrubs or SEU-mitigation runs. A value of 0 (zero) indicates that the scrubs or runs are back-to-back.

csmScrubCurrentIntervalUnits

1.3.6.1.4.1.9.9.701.1.1.1.13

This object represents the units for csmScrubCurrentInterval.

csmScrubThresholdInterval

1.3.6.1.4.1.9.9.701.1.1.1.14

Unsigned32

This object represents the period of time that a rate-adaptive scrub algorithm will check for csmScrubThresholdErrorValue being exceeded. If the threshold is exceeded within this sliding time window, the scrub rate will increase.

csmScrubThresholdIntervalUnits

1.3.6.1.4.1.9.9.701.1.1.1.15

This object indicates the units for csmScrubConfigThresholdInterval.

csmScrubThresholdIntervalCount

1.3.6.1.4.1.9.9.701.1.1.1.16

Unsigned32 (1..1000)

This object represents the number of error interrupts received before a rate-adaptive scrub or SEU-mitigation algorithm decreases the scrub interval.

csmScrubThresholdErrorValue

1.3.6.1.4.1.9.9.701.1.1.1.17

Unsigned32 (1..1000)

This object represents the error threshold above which, when it occurs during sliding window (csmScrubThresholdInterval), the scrub or SEU-mitigation rate will increase.

csmScrubRunning

1.3.6.1.4.1.9.9.701.1.1.1.18

TruthValue1 = true2 = falseRepresents a boolean value. · Integer32

This object indicates whether the scrub or SEU algorithm is running or not. true : Algorithm is running. false : Algorithm is NOT running.

csmScrubStatus

1.3.6.1.4.1.9.9.701.1.1.1.19

INTEGER1 = elevated2 = decreased3 = normal · Integer32

This object indicates whether an adaptive scrub or SEU algorithm is performing scrubs more frequently (elevated) due most likely to more frequent SEUs or decreased due to less frequent SEUs, or at a normal rate.

csmScrubLastRun

1.3.6.1.4.1.9.9.701.1.1.1.20

DateAndTimeA date-time specification. field octets contents range ----- ------ -------- ----- 1 1-2 year* 0..65536 2 3 month 1..12 3 4 day 1..31 4 5 hour 0..23 5 6 minutes 0..59 6 7 seconds 0..60 (use 60 for leap-second) 7 8 deci-seconds 0..9 8 9 direction from UTC '+' / '-' 9 10 hours from UTC* 0..13 10 11 minutes from UTC 0..59 * Notes: - the value of year is in network-byte order - daylight saving time in New Zealand is +13 For example, Tuesday May 26, 1992 at 1:30:15 PM EDT would be displayed as: 1992-5-26,13:30:15.0,-4:0 Note that if only local time is known, then timezone information (fields 8-10) is not present. SIZE (8 | 11) · OCTET STRING · hint 2d-1d-1d,1d:1d:1d.1d,1a1d:1d

This object represents the date and time a scrub or SEU-mitigation algorithm last ran.

csmScrubPassesCompleted

1.3.6.1.4.1.9.9.701.1.1.1.21

Unsigned32

This object represents the total number of scrub or SEU-mitigations runs since the last 'clear SEU counters' CLI (command line interace) command was issued.

csmScrubErrorsTable

1.3.6.1.4.1.9.9.701.1.2

Index: csmScrubErrorsIndex

This table lists the errors and counts for the errors that the scrub algorithms are mitigating. All entries are added with the SEU subsystem is initialized.

csmScrubErrorsIndex

1.3.6.1.4.1.9.9.701.1.2.1.1

Unsigned32 (1..1000)

This object uniquely identifies the csmScrubEntry.

csmScrubErrorsEntPhysicalIndex

1.3.6.1.4.1.9.9.701.1.2.1.2

This object is represents the EntityPhysicalIndex (from the ENTITY-MIB) corresponding to the physical entity upon which the scrub or SEU-mitigation is being performed.

csmScrubErrorsDescription

1.3.6.1.4.1.9.9.701.1.2.1.3

This object represents the error name and may include things such as DDR memory errors, cache errors, register errors, and other processor-specific register errors.

csmScrubErrorsReference

1.3.6.1.4.1.9.9.701.1.2.1.4

This object provides a reference to a User's Manual entry, if one exists, for processor and other device-specific errors.

csmScrubErrorsSingleBit

1.3.6.1.4.1.9.9.701.1.2.1.5

Counter32

This object counts the single-bit errors for the specific error type described by csmScrubErrorsDescription.

csmScrubErrorsSingleBitInterrupts

1.3.6.1.4.1.9.9.701.1.2.1.6

Counter32

This object counts number of interrupts thrown, if any, for single-bit errors that occurred for the specific error type described by csmScrubErrorsDescription.

csmScrubErrorsMultibit

1.3.6.1.4.1.9.9.701.1.2.1.7

Counter32

This object counts the multi-bit errors for the specific error type described by csmScrubErrorsDescription.

csmScrubErrorsMultibitInterrupts

1.3.6.1.4.1.9.9.701.1.2.1.8

Counter32

This object counts number of interrupts thrown, if any, for multiple-bit errors that occurred for the specific error type described by csmScrubErrorsDescription.

csmSeuEventLogTable

1.3.6.1.4.1.9.9.701.1.4

Index: csmSeuEventLogIndex

This table lists any special error and scrub or SEU-mitigation algorithm events that may have occurred and is limited to csmSeuEventLogMaxEntries. All entries are added with the SEU subsystem is initialized.

csmSeuEventLogIndex

1.3.6.1.4.1.9.9.701.1.4.1.1

Unsigned32

This object uniquely identifies the csmScrubEventLogEntry.

csmSeuEventLogDescription

1.3.6.1.4.1.9.9.701.1.4.1.2

This object describes the event of interest.

csmSeuEventLogReference

1.3.6.1.4.1.9.9.701.1.4.1.3

This object provides a reference to a User's Manual entry, if one exists, that describes and provides more detail for the event of interest.

csmSeuEventLogAddress

1.3.6.1.4.1.9.9.701.1.4.1.4

This object provides the hexadecimal address (if one exists) associated with the event that occurred.

csmSeuEventLogTimeStamp

1.3.6.1.4.1.9.9.701.1.4.1.5

This object provides a date-and-time-stamp for the event that occurred.

Trap details

csmSeuScrubAlert

1.3.6.1.4.1.9.9.701.0.1

Notifies NMS when the scrub rate or SEU-mitigation rate is elevated, decreased or returns to normal.

csmScrubStatus

1.3.6.1.4.1.9.9.701.1.1.1.19

INTEGER1 = elevated2 = decreased3 = normal · Integer32

↑ To TOC