tracert evpn vpws

Function

The tracert evpn vpws command locates an EVPN VPWS tunnel forwarding fault.

Format

tracert evpn vpws local-ce-id remote-ce-id [ vpn-instance evpn-name ] [ end-op endOp | control-word ] [ -a source-ip | -exp exp-value | -s packet-size | -t timeout | -h max-ttl | -r reply-mode | -tc tc | -service-class classValue ] * [ pipe | uniform ]

Parameters

Parameter Description Value
local-ce-id

Specifies a local EVPN VPWS ID.

The value is an integer ranging from 1 to 16777215.

remote-ce-id

Specifies a remote EVPN VPWS ID.

The value is an integer ranging from 1 to 16777215.

vpn-instance evpn-name

Specifies the name of an EVPN instance. This parameter needs to be specified if the local service ID is not globally unique.

The value is a string of 1 to 31 characters.

end-op endOp

Specifies the ID of an End.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

control-word

Specifies that the sent packet carries a control word. This parameter needs to be configured in a cross-domain scenario.

-

-a source-ip

Specifies a source IP address for EVPN VPWS echo request packets.

If the source address is not specified, the encapsulation source-address address is preferentially used in the SRv6 BE scenario. In other scenarios, the address of the outbound interface is used as the source address of EVPN VPWS echo request packets.

The value is in dotted decimal notation or a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

-exp exp-value

Specifies the EXP value of EVPN VPWS echo request packets to be sent.

The value is an integer ranging from 0 to 7. The default value is 0.

-s packet-size

Specifies the size of a payload packet to be sent without the IP header or UDP head.

The value is an integer ranging from 96 to 9600, in bytes. The default value is 160.

-t timeout

Specifies a timeout period for waiting an EVPN VPWS echo reply packet after an EVPN VPWS echo request packet is sent.

The value is an integer ranging from 0 to 65535, in milliseconds. The default value is 2000.

-h max-ttl

Specifies the mode in which the peer responds with EVPN VPWS echo reply messages.

The value is an integer ranging from 1 to 255. The default value is 30.

-r reply-mode

Specifies the mode in which the peer responds with EVPN VPWS echo reply messages.

The value is 2 or 4.

  • 2: reply with an IPv4 or IPv6 UDP packet
  • 4: reply through the control channel of the application plane

The default value is 2.

-tc tc

Specifies a traffic class for ICMP echo request messages.

The value is an integer ranging from 0 to 255. The default value is 0.

-service-class classValue

In an SRv6 TE Policy group scenario, you can specify this parameter to select a path.

The value is of the enumerated type and can be be, af1, af2, af3, af4, ef, cs6, or cs7.

pipe

Specifies the pipe mode. In this mode, when a probe packet passes through an MPLS domain, the IP TTL value is decreased by 1 only on the ingress and egress nodes. The MPLS domain is used as the next hop.

-

uniform

Specifies the uniform mode. The IP TTL value is decreased by 1 each time a probe packet passes through one hop in the MPLS domain.

-

Views

All views

Default Level

2: Configuration level

Task Name and Operations

Task Name Operations
tailmode1 execute

Usage Guidelines

Usage Scenario

If an EVPN VPWS LSP fails, you can run the ping evpn vpws command to check link connectivity and use the tracert evpn vpws command to locate the specific failure point.

EVPN VPWS tracert locates EVPN VPWS tunnel forwarding faults by sending EVPN VPWS echo request and EVPN VPWS echo reply messages. Both types of packets are UDP packets transmitted using port 3503. The receive end uses the UDP port number to identify EVPN VPWS echo request and reply packets. An EVPN VPWS echo request message carries information about the forwarding equivalence class (FEC) for an EVPN VPWS tunnel to be monitored. The EVPN VPWS echo request message is forwarded with other service packets of the same FEC along the EVPN VPWS tunnel. This procedure enables EVPN VPWS connectivity check. EVPN VPWS echo request packets are transmitted to the destination along EVPN VPWS tunnels, whereas EVPN VPWS echo reply packets are transmitted to the source through IP.

Currently, EVPN VPWS tracert supports only the MPLS public network. MPLS public networks supported include the LDP, TE, BGP LSP(label address family not supported), SR-MPLS TE, SR-MPLS BE, SRv6 BE, and SRv6 TE Policy.

Precautions

In the E-Line smooth evolution scenario, -r 4 cannot be specified to initiate a tracert test.

In an E-Line smooth evolution scenario, if a control word is specified, no error message is displayed when EVPN routes are iterated to an SRv6 tunnel, and the sent packets are the same as those when no control word is specified.

Example

# Perform a tracert operation on an EVPN VPWS network.
<HUAWEI> tracert evpn vpws 1 2
EVPN VPWS TRACE FEC: Local Evpn Vpws Id = 1, Remote Evpn Vpws Id = 2 , press CTRL_C to break 
TTL    Replier            Time    Type      Downstream
 0                                Ingress   10.1.1.1/[3 1 32927] 
 1     10.1.1.1           52 ms   Egress
Table 1 Description of the tracert evpn vpws command output
Item Description
Local Evpn Vpws Id

Local EVPN VPWS ID.

Remote Evpn Vpws Id

Remote EVPN VPWS ID.

press CTRL_C to break

You can press CTRL+C to stop the ongoing tracert test.

TTL

Sequence of the hop.

Replier

IP address of an intermediate node that responds with an MPLS VPWS echo reply message.

Time

Round-Trip Time (RTT) value, in milliseconds.

Type

Node type. The value can be:

  • Ingress: indicates the ingress node.
  • Transit: indicates transit nodes on a tunnel.
  • Egress: indicates the egress node.
Downstream

Next-hop IP address and pushed label value.

Copyright © Huawei Technologies Co., Ltd.
Copyright © Huawei Technologies Co., Ltd.
< Previous topic Next topic >