route-distinguisher

Function

The route-distinguisher command configures a route distinguisher (RD) for a VPN instance address family.

By default, no RD is configured for the VPN instance address family.

Format

route-distinguisher route-distinguisher

Parameters

Parameter	Description	Value
route-distinguisher	Specifies the value of an RD. The forms of RD are as follows: 2-byte AS number:4-byte user-defined number, for example, 101:3. An AS number ranges from 0 to 65535. A user-defined number ranges from 0 to 4294967295. The AS number and the user-defined number cannot be 0s at the same time. That is, an RD cannot be 0:0. Integral 4-byte AS number:2-byte user-defined number, for example, 65537:3. An AS number ranges from 65536 to 4294967295. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. That is, an RD cannot be 0:0. 4-byte AS number in dotted notation:2-byte user-defined number, for example, 0.0:3 or 0.1:0. A 4-byte AS number in dotted notation is in the format of x.y, where x and y are integers that range from 0 to 65535 and from 0 to 65535, respectively. A user-defined number ranges from 0 to 65535. The AS number and user-defined number cannot be both 0s. That is, an RD cannot be 0.0:0. IPv4-address:2-byte user-defined number, for example, 192.168.122.15:1. An IP address ranges from 0.0.0.0 to 255.255.255.255. A user-defined number ranges from 0 to 65535.	-

Views

VPN instance view, VPN instance IPv4 address family view, VPN instance IPv6 address family view, EVPN instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After creating a VPN instance and enabling the IPv4 or IPv6 address family for the VPN instance, you need to run the route-distinguisher command to configure an RD for the address family.

Different VPN instances may have the same route prefix. To allow a PE to determine to which VPN instance a route belongs, run the route-distinguisher command to configure an RD for an address family of a VPN instance on the PE. After the configuration, the PE will add an RD to the route received from the VPN instance, and then the route prefix becomes a globally unique VPNv4 or VPNv6 route.

Configuration Impact

An RD configured for the IPv4 or IPv6 address family of a VPN instance cannot be directly modified or deleted. Before modifying an RD, you need to disable the IPv4 or IPv6 address family of the VPN instance or delete the VPN instance and then reconfigure the address family or the VPN instance.

Precautions

Configuring a unique RD for the IPv4 or IPv6 address family of a VPN instance is recommended; otherwise, route overlap may occur.

When the route-distinguisher command is run in the VPN instance view, an ipv4-family command is created at the same time by default. The command results are equivalent to running the ipv4-family command in the VPN instance view and then running the route-distinguisher command in the VPN instance IPv4 address family view. For example:

[HUAWEI-vpn-instance-vpn1] route-distinguisher 200:1
[HUAWEI-vpn-instance-vpn1-af-ipv4] display this 
#  
 ipv4-family
  route-distinguisher 200:1
#
return

Example

# Configure an RD for the VPN instance named vpn1.

<HUAWEI> system-view
[HUAWEI] ip vpn-instance vpn1
[HUAWEI-vpn-instance-vpn1] ipv4-family
[HUAWEI-vpn-instance-vpn1-af-ipv4] route-distinguisher 22:1