Table Of Contents

SPA Interface Processor and Shared Port Adapter Debug Commands on Cisco IOS XR Software

debug spa devobject

debug spa error

debug spa info

debug spa job

debug spa location

debug spa lwm

debug spa oir

debug spa periodic

debug spa plugin

debug spa process

debug spa show

debug spa sysdb

debug spa trace

debug spa-bridge error

debug spa-bridge oir

debug spa-bridge show

debug spa-bridge trace

SPA Interface Processor and Shared Port Adapter Debug Commands on Cisco IOS XR Software

---

This module describes the Cisco IOS XR debug commands which are specific to SPA interface processors (SIPs) and shared port adapters (SPAs). For general configuration and troubleshooting commands, refer to the Ethernet Switch and Server Platform Commands on Cisco IOS XR Software or Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software modules.

debug spa devobject

To debug a SPA object, use the debug spa devobject command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa devobject [location node-id] [job job-id | process pid]

no debug spa devobject [location node-id] [job job-id | process pid]

Syntax Description

location node-id	Displays debugging information for a node. The node-id argument is entered in the rack/slot/module notation.
job job-id	Displays debugging information for a job.
process pid	Displays debugging information for a process.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco CRS-1 and the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID	Operations
root-lr	read, write

Examples

The following example illustrates the use of the debug spa devobject command:

Router# debug spa devobject location 0/2/cpu0

debug spa error

To debug SPA errors, use the debug spa error command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa error [job job-id | process pid] [location node-id]

no debug spa error [job job-id | process pid] [location node-id]

Syntax Description

job job-id	Displays debugging information for a job.
process pid	Displays debugging information for a process.
location node-id	Displays debugging information for a node. The node-id argument is entered in the rack/slot/module notation.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco CRS-1 and the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID	Operations
root-lr	read, write

Examples

The following example illustrates the use of the debug spa error command:

Router# debug spa error location 0/2/cpu0

debug spa info

To view informational debugging for the SPA infrastructure, use the debug spa info command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa info [job job-id | process pid] [location node-id]

no debug spa info [job job-id | process pid] [location node-id]

Syntax Description

job job-id	Displays debugging information for a job.
process pid	Displays debugging information for a process.
location node-id	Displays debugging information for a node. The node-id argument is entered in the rack/slot/module notation.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco CRS-1 and the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID	Operations
root-lr	read, write

Examples

The following example illustrates the use of the debug spa info command:

Router# debug spa info location 0/2/cpu0

debug spa job

To debug a SPA job, use the debug spa job command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa job job-id [location node-id]

no debug spa job job-id [location node-id]

Syntax Description

job-id	ID of job for which to display debugging information.
location node-id	Displays job debugging information for a node. The node-id argument is entered in the rack/slot/module notation.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco CRS-1 and the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	The location node-id keyword argument was added to the debug spa job command.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID	Operations
root-lr	read, write

Examples

The following example illustrates the use of the debug spa job command:

Router# debug spa job 10

debug spa location

To debug a SPA module, use the debug spa location command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa location node-id [job job-id | process pid]

no debug spa location node-id [job job-id | process pid]

Syntax Description

node-id	Node for which to display debugging information. The node-id argument is entered in the rack/slot/module notation.
job job-id	Displays debugging information for a job.
process pid	Displays debugging information for a process.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco CRS-1 and the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID	Operations
root-lr	read, write

Examples

The following example illustrates the use of the debug spa location command:

Router# debug spa location 0/2/cpu0

debug spa lwm

To debug light weight messaging (lwm), use the debug spa lwm command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa lwm [job job-id | process pid] [location node-id]

no debug spa lwm [job job-id | process pid] [location node-id]

Syntax Description

job job-id	Displays debugging information for a job.
process pid	Displays debugging information for a process.
location node-id	Displays debugging information for a node. The node-id argument is entered in the rack/slot/module notation.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco CRS-1 and the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

The debug spa lwm command debugs interprocess communication in the IOS XR software.

Task ID

Task ID	Operations
root-lr	read, write

Examples

The following example illustrates the use of the debug spa lwm command:

Router# debug spa lwm location 0/2/cpu0

debug spa oir

To debug online insertion and removal of SPAs, use the debug spa oir command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa oir [job job-id | process pid] [location node-id]

no debug spa oir [job job-id | process pid] [location node-id]

Syntax Description

job job-id	Displays debugging information for a job.
process pid	Displays debugging information for a process.
location node-id	Displays debugging information for a node. The node-id argument is entered in the rack/slot/module notation.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco CRS-1 and the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID	Operations
root-lr	read, write

Examples

The following example illustrates the use of the debug spa oir command:

Router# debug spa oir location 0/2/cpu0

debug spa periodic

To perform periodic SPA event debugging, use the debug spa periodic command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa periodic [job job-id | process pid] [location node-id]

no debug spa periodic [job job-id | process pid] [location node-id]

Syntax Description

job job-id	Displays debugging information for a job.
process pid	Displays debugging information for a process.
location node-id	Displays debugging information for a node. The node-id argument is entered in the rack/slot/module notation.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco CRS-1 and the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID	Operations
root-lr	read, write

Examples

The following example illustrates the use of the debug spa periodic command:

Router# debug spa periodic location 0/2/cpu0

debug spa plugin

To debug a SPA plugin, use the debug spa plugin command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa plugin [job job-id | process pid] [location node-id]

no debug spa plugin [job job-id | process pid] [location node-id]

Syntax Description

job job-id	Displays debugging information for a job.
process pid	Displays debugging information for a process.
location node-id	Displays debugging information for a node. The node-id argument is entered in the rack/slot/module notation.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco CRS-1 and the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID	Operations
root-lr	read, write

Examples

The following example illustrates the use of the debug spa plugin command:

Router# debug spa plugin location 0/2/cpu0

debug spa process

To debug a SPA process, use the debug spa process command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa process pid [location node-id]

no debug spa process pid [location node-id]

Syntax Description

pid	Process ID of the process for which to debug.
location node-id	Displays debugging information for a node. The node-id argument is entered in the rack/slot/module notation.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco CRS-1 and the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID	Operations
root-lr	read, write

Examples

The following illustrates the use of the debug spa process command:

Router# debug spa process location 0/2/cpu0

debug spa show

To display show debugging information, use the debug spa show command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa show [job job-id | process pid] [location node-id]

no debug spa show [job job-id | process pid] [location node-id]

Syntax Description

job job-id	Displays debugging information for a job.
process pid	Displays debugging information for a process.
location node-id	Displays debugging information for a node. The node-id argument is entered in the rack/slot/module notation.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco CRS-1 and the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID	Operations
root-lr	read, write

Examples

The following example illustrates the use of the debug spa show command:

Router# debug spa show location 0/2/cpu0

debug spa sysdb

To debug SPA infrastructure interaction with the system database, use the debug spa sysdb command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa sysdb [job job-id | process pid] [location node-id]

no debug spa sysdb [job job-id | process pid] [location node-id]

Syntax Description

job job-id	Displays debugging information for a job.
process pid	Displays debugging information for a process.
location node-id	Displays debugging information for a node. The node-id argument is entered in the rack/slot/module notation.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco CRS-1 and the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID	Operations
root-lr	read, write

Examples

The following example illustrates the use of the debug spa sysdb command:

Router# debug spa sysdb location 0/2/cpu0

debug spa trace

To display trace debug information, use the debug spa trace command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa trace [location node-id] [job job-id | process pid]

no debug spa trace [location node-id] [job job-id | process pid]

Syntax Description

location node-id	Displays debugging information for a node. The node-id argument is entered in the rack/slot/module notation.
job job-id	Displays debugging information for a job.
process pid	Displays debugging information for a process.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco CRS-1 and the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID	Operations
root-lr	read, write

Examples

The following example illustrates the use of the debug spa trace command:

Router# debug spa trace location 0/2/cpu0

debug spa-bridge error

To display error messages related to the SPA ASIC driver on the carrier card, use the debug spa-bridge error command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa-bridge error

no debug spa-bridge error

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	The debug spa-bridge error command was moved from the root-lr task ID to the ip-services task ID.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID	Operations
ip-services	read, write

Examples

The following example illustrates the use of the debug spa-bridge error command:

Router# debug spa-bridge error

debug spa-bridge oir

To debug online insertion and removal of SPAs in relation to the SPA ASIC driver on the carrier card, use the debug spa-bridge oir command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa-bridge oir

no debug spa-bridge oir

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	The debug spa-bridge oir command was moved from the root-lr task ID to the ip-services task ID.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID	Operations
ip-services	read, write

Examples

The following example illustrates the use of the debug spa-bridge oir command:

Router# debug spa-bridge oir

debug spa-bridge show

To display dumps related to the SPA ASIC driver on the carrier card, use the debug spa-bridge show command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa-bridge show

no debug spa-bridge show

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	The debug spa-bridge show command was moved from the root-lr task ID to the ip-services task ID.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID	Operations
ip-services	read, write

Examples

The following example illustrates the use of the debug spa-bridge show command:

Router# debug spa-bridge show

debug spa-bridge trace

To display trace debug information related to the SPA ASIC driver on the carrier card, use the debug spa-bridge trace command in privileged EXEC mode. To turn off debugging output, use the no form of this command.

debug spa-bridge trace

no debug spa-bridge trace

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	The debug spa-bridge trace command was moved from the root-lr task ID to the ip-services task ID.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID	Operations
ip-services	read, write

Examples

The following example illustrates the use of the debug spa-bridge trace command:

Router# debug spa-bridge trace