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

address-family

vpn router bgp address-family, vpn router bgp neighbor address-family—Configure global and per-neighbor BGP address family information (on vEdge routers only).

vManage Feature Template

For vEdge routers only:

Configuration ► Templates ► BGP

Command Hierarchy

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 | natpool-outside | omp | ospf | static) [route-policy policy-name]
        
vpn vpn-id
  router
    bgp local-as-number
      neighbor ip-address
        address-family ipv4_unicast
          maximum-prefixes number [threshold] [restart minutes | warning-only]
          route-policy policy-name (in | out)

Options

Address Family
ipv4_unicast
Currently, the Viptela software supports only the BGP IPv4 unicast address family.
Aggregate Prefixes
aggregate-address prefix/length [as-set] [summary-only]
For all BGP sessions, aggregate the specified prefixes. To generate set path information, include the as-set option. To filter out more specific routes from BGP updates, include the summary-only option.
IBGP Multipath Load Sharing
maximum-paths paths number
For all BGP sessions, enable IBGP multipath load sharing, and configure the maximum number of parallel IBGP paths that can be installed into a route table.
Range: 0 to 32
Networks To Advertise
network prefix/length
Networks to be advertised by BGP. Identify the networks by their prefix and length.
Prefixes Received from a Neighbor
maximum-prefixes number [threshold] [restart minutes | warning-only]
Configure how to handle prefixes received from the BGP neighbor:
number is the maximum number of prefixes that can be received from the neighbor.
Range: 1 through 4294967295
Default: 0 (there is no limit to the number of prefixes received)
threshold is the percentage of the maximum number of prefixes at which to either generate a warning message or restart the BGP peering session.
Range: 1 through 100 percent
Default: 0 (no warning message is generated)
restart minutes is how long to wait after the maximum number of prefixes has been exceeded before restarting the BGP peering session with the neighbor.
Range: 0 through 65535 minutes (approximately 1092 hours, or 45 days)
Default: None
warning-only displays a warning message only when the maximum prefix limit is exceeded.
Policy to Apply to Received Prefixes
route-policy policy-name (in | out)
Apply the specified policy, policy-name, to prefixes received from the neighbor. You can apply the policy inbound (in) as the prefixes are received from the neighbor or outbound (out) as they are send to the neighbor.
Redistribute Routes into BGP
redistribute (connected | nat | natpool-outside | omp | ospf |static) [route-policy policy-name]
For all BGP sessions, redistribute routes learned from other protocols into BGP.
Optionally, apply a route policy to the redistributed routes.

Example

Redistribute OMP routes into BGP:

vpn 1
  router
    bgp 123
      address-family ipv4-unicast
      redistribute omp
      ! 
    !
  !
!

Have BGP advertise the network 1.2.0.0/16:

vEdge(config-address-family-ipv4-unicast)# network 61.0.1.0/24 
vEdge(config-address-family-ipv4-unicast)# network 10.20.25.0/24 
vEdge(config-address-family-ipv4-unicast)# show full-configuration 
vpn 1
 router
  bgp 1
   address-family ipv4-unicast
    network 61.0.1.0/24
    network 10.20.24.0/24
   !
  !
 !
!
vEdge(config-address-family-ipv4-unicast)# commit and-quit 
Commit complete.
vEdge# show bgp routes 

                                     LOCAL                  AS     PATH        
VPN  PREFIX         NEXTHOP  METRIC  PREF   WEIGHT  ORIGIN  PATH   STATUS      
-------------------------------------------------------------------------------
1    10.20.25.0/24  0.0.0.0  0       -      32768   igp     Local  valid,best  
1    61.0.1.0/24    0.0.0.0  0       -      32768   igp     Local  valid,best  

Release Information

Command introduced in Viptela Software Release 14.1.​
In Release 16.3, add redistribute natpool-outside option.

Additional Information

See the Configuring Unicast Overlay Routing and Using a vEdge Router as a NAT Device articles for your software release.

  • Was this article helpful?