udp-port udp-port: Specifies the destination UDP port number for BIER OAM packets (BIER echo requests and BIER echo replies). The value is in the range of 1024 to 65535, and the default is 49100.

Usage guidelines

Devices transmit BIER OAM packets over UDP. To avoid UDP port conflict between BIER OAM and other protocols, use the default UDP port number for BIER OAM packets.

For all BFRs in a BIER sub-domain to receive BIER echo requests, specify the same UDP port number for the BFRs.

Examples

# Disable BIER OAM.

<Sysname> system-view

[Sysname] bier

[Sysname-bier] undo bier ipv6 oam enable

ping bier

Use ping bier to test the reachability of one or a range of BIER BFRs and display ping statistics.

Syntax

ping bier { bierv6 | g-bier | msr6 } sub-domain sub-domain-id bsl bsl-value bfr-id bfr-id-value [ to bfr-id-end-value ] [ -c count | -h ttl-value | -m interval | -t timeout | udp-port udp-port ] *

Views

Any view

Predefined user roles

network-admin

Parameters

bierv6: Specifies Bit Index Explicit Replication IPv6 Encapsulation (BIERv6) for BIER packets.

g-bier: Specifies Generalized BIER (G-BIER) encapsulation for BIER packets.

msr6: Specifies Multicast Source Routing over IPv6 (MSR6) for BIER packets.

sub-domain sub-domain-id: Specifies a BIER sub-domain by its ID in the range of 0 to 255.

bsl bsl-value: Specifies a BSL value. The valid values are 64, 128, and 256.

bfr-id bfr-id-value [ to bfr-id-end-value ]: Specifies a destination BFR by its ID or specifies a range of destination BFRs in the form of bfr-id-value to bfr-id-end-value. The value range for the bfr-id-value argument is 1 to 65535. The value range for the bfr-id-end-value argument is 2 to 65535. The end ID must be equal to or greater than the start ID.

-c count: Specifies the number of BIER echo requests to be sent to each destination BFR. The value range is 1 to 65535, and the default is 5.

-h ttl-value: Specifies the TTL value of BIER echo requests. The value range is 1 to 255, and the default is 255.

-m interval: Specifies the interval (in milliseconds) to send BIER echo requests. The value range is 100 to 10000, and the default is 2000.

-t timeout: Specifies the timeout time (in milliseconds) for a response from the destination. The value range is 100 to 65535, and the default is 2000.

udp-port udp-port: Specifies the destination UDP port number for BIER echo requests. The value range is 1024 to 65535, and the default is 49100.

Usage guidelines

Before using this command, make sure BIER OAM is enabled.

If you specify multiple destination BFRs in this command, make sure all the BFRs are in the same SI.

After sending a BIER echo request, the device waits for the response timeout to expire before a subsequent transmission if the specified echo request transmission interval is less than the response timeout.

To stop the ping operation after the command is issued, press Ctrl+C.

Examples

# Ping BFR 22 in BIER sub-domain 0 to test whether it is reachable, with the G-BIER encapsulation type and a bitstring length of 128 in the BIER header.

<Sysname> ping bier g-bier sub-domain 0 bsl 128 bfr-id 22

Ping BIER: Sub-domain ID: 0, BSL: 128, BFR-IDs: 22, press CTRL_C to break

BFR-ID: 22 Request timed out

--- Ping statistics for BFR-ID (22)---

5 packets transmitted, 0 packets received, 100.00% packet loss

Round-trip min/avg/max=0.000/0.000/0.000 ms

# Ping BFR 22 in BIER sub-domain 0 to test whether it is reachable, with the BIERv6 encapsulation type and a bitstring length of 128 in the BIER header.

<Sysname> ping bier bierv6 sub-domain 0 bsl 128 bfr-id 22

Ping BIER: Sub-domain ID: 0, BSL: 128, BFR-IDs: 22, press CTRL_C to break

BFR-ID: 22 Request timed out

--- Ping statistics for BFR-ID (22)---

5 packets transmitted, 0 packets received, 100.00% packet loss

Round-trip min/avg/max=0.000/0.000/0.000 ms

# Ping BFR 22 in BIER sub-domain 0 to test whether it is reachable, with the MSR6 encapsulation type and a bitstring length of 128 in the BIER header.

<Sysname> ping bier msr6 sub-domain 0 bsl 128 bfr-id 22

Ping BIER: Sub-domain ID: 0, BSL: 128, BFR-IDs: 22, press CTRL_C to break

BFR-ID: 22 Request timed out

--- Ping statistics for BFR-ID (22)---

5 packets transmitted, 0 packets received, 100.00% packet loss

Round-trip min/avg/max=0.000/0.000/0.000 ms

# Ping BFR 2 in BIER sub-domain 0 to test whether it is reachable, with the G-BIER encapsulation type and a bitstring length of 128 in the BIER header.

<Sysname> ping bier g-bier sub-domain 0 bsl 128 bfr-id 2

Ping BIER: Sub-domain ID: 0, BSL: 128, BFR-IDs: 2, press CTRL_C to break

88 bytes from BFR-ID: 2 (2001:db8:1::1), Sequence=1 time=10.000 ms ReturnCode=3

88 bytes from BFR-ID: 2 (2001:db8:1::1), Sequence=2 time=4.000 ms ReturnCode=3

88 bytes from BFR-ID: 2 (2001:db8:1::1), Sequence=3 time=4.000 ms ReturnCode=3

88 bytes from BFR-ID: 2 (2001:db8:1::1), Sequence=4 time=4.000 ms ReturnCode=3

88 bytes from BFR-ID: 2 (2001:db8:1::1), Sequence=5 time=4.000 ms ReturnCode=3

--- Ping statistics for BFR-ID (22) ---

5 packets transmitted, 5 packets received, 0.0% packet loss

Round-trip min/avg/max=4.000/5.200/10.000 ms

# Ping BFRs 1 through 4 in BIER sub-domain 0 to test whether they are reachable, with the G-BIER encapsulation type, a bitstring length of 128 in the BIER header, and three G-BIER echo requests to each of those BFRs.

<Sysname> ping bier g-bier sub-domain 0 bsl 128 bfr-id 1 to 4 –c 3

Ping BIER: Sub-domain ID: 1, BSL: 128, BFR-IDs: [1,4], press CTRL_C to break

88 bytes from BFR-ID: 1 (2001:db8:1::1), Sequence=1 time=10.000 ms ReturnCode=4

88 bytes from BFR-ID: 2 (2002:db8:1::1), Sequence=1 time=4.000 ms ReturnCode=4

BFR-ID: 3 Request timed out

BFR-ID: 4 Request timed out

88 bytes from BFR-ID: 1 (2001:db8:1::1), Sequence=2 time=11.000 ms ReturnCode=4

88 bytes from BFR-ID: 2 (2002:db8:1::1), Sequence=2 time=5.000 ms ReturnCode=4

BFR-ID: 3 Request time out

BFR-ID: 4 Request time out

88 bytes from BFR-ID: 1 (2001:db8:1::1), Sequence=3 time=10.000 ms ReturnCode=4

88 bytes from BFR-ID: 2 (2002:db8:1::1), Sequence=3 time=5.000 ms ReturnCode=4

BFR-ID: 3 Request time out

BFR-ID: 4 Request time out

--- Ping statistics for BFR-ID (1) ---

3 packets transmitted, 3 packets received, 0.0% packet loss

Round-trip min/avg/max=10.000/10.333/11.000 ms

--- Ping statistics for BFR-ID (2) ---

3 packets transmitted, 3 packets received, 0.0% packet loss

Round-trip min/avg/max=4.000/4.667/5.000 ms

--- Ping statistics for BFR-ID (3) ---

3 packets transmitted, 0 packets received, 100.00% packet loss

Round-trip min/avg/max=0.000/0.000/0.000 ms

--- Ping statistics for BFR-ID (4) ---

3 packets transmitted, 0 packets received, 100.00% packet loss

Round-trip min/avg/max=4.000/4.667/5.000 ms

Table 1 Command output

Field	Description
Ping BIER: Sub-Domain ID, BSL, BFR-IDs,	Test whether a BFR in the BIER network is reachable: · Sub-Domain ID—The BIER sub-domain ID where the destination BFR resides. · BSL—Bitstring length in the BIER header. · BFR-IDs—Destination BFR ID or BFR ID range.
press CTRL_C to break	To stop the BIER ping operation, you can press Ctrl+C.
BFR-ID: ID Request timed out	This result is displayed when the request to the specified BFR timed out.
bytes from BFR-ID:,	This result is displayed when the specified BFR is detected reachable: · bytes: Length of the response packet. The value depends on the BSL. ¡ When the BSL is set to 256, the response packet is 104 bytes. ¡ When the BSL is set to 128, the response packet is 88 bytes. ¡ When the BSL is set to 64, the response packet is 80 bytes. · BFR-ID: ID of the destination BFR, with the corresponding BFR prefix displayed in parentheses.
Sequence	Sequence number of the reply packet, used to determine whether a segment is lost, disordered, or repeated.
time	Response time.
ReturnCode	Return code: · 1—The received BIER OAM echo request packet is malformed. · 2—The reply packet contains one or more unsupported TLVs. · 3—The replying BFR is the only BFER matching the BitString field in the echo request header. · 4—The replying BFR is one of the BFERs matching the BitString field in the echo request header. · 5—The echo request packet is forwarded successfully. · 6—The received echo request contains multipath information for more than one BFER. (This field is not supported in the current software version.) · 8—No matching entry in the local BIER forwarding table. · 9—The SI in the received echo request does not match that assigned for the local BFR. · 10—The BitString field in the received echo request does not match that in the Downstream Detailed Mapping TLV. (This field is not supported in the current software version.)
--- Ping statistics for BFR-ID ---	Statistics on data received and sent in the ping operation, with the ID of the destination BFR displayed in parentheses.
packets transmitted	Number of transmitted BIER OAM echo request packets. The value must be consistent with the -c parameter specified in this command.
packets received	Number of received BIER OAM echo reply packets.
packet loss	Percentage of unacknowledged packets to the total packets sent.
Round-trip min/avg/max	Minimum/average/maximum response time, in milliseconds.

Related commands

bier ipv6 oam enable

tracert bier

Use tracert bier to trace the path that a BIER packet traverses from source to destination.

Syntax

tracert bier { bierv6 | g-bier | msr6 } sub-domain sub-domain-id bsl bsl-value bfr-id bfr-id-value [ to bfr-id-end-value ] [ entropy entropy-value [ to entropy-end-value ] | -ds | -h ttl-value | -ibs | -t timeout | -tbs | udp-port udp-port ] *

Views

Any view

Predefined user roles

network-admin

Parameters

bierv6: Specifies Bit Index Explicit Replication IPv6 Encapsulation (BIERv6) for BIER packets.

g-bier: Specifies Generalized BIER (G-BIER) encapsulation for BIER packets.

msr6: Specifies Multicast Source Routing over IPv6 (MSR6) for BIER packets.

sub-domain sub-domain-id: Specifies a BIER sub-domain by its ID in the range of 0 to 255.

bsl bsl-value: Specifies a BSL value. The valid values are 64, 128, 256.

entropy entropy-value [ to entropy-end-value ]: Specifies an entropy value, or a range of entropy values in the form of entropy-value to entropy-end-value for selecting a path from multiple equal-cost multipath (ECMP) paths. You must select the same path for BIER OAM packets with the same entropy value. The value range for the entropy-value argument is 0 to 1048575 and the default is 0. The value range for the entropy-end-value argument is 1 to 1048575. The end entropy value must be equal to or greater than the start entropy value.

-ds: Includes the Downstream Mapping TLV in BIER echo requests.

-h ttl-value: Specifies the TTL value of BIER echo requests. The value range is 1 to 255, and the default is 255.

-ibs: Sets the I flag in the Downstream Mapping TLV in BIER echo requests. With the I flag set, BIER echo replies will carry the Incoming SI-BitString TLV.

-t timeout: Specifies the number of milliseconds to wait for a response from the destination. The value range is 100 to 65535, and the default is 2000.

-tbs: Includes the Target SI-BitString TLV in BIER echo requests.

udp-port udp-port: Specifies the destination UDP port number for BIER echo requests. The value range is 1024 to 65535, and the default is 49100.

Usage guidelines

Before configuring this command, make sure BIER OAM is enabled.

After a fault is detected by using the ping bier command, you can use the tracert bier command to locate the fault point on the network.

If multiple BIER ECMP paths exist between the source node and destination node, specify an entropy value for selection of a path.

To stop the tracert operation after the command is issued, press Ctrl+C.

Examples

# Specify G-BIER packet encapsulation and display the path that a BIER packet traverse from BFR 120 to BFR 127. Configure the G-BIER OAM echo requests to carry the Target SI-BitString TLV and G-BIER OAM echo replies to carry the Incoming SI-BitString TLV and Downstream Mapping TLV.

<Sysname> tracert bier g-bier sub-domain 0 bsl 128 bfr-id 120 to 127 –tbs -ds–ibs

Traceroute BIER source BFR-Prefix=11::11, Destination BFR-IDs=[120,127], 255 hops at most, press CTRL_C to break

Entropy 0:

Original Bit String(HEX): 7F800000-00000000-00000000-00000000

TTL: 0

Target Bit String(HEX): 7F800000-00000000-00000000-00000000

Replier: -- Type: Ingress

Time: -- Return Code: 0

Downstream nodes:

33::33

Timeout Target Bit String(HEX): 00000000-00000000-00000000-00000000

TTL: 1

Target Bit String(HEX): 7F800000-00000000-00000000-00000000

Replier: 33::33 Type: Transit

Time: 2.000 ms Return Code: 5

Incoming Bit String(HEX): 10800000-00000000-00000000-00000000

Downstream nodes:

44::44

55::55

Timeout Target Bit String(HEX): 6F000000-00000000-00000000-00000000

TTL: 2

Target Bit String(HEX): 10800000-00000000-00000000-00000000

Replier: 44::44 Type: Transit

Time: 50.000 ms Return Code: 5

Incoming Bit String(HEX): 00800000-00000000-0000000-00000000

Downstream nodes:

66::66

88::88

Replier: 55::55 Type: Transit

Time: 50.000 ms Return Code: 5

Incoming Bit String(HEX): 10000000-00000000-00000000-00000000

Downstream nodes:

88::88

Timeout Target Bit String(HEX): 00000000-00000000-00000000-00000000

TTL: 3

Target Bit String(HEX): 10800000-00000000-00000000-00000000

Replier: 66::66 Type: Egress

Time: 80.000 ms Return Code: 3

Incoming Bit String(HEX): 00800000-00000000-0000000-00000000

Downstream nodes:

Replier: 88::88 Type: Egress

Time: 90.000 ms Return Code: 3

Incoming Bit String(HEX): 10000000-00000000-00000000-00000000

Downstream nodes:

Timeout Target Bit String(HEX): 00000000-00000000-00000000-00000000

Summary:

Path to BFR-ID 120 (66::66)

TTL Replier Time Downstream

0 -- -- 33::33

1 33::33 2.000 ms 44::44

2 44::44 50.000 ms 66::66

3 66::66 80.000 ms --

Path to BFR-ID 125 (88::88)

TTL Replier Time Downstream

0 -- -- 33::33

1 33::33 2.000 ms 55::55

2 55::55 50.000 ms 88::88

3 88::88 90.000 ms --

Table 2 Command output

Field	Description
Traceroute BIER source BFR-Prefix, Destination BFR-ID	Display the route that the packets traverse from the current BFR to the destination BFR. · source BFR-Prefix: Prefix of the source BFR. · Destination BFR-ID: Destination BFR ID or BFR ID range.
hops at most	Maximum number of hops.
press CTRL_C to break	To stop the tracert operation, press Ctrl+C.
Entropy	Entropy value used for selecting a path from multiple ECMP paths.
Original Bit String(HEX)	Bit string in the Original SI-BitString TLV carried in the BIER OAM echo request (in hexadecimal format, with the least significant bit at the rightmost)
TTL	TTL value.
Target Bit String(HEX)	Bit string in the Target SI-BitString TLV carried in the BIER OAM echo request (in hexadecimal format, with the least significant bit at the rightmost). When the TTL is 0, the value is consistent with the original bit string. This field is available only after you specify the -ds or tbs keyword.
Replier	Prefix of the replying BFR. This field displays -- if the TTL is 0.
Type	BFR type: · Ingress—Ingress BFR. · Transit—Transit BFR. · Egress—Egress BFR.
Time	Response time.
Return Code	Return code: · 1—The received BIER OAM echo request packet is malformed. · 2—The reply packet contains one or more unsupported TLVs. · 3—The replying BRF is the only BFER matching the BitString field in the echo request header. · 4—The replying BRF is one of the BFERs matching the BitString field in the echo request header. · 5—The echo request packet is forwarded successfully. · 6—The received echo request contains multipath information for more than one BFER. (This field is not supported in the current software version.) · 8—No matching entry in the local BIER forwarding table. · 9—The SI in the received echo request does not match that assigned for the local BFR. · 10—The BitString field in the received echo request does not match that in the Downstream Detailed Mapping TLV. (This field is not supported in the current software version.)
Downstream nodes	Prefixes of the downstream BFRs. This field is available only after you specify the -ds keyword.
Incoming Bit String(HEX)	Bit string in the Incoming SI-BitString TLV carried in the BIER OAM Echo reply (in hexadecimal format, with the least significant bit at the rightmost). This field is available only after you specify both the -ds and -ibs keywords.
Timeout Target Bit String(HEX)	Bit string carried in the BIER OAM echo reply (in hexadecimal format, with the least significant bit at the rightmost) that represents unreachable destination nodes and destination nodes for which the request times out. This field is available only after you specify both the -ds and -ibs keywords.
Summary: Path to BFR-ID	Brief information about the path from the current device to the destination node. This field is available only after you specify both the -ds and -ibs keywords. · TTL: Hop count. · Replier: Prefix of the replying BFR. This field is displayed as "--" when TTL is 0. · Time: Time when the response was received, in milliseconds. · Downstream: Prefix address of the downstream BFR.

Related commands

bier ipv6 oam enable

08-BIER Command Reference

BIER OAM commands

bier ipv6 oam enable

ping bier

tracert bier

Cloud & AI

Intelligent Connection

Intelligent Computing

Intelligent Storage

Security

SMB Products

Intelligent Terminal Products

Industry Solutions

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Technical Blogs

Training & Certification

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Partner Business Management

Service Business

Profile

News & Events

Online Exhibition Center

Contact Us