Cisco ASR 9000 Series Aggregation Services Router Routing Configuration Guide, Release 5.1.x
Implementing RCMD
Downloads: This chapterpdf (PDF - 1.27MB) The complete bookPDF (PDF - 7.59MB) | Feedback

Implementing RCMD

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 ActionPurpose
    Step 1 configure


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

    Enters global configuration mode.

     
    Step 2router-convergence


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

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

     
    Step 3collect-diagnostics location


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

    Configures to collect diagnostics on specified node.

     
    Step 4event-buffer-size number


    Example:
    RP/0/RSP0/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


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

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

     
    Step 6monitoring-interval minutes


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

    Sets interval (in minutes) to collect logs.

     
    Step 7node node-name
     

    Configures parameters for a specified node.

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


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


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


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

    Disables the monitoring of route convergence for specified priority.

     
    Step 11leaf-network number


    Example:
    RP/0/RSP0/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


    Example:
    RP/0/RSP0/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


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

    Sets the absolute directory path for storing diagnostic reports.

     
    Step 14diagnostics directory-path-name


    Example:
    RP/0/RSP0/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


    Example:
    RP/0/RSP0/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


    Example:
    RP/0/RSP0/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


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

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

     

    Route Convergence Monitoring and Diagnostics Prefix Monitoring

    The Route Convergence Monitoring and Diagnostics (RCMD) prefix monitoring feature enables convergence monitoring for specific individual prefixes in Open Shortest Path First (OSPF) and Intermediate System-to-Intermediate System (IS-IS) Interior Gateway Protocols (IGP). In IGP, when the route information is created, the prefix is verified against the configured prefix-list. If the prefix is found to be monitored, it is marked for monitoring and information about each prefix change event is captured. The RCMD prefix monitoring individually monitors specific prefixes on each RCMD enabled router in the network. A maximum of 10 prefixes can be monitored. Individual prefix monitoring compliments the probes enabled at customer network edges to monitor connectivity and availability of specific service end-points.

    The RCMD prefix monitoring for IS-IS prefixes is enabled by configuring the prefix-list command under Router IS-IS monitor-convergence configuration mode. The RCMD prefix monitoring for OSPF prefixes is enabled by configuring the prefix-list command under Router OSPF monitor-convergence configuration mode.

    For individual prefix monitoring, the prefixes are marked before those appear for the route calculation so that the monitoring does not affect the convergence of OSPF or ISIS routes.

    Route Convergence Monitoring and Diagnostics OSPF Type 3/5/7 Link-state Advertisements Monitoring

    The Route Convergence Monitoring and Diagnostics (RCMD) OSPF type 3/5/7 link-state advertisements (LSA) monitoring feature flags and differentiates the LSAs during the monitoring of LSAs. A change in route for type 3/5/7 LSAs has to be monitored. During the route calculation, if the route source appears to be type 3/5/7 LSAs and the route change is an add or delete action, then those prefixes have to be monitored. RCMD monitors all deletion of available paths (a purge operation) and addition of the first path (a restoration operation) for all type 3/5/7 LSAs. The OSPF type 3/5/7 LSAs are monitored and reported on a individual prefix basis. However, a modify operation that involves a change in paths not affecting reachability as a whole, is not monitored. Although all prefixes are logged for reporting, the convergence tracking is rate-limited for the first 10 prefixes that are affected in an SPF run.

    The RCMD OSPF type 3/5/7 LSA monitoring is enabled by configuring the track-external-routes and track-summary-routes under Router OSPF monitor-convergence configuration mode.

    Enabling RCMD Monitoring for IS-IS Prefixes

    Perform this task to enable individual prefix monitoring for IS-IS prefixes.

    Before You Begin

    To enable monitoring of individual prefixes, first configure a prefix-list using the {ipv4 | ipv6} prefix-list command. Then, use this prefix list with the prefix-list command.

    SUMMARY STEPS

      1.    configure

      2.    router isis instance-id

      3.    address-family {ipv4 | ipv6} [unicast | multicast]

      4.    monitor-convergence

      5.    prefix-list prefix-list-name

      6.    Use the commit or end command.


    DETAILED STEPS
       Command or ActionPurpose
      Step 1 configure


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

      Enters global configuration mode.

       
      Step 2router isis instance-id


      Example:
      RP/0/RSP0/CPU0:router(config)#router isis isp
       

      Enables IS-IS routing for the specified routing instance, and places the router in router configuration mode.

       
      Step 3address-family {ipv4 | ipv6} [unicast | multicast]

      Example:
      RP/0/RSP0/CPU0:router(config-isis)#address-family ipv6 unicast
       

      Enter the IS-IS address-family configuration mode.

       
      Step 4monitor-convergence


      Example:
      RP/0/RSP0/CPU0:router(config-isis-af)#monitor-convergence
       

      Enables route convergence monitoring for IS-IS protocol.

       
      Step 5prefix-list prefix-list-name


      Example:
      RP/0/RSP0/CPU0:router(config-isis-af-rcmd)#prefix-list isis_monitor
       

      Enables individual prefix monitoring for IS-IS prefixes.

       
      Step 6 Use the commit or end command.  

      commit—Saves the configuration changes and remains within the configuration session.

      end—Prompts user to take one of these actions:
      • Yes— Saves configuration changes and exits the configuration session.
      • No—Exits the configuration session without committing the configuration changes.
      • Cancel—Remains in the configuration mode, without committing the configuration changes.
       

      Enabling RCMD Monitoring for OSPF Prefixes

      Perform this task to enable individual prefix monitoring for OSPF prefixes.

      Before You Begin

      To enable monitoring of individual prefixes, first configure a prefix-list using the {ipv4 | ipv6} prefix-list command. Then, use this prefix list with the prefix-list command.

      SUMMARY STEPS

        1.    configure

        2.    router ospf ospf-process-name

        3.    monitor-convergence

        4.    prefix-list prefix-list-name

        5.    Use the commit or end command.


      DETAILED STEPS
         Command or ActionPurpose
        Step 1 configure


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

        Enters global configuration mode.

         
        Step 2router ospf ospf-process-name


        Example:
        RP/0/RSP0/CPU0:router(config)#router ospf 1
         

        Enables OSPF routing for the specified routing process and places the router in router configuration mode.

         
        Step 3monitor-convergence


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

        Enables OSPF route convergence monitoring.

         
        Step 4prefix-list prefix-list-name


        Example:
        RP/0/RSP0/CPU0:router(config-ospf-af-rcmd)#prefix-list ospf_monitor
         

        Enables individual prefix monitoring for OSPF prefixes.

         
        Step 5 Use the commit or end command.  

        commit—Saves the configuration changes and remains within the configuration session.

        end—Prompts user to take one of these actions:
        • Yes— Saves configuration changes and exits the configuration session.
        • No—Exits the configuration session without committing the configuration changes.
        • Cancel—Remains in the configuration mode, without committing the configuration changes.
         

        Enabling RCMD Monitoring for Type 3/5/7 OSPF LSAs

        Perform this task to enable RCMD monitoring for type 3/5/7 OSPF LSAs.

        SUMMARY STEPS

          1.    configure

          2.    router ospf 100

          3.    track-external-routes

          4.    track-summary-routes

          5.    Use the commit or end command.


        DETAILED STEPS
           Command or ActionPurpose
          Step 1 configure


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

          Enters global configuration mode.

           
          Step 2router ospf 100


          Example:
          RP/0/RSP0/CPU0:router(config)#router ospf 100
           

          Enables OSPF routing for the specified routing process and places the router in router configuration mode.

           
          Step 3track-external-routes


          Example:
          RP/0/RSP0/CPU0:router(config-ospf-af-rcmd)#track-external-routes
           

          Enables tracking of external (Type-3/5/7) LSAs prefix monitoring.

           
          Step 4track-summary-routes


          Example:
          RP/0/RSP0/CPU0:router(config-ospf-af-rcmd)#track-summary-routes
           

          Enables tracking of summary (inter-area) routes monitoring

           
          Step 5 Use the commit or end command.  

          commit—Saves the configuration changes and remains within the configuration session.

          end—Prompts user to take one of these actions:
          • Yes— Saves configuration changes and exits the configuration session.
          • No—Exits the configuration session without committing the configuration changes.
          • Cancel—Remains in the configuration mode, without committing the configuration changes.
           

          Enabling RCMD Monitoring for IS-IS Prefixes: Example

          This example shows how to monitor RCMD prefix monitoring for individual IS-IS prefixes:
          ipv6 prefix-list isis_monitor
           10 permit 2001:db8::/32
          !
          router isis isp
           address-family ipv6 unicast
            monitor-convergence
             prefix-list isis_monitor
          
          

          Enabling RCMD Monitoring for OSPF Prefixes: Example

          This example shows how to enable RCMD monitoring for individual OSPF prefixes:
          ipv6 prefix-list ospf_monitor
           10 permit 2001:db8::/32
          !
          router ospf 100
           monitor-convergence
            prefix-list ospf_monitor
          
          

          Enabling RCMD Monitoring for Type 3/5/7 OSPF LSAs: Example

          This example shows how to enable tracking of prefix monitoring for OSPF external LSAs and summary routes:
          router ospf 100
           monitor-convergence
            track-external-routes
            track-summary-routes