Onboard Failure Logging

OBFL gathers boot,
environmental, and critical hardware data for field-replaceable units (FRUs),
and stores the information in the nonvolatile memory of the FRU. This
information is used for troubleshooting, testing, and diagnosis if a failure or
other error occurs, providing improved accuracy in hardware troubleshooting and
root cause isolation analysis. Stored OBFL data can be retrieved in the event
of a failure and is accessible even if the card does not boot.

Because OBFL is on by
default, data is collected and stored as soon as the card is installed. If a
problem occurs, the data can provide information about historical environmental
conditions, uptime, downtime, errors, and other operating conditions.

Caution

OBFL is activated by
default in all cards. Do not deactivate OBFL without specific reasons, because
the OBFL data is used to diagnose and resolve problems in FRUs.

Prerequisites

You must be in a user group associated with a task group that
includes the proper task IDs. The command reference guides include the task IDs
required for each command. If you suspect user group assignment is preventing
you from using a command, contact your AAA administrator for assistance.

Information About
Implementing OBFL

Data Collection
Types

OBFL collects and
stores both baseline and event- driven information in the nonvolatile memory of
each supported card where OBFL is enabled. The data collected includes these:

FRU part serial
number

OS version

Boot time

Total run time
(hours in use)

Boot status

Temperature and
voltage at boot

Temperature and
voltage history

Other board
specific errors

This data is collected
in two different ways: as baseline data and event- driven data:

Inlet and
hot point temperature value change beyond the threshold
set in the hardware inventory XML files.

Voltage
Value

+5, and MBUS
+5, +3.3, and +2.2 voltage value.

An
environmental reading is logged when the following temperature or voltage
events occur:

Exceed
the normal range

Change
more than 10%

Return
within range for more than five minutes.

On reboot,
these environmental readings are consolidated into a single environmental
history record that shows the duration and extent out of normal range for a
consecutive set of environmental readings.

Calendar
Time

Disabled

The time
when OBFL logging was disabled with the
hw-module {all |
subslotnode-id}
logging
onboard disable
command in global configuration or administration
configuration mode.

Cleared

The time
when OBFL logging was cleared with the
clear logging
onboard command in EXEC or administration EXEC mode.

Reset to 0

The time
when total line card runtime is reset to zero with the
clear logging
onboard command in EXEC or administration EXEC mode.

Supported Cards and
Platforms

OBFL data collection
is supported.

FRUs that have
sufficient nonvolatile memory available for OBFL data storage support OBFL. For
example, the processor supports the OBFL.

How to Implement
OBFL

OBFL logging is
configured for the router. If a new node is inserted, and OBFL is enabled for
that slot or for all slots, then OBFL is enabled for the new node. If a card is
removed from a router and inserted into a different router, the card assumes
the OBFL configuration for the new router.

The clear logging onboard command permanently deletes all OBFL data for a node or for all nodes. Do not
clear the OBFL logs without specific reasons because the OBFL data is used to diagnose
and resolve problems in FRUs.

Caution

If OBFL is actively running on a card, issuing the clear logging
onboard command can result in a corrupt or incomplete log at a later
point in time. OBFL should always be disabled before this command is issued.

For more information, see the Onboard Failure Logging Commands
module in the Cisco IOS XR System Monitoring Command
Reference for the Cisco CRS Router.

RFCs

RFCs

Title

No new
or modified RFCs are supported by this feature, and support for existing RFCs
has not been modified by this feature.

—

Technical
Assistance

Description

Link

The
Cisco Technical Support website contains thousands of pages of searchable
technical content, including links to products, technologies, solutions,
technical tips, and tools. Registered Cisco.com users can log in from this page
to access even more content.