Cisco IOS XR Interface and Hardware Component Command Reference, Release 3.5
10-Gigabit Ethernet WAN Physical Controller Commands on Cisco IOS XR Software
Download this chapter
10-Gigabit Ethernet WAN Physical Controller Commands on Cisco IOS XR Software10-Gigabit Ethernet WAN Physical Controller Commands on Cisco IOS XR Software
Download the complete book
Book-level PDF: Cisco IOS XR Interface and Hardware Component Command Reference Book-level PDF: Cisco IOS XR Interface and Hardware Component Command Reference (PDF - 6 MB)
give_us_feedback

Table Of Contents

10-Gigabit Ethernet WAN SPA Controller Commands on Cisco IOS XR Software

clear controller wanphy

clear counters wanphy

controller wanphy

lanmode on

show controllers wanphy


10-Gigabit Ethernet WAN SPA Controller Commands on Cisco IOS XR Software

This module describes the commands to configure a 10-Gigabit Ethernet WAN SPA physical layer controller on Cisco CRS-1 routers supporting Cisco IOS XR software.

For information on 10-Gigabit Ethernet (GE) interface commands see the Ethernet Interface Commands on Cisco IOS XR Software module.

clear controller wanphy

To clear the alarms counters for a specific 10-Gigabit Ethernet WAN SPA controller, use the clear controller wanphy command in EXEC mode.

clear controller wanphy interface-id stats

Syntax Description

interface-id

Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

•rack: Chassis number of the rack.

•slot: Physical slot number of the line card.

•module: Module number. A physical layer interface module (PLIM) is always 0. Shared port adapters (SPAs) are referenced by their subslot number.

•port: Physical port number of the interface.

For more information about the syntax for the router, use the question mark (?) online help function.

stats

Clears alarm counters for the specified 10-Gigabit Ethernet WAN SPA controller.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.5.0

This command was introduced on the Cisco CRS-1.


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.

Task ID

Task ID
Operations

interface

read, write, execute


Examples

The following example shows how to configure a 10-Gigabit Ethernet WAN SPA controller in Slot 6: 

RP/0/RP0/CPU0:Router # clear controller wanphy 0/6/0/0 stats

Related Commands

Command
Description

show controllers wanphy

Displays alarms, registers, and module information for a 10-Gigabit Ethernet WAN SPA controller.

clear counters wanphy

Clears the alarms counters for a specific 10-Gigabit Ethernet WAN SPA interface.


clear counters wanphy

To clear the alarms counters for a specific 10-Gigabit Ethernet WAN SPA interface, use the clear counters wanphy command in EXEC mode.

clear counters wanphy interface-id stats

Syntax Description

interface-id

Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

•rack: Chassis number of the rack.

•slot: Physical slot number of the line card.

•module: Module number. A physical layer interface module (PLIM) is always 0. Shared port adapters (SPAs) are referenced by their subslot number.

•port: Physical port number of the interface.

For more information about the syntax for the router, use the question mark (?) online help function.

stats

Clears alarm counters for the specified 10-Gigabit Ethernet WAN interface.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.5.0

This command was introduced on the Cisco CRS-1.


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.

Task ID

Task ID
Operations

interface

read, write, execute


Examples

The following example shows how to clear the alarms counters for a 10-Gigabit Ethernet WAN interface: 

RP/0/RP0/CPU0:Router # clear counters wanphy 0/6/0/0 stats

Related Commands

Command
Description

show controllers wanphy

Displays alarms, registers, and module information for a 10-Gigabit Ethernet WAN SPA controller.

clear controller wanphy

Clears the alarms counters for a specific 10-Gigabit Ethernet WAN SPA interface.


controller wanphy

To enter WAN physical controller configuration mode in which you can configure a 10-Gigabit Ethernet WAN SPA controller, use the controller wanphy command in global configuration mode. To return the 10-Gigabit Ethernet WAN SPA controller to its default WAN mode configuration, use the no form of this command.

controller wanphy interface-id

no controller wanphy interface-id

Syntax Description

interface-id

Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

•rack: Chassis number of the rack.

•slot: Physical slot number of the line card.

•module: Module number. A physical layer interface module (PLIM) is always 0. Shared port adapters (SPAs) are referenced by their subslot number.

•port: Physical port number of the interface.

For more information about the syntax for the router, use the question mark (?) online help function.


Defaults

No default behavior or values

Command Modes

Global configuration

Command History

Release
Modification

Release 3.5.0

This command was introduced on the Cisco CRS-1.


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.

Note After you use the no controller wanphy command to return a 10-Gigabit Ethernet WAN SPA controller to its default configuration, you need to cycle the power to the 10-Gigabit Ethernet SPA for the mode configuration changes to take affect.

Task ID

Task ID
Operations

interface

read, write


Examples

The following example shows how to configure a 10-Gigabit Ethernet WAN SPA controller in slot 6 to run in LAN mode: 

RP/0/RP0/CPU0:Router # configure

RP/0/RP0/CPU0:Router(config)# controller wanphy 0/6/0/0

RP/0/RP0/CPU0:Router(config-wanphy)# lanmode on

RP/0/RP0/CPU0:Router(config-wanphy)# commit

RP/0/RP0/CPU0:Router(config-wanphy)# exit

RP/0/RP0/CPU0:Router(config)# exit

RP/0/RP0/CPU0:router(config)# hw-module subslot 0/6/0 shutdown unpowered

RP/0/RP0/CPU0:Router(config)# commit

RP/0/RP0/CPU0:router(config)# no hw-module subslot 0/6/0 shutdown unpowered

The following example shows how to return a 10-Gigabit Ethernet WAN SPA controller in slot 6 to run in its default WAN mode: 

RP/0/RP0/CPU0:Router # configure

RP/0/RP0/CPU0:Router(config)# no controller wanphy 0/6/0/0

RP/0/RP0/CPU0:Router(config)# commit

RP/0/RP0/CPU0:Router(config)# exit

RP/0/RP0/CPU0:router(config)# hw-module subslot 0/6/0 shutdown unpowered

RP/0/RP0/CPU0:Router(config)# commit

RP/0/RP0/CPU0:router(config)# no hw-module subslot 0/6/0 shutdown unpowered

Related Commands

Command
Description

lanmode on

Configures a 10-Gigabit Ethernet WAN SPA10-Gigabit Ethernet WAN SPA controller to run in LAN mode, or returns a 10-Gigabit Ethernet WAN SPA controller to run in the default WAN mode.

show controllers wanphy

Displays alarms, registers, and module information for a 10-Gigabit Ethernet WAN SPA controller.


lanmode on

To configure a 10-Gigabit Ethernet WAN SPA controller to run in LAN mode, use the lanmode on command in WAN physical controller configuration mode. To return the controller to its default WAN state, use the no form of this command.

lanmode on

no lanmode on

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

WAN physical controller configuration

Command History

Release
Modification

Release 3.5.0

This command was introduced on the Cisco CRS-1.


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.

Task ID

Task ID
Operations

interface

read, write


Examples

The following example shows how to enable LAN mode on a 10-Gigabit Ethernet WAN SPA controller: 

RP/0/RP0/CPU0:Router # configure

RP/0/RP0/CPU0:Router(config)# controller wanphy 0/6/0/0

RP/0/RP0/CPU0:Router(config-wanphy)# lanmode on


To complete the mode change the SPA must be power-cycled.

The following example shows how to disable LAN mode on a 10-Gigabit Ethernet WAN SPA controller and return that controller to the default WAN mode: 

RP/0/RP0/CPU0:Router # configure

RP/0/RP0/CPU0:Router(config)# controller wanphy 0/6/0/0

RP/0/RP0/CPU0:srt-crs1(config-wanphy)# no lanmode on


To complete the mode change the SPA must be power-cycled.

Related CommandsRP/0/RP0/CPU0:Router(config)#

Command
Description

show controllers wanphy

Displays alarms, registers, and module information for a 10-Gigabit Ethernet WAN SPA controller.


show controllers wanphy

To display alarms, registers, and module information for a 10-Gigabit Ethernet WAN SPA controller, use the show controllers wanphy command in EXEC mode.

show controller wanphy interface-id [alarms | all | registers]

Syntax Description

interface-id

Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

•rack: Chassis number of the rack.

•slot: Physical slot number of the line card.

•module: Module number. A physical layer interface module (PLIM) is always 0. Shared port adapters (SPAs) are referenced by their subslot number.

•port: Physical port number of the interface.

For more information about the syntax for the router, use the question mark (?) online help function.

alarms

Displays information about any alarms that are detected by the specified 10-Gigabit Ethernet WAN SPA controller.

all

Displays registers, alarms, and module information for the specified 10-Gigabit Ethernet WAN SPA controller.

registers

Displays registers for the specified 10-Gigabit Ethernet WAN SPA controller.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.5.0

This command was introduced on the Cisco CRS-1.


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.

Task ID

Task ID
Operations

interface

read


Examples

The following example shows sample output from the show controllers wanphy command with the all keyword: 

RP/0/RP0/CPU0:srt-crs1# show controllers wanphy 0/3/4/0 all


Interface: wanphy0_3_4_0

Configuration Mode: WAN Mode

SECTION

  LOF = 1, LOS = 1, BIP(B1) = 2912

LINE

  AIS = 1, RDI = 0, FEBE = 949, BIP(B2) = 48562

PATH

  AIS = 1, RDI = 0, FEBE = 0, BIP(B2) = 0

  LOP = 0, NEWPTR = 0, PSE = 0, NSE = 0

WIS ALARMS

  SER = 9, FELCDP = 0, FEAISP = 0

  WLOS = 1, PLCD = 0

  LFEBIP = 47260, PBEC = 949


Active Alarms[All defects]: lof,

Active Alarms[Highest Alarms]: lof

  Rx(K1/K2): N/A, Tx(K1/K2): N/A

  S1S0 = N/A, C2 = N/A

PATH TRACE BUFFER

Remote IP addr: 000.000.000.000

BER thresholds: N/A

TCA thresholds: N/A


REGISTERS

P_FEBE  : 949

L_FE_BIP: 47260

L_BIP   : 48562

P_BEC   : 949

S_BIP   : 2912

J1-Rx0  : 0x3136

J1-Rx1  : 0x352e

J1-Rx2  : 0x3234

J1-Rx3  : 0x332e

J1-Rx4  : 0x3132

J1-Rx5  : 0x3900

J1-Rx6  : 0x3138

J1-Rx7  : 0x372e

Internal Information

Operational Mode  : WAN Mode

Curent Alarms: 0x8

Table 24 describes the significant fields shown in the display.

Table 24 show controllers wanphy Command Output Fields 

Field
Description

Interface

Identifies the WAN physical interface, in the format rack/slot/module/port.

•rack: Chassis number of the rack.

•slot: Physical slot number of the line card.

•module: Module number. A physical layer interface module (PLIM) is always 0. Shared port adapters (SPAs) are referenced by their subslot number.

•port: Physical port number of the interface.

Configuration Mode

Current configuration mode running on this controller. Can be WAN mode or LAN mode.

SECTION

Displays the following section alarms:

•LOF—Number of Loss of Framing (LOF) errors on this connection section. LOF alarms are critical because they indicate that the link associated with this section is down.

•LOS—Number of loss of signal (LOS) errors on this connection section. LOS alarms are critical because they indicate that the link associated with this section is down.

•BIP(B1)—Number of bit interleaved parity (BIP) B1 errors on this section that exceeded the specified threshold.

LINE

Displays the following line alarms:

•AIS—Number of AIS errors on this line. AIS alarms are critical because they indicate that the line is down.

•RDI—Remote defect indication.

–Line remote defect indication is reported by the downstream LTE when it detects LOF4, LOS5, or AIS6.

–Path remote defect indication is reported by the downstream PTE when it detects a defect on the incoming signal.

•FEBE—Number of far-end block errors (FEBE) on this line. Line FEBE errors are accumulated from the M0 or M1 byte, and are reported when the downstream LTE detects BIP7 (B2) errors.

•BIP(B2)—Number of bit interleaved parity (BIP) B2 errors on this line that exceeded the specified threshold.

PATH

Displays the following path alarms:

•AIS—Number of AIS errors on this path. AIS alarms are critical because they indicate that the line associated with this path is down.

•RDI—Number of RDI errors on this path.

•FEBE—Number of FEBE errors on this path. Path FEBEs are accumulated from the G1 byte, and are reported when the downstream PTE detects BIP (B3) errors.

•BIP(B2)—Number of bit interleaved parity (BIP) errors on this path that exceeded the specified threshold.

•LOP—Number of loss of pointer (LOP) errors on this path. Path LOPs are reported as a result of an invalid pointer (H1, H2) or an excess number of new data flag enabled indications.

•NEWPTR—Inexact count of the number of times the SONET framer has validated a new SONET pointer value (H1, H2).

•PSE—Inexact count of the number of times the SONET framer has detected a positive stuff event (PSE) in the received pointer (H1, H2).

•NSE—Inexact count of the number of times the SONET framer has detected a negative stuff event in the received pointer (H1, H2).

Note For Cisco IOS XR Software Release 3.53.5.0, the following fields display no errors:
RDI
FEBE
BIP(B2)
NEWPTR
PSE
NSE

WIS ALARMS

Displays the following WAN Interconnect Sublayer (WIS) layer alarms:

•SER—Number of Severely Errored Seconds (SER) errors

•FELCDP—Number of Far End - Loss of Code-group Delineation - Path (FELCDP) errors

•FEAISP—Number of Far End - AIS - Path (FEAISP) errors

•WLOS—Number of WIS LOS (WLOS) errors.

•PLCD—Number of Path Loss of Code-group Delineation (PLCD) errors

•LFEBIP—Number of Line - Far End - BIP (LFEBI) errors

•PBEC—Number of Path - Block Error Counter (PBEC) errors

Note For Cisco IOS XR Software Release 3.53.5.0, the WLOS field displays no alarms.

Active Alarms[All defects]

Total number of currently active alarms on this interface.

Active Alarms[Highest Alarms]

Total number of the most significant active alarms on this interface. These alarms are likely causing all other alarms on the interface.

Rx(K1/K2)

Total number of errored K1/K2 bytes from the Line OverHead (LOH) of the SONET frame that were received by this interface.

Note The Rx(K1/K2) field displays no output in Cisco IOS XR Software Release 3.53.5.0.

Tx(K1/K2)

Total number of errored K1/K2 bytes from the Line OverHead (LOH) of the SONET frame that were transmitted by this interface.

Note The Tx(K1/K2) field displays no output in Cisco IOS XR Software Release 3.53.5.0.

S1S0

Number of errored payload pointer bytes on this interface.

Note The S1S0 field displays no output in Cisco IOS XR Software Release 3.53.5.0.

C2

Number of errored STS identifier (C1) bytes on this interface.

PATH TRACE BUFFER

Rx J1 trace buffer received from the far end. If the received data is valid it will be shown below the PATH TRACE BUFFER field.

Remote IP addr

Byte string containing the IP address of the remote end of this connection. If the received data is invalid, this field displays no IP address.

BER thresholds

BER threshold values of the specified alarms for a the 10-Gigabit Ethernet controller.

Note The BER thresholds field displays no output in Cisco IOS XR Software Release 3.53.5.0.

TCA thresholds

TCA threshold values of the specified alarms for a the 10-Gigabit Ethernet controller.

Note The TCA thresholds field displays no output in Cisco IOS XR Software Release 3.53.5.0.

REGISTERS

Displays output from the following registers in hexadecimal format:

•P_FEBE—Total number of Far End Block Errors (FEBEs) that occurred on the path that is associated with this interface.

•L_FE_BIP—Total number of far end BIP errors that occurred on this interface.

•L_BIP—Total number of local BIP errors that occurred on this interface.

•P_BEC—Total BIP error count (BEC) that occurred on the path that is associated with this interface.

•S_BIP—Total number of far end BIP errors that occurred on the current section.

•J1-Rx0—Characters from far end IPV4 address string.

•J1-Rx1—Characters from far end IPV4 address string.

•J1-Rx2—Characters from far end IPV4 address string.

•J1-Rx3—Characters from far end IPV4 address string.

•J1-Rx4—Characters from far end IPV4 address string.

•J1-Rx5—Characters from far end IPV4 address string.

•J1-Rx6—Characters from far end IPV4 address string.

•J1-Rx7—Characters from far end IPV4 address string.

Note The following Serdes-WIS HW registers are used to debug counters and can be cleared only by power cycling the hardware:
P_FEBE
L_FE_BIP
L_BIP
P_BEC
S_BIP

The J1-Rx registers (J1-Rx0 through J1-Rx7) comprise the raw 16 bytes of data received from the Rx J1 Path Trace Buffer, and are used to debug IPV4 address sent from far end.

Internal Information

Displays the following internal information for the interface:

•Operational Mode—Current operation mode for this controller. Can be WAN mode or LAN mode. Use the Operational Mode field to detect whether the hardware was power cycled after a mode configuration change. If the Operational Mode field shows output that is different from the Configuration Mode field, then the hardware was not power cycled properly after a mode configuration change.

•Current Alarms—Bit map of all currently active alarms on this controller. Use this information for debugging purposes.


The following example shows sample output from the show controllers wanphy command with the alarms keyword: 

RP/0/RP0/CPU0:srt-crs1# show controllers wanphy 0/3/4/0 alarms


Interface: wanphy0_3_4_0

Configuration Mode: WAN Mode

SECTION

  LOF = 1, LOS = 1, BIP(B1) = 2912

LINE

  AIS = 1, RDI = 0, FEBE = 949, BIP(B2) = 48562

PATH

  AIS = 1, RDI = 0, FEBE = 0, BIP(B2) = 0

  LOP = 0, NEWPTR = 0, PSE = 0, NSE = 0

WIS ALARMS

  SER = 9, FELCDP = 0, FEAISP = 0

  WLOS = 1, PLCD = 0

  LFEBIP = 47260, PBEC = 949


Active Alarms[All defects]:

Active Alarms[Highest Alarms]:

  Rx(K1/K2): N/A, Tx(K1/K2): N/A

  S1S0 = N/A, C2 = N/A

PATH TRACE BUFFER

Remote IP addr: 981.761.542.321

BER thresholds: N/A

TCA thresholds: N/A

The alarm information displayed in the show controllers wanphy interface-id alarms command output are described in Table 24.

The following example shows sample output from the show controllers wanphy command with the registers keyword: 


RP/0/RP0/CPU0:srt-crs1# show controllers wanphy 0/3/4/0 registers

Interface: wanphy0_3_4_0


Configuration Mode: WAN Mode

REGISTERS

P_FEBE  : 949

L_FE_BIP: 47260

L_BIP   : 48562

P_BEC   : 949

S_BIP   : 2912

J1-Rx0  : 0x3136

J1-Rx1  : 0x352e

J1-Rx2  : 0x3234

J1-Rx3  : 0x332e

J1-Rx4  : 0x3132

J1-Rx5  : 0x3900

J1-Rx6  : 0x3138

J1-Rx7  : 0x372e

Internal Information

Operational Mode  : WAN Mode

Curent Alarms: 0x0

The registers displayed in the show controllers wanphy interface-id registers command output is described in Table 24.

Related Commands

Command
Description

clear controller wanphy

Clears the alarms counters for a specific 10-Gigabit Ethernet WAN SPA controller.

lanmode on

Configures a 10-Gigabit Ethernet WAN SPA controller to run in LAN mode, or returns a 10-Gigabit Ethernet WAN SPA controller to run in the default WAN mode.