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.81MB) | Feedback

Implementing RCMD

This module describes how to implement RCMD.

Feature History for Implementing RCMD

Release

Modification

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:

SUMMARY STEPS

    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


DETAILED STEPS
      Command or Action Purpose
    Step 1 configure


    Example:
    RP/0/0/CPU0:router# configure
     

    Enters global configuration mode.

     
    Step 2 router-convergence


    Example:
    RP/0/0/CPU0:router(config)#router-convergence
     

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

     
    Step 3 collect-diagnostics location


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

    Configures to collect diagnostics on specified node.

     
    Step 4 event-buffer-size number


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

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

     
    Step 5 max-events-stored number


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

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

     
    Step 6 monitoring-interval minutes


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

    Sets interval (in minutes) to collect logs.

     
    Step 7 node node-name
     

    Configures parameters for a specified node.

    RP/0/0/CPU0:router(config-rcmd)#node
     
    Step 8 protocol


    Example:
    RP/0/0/CPU0:router(config-rcmd)#protocol ISIS 
    RP/0/0/CPU0:router(config-rcmd-proto)#
     
    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 9 priority


    Example:
    RP/0/0/CPU0:router(config-rcmd-proto)#priority critical 
    RP/0/0/CPU0:router(config-rcmd-proto-prio)#
     
    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 10 disable


    Example:
    RP/0/0/CPU0:router(config-rcmd-proto-prio)#disable 
     

    Disables the monitoring of route convergence for specified priority.

     
    Step 11 leaf-network number


    Example:
    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 12 threshold value


    Example:
    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 13 storage-location


    Example:
    RP/0/0/CPU0:router(config-rcmd)#storage-location 
    RP/0/0/CPU0:router(config-rcmd-store)#
     

    Sets the absolute directory path for storing diagnostic reports.

     
    Step 14 diagnostics directory-path-name


    Example:
    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 15 diagnostics-size


    Example:
    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 16 reports directory-path-name


    Example:
    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 17 reports-size


    Example:
    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%.