Cisco IOS XR Interface and Hardware Component Command Reference, Release 3.5
SRP Commands on Cisco IOS XR Software
Download this chapter
SRP Commands on Cisco IOS XR SoftwareSRP 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

SRP Commands on Cisco IOS XR Software

clear srp counters

hw-module port

interface srp

show controllers srp

show srp

srp ips delay trigger-keepalive

srp ips request forced-switch

srp ips timer

srp ips wtr-timer

srp mac-count

srp mac-reject

srp manual-switch

srp shutdown

srp topology-timer


SRP Commands on Cisco IOS XR Software

This module describes the commands to configure Spatial Reuse Protocol (SRP) on supported Cisco Dynamic Packet Transport (DPT) interfaces in routers running Cisco IOS XR software.

SRP is a MAC-layer protocol developed by Cisco and is used in conjunction with Cisco DPT products. DPT products deliver scalable Internet service, reliable IP-aware optical transport, and simplified network operations. These solutions allow you to scale and distribute your IP services across a reliable optical packet ring infrastructure.

Note Throughout the remainder of this publication, the term SRP is used to describe features related to the DPT product family.

clear srp counters

To clear the SRP counters, use the clear srp counters command in EXEC mode.

clear srp counters {interface srp instance | location node-id}

Syntax Description

interface srp

Specifies the SRP interface.

instance

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 modular services card or 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. An SRP interface is comprised of two consecutive physical ports and is named according to the first, lower-numbered port. For example, the SRP interface 0/4/0/2 is comprised of the two physical ports 0/4/0/2 and 0/4/0/3.

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


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2.2

This command was introduced on the Cisco CRS-1 and is supported only on the 4-port OC-192c/STM-64c POS/DPT PLIM.

Release 3.4.0

This command was first supported on the 16-port OC-48c/STM-16c POS/DPT PLIM.

Release 3.5.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.

The clear srp counters command clears the counters displayed in the following commands:

•show controllers srp rac-error

•show srp counters

•show srp counters source

•show srp transit

Task ID

Task ID
Operations

pos-dpt

read, write


Examples

The following example shows how to use the clear srp counters command to make the counts displayed from the show srp source-counters command return to zero: 

RP/0/RP0/CPU0:Router# show srp counters interface srp 0/7/0/0 


Data Traffic Counters for Interface SRP0/7/0/0

 Side A:

 Transit                                   Packets                Bytes

     Total Low Priority:                         0                    0

     Total High Priority:                      183               768543

     Total Multicast:                          174               767913

     Total Unicast:                              9                  630

 Host Receive                              Packets                Bytes

     Unicast Low Priority:                       6                  648

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                    1                   41

 Total Receive                             Packets                Bytes

     Unicast Low Priority:                       6                  648

     Unicast High Priority:                      9                  630

     Multicast Low Priority:                     3                  144

     Multicast High Priority:                  174               767913

 Host Transmit                             Packets                Bytes

     Unicast Low Priority:                       4                  480

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                    0                    0

 Total Transmit                            Packets                Bytes

     Unicast Low Priority:                       4                  480

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                  772              1575090

 Traffic Rate (5 Minutes)              packets/sec             bits/sec

     Transit Low Priority                        0                    0

     Transit High Priority                       0                    0

     Transit Multicast                           0                    0

     Transit Unicast                             0                    0

     Host Receive                                0                    0

     Total Receive                               0                    0

     Host Transmit                               0                    0

     Total Transmit                              0                    0

 Received Errors:

     0 input errors, 0 CRC, 0 ignored,

     0 framer runts, 0 framer giants, 0 framer aborts,

     0 mac runts, 0 mac giants, 0 mac ttl strips


 Side B:

 Transit                                   Packets                Bytes

     Total Low Priority:                         0                    0

     Total High Priority:                      772              1575090

     Total Multicast:                          772              1575090

     Total Unicast:                              0                    0

 Host Receive                              Packets                Bytes

     Unicast Low Priority:                       6                  648

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                    1                   41

 Total Receive                             Packets                Bytes

     Unicast Low Priority:                       6                  648

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                  772              1575090

 Host Transmit                             Packets                Bytes

     Unicast Low Priority:                       6                  720

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     3                  144

     Multicast High Priority:                    0                    0

 Total Transmit                            Packets                Bytes

     Unicast Low Priority:                       6                  720

     Unicast High Priority:                      9                  630

     Multicast Low Priority:                     3                  144

     Multicast High Priority:                  174               767913

 Traffic Rate (5 Minutes)              packets/sec             bits/sec

     Transit Low Priority                        0                    0

     Transit High Priority                       0                    0

     Transit Multicast                           0                    0

     Transit Unicast                             0                    0

     Host Receive                                0                    0

     Total Receive                               0                    0

     Host Transmit                               0                    0

     Total Transmit                              0                    0

 Received Errors:

     0 input errors, 0 CRC, 0 ignored,

     0 framer runts, 0 framer giants, 0 framer aborts,

     0 mac runts, 0 mac giants, 0 mac ttl strips


RP/0/RP0/CPU0:Router# clear srp counters interface srp 0/7/0/0

RP/0/RP0/CPU0:Router# show srp counters interface srp 0/7/0/0


 Data Traffic Counters for Interface SRP0/7/0/0

 Side A:

 Transit                                   Packets                Bytes

     Total Low Priority:                         0                    0

     Total High Priority:                        0                    0

     Total Multicast:                            0                    0

     Total Unicast:                              0                    0

 Host Receive                              Packets                Bytes

     Unicast Low Priority:                       0                    0

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                    0                    0

 Total Receive                             Packets                Bytes

     Unicast Low Priority:                       0                    0

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                    0                    0

 Host Transmit                             Packets                Bytes

     Unicast Low Priority:                       0                    0

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                    0                    0

 Total Transmit                            Packets                Bytes

     Unicast Low Priority:                       0                    0

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                    0                    0

 Traffic Rate (5 Minutes)              packets/sec             bits/sec

     Transit Low Priority                        0                    0

     Transit High Priority                       0                    0

     Transit Multicast                           0                    0

     Transit Unicast                             0                    0

     Host Receive                                0                    0

     Total Receive                               0                    0

     Host Transmit                               0                    0

     Total Transmit                              0                    0

 Received Errors:

     0 input errors, 0 CRC, 0 ignored,

     0 framer runts, 0 framer giants, 0 framer aborts,

     0 mac runts, 0 mac giants, 0 mac ttl strips


 Side B:

 Transit                                   Packets                Bytes

     Total Low Priority:                         0                    0

     Total High Priority:                        0                    0

     Total Multicast:                            0                    0

     Total Unicast:                              0                    0

 Host Receive                              Packets                Bytes

     Unicast Low Priority:                       0                    0

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                    0                    0

 Total Receive                             Packets                Bytes

     Unicast Low Priority:                       0                    0

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                    0                    0

 Host Transmit                             Packets                Bytes

     Unicast Low Priority:                       0                    0

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                    0                    0

 Total Transmit                            Packets                Bytes

     Unicast Low Priority:                       0                    0

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                    0                    0

 Traffic Rate (5 Minutes)              packets/sec             bits/sec

     Transit Low Priority                        0                    0

     Transit High Priority                       0                    0

     Transit Multicast                           0                    0

     Transit Unicast                             0                    0

     Host Receive                                0                    0

     Total Receive                               0                    0

     Host Transmit                               0                    0

     Total Transmit                              0                    0

 Received Errors:

     0 input errors, 0 CRC, 0 ignored,

     0 framer runts, 0 framer giants, 0 framer aborts,

     0 mac runts, 0 mac giants, 0 mac ttl strips

Related Commands

Command
Description

show srp

Displays information about SRP interfaces on the ring, including MAC addresses of neighboring interfaces, IPS status, source-counters, and topology map.


hw-module port

To enable a port to be used for SRP, use the hw-module port command in global configuration mode. To disable SRP and enable the port for POS, use the no form of this command.

hw-module port port-number srp location node-id

no hw-module port port-number srp location node-id

Syntax Description

port-number

Number of the physical interface on the PLIM.

srp

Specifies an SRP interface.

location

Specifies the location of the module.

node-id

Location of the module in the rack/slot/module notation.


Defaults

When there is no hw-module port configuration, ports are enabled for POS by default.

Command Modes

Global configuration

Command History

Release
Modification

Release 3.2.2

This command was introduced on the Cisco CRS-1 and is supported only on the 4-port OC-192c/STM-64c POS/DPT PLIM.

Release 3.4.0

This command was first supported on the 16-port OC-48c/STM-16c POS/DPT PLIM.

Release 3.5.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.

POS is the default port mode on POS/DPT PLIMs. Use the hw-module port command to allow the ports to be configured for SRP use.

SRP requires two consecutive physical ports for use as a single SRP interface. The first port must be even numbered and the second port must be odd numbered. No other combinations are allowed. You must use this command on both of the ports to be used as an SRP interface. SRP interfaces take the number of the lower, even-numbered port. For example, if ports 0/1/0/2 and 0/1/0/3 are enabled as an SRP interface, the interface would be referred to as SRP0/1/0/2.

On the 16-port OC-48c/STM-16c POS/DPT PLIM, groups of four consecutive ports must be configured the same. Ports 0-3 all must be configured as either SRP or POS. The same is true for ports 4-7, 8-11 and 12-15.

After using the hw-module port command, you must save the configuration and reload the PLIM. To disable SRP and reenable POS on the port, use the no form of the command.

Note You must reload the PLIM to enable this configuration change and create the SRP or POS interface. Use the hw-module location reload command in EXEC mode.

Note Internal clocking is required for SRP interfaces. Use the clock source internal command in SONET configuration mode to configure the clock source.

Task ID

Task ID
Operations

root-lr

read, write


Examples

In the following example, ports 0 and 1 are enbled for SRP: 

RP/0/RP0/CPU0:Router(config)# hw-module port 0 srp location 0/6/cpu0

RP/0/RP0/CPU0:Router(config)# hw-module port 1 srp location 0/6/cpu0

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


Uncommitted changes found, commit them before exiting(yes/no/cancel)? [cancel]: y


RP/0/RP0/CPU0:Sep  8 11:13:30.817 : config[65732]: %MGBL-LIBTARCFG-6-COMMIT : 
Configuration committed by user 'xxx'.   Use 'show configuration commit changes 
1000000646' to view the changes. 

RP/0/RP0/CPU0:Sep  8 11:13:30.902 : config[65732]: %MGBL-SYS-5-CONFIG_I : Configured from 
console by xxx 


RP/0/RP0/CPU0:Router# hw-module location 0/6/cpu0 reload 


RP/0/RP0/CPU0:Anjou#SP/0/6/SP:Sep  8 11:17:17.037 : alphadisplay[100]: 
%PLATFORM-ALPHA_DISPLAY-6-CHANGE : Alpha display on node 0/6/SP changed to          in 
state default  

shRP/0/RP0/CPU0:Sep  8 11:17:17.865 : shelfmgr[283]: %PLATFORM-SHELFMGR-3-USER_RESET : 
Node 0/6/CPU0 is reset due to user reload request

Related Commands

Command
Description

clock source internal

Configures SONET clocking as internal.

hw-module location reload

Reloads the PLIM.


interface srp

To configure the SRP protocol on a DPT interface and enter interface configuration mode, use the interface srp command in global configuration mode.

interface srp instance

Syntax Description

instance

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 modular services card or line card.

•module: Module number. A physical layer interface module (PLIM) is always 0.

•port: Physical port number of the interface. An SRP interface is comprised of two consecutive physical ports and is named according to the first, lower-numbered port. For example, the SRP interface 0/4/0/2 is comprised of the two physical ports 0/4/0/2 and 0/4/0/3.

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.2.2

This command was introduced on the Cisco CRS-1 and is supported only on the 4-port OC-192c/STM-64c POS/DPT PLIM.

Release 3.4.0

This command was first supported on the 16-port OC-48c/STM-16c POS/DPT PLIM.

Release 3.5.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.

Task ID

Task ID
Operations

interface

read, write


Examples

The following example shows how to enter srp interface mode: 

RP/0/RP0/CPU0:router(config)# interface srp 0/1/0/0

RP/0/RP0/CPU0:router(config-if)#

show controllers srp

To display information on the SRP controllers, use the show controllers srp command in EXEC mode.

show controllers srp instance side {a | b} {rac-error | rac-reg | ucode-inst | ucode-reg}

Syntax Description

instance

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 modular services card or 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. An SRP interface is comprised of two consecutive physical ports and is named according to the first, lower-numbered port. For example, the SRP interface 0/4/0/2 is comprised of the two physical ports 0/4/0/2 and 0/4/0/3.

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

side

Specify the side of the node.

a

The side of a node that has outer ring receive fiber is identified as side A.

b

The side of a node that has inner ring receive fiber is identified as side B.

rac-error

Displays the error reported by the Ring Access Controller (RAC) device.

rac-reg

Displays the value of the RAC device register set.

ucode-inst

Displays the RAC micro-controller binary code instruction set (currently loaded or executing) in hexidecimal format.

Note This is an intrusive command that will cause adjacent nodes to detect a MAC keepalive failure and then wrap.

ucode-reg

Displays the RAC micro-controller register set.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2.2

This command was introduced on the Cisco CRS-1 and is supported only on the 4-port OC-192c/STM-64c POS/DPT PLIM.

Release 3.4.0

This command was first supported on the 16-port OC-48c/STM-16c POS/DPT PLIM.

Release 3.5.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.

Task ID

Task ID
Operations

interface

read


Examples

This example shows how to display the RAC registers for a specified SRP interface: 

RP/0/RP0/CPU0:Router# show controllers srp 0/5/0/0 side a rac-reg

Related Commands

Command
Description

show srp

Displays information about SRP interfaces on the ring, including MAC addresses of neighboring nodes, IPS status, source-counters, and topology map.


show srp

To display information about an SRP interface, use the show srp command in EXEC mode.

show srp [counters [source] | failures | ips | platform | srr | topology | transit] [interface srp instance | location node-id]

Syntax Description

counters

Displays counters for the packets received, transmitted, and transited on both sides of an SRP node.

source

Displays the counters for the SRP source address.

failures

Displays all SRP failures that were detected by the router.

ips

Displays the Intelligent Protection Switching (IPS) status.

platform

Displays platform-specific SRP interface details.

srr

Displays single ring recovery (SRR) information.

topology

Identifies the nodes on the ring.

transit

Displays transit delays (in nanoseconds) between the time that a packet enters the transit buffer and the time it comes back on the ring.

interface

Specifies the interface for which to display the counters.

srp

Specifies an SRP interface.

instance

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 modular services card or 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. An SRP interface is comprised of two consecutive physical ports and is named according to the first, lower-numbered port. For example, the SRP interface 0/4/0/2 is comprised of the two physical ports 0/4/0/2 and 0/4/0/3.

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

location

Specifies the location of the module.

node-id

Location of the module in the rack/slot/module notation.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2.2

This command was introduced on the Cisco CRS-1 and is supported only on the 4-port OC-192c/STM-64c POS/DPT PLIM.

Release 3.4.0

This command was first supported on the 16-port OC-48c/STM-16c POS/DPT PLIM.

Release 3.5.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.

To clear the SRP counters, use the clear srp counters command. The show srp command with the counters keyword reports the per-side counters and rates for various packet paths.

The show srp command with the failures keyword reports the SRP failures that were detected by the router. Use the failures keyword when an SRP interface is wrapped and you want to display information about the cause of the failure.

Use the transit keyword to determine the approximate latency when transmitting a packet, which due to higher latency, gives the approximation of congestion at this interface. If there is no latency, there is no congestion. Latency indicates that traffic transiting the ring and transmitted from the host are competing, meaning there is congestion.

Regarding the topology keyword, Address Resolution Protocol (ARP) is independent of the Layer 2 topology mapping. In other words, the absence of a MAC address in the topology map does not prevent ARP or any Layer 3 protocol from reaching the node. Alternatively, the presence of a MAC address in the topology map does not mean that it will be possible to resolve the Layer 3 address. The topology map is used to determine the most efficient side (in hops) to use to reach any given MAC address.

Task ID

Task ID
Operations

pos-dpt

read


Examples

Sample output from the show srp command is displayed in the following sections:

•show srp counters Sample Output

•show srp failures Sample Output

•show srp interface Sample Output

•show srp ips Sample Output

•show srp topology Sample Output

•show srp transit Sample Output

show srp counters Sample Output

In the following example, output from the show srp command with the counters keyword is displayed: 

RP/0/RP0/CPU0:Router# show srp counters interface srp 0/7/0/0 


Data Traffic Counters for Interface SRP0/7/0/0

 Side A:

 Transit                                   Packets                Bytes

     Total Low Priority:                         0                    0

     Total High Priority:                      183               768543

     Total Multicast:                          174               767913

     Total Unicast:                              9                  630

 Host Receive                              Packets                Bytes

     Unicast Low Priority:                       6                  648

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                    1                   41

 Total Receive                             Packets                Bytes

     Unicast Low Priority:                       6                  648

     Unicast High Priority:                      9                  630

     Multicast Low Priority:                     3                  144

     Multicast High Priority:                  174               767913

 Host Transmit                             Packets                Bytes

     Unicast Low Priority:                       4                  480

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                    0                    0

 Total Transmit                            Packets                Bytes

     Unicast Low Priority:                       4                  480

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                  772              1575090

 Traffic Rate (5 Minutes)              packets/sec             bits/sec

     Transit Low Priority                        0                    0

     Transit High Priority                       0                    0

     Transit Multicast                           0                    0

     Transit Unicast                             0                    0

     Host Receive                                0                    0

     Total Receive                               0                    0

     Host Transmit                               0                    0

     Total Transmit                              0                    0

 Received Errors:

     0 input errors, 0 CRC, 0 ignored,

     0 framer runts, 0 framer giants, 0 framer aborts,

     0 mac runts, 0 mac giants, 0 mac ttl strips


 Side B:

 Transit                                   Packets                Bytes

     Total Low Priority:                         0                    0

     Total High Priority:                      772              1575090

     Total Multicast:                          772              1575090

     Total Unicast:                              0                    0

 Host Receive                              Packets                Bytes

     Unicast Low Priority:                       6                  648

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                    1                   41

 Total Receive                             Packets                Bytes

     Unicast Low Priority:                       6                  648

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     0                    0

     Multicast High Priority:                  772              1575090

 Host Transmit                             Packets                Bytes

     Unicast Low Priority:                       6                  720

     Unicast High Priority:                      0                    0

     Multicast Low Priority:                     3                  144

     Multicast High Priority:                    0                    0

 Total Transmit                            Packets                Bytes

     Unicast Low Priority:                       6                  720

     Unicast High Priority:                      9                  630

     Multicast Low Priority:                     3                  144

     Multicast High Priority:                  174               767913

 Traffic Rate (5 Minutes)              packets/sec             bits/sec

     Transit Low Priority                        0                    0

     Transit High Priority                       0                    0

     Transit Multicast                           0                    0

     Transit Unicast                             0                    0

     Host Receive                                0                    0

     Total Receive                               0                    0

     Host Transmit                               0                    0

     Total Transmit                              0                    0

 Received Errors:

     0 input errors, 0 CRC, 0 ignored,

     0 framer runts, 0 framer giants, 0 framer aborts,

     0 mac runts, 0 mac giants, 0 mac ttl strips

Table 30 describes the significant fields shown in the display.

Table 30 show srp counters Command Output Fields 

Field
Description

Side A

Header for packets received, transmitted, and transited by the Resource Availability Confirmation (RAC) device on side A.

Side B

Header for packets received, transmitted, and transited by the RAC device on side B.

Transit
Total Low Priority

Total number of unicast and multicast packets marked as SRP low priority (based on the SRP priority mapping) that transit the router and are counted in the transmit low-priority counters.

Transit
Total High Priority

Total number of unicast and multicast packets marked as SRP high priority (based on the SRP priority mapping) that transit the router and are counted in the transmit high-priority counters.

Transit
Total Multicast

Total number of low- and high-priority multicast packets that transit the router and are counted in the transmit multicast counters.

Transit
Total Unicast

Total number of low- and high-priority unicast packets that transit the router and are counted in the transmit unicast counters.

Host Receive
Unicast Low/High priority

Total number of low- and high-priority unicast packets received by the router.

Host Receive
Multicast Low/High priority

Total number of low- and high-priority multicast packets received by the router.

Total Receive
Unicast Low/High priority

Total number of low- and high-priority unicast packets that transit or are received by the router.

Total Receive
Multicast Low/High priority

Total number of low- and high-priority multicast packets that transit or are received by the router.

Host Transmit
Unicast Low/High priority

Total number of low- and high-priority unicast packets sourced onto the ring by the router.

Host Transmit
Multicast Low/High priority

Total number of low- and high-priority multicast packets sourced onto the ring by the router.

Total Transmit
Unicast Low/High priority

Total number of low- and high-priority unicast packets transmitted by this side and transited out of the other side of the node.

Total Transmit
Multicast Low/High priority

Total number of low- and high-priority multicast packets transmitted by this side and transited out of the other side of the node.

Traffic Rate (5 Minutes)

Average number of packets and bits transmitted per second during the last 5 minutes.

The 5-minute traffic rates should be used only as an approximation of traffic per second during a given 5-minute period. These rates are exponentially weighted averages with a time constant of 5 minutes. A period of four time constants must pass before the average will be within two percent of the instantaneous rate of a uniform stream of traffic over that period.

The 5-minute value is the load interval, and it is configurable using the load-interval command.

input errors

Total number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and abort counts. Other input-related errors can also increment the count, so that this sum might not balance with the other counts.

CRC

Cyclic redundancy checksum generated by the originating LAN station or far-end device does not match the checksum calculated from the data received. On a LAN, this usually indicates noise or transmission problems on the LAN interface or the LAN bus itself. A high number of CRCs is usually the result of a station transmitting bad data.

ignored

Number of received packets ignored by the interface because the interface hardware ran low on internal buffers. These buffers are different than the system buffers mentioned previously in the buffer description. Broadcast storms and bursts of noise can cause the ignored count to be increased.

framer runts

Number of packets dropped by the framer as runts, that are smaller than 16 bytes.

framer giants

Number of packets dropped by the framer as giants, whose size is greater than the MTU.

framer aborts

Number of packets dropped by the framer due to an error in packet insertion from the SONET frame. Normally a framer abort is caused by a delimiter inserted at the transmit framer that forces the receive framer to drop the packet on reception because it is bad. The delimiter is inserted by the transmit framer when it cannot transmit a packet due to a transmission error. A runt or CRC error may also result. A framer abort can be caused by any of the following:

•A bad transmit framer at the neighbor node (upstream)

•BIP errors in the SONET frame that cause a false abort delimiter (often due to intermediate equipment failure or clocking issues)

•A bad receive framer at this node

mac runts

Packets dropped by the MAC controller as runts, that are smaller than 24 bytes.

mac giants

Packets dropped by the MAC controller as giants, whose size is greater than the MTU.

mac ttl strips

Packets stripped by the MAC controller when the SRP Time to Live value expires. (TTL value is 1 when a packet arrives.) These packets are removed from the ring because the TTL value cannot be decreased. As a result, the packet is dropped if it is not destined for the node that strips it.


show srp failures Sample Output

In the following example, self-detected failures in the SRP interface configured on slot 7, subslot 0, and port 0 are displayed: 

RP/0/RP0/CPU0:Router# show srp failures 


 Self Detected Failures Information for Interface SRP0/7/0/0

 Side A:

                 Reported  Debounced  Current  Stable    Debounce

                 state     state      state    for(sec)  delay(sec)

HW missing       IDLE      IDLE       IDLE     778       0       

L1 Admin State   IDLE      IDLE       IDLE     777       0       

Layer 1          IDLE      IDLE       IDLE     778       0       

MAC Keepalive    IDLE      IDLE       IDLE     477       5       

Link quality     IDLE      IDLE       IDLE     778       0       

Mate interface   IDLE      IDLE       IDLE     778       10      

Side mismatch    IDLE      IDLE       IDLE     477       5       

Result Self Detect = IDLE


 Side B:

                 Reported  Debounced  Current  Stable    Debounce

                 state     state      state    for(sec)  delay(sec)

HW missing       IDLE      IDLE       IDLE     778       0       

L1 Admin State   IDLE      IDLE       IDLE     775       0       

Layer 1          IDLE      IDLE       IDLE     778       0       

MAC Keepalive    IDLE      IDLE       IDLE     477       5       

Link quality     IDLE      IDLE       IDLE     778       0       

Mate interface   IDLE      IDLE       IDLE     778       10      

Side mismatch    IDLE      IDLE       IDLE     477       5       

Result Self Detect = IDLE

Table 31 describes the significant fields shown in the display.

Table 31 show srp failures Command Output Fields 

Field
Description

HW missing

Presence of this side's hardware port. Possible states:
IDLE—No error or failure
SF—Port is not installed or is still booting

L1 Admin State

Layer 1 administrative state. Possible states:
IDLE—SONET controller is configured as up
FS—SONET controller is configured as administratively down

Note This is the only field in which the status is related to a user-configurable state.

Layer 1

Operating state of the SONET controller. Possible states:
IDLE—No alarms, etc.
SF—Some alarms, such as section loss of signal (SLOS), section loss of frame (SLOF), or line alarm indicator signal (LAIS)

Note For detailed information about a Layer 1 failure, use the show controllers sonet command.

MAC keepalive

The MAC keepalive timer has expired.

Link quality

The SONET B3 bit error rate (BER) threshold has been crossed.

Mate interface

The external mate cable on a line card interface is missing or malfunctioning.

Note This is only applicable to one-port PLIMs or SPAs that would require a second PLIM or SPA to create an SRP interface.

Side mismatch

Side A of the node is connected to side A of the neighbor node, or side B of the node is connected to side B of the neighbor node.

Result Self Detect

IPS state requested for this side. The state will be the highest IPS request listed under "Reported state."

Reported state

State that is reported to the IPS engine.

Debounced state

Current SF/FS state or the current IDLE state if IDLE has been stable for the amount of time of the debounce delay.

Current state

Current state as reported by the source.

Stable for (sec)

Amount of time the current state has been stable.

Debounce delay (sec)

Amount of time to wait when transitioning from SF to IDLE. The IDLE state must be stable for this amount of time before getting debounced or reported. This is to prevent flapping and is similar to higher-level WTR values.


show srp interface Sample Output

In the following example, the display from the show srp command with the interface keyword is shown: 

RP/0/RP0/CPU0:Router# show srp interface srp 0/5/0/0 


IPS Information for Interface SRP0/5/0/0

 MAC Addresses

   Side A (Outer ring RX) neighbor 0009.11d8.3c66

   Side B (Inner ring RX) neighbor 0012.da6a.f664

   Node MAC address 0800.453d.8644

 IPS State

   Side A not wrapped

   Side B not wrapped

   Side A (Inner ring TX) IPS pkt. sent every 1 sec. (next pkt. after 1 sec.)

   Side B (Outer ring TX) IPS pkt. sent every 1 sec. (next pkt. after 1 sec.)

   inter card bus disabled

   IPS WTR period is 60 sec. (timer is inactive)

   Node IPS State: idle

 IPS Self Detected Requests           IPS Remote Requests

   Side A IDLE                          Side A IDLE

   Side B IDLE                          Side B IDLE

   Side A Failures: none

   Side B Failures: none

 IPS messages received

   Side A (Outer ring RX) { 0009.11d8.3c66,IDLE,SHORT}, TTL 255

   Side B (Inner ring RX) { 0012.da6a.f664,IDLE,SHORT}, TTL 255

 IPS messages transmitted

   Side A (Inner ring TX) { 0800.453d.8644,IDLE,SHORT}, TTL 255

   Side B (Outer ring TX) { 0800.453d.8644,IDLE,SHORT}, TTL 255

 IPS delay trigger keepalive

   Side A: 0 milliseconds

   Side B: 0 milliseconds


 Topology Map for Interface: SRP0/5/0/0

  Topology pkt. sent every 5 sec.  (next pkt. after 1 sec.)

  Last received topology pkt. 00:00:05

  Last topology change was 00:01:59 ago.

  Nodes on the ring: 3

  Hops (outer ring)      MAC       IP Address      Wrapped SRR   Name

         0          0800.453d.8644 0.0.0.0           No      -   ios

         1          0012.da6a.f664 0.0.0.0           No      -   gsrd

         2          0009.11d8.3c66 0.0.0.0           No      -   gsre


 SRR not enabled for Interface SRP0/5/0/0


 Rate Limit Information for Interface SRP0/5/0/0

   Minimum SRP priority value of high priority outgoing/transit traffic: 2

Fields from the show srp command output with the interface keyword are described in Table 32 and Table 33. The minimum SRP priority value for high-priority traffic is set to 2 by default.

show srp ips Sample Output

The following example shows the display from the show srp command with the ips keyword: 

RP/0/RP0/CPU0:Router# show srp ips 


 IPS Information for Interface SRP0/7/0/0

 MAC Addresses

   Side A (Outer ring RX) neighbor 000e.3900.4800

   Side B (Inner ring RX) neighbor 000a.8b08.9600

   Node MAC address 0800.453c.f882

 IPS State

   Side A not wrapped

   Side B not wrapped

   Side A (Inner ring TX) IPS pkt. sent every 1 sec. (next pkt. after 1 sec.)

   Side B (Outer ring TX) IPS pkt. sent every 1 sec. (next pkt. after 1 sec.)

   inter card bus disabled

   IPS WTR period is 60 sec. (timer is inactive)

   Node IPS State: idle

 IPS Self Detected Requests           IPS Remote Requests

   Side A IDLE                          Side A IDLE

   Side B IDLE                          Side B IDLE

   Side A Failures: none

   Side B Failures: none

 IPS messages received

   Side A (Outer ring RX) { 000e.3900.4800,IDLE,SHORT}, TTL 255

   Side B (Inner ring RX) { 000a.8b08.9600,IDLE,SHORT}, TTL 255

 IPS messages transmitted

   Side A (Inner ring TX) { 0800.453c.f882,IDLE,SHORT}, TTL 255

   Side B (Outer ring TX) { 0800.453c.f882,IDLE,SHORT}, TTL 255

 IPS delay trigger keepalive

   Side A: 0 milliseconds

   Side B: 0 milliseconds

Table 32 describes the significant fields shown in the display.

Table 32 show srp ips Command Output Fields 

Field
Description

IPS Information for Interface

IPS (Intelligent Protection Switching) identifies the status of an SRP interface on the SRP ring.

MAC Addresses
Side A (Outer ring RX) neighbor

MAC address of the next SRP node on the outer ring.

MAC Addresses
Side B (Inner ring RX) neighbor

MAC address of the next SRP node on the inner ring.

Node MAC address

MAC address of this SRP node.

IPS State

Reports whether or not a wrap exists on side A or side B of the SRP ring.

IPS WTR period is 60 seconds (timer is inactive)

Displays the current WTR (Wait to Restore) timer value. If a timer is active, the time remaining before the timer expires also is given.

Node IPS State IDLE

Displays the current IPS state of the node. IDLE is the normal state. Other states are WRAPPED and UNKNOWN. Unknown means that the node is in pass-through mode.

IPS self-detected requests

Indicates any locally generated requests. Displays local IPS requests, as well as IDLE status. Possible requests include the following:
FS — Forced Switch
SF — Signal Fail
SD — Signal Degrade
MS — Manual Switch
WTR — Wait to Restore

IPS remote requests

Indicates any remotely generated requests. Displays remote IPS requests, as well as IDLE status. Possible requests include the following:
FS — Forced Switch
SF — Signal Fail
SD — Signal Degrade
MS — Manual Switch
WTR — Wait to Restore

IPS messages received

Provides details of the last IPS messages received. Fields within the braces ({}) are the MAC addresses of the sending node and the IPS state (IDLE, FS, and so on). It also indicates either a short or long path.

IPS messages transmitted

Provides details of the last IPS messages transmitted, in the format used for received messages.

IPS delay trigger keepalive

Configured value of the srp ips delay trigger-keepalive command. The default value is 0.


show srp topology Sample Output

The following example shows the display from the show srp command with the topology keyword: 

RP/0/RP0/CPU0:Router# show srp topology 


 Topology Map for Interface SRP0/7/0/0

  Topology pkt. sent every 5 sec.  (next pkt. after 5 sec.)

  Last received topology pkt. 00:00:01

  Last topology change was 00:09:44 ago.

  Nodes on the ring: 3

  Hops (outer ring)      MAC       IP Address      Wrapped SRR   Name

         0          0800.453c.f882 30.30.30.2        No      -   crs1

         1          000a.8b08.9600 30.30.30.1        No      -   gsra

         2          000e.3900.4800 30.30.30.3        No      -   gsrb

Table 33 describes the significant fields shown in the display.

Table 33 show srp topology Command Output Fields 

Field
Description

Topology map for interface

Displays SRP topology information that identifies the SRP interface.

Topology packet sent every 10 seconds (next packet after 5 seconds)

Displays the interval between successive topology packets sent from this node and the time until the next one is to be sent (rounded down to the nearest second).

Last received topology packet 00:00:04

Displays the time since the last topology packet was received at this node.

Nodes on the ring: 4

Displays the number of nodes in the current ring topology.

Hops

Displays the number of hops to the destination node along the outer ring (from side B). The local node is at hop count zero.

MAC

Displays the MAC address of the node.

IP Address

Displays the IP address of the SRP interface on the node. If the address is not known, the text string "unknown" is displayed.

The IP address information is gathered by the ARP table. When a ring is first established, it is normal for the IP address of a node to remain unknown until some time after the MAC address is known.

Wrapped

Uses Yes or No to indicates whether the SRP ring is wrapped at that node.

SRR

Indicates whether SRR is enabled on the node.

Name

Displays the hostname of the router. If the name is not known, this field is left blank.

The hostname is obtained from information that is broadcast on the ring at a slower rate than other topology information. When a ring is first established, it is normal for the hostname of a remote node to remain unknown until some time after the MAC address is known.


show srp transit Sample Output

The following example shows the display from the show srp command with the transit keyword: 

RP/0/RP0/CPU0:Router# show srp transit interface srp 0/7/0/0 


 Transit Buffer Delay Counters for Interface SRP0/7/0/0

   Side A:

   Transit Delay (5 Minutes)             Nanoseconds

     Low TB Min Delay:                             0

     Low TB Avg Delay:                             0

     Low TB Max Delay:                             0

     High TB Min Delay:                          569

     High TB Avg Delay:                          569

     High TB Max Delay:                          570


   Side B:

   Transit Delay (5 Minutes)             Nanoseconds

     Low TB Min Delay:                             0

     Low TB Avg Delay:                             0

     Low TB Max Delay:                             0

     High TB Min Delay:                           15

     High TB Avg Delay:                          261

     High TB Max Delay:                          574

Table 34 describes the significant fields shown in the display.

Table 34 show srp transit Command Output Fields 

Field
Description

Low TB Min Delay

Minimum value for the low transit buffer as calculated over the last load interval.

Low TB Avg Delay

Average value for the low transit buffer as calculated over the last load interval.

Low TB Max Delay

Maximum value for the low transit buffer as calculated over the last load interval.

High TB Min Delay

Minimum value for the high transit buffer as calculated over the last load interval.

High TB Avg Delay

Average value for the high transit buffer as calculated over the last load interval.

High TB Max Delay

Maximum value for the high transit buffer as calculated over the last load interval.


Related Commands

Command
Description

clear srp counters

Clears the various SRP packet counters.

load-interval

Sets the time (in seconds) used to gather data for computing load statistics.

show controllers sonet

Displays the SONET controller information for the interface.

show controllers srp

Displays the current controller configuration on an SRP interface.

show interfaces srp

Displays current IPS wrap state, along with other SRP interface information.


srp ips delay trigger-keepalive

To specify a delay for the IPS keepalive value, use the srp ips delay keep-alive command in interface configuration mode. To restore the default value, use the no form of this command.

srp ips delay trigger-keepalive value {a | b}

no srp ips delay trigger-keepalive value {a | b}

Syntax Description

value

Time in milliseconds of the trigger keepalive. Values can range from 51 to 200.

a

The side of a node that has outer ring receive fiber is identified as side A.

b

The side of a node that has inner ring receive fiber is identified as side B.


Defaults

The default IPS keepalive delay value is 0.

Command Modes

Interface configuration

Command History

Release
Modification

Release 3.2.2

This command was introduced on the Cisco CRS-1 and is supported only on the 4-port OC-192c/STM-64c POS/DPT PLIM.

Release 3.4.0

This command was first supported on the 16-port OC-48c/STM-16c POS/DPT PLIM.

Release 3.5.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.

The default keepalive value is 1 ms. Use the srp ips delay trigger-keepalive command to delay this 1 ms up to the configured delay value. You should use this command only if the Layer 1 (SONET) is already protected (for example, with SONET APS). This delay gives the first protection mechanism time to protect, before the Layer 2 protection is enabled. For example, if an SRP side is connected to an Add-Drop Multiplexer (ADM) that utilizes dual SONET ring and APS, you should delay the Layer 2 keepalive value using this command.

Task ID

Task ID
Operations

pos-dpt

read, write


Examples

The following example indicates how to set the trigger keepalive timer to 60 milliseconds: 

RP/0/RP0/CPU0:Router# config

RP/0/RP0/CPU0:Router(config)# interface srp 0/5/0/0

RP/0/RP0/CPU0:Router(config-if)# srp ips delay trigger-keepalive 60 a

Related Commands

Command
Description

show srp

Displays information about SRP interfaces on the ring, including MAC addresses of neighboring nodes, IPS status, source-counters, and topology map.


srp ips request forced-switch

To initiate a forced-switch wrap on a ring, use the srp ips request forced-switch command in interface configuration mode. To remove the wrap, use the no form of this command.

srp ips request forced-switch {a | b}

no srp ips request forced-switch {a | b}

Syntax Description

a

The side of a node that has outer ring receive fiber is identified as side A.

b

The side of a node that has inner ring receive fiber is identified as side B.


Defaults

No default behavior or values

Command Modes

Interface configuration

Command History

Release
Modification

Release 3.2.2

This command was introduced on the Cisco CRS-1 and is supported only on the 4-port OC-192c/STM-64c POS/DPT PLIM.

Release 3.4.0

This command was first supported on the 16-port OC-48c/STM-16c POS/DPT PLIM.

Release 3.5.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.

Task ID

Task ID
Operations

pos-dpt

read, write


Examples

The following example shows how to insert a forced-switch wrap on side A of the interface by entering the srp ips request forced-switch command: 

RP/0/RP0/CPU0:Router# configure

RP/0/RP0/CPU0:Router(config)# interface srp 0/5/0/0

RP/0/RP0/CPU0:Router(config-if)# srp ips request forced-switch a

Related Commands

Command
Description

show interfaces srp

Displays current IPS wrap state, along with other SRP interface information.

show srp

Displays information about SRP interfaces on the ring, including MAC addresses of neighboring nodes, IPS status, source-counters, and topology map.

srp ips wtr-timer

Determines how long a wrap remains on the fiber after the original cause of the wrap is removed.

srp manual-switch

Inserts a manual-switch wrap on the ring.

srp shutdown

Provides an alternative form of the srp ips request forced-switch command.


srp ips timer

To control the frequency of the transmission of Intelligent Protection Switching (IPS) requests, use the srp ips timer command in interface configuration mode. To restore the default value, use the no form of this command.

srp ips timer value

no srp ips timer value

Syntax Description

value

Amount of time in seconds between transmission of IPS requests. Values can range from 1 to 60.


Defaults

The default IPS timer value is 1 second.

Command Modes

Interface configuration

Command History

Release
Modification

Release 3.2.2

This command was introduced on the Cisco CRS-1 and is supported only on the 4-port OC-192c/STM-64c POS/DPT PLIM.

Release 3.4.0

This command was first supported on the 16-port OC-48c/STM-16c POS/DPT PLIM.

Release 3.5.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.

In general, you should not need to adjust the IPS timer value.

We recommend that you configure the same IPS timer value on all nodes on an SRP ring. This means that if you modify the IPS timer setting on one node, you must reconfigure all other nodes on the ring with the same IPS timer value.

Task ID

Task ID
Operations

pos-dpt

read, write


Examples

The following example indicates how to change the IPS timer to 30 seconds: 

RP/0/RP0/CPU0:Router# config

RP/0/RP0/CPU0:Router(config)# interface srp 0/5/0/0

RP/0/RP0/CPU0:Router(config-if)# srp ips timer 30

Related Commands

Command
Description

show srp

Displays information about SRP interfaces on the ring, including MAC addresses of neighboring nodes, IPS status, source-counters, and topology map.

srp ips wtr-timer

Determines how long a wrap remains on the fiber after the original cause of the wrap is removed.


srp ips wtr-timer

To control the amount of time to wait before a wrap is removed after there is no more reason for the wrap, use the srp ips wtr-timer command in interface configuration mode. To restore the default value, use the no form of this command.

srp ips wtr-timer value

no srp ips wtr-timer value

Syntax Description

value

Amount of time in seconds for the wait-to-restore (WTR) timer. Values can range from 10 to 600.


Defaults

The default WTR timer value is 60 seconds.

Command Modes

Interface configuration

Command History

Release
Modification

Release 3.2.2

This command was introduced on the Cisco CRS-1 and is supported only on the 4-port OC-192c/STM-64c POS/DPT PLIM.

Release 3.4.0

This command was first supported on the 16-port OC-48c/STM-16c POS/DPT PLIM.

Release 3.5.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.

In general, you should not need to adjust the Intelligent Protection Switching (IPS) wait-to-restore (WTR) timer value.

Task ID

Task ID
Operations

pos-dpt

read, write


Examples

The following example indicates how to change the IPS wait-to-restore timer to 120 seconds: 

RP/0/RP0/CPU0:Router# config

RP/0/RP0/CPU0:Router(config)# interface srp 0/5/0/0

RP/0/RP0/CPU0:Router(config-if)# srp ips wtr-timer 120

Related Commands

Command
Description

show srp

Displays information about SRP interfaces on the ring, including MAC addresses of neighboring nodes, IPS status, source-counters, and topology map.

srp ips timer

Controls the frequency of the transmission of SRP IPS packets.


srp mac-count

To keep track of the number of SRP packets from a specific source MAC address, use the srp mac-count command in interface configuration mode. To disable counting by MAC address, use the no form of this command.

srp mac-count mac-address

no srp mac-count mac-address

Syntax Description

mac-address

48-bit source MAC address from which to count SRP packets.


Defaults

The srp mac-count command is disabled by default.

Command Modes

Interface configuration

Command History

Release
Modification

Release 3.2.2

This command was introduced on the Cisco CRS-1 and is supported only on the 4-port OC-192c/STM-64c POS/DPT PLIM.

Release 3.4.0

This command was first supported on the 16-port OC-48c/STM-16c POS/DPT PLIM.

Release 3.5.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.

Task ID

Task ID
Operations

pos-dpt

read, write


Examples

The following example shows how to count SRP packets from the source with MAC address 2.2.2: 

RP/0/RP0/CPU0:Router# config

RP/0/RP0/CPU0:Router(config)# interface srp 0/5/0/0

RP/0/RP0/CPU0:Router(config-if)# srp mac-count 2.2.2

Related Commands

Command
Description

clear srp counters

Clears the various SRP packet counters.

show srp

Displays information about SRP interfaces on the ring, including MAC addresses of neighboring nodes, IPS status, source-counters, and topology map.


srp mac-reject

To reject SRP packets from a specific source MAC address, use the srp mac-reject command in interface configuration mode. To disable rejection by MAC address, use the no form of this command.

srp mac-reject mac-address

no srp mac-reject mac-address

Syntax Description

mac-address

48-bit source MAC address from which to reject SRP packets.


Defaults

The srp mac-reject command is disabled by default.

Command Modes

Interface configuration

Command History

Release
Modification

Release 3.2.2

This command was introduced on the Cisco CRS-1 and is supported on the 4-port OC-192c/STM-64c POS/DPT PLIM.

Release 3.4.0

This command was first supported on the 16-port OC-48c/STM-16c POS/DPT PLIM.

Release 3.5.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.

Use srp mac-reject command to control a node that cannot be fixed because it is owned or administered by someone else. For example, if such a node is flooding your node with packets, you can use this command to limit the amount of traffic that is processed.

Task ID

Task ID
Operations

pos-dpt

read, write


Examples

The following example shows how to reject SRP packets from the source with MAC address 2.2.2: 

RP/0/RP0/CPU0:Router# config

RP/0/RP0/CPU0:Router(config)# interface srp 0/5/0/0

RP/0/RP0/CPU0:Router(config-if)# srp mac-reject 2.2.2

Related Commands

Command
Description

clear srp counters

Clears the various SRP packet counters.

show srp

Displays information about SRP interfaces on the ring, including MAC addresses of neighboring nodes, IPS status, source-counters, and topology map.


srp manual-switch

To initiate or remove a manual switch wrap on a ring, use the srp manual-switch command in EXEC mode.

srp {request | remove} manual-switch {a | b} interface srp instance

Syntax Description

request

Initiate a manual switch wrap on the interface.

remove

Remove a manual switch wrap on the interface.

a

The side of a node that has outer ring receive fiber is identified as side A.

b

The side of a node that has inner ring receive fiber is identified as side B.

interface

Specifies the interface for which to display the counters.

srp

Specifies an SRP interface.

instance

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 modular services card or 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. An SRP interface is comprised of two consecutive physical ports and is named according to the first, lower-numbered port. For example, the SRP interface 0/4/0/2 is comprised of the two physical ports 0/4/0/2 and 0/4/0/3.

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


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2.2

This command was introduced on the Cisco CRS-1 and is supported only on the 4-port OC-192c/STM-64c POS/DPT PLIM.

Release 3.4.0

This command was first supported on the 16-port OC-48c/STM-16c POS/DPT PLIM.

Release 3.5.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.

Task ID

Task ID
Operations

pos-dpt

read, write


Examples

The following example shows how to insert a manual switch wrap on side A of the interface: 

RP/0/RP0/CPU0:Router# srp request manual-switch a interface srp 0/5/0/0

Related Commands

Command
Description

show interfaces srp

Displays current IPS wrap state, along with other SRP interface information.

show srp

Displays information about SRP interfaces on the ring, including MAC addresses of neighboring nodes, IPS status, source-counters, and topology map.

srp ips request forced-switch

Inserts a forced switch wrap on the ring; this command is an alternate form of the srp shutdown command.

srp ips wtr-timer

Determines how long a wrap remains on the fiber after the original cause of the wrap is removed.

srp shutdown

Provides an alternative form of the srp ips request forced-switch command.


srp shutdown

To shut down an interface by entering a forced switch, use the srp shutdown command in interface configuration mode. To remove the forced switch wrap near the interface, use the no form of this command.

srp shutdown

no srp shutdown

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

Interface configuration

Command History

Release
Modification

Release 3.2.2

This command was introduced on the Cisco CRS-1 and is supported only on the 4-port OC-192c/STM-64c POS/DPT PLIM.

Release 3.4.0

This command was first supported on the 16-port OC-48c/STM-16c POS/DPT PLIM.

Release 3.5.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.

Task ID

Task ID
Operations

pos-dpt

read, write


Examples

The following example shows how to enter a forced switch on the interface: 

RP/0/RP0/CPU0:Router# config

RP/0/RP0/CPU0:Router(config)# interface srp 0/5/0/0

RP/0/RP0/CPU0:Router(config-if)# srp shutdown

Related Commands

Command
Description

show interfaces srp

Displays current IPS wrap state along with other SRP interface information.

show srp

Displays information about SRP interfaces on the ring, including MAC addresses of neighboring nodes, IPS status, source-counters, and topology map.

srp ips request forced-switch

Inserts a forced switch wrap on the ring; this command is an alternate form of the srp shutdown command.


srp topology-timer

To specify the frequency of the topology timer, use the srp topology-timer command in interface configuration mode. To restore the default value, use the no form of this command.

srp topology-timer value

no srp topology-timer value

Syntax Description

value

Value of topology timer in seconds, ranging from 1 to 600.


Defaults

The default topology timer value is 10 seconds.

Command Modes

Interface configuration

Command History

Release
Modification

Release 3.2.2

This command was introduced on the Cisco CRS-1 and is supported only on the 4-port OC-192c/STM-64c POS/DPT PLIM.

Release 3.4.0

This command was first supported on the 16-port OC-48c/STM-16c POS/DPT PLIM.

Release 3.5.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.

The srp topology-timer interface configuration command determines how frequently topology discovery messages are sent around the ring to identify the current nodes on the SRP ring.

In general, you should not need to adjust the topology timer value.

Task ID

Task ID
Operations

pos-dpt

read, write


Examples

The following example indicates how to change the topology timer to 300 seconds: 

RP/0/RP0/CPU0:Router# config

RP/0/RP0/CPU0:Router(config)# interface srp 0/5/0/0

RP/0/RP0/CPU0:Router(config-if)# srp topology-timer 1

Related Commands

Command
Description

show srp

Displays information about SRP interfaces on the ring, including MAC addresses of neighboring nodes, IPS status, source-counters, and topology map.