EVPN Management
This section describes the configuration model of EVPN management and provides examples of XML packets.
Data Model
The configuration model files matching EVPN are huawei-ethernet-vpn.yang, huawei-bgp-l3vpn.yang and huawei-bgp.yang.
Object |
Description |
Value |
Remarks |
|---|---|---|---|
/huawei-ethernet-vpn:vpn-instances/vpn-instance/vpn-instance-name |
Indicates the name of a created EVPN instance. |
The value is a string of 1 to 31 case-sensitive characters without spaces. |
N/A |
/huawei-ethernet-vpn:vpn-instances/vpn-instance/evpn-type |
Indicates the type of a created EVPN instance. |
The value is of the enumerated type:
|
N/A |
/huawei-ethernet-vpn:vpn-instances/vpn-instance/route-distinguisher |
Specifies the RD of an EVPN instance. |
The value is a string of 3 to 21 case-sensitive characters without spaces. |
N/A |
/huawei-ethernet-vpn:vpn-instances/vpn-instance/evpntargets/evpntarget/evrf-rtvalue |
Specifies the value of the VPN target extended community attribute for an EVPN instance. |
The value is a string of 3 to 21 case-sensitive characters without spaces. |
N/A |
/huawei-ethernet-vpn:vpn-instances/vpn-instance/evpntargets/evpntarget/evrf-rttype |
Specifies the type of the VPN target extended community attribute for an EVPN instance. |
The value is of the enumerated type:
|
N/A |
/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/huawei-bgp:bgp-routing/bgp-router/huawei-bgp-l3vpn:bgp-af-ipv4-vpn-instances/bgp-af-ipv4-vpn-instance/huawei-ethernet-vpn:advertise-to-ethernet-vpn |
Enables a VPN instance to advertise IP routes to an EVPN instance. |
N/A |
N/A |
/huawei-bd:bridge-domains/bridge-domain/huawei-ethernet-vpn:evpn-vpn-instance-name |
Specifies the name of an EVPN instance bound to a BD. |
The value is a string of 1 to 31 case-sensitive characters without spaces. |
For details, see /hw-ethvpn:vpn-instances/hw-ethvpn:vpn-instance/hw-ethvpn:vpn-instance-name. |
/huawei-bd:bridge-domains/bridge-domain/huawei-ethernet-vpn:arp-broadcast-suppress |
Enables ARP broadcast suppression. |
The value is of the Boolean type:
|
N/A |
/huawei-bd:bridge-domains/bridge-domain/huawei-ethernet-vpn:mismatch-discard |
Enables the action of discarding ARP packets matching no ARP entry when ARP broadcast suppression is enabled. |
The value is of the Boolean type:
|
This object can be configured only when the value of /huawei-bd:bridge-domains/bridge-domain/huawei-ethernet-vpn:arp-broadcast-suppress is true. |
/huawei-bd:bridge-domains/bridge-domain/huawei-ethernet-vpn: nd-multicast-suppress |
Enables the NS multicast suppression function. |
The value is of the Boolean type:
|
N/A |
/huawei-bd:bridge-domains/bridge-domain/huawei-ethernet-vpn: nd-mismatch-discard |
Configures the device to discard unmatched NS multicast packets when the NS multicast suppression function is enabled. |
The value is of the Boolean type:
|
This object can be configured only when the value of the /huawei-bd:bridge-domains/bridge-domain/huawei-ethernet-vpn: nd-multicast-suppress object is true. |
/huawei-l3vpn:vpn-instances/vpn-instance/huawei-bgp-l3vpn:ipv4-family/huawei-ethernet-vpn:evpntargets/evpntarget/evrf-rtvalue |
Specifies the value of a VPN target for EVPN routes to be imported into a VPN instance. |
The value is a string of 3 to 21 case-sensitive characters without spaces. |
N/A |
/huawei-l3vpn:vpn-instances/vpn-instance/huawei-bgp-l3vpn:ipv4-family/huawei-ethernet-vpn:evpntargets/evpntarget/evrf-rttype |
Specifies the type of a VPN target for EVPN routes to be imported into a VPN instance. |
The value is of the enumerated type:
|
N/A |
/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/huawei-bgp:bgp-routing/bgp-neighbors/bgp-neighbor/af-specific-config/l2vpn/evpn/active |
Enables the local device to exchange routing information with specified peers. |
The value is of the Boolean type:
|
N/A |
/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/huawei-bgp:bgp-routing/bgp-neighbors/bgp-neighbor/af-specific-config/l2vpn/evpn/route-reflector-client |
Enables the local device as a route reflector and its peers as the clients of the route reflector. |
The value is of the Boolean type:
|
This object can be configured only when the value of /ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/huawei-bgp:bgp-routing/bgp-neighbors/bgp-neighbor/af-specific-config/l2vpn/evpn/active is true. |
/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/huawei-bgp:bgp-routing/bgp-neighbors/bgp-neighbor/af-specific-config/l2vpn/evpn/huawei-ethernet-vpn:advertise-host-route-mode |
Enables the local device to advertise ARP routes or IRB routes to its BGP EVPN peers. |
The value is of the enumerated type:
|
N/A |
/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/huawei-bgp:bgp-routing /bgp-neighbors/bgp-neighbor/af-specific-config/l2vpn/evpn/huawei-ethernet-vpn:advertise-host-ipv6-route-mode |
Enables the local device to advertise ND routes or IRBv6 routes to its BGP EVPN peers. |
The value is of the enumerated type:
|
N/A |
/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/huawei-bgp:bgp-routing/bgp-router/af-configuration/l2vpn/evpn/vpn-target-filter |
Configures the device to filter received EVPN routes based on the VPN target. |
The value is of the enumerated type:
|
N/A |
/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/huawei-bgp:bgp-routing/bgp-router/af-configuration/l2vpn/evpn/cluster-id |
Configures the cluster ID of the route reflector in the BGP EVPN address family view. |
The value can be in either of the following formats:
|
N/A |
Configuring VXLAN EVPN
This section provides a sample of configuring VXLAN EVPN using the config method.
Operation |
XPATH |
|---|---|
config |
/huawei-ethernet-vpn:vpn-instances/vpn-instance/vpn-instance-name /huawei-ethernet-vpn:vpn-instances/vpn-instance/evpn-type /huawei-ethernet-vpn:vpn-instances/vpn-instance/route-distinguisher /huawei-ethernet-vpn:vpn-instances/vpn-instance/evpntargets/evpntarget/evrf-rtvalue /huawei-ethernet-vpn:vpn-instances/vpn-instance/evpntargets/evpntarget/evrf-rttype /ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/huawei-bgp:bgp-routing/bgp-router/huawei-bgp-l3vpn:bgp-af-ipv4-vpn-instances/bgp-af-ipv4-vpn-instance/huawei-ethernet-vpn:advertise-to-ethernet-vpn /huawei-bd:bridge-domains/bridge-domain/huawei-ethernet-vpn:evpn-vpn-instance-name /huawei-bd:bridge-domains/bridge-domain/huawei-ethernet-vpn:arp-broadcast-suppress /huawei-bd:bridge-domains/bridge-domain/huawei-ethernet-vpn:mismatch-discard /huawei-l3vpn:vpn-instances/vpn-instance/huawei-bgp-l3vpn:ipv4-family/huawei-ethernet-vpn:evpntargets/evpntarget/evrf-rtvalue /huawei-l3vpn:vpn-instances/vpn-instance/huawei-bgp-l3vpn:ipv4-family/huawei-ethernet-vpn:evpntargets/evpntarget/evrf-rttype |
Data Requirements
Item |
Data |
Description |
|---|---|---|
Name of an EVPN instance |
mm |
Set the name of the EVPN instance to mm. |
Type of an EVPN instance |
bdevpn |
Set the type of the EVPN instance to bd-mode. |
RD of an EVPN instance |
10:10 |
Set the RD of the EVPN instance to 10:10. |
Value of the VPN target of an EVPN instance |
10:10 |
Set the value of the VPN target of the EVPN instance to 10:10. |
Function of enabling a VPN instance to advertise IP routes to an EVPN instance |
Space |
Enable a VPN instance to advertise IP routes to the EVPN instance. |
Name of an EVPN instance bound to a BD |
mm |
Set the name of the EVPN instance bound to a BD to mm. |
ARP broadcast suppression |
true |
Enable ARP broadcast suppression. |
Action of discarding ARP packets matching no ARP entry when ARP broadcast suppression is enabled |
true |
Enable the action of discarding ARP packets matching no ARP entry when ARP broadcast suppression is enabled. |
Value of a VPN target for routes to be installed into the routing table of an EVPN instance |
2:2 |
Set the value of a VPN target for routes to be installed into the routing table of an EVPN instance to 2:2. |
Type of a VPN target for routes to be installed into the routing table of an EVPN instance |
both |
Set the type of a VPN target for routes to be installed into the routing table of an EVPN instance to both. |
Request Example
<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="5" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<edit-config>
<target>
<running/>
</target>
<config>
<hw-ethvpn:vpn-instances xmlns:hw-ethvpn="urn:huawei:params:xml:ns:yang:huawei-ethernet-vpn">
<hw-ethvpn:vpn-instance>
<hw-ethvpn:vpn-instance-name>mm</hw-ethvpn:vpn-instance-name>
<hw-ethvpn:evpn-type>bdevpn</hw-ethvpn:evpn-type>
<hw-ethvpn:route-distinguisher>10:10</hw-ethvpn:route-distinguisher>
<hw-ethvpn:evpntargets>
<hw-ethvpn:evpntarget>
<hw-ethvpn:evrf-rtvalue>10:10</hw-ethvpn:evrf-rtvalue>
<hw-ethvpn:evrf-rttype>both</hw-ethvpn:evrf-rttype>
</hw-ethvpn:evpntarget>
</hw-ethvpn:evpntargets>
</hw-ethvpn:vpn-instance>
</hw-ethvpn:vpn-instances>
<hw-l3vpn:vpn-instances xmlns:hw-l3vpn="urn:huawei:params:xml:ns:yang:huawei-l3vpn">
<hw-l3vpn:vpn-instance>
<hw-l3vpn:vpn-instance-name>kk</hw-l3vpn:vpn-instance-name>
<hw-bgp-vpn:ipv4-family xmlns:hw-bgp-vpn="urn:huawei:params:xml:ns:yang:huawei-bgp-l3vpn">
<hw-bgp-vpn:route-distinguisher>9:9</hw-bgp-vpn:route-distinguisher>
<hw-ethvpn:evpntargets xmlns:hw-ethvpn="urn:huawei:params:xml:ns:yang:huawei-ethernet-vpn">
<hw-ethvpn:evpntarget>
<hw-ethvpn:evrf-rtvalue>2:2</hw-ethvpn:evrf-rtvalue>
<hw-ethvpn:evrf-rttype>both</hw-ethvpn:evrf-rttype>
</hw-ethvpn:evpntarget>
</hw-ethvpn:evpntargets>
</hw-bgp-vpn:ipv4-family>
</hw-l3vpn:vpn-instance>
</hw-l3vpn:vpn-instances>
<rt:routing xmlns:rt="urn:ietf:params:xml:ns:yang:ietf-routing">
<rt:routing-instance>
<rt:name>bgp</rt:name>
<rt:routing-protocols>
<rt:routing-protocol>
<rt:type xmlns:huawei-bgp="urn:huawei:params:xml:ns:yang:huawei-bgp">huawei-bgp:bgp-routing-protocol</rt:type>
<rt:name>bgp</rt:name>
<hw-bgp:bgp-routing xmlns:hw-bgp="urn:huawei:params:xml:ns:yang:huawei-bgp">
<hw-bgp:bgp-router>
<hw-bgp:local-as-number>100</hw-bgp:local-as-number>
<hw-bgp-vpn:bgp-af-ipv4-vpn-instances xmlns:hw-bgp-vpn="urn:huawei:params:xml:ns:yang:huawei-bgp-l3vpn">
<hw-bgp-vpn:bgp-af-ipv4-vpn-instance>
<hw-bgp-vpn:vpn-instance-name>kk</hw-bgp-vpn:vpn-instance-name>
<hw-ethvpn:advertise-to-ethernet-vpn xmlns:hw-ethvpn="urn:huawei:params:xml:ns:yang:huawei-ethernet-vpn"> </hw-ethvpn:advertise-to-ethernet-vpn>
</hw-bgp-vpn:bgp-af-ipv4-vpn-instance>
</hw-bgp-vpn:bgp-af-ipv4-vpn-instances>
</hw-bgp:bgp-router>
</hw-bgp:bgp-routing>
</rt:routing-protocol>
</rt:routing-protocols>
</rt:routing-instance>
</rt:routing>
<bd:bridge-domains xmlns:bd="urn:huawei:params:xml:ns:yang:huawei-bd">
<bd:bridge-domain>
<bd:id>10</bd:id>
<hw-ethvpn:evpn-vpn-instance-name xmlns:hw-ethvpn="urn:huawei:params:xml:ns:yang:huawei-ethernet-vpn">mm</hw-ethvpn:evpn-vpn-instance-name>
<hw-ethvpn:arp-broadcast-suppress xmlns:hw-ethvpn="urn:huawei:params:xml:ns:yang:huawei-ethernet-vpn">true</hw-ethvpn:arp-broadcast-suppress>
<hw-ethvpn:mismatch-discard xmlns:hw-ethvpn="urn:huawei:params:xml:ns:yang:huawei-ethernet-vpn">true</hw-ethvpn:mismatch-discard>
</bd:bridge-domain>
</bd:bridge-domains>
<hw-vxlan:vxlan xmlns:hw-vxlan="urn:huawei:params:xml:ns:yang:huawei-vxlan">
<hw-vxlan:nve>
<hw-vxlan:id>1</hw-vxlan:id>
<hw-vxlan:vni-config>
<hw-vxlan:vni>10</hw-vxlan:vni>
<hw-vxlan:bgp> </hw-vxlan:bgp>
<hw-vxlan:bdid>10</hw-vxlan:bdid>
</hw-vxlan:vni-config>
</hw-vxlan:nve>
</hw-vxlan:vxlan>
</config>
</edit-config>
</rpc>
Response Example
Sample of successful response
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="5"> <ok/> </rpc-reply>
Sample of failed response
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="5">
<rpc-error>
<error-app-tag>-1</error-app-tag>
<error-message>The BGP protocol supports single instance only.</error-message>
<error-info>Error on node /ietf-routing:routing/routing-instance[name="bgp"]/routing-protocols/routing-protocol[type="huawei-bgp:bgp-routing-protocol",name="bgp"]/huawei-bgp:bgp-routing/bgp-router/local-as-number</error-info>
</rpc-error>
</rpc-reply>
Configuring L2VPN EVPN
This section provides a sample of configuring L2VPN EVPN using the config method.
Operation |
XPATH |
|---|---|
config |
/ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/huawei-bgp:bgp-routing/bgp-neighbors/bgp-neighbor/af-specific-config/l2vpn/evpn/active /ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/huawei-bgp:bgp-routing/bgp-neighbors/bgp-neighbor/af-specific-config/l2vpn/evpn/route-reflector-client /ietf-routing:routing/routing-instance/routing-protocols/routing-protocol/huawei-bgp:bgp-routing/bgp-neighbors/bgp-neighbor/af-specific-config/l2vpn/evpn/huawei-ethernet-vpn:advertise-host-route-mode |
Data Requirements
Item |
Data |
Description |
|---|---|---|
Function of enabling the local device to exchange routing information with specified peers |
true |
Enable the local device to exchange routing information with specified peers. |
Function of enabling the local device as a route reflector and its peers as the clients of the route reflector |
true |
Enable the local device as a route reflector and its peers as the clients of the route reflector. |
Function of enabling the local device to advertise ARP routes or IRB routes to its BGP EVPN peers |
arp |
Enable the local device to advertise ARP routes or IRB routes to its BGP EVPN peers. |
Request Example
<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="3" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<edit-config>
<target>
<running/>
</target>
<config>
<rt:routing xmlns:rt="urn:ietf:params:xml:ns:yang:ietf-routing">
<rt:routing-instance>
<rt:name>bgp</rt:name>
<rt:routing-protocols>
<rt:routing-protocol>
<rt:type xmlns:huawei-bgp="urn:huawei:params:xml:ns:yang:huawei-bgp">huawei-bgp:bgp-routing-protocol</rt:type>
<rt:name>bgp</rt:name>
<hw-bgp:bgp-routing xmlns:hw-bgp="urn:huawei:params:xml:ns:yang:huawei-bgp">
<hw-bgp:bgp-router>
<hw-bgp:local-as-number>100</hw-bgp:local-as-number>
</hw-bgp:bgp-router>
<hw-bgp:bgp-neighbors>
<hw-bgp:bgp-neighbor>
<hw-bgp:peer-address>10.1.1.1</hw-bgp:peer-address>
<hw-bgp:remote-as>100</hw-bgp:remote-as>
<hw-bgp:af-specific-config>
<hw-bgp:l2vpn>
<hw-bgp:evpn>
<hw-bgp:active>true</hw-bgp:active>
<hw-bgp:route-reflector-client>true</hw-bgp:route-reflector-client>
<hw-ethvpn:advertise-host-route-mode xmlns:hw-ethvpn="urn:huawei:params:xml:ns:yang:huawei-ethernet-vpn">arp</hw-ethvpn:advertise-host-route-mode>
</hw-bgp:evpn>
</hw-bgp:l2vpn>
</hw-bgp:af-specific-config>
</hw-bgp:bgp-neighbor>
</hw-bgp:bgp-neighbors>
</hw-bgp:bgp-routing>
</rt:routing-protocol>
</rt:routing-protocols>
</rt:routing-instance>
</rt:routing>
</config>
</edit-config>
</rpc>
Response Example
Sample of successful response
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="3"> <ok/> </rpc-reply>
Sample of failed response
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="3">
<rpc-error>
<error-type>application</error-type>
<error-tag>invalid-value</error-tag>
<error-severity>error</error-severity>
<error-path>/ietf-routing:routing/routing-instance[name='rt']/routing-protocols/routing-protocol[type='huawei-bgp:bgp-routing-protocol'][name='bgp']/huawei-bgp:bgp-routing/bgp-neighbors/bgp-neighbor[peer-address='10.1.1.1']/af-specific-config/l2vpn/evpn/route-reflector-client</error-path>
<error-message>validation failed(When condition "(../active='true') and (../../../../remote-as = ../../../../../../bgp-router/local-as-number)" not satisfied.).</error-message>
</rpc-error>
</rpc-reply>