Contents

BIER OAM commands· 1

g-bier oam enable· 1

ping bier g-bier 1

tracert bier g-bier 4

 

BIER OAM commands

g-bier oam enable

Use g-bier oam enable to enable G-BIER OAM.

Use undo g-bier oam enable to disable G-BIER OAM.

Syntax

g-bier oam enable [ udp-port udp-port ]

undo g-bier oam enable

Default

G-BIER OAM is enabled.

Views

BIER view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

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

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

Examples

# Disable G-BIER OAM.

<Sysname> system-view

[Sysname] bier

[Sysname-bier] undo g-bier oam enable

ping bier g-bier

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

Syntax

ping bier g-bier 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

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 G-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 G-BIER echo requests. The value range is 1 to 255, and the default is 255.

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

-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.

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

Usage guidelines

Before using this command, make sure G-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 G-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 its reachability.

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

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

BFR-ID: 22 Request timed out

BFR-ID: 22 Request timed out

BFR-ID: 22 Request timed out

BFR-ID: 22 Request timed out

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 its reachability.

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

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

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

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

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

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

64 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.000/10.000 ms

# Ping BFRs 1 through 4 in BIER sub-domain 0 and specify three echo requests to be sent to each of those BFRs.

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

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

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

64 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

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

64 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

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

64 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) ---

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

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

 

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

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

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

 

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

5 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) ---

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

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

Table 1 Command output

Field	Description
Ping G-BIER: Sub-Domain ID: 0, BSL: 128, BFR-ID: 22, press CTRL_C to break	Test whether BFR 22 in BIER sub-domain 0 with BSL of 128 is reachable. To stop the ping operation, press escape key Ctrl+C.
64 bytes from BFR-ID: 2 (2001:db8:1::1)	Received an echo reply of 64 bytes from BFR 2 whose prefix is 2001:db8:1::1.
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 G-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(1) ---	Statistics on data received and sent in the ping operation.
5 packets transmitted	Number of transmitted G-BIER OAM echo request packets.
5 packets received	Number of received G-BIER OAM echo reply packets.
0.0% packet loss	Percentage of unacknowledged packets to the total packets sent.
Round-trip min/avg/max=4.000/5.000/10.000 ms	Minimum/average/maximum response time, in milliseconds.

 

Related commands

g-bier oam enable

tracert bier g-bier

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

Syntax

tracert bier g-bier 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

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.

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.

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 G-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 G-BIER echo requests.

-h ttl-value: Specifies the TTL value of G-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 G-BIER echo requests. With the I flag set, G-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 G-BIER echo requests.

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

Usage guidelines

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

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

If multiple G-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

# Display the path that a G-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.

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

Traceroute G-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 G-BIER source BFR-Prefix=11::11, Destination BFR-ID=[120,127]	Display the path that a G-BIER packet traverses from the current BFR (11::11) to destination BFRs 120 through 127.
hops at most	Maximum number of hops.
byte packets	Number of bytes of an echo request packet.
press CTRL_C to break	To stop the tracert operation after the command is used, press Ctrl+C.
Entropy	Entropy value used for select a path from multiple ECMP paths.
TTL	TTL value.
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 G-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.
Original Bit String(HEX)	Bit string in the Original SI-BitString TLV carried in the G-BIER OAM echo request (in hexadecimal format, with the least significant bit at the rightmost)
Target Bit String(HEX)	Bit string in the Target SI-BitString TLV carried in the G-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.
Incoming Bit String(HEX)	Bit string in the Incoming SI-BitString TLV carried in the G-BIER OAM Echo reply (in hexadecimal format, with the least significant bit at the rightmost). This field is available only after you specify the -ds or -ibs keyword.
Timeout Target Bit String(HEX)	Bit string carried in the G-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 the -ds or -ibs keyword.
Summary	Brief information about the path from the current device to the destination node. This field is available only after you specify the -ds or -ibs keyword.

 

Related commands

g-bier oam enable