Onboard Failure Logging (OBFL) captures and stores hardware failure and environmental information into nonvolatile memory. OBFL permits improved accuracy in hardware troubleshooting and root cause isolation analysis. Stored OBFL data can be retrieved in the event of a router crash or failure.
•
Understanding OBFL, page 1
•
Configuring OBFL, page 2
•
Verifying OBFL Configuration, page 2
OBFL provides a mechanism to store hardware, software, and environment related critical data in a non-volatile memory, such as flash EPROM or EEPROM on routers. The logging information is used by the TAC team to troubleshoot and fix hardware issues.
OBFL collects data like temperatures and voltages. It stores the data in a dedicated area of the flash memory of the router. This data is retrieved by TAC personnel to troubleshoot routers. It can also be analyzed by back-end software to detect failure patterns, and possibly to recommend specific quality improvements.
Retrieval of the OBFL message
If the hardware is defective and the system cannot boot up, any data in flash is inaccessible. In that case, use any one of the following methods to recover OBFL data:
• Read the flash through JTAG: this requires provisions in hardware design and back-end hardware and software support tools.
• Repair the system; boot it; use the OBFL CLI commands.
Recording OBFL Messages
Data is recorded in any of the following formats:
• Continuous information that displays a snapshot of measurements.
• Samples in a continuous file, and summary information about the data being collected.
Cisco ASR 901S Series Aggregation Services Router Software Configuration Guide
1 OL-30498-03

Onboard Failure Logging
Configuring OBFL
Use the following commands to configure and verify OBFL:
Command
Router(conf)# hw-module
{all|slot|module}
{slotnumber/subslotnumber|modulenumber} logging onboard
Purpose
Enables OBFL on the specified hardware module.
The no form of the command disables OBFL.
Router(conf)# onboard hw-module module 0 logging
Router> show logging onboard
{slot|module}
{slotnumber/subslotnumber|modulenumber}
[ status
]
Shows the status of OBFL logging.
OBFL is enabled by default in Cisco ASR 901.
Clears OBFL logging.
Router(conf)# clear logging onboard
Example 1
Router# show logging onboard status
Devices registered with infra
Slot no.: 0 Subslot no.: 0, Device obfl0:
Application name clilog :
Path : obfl0:
CLI enable status : enabled
Platform enable status: enabled
Application name temperature :
Path : obfl0:
CLI enable status : enabled
Platform enable status: enabled
Example 2
Router # show logging onboard temperature ?
continuous Onboard logging continuous information detail Onboard logging detailed information end ending time and date raw Onboard logging raw information start starting time and date status Onboard logging status information summary Onboard logging summary information
Router# show logging onboard temperature continuous
--------------------------------------------------------------------------------
TEMPERATURE CONTINUOUS INFORMATION
--------------------------------------------------------------------------------
Sensor | ID |
--------------------------------------------------------------------------------
System 1
--------------------------------------------
Time Stamp |Sensor Temperature 0C
2
Cisco ASR 901S Series Aggregation Services Router Software Configuration Guide
OL-30498-03

Onboard Failure Logging
Verifying OBFL Configuration
MM/DD/YYYY HH:MM:SS | 1
--------------------------------------------
03/01/2000 00:06:02 37
03/01/2000 00:16:02 37
03/01/2000 00:05:57 36
Router# show logging onboard voltage continuous
------------------------------------------------------------------------------------------
-------------------------
VOLTAGE CONTINUOUS INFORMATION
------------------------------------------------------------------------------------------
-------------------------
Sensor | ID |
------------------------------------------------------------------------------------------
-------------------------
12.00VA 0
1.50V 1
1.25V 2
12.00VB 3
2.50V 4
1.05V 5
1.20V 6
1.80V 7
------------------------------------------------------------------------------------------
-------------------------
Time Stamp |Sensor Voltage
MM/DD/YYYY HH:MM:SS | 12.00VA 1.50V 1.25V 12.00VB 2.50V 1.05V 1.20V
1.80V
------------------------------------------------------------------------------------------
-------------------------
02/24/2000 21:41:58 11.764 1.176 1.176 7.843 2.352 0.784 1.176
1.568
02/24/2000 21:46:00 11.764 1.176 1.176 7.843 2.352 0.784 1.176
1.568
02/25/2000 14:29:53 11.764 1.176 1.176 7.843 2.352 0.784 1.176
1.568
02/25/2000 14:33:54 11.764 1.176 1.176 7.843 2.352 0.784 1.176
1.568
Router# sh logging onboard clilog summary
--------------------------------------------------------------------------------
CLI LOGGING SUMMARY INFORMATION
--------------------------------------------------------------------------------
COUNT COMMAND
--------------------------------------------------------------------------------
1 clear logging onboard
2 hw-module module 0 logging onboard message level 1
1 hw-module module 0 logging onboard message level 2
5 hw-module module 0 logging onboard message level 3
2 no hw-module module 0 logging onboard message level
5 show logging onboard
2 show logging onboard clilog
2 show logging onboard clilog continuous
1 show logging onboard clilog summary
2 show logging onboard continuous
1 show logging onboard environment
9 show logging onboard message
9 show logging onboard message continuous
1 show logging onboard message summary
3 show logging onboard status
1 show logging onboard temperature
1 show logging onboard voltage
1 test logging onboard error 3
1 test logging onboard error1 3
1 test logging onboard try 1
--------------------------------------------------------------------------------
OL-30498-03
Cisco ASR 901S Series Aggregation Services Router Software Configuration Guide
3

Verifying OBFL Configuration
Onboard Failure Logging
4
Cisco ASR 901S Series Aggregation Services Router Software Configuration Guide
OL-30498-03