Cisco IOS XR Routing Configuration Guide for the Cisco XR 12000 Series Router, Release 4.2.x
Implementing RCMD
Downloads: This chapterpdf (PDF - 1.23MB) The complete bookPDF (PDF - 7.33MB) | Feedback

Implementing RCMD

Implementing RCMD

This module describes how to implement RCMD.

Feature History for Implementing RCMD



Release 4.2.0

This feature was introduced.

Route Convergence Monitoring and Diagnostics

Route Convergence Monitoring and Diagnostics (RCMD) is a mechanism to monitor OSPF and ISIS convergence events, gather details about the SPF runs and time taken to provision routes and LDP labels across all LCs on the router.

RCMD is a tool that collects and reports data related to routing convergence. Highlights of the RCMD mechanism are:

  • Lightweight and always-on using route flow markers across routing components (all nodes & MC).
  • Tracks most convergence events and all routes affected by them.
  • Provides within-router view with statistics and time-lines on per convergence event basis.
  • Measurements against time-line/SLA and triggers specified EEM actions on excess.
  • 'On the router' reports via CLI/XML interface.
  • Each RCMD enabled router provides a digest of convergence data.

The events that are monitored and reported by RCMD are:

  • OSPF and IS-IS SPF events (default VRF only).
  • Add/delete of specific external or inter-area/level prefixes.
  • IGP flooding propagation delays for LSA/LSP changes.

RCMD runs in two modes:

  • Monitoring—detecting events and measuring convergence.
  • Diagnostics—additional (debug) information collection for 'abnormal' events.

Configuring Route Convergence Monitoring and Diagnostics

Perform these tasks to configure route convergence monitoring and diagnostics:


    1.    configure

    2.    router-convergence

    3.    collect-diagnostics location

    4.    event-buffer-size number

    5.    max-events-stored number

    6.    monitoring-interval minutes

    7.    node node-name

    8.    protocol

    9.    priority

    10.    disable

    11.    leaf-network number

    12.    threshold value

    13.    storage-location

    14.    diagnostics directory-path-name

    15.    diagnostics-size

    16.    reports directory-path-name

    17.    reports-size

     Command or ActionPurpose
    Step 1 configure

    RP/0/0/CPU0:router# configure

    Enters global configuration mode.

    Step 2router-convergence


    Enters configure Router Convergence Monitoring and Diagnostics (rcmd) configuration mode.

    Step 3collect-diagnostics location

    RP/0/0/CPU0:router(config-rcmd)#collect-diagnostics 0/3/CPU0

    Configures to collect diagnostics on specified node.

    Step 4event-buffer-size number

    RP/0/0/CPU0:router(config-rcmd)#event-buffer-size 100

    Sets event buffer size 9as number of events) for storing event traces .

    Step 5max-events-stored number

    RP/0/0/CPU0:router(config-rcmd)#max-events-stored 10

    Sets maximum number of events to be stored in the server.

    Step 6monitoring-interval minutes

    RP/0/0/CPU0:router(config-rcmd)#monitoring-interval 120

    Sets interval (in minutes) to collect logs.

    Step 7node node-name

    Configures parameters for a specified node.

    Step 8protocol

    RP/0/0/CPU0:router(config-rcmd)#protocol ISIS 
    Specifies the protocol for which to configure RCMD parameters.
    • ISIS-Select ISIS to configure parameters related to ISIS protocol
    • OSPF-Select OSPF to configure parameters related OSPF protocol
    Step 9priority

    RP/0/0/CPU0:router(config-rcmd-proto)#priority critical 
    Sets priority for monitoring of route convergence for the specified protocol.
    • Critical-Set to monitor route convergence for critical priority routes
    • High-Set to monitor route convergence for high priority routes
    • Medium-Set to monitor route convergence for medium priority routes
    • Low-Set to monitor route convergence for low priority routes
    Step 10disable


    Disables the monitoring of route convergence for specified priority.

    Step 11leaf-network number

    RP/0/0/CPU0:router(config-rcmd-proto-prio)#leaf-network 100

    Enables leaf network monitoring. Specify a maximum number of leaf networks to be monitored. Range for maximum number is 10-100.

    Step 12threshold value

    RP/0/0/CPU0:router(config-rcmd-proto-prio)#threshold 1000

    Specifies threshold value for convergence in milliseconds. Select a threshold value from the range. Range is 0-4294967295 milliseconds

    Step 13storage-location


    Sets the absolute directory path for storing diagnostic reports.

    Step 14diagnostics directory-path-name

    RP/0/0/CPU0:router(config-rcmd-store)#diagnostics /disk0:/rcmd

    Specifies the absolute directory path for storing diagnostic reports. Set a directory-path-name. Example: /disk0:/rcmd/ or <tftp-location>/rcmd/


    Step 15diagnostics-size

    RP/0/0/CPU0:router(config-rcmd-store)# diagnostics-size 8

    Specify a maximum size for the diagnostics directory. Set the size in %. Range is 5%-80%.

    Step 16reports directory-path-name

    RP/0/0/CPU0:router(config-rcmd-store)#reports /disck0:/rcmd

    Specifies the absolute directory path for storing reports. Set a directory-path-name. Example: /disk0:/rcmd/ or <tftp-location>/rcmd/

    Step 17reports-size

    RP/0/0/CPU0:router(config-rcmd-store)#reports-size 8

    Specify a maximum size for the reports directory. Set the size in %. Range is 5%-80%.