Displaying the VPNv4/VPNv6 route table

When the user wants to view all the VPNv4 and VPNv6 routes in a network, the user can display the BGP VPNv4 and VPNv6 table using the following method.

To view the BGP VPNv4 route table, enter the following command.

        device# show ip bgp vpnv4 routes
Total number of BGP Routes: 288
Status A:AGGREGATE B:BEST b:NOT-INSTALLED-BEST C:CONFED_EBGP D:DAMPED
       E:EBGP H:HISTORY I:IBGP L:LOCAL M:MULTIPATH S:SUPPRESSED
       Prefix             Next Hop        	 Metric     LocPrf     Weight Status
Route Distinguisher: 4:1
1      10.6.1.0/24        10.2.2.2         3          100        0      I
         AS_PATH:
2      10.8.1.0/24        10.2.2.2         2          100        0      I
         AS_PATH:
3      10.40.1.1/32       10.2.2.2         4          100        0      I
         AS_PATH:
4      10.40.1.2/32       10.2.2.2         4          100        0      I
         AS_PATH:
5      10.40.1.3/32       10.2.2.2         4          100        0      I
         AS_PATH:

Syntax: show ip bgp vpnv4 routes [ ip-addr ] | num | [ age secs ] | [ as-path-access-list num ] | [ as-path-filter num,num,... ] | [ best ] | [ cidr-only ] | [ community num | no-export | no-advertise | internet | local-as ] | [ community-access-list num ] | community-filter num | community-reg-expression regular-expression | detail | local | neighbor ip-addr [ next-hop ip-addr ] | [ no-best ] | [ not-installed-best ] | [ prefix-list string ] | [ regular-expression regular-expression ] | [ route-map map-name ] | [ summary ] | [ unreachable ]

The ip-addr option displays routes for a specific network.

The num option specifies the table entry with which the user wants the display to start. For example, when the user wants to list entries beginning with table entry 100, specify 100.

The agesecs parameter displays only the routes that have been received or updated more recently than the number of seconds the user specifies.

The as-path-access-list num parameter filters the display using the specified AS-path ACL.

The best parameter displays the routes received from the neighbor that the device selected as the best routes to their destinations.

The cidr-only option lists only the routes whose network masks do not match their class network length.

The community option lets the user display routes for a specific community. The user can specify local-as , no-export , no-advertise , internet , or a private community number. The user can specify the community number as either two five-digit integer values of up to 1- 65535, separated by a colon (for example, 12345:6789) or a single long integer value.

The community-access-list num parameter filters the display using the specified community ACL.

The community-filter option lets the user display routes that match a specific community filter.

The community regular-expression regular-expression option filters the display based on a specified community regular expression.

The local option....

The neighbor ip-addr option displays the number of accepted routes from the specified BGP neighbor.

The detail option lets the user display more details about the routes. The user can refine the request by also specifying one of the other display options after the detail keyword.

The next-hop ip-addr option displays the routes for a given next-hop IP address.

The no-best option displays the routes for which none of the routes to a given prefix were selected as the best route.

The not-installed-best option displays the routes received from the neighbor are the best BGP4 routes to their destinations, but were nonetheless not installed in the IP route table due to the rib-route-limit (or RTM route table size limit) and always-propagate option to allow the propagating those best BGP routes.

The prefix-liststring parameter filters the display using the specified IP prefix list.

The regular-expression regular-expression option filters the display based on a regular expression.

The route-mapmap-name parameter filters the display using the specified route map. The software displays only the routes that match the match statements in the route map. The software disregards the route map‘s set statements.

The summary option displays summary information for the routes.

The unreachable option displays the routes that are unreachable because the device does not have a valid RIP, OSPF, or static route to the next hop.

For information about the fields in this display, see the table below.

Table 1. BGP4 VPNv4 information

This field...

Displays...

Total number of BGP VPNv4 Routes:

The number of BGP VPNv4 routes.

Status or Status Codes

The route‘s status, which can be one or more of the following:

  • A - AGGREGATE. The route is an aggregate route for multiple networks.
  • B - BEST. BGP4 has determined that this is the optimal route to the destination.
Note: When the "b" is shown in lowercase, the software was not able to install the route in the IP route table.
  • b - NOT-INSTALLED-BEST. The routes received from the neighbor are the best BGP4 routes to their destinations, but were nonetheless not installed in the IP route table due to the rib-route-limit (or RTM route table size limit) and always-propagate option to allow the propagating those best BGP routes.
  • C - CONFED_EBGP. The route was learned from a neighbor in the same confederation and AS, but in a different sub-AS within the confederation.
  • D - DAMPED. This route has been dampened (by the route dampening feature), and is currently unusable.
  • H - HISTORY. Route dampening is configured for this route, and the route has a history of flapping and is unreachable now.
  • I - INTERNAL. The route was learned through BGP4.
  • L - LOCAL. The route originated on this device.
  • M - MULTIPATH. BGP4 load sharing is enabled and this route was selected as one of the best ones to the destination. The best route among the multiple paths also is marked with "B".
Note: When the "m" is shown in lowercase, the software was not able to install the route in the IP route table.
  • S - SUPPRESSED. This route was suppressed during aggregation and thus is not advertised to neighbors.
Note: This field appears only when the user enters the route option.

Origin code

A character the display uses to indicate the route‘s origin. The origin code appears to the right of the AS path (Path field). The origin codes are described in the command‘s output.

Route Distinguisher

A unique ID that is prepended on any address being routed or advertised from a VRF. The RD can be defined as either ASN-relative or IP address-relative as described:

  • ASN-relative - Composed of the local ASN number followed by a ":" and a unique arbitrary number. For example: 3:6
  • IP address-relative - Composed of the local IP address followed by a ":" and a unique arbitrary number.

Network

IP address or mask of the destination network of the route.

Next Hop

The next-hop device for reaching the network from this device.

Metric

The value of the route‘s MED attribute. When the route does not have a metric, this field is blank.

LocPrf

The degree of preference for this route relative to other routes in the local AS. When the BGP4 algorithm compares route on the basis of local preference, the route with the higher local preference is chosen. The preference can have a value from 0-4294967295

Weight

The value that this route associates with routes from a specific neighbor. For example, when the device receives routes to the same destination from two BGP4 neighbors, the device prefers the route from the neighbor with the larger weight.

Path

The AS path of the route.