Related Documentation
- Example: Configuring BGP Route Target Filtering for VPNs
- Configuring Routing Instances on PE Routers in VPNs
- Configuring an MPLS-Based Layer 2 VPN (CLI Procedure)
- Configuring an MPLS-Based Layer 3 VPN (CLI Procedure)
- Understanding 4-Byte AS Numbers and Route Distinguishers in the Using 4-Byte Autonomous System Numbers in BGP Networks Technology Overview
route-distinguisher
Syntax
Hierarchy Level
Release Information
Statement introduced before Junos OS Release 7.4.
Statement introduced in Junos OS Release 11.1 for EX Series switches.
Support at [edit routing-instances routing-instance-name protocols vpls mesh-group mesh-group-name] hierarchy level introduced in Junos OS Release 11.2.
Description
Specify an identifier attached to a route, enabling you to distinguish to which VPN or VPLS the route belongs. Each routing instance must have a unique route distinguisher associated with it. The route distinguisher is used to place bounds around a VPN so that the same IP address prefixes can be used in different VPNs without having them overlap. If the instance type is vrf, the route-distinguisher statement is required.
We recommend that you use a unique route distinguisher for each routing instance that you configure. Although you could use the same route distinguisher on all PE routers for the same VPN, if you use a unique route distinguisher, you can determine the CE router from which a route originated.
![]() | Caution: We strongly recommend that if you change a route distinguisher that has already been configured, make the change during a maintenance window, as follows:
This is not required if you are configuring the route distinguisher for the first time. |
Options
as-number:number—as-number is an assigned AS number, and number is any 2-byte or 4-byte value. The AS number can be from 1 through 4,294,967,295. If the AS number is a 2-byte value, the administrative number is a 4-byte value. If the AS number is 4-byte value, the administrative number is a 2-byte value. A route distinguisher consisting of a 4-byte AS number and a 2-byte administrative number is defined as a type 2 route distinguisher in RFC 4364 BGP/MPLS IP Virtual Private Networks (VPNs).
![]() | Note: In Junos OS Release 9.1 and later, the numeric range for AS numbers is extended to provide BGP support for 4-byte AS numbers, as defined in RFC 4893, BGP Support for Four-octet AS Number Space. All releases of Junos OS support 2-byte AS numbers. To configure a route distinguisher that includes a 4-byte AS number, append the letter “L” to the end of the AS number. For example, a route distinguisher with the 4-byte AS number 7,765,000 and an administrative number of 1,000 is represented as 77765000L:1000. In Junos OS Release 9.2 and later, you can also configure a 4-byte AS number using the AS dot notation format of two integer values joined by a period: <16-bit high-order value in decimal>.<16-bit low-order value in decimal>. For example, the 4-byte AS number of 65,546 in the plain-number format is represented as 1.10 in AS dot notation format. |
ip-address:id—IP address (ip-address is a 4-byte value) within your assigned prefix range and a 2-byte value for the id. The IP address can be any globally unique unicast address.
Range: 0 through 4,294,967,295 (232 – 1). If the router you are configuring is a BGP peer of a router that does not support 4-byte AS numbers, you need to configure a local AS number. For more information, see Establishing a Peer Relationship Between a 4-Byte Capable Router and a 2-Byte Capable Router Using a 4-Byte AS Number in the Using 4-Byte Autonomous System Numbers in BGP Networks Technology Overview.
Required Privilege Level
routing—To view this statement in the configuration.
routing-control—To add this statement to the configuration.
Related Documentation
- Example: Configuring BGP Route Target Filtering for VPNs
- Configuring Routing Instances on PE Routers in VPNs
- Configuring an MPLS-Based Layer 2 VPN (CLI Procedure)
- Configuring an MPLS-Based Layer 3 VPN (CLI Procedure)
- Understanding 4-Byte AS Numbers and Route Distinguishers in the Using 4-Byte Autonomous System Numbers in BGP Networks Technology Overview
Published: 2013-01-25
Related Documentation
- Example: Configuring BGP Route Target Filtering for VPNs
- Configuring Routing Instances on PE Routers in VPNs
- Configuring an MPLS-Based Layer 2 VPN (CLI Procedure)
- Configuring an MPLS-Based Layer 3 VPN (CLI Procedure)
- Understanding 4-Byte AS Numbers and Route Distinguishers in the Using 4-Byte Autonomous System Numbers in BGP Networks Technology Overview