Skip to main content
Cisco SD-WAN
Support
Product Documentation
Viptela Documentation

Routing CLI Reference

CLI commands for configuring and monitoring the BGP, IGMP, OMP, OSPF, and PIM routing protocols on vEdge routers.

Routing Protocol Configuration Commands

You configure routing protocols on vEdge routers. For BGP and OSPF, you configure them in each VPN:

omp...
vpn vpn-id
  router
    bgp...
    igmp ...
    multicast-replicator...
    ospf...
    pim...

BGP Configuration and Monitoring Commands

Use the following commands to configure BGP within a VPN on a vEdge router:

vpn vpn-id
  router
    bgp local-as-number
      address-family ipv4-unicast
        aggregate-address prefix/length [as-set] [summary-only]
        maximum-paths paths number
        network prefix/length
        redistribute (connected | nat | omp | ospf | static) [route-policy policy-name]
      best-path
        as-path multipath-relax
        compare-router-id
        med (always-compare | deterministic | missing-as-worst)
      distance
        external number
        internal number
        local number
      neighbor ip-address
        address-family ipv4-unicast
          maximum-prefixes number [threshold] [restart minutes | warning-only]
          route-policy policy-name (in | out)
        capability-negotiate
        description text        
        ebgp-multihop ttl
        next-hop-self
        password md5-digest-string
        remote-as remote-as-number
        send-community
        send-ext-community
        [no] shutdown
        timers
          advertisement-interval number
          connect-retry seconds
          holdtime seconds          
          keepalive seconds        
        update-source ip-address
      ! end neighbor configuration
      router-id ip-address
      [no] shutdown
      timers
        holdtime seconds
        keepalive seconds

Use the following commands to monitor BGP on a vEdge router:

  • clear bgp all— Reset the connections to all BGP neighbors in the specified VPN.
  • clear bgp neighbor—Reset the connection to a specific BGP neighbor in the specified VPN.
  • debug bgp events—Display the events that have occurred as part of the BGP finite state model.
  • debug bgp fsm—Display the states in the BGP finite state model, which describes the actions that BGP takes and the BGP packets that are exchanged between BGP neighbors when they are establishing a peering session.
  • debug bgp ipcs—Display information about BGP interprocess communication with other processes running on the vEdge router.
  • debug bgp packets v—Display the packets that BGP is receiving from its peers.
  • show bgp neighbor—Display information about all BGP connections to neighbors.
  • show bgp routes—Display information about all routes learned by BGP.
  • show bgp summary—Display summary information about BGP.

IGMP Configuration and Monitoring Commands

Use the following commands to configure IGMP within a VPN on a vEdge router:

vpn vpn-id
  router
    igmp
      interface interface-name
        join-group group-address
      [no] shutdown

Use the following commands to monitor IGMP:

OMP Configuration and Monitoring Commands

By default, OMP is enabled on all vEdge routers and vSmart controllers. Use the following commands to modify the OMP configuration:

omp
  advertise (bgp | connected | ospf | static) (on vEdge routers only)
  discard-rejected (on vSmart controllers only)
  ecmp-limit number (on vEdge routers only)
  graceful-restart
  send-backup-paths (on vSmart controllers only)
  send-path-limit number
  [no] shutdowntimers
  ​  advertisement-interval seconds
    eor-timer seconds
    graceful-restart-timer seconds
    ​holdtime seconds
vpn
  omp
    advertise (aggregate prefix [aggregate-only] | bgp | connected | network prefix | ospf type | static) (on vEdge routers only) 

Use the following commands to monitor OMP:

  • clear omp all—Restart OMP and all OMP sessions.
  • clear omp peer—Restart the OMP session to a specific peer
  • clear omp routes—Flush the OMP routes from the route table and then re-install them.
  • clear omp tlocs—Remove TLOCs from the tunnel table and then re-install them.
  • debug omp events [level level]—Display information to help debug OMP events.
  • debug omp ipcs [level level]—Display information to help debug OSPF interprocess communication with other processes running on the Viptela device.
  • debug omp packets [level level]—Display information to help debug OMP packets.
  • show omp peers—Display information about active OMP peering sessions.
  • show omp routes—Display OMP route information.
  • show omp services—Display OMP services information.
  • show omp summary—Display summary information about OMP.
  • show omp tloc-paths—Display TLOC path information.
  • show omp tlocs—Display TLOC information.

OSPF Configuration and Monitoring Commands

Use the following commands to configure OSPF within a VPN on a vEdge router:

vpn vpn-id
   router
    ospf
      area number
        interface interface-name
          authentication
            authentication-key key
            message-digest key
            type (message-digest | simple)
          cost number

          dead-interval seconds
          hello-interval seconds
          network (broadcast | point-to-point)
          passive-interface
          priority number 
          retransmit-interval seconds 
        ! end area interface
        nssa
          no-summary
          translate (always | candidate | never)
        range prefix/length
          cost number
          no-advertise
        stub
        no-summary
    ! end area
    auto-cost reference-bandwidth mbps
    compatible rfc1583
    default-information    
      originate (always | metric metric | metric-type type)
    distance
      external number
      inter-area number
      intra-area number
    max-metric
      router-lsa (administrative | on-startup seconds)
    redistribute (bgp | connected | nat | omp | static) route-policy policy-name
    route-policy policy-name in
    router-id ip-v4-address
    timers
      spf delay initial-hold-time maximum-hold-time

Use the following commands to monitor OSPF on a vEdge router:

  • clear ospf all—Reset all OSPF neighbors in the specified VPN.
  • debug ospf events—Display information to help debug OSPF events in the specified VPN.
  • debug ospf ipcs—Display information to help debug OSPF interprocess communication with other processes running on the vEdge router.
  • debug ospf ism—Display information about the OSPF interface state machine in the specified VPN, to help debug issues with establishing an OSPF session on an interface.
  • debug ospf lsa—Display information to help debug OSPF link-state advertisements in the specified VPN.
  • debug ospf nsm—Display information about the OSPF neighbor state machine in the specified VPN, to help debug issues with establishing an OSPF session with a neighbor.
  • debug ospf nssa —Display information to help debug an OSPF NSSA (Not-So-Stubby Area)
  • debug ospf packets—Display information about OSPF packets in the specified VPN,to help debug issues related to the exchange of packets between OSPF routers.
  • show ospf database—Display the entries in the OSPF link-state database.
  • show ospf database-summary—Display a summary of the entries in the OSPF link-state database.
  • show ospf interface—List the interfaces in the specified VPN that are running OSPF.
  • show ospf neighbor—List the OSPF neighbors in the specified VPN.
  • show ospf process—List the OSPF processes running in the specified VPN.
  • show ospf routes—Display information about all routes learned by OSPF.

PIM and Multicast Replicator Configuration and Monitoring Commands

Use the following commands to configure PIM and multicast replicators within a VPN on a vEdge router:

vpn vpn-id
  router
    multicast-replicator local [threshold number]
vpn vpn-id
  router
    pim
      auto-rp
      interface interface-name
        hello-interval seconds
        join-prune-interval seconds
      replicator-selection       
      [no] shutdown
      spt-threshold kbps

Use the following commands to monitor PIM and multicast replicators:

  • Was this article helpful?