EVPN Command Reference

Command Hierarchies

EVPN Configuration Commands

config
— service
epipe service-id [customer customer-id][test][create][vpn vpn-id][vc-switching]
— no epipe service-id
bgp
route-distinguisher [ip-addr:comm-val | as-number:ext-comm-val | auto-rd]
route-target {ext-community | {[export ext-community] [import ext-community]}}
[no] bgp-evpn
[no] evi value
[no] local-ac-name ac-name
[no] eth-tag value
[no] remote-ac-name ac-name
[no] eth-tag value
mpls
resolution {disabled|any|filter}
[no] bgp
[no] ldp
[no] rsvp
[no] sr-isis
[no] sr-ospf
[no] sr-te
[no] control-word
[no] entropy-label
[no] shutdown
vpls service-id [customer customer-id] [vpn vpn-id] [m-vpls] [b-vpls | i-vpls] [create]
— no vpls service-id
bgp
route-distinguisher [ip-addr:comm-val | as-number:ext-comm-val | auto-rd]
route-target {ext-community | {[export ext-community] [import ext-community]}}
vsi-export policy-name [policy-name...(up to 5 max)]
— no vsi-export
vsi-import policy-name [policy-name...(up to 5 max)]
— no vsi-import
[no] bgp-evpn
[no] evi value
[no] ip-route-advertisement [incl-host]
detect num-moves num-moves window minutes
[no] retry minutes
mpls
resolution {disabled|any|filter}
[no] bgp
[no] ldp
[no] rsvp
[no] sr-isis
[no] sr-ospf
[no] sr-te
[no] control-word
ecmp max-ecmp-routes
[no] entropy-label
[no] shutdown
vxlan
[no] shutdown
pbb
[no] use-es-bmac
[no] mldp
[no] root-and-leaf
[no] owner {bgp-ad | bgp-vpls | bgp-evpn-mpls}
[no] shutdown
[no] proxy-arp
[no] age-time seconds
dup-detect [anti-spoof-mac mac-address] [static-black-hole] window minutes num-moves count hold-down minutes|max
[no] send-refresh seconds
[no] static ip-address ieee-address
table-size table-size
[no] shutdown
[no] proxy-nd
[no] age-time seconds
dup-detect [anti-spoof-mac mac-address] [static-black-hole] window minutes num-moves count hold-down minutes|max
[no] send-refresh seconds
[no] static ip-address ieee-address {host | router}
table-size table-size
[no] shutdown
mac ieee-address [create ] sap sap-id monitor fwd-status
mac ieee-address [create ] spoke-sdp sdp-id:vc-id monitor fwd-status
mac ieee-address [create ] black-hole
— no mac ieee-address
vsd-domain name
— no vsd-domain vni
vxlan vni vni-id create
— no vxlan vni
— vprn
— interface
vpls
[no] evpn-tunnel
vsd
domain name [type {l2-domain | vrf-gre | vrf-vxlan | l2-domain-irb}] [create]
— no domain name
description description -string
[no] shutdown
service-range svc-id to svc-id
config
— service
— system
[no] bgp-auto-rd-range ip-address comm-val [1..65535] to [1..65535]
[no] bgp-evpn
ad-per-es-route-target [evi-rt | evi-rt-set route-distinguisher ip-address]
— no ethernet-segment name [ceate]
[no] es-activation-timer seconds
[no] esi esi
[no] lag lag-id
[no] multi-homing {single-active [no-esi-label
[no] port port-id
[no] sdp sdp-id
mode {manual | auto | off}
manual
[no] evi start [to to] primary
[no] isid start [to to] primary
[no] shutdown
[no] source-bmac-lsb MAC Lsb [ex-bmac-table-size size]
config
boot-timer seconds
config
— system
vsd
system-id name
— no system-id
xmpp
server xmpp-server-name [domain-name fqdn] [username user-name] [password password] [create]
— no server xmpp-server-name
[no] shutdown
vsd
[no] cli-user user-name
config
router
bgp
group
neighbor ip-address
def-recv-evpn-encap [mpls | vxlan]
config
python
python-policy name
vsd script script
<root>

Show Commands

show
— service
— id service-id
vxlan
es-pbr
esi esi
es-bmac ieee-address
service-using [vsd] [origin creation-origin]
system
ethernet-segment name name [all]
ethernet-segment name name evi [evi]
ethernet-segment name name isid [isid]
vsd [vsd] [origin creation-origin]
domain [domain-name] [association]
script
snippets snippet-name [instance snippet-instance] [detail]
summary
vxlan [vtep]
evpn-mpls [TEP ip-address]

Clear Commands

clear
— service
— statistics
— vsd
domain name
scripts name
clear
— system
— statistics
— xmpp
server xmpp-server-name

Debug Commands

debug
— system
xmpp [connection] [gateway] [message] [vsd] [iq] [all]
[no] xmpp
— vsd
scripts
[no] event
[no] cli
[no] errors
[no] executed-cmd
[no] state-change
[no] warnings
instance instance
[no] event
[no] cli
[no] errors
[no] executed-cmd
[no] state-change
[no] warnings

Tools Commands

tools
— dump
domain name name
evpn
usage
id service-id
— evpn-mpls [clear] [default-multicast-list]
vxlan [clear]
— evpn
usage
— system
ethernet-segment name evi evi df
ethernet-segment name isid isid df
vxlan [vtep]
dup-vtep-egrvni [clear]
tools
— perform
— service
— vsd
— domain
name [name] refresh-config
fd-domain-sync {full | diff}
evaluate-script domain-name [64 chars max] type [type] action script-action [vni vni-id] [rt-i ext-community] [rt-e ext-community] [metadata metadata] policy python-policy
tools
— perform
— system
xmpp

Command Descriptions

EVPN Configuration Commands

epipe

Syntax 
epipe service-id customer customer-id [vpn vpn-id] [vc-switching] [create]
epipe service-id [test] [create]
no epipe service-id
Context 
config>service
Description 

This command configures an Epipe service instance. This command is used to configure a point-to-point epipe service. An Epipe connects two endpoints defined as Service Access Points (SAPs). Both SAPs may be defined in one or they may be defined in separate devices connected over the service provider network. When the endpoint SAPs are separated by the service provider network, the far end SAP is generalized into a Service Distribution Point (SDP). This SDP describes a destination and the encapsulation method used to reach it. In addition to the SDPs, endpoint SAPs can also be connected by EVPN destinations.

No MAC learning or filtering is provided on an Epipe.

When a service is created, the customer keyword and customer-id must be specified and associates the service with a customer. The customer-id must already exist having been created using the customer command in the service context. Once a service has been created with a customer association, it is not possible to edit the customer association. The service must be deleted and recreated with a new customer association.

Once a service is created, the use of the customer customer-id is optional for navigating into the service configuration context. Attempting to edit a service with the incorrect customer-id specified will result in an error.

By default, no epipe services exist until they are explicitly created with this command.

The no form of this command deletes the epipe service instance with the specified service-id. The service cannot be deleted until the service has been shutdown.

Parameters 
service-id—
The unique service identification number or string identifying the service in the service domain. This ID must be unique to this service and may not be used for any other service of any type. The service-id must be the same number used for every node on which this service is defined.
Values—
service-id: 1 to 2147483648
svc-name: 64 characters maximum
customer customer-id
Specifies the customer ID number to be associated with the service. This parameter is required on service creation and optional for service editing or deleting.
Values—
1 to 2147483647
vpn vpn-id—
Specifies the VPN ID number which allows you to identify virtual private networks (VPNs) by a VPN ID. If this parameter is not specified, the VPN ID uses the same service ID number.
Values—
1 to 2147483647
Values—
null (0)
vc-switching—
Specifies if the pseudowire switching signaling is used for the spoke SDPs configured in this service. When an epipe is configured with vc-switching, no bgp-evpn is allowed.
test—
Specifies a unique test service type for the service context which will contain only a SAP configuration. The test service can be used to test the throughput and performance of a path for MPLS-TP PWs. This parameter applies to the 7450 ESS and 7750 SR only.
create—
Keyword used to create the service instance. The create keyword requirement can be enabled/disabled in the environment>create context.

vpls

Syntax 
vpls service-id customer customer-id vpn vpn-id [m-vpls] [bvpls | i-vpls] [create]
no vpls service-id
Context 
config>service
Description 

This command creates or edits a Virtual Private LAN Services (VPLS) instance. The vpls command is used to create or maintain a VPLS service. If the service-id does not exist, a context for the service is created. If the service-id exists, the context for editing the service is entered.

A VPLS service connects multiple customer sites together acting like a zero-hop, Layer 2 switched domain. A VPLS is always a logical full mesh.

When a service is created, the create keyword must be specified if the create command is enabled in the environment context. When a service is created, the customer keyword and customer-id must be specified and associates the service with a customer. The customer-id must already exist having been created using the customer command in the service context. Once a service has been created with a customer association, it is not possible to edit the customer association. The service must be deleted and recreated with a new customer association.

To create a management VPLS on a 7450 ESS, the m-vpls keyword must be specified. See section Hierarchical VPLS Redundancy for an introduction to the concept of management VPLS.

Once a service is created, the use of the customer customer-id is optional for navigating into the service configuration context. Attempting to edit a service with the incorrect customer-id specified will result in an error.

More than one VPLS service may be created for a single customer ID.

By default, no VPLS instances exist until they are explicitly created.

The no form of this command deletes the VPLS service instance with the specified service-id. The service cannot be deleted until all SAPs and SDPs defined within the service ID have been shutdown and deleted, and the service has been shutdown.

Parameters 
service-id—
The unique service identification number or string identifying the service in the service domain. This ID must be unique to this service and may not be used for any other service of any type. The service-id must be the same number used for every router on which this service is defined.
Values—
service-id: 1 to 2147483648
svc-name: 64 characters maximum
customer customer-id
Specifies the customer ID number to be associated with the service. This parameter is required on service creation and optional for service editing or deleting.
Values—
1 to 2147483647
vpn vpn-id—
Specifies the VPN ID number which allows you to identify virtual private networks (VPNs) by a VPN identification number.
Values—
1 to 2147483647
Values—
null (0)
m-vpls—
Specifies a management VPLS.
b-vpls | i-vpls—
Creates a backbone-vpls or ISID-vpls.

bgp

Syntax 
bgp
Context 
config>service>vpls
config>service>epipe
Description 

This command enables the context to configure the BGP related parameters for BGP AD, BGP VPLS and EVPN.

route-target

Syntax 
route-target {ext-community | {[export ext-community] [import ext-community]}}
no route-target
Context 
config>service>vpls>bgp-ad
config>service>vpls>bgp
config>service>epipe>bgp
Description 

This command configures the route target (RT) component that will be signaled in the related MP- BGP attribute to be used for BGP auto-discovery, BGP VPLS, BGP Multi-Homing and EVPN if these features are configured in this VPLS service.

If this command is not used, the RT is built automatically using the VPLS ID. The ext-comm can have the same two formats as the VPLS ID, a two-octet AS-specific extended community, IPv4 specific extended community. For BGP EVPN enabled VPLS and Epipe services, the route target can also be auto-derived from the evi value (config>service>vpls>bgp-evpn>evi or config>service>epipe>bgp-evpn>evi ) if this command is not configured. See the evi command description for more information.

Parameters 
export ext-community
Specifies communities allowed to be sent to remote PE neighbors.
import ext-community
Specifies communities allowed to be accepted from remote PE neighbors.

vsi-export

Syntax 
vsi-export policy-name [policy-name...(up to 5 max)]
no vsi-export
Context 
config>service>vpls>bgp-ad
config>service>vpls>bgp
Description 

This command specifies the name of the VSI export policies to be used for BGP auto-discovery, BGP VPLS and BGP Multi-Homing if these features are configured in this VPLS service. If multiple policy names are configured, the policies are evaluated in the order they are specified. The first policy that matches is applied.

The policy name list is handled by the SNMP agent as a single entity.

vsi-import

Syntax 
vsi-import policy-name [policy-name...(up to 5 max)]
no vsi-import
Context 
config>service>vpls>bgp-ad>vsi-id
config>service>vpls>bgp
Description 

This command specifies the name of the VSI import policies to be used for BGP auto-discovery, BGP VPLS and BGP Multi-Homing if these features are configured in this VPLS service. If multiple policy names are configured, the policies are evaluated in the order they are specified. The first policy that matches is applied.

The policy name list is handled by the SNMP agent as a single entity.

route-distinguisher

Syntax 
route-distinguisher [ip-addr:comm-val | as-number:ext-comm-val]
route-distinguisher auto-rd
no route-distinguisher
Context 
config>service>vpls>bgp
config>service>epipe>bgp
Description 

This command configures the Route Distinguisher (RD) component that will be signaled in the MP-BGP NLRI for L2VPN and EVPN families. This value will be used for BGP-AD, BGP VPLS and BGP Multi-Homing NLRI if these features are configured.

If this command is not configured, the RD is automatically built using the BGP-AD VPLS ID. The following rules apply:

  1. if BGP AD VPLS-id is configured & no RD is configured under BGP node - RD = VPLS-ID
  2. if BGP AD VPLS-id is not configured then an RD value must be configured under BGP node (this is the case when only BGP VPLS is configured)
  3. if BGP AD VPLS-id is configured and an RD value is also configured under BGP node, the configured RD value prevails

Values and format (6 bytes, other 2 bytes of type will be automatically generated)

Alternatively, the auto-rd option allows the system to automatically generate an RD based on the bgp-auto-rd-range command configured at the service level. For bgp-evpn enabled VPLS and Epipe services, the route-distinguisher value can also be auto-derived from the evi value (config>service>vpls>bgp-evpn>evi or config>service>epipe>bgp-evpn>evi) if this command is not configured. See the evi command description for more information.

Parameters 
ip-addr:comm-val—
Specifies the IP address.
Values—

ip-addr

a.b.c.d

comm-val

0 to 65535

as-number:ext-comm-val—
Specifies the AS number.
Values—

as-number

1 to 65535

ext-comm-val

0 to 4294967295

auto-rd—
the system will generate an RD for the service according to the IP address and range configured in the bgp-auto-rd-range command.

vsi-import

Syntax 
vsi-import policy-name [policy-name...(up to 5 max)]
no vsi-import
Context 
config>service>vpls>bgp-ad>vsi-id
config>service>vpls>bgp
Description 

This command specifies the name of the VSI import policies to be used for BGP auto-discovery, BGP VPLS and BGP Multi-Homing if these features are configured in this VPLS service. If multiple policy names are configured, the policies are evaluated in the order they are specified. The first policy that matches is applied.

The policy name list is handled by the SNMP agent as a single entity.

bgp-auto-rd-range

Syntax 
bgp-auto-rd-range ip-address comm-val comm-val to comm-val
no bgp-auto-rd-range
Context 
config>service>system
Description 

This command defines the type-1 route-distinguisher ipv4 address and community value range within which the system will select a route-distinguisher for the bgp-enabled services using auto-rd.

Interactions:

This command is used along with the route-distinguisher auto-rd command supported in VPLS, VPRN and Epipe services. The system forces the user to create a bgp-auto-range before the auto-rd option can be used in the services.

Note that the system will keep allocating values for services configured with route-distinguisher auto-rd as long as there are available community values within the configured range. Once the command is added, the following changes are allowed:

  1. The ip-address can be changed without modifying the comm-val range, even if services using auto-rd are present. The affected routes will be withdrawn and re-advertised with the new route-distinguishers.
  2. The comm-val range can be modified as long as no conflicting values are present in the new range. For example, the user may expand the range as long as the new range does not overlap with existing manual route-distinguishers. The user may also reduce the range as long as the new range can accommodate the already allocated auto-RDs.
Parameters 
ip-address—
Specifies the IPv4 address used in the first 4 octets of all the type-1 auto route-distinguishers selected by the system.
comm-val—
Specifies the community value of the type-1 auto route-distinguisher.
Values—
0 to 65535

bgp-evpn

Syntax 
[no] bgp-evpn
Context 
config>service>vpls
config>service>system
config>service>epipe
Description 

This command enables the context to configure the BGP EVPN parameters in the base instance.

ad-per-es-route-target

Syntax 
ad-per-es-route-target [evi-rt | evi-rt-set route-distinguisher ip-address]
no ad-per-es-route-target
Context 
config>service>system>bgp-evpn
Description 

This command controls how Ethernet AD per-ES routes are generated.

The system can either send a separate Ethernet AD per-ES route per service, or an Ethernet AD per-ES routes aggregating the route-targets for multiple services. While both alternatives will inter-operate, RFC 7432 states that the EVPN Auto-Discovery per-ES route must be sent with a set of route-targets corresponding to all the EVIs defined on the ethernet-segment. The command supports both options.

The default option ad-per-es-route-target evi-rt configures the system to send a separate AD per-ES route per service.

When enabled, the evi-rt-set option allows the aggregation of routes: A single AD per-ES route with the associated RD (ip-address:1) and a set of EVI route-targets will be advertised (to a maximum of 128). When a significant number of EVIs are defined in the ethernet-segment (hence the number of route-targets), the system will send more than one route. For example:

  1. AD per-ES route for evi-rt-set 1 will be sent with RD ip-address:1
  2. AD per-ES route for evi-rt-set 2 will be sent with RD ip-address:2
Default 

ad-per-es-route-target evi-rt

Parameters 
evi-rt
Specifies the option to advertise a separate AD per-ES route per service.
evi-rt-set
Specifies the option to advertise a set of AD per-ES routes aggregating the route-targets for all the services in the ethernet-segment.
route-distinguisher ip-address—
Specifies the ip-address part of the route-distinguisher being used in the evi-rt-set option.

route-distinguisher

Syntax 
route-distinguisher [ip-addr:comm-val | as-number:ext-comm-val]
no route-distinguisher
Context 
config>service>system>bgp-evpn
Description 

This command configures the Route Distinguisher (RD) component that will be signaled in the MP-BGP NLRI for EVPN corresponding to the base EVPN instance (Ethernet Segment routes). If the route-distinguisher component is not configured, the system will use system:ip-address as the default route-distinguisher

Default 

no route-distinguisher

Parameters 
ip-addr:comm-val—
Specifies the IP address.
Values—

ip-addr

a.b.c.d

comm-val

0 to 65535

as-number:ext-comm-val—
Specifies the AS number.
Values—

as-number

1 to 65535

ext-comm-val

0 to 4294967295

ethernet-segment

Syntax 
ethernet-segment name create
no ethernet-segment
Context 
config>service>system>bgp-evpn
Description 

This command configures an ethernet-segment instance its corresponding name.

Parameters 
name—
Specifies the 28-character ethernet-segment name.

es-activation-timer

Syntax 
es-activation-timer seconds
no es-activation-timer
Context 
config>service>system>bgp-evpn>ethernet-segment
Description 

This command configures the ethernet-segment activation timer for a given ethernet-segment. The es-activation-timer delays the activation of a given ethernet-segment on a given PE that has been elected as DF (Designated Forwarder). Only when the es-activation-timer has expired, the SAP/SDP-binding associated to an ethernet-segment can be activated (in case of single-active multi-homing) or added to the default-multicast-list (in case of all-active multi-homing).

If no es-activation-timer is configured, the system will use the value configured at config>redundancy>bgp-evpn-multi-homing>es-activation-timer if configured. Otherwise the system will use a default value of 3 seconds.

Default 

no es-activation-timer

Parameters 
seconds—
Specifies the number of seconds for the es-activation-timer.
Values—
0 to 100 seconds

esi

Syntax 
esi value
no esi
Context 
config>service>system>bgp-evpn>ethernet-segment
Description 

This command configures the 10-byte ethernet-segment identifier associated to the ethernet-segment that will be signaled in the BGP-EVPN routes. The esi value cannot be changed unless the ethernet-segment is shutdown. Reserved esi values (0 and MAX-ESI) are not allowed.

Parameters 
value—
Specifies the 10-byte esi.
Values—
00-11-22-33-44-55-66-77-88-99
Using any of these separators ('-',':')

lag

Syntax 
lag lag-id
no lag
Context 
config>service>system>bgp-evpn>ethernet-segment
Description 

This command configures a lag-id associated to the ethernet-segment. When the ethernet-segment is configured as all-active. only a lag can be associated to the ethernet-segment. When the ethernet-segment is configured as single-active, then a lag, port or sdp can be associated to the ethernet-segment. In either case, only one of the three objects can be configured in the ethernet-segment. A given lag can be part of only one ethernet-segment.

Default 

no lag

Parameters 
lag-id—
Specifies the lag-id associated with the ethernet-segment.
Values—
1 to 800

multi-homing

Syntax 
multi-homing single-active [no-esi-label]
multi-homing all-active
no multi-homing
Context 
config>service>system>bgp-evpn>ethernet-segment
Description 

This command configures the multi-homing mode for the ethernet-segment as single-active or all-active multi-homing, as defined in RFC7432.

By default, the use of esi-label is enabled for all-active and single-active as defined in RFC7432 (for single-active multi-homing, the esi-label is used to avoid transient loops).

When single-active no-esi-label is specified, the system will not allocate a label for the esi and hence advertise esi label 0 to peers. Even if the esi is configured to not send the esi-label, upon reception of an esi-label from a peer, the PE will always send traffic to that peer using the received esi-label.

Default 

no multi-homing

Parameters 
single-active—
Configures single-active mode for the ethernet-segment.
all-active—
Configures the system to not send an esi-label for single-active mode.
no-esi-label—
Configures single-active mode for the ethernet-segment.

port

Syntax 
port port-id
no port
Context 
config>service>system>bgp-evpn>ethernet-segment
Description 

This command configures a port-id associated with the ethernet-segment. If the ethernet-segment is configured as all-active only a lag can be associated to the ethernet-segment. If the ethernet-segment is configured as single-active, then a lag, port or sdp can be associated to the ethernet-segment. In any case, only one of the three objects can be configured in the ethernet-segment. A given port can be part of only one ethernet-segment. Only ethernet ports can be added to an ethernet-segment.

Default 

no port

Parameters 
port-id—
Specifies the port ID associated to the ethernet-segment.

port-id

slot/mda/port [.channel]

eth-sat-id

esat-id/slot/port

esat

keyword

id

1 to 20

pxc-id

pxc-id.sub-port

pxc

keyword

id

1 to 64

sub-port

a, b

sdp

Syntax 
sdp sdp-id
no sdp
Context 
config>service>system>bgp-evpn>ethernet-segment
Description 

This command configures an sdp-id associated to the ethernet-segment. If the ethernet-segment is configured as all-active only a lag can be associated to the ethernet-segment. If the ethernet-segment is configured as single-active, then a lag, port or sdp can be associated to the ethernet-segment. In any case, only one of the three objects can be configured in the ethernet-segment. A given sdp can be part of only one ethernet-segment. Only user-configured sdps can be added to an ethernet-segment.

Default 

no sdp

Parameters 
sdp-id—
Specifies the IP address.
Values—
1 to 17407

service-carving

Syntax 
service-carving
Context 
config>service>system>bgp-evpn>ethernet-segment
Description 

The service-carving algorithm determines the PE that is the Designated Forwarder (DF) in a given ethernet-segment and for a given service. This command enables the context to configure service-carving in the ethernet-segment.

mode

Syntax 
mode {manual | auto | off}
Context 
config>service>system>bgp-evpn>ethernet-segment>service-carving
Description 

This command configures the service-carving mode. This determines how the DF is elected for a given ethernet-segment and service.

Default 

mode auto

Parameters 
auto—
This mode is the service-carving algorithm defined in RFC7432. The DF for the service is calculated based on the modulo function of the service (identified by either the evi or the isid) and the number of PEs.
manual—
In this mode the DF is elected based on the manual configuration added in the service-carving>manual context.
off—
In this mode all the services elect the same DF PE (assuming the same PEs are active for all the configured services). The PE with the lowest IP is elected as DF for the ethernet-segment.

manual

Syntax 
manual
Context 
config>service>system>bgp-evpn>ethernet-segment>service-carving
Description 

This command enables the context to configure service-carving in a manual way, that is, configuring the evis or isids for which the PE is DF.

evi

Syntax 
evi start [to to] primary
no evi
Context 
config>service>system>bgp-evpn>ethernet-segment>service-carving>manual
Description 

This command configures the evi ranges for which the PE is DF.

Note that multiple individual evi values and multiple evi ranges are allowed. The PE will be non-DF for the evi values not defined as primary.

Parameters 
start—
This specifies the initial evi value of the range for which the PE is DF.
Values—
1 to 65535
to—
This specifies the end evi value of the range for which the PE is DF. If not configured, only the individual start value will be considered.
Values—
1 to 65535
primary—
Specifies that the PE is DF for the configured evi range.

isid

Syntax 
isid start [to to] primary
no sid
Context 
config>service>system>bgp-evpn>ethernet-segment>service-carving>manual
Description 

This command configures the isid ranges for which the PE is DF. Note that multiple individual isid values and multiple isid ranges are allowed. The PE will be non-DF for isid values not defined as primary.

Parameters 
start—
This specifies the initial isid value of the range for which the PE is DF.
Values—
1 to 16777215
to—
This specifies the end isid value of the range for which the PE is DF. If not configured, only the individual start value will be considered.
Values—
1 to 16777215
primary—
Specifies that the PE is DF for the configured evi range.

shutdown

Syntax 
no shutdown
Context 
config>service>system>bgp-evpn>ethernet-segment
Description 

This command changes the administrative status of the ethernet-segment.

The user can do no shutdown only when esi, multi-homing and lag/port/sdp are configured. If the ethernet-segment or the corresponding lag/port/sdp shutdown, the ethernet-segment route and the AD per-ES routes will be withdrawn. No changes are allowed when the ethernet-segment is no shutdown

Default 

shutdown

source-bmac-lsb

Syntax 
source-bmac-lsb MAC Lsb [es-bmac-table-size size]
no source-bmac-lsb
Context 
config>service>system>bgp-evpn>ethernet-segment
Description 

This command configures the least significant two bytes of the BMAC used as source BMAC for packets generated from the ethernet-segment in PBB-EVPN.

When the multi-homing mode is all-active, this value and the first high order four bytes must match on all the PEs that are part of the same ethernet-segment.

The es-bmac-table-size parameter modifies the default value (8) for the maximum number of virtual bmacs that can be associated to the ethernet-segment, that is, the es-bmacs. When the source-bmac-lsb is configured, the associated es-bmac-table-size is reserved out of the total FDB. Note that the es-bmac will consume a separate BMAC per B-VPLS that is linked to an ethernet-segment

Parameters 
MAC Lsb—
This specifies the two least significant bytes of the es-bmac.
Values—
1 to 65535 or xx-xx or xx:xx
size—
This specifies the reserved space in the FDB for a given es-bmac. By default the system reserves 8 entries for a given ethernet-segment BMAC.
Values—
1 to 511999
Values—
8

redundancy

Syntax 
redundancy
Context 
config
Description 

This command enables the context to configure the global redundancy parameters.

bgp-evpn-multi-homing

Syntax 
bpg-evpn-multi-homing
Context 
config>redundancy
config>redundancy
Description 

This command enables the context to configure the bgp-evpn global timers

boot-timer

Syntax 
boot-timer seconds
Context 
config>redundancy>bgp-evpn-multi-homing
Description 

When the PE boots up, the boot-timer will allow the necessary time for the control plane protocols to come up before bringing up the ethernet-segments and running the DF algorithm.

The following considerations apply to the functionality:

  1. The boot-timer is configured at the system level config>redundancy>bgp-evpn-multi-homing# boot-timer. The configured value must provide enough time to allow the IOMs and BGP sessions to come up before exchanging ES routes and running the DF election for each EVI/ISID.
  2. The boot-timer is synchronized across CPMs and is relative to the System UP-time; hence it is not subject to change or reset upon CPM switchover.
  3. The boot-timer is never interrupted (the es-activation-timer, however, can be interrupted if there is a new event triggering the DF election).
  4. The boot-timer runs per EVI/ISID on the ES's in the system. While system-up-time < boot-timer is true, the system does not run the DF election for any EVI/ISID. Once the boot-timer expires, the DF election for the EVI/ISID is run and if the system is elected DF for the EVI/ISID, the es-activation-timer will kick-in.
  5. The system will not advertise ES routes until the boot timer has expired. This guarantees that the peer ES PEs do not run the DF election until the PE is ready to become the DF, if required.
Default 

boot-timer 10

Parameters 
seconds—
Specifies the number of seconds for the boot-timer.
Values—
0 to 600 seconds

es-activation-timer

Syntax 
es-activation-timer seconds
Context 
config>redundancy>bgp-evpn-multi-homing
Description 

This command configures the global ethernet-segment activation timer. The es-activation-timer delays the activation of a given ethernet-segment on a given PE that has been elected as DF (Designated Forwarder). Only when the es-activation-timer has expired, the SAP/SDP-binding associated to an ethernet-segment can be activated (in case of single-active multi-homing) or added to the default-multicast-list (in case of all-active multi-homing).

The es-activation-timer configured at the ethernet-segment level supersedes this global es-activation-timer.

Default 

es-activation-timer 3

Parameters 
seconds—
Specifies the number of seconds for the es-activation-timer.
Values—
0 to 100 seconds

cfm-mac-advertisement

Syntax 
[no] cfm-mac-advertisement
Context 
config>service>vpls>bgp-evpn
Description 

This command enables the advertisement and withdrawal, as appropriate, of the IEEE MAC address associated with the MP (MEP & MIP) created on a SAP, Spoke or Mesh, in an EVPN service.

The up-date occurs each time an MP is added or deleted, or an IEEE MAC address is changed for an MP on a SAP, Spoke or Mesh within the service. The size of the update depends on the number of MPs in the service affected by the modification.

Note that you should only enable this functionality, as required, for services that require a resident MAC address to properly forward unicast traffic and that do not perform layer two MAC learning as part of the dataplane.

Local MP IEEE MAC addresses are not stored in the local FDB and, as such, cannot be advertised through a control plane to a peer without this command.

The no version of the command disables the functionality and withdraws all previously advertised MP IEEE MAC addresses.

evi

Syntax 
evi value
[no] evi
Context 
config>service>vpls>bgp-evpn
config>service>epipe>bgp-evpn
Description 

This command allows you to specify a 2-byte EVPN instance unique in the system. It is used for the service-carving algorithm for multi-homing and auto-deriving route-target and route-distinguishers.

If not specified, the value will be zero and no route-distinguisher or route-targets will be auto-derived from it. If the evi value is specified and no other route-distinguisher/route-target are configured in the service, then the following rules apply:

  1. the route distinguisher is derived from <system_ip>:evi
  2. the route-target is derived from <autonomous-system>:evi

Note that if vsi-import and export policies are configured, the route-target must be configured in the policies and those values take preference over the auto-derived route-targets. The operational route-target for a service will be shown in the show service id bgp command.

The no version of the command will set the evi value back to zero.

Parameters 
value
Specifies the evi.
Values—
1 to 65535

ingress-replication-incl-mcast-advertisement

Syntax 
[no] ingress-replication-incl-mcast-advertisement
Context 
config>service>vpls>bgp-evpn
Description 

This command enables and disables the advertisement of the Inclusive Multicast Ethernet Tag route (IMET route) with tunnel-type Ingress-Replication in the PMSI Tunnel Attribute, or with the tunnel-type Composite Point-to-Multipoint and Ingress-Replication (P2MP+IR) in the root-and-leaf nodes. The following considerations must be taken into account:

  1. When no ingress-replication-incl-mcast-advertisement is configured, no IMET routes will be sent for the service unless the provider-tunnel is configured with owner bgp-evpn-mpls and root-and-leaf, in which case, an IMET-P2MP route is sent.
  2. When ingress-replication-incl-mcast-advertisement and provider-tunnel are configured for bgp-evpn-mpls with root-and-leaf, the system will send an IMET-P2MP-IR route, that is, an IMET route with a composite P2MP+IR tunnel type.
Default 

ingress-replication-incl-mcast-advertisement

ip-route-advertisement

Syntax 
ip-route-advertisement [incl-host]
no ip-route-advertisement
Context 
config>service>vpls>bgp-evpn
Description 

This command enables and disables the advertisement of IP prefixes in EVPN.If enabled, any active route in the R-VPLS VPRN route table will be advertised in EVPN using the VPLS BGP configuration. Note that the interface host addresses are not advertised in EVPN unless the ip-route-advertisement incl-host command is enabled.

Default 

no ip-route-advertisement

Parameters 
incl-host—
Specifies to advertise the interface host addresses in EVPN.

local-ac-name

Syntax 
[no] local-ac-name ac-name
Context 
config>service>epipe>bgp-evpn
Description 

This command enables and disables the context in which the local ethernet tag value is configured.

Default 

no local-ac-name

Parameters 
ac-name
Specifies the name of the local attachment circuit.

remote-ac-name

Syntax 
[no] remote-ac-name ac-name
Context 
config>service>epipe>bgp-evpn
Description 

This command enables and disables the context in which the remote ethernet tag value is configured.

Default 

no remote-ac-name

Parameters 
ac-name
Specifies the name of the remote attachment circuit.

eth-tag

Syntax 
[no] eth-tag tag-value
Context 
config>service>epipe>bgp-evpn>local-ac-name
config>service>epipe>bgp-evpn>remote-ac-name
Description 

This command configures the ethernet tag value. When configured in the local-ac-name context, the system will use the value in the advertised AD per-EVI route sent for the attachment circuit. When configured in the remote-ac-name context, the system will compare that value with the eth-tag value of the imported AD per-EVI routes for the service. If there is a match, the system will create an EVPN destination for the Epipe.

Parameters 
tag-value
Specifies the eth-tag value of the attachment circuit.
Values—
1-16777215

mac-advertisement

Syntax 
[no] mac-advertisement
Context 
config>service>vpls>bgp-evpn
Description 

The mac-advertisement command enables the advertisement in BGP of the learned macs on SAPs and SDP bindings. When the mac-advertisement is disabled, the local macs will be withdrawn in BGP.

Default 

mac-advertisement

mac-duplication

Syntax 
mac-duplication
Context 
config>service>vpls>bgp-evpn
Description 

This command enables the context to configure the BGP EVPN MAC duplication parameters.

detect

Syntax 
detect num-moves num-moves window minutes
Context 
config>service>vpls>bgp-evpn>mac-duplication
Description 

The mac-duplication featured is always enabled by default. This command modifies the default behavior. mac-duplication monitors the number of moves of a MAC address for a period of time (window).

Default 

num-moves 5 window 3

Parameters 
num-moves num-moves
Identifies the number of MAC moves in a VPLS service. The counter is incremented when a given MAC is locally relearned in the FDB or flushed from the FDB due to the reception of a better remote EVPN route for that MAC.
Values—
3 to10 minutes
Values—
3 minutes
window minutes
Specifies the length of the window in minutes.
Values—
1 to 15
Values—
3

retry

Syntax 
retry minutes
no retry
Context 
config>service>vpls>bgp-evpn>mac-duplication
Description 

Specifies the timer after which the MAC in hold-down state is automatically flushed and the mac-duplication process starts again. This value is expected to be equal to two times or more than that of window.

If no retry is configured, this implies that, once mac-duplication is detected, MAC updates for that MAC will be held down till the user intervenes or a network event (that flushes the MAC) occurs.

Default 

9 minutes

Parameters 
minutes—
Specifies the BGP EVPN MAC duplication retry in minutes.
Values—
2 to 60 minutes

mpls

Syntax 
mpls
Context 
config>service>vpls>bgp-evpn
config>service>epipe>bgp-evpn
Description 

This command enables the context to configure the BGP EVPN MPLS parameters.

auto-bind-tunnel

Syntax 
auto-bind-tunnel
Context 
config>service>vpls>bgp-evpn>mpls
config>service>epipe>bgp-evpn>mpls
Description 

This command enables the context to configure automatic binding of a BGP-EVPN service using tunnels to MP-BGP peers.

The auto-bind-tunnel node is simply a context to configure the binding of EVPN routes to tunnels. The user must configure the resolution option to enable auto-bind resolution to tunnels in TTM. The following configurations are available:

  1. If the resolution option is explicitly set to disabled, the auto-binding to the tunnel is removed.
  2. If resolution is set to any, then any supported tunnel type in EVPN context will be selected following TTM preference.
  3. If one or more explicit tunnel types are specified using the resolution-filter option, then only these tunnel types will be selected again following the TTM preference.

The following tunnel types are supported in a BGP-EVPN MPLS context in order of preference: RSVP, LDP, SR-ISIS, SR-OSPF, SR-TE, and BGP.

The ldp value instructs BGP to search for an LDP LSP with a FEC prefix corresponding to the address of the BGP next-hop.

The rsvp value instructs BGP to search for the best metric RSVP LSP to the address of the BGP next-hop. This address can correspond to the system interface or to another loopback used by the BGP instance on the remote node. The LSP metric is provided by MPLS in the tunnel table. In the case of multiple RSVP LSPs with the same lowest metric, BGP selects the LSP with the lowest tunnel-id.

When the sr-isis (sr-ospf) value is enabled, a SR tunnel to the BGP next-hop is selected in the TTM from the lowest numbered ISIS (OSPF) instance.

The sr-te value instructs the code to search for the best metric SR-TE LSP to the address of the BGP next-hop. The LSP metric is provided by MPLS in the tunnel table. In the case of multiple SR-TE LSPs with the same lowest metric, BGP selects the LSP with the lowest tunnel-id.

The bgp value instructs BGP EVPN to search for a BGP LSP to the address of the BGP next-hop. If the user does not enable the BGP tunnel type, inter-area or inter-as prefixes will not be resolved.

The user must set resolution to filter to activate the list of tunnel-types configured under resolution-filter.

resolution

Syntax 
resolution {disabled | any | filter}
Context 
config>service>vpls>bgp-evpn>mpls>auto-bind-tunnel
config>service>epipe>bgp-evpn>mpls>auto-bind-tunnel
Description 

This command configures the resolution mode in the automatic binding of a BGP-EVPN MPLS service to tunnels to MP-BGP peers.

Parameters 
any—
Enables the binding to any supported tunnel type in a BGP-EVPN MPLS context following TTM preference.
disabled—
Disables the automatic binding of a BGP-EVPN MPLS service to tunnels to MP-BGP peers.
filter—
Enables the binding to the subset of tunnel types configured under resolution-filter.

resolution-filter

Syntax 
resolution-filter
Context 
config>service>vpls>bgp-evpn>mpls>auto-bind-tunnel
config>service>epipe>bgp-evpn>mpls>auto-bind-tunnel
Description 

This command enables the context that allows the configuration of the subset of tunnel types that can be used in the resolution of BGP-EVPN routes within the automatic binding of BGP-EVPN MPLS service to tunnels to MP-BGP peers.

The following tunnel types are supported in a BGP-EVPN MPLS context in order of preference: RSVP, LDP, Segment Routing (SR), and BGP.

bgp

Syntax 
[no] bgp
Context 
config>service>vpls>bgp-evpn>mpls>auto-bind-tunnel>resolution-filter
config>service>epipe>bgp-evpn>mpls>auto-bind-tunnel>resolution-filter
Description 

Selects the BGP tunnel type.

ldp

Syntax 
[no] ldp
Context 
config>service>vpls>bgp-evpn>mpls>auto-bind-tunnel>resolution-filter
config>service>epipe>bgp-evpn>mpls>auto-bind-tunnel>resolution-filter
Description 

Selects the LDP tunnel type.

rsvp

Syntax 
[no] rsvp
Context 
config>service>vpls>bgp-evpn>mpls>auto-bind-tunnel>resolution-filter
config>service>epipe>bgp-evpn>mpls>auto-bind-tunnel>resolution-filter
Description 

Selects the RSVP-TE tunnel type.

sr-isis

Syntax 
[no] sr-isis
Context 
config>service>vpls>bgp-evpn>mpls>auto-bind-tunnel>resolution-filter
config>service>epipe>bgp-evpn>mpls>auto-bind-tunnel>resolution-filter
Description 

Selects the Segment Routing (SR) tunnel type programed by an ISIS instance in TTM.

sr-ospf

Syntax 
[no] sr-ospf
Context 
config>service>vpls>bgp-evpn>mpls>auto-bind-tunnel>resolution-filter
config>service>epipe>bgp-evpn>mpls>auto-bind-tunnel>resolution-filter
Description 

Selects the Segment Routing (SR) tunnel type programed by an OSPF instance in TTM.

sr-te

Syntax 
[no] sr-te
Context 
config>service>vpls>bgp-evpn>mpls>auto-bind-tunnel>resolution-filter
config>service>epipe>bgp-evpn>mpls>auto-bind-tunnel>resolution-filter
Description 

Selects the Segment Routing (SR) Traffic Engineered (SR-TE) LSP programmed in TTM.

control-word

Syntax 
[no] control-word
Context 
config>service>vpls>bgp-evpn>mpls
config>service>epipe>bgp-evpn>mpls
Description 

This command enables the transmission and reception of the control-word. As defined in RFC7432, the use of the control-word helps avoid frame disordering.

It is enabled or disabled for all EVPN-MPLS destinations at the same time.

Default 

no control-word

ecmp

Syntax 
ecmp value
Context 
config>service>vpls>bgp-evpn>mpls
Description 

This command controls the number of paths to reach a given MAC address when that MAC in the FDB is associated to a remote all-active multi-homed ethernet-segment.

The configuration of 2 or more ecmp paths to a given MAC enables the “aliasing” function described in RFC7432.

Parameters 
value—
Specifies the number of paths allowed to the same multi-homed MAC address, assuming the MAC is located in an all-active multi-homed ethernet-segment.
Values—
0 to 32
Values—
0

entropy-label

Syntax 
[no] entropy-label
Context 
config>service>vpls>bgp-evpn>mpls
config>service>epipe>bgp-evpn>mpls
Description 

If entropy-label is configured, the Entropy label and Entropy Label Indicator are inserted in packets for which at least one LSP in the stack for the far-end of the tunnel used by the service has advertised entropy label capability. If the tunnel is RSVP type, entropy-label can also be controlled under the config>router>mpls or config>router>mpls>lsp context.

The entropy label is mutually exclusive with the hash label feature. The entropy label cannot be configured on a spoke-sdp or service where the hash label feature has already been configured unless no hash label is set, and vice-versa.

force-vlan-vc-forwarding

Syntax 
[no] force-vlan-vc-forwarding
Context 
config>service>vpls>bgp-evpn>mpls
config>service>epipe>bgp-evpn>mpls
Description 

This command allows the system to preserve the vlan-id and 802.1p bits of the service-delimiting qtag in a new tag added in the customer frame before sending it to the EVPN-MPLS destinations.

Note that this command may be used in conjunction with the sap ingress vlan-translation command. If so used, the configured translated vlan-id will be the vlan-id sent to the EVPN-MPLS destinations as opposed to the service-delimiting tag vlan-id. If the ingress SAP/SDP binding is 'null'-encapsulated, the output vlan-id and pbits will be zero.

Default 

no force-vlan-vc-forwarding

ingress-replication-bum-label

Syntax 
[no] no-ingress-replication-bum-label
Context 
config>service>vpls>bgp-evpn>mpls
Description 

This command allows the user to configure the system so that a separate label is sent for BUM (Broadcast, Unknown unicast and Multicast) traffic in a given service. By default (no ingress-replication-bum-label), the same label is used for unicast and flooded BUM packets when for-warding traffic to remote PEs.

When saving labels, this might cause transient traffic duplication for all-active multi-homing. By enabling ingress-replication-bum-label, the system will advertise two labels per EVPN VPLS instance, one for unicast and one for BUM traffic. The ingress PE will use the BUM label for flooded traffic to the advertising egress PE, so that the egress PE can determine if the unicast traffic has been flooded by the ingress PE. Depending on the scale required in the network, the user may choose between saving label space or avoiding transient packet duplication sent to an all-active multi-homed CE for certain macs.

Default 

no ingress-replication-bum-label

shutdown

Syntax 
[no] shutdown
Context 
config>service>vpls>bgp-evpn>mpls
config>service>epipe>bgp-evpn>mpls
Description 

This command controls the administrative state of EVPN-MPLS in the service.

split-horizon-group

Syntax 
split-horizon-group name
no split-horizon-group
Context 
config>service>vpls>bgp-evpn>mpls
Description 

This command allows the user to configure an explicit split-horizon-group for all BGP-EVPN MPLS destinations that can be shared by other SAPs and/or spoke-SDPs. The use of explicit split-horizon-groups for EVPN-MPLS and spoke-SDPs allows the integration of VPLS and EVPN-MPLS networks.

If the split-horizon-group command for bgp-evpn>mpls> is not used, the default split-horizon-group (that contains all the EVPN destinations) is still used, but it is not possible to refer to it on SAPs/spoke-SDPs. User-configured split-horizon-groups can be configured within the service context. The same group-name can be associated to saps, spoke-sdps, pw-templates, pw-template-bindings and EVPN-MPLS destinations. The configuration of bgp-evpn>mpls> split-horizon-group will only be allowed if bgp-evpn>mpls is shutdown; no changes are allowed when bgp-evpn>mpls is no shutdown.

When the SAPs and/or spoke-SDPs (manual or BGP-AD-discovered) are configured within the same split-horizon-group as the EVPN-MPLS endpoints, MAC addresses will still be learned on them but they will not be advertised in BGP-EVPN. If provider-tunnel is enabled in the bgp-evpn service, the SAPs and SDP-bindings that share the same split-horizon-group of the EVPN-MPLS provider-tunnel will be brought operationally DOWN if the point-to-multipoint tunnel is operationally UP.

Default 

no split-horizon-group

Parameters 
name—
Specifies the split-horizon-group name.

unknown-mac-route

Syntax 
[no] unknown-mac-route
Context 
config>service>vpls>bgp-evpn
Description 

This command enables the advertisement of the unknown-mac-route in BGP. This will be coded in an EVPN MAC route where the MAC address is zero and the MAC address length 48. By using this unknown-mac-route advertisement, the user may decide to optionally turn off the advertisement of MAC addresses learned from saps and sdp-bindings, hence reducing the control plane overhead and the size of the FDB tables in the data center. All the receiving NVEs supporting this concept will send any unknown-unicast packet to the owner of the unknown-mac-route, as opposed to flooding the unknown-unicast traffic to all other nodes part of the same VPLS. Note that, although the 7750 SR, 7450 ESS, or 7950 XRS can be configured to generate and advertise the unknown-mac-route, the router will never honor the unknown-mac-route and will flood to the vpls flood list when an unknown-unicast packet arrives to an ingress sap/sdp-binding.

Use of the unknown-mac-route is only supported for BGP-EVPN VXLAN.

Default 

no unknown-mac-route

vxlan

Syntax 
vxlan vni vni-id create
no vxlan vni
Context 
config>service>vpls
Description 

This command enables the use of vxlan in the VPLS service.

Parameters 
vni vni-id
Specifies the VXLAN network identifier configured in the VPLS service. All the EVPN advertisements (MAC routes and inclusive multicast routes) for this services will encode the configured vni in the Ethernet Tag field of the NLRI.
Values—
1 to 16777215
Note that the VPLS service will be operationally UP once the vxlan vni vni-id is successfully created. However, bgp-evpn must be enabled so that VXLAN bindings can be established and MAC learning and flooding can happen on them.

vxlan

Syntax 
vxlan
Context 
config>service>vpls>bgp-evpn
Description 

This command enables the context to configure the VXLAN parameters when BGP EVPN is used as the control plane.

shutdown

Syntax 
[no] shutdown
Context 
config>service>vpls>bgp-evpn>vxlan
Description 

This command enables and disables the automatic creation of VXLAN auto-bindings by BGP-EVPN.

Default 

shutdown

pbb

Syntax 
pbb
Context 
config>service>vpls
Description 

This command enables the context where the PBB parameters are configured.

use-es-bmac

Syntax 
use-es-bmac
Context 
config>service>vpls>pbb
Description 

This command is only supported in B-VPLS instances where BGP-EVPN is enabled and controls the source BMAC used by the system for packets coming from the SAP or spoke-SDPs when they belong to an EVPN ethernet-segment.

If enabled, the system will use a source BMAC derived from the source-bmac (high order four bytes) and the least significant two bytes configured in config>service>system>bgp-evpn>ethernet-segment>source-bmac-lsb for all the packets coming from the local ethernet-segment.

If no use-es-bmac is configured, the system will use the regular source-bmac (provided by the config>service>vpls>pbb>source-bmac command, or the chassis bmac if the source-bmac is not configured).

Default 

no use-es-bmac

provider-tunnel

Syntax 
provider-tunnel
Context 
config>service>vpls
Description 

This command enables the context to configure the use of a P2MP LSP to forward Broadcast, Unknown unicast, and Multicast (BUM) packets of a VPLS or B-VPLS instance. The P2MP LSP is referred to as the Provider Multicast Service Interface (PMSI).

inclusive

Syntax 
inclusive
Context 
config>service>vpls>provider-tunnel
Description 

This command enables the context to configure the use of a P2MP LSP as the default tree for forwarding Broadcast, Unknown unicast, and Multicast (BUM) packets of a VPLS or B-VPLS instance. The P2MP LSP is referred to, in this case, as the Inclusive Provider Multicast Service Interface (I-PMSI).

When enabled, this feature relies on BGP Auto-Discovery (BGP-AD), BGP-VPLS or BGP-EVPN to discover the PE nodes participating in a given VPLS/B-VPLS instance. In the case of BGP-AD or BGP-VPLS, the BGP route contains the information required to signal both point-to-point (P2P) PWs used to forward unicast known Ethernet frames, and the RSVP or mLDP P2MP LSP used to forward the BUM frames. In the case of BGP-EVPN, the EVPN IMET route contains the information to set up the mLDP P2MP LSP and may also contain the information that enables the remote leaf-only nodes to setup an EVPN destination to the sending PE.

Note:

The provider-tunnel for a given service must be configured with an owner protocol (BGP-AD, BGP-VPLS or BGP-EVPN); only one owner must be configured. Use the owner {bgp-ad|bgp-vpls|bgp-evpn-mpls} command to configure an owner.

With an mLDP I-PMSI, each leaf node will initiate the signaling of the mLDP P2MP LSP upstream using the P2MP FEC information in the I-PMSI tunnel information discovered through the BGP.

Use the mldp command to enable the use of an LDP P2MP LSP as the I-PMSI for forwarding Ethernet BUM and IP multicast packets in a VPLS instance:

config>service>vpls [b-vpls]>provider-tunnel>inclusive>mldp

When a no shutdown is performed under the context of the inclusive node and the expiration of a delay timer, BUM packets will be forwarded over an automatically signaled mLDP P2MP LSP.

Use the root-and-leaf command to configure the node to operate as both root and leaf in the VPLS instance:

config>service>vpls [b-vpls]>provider-tunnel>inclusive>root-and-leaf

The node behaves as a leaf-only node by default. For the I-PMSI of type mLDP, the leaf-only node will join I-PMSI rooted at other nodes it discovered but will not include a PMSI Tunnel Attribute in BGP route update messages. This way a leaf-only node will forward packets to other nodes in the VPLS/B-VPLS using the point-to-point spoke-sdps in the case of BGP-AD or BGP-VPLS, or using EVPN destinations in the case of BGP-EVPN.

Note:

Either BGP-AD/VPLS or BGP-EVPN must be enabled in the VPLS/B-VPLS instance otherwise the execution of the no shutdown command under the context of the inclusive node will fail and the I-PMSI will not come up.

If the P2MP LSP instance goes down, the VPLS/B-VPLS immediately reverts the forwarding of BUM packets to the P2P PWs or EVPN destinations (in the case of BGP-EVPN). Performing a shutdown under the context of the inclusive node will allow the user to restore BUM packet forwarding over the P2P PWs or EVPN destinations.

This feature is supported with VPLS and B-VPLS; it is not supported with I-VPLS. Although Routed VPLS is supported, routed traffic cannot be sent over the I-PMSI tree.

data-delay-interval

Syntax 
data-delay-interval seconds
no data-delay-interval
Context 
config>service>vpls>provider-tunnel>inclusive
Description 

This command enables the context to configure the I-PMSI data delay timer.

For an mLDP P2MP LSP, the delay timer is started as soon as the P2MP FEC corresponding to the I- PMSI is resolved and installed at the root node. When configuring a value at the root node, the user must factor the configured IGP-LDP sync timer (config>router>interface>ldp-sync-timer) on the network interfaces. This is required because the mLDP P2MP LSP may move to a different interface at the expiry of the sync timer as the routing upstream of the LDP Label Mapping message may change when the sync timer expires and the interface metric is restored.

When the data delay timer expires, the VPLS/B-VPLS begins forwarding BUM packets over the P2MP LSP instance even if all the paths are not up.

The no version of this command reinstates the default value for the delay timer.

Parameters 
seconds
Specifies the delay-time in seconds.
Values—
3 to 180 seconds
Values—
15 seconds

mldp

Syntax 
[no] mldp
Context 
config>service>vpls>provider-tunnel>inclusive
Description 

This command enables the context to configure the parameters of an LDP P2MP LSP used for forwarding Broadcast, Unicast unknown and Multicast (BUM) packets of a VPLS or B-VPLS instance.

root-and-leaf

Syntax 
[no] root-and-leaf
Context 
config>service>vpls>provider-tunnel>inclusive
Description 

This command enables the node to operate as both root and leaf of the I-PMSI in a given VPLS/B-VPLS instance.

By default, a node will behave as a leaf-only node. For the I-PMSI of type mLDP, the leaf-only node will join I-PMSI rooted at other nodes it discovered but will not include a PMSI Tunnel attribute in BGP route update messages. This way a leaf-only node will forward packets to other nodes in the VPLS/B-VPLS using the point-to-point spoke-sdp's or the EVPN destinations.

The no version of the command reinstates the default value.

owner

Syntax 
[no] owner
Context 
config>service>vpls>provider-tunnel>inclusive
Description 

This command selects the owner protocol of the inclusive PMSI tunnel in the service. Only one of the protocols will support the provider tunnel.

The bgp-vpls and bgp-evpn-mpls parameters cannot be configured together in the same service. Although bgp-ad and bgp-evpn can coexist in the same service, bgp-ad cannot be configured as the owner of the provider-tunnel. In addition, the following applies to this configuration:

  1. The owner must be explicitly set before the provider-tunnel can be no shutdown.
  2. If the owner is bgp-ad, then bgp-evpn mpls and bgp-evpn vxlan will fail to no shutdown.
  3. The provider-tunnel must be shutdown to change the owner; on the fly change is not allowed.
Default 

no owner

Parameters 
bgp-ad
Specifies that bgp-ad is the owner of the provider-tunnel.
bgp-vpls
Specifies that bgp-vpls is the owner of the provider-tunnel.
bgp-evpn-mpls
Specifies that bgp-evpn-mpls is the owner of the provider-tunnel.

shutdown

Syntax 
[no] shutdown
Context 
config>service>vpls>provider-tunnel>inclusive
Description 

This command administratively enables and disables the service.

proxy-arp

Syntax 
[no] proxy-arp
Context 
config>service>vpls
Description 

This command enables the context to configure the proxy-ARP parameters in a VPLS service.

Default 

no proxy-arp

proxy-nd

Syntax 
[no] proxy-nd
Context 
config>service>vpls
Description 

This command enables the context to configure the proxy-ND parameters in a VPLS service.

Default 

no proxy-arp

age-time

Syntax 
[no] age-time seconds
Context 
config>service>vpls>proxy-arp
config>service>vpls>proxy-nd
Description 

This command specifies the aging timer per proxy-ARP/proxy-ND entry for dynamic entries. When the aging expires, the entry is flushed. The age is reset when a new ARP/GARP/NA for the same MAC-IP is received. If the corresponding FDB MAC entry is flushed, the proxy-ARP/proxy-ND entry goes inactive and subsequent ARP/NS lookups are treated as "missed". EVPN will withdraw the IP->MAC if the entry goes inactive. The age-time should be set at send-refresh * 3 to ensure that no active entries are unnecessarily removed.

Default 

no age-time

Parameters 
seconds
Specifies the age-time in seconds.
Values—
60 to 86400

dup-detect

Syntax 
dup-detect [anti-spoof-mac mac-address] window minutes num-moves count hold-down [minutes | max]
dup-detect [anti-spoof-mac mac-address] window minutes num-moves count hold-down [minutes | max] [static-black-hole]
Context 
config>service>vpls>proxy-arp
config>service>vpls>proxy-nd
Description 

This command enables a mechanism that detects duplicate IPs and ARP/ND spoofing attacks. Attempts (relevant to dynamic and EVPN entry types) to add the same IP (different MAC) are monitored for window <minutes>. When <count> is reached within that window, the proxy-ARP/ND entry for the suspected IP is marked as duplicate. An alarm is also triggered. This condition is cleared when hold-down time expires (max does not expire) or a clear command is issued.

If the anti-spoof-mac is configured, the proxy-ARP/ND offending entry's MAC is replaced with this <mac-address> and advertised in an unsolicited GARP/NA for local SAP/SDP-bindings, and in EVPN to remote PEs. This mechanism assumes that the same anti-spoof-mac is configured in all the PEs for the same service and that traffic with destination anti-spoof-mac received on SAPs/SDP-bindings will be dropped. An ingress mac-filter may be configured to drop traffic to the anti-spoof-mac.

The anti-spoof-mac can also be combined with the static-black-hole option. To use a black-hole MAC entry for the anti-spoof-mac function in a proxy-ARP/ND service, the following must be configured:

  1. static-black-hole option for the anti-spoof-mac
  2. a static black-hole MAC using the same MAC address used for the anti-spoof-mac: static-mac mac <mac-address> create black-hole command.

When both anti-spoof-mac and static-black-hole commands are configured, the MAC is advertised in EVPN as Static. Locally, the MAC will be shown in the FDB as 'CStatic' and associated with a black-hole.

The combination of the anti-spoof-mac and the static-black-hole options ensures that any frame arriving in the system with MAC DA = anti-spoof-mac will be discarded, irrespective of the ingress endpoint type (SAP/SDP-binding or EVPN) and without the need for a filter.

If the user wants to redirect the traffic with MAC DA = anti-spoof-mac instead of discarding it, redirect filters should be configured on saps/sdp-bindings instead of the static-black-hole option

If the static-black-hole option is not configured for the anti-spoof-mac, the behavior is as follows:

  1. The anti-spoof-mac is not programmed in the FDB.
  2. Any attempt to add a Static MAC (or any other MAC) with the anti-spoof-mac value will be rejected by the system.
  3. A mac-filter is needed to discard traffic with MAC DA = anti-spoof-mac.

Any changes to the configuration of anti-spoof-mac require proxy-arp or proxy-nd to first be shut down. See ARP/ND Snooping and Proxy Support for more information.

Default 

dup-detect window 3 num-moves 5 hold-down 9

Parameters 
minutes
Specifies the window size in minutes.
Values—
1 to 15
Values—
3
count
Specifies the number of moves required so that an entry is declared duplicate.
Values—
3 to 10
Values—
5
minutes | max
Specifies the hold-down time for a duplicate entry. Max means permanent hold-down.
Values—
2 to 60 | max
Values—
9
mac-address
Specifies the optional anti-spoof-mac to use.

dynamic-arp-populate

Syntax 
[no] dynamic-arp-populate
Context 
config>service>vpls>proxy-arp
Description 

This command enables the addition of dynamic entries to the proxy-ARP table (disabled by default). When executed, the system will populate proxy-ARP entries from snooped GARP/ARP messages on SAPs/SDP-bindings. These entries will be shown as dynamic.

When disabled, dynamic-arp entries will be flushed from the proxy-ARP table. Enabling dynamic-arp-populate is only recommended in networks with a consistent configuration of this command in all the PEs.

Default 

no dynamic-arp-populate

garp-flood-evpn

Syntax 
[no] garp-flood-evpn
Context 
config>service>vpls>proxy-arp
Description 

This command controls whether the system floods GARP-requests / GARP-replies to the EVPN. The GARPs impacted by this command are identified by the sender's IP being equal to the target's IP and the MAC DA being broadcast.

The no form of the command only floods to local saps/binds but not to EVPN destinations.

Disabling this command is only recommended in networks where CEs are routers that are directly connected to the PEs. Networks using aggregation switches between the host/routers and the PEs should flood GARP messages in the EVPN to ensure that the remote caches are updated and the BGP does not miss the advertisement of these entries.

Default 

garp-flood-evpn

send-refresh

Syntax 
[no] send-refresh seconds
Context 
config>service>vpls>proxy-arp
config>service>vpls>proxy-nd
Description 

If enabled, this command will make the system send a refresh at the configured time. A refresh message is an ARP-request message that uses 0s as sender's IP for the case of a proxy-ARP entry. For proxy-ND entries, a refresh is a regular NS message using the chassis-mac as MAC source-address.

Default 

no send-refresh

Parameters 
seconds
Specifies the send-refresh in seconds.
Values—
120 to 86400

static

Syntax 
[no] static ip-address ieee-address
Context 
config>service>vpls>proxy-arp
Description 

This command configures static entries to be added to the table. Note that a static MAC-IP entry requires the addition of the MAC address to the FDB as either learned or CStatic (conditional static MAC) in order to become active.

Parameters 
ip-address
Specifies the IPv4 address for the static entry.
ieee-address
Specifies the MAC address for the static entry.

table-size

Syntax 
table-size table-size
Context 
config>service>vpls>proxy-arp
config>service>vpls>proxy-nd
Description 

This command adds a table-size limit per service. By default, the table-size limit is 250; it can be set up to 16k entries per service. A non-configurable implicit high watermark of 95% and low watermark of 90% exists, per service and per system. When those watermarks are reached, a syslog/trap is triggered. When the system/service limit is reached, entries for a given IP can be replaced (a different MAC can be learned and added) but no new IP entries will be added, regardless of the type (Static, evpn, dynamic). If the user attempts to change the table-size value to a value that cannot accommodate the number of existing entries, the attempt will fail.

Default 

table-size 250

Parameters 
table-size
Specifies the table-size as number of entries for the service.
Values—
1 to 16384

unknown-arp-request-flood-evpn

Syntax 
[no] unknown-arp-request-flood-evpn
Context 
config>service>vpls>proxy-arp
Description 

This command controls whether unknown ARP-requests are flooded into the EVPN network. By default, the system floods ARP-requests, including EVPN (with source squelching), if there is no active proxy-arp entry for the requested IP.

The no form of the command will only flood to local SAPs/SDP-bindings and not to EVPN destinations.

Default 

unknown-arp-request-flood-evpn

dynamic-nd-populate

Syntax 
[no] dynamic-nd-populate
Context 
config>service>vpls>proxy-nd
Description 

This command enables the addition of dynamic entries to the proxy-ND table. The command is disabled by default. When executed, the system will populate proxy-ND entries from snooped Neighbor Advertisement (NA) messages on SAPs/SDP-bindings, in addition to the entries coming from EVPN (if the EVPN is enabled). These entries will be shown as dynamic, as opposed to EVPN entries or static entries.

When disabled, dynamic-ND entries will be flushed from the proxy-ND table. Enabling dynamic-nd-populate is only recommended in networks with a consistent configuration of this command in all the PEs.

Default 

no dynamic-nd-populate

evpn-nd-advertise

Syntax 
evpn-nd-advertise {host|router}
Context 
config>service>vpls>proxy-nd
Description 

This command enables two different functions: on the one hand it enables the advertisement of static or dynamic entries that are learned as host or routers (only one option is possible for a given service). On the other hand, it determines the R flag (host or router) when sending Neighbor Advertisement (NA) messages for existing EVPN entries in the proxy-ND table.

This command cannot be modified without proxy-nd shutdown.

Default 

evpn-nd-advertise router

host-unsolicited-na-flood-evpn

Syntax 
[no] host-unsolicited-na-flood-evpn
Context 
config>service>vpls>proxy-nd
Description 

This command controls whether the system floods host unsolicited Neighbor Advertisements to the EVPN. The NA messages impacted by this command are NA messages with the following flags: S=0 and R=0.

The no form of the command will only flood to local saps/binds but not to the EVPN destinations. This is only recommended in networks where CEs are routers that are directly connected to the PEs. Networks using aggregation switches between the host/routers and the PEs should flood unsolicited NA messages in the EVPN to ensure that the remote caches are updated and the BGP does not miss the advertisement of these entries.

Default 

host-unsolicited-na-flood-evpn

router-unsolicited-na-flood-evpn

Syntax 
[no] router-unsolicited-na-flood-evpn
Context 
config>service>vpls>proxy-nd
Description 

This command controls whether the system floods router unsolicited Neighbor Advertisements to EVPN. The NA messages impacted by this command are NA messages with the following flags: S=0 and R=1.

The no form of the command will only flood to local saps/binds but not to EVPN destinations. This is only recommended in networks where CEs are routers directly connected to the PEs. Networks using aggregation switches between the host/routers and the PEs should flood unsolicited NA messages in EVPN to ensure that the remote caches are updated and BGP does not miss the advertisement of these entries.

Default 

router-unsolicited-na-flood-evpn

static

Syntax 
static ipv6-address ieee-address {host | router}
no static ipv6-address
Context 
config>service>vpls>proxy-nd
Description 

This command configures static entries to be added to the table. Note that a static MAC-IP entry requires the addition of the MAC address to the FDB as either dynamic or CStatic (Conditional Static MAC) in order to become active. Along with the IPv6 and MAC, the entry must also be configured as either host or router. This will determine if the received NS for the entry will be replied with the R flag set to 1 (router) or 0 (host).

Default 

router-unsolicited-na-flood-evpn

Parameters 
ipv6-address
Specifies the IPv6 address for the static entry.
ieee-address
Specifies the MAC address for the static entry.
host—
Specifies that the entry is type “host”.
router—
Specifies that the entry is type “router”.

unknown-ns-flood-evpn

Syntax 
[no] unknown-ns-flood-evpn
Context 
config>service>vpls>proxy-nd
Description 

This command controls whether unknown Neighbor Solicitation messages are flooded into the EVPN network. By default, the system floods NS (with source squelching) to SAPs/SDP-bindings including EVPN, if there is no active proxy-nd entry for the requested IPv6.

The no form of the command will only flood to local SAPs/SDP-bindings but not to EVPN destinations.

Default 

unknown-ns-flood-evpn

shutdown

Syntax 
[no] shutdown
Context 
config>service>vpls>proxy-arp
config>service>vpls>proxy-nd
Description 

This command enables and disables the proxy-ARP and proxy-nd functionality. ARP/GARP/ND messages will be snooped and redirected to the CPM for lookup in the proxy-ARP/proxy-ND table. The proxy-ARP/proxy-ND table is populated with IP->MAC pairs received from different sources (EVPN, static, dynamic). When the shutdown command is issued, it flushes the dynamic/EVPN dup proxy-ARP/proxy-ND table entries and instructs the system to stop snooping ARP/ND frames. All the static entries are kept in the table as inactive, regardless of their previous Status.

Default 

shutdown

static-mac

Syntax 
static-mac
Context 
config>service>vpls
Description 

A set of conditional static MAC addresses can be created within a VPLS supporting bgp-evpn. Conditional Static Macs are also supported in B-VPLS with SPBs. Unless they are configured as black-hole, conditional Static Macs are dependent on the SAP/SDP state.

This command allows the assignment of a set of conditional Static MAC addresses to a SAP/ spoke-SDP or black-hole. In the FDB, the static MAC is then associated with the active SAP or spoke SDP.

When configured in conjunction with SPBM services, Static MACs are used for PBB Epipe and I-VPLS services that may terminate external to SPBM. If this is configured under a Control B-VPLS the interface referenced will not use IS-IS for this neighbor. This may also be configured under a User B-VPLS where the corresponding interface is not supported under the Control B-VPLS.

Static MACs configured in a bgp-evpn service are advertised as protected (EVPN will signal the MAC as protected).

mac

Syntax 
mac ieee-address [create] sap sap-id monitor fwd-status
mac ieee-address [create] spoke-sdp sdp-id:vc-id] monitor fwd-status
mac ieee-address [create] black-hole
no mac ieee-address
Context 
config>service>vpls>static-mac
Description 

This command assigns a conditional static MAC address entry to an SPBM B-VPLS SAP/spoke-SDP or black-hole, allowing external MACs for single and multi-homed operation.

This command also assigns a conditional static MAC address entry to an EVPN VPLS SAP/spoke-SDP or a black-hole on the 7450 ESS or 7750 SR.

When configured in conjunction with SPBM services, Static MACs are used for PBB Epipe and I-VPLS services that may terminate external to SPBM. If this is configured under a Control B-VPLS the interface referenced will not use IS-IS for this neighbor. This may also be configured under a User B-VPLS where the corresponding interface is not supported under the Control B-VPLS.

Default 

none

Parameters 
ieee-address —
Specifies the static MAC address to SAP/SDP-binding or black-hole.
Values—
6-byte mac-address (xx:xx:xx:xx:xx:xx or xx-xx-xx-xx-xx-xx). It cannot be all zeros.
create—
This keyword is mandatory while creating a static MAC.
black-hole—
This keyword creates a static FDB entry for the MAC address to black-hole traffic.
monitor fwd-status
Specifies that this static MAC will be installed in the FDB based on the forwarding status of the SAP or spoke SDP.

evpn-tunnel

Syntax 
[no] evpn-tunnel
Context 
config>service>vprn>interface>vpls
Description 

This command enables and disables the evpn-tunnel mode for the attached R-VPLS. When enabled, no IP address will be required under the same interface.

Default 

no evpn-tunnel

vsd-domain

Syntax 
vsd-domain name
no vsd-domain
Context 
config>service>vpls
config>service>vprn
Description 

This command associates a previously configured vsd-domain to an existing VPRN or VPLS service. The vsd-domain is a tag used between the VSD and the 7750 SR, 7450 ESS, or 7950 XRS to correlate configuration parameters to a service.

Parameters 
name —
Specifies the vsd-domain name.

vsd

Syntax 
vsd
Context 
config>service
config>service
Description 

This command provides the context for the vsd configuration.

domain

Syntax 
domain name [type {l2-domain | vrf-gre | vrf-vxlan | l2-domain-irb}] [create]
no domain name
Context 
config>service>vsd
Description 

This command configures a vsd-domain that can be associated to a VPLS or VPRN service.

Parameters 
type —
Specifies the type of domain. Vrf-gre can only be associated to a VPRN service. The other three types of domains must be associated to a VPLS service.
Values—
l2-domain | vrf-gre | vrf-vxlan | l2-domain-irb
create—
Creates the vsd-domain.

description

Syntax 
description description-string
no description
Context 
config>service>vsd>domain
Description 

This command provides a description for a vsd-domain. This description must be added before the domain can be no shutdown.

Parameters 
description-string —
Specifies the text for the description.

service-range

Syntax 
service-range svc-id to svc-id
no service-range
Context 
config>service>vsd
Description 

This command configures the range of service identifiers that the system allows for dynamic services configured by python, when the Nuage VSD sends the service configuration parameters for the VSD fully-dynamic integration model

Parameters 
svc-id
Specifies the start and end service identifier values.
Values—
1 to 2147483647

shutdown

Syntax 
[no] shutdown
Context 
config>service>vsd>domain
Description 

This command enables or disables a domain. A description must be provided before no shutdown is executed.

system-id

Syntax 
system-id name
no system-id
Context 
config>system>vsd
Description 

This command configures the DC GW system-id that is used for the configuration from VSD. VSD will identify the DC GW based on this identifier, hence it must be unique per VSD.

Parameters 
name —
Specifies the name.

xmpp

Syntax 
xmpp
Context 
config>system
Description 

This command provides the context for the xmpp configuration.

server

Syntax 
server xmpp-server-name [domain-name fqdn] [username user-name] [password password] [create]
no server xmpp-server-name
Context 
config>system>xmpp
Description 

This command configures the XMPP server as well as the Jabber ID that the 7750 SR, 7450 ESS, or 7950 XRS will use for the XMPP communication with the server. Note that the system uses DNS to resolve the configured domain-name.

no server name will remove all the dynamic configurations in all the services.

Parameters 
xmpp-server-name —
Specifies the name of the server in lower-case letters.
fqdn —
Specifies the Fully Qualified Domain Name of the server.
user-name —
Specifies the user-name part of the Jabber ID.
password —
Specifies the password part of the Jabber ID’s user.
create —
Keyword used to create the server instance.

shutdown

Syntax 
[no] shutdown
Context 
config>system>xmpp>server
Description 

This command enables or disables the communication with a given XMPP server. When the xmpp server is properly configured, no shutdown instructs the system to establish a TCP session with the XMPP server through the management interface first. If it fails to establish communication, the 7750 SR, 7450 ESS, or 7950 XRS uses an in-band communication and its system IP as source IP address. Shutdown does not remove the dynamic configurations.

security

Syntax 
security
Context 
config>system
Description 

This command enables the context for the configuration of the security parameters in the system.

cli-script

Syntax 
cli-script
Context 
config>system>security
Description 

This command enables the context for the configuration of the security parameters in the system.

authorization

Syntax 
authorization
Context 
config>system>security>cli-script
Description 

This command enables the context for the configuration of the authorization parameters for the cli-scripts in the system.

vsd

Syntax 
vsd
Context 
config>system>security>cli-script>authorization
Description 

This command enables the context for the configuration of the authorization parameters related to VSD in the system.

cli-user

Syntax 
cli-user user-name
no cli-user
Context 
config>system>security>cli-script>authorization>vsd
Description 

This command configures the cli-user for the configuration coming from VSD (fully dynamic VSD integration model). The user-profile determines what CLI set of commands can be executed by the VSD. This set of commands is a sub-set of the white-list of commands allowed by the system for the or VSD. You can use the tools dump service vsd-services command-list to check the white-list of commands.

Parameters 
user-name —
Specifies the user-name that the VSD will use when adding a configuration to the system.

password

Syntax 
password
Context 
config>system>security>password
Description 

This command enables the context for the configuration of the passwords in the system.

vsd-password

Syntax 
vsd-password password [hash | hash2]
no vsd-password
Context 
config>system>security>password
Description 

This command configures the password required to access the enable-vsd-config mode. The enable-vsd-config mode allows editing of services provisioned by the VSD in fully dynamic mode (or by the tools perform service vsd evaluate-script command

Parameters 
password —
Specifies the password required to login as authorized user in the enable-vsd-config mode.
hash | hash2—
Specifies the hashing sequence.

router

Syntax 
router
Context 
config
Description 

This command enables the context for the configuration of the base router in the system.

bgp

Syntax 
bgp
Context 
config>router
Description 

This command enables the context for the configuration of the base router bgp parameters in the system.

group

Syntax 
group name
Context 
config>router>bgp
Description 

This command enables the context for the configuration of a bgp group in the base router.

neighbor

Syntax 
neighbor ip-address
Context 
config>router>bgp>group
Description 

This command enables the context for the configuration of a bgp group neighbor in the base router.

def-recv-evpn-encap

Syntax 
def-recv-evpn-encap {mpls | vxlan}
Context 
config>router>bgp>group>neighbor
Description 

This command defines how the BGP will treat a received EVPN route without RC5512 BGP encapsulation extended community. If no encapsulation is received, BGP will validate the route as MPLS or VXLAN depending on how this command is configured.

Default 

no def-recv-evpn-encap

Parameters 
mpls —
Specifies that mpls is the default encapsulation value in the case where no RFC5512 extended community is received in the incoming BGP-EVPN route.
vxlan —
Specifies that vxlan is the default encapsulation value.

python

Syntax 
python
Context 
config
Description 

This command enables the context for the configuration of the python parameters in the system.

python-policy

Syntax 
python-policy name
Context 
config>python
Description 

This command enables the context for the configuration of the python policy parameters in the system.

vsd

Syntax 
vsd script script
no vsd
Context 
config>python
Description 

This command defines the python script for the python-policy sent by the VSD.

Parameters 
script —
Specifies the vsd script that points at the python-script command.

enable-vsd-config

Syntax 
[no] enable-vsd-config
Context 
<root>
Description 

This command allows editing of vsd services just like normal services. As this is an action that should only be executed by authorized personnel, the activation of this command is protected by the use of a password, defined under configure system security password vsd-password.

Show Configuration Commands

service-using

Syntax 
service-using [vsd]
service-using [origin vsd]
Context 
show>service
Description 

When the vsd modifier is used, this command displays the VSD domain tags used and the associated service identifier. If the modifier origin vsd is used, the command displays the services created by the VSD fully-dynamic integration model. (Python will actually create the service after receiving the relevant parameters from VSD).

Output 

Sample Output
*A:PE1# show service service-using vsd 
===========================================
Services-using VSD Domain
===========================================
Svc Id     Domain
-------------------------------------------
64000      L2-DOMAIN-5
-------------------------------------------
Number of services using VSD Domain: 1
===========================================
*A:PE1# show service service-using origin vsd 
===============================================================================
Services 
===============================================================================
ServiceId    Type      Adm  Opr  CustomerId Service Name
-------------------------------------------------------------------------------
64000        VPLS      Up   Up   1          evi64000
-------------------------------------------------------------------------------
Matching Services : 1
-------------------------------------------------------------------------------
===============================================================================

system

Syntax 
system
Context 
show>service
Description 

This command enables the context to display the system parameters.

bgp-evpn

Syntax 
bgp-evpn [ethernet-segment]
bgp-evpn ethernet-segment name name [all] [evi evi] [isid isid]
Context 
show>service>system
Description 

This command shows all the information related to the base EVPN instance, including the base RD used for ES routes, the ethernet-segments or individual ethernet-segment information.

Output 

Sample Output
*A:PE1# show service system bgp-evpn 
===============================================================================
Service BGP EVPN Information
===============================================================================
Evpn Route Dist.   : 192.0.2.69:0                 
===============================================================================
*A:PE1# show service system bgp-evpn ethernet-segment 
===============================================================================
Service Ethernet Segment
===============================================================================
Name                             ESI                           Admin     Oper
-------------------------------------------------------------------------------
ESI-71                           01:00:00:00:00:71:00:00:00:01 Enabled   Up
-------------------------------------------------------------------------------
Entries found: 1
===============================================================================
*A:PE1# show service system bgp-evpn ethernet-segment name "ESI-71" all 
===============================================================================
Service Ethernet Segment
===============================================================================
Name                    : ESI-71
Admin State             : Enabled            Oper State         : Up
ESI                     : 01:00:00:00:00:71:00:00:00:01
Multi-homing            : allActive          Oper Multi-homing  : allActive
Source BMAC LSB         : 71-71              
ES BMac Tbl Size        : 8                  ES BMac Entries    : 1
Lag Id                  : 1                  
ES Activation Timer     : 0 secs             
Exp/Imp Route-Target    : target:00:00:00:00:71:00
Svc Carving             : auto               
ES SHG Label            : 262142             
===============================================================================
===============================================================================
EVI Information 
===============================================================================
EVI                 SvcId               Actv Timer Rem      DF
-------------------------------------------------------------------------------
1                   1                   0                   no
-------------------------------------------------------------------------------
Number of entries: 1
===============================================================================
-------------------------------------------------------------------------------
DF Candidate list
-------------------------------------------------------------------------------
EVI                                     DF Address
-------------------------------------------------------------------------------
1                                       192.0.2.69
1                                       192.0.2.72
-------------------------------------------------------------------------------
Number of entries: 2
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
                                      
===============================================================================
ISID Information 
===============================================================================
ISID                SvcId               Actv Timer Rem      DF
-------------------------------------------------------------------------------
20001               20001               0                   no
-------------------------------------------------------------------------------
Number of entries: 1
===============================================================================
-------------------------------------------------------------------------------
DF Candidate list
-------------------------------------------------------------------------------
ISID                                    DF Address
-------------------------------------------------------------------------------
20001                                   192.0.2.69
20001                                   192.0.2.72
-------------------------------------------------------------------------------
Number of entries: 2
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
===============================================================================
BMAC Information 
===============================================================================
SvcId                                   BMacAddress
-------------------------------------------------------------------------------
20000                                   00:00:00:00:71:71
-------------------------------------------------------------------------------
Number of entries: 1
===============================================================================

ethernet-segment

Syntax 
ethernet-segment
ethernet-segment name name [all]
ethernet-segment name name evi [evi]
ethernet-segment name name isid [isid]
Context 
show>service>system>bgp-evpn
Description 

This command enables the context to display the ethernet-segment parameters.

vsd

Syntax 
vsd
Context 
show>service
Description 

This command enables the context for the vsd parameters.

domain

Syntax 
domain domain-name association
Context 
show>service>vsd
Description 

This command shows all the parameters related to a VSD domain created by the user or by VSD.

Output 

Sample Output
*A:PE71(1)# show service vsd domain 
===============================================================================
VSD Domain Table
===============================================================================
Name                                    Type           Origin    Admin
-------------------------------------------------------------------------------
L2-DOMAIN-5                             l2Domain       vsd       inService
-------------------------------------------------------------------------------
Number of domain entries: 1
===============================================================================
*A:PE71(1)# show service vsd domain "L2-DOMAIN-5"  
===============================================================================
VSD Information
===============================================================================
Name               : L2-DOMAIN-5
Description        : L2-DOMAIN-5
Type               : l2Domain                     Admin State   : inService
Last Error To Vsd  : (Not Specified)
Last Error From Vsd: (Not Specified)
Statistics
-------------------------------------------------------------------------------
Last Cfg Chg Evt   : 07/15/2015 21:20:23          Cfg Chg Evts  : 1
Last Cfg Update    : 07/15/2015 21:20:23          Cfg Upd Rcvd  : 1
Last Cfg Done      : 07/15/2015 21:20:23          
Cfg Success        : 1                            Cfg Failed    : 0
Last Recd Params   : script = {'domain' : '', 'vn 
                   : i' : '64000', 'rt' : 'target 
                   : :64000:64000', 'rte' : 'targ 
                   : et:64000:64000', 'servicetyp 
                   : e' : 'L2DOMAIN', 'metadata'  
                   : : 'rd=1:1, sap=1/1/10:3000 ' 
                   : }                            
Last Exec Params   : script = {'domain' : '', 'vn 
                   : i' : '64000', 'rt' : 'target 
                   : :64000:64000', 'rte' : 'targ 
                   : et:64000:64000', 'servicetyp 
                   : e' : 'L2DOMAIN', 'metadata'  
                   : : 'rd=1:1, sap=1/1/10:3000 ' 
                   : }                            
===============================================================================
*A:PE71(1)# show service vsd domain "L2-DOMAIN-5" association 
============================================================
Service VSD Domain
============================================================
Svc Id      Svc Type  Domain Type    Domain Admin   Origin
------------------------------------------------------------
64000       vpls      l2Domain       inService      vsd
------------------------------------------------------------
Number of entries: 1
============================================================

root-objects

Syntax 
root-objects
Context 
show>service>vsd
Description 

This command displays the root objects created by vsd.

Output 

Sample Output
*A:PE1# show service vsd root-objects 
===============================================================================
VSD Dynamic Service Root Objects
===============================================================================
OID Prefix                  : svcRowStatus
OID index                   : .64000
Snippet name                : script
Snippet instance            : L2-DOMAIN-5
Orphan time                 : N/A
-------------------------------------------------------------------------------
No. of Root Objects: 1
===============================================================================

script

Syntax 
script
Context 
show>service>vsd
Description 

This command enables the context to show dynamic services script information.

snippets

Syntax 
snippets [detail]
Context 
show>service>vsd>script
Description 

This command displays the dynamic services snippets information. The CLI output generated by a single vsd service python function call is a snippet instance

Output 

Sample Output
*A:PE1# show service vsd script snippets name "script" 
===============================================================================
VSD Dynamic Services Snippets
===============================================================================
Name                       Instance                      Ref-count  Dict-len
-------------------------------------------------------------------------------
script                     L2-DOMAIN-5                   0          126
-------------------------------------------------------------------------------
No. of Snippets: 1
===============================================================================
*A:PE1# show service vsd script snippets name "script" detail 
===============================================================================
VSD Dynamic Service Snippets
===============================================================================
Snippet            : script:L2-DOMAIN-5
-------------------------------------------------------------------------------
reference-count    : 0
dictionary-length  : 126
Root-object
-----------
oid                : 0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0
Reserved-id
-----------
id                 : service-id:64000
-------------------------------------------------------------------------------
No. of Snippets: 1
===============================================================================

statistics

Syntax 
statistics
Context 
show>service>vsd>script
Description 

This command displays vsd service script statistics. Only non-zero values are shown. The script statistics can be cleared with the "clear service statistics vsd" command.

Output 

Sample Output
*A:PE1# show service vsd script statistics 
===============================================================================
VSD Dynamic Services Script Statistics
===============================================================================
Description                                                         Counter
-------------------------------------------------------------------------------
python scripts with 0 retries due to timeout                        1
setup    - jobs launched                                            1
setup    - jobs handled                                             1
setup    - success                                                  1
-------------------------------------------------------------------------------
No. of VSD Script Statistics: 4
-------------------------------------------------------------------------------
Last Cleared Time: N/A
===============================================================================

summary

Syntax 
summary
Context 
show>service>vsd
Description 

This command displays the global configuration summary for vsd services.

Output 

Sample Output
*A:PE1# show service vsd summary 
===============================================================================
VSD Information
===============================================================================
Service Range
Start              : 64000                        End           : 65000
===============================================================================
===============================================================================
VSD Domain Table
===============================================================================
Name                                    Type           Origin    Admin
-------------------------------------------------------------------------------
L2-DOMAIN-5                             l2Domain       vsd       inService
-------------------------------------------------------------------------------
Number of domain entries: 1
===============================================================================

bgp-evpn

Syntax 
bgp-evpn
Context 
show>service>id
Description 

This command displays the bgp-evpn configured parameters for a given service, including the admin status of vxlan, the configuration for mac-advertisement and unknown-mac-route as well as the mac-duplication parameters. The command shows the duplicate MAC addresses that mac-duplication has detected. This command also shows whether the ip-route-advertisement command (and the incl-host parameter) has been enabled. If the service is bgp-evpn mpls, the command will show the parameters corresponding to evpn-mpls.

Output 

Sample Output
# bgp-evpn vxlan service
*A:DutA# show service id 1 bgp-evpn 
===============================================================================
BGP EVPN Table
===============================================================================
MAC Advertisement  : Enabled            Unknown MAC Route  : Disabled
VXLAN Admin Status : Enabled            Creation Origin    : manual
MAC Dup Detn Moves : 5                  MAC Dup Detn Window: 3
MAC Dup Detn Retry : 9                  Number of Dup MACs : 1
IP Route Advertise*: Enabled            Include hosts      : Disabled 
-------------------------------------------------------------------------------
Detected Duplicate MAC Addresses             Time Detected
-------------------------------------------------------------------------------
00:12:12:12:12:00                            01/17/2014 16:01:02
-------------------------------------------------------------------------------
===============================================================================
===============================================================================
BGP EVPN MPLS Information
===============================================================================
Admin Status       : Disabled           
Force Vlan Fwding  : Disabled           Control Word       : Disabled
Split Horizon Group: (Not Specified)
Ingress Rep BUM Lbl: Disabled           Max Ecmp Routes    : 0
Ingress Ucast Lbl  : N/A                Ingress Mcast Lbl  : N/A
Entropy Label      : Disabled           
===============================================================================
===============================================================================
BGP EVPN MPLS Auto Bind Tunnel Information
===============================================================================
Resolution         : disabled           
Filter Tunnel Types: (Not Specified)
===============================================================================
# bgp-evpn mpls service
*A:DutA# show service id 1 bgp-evpn   
===============================================================================
BGP EVPN Table
===============================================================================
MAC Advertisement  : Enabled            Unknown MAC Route  : Disabled
CFM MAC Advertise  : Enabled            
VXLAN Admin Status : Disabled           Creation Origin    : manual
MAC Dup Detn Moves : 3                  MAC Dup Detn Window: 3
MAC Dup Detn Retry : 9                  Number of Dup MACs : 0
IP Route Advertise*: Disabled           
 
EVI                : 1                  
-------------------------------------------------------------------------------
Detected Duplicate MAC Addresses             Time Detected
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
===============================================================================
* indicates that the corresponding row element may have been truncated.
===============================================================================
BGP EVPN MPLS Information
===============================================================================
Admin Status       : Enabled            
Force Vlan Fwding  : Disabled           Control Word       : Disabled
Split Horizon Group: (Not Specified)
Ingress Rep BUM Lbl: Disabled           Max Ecmp Routes    : 4
Ingress Ucast Lbl  : 262142             Ingress Mcast Lbl  : 262142
Entropy Label      : Disabled           
===============================================================================
===============================================================================
BGP EVPN MPLS Auto Bind Tunnel Information
===============================================================================
Resolution         : any                
Filter Tunnel Types: (Not Specified)
===============================================================================

evpn-mpls

Syntax 
evpn-mpls [esi esi] [es-bmac ieee-address]
Context 
show>service>id
Description 

This command displays the existing EVPN-MPLS destinations for a given service and all related information. The command allows filtering based on esi (for EVPN multi-homing) and es-bmac (for PBB-EVPN multi-homing) to display the EVPN-MPLS destinations associated to an esi.

Output 

Sample Output
*A:PE1# show service id 1 evpn-mpls 
===============================================================================
BGP EVPN-MPLS Dest
===============================================================================
TEP Address     Egr Label     Num. MACs   Mcast           Last Change
                 Transport                                
-------------------------------------------------------------------------------
192.0.2.69      262140        0           Yes             07/15/2015 19:44:07
                ldp                                        
192.0.2.69      262141        2           No              07/15/2015 19:44:07
                ldp                                        
192.0.2.70      262139        0           Yes             07/15/2015 19:44:07
                ldp                                        
192.0.2.70      262140        1           No              07/15/2015 19:44:07
                ldp                                        
192.0.2.72      262140        0           Yes             07/15/2015 19:44:07
                ldp                                        
192.0.2.72      262141        1           No              07/15/2015 19:44:07
                ldp                                        
192.0.2.73      262139        0           Yes             07/15/2015 19:44:09
                ldp                                        
192.0.2.254     262142        1           Yes             07/15/2015 19:44:31
                bgp                                        
-------------------------------------------------------------------------------
Number of entries : 8
-------------------------------------------------------------------------------
===============================================================================
===============================================================================
BGP EVPN-MPLS Ethernet Segment Dest
===============================================================================
Eth SegId                       Num. Macs               Last Change
-------------------------------------------------------------------------------
01:00:00:00:00:71:00:00:00:01   2                       07/15/2015 20:41:09
01:74:13:00:74:13:00:00:74:13   1                       07/15/2015 20:41:07
-------------------------------------------------------------------------------
Number of entries: 2
-------------------------------------------------------------------------------
===============================================================================
                                      
===============================================================================
BGP EVPN-MPLS ES BMAC Dest
===============================================================================
vBmacAddr                       Num. Macs               Last Change
-------------------------------------------------------------------------------
No Matching Entries
===============================================================================
*A:PE1# show service id 1 evpn-mpls esi 01:00:00:00:00:71:00:00:00:01 
===============================================================================
BGP EVPN-MPLS Ethernet Segment Dest
===============================================================================
Eth SegId                       Num. Macs               Last Change
-------------------------------------------------------------------------------
01:00:00:00:00:71:00:00:00:01   2                       07/15/2015 20:41:09
===============================================================================
===============================================================================
BGP EVPN-MPLS Dest TEP Info
===============================================================================
TEP Address              Egr Label                Last Change
                         Transport                
-------------------------------------------------------------------------------
192.0.2.69               262141                   07/15/2015 20:41:09
                         ldp                       
192.0.2.72               262141                   07/15/2015 20:41:09
                         ldp                       
-------------------------------------------------------------------------------
Number of entries : 2
-------------------------------------------------------------------------------
===============================================================================
A:PE3# show service id 20000 evpn-mpls es-bmac 00:00:00:00:71:71 
===============================================================================
BGP EVPN-MPLS ES BMAC Dest
===============================================================================
vBmacAddr                       Num. Macs               Last Change
-------------------------------------------------------------------------------
00:00:00:00:71:71               1                       07/15/2015 19:44:10
===============================================================================
===============================================================================
BGP EVPN-MPLS ES BMAC Dest TEP Info
===============================================================================
TEP Address               Egr Label               Last Change
                          Transport               
-------------------------------------------------------------------------------
192.0.2.69                262138                  07/15/2015 19:44:10
                          ldp                      
-------------------------------------------------------------------------------
Number of entries : 1
-------------------------------------------------------------------------------
===============================================================================

esi

Syntax 
esi esi
Context 
show>service>id>evpn-mpls
Description 

This command shows the remote ethernet-segment identifiers as well as the BGP-EVPN MPLS destinations associated to them.

Output 

Sample Output
*A:PE71(1)# show service id 1 evpn-mpls esi 01:00:00:00:00:71:00:00:00:01 
===============================================================================
BGP EVPN-MPLS Ethernet Segment Dest
===============================================================================
Eth SegId                       Num. Macs               Last Change
-------------------------------------------------------------------------------
01:00:00:00:00:71:00:00:00:01   1                       07/17/2015 18:31:27
===============================================================================
===============================================================================
BGP EVPN-MPLS Dest TEP Info
===============================================================================
TEP Address              Egr Label                Last Change
                         Transport                
-------------------------------------------------------------------------------
192.0.2.69               262141                   07/17/2015 18:31:26
                         ldp                       
192.0.2.72               262141                   07/17/2015 18:31:26
                         ldp                       
-------------------------------------------------------------------------------
Number of entries : 2
-------------------------------------------------------------------------------
=============================================================================== 

es-bmac

Syntax 
es-bmac ieee-address
Context 
show>service>id>evpn-mpls
Description 

This command shows the remote ethernet-segment BMACs as well as the BGP-EVPN MPLS destinations associated to them.

Output 

Sample Output
*A:PE70(4)# show service id 20000 evpn-mpls es-bmac 00:00:00:00:71:71 
===============================================================================
BGP EVPN-MPLS ES BMAC Dest
===============================================================================
vBmacAddr                       Num. Macs               Last Change
-------------------------------------------------------------------------------
00:00:00:00:71:71               1                       07/15/2015 19:50:22
===============================================================================
===============================================================================
BGP EVPN-MPLS ES BMAC Dest TEP Info
===============================================================================
TEP Address               Egr Label               Last Change
                          Transport               
-------------------------------------------------------------------------------
192.0.2.69                262138                  07/15/2015 19:50:22
                          ldp                      
192.0.2.72                262136                  07/15/2015 19:50:22
                          ldp                      
-------------------------------------------------------------------------------
Number of entries : 2
-------------------------------------------------------------------------------
=============================================================================== 

es-pbr

Syntax 
es-pbr
Context 
show>service>id
Description 

When a filter with an action forward esi is successfully added to a VPLS service and the PE receives an EVPN Auto-Discovery route for the configured ESI, this command displays the PBR VXLAN bindings auto-created, including the ESI, the VXLAN VTEP:VNI and the status of the binding.

Output 

Sample Output
A:PE1# show service id 301 es-pbr 
===============================================================================
L2 ES PBR
===============================================================================
ESI                           Users      Status
                                         VTEP:VNI
-------------------------------------------------------------------------------
ff:00:00:00:00:00:00:00:00:01 1          Active
                                         192.0.2.72:7272
-------------------------------------------------------------------------------
Number of entries : 1
-------------------------------------------------------------------------------
===============================================================================

proxy-arp

Syntax 
proxy-arp ip-address [detail]
Context 
show>service>id
Description 

This command displays the proxy-ARP entries existing for a particular service. This table is populated by the EVPN MAC routes containing a MAC and an IP address , as well as static entries or dynamic entries from snooped ARP messages on access SAP/SDP-bindings. A 7750 SR, 7450 ESS, or 7950 XRS receiving an ARP request from a SAP or SDP-binding will perform a lookup in the proxy-arp table for the service. If the router finds a match, it will reply to the ARP and will not let the ARP be flooded in the VPLS service. If the router does not find a match, the ARP will be flooded within the service if the configuration allows it. The command allows for an specific IP addresses to be shown.

Output 

Sample Output
*A:DutA# show service id 1 proxy-arp 
-------------------------------------------------------------------------------
Proxy Arp
-------------------------------------------------------------------------------
Admin State       : enabled             
Dyn Populate      : enabled             
Age Time          : disabled            Send Refresh      : 120 secs
Table Size        : 250                 Total             : 2
Static Count      : 0                   EVPN Count        : 0
Dynamic Count     : 2                   Duplicate Count   : 0
Dup Detect
-------------------------------------------------------------------------------
Detect Window     : 3 mins              Num Moves         : 5
Hold down         : 9 mins              
Anti Spoof MAC    : None
EVPN
-------------------------------------------------------------------------------
Garp Flood        : enabled             Req Flood         : enabled
-------------------------------------------------------------------------------
===============================================================================
*A:DutA# show service id 1 proxy-arp detail 
-------------------------------------------------------------------------------
Proxy Arp
-------------------------------------------------------------------------------
Admin State       : enabled             
Dyn Populate      : enabled             
Age Time          : disabled            Send Refresh      : 120 secs
Table Size        : 250                 Total             : 2
Static Count      : 0                   EVPN Count        : 0
Dynamic Count     : 2                   Duplicate Count   : 0
Dup Detect
-------------------------------------------------------------------------------
Detect Window     : 3 mins              Num Moves         : 5
Hold down         : 9 mins              
Anti Spoof MAC    : None
EVPN
-------------------------------------------------------------------------------
Garp Flood        : enabled             Req Flood         : enabled
-------------------------------------------------------------------------------
===============================================================================
VPLS Proxy Arp Entries
===============================================================================
IP Address          Mac Address         Type      Status    Last Update
-------------------------------------------------------------------------------
10.10.10.1          00:ca:ca:ba:ca:01   dyn       active    07/15/2015 19:53:31
10.10.10.3          00:ca:ca:ba:ca:03   dyn       active    07/15/2015 19:53:21
-------------------------------------------------------------------------------
Number of entries : 2
===============================================================================

vxlan

Syntax 
vxlan
vxlan [vtep ip-address]
Context 
show>service>id
show>service
Description 

This command displays the VXLAN bindings auto-created in a given service. A VXLAN binding is composed of the remote VTEP (VXLAN Termination Endpoint) and the corresponding egress VNI (VXLAN Network Identifier) to identify the service at the egress node. The command shows the number of MACs associated to each binding as well as the operational status and if the binding is part of the multicast list. The binding will be operationally down when the VTEP address is not found in the base routing table (the VTEP address cannot be reached). A binding will be part of the multicast list if a valid BGP EVPN inclusive multicast route exists for it.

Output 

Sample Output
*A:DutAA# show service id 101 vxlan 
show service id 101 vxlan 
===============================================================================
VPLS VXLAN, Ingress VXLAN Network Id: 101
===============================================================================
Egress VTEP, VNI
===============================================================================
VTEP Address           Egress VNI     Num. MACs    Mcast   Oper State   L2 PBR
-------------------------------------------------------------------------------
192.0.2.71             101            1            No      Up           No
-------------------------------------------------------------------------------
Number of Egress VTEP, VNI : 1
-------------------------------------------------------------------------------
A:DutB# show service vxlan <vtep>  192.0.2.65   192.0.2.66
A:DutB# show service vxlan 192.0.2.65 
===============================================================================
VXLAN Tunnel Endpoint: 192.0.2.65
===============================================================================
Egress VNI                    Service Id               Oper State
-------------------------------------------------------------------------------
60                            60                       Up
-------------------------------------------------------------------------------
===============================================================================

evpn-mpls

Syntax 
evpn-mpls [TEP ip-address]
Context 
show>service
Description 

This command shows the remote EVPN-MPLS tunnel endpoints in the system.

Output 

Sample Output
*A:PE70(4)# show service evpn-mpls 
===============================================================================
EVPN MPLS Tunnel Endpoints
===============================================================================
EvpnMplsTEP Address EVPN-MPLS Dest      ES Dest             ES BMac Dest
-------------------------------------------------------------------------------
192.0.2.69          3                   1                   1
192.0.2.71          2                   0                   0
192.0.2.72          3                   1                   1
192.0.2.73          2                   1                   0
192.0.2.254         1                   0                   0
-------------------------------------------------------------------------------
Number of EvpnMpls Tunnel Endpoints: 5
-------------------------------------------------------------------------------
===============================================================================
*A:PE70(4)# show service evpn-mpls 
<TEP ip-address>
 192.0.2.69   192.0.2.71   192.0.2.72   192.0.2.73   192.0.2.254
*A:PE70(4)# show service evpn-mpls 192.0.2.69 
===============================================================================
BGP EVPN-MPLS Dest
===============================================================================
Service Id                              Egr Label
-------------------------------------------------------------------------------
1                                       262140
1                                       262141
20000                                   262138
-------------------------------------------------------------------------------
===============================================================================
===============================================================================
BGP EVPN-MPLS Ethernet Segment Dest
===============================================================================
Service Id          Eth Seg Id                              Egr Label
-------------------------------------------------------------------------------
1                   01:00:00:00:00:71:00:00:00:01           262141
-------------------------------------------------------------------------------
===============================================================================
===============================================================================
BGP EVPN-MPLS ES BMac Dest
===============================================================================
Service Id               ES BMac                  Egr Label
-------------------------------------------------------------------------------
20000                    00:00:00:00:71:71        262138
-------------------------------------------------------------------------------
===============================================================================

server

Syntax 
server [name]
Context 
show>system>xmpp
Description 

This command shows the connectivity to the XMPP server, including the configured parameters and statistics. When the user provides the name of the server, a detailed view is shown.

Output 

Sample Output
:sr12U-46-PE2# show system xmpp server           
==========================================================================
XMPP Server Table
==========================================================================
Name                            User Name          State
 XMPP FQDN                       Last State chgd    Admin State
--------------------------------------------------------------------------
vsd1-hy                         cspTest             Functional
 vsd1-hy.alu-srpm.us             0d 22:42:15        inService
--------------------------------------------------------------------------
No. of XMPP server's: 1
==========================================================================
B:Dut# show system xmpp server "vsd1-hy" 
==========================================================================
XMPP Server Table
==========================================================================
XMPP FQDN          : vsd1-hy.alu-srpm.us
XMPP Admin User    : cspTest             
XMPP Oper User     : cspTest             
State Lst Chg Since: 0d 22:40:16        State              : Functional
Admin State        : Up                 Connection Mode    : outOfBand
Auth Type          : md5
IQ Tx.             : 306                IQ Rx.             : 306
IQ Error           : 72                 IQ Timed Out       : 0
IQ Min. Rtt        : 100 ms             IQ Max. Rtt        : 450 ms
IQ Ack Rcvd.       : 234                
Push Updates Rcvd  : 41                 VSD list Upd Rcvd  : 91
Msg Tx.            : 279                Msg Rx.            : 207
Msg Ack. Rx.       : 135                Msg Error          : 72
Msg Min. Rtt       : 0 ms               Msg Max. Rtt       : 450 ms
Sub Tx.            : 1                  UnSub Tx.          : 0
Msg Timed Out      : 0                  
 
==========================================================================

vsd

Syntax 
vsd [entry]
Context 
show>system
show>system>xmpp
Description 

This command shows the connectivity to the VSD server, including the configured parameters and statistics. When the user provides the entry number of the VSD server as shown in the show system xmpp vsd command, a detailed view for that specific server is shown, including statistics.

Output 

Sample Output
:Dut# show system vsd 
==========================================================================
VSD Information
==========================================================================
System Id               : SR12U-46-PE
GW Last Audit Tx Time   : 03/07/2000 04:07:06
Gateway Publish-Subscribe Information
--------------------------------------------------------------------------
Subscribed              : True
Subscriber Name         : nuage_gateway_id_SR12U-46-PE
Last Subscription Time  : 03/06/2000 05:27:06
==========================================================================
*B:Dut# show system xmpp vsd   
==========================================================================
Virtual Services Directory Table
==========================================================================
Id User Name                    Uptime             Status
--------------------------------------------------------------------------
1  cna@vsd1-hy.alu-srpm.us/nua* 0d 22:45:39        Available
--------------------------------------------------------------------------
No. of VSD's: 1
==========================================================================
*B:Dut# show system xmpp vsd 1 
==========================================================================
VSD Server Table
==========================================================================
VSD User Name      : cna@vsd1-hy.alu-srpm.us/nuage
Uptime             : 0d 22:45:41        Status             : Available
Msg Tx.            : 282                Msg Rx.            : 209
Msg Ack. Rx.       : 136                Msg Error          : 73
Msg TimedOut       : 0                  Msg MinRtt         : 70 ms
Msg MaxRtt         : 450 ms             
 
==========================================================================

domain

Syntax 
domain [domain-name] [association]
Context 
show>system>vsd
Description 

This command shows the different VSD domains configured in the system. If association is added, the VSD domain to service association is shown. If a specific domain-name is used, configuration event statistics are shown.

Output 

Sample Output
B:Dut# show service vsd domain 
===============================================================================
VSD Domain Table
===============================================================================
Name                                    Type           Origin    Admin
-------------------------------------------------------------------------------
nuage_401                               l2DomainIrb    manual    inService
nuage_402                               l2Domain       manual    inService
nuage_501                               l2Domain       manual    inService
nuage_502                               l2Domain       manual    inService
-------------------------------------------------------------------------------
Number of entries: 4
===============================================================================
*B:Dut# show service vsd domain "nuage_501" 
===============================================================================
VSD Information
===============================================================================
Name               : nuage_501
Description        : nuage_501_l2_domain
Type               : l2Domain                     Admin State   : inService
Last Error To Vsd  : (Not Specified)
Last Error From Vsd: (Not Specified)
Statistics
-------------------------------------------------------------------------------
Last Cfg Chg Evt   : 01/01/2000 00:00:11          Cfg Chg Evts  : 0
Last Cfg Update    : 01/01/2000 00:00:11          Cfg Upd Rcvd  : 0
Last Cfg Done      : 01/01/2000 00:00:11          
Cfg Success        : 0                            Cfg Failed    : 0
===============================================================================
*B:Dut# show service vsd domain "nuage_501" association 
============================================================
Service VSD Domain
============================================================
Svc Id      Svc Type  Domain Type    Domain Admin   Origin
------------------------------------------------------------
501         vpls      l2Domain       inService      manual
------------------------------------------------------------
Number of entries: 1
============================================================
*B:sr12U-46-PE2# show service vsd domain association             
===========================================
Services-using VSD Domain
===========================================
Svc Id     Domain
-------------------------------------------
501        nuage_501
502        nuage_502
-------------------------------------------
Number of services using VSD Domain: 2
===========================================

redundancy

Syntax 
redundancy
Context 
show
Description 

This command enables the context for the display of global redundancy parameters.

bgp-evpn-multi-homing

Syntax 
bpg-evpn-multi-homing
Context 
show>redundancy
Description 

This command shows the information related to the EVPN global timers.

Output 

Sample Output
*A:PE2# show redundancy bgp-evpn-multi-homing 
===============================================================================
Redundancy BGP EVPN Multi-homing Information
===============================================================================
Boot-Timer              : 10 secs                 
Boot-Timer Remaining    : 0 secs                  
ES Activation Timer     : 3 secs                  
===============================================================================

Clear Commands

domain

Syntax 
domain [name]
Context 
clear>service>statistics>vsd
Description 

This command clears the statistics shown in the show service vsd domain name command.

Parameters 
name —
specifies the vsd domain name.

scripts

Syntax 
scripts
Context 
clear>service>statistics>vsd
Description 

This command clears the statistics shown in the show service vsd script statistics command.

server

Syntax 
server [xmpp-server-name]
Context 
clear>system>statistics>xmpp
Description 

This command clears the statistics shown in the show system xmpp server name command.

Parameters 
xmpp-server-name —
Specifies the vsd domain name.

ver

Syntax 
server [xmpp-server-name]
Context 
clear>system>statistics>xmpp
Description 

This command clears the statistics shown in the show system xmpp server name command.

Parameters 
xmpp-server-name —
Specifies the vsd domain name.

Debug Commands

xmpp

Syntax 
xmpp [connection] [gateway] [message] [vsd] [iq] [all]
no xmpp
Context 
debug>system
Description 

This command enables the debug for XMPP messages sent or received by the 7750 SR, 7450 ESS, or 7950 XRS.

Parameters 
connection —
Filters only the messages related to the XMPP connection.
gateway —
Filters the messages related to the gateway.
message—
Filters only the messages.
vsd —
Filters the vsd messages.
iq—
Filters the IQ messages between the gateway and the vsd.
all —
Includes all the above.

vsd

Syntax 
vsd
Context 
debug
Description 

This command enables the context for the debug vsd commands.

scripts

Syntax 
scripts
scripts event [cli] [errors] [executed-cmd] [state-change] [warnings]
scripts instance instance event [cli] [errors] [executed-cmd] [state-change] [warnings]
Context 
debug>vsd
Description 

This command enables the debug of the VSD fully dynamic integration scripts.

event

Syntax 
[no] event
Context 
debug>vsd>script
Description 

This command enables/disables the generation of all script debugging event output: cli, errors, execute-cmd, warnings, state-change.

instance

Syntax 
[no] instance instance
Context 
debug>vsd>script
Description 

This command enables/disables the generation of script debugging for a specific instance

Parameters 
instance—
Specifies the instance name.

cli

Syntax 
[no] cli
Context 
debug>vsd>script>event
debug>vsd>script>instance
Description 

This command enables/disables the generation of a specific script debugging event output: cli.

errors

Syntax 
[no] errors
Context 
debug>vsd>script>event
debug>vsd>script>instance
Description 

This command enables/disables the generation of a specific script debugging event output: errors.

executed-cmd

Syntax 
[no] executed-cmd
Context 
debug>vsd>script>event
debug>vsd>script>instance
Description 

This command enables/disables the generation of a specific script debugging event output: execute-cmd.

state-change

Syntax 
[no] state-change
Context 
debug>vsd>script>event
debug>vsd>script>instance
Description 

This command enables/disables the generation of a specific script debugging event output: state-change.

warnings

Syntax 
[no] warnings
Context 
debug>vsd>script>event
debug>vsd>script>instance
Description 

This command enables/disables the generation of a specific script debugging event output: warnings.

Tools Commands

service

Syntax 
service
Context 
tools>dump
Description 

Use this command to configure tools to display service dump information.

id

Syntax 
id service-id
Context 
tools>dump
Description 

Use this command to configure parameters to display service ID information.

vxlan

Syntax 
vxlan [clear]
Context 
tools>dump>service>id
Description 

This command displays the number of times a service could not add a VXLAN binding or <VTEP, Egress VNI> due to the following limits:

  1. The per System VTEP limit has been reached
  2. The per System <VTEP, Egress VNI> limit has been reached
  3. The per Service <VTEP, Egress VNI> limit has been reached
  4. The per System Bind limit: Total bind limit or vxlan bind limit has been reached.

The command adds a clear option to clear the above statistics.

Output 

Sample Output
*A:PE63# tools dump service id 3 vxlan
VTEP, Egress VNI Failure statistics at 000 00:03:55.710:
statistics last cleared at 000 00:00:00.000:
      Statistic            |    Count
---------------------------+-------------
                      VTEP |          0
             Service Limit |          0
              System Limit |          0
   Egress Mcast List Limit |          0
Duplicate VTEP, Egress VNI |          1

dup-vtep-egrvni

Syntax 
dup-vtep-egrvni [clear]
Context 
tools>dump>service>vxlan
Description 

This command dumps the <VTEP, VNI> bindings that have been detected as duplicate attempts, i.e. an attempt to add the same binding to more than one service. The commands provides a clear option.

Output 

Sample Output
*A:PE71# tools dump service vxlan dup-vtep-egrvni
Duplicate VTEP, Egress VNI usage attempts at 000 00:03:41.570:
1. 10.1.1.1:100

usage

Syntax 
usage
Context 
tools>dump>service>id>evpn
Description 

This command shows the maximum number of EVPN-tunnel interface IP next-hops per R-VPLS as well as the current usage for a given R-VPLS service.

Output 

Sample Output
*A:PE71# tools dump service id 504 evpn usage 
Evpn Tunnel Interface IP Next Hop: 1/8189

domain-to-vsd-mapping

Syntax 
domain-to-vsd-mapping
Context 
tools>dump>service
Description 

This command enables the context for the domain-to-vsd mappings.

domain

Syntax 
domain name name
Context 
tools>dump>service>domain-to-vsd-mapping
Description 

This command shows mapping of a given VSD to a vsd-domain.

Output 

Sample Output
Dut# tools dump service domain-to-vsd-mapping domain name "nuage_501" 
===============================================================================
Domain to VSD Mapping
===============================================================================
Domain name                      VSD
-------------------------------------------------------------------------------
nuage_501                        cna@vsd1-hy.alu-srpm.us/nuage
================================================================= 

xmpp

Syntax 
xmpp
Context 
tools>perform>system
Description 

This command enables the xmpp context.

vsd-refresh

Syntax 
vsd-refresh
Context 
tools>perform>system>xmpp
Description 

This command instructs the system to refresh immediately the list of VSDs and not to wait for the next VSD list audit that the system does periodically.

fd-domain-sync

Syntax 
fd-domain-sync {full | diff}
Context 
tools>perform>service>vsd
Description 

This command instructs the system to audit the VSD to get the "DIFF" list of even the "FULL" list of all the do-mains in the VSD.

evaluate-script

Syntax 
evaluate-script domain-name [64 chars max] type [type] action script-action [vni vni-id] [rt-i ext-community] [rt-e ext-community] [metadata metadata] policy python-policy
Context 
tools>perform>service>vsd
Description 

The command enables the user to test their setup, and modify and teardown python scripts in a lab environment without the need to be connected to a VSD. The successful execution of the command for action setup will create a vsd domain and the corresponding configuration, just as the system would do when the parameters are received from VSD.

Output 

Sample Output
*A:PE1# tools perform service vsd evaluate-script domain-name "L2-DOMAIN-5" type l2-
domain action setup policy "py-l2" vni 64000 rt-i target:64000:64000 rt-
e target:64000:64000 metadata "rd=1:1, sap=1/1/10:3000"   
Success

name

Syntax 
name [name] refresh-config
Context 
tools>perform>service>vsd>domain
Description 

This command instructs the system to refresh the configuration of a given domain immediately instead of waiting for the next audit interval.

bgp-evpn

Syntax 
bpg-evpn
Context 
tools>dump>service>system
Description 

This command enables the context for the bgp-evpn base instance.

ethernet-segment

Syntax 
ethernet-segment name evi evi df
ethernet-segment name isid isid df
Context 
tools>dump>service>system>bgp-evpn
Description 

This command shows the computed DF PE for a given evi or isid.

Output 

Sample Output
*A:PE2# tools dump service system bgp-evpn ethernet-segment "ESI-71" evi 1 df 
[07/15/2015 21:52:08] Computed DF: 192.0.2.72 (Remote) (Boot Timer Expired: Yes) 
*A:PE2# tools dump service system bgp-evpn ethernet-segment "ESI-71" isid 20001 df 
[07/15/2015 21:52:21] Computed DF: 192.0.2.72 (Remote) (Boot Timer Expired: Yes)

evpn

Syntax 
evpn
Context 
tools>dump>service
Description 

This command enables the context for the global evpn parameters.

usage

Syntax 
usage
Context 
tools>dump>service>evpn
Description 

This command displays the consumed VXLAN EVPN resources in the system.

Output 

Sample Output
*A:PE71# tools dump service evpn usage            
EVPN usage statistics at 000 02:01:03.810:
MPLS-TEP                                        :             5
VXLAN-TEP                                       :             2
Total-TEP                                       :      7/  8191
Mpls Dests (TEP, Egress Label + ES + ES-BMAC)   :            16
Vxlan Dests (TEP, Egress VNI)                   :             2
Total-Dest                                      :     18/131071
Sdp Bind +  Evpn Dests                          :     20/196607
RVPLS Egress VNI                                :      1/40959
ES L2/L3 PBR                                    :      0/ 32767

vsd-services

Syntax 
vsd-services
Context 
tools>dump>service
Description 

This command enables the context for vsd-services commands.

command-list

Syntax 
command-list
Context 
tools>dump>service>vsd-services
Description 

This command displays the list of CLI nodes allowed in the VSD fully dynamic provisioning model. Python will have access to the shown nodes.

When access is granted to a node, all commands in that node are allowed; however, CLI nodes are only allowed if explicitly listed. Nodes in CLI are shown with a "+" in the CLI.

While you can navigate special "Pass through nodes" via these nodes, the commands in that node are not implicitly allowed. When configured in a service through VSD, these commands will not be shown in the 'info' output of the config command.

Note:

A 'node' implies leaf-nodes and leaf-table nodes in reality. A 'Leaf-table' is a sub-table that looks like a leaf (i.e. it is entered/displayed as a one-liner). An example of leaf-table node is /configure router policy-options prefix-list x prefix 0.0.0.0/0 - since you can have multiple instances of prefixes.