Table Of Contents
BGP Support for IP Prefix Import from Global Table into a VRF Table
Prerequisites for BGP Support for IP Prefix Import from Global Table into a VRF Table
Restrictions for BGP Support for IP Prefix Import from Global Table into a VRF Table
Information About BGP Support for IP Prefix Import from Global Table into a VRF Table
Importing IPv4 Prefixes into a VRF
How to Import IP Prefixes from Global Table into a VRF Table
Defining IPv4 IP Prefixes to Import
Creating the VRF and the Import Route Map
Filtering on the Ingress Interface
Unicast Reverse Path Forwarding
Verifying Global IP Prefix Import
Configuration Examples for BGP Support for IP Prefix Import from Global Table into a VRF Table
Configuring Global IP Prefix Import: Example
Feature Information for BGP Support for IP Prefix Import from Global Table into a VRF Table
BGP Support for IP Prefix Import from Global Table into a VRF Table
First Published: August 9, 2004Last Updated: August 21, 2007The BGP Support for IP Prefix Import from Global Table into a VRF Table feature introduces the capability to import IPv4 unicast prefixes from the global routing table into a Virtual Private Network (VPN) routing/forwarding (VRF) instance table using an import route map.
Finding Feature Information in This Module
Your Cisco IOS software release may not support all of the features documented in this module. To reach links to specific feature documentation in this module and to see a list of the releases in which each feature is supported, use the "Feature Information for BGP Support for IP Prefix Import from Global Table into a VRF Table" section.
Finding Support Information for Platforms and Cisco IOS and Catalyst OS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS and Catalyst OS software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Contents
•
Prerequisites for BGP Support for IP Prefix Import from Global Table into a VRF Table
•
Restrictions for BGP Support for IP Prefix Import from Global Table into a VRF Table
•
Information About BGP Support for IP Prefix Import from Global Table into a VRF Table
•
How to Import IP Prefixes from Global Table into a VRF Table
•
Configuration Examples for BGP Support for IP Prefix Import from Global Table into a VRF Table
•
Feature Information for BGP Support for IP Prefix Import from Global Table into a VRF Table
Prerequisites for BGP Support for IP Prefix Import from Global Table into a VRF Table
•
Border Gateway Protocol (BGP) peering sessions are established.
•
CEF or dCEF (for distributed platforms) is enabled on all participating routers.
Restrictions for BGP Support for IP Prefix Import from Global Table into a VRF Table
•
Only IPv4 unicast and multicast prefixes can be imported into a VRF with this feature.
•
A maximum of five VRF instances per router can be created to import IPv4 prefixes from the global routing table.
•
IPv4 prefixes imported into a VRF using this feature cannot be imported into a VPNv4 VRF.
Information About BGP Support for IP Prefix Import from Global Table into a VRF Table
•
Importing IPv4 Prefixes into a VRF
Importing IPv4 Prefixes into a VRF
The BGP Support for IP Prefix Import from Global Table into a VRF Table feature introduces the capability to import IPv4 unicast prefixes from the global routing table into a Virtual Private Network (VPN) routing/forwarding instance (VRF) table using an import route map. This feature extends the functionality of VRF import-map configuration to allow IPv4 prefixes to be imported into a VRF based on a standard community. Both IPv4 unicast and multicast prefixes are supported. No Multiprotocol Label Switching (MPLS) or route target (import/export) configuration is required.
IP prefixes are defined as match criteria for the import map through standard Cisco IOS filtering mechanisms. For example, an IP access-list, an IP prefix-list, or an IP as-path filter is created to define an IP prefix or IP prefix range, and then the prefix or prefixes are processed through a match clause in a route map. Prefixes that pass through the route map are imported into the specified VRF per the import map configuration.
Black Hole Routing
This feature can be configured to support Black Hole Routing (BHR). BHR is method that allows the administrator to block undesirable traffic, such as traffic from illegal sources or traffic generated by a Denial of Service (DoS) attack, by dynamically routing the traffic to a dead interface or to a host designed to collect information for investigation, mitigating the impact of the attack on the network. Prefixes are looked up, and packets that come from unauthorized sources are blackholed by the ASIC at line rate.
Classifying Global Traffic
This feature can be used to classify global IP traffic based on physical location or class of service. Traffic is classified based on administration policy and then imported into different VRFs. On a college campus, for example, network traffic could be divided into an academic network and residence network traffic, a student network and faculty network, or a dedicated network for multicast traffic. After the traffic is divided along administration policy, routing decisions can be configured with the MPLS VPN—VRF Selection Using Policy Based Routing or the MPLS VPN—VRF Selection Based on Source IP Address features.
How to Import IP Prefixes from Global Table into a VRF Table
This section contains the following tasks:
•
Defining IPv4 IP Prefixes to Import
•
Creating the VRF and the Import Route Map
•
Filtering on the Ingress Interface
•
Verifying Global IP Prefix Import
Defining IPv4 IP Prefixes to Import
IPv4 unicast or multicast prefixes are defined as match criteria for the import route map using standard Cisco IOS filtering mechanisms. This task uses an IP access-list and an IP prefix-list.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
access-list access-list-number {deny | permit} source [source-wildcard] [log]
4.
ip prefix-list prefix-list-name [seq seq-value] {deny network/length | permit network/length} [ge ge-value] [le le-value]
DETAILED STEPS
Creating the VRF and the Import Route Map
The IP prefixes that are defined for import are then processed through a match clause in a route map. IP prefixes that pass through the route map are imported into the VRF. A maximum of 5 VRFs per router can be configured to import IPv4 prefixes from the global routing table. 1000 prefixes per VRF are imported by default. You can manually configure from 1 to 2,147,483,647 prefixes for each VRF. We recommend that you use caution if you manually configure the prefix import limit. Configuring the router to import too many prefixes can interrupt normal router operation.
No MPLS or route target (import/export) configuration is required.
Import Actions
Import actions are triggered when a new routing update is received or when routes are withdrawn. During the initial BGP update period, the import action is postponed to allow BGP to convergence more quickly. Once BGP converges, incremental BGP updates are evaluated immediately and qualified prefixes are imported as they are received.
New Syslog Message
The following syslog message is introduced by this feature. It will be displayed when more prefixes are available for import than the user-defined limit:
00:00:33: %BGP-3-AFIMPORT_EXCEED: IPv4 Multicast prefixes imported to multicast vrf exceed the limit 2You can either increase the prefix limit or fine-tune the import route map filter to reduce the number of candidate routes.
Restrictions
•
Only IPv4 unicast and multicast prefixes can be imported into a VRF with this feature.
•
A maximum of five VRF instances per router can be created to import IPv4 prefixes from the global routing table.
•
IPv4 prefixes imported into a VRF using this feature cannot be imported into a VPNv4 VRF.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
ip vrf vrf-name
4.
rd route-distinguisher
5.
import ipv4 {unicast | multicast} [prefix-limit] map route-map
6.
exit
7.
route-map map-tag [permit | deny] [sequence-number]
8.
match ip address {acl-number [acl-number | acl-name] | acl-name [acl-name | acl-number] | prefix-list prefix-list-name [prefix-list-name]}
9.
end
DETAILED STEPS
Filtering on the Ingress Interface
This feature can be configured globally or on a per-interface basis. We recommend that you apply it to ingress interfaces to maximize performance.
Unicast Reverse Path Forwarding
Unicast Reverse Path Forwarding (Unicast RPF) can be optionally configured. Unicast RPF is used to verify that the source address is in the Forwarding Information Base (FIB). The ip verify unicast vrf command is configured in interface configuration mode and is enabled for each VRF. This command has permit and deny keywords that are used to determine if the traffic is forwarded or dropped after Unicast RPF verification.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
interface type number [name-tag]
4.
ip policy route-map map-tag
5.
ip verify unicast vrf vrf-name {deny | permit}
6.
end
DETAILED STEPS
Verifying Global IP Prefix Import
Perform the steps in this task to display information about the VRFs that are configured with this feature and to verify that global IP prefixes are imported into the specified VRF table.
SUMMARY STEPS
1.
enable
2.
show ip bgp vpnv4 {all | rd route-distinguisher | vrf vrf-name} [rib-failure] [ip-prefix/length [longer-prefixes] [output-modifiers]] [network-address [mask] [longer-prefixes] [output-modifiers]] [cidr-only] [community] [community-list] [dampened-paths] [filter-list] [flap-statistics] [inconsistent-as] [neighbors] [paths [line]] [peer-group] [quote-regexp] [regexp] [summary] [labels]
3.
show ip vrf [brief | detail | interfaces | id] [vrf-name]
DETAILED STEPS
Step 1
enable
Enables privileged EXEC mode. Enter your password if prompted.
Router# enableStep 2
show ip bgp vpnv4 {all | rd route-distinguisher | vrf vrf-name} [rib-failure] [ip-prefix/length [longer-prefixes] [output-modifiers]] [network-address [mask] [longer-prefixes] [output-modifiers]] [cidr-only] [community] [community-list] [dampened-paths] [filter-list] [flap-statistics] [inconsistent-as] [neighbors] [paths [line]] [peer-group] [quote-regexp] [regexp] [summary] [labels]
Displays VPN address information from the BGP table. The output displays the import route map, the traffic type (unicast or multicast), the default or user-defined prefix import limit, the actual number of prefixes that are imported, and individual import prefix entries.
Router# show ip bgp vpnv4 allBGP table version is 15, local router ID is 10.1.1.1Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,S StaleOrigin codes: i - IGP, e - EGP, ? - incompleteNetwork Next Hop Metric LocPrf Weight PathRoute Distinguisher: 100:1 (default for vrf academic)Import Map: ACADEMIC, Address-Family: IPv4 Unicast, Pfx Count/Limit: 6/1000*> 10.50.1.0/24 172.17.2.2 0 2 3 ?*> 10.50.2.0/24 172.17.2.2 0 2 3 ?*> 10.50.3.0/24 172.17.2.2 0 2 3 ?*> 10.60.1.0/24 172.17.2.2 0 2 3 ?*> 10.60.2.0/24 172.17.2.2 0 2 3 ?*> 10.60.3.0/24 172.17.2.2 0 2 3 ?Route Distinguisher: 200:1 (default for vrf residence)Import Map: RESIDENCE, Address-Family: IPv4 Unicast, Pfx Count/Limit: 3/1000*> 10.30.1.0/24 172.17.2.2 0 0 2 i*> 10.30.2.0/24 172.17.2.2 0 0 2 i*> 10.30.3.0/24 172.17.2.2 0 0 2 iRoute Distinguisher: 300:1 (default for vrf BLACKHOLE)Import Map: BLACKHOLE, Address-Family: IPv4 Unicast, Pfx Count/Limit: 3/1000*> 10.40.1.0/24 172.17.2.2 0 0 2 i*> 10.40.2.0/24 172.17.2.2 0 0 2 i*> 10.40.3.0/24 172.17.2.2 0 0 2 iRoute Distinguisher: 400:1 (default for vrf multicast)Import Map: MCAST, Address-Family: IPv4 Multicast, Pfx Count/Limit: 2/2*> 10.70.1.0/24 172.17.2.2 0 0 2 i*> 10.70.2.0/24 172.17.2.2 0 0 2 iStep 3
show ip vrf [brief | detail | interfaces | id] [vrf-name]
Displays defined VRFs and their associated interfaces. The output displays the import route map, the traffic type (unicast or multicast), and the default or user-defined prefix import limit. The following example output shows that the import route map named UNICAST is importing IPv4 unicast prefixes and that the prefix import limit is 1000.
Router# show ip vrf detailVRF academic; default RD 100:10; default VPNID <not set>VRF Table ID = 1No interfacesConnected addresses are not in global routing tableExport VPN route-target communitiesRT:100:10Import VPN route-target communitiesRT:100:10Import route-map for ipv4 unicast: UNICAST (prefix limit: 1000)No export route-map
Configuration Examples for BGP Support for IP Prefix Import from Global Table into a VRF Table
This section contains the following configuration example:
•
Configuring Global IP Prefix Import: Example
Configuring Global IP Prefix Import: Example
The following example, beginning in global configuration mode, imports all unicast prefixes from the 10.24.240.0/22 subnet into the VRF named GREEN. An IP prefix list is used to define the imported IPv4 prefixes. The route map is attached to Ethernet interface 0. Unicast RPF verification for VRF GREEN is enabled.
ip prefix-list COLORADO permit 10.24.240.0/22!ip vrf GREENrd 100:10import ipv4 unicast 1000 map UNICASTexitroute-map UNICAST permit 10match ip address prefix-list COLORADOexitinterface Ethernet 0ip policy route-map UNICASTip verify unicast vrf GREEN permitendAdditional References
The following sections provide references related to the BGP Support for IP Prefix Import from Global Table into a VRF Table feature.
Related Documents
Related Topic Document TitleBGP commands: complete command syntax, defaults, command mode, command history, usage guidelines, and examples
•
Cisco IOS IP Routing Protocols Command Reference, Release 12.2SB
•
Cisco IOS IP Routing Protocols Command Reference, Release 12.2SR
•
Cisco IOS IP Routing Protocols Command Reference, Release 12.2SX
•
Cisco IOS IP Command Reference, Volume 2 of 4: Routing Protocols, Release 12.3T
BGP configuration tasks
Cisco IOS IP Configuration Guide, Release 12.3
MPLS VPN configuration tasks
MPLS Virtual Private Networks, Release 12.0(5)T
VRF selection using policy based routing
VRF selection based on source IP address
Standards
Standard TitleNo new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.
—
MIBs
RFCs
RFC TitleNo new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.
—
Technical Assistance
Command Reference
This section documents only commands that are new or modified.
debug ip bgp import
To display debugging information related to importing IPv4 prefixes from the global routing table into a VRF table, use the debug ip bgp import command in privileged EXEC mode. To disable the display of IPv4 prefix import debugging information, use the no form of this command.
debug ip bgp import {events | updates [access-list | expanded-access-list]}
no debug ip bgp import {events | updates [access-list | expanded-access-list]}
Syntax Description
Command Modes
Privileged EXEC
Command History
Usage Guidelines
Use this command to display debugging information related to the BGP Support for IP Prefix Import from Global Table into a VRF Table feature. This feature provides the capability to import IPv4 unicast prefixes from the global routing table into a Virtual Private Network (VPN) routing/forwarding (VRF) instance table using an import route map.
Examples
The following example configures IPv4 prefix import debugging messages for both import events and import updates to be displayed on the console of the router:
Router# debug ip bgp import eventsBGP import events debugging is onRouter# debug ip bgp import updatesBGP import updates debugging is on for access list 300:00:50: %BGP-5-ADJCHANGE: neighbor 10.2.2.2 Up00:01:06: BGP: reevaluate IPv4 Unicast routes in VRF academic00:01:06: BGP: 0 routes available (limit: 1000)00:01:06: BGP: import IPv4 Unicast routes to VRF academic00:01:06: BGP(2)-VRF(academic): import pfx 100:1:10.30.1.0/24 via 10.2.2.200:01:06: BGP: accepted 8 routes (limit: 1000)00:01:06: BGP: reevaluate IPv4 Multicast routes in VRF multicast00:01:06: BGP: 0 routes available (limit: 2)00:01:06: BGP: import IPv4 Multicast routes to VRF multicast00:01:06: %BGP-4-AFIMPORT: IPv4 Multicast prefixes imported to multicast vrf reached thelimit 200:01:06: BGP: accepted 2 routes (limit: 2)00:01:06: BGP: reevaluate IPv4 Unicast routes in VRF BLUE00:01:06: BGP: 0 routes available (limit: 1000)00:01:06: BGP: import IPv4 Unicast routes to VRF BLUE00:01:06: BGP: accepted 3 routes (limit: 1000)Table 1 describes the significant fields shown in the display.
Related Commands
import ipv4
To configure an import map to import IPv4 prefixes from the global routing table to a VRF table, use the import ipv4 command in VRF configuration mode. To remove the import map, use the no form of this command.
import ipv4 {unicast | multicast} [prefix-limit] map route-map
no import ipv4 {unicast | multicast} [prefix-limit] map route-map
Syntax Description
Command Default
No import map is configured.
Command Modes
VRF configuration
Command History
Usage Guidelines
IP prefixes that are defined for import are processed through a match clause in a route map. The prefixes that pass through the route map are imported into the Virtual Private Network (VPN) routing/forwarding (VRF) instance. A maximum of five VRFs per router can be configured to import IPv4 prefixes from the global routing table. 1000 prefixes per VRF are imported by default. You can manually configure from 1 to 2,147,483,647 prefixes for each VRF. We recommend that you use caution if you manually configure the prefix import limit. Configuring the router to import too many prefixes can interrupt normal router operation. Only IPv4 unicast and multicast prefixes can be imported to a VRF with this feature. IPv4 prefixes imported into a VRF using this feature cannot be imported into a VPNv4 VRF.
No MPLS or Route Target Configuration Is Required
No MPLS or route target (import/export) configuration is required.
Import Behavior
Import actions are triggered when a new routing update is received or when routes are withdrawn. During the initial BGP update period, the import action is postponed to allow BGP to converge more quickly. Once BGP converges, incremental BGP updates are evaluated immediately and qualified prefixes are imported as they are received.
Examples
The following example, beginning in global configuration mode, imports all unicast prefixes from the 10.24.240.0/22 subnet into the VRF named GREEN. An IP prefix list is used to define the imported IPv4 prefixes. The route map is attached to the Ethernet interface 0, and unicast RPF verification for VRF GREEN is enabled.
ip prefix-list COLORADO permit 10.24.240.0/22!ip vrf GREENrd 100:10import ipv4 unicast 1000 map UNICASTexitroute-map UNICAST permit 10match ip address prefix-list ACCOUNTINGexitinterface Ethernet 0ip policy route-map UNICASTip verify unicast vrf GREEN permitendRelated Commands
ip verify unicast vrf
To enable Unicast Reverse Path Forwarding (Unicast RPF) verification for a specified VRF, use the ip verify unicast vrf command in interface configuration mode. To disable the Unicast RPF check for a VRF, use the no form of this command.
ip verify unicast vrf vrf-name {deny | permit}
no ip verify unicast vrf vrf-name {deny | permit}
Syntax Description
Command Default
Unicast RPF verification is disabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
Unicast RPF is configured to verify that the source address is in the Forwarding Information Base (FIB). The ip verify unicast vrf command is configured in interface configuration mode and is enabled for each VRF. This command has permit and deny keywords that are used to determine if traffic is forwarded or dropped after Unicast RPF verification.
Examples
The following example configures Unicast RPF verification for VRF GREEN and RED. VRF GREEN traffic is forwarded. VRF RED traffic is dropped.
Router(config)# interface Ethernet 0Router(config-if)# ip verify unicast vrf GREEN permitRouter(config-if)# ip verify unicast vrf RED denyRouter(config-if)# endRelated Commands
Feature Information for BGP Support for IP Prefix Import from Global Table into a VRF Table
Table 2 lists the release history for this feature.
Not all commands may be available in your Cisco IOS software release. For release information about a specific command, see the command reference documentation.
Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which Cisco IOS and Catalyst OS software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Note
Table 2 lists only the Cisco IOS software release that introduced support for a given feature in a given Cisco IOS software release train. Unless noted otherwise, subsequent releases of that Cisco IOS software release train also support that feature.
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2004-2007 Cisco Systems, Inc. All rights reserved.


