Table Of Contents

H Commands

hw-module logging onboard

H Commands

---

This chapter describes the Cisco NX-OS system management commands that begin with the letter H.

hw-module logging onboard

To enable onboard failure logging (OBFL) based on the error type, use the hw-module logging onboard command. To disable OBFL (not recommended), use the no form of this command.

hw-module logging onboard [counter-stats] [environmental-history] [error-stats] [interrupt-stats] [module num] [obfl-log]

no hw-module logging onboard [environmental-history] [error-stats] [interrupt-stats] [module num] [obfl-log]

Syntax Description

counter-stats	(Optional) Specifies the OBFL counter statistics.
environmental-history	(Optional) Specifies the OBFL environmental history.
error-stats	(Optional) Specifies OBFL error statistics.
interrupt-stats	(Optional) Specifies OBFL interrupt statistics.
module num	(Optional) Specifies OBFL information for a specific module.
obfl-log	(Optional) Specifies OBFL (boot-uptime/device-version/obfl-history).

Defaults

Enabled and is the recommended state.

Command Modes

Global configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
4.0(1)	This command was introduced.
4.0(2)	Added counter-stats keyword.

Usage Guidelines

The hw-module logging onboard command enables events to be recorded in files stored in nonvolatile memory, so that the data can be used to diagnose problems with hardware modules installed in a Cisco router or switch. When the onboard hardware is started up, a first record is made for each area monitored and becomes a base value for subsequent records. This command provides a circular updating scheme for collecting continuous records and archiving older (historical) records, ensuring accurate data about the hardware. Data is recorded in one of two formats: continuous information that displays a snapshot of data in a continuous file, and summary information that provides details about the data being collected. Use the show logging onboard command to see reports of current and historical data.

---

Note We recommend that you do not disable OBFL.

---

This configuration command is applicable to the module inserted in a device. When the module is removed and inserted into a new device, the configuration of this command follows the module to the new device.

This command does not require a license.

Examples

This example shows how to configure OBFL message logging at level 7 (debugging):

Router> enable

switch# configure terminal

switch(config)# hw-module switch 2 module 1 logging onboard message level 7

switch(config)# end

Related Commands

Command	Description
attach	Connects to a specific line card for the purpose of executing commands on that card.
clear logging onboard	Clears onboard failure logs.
show logging onboard	Displays onboard failure logs.