20-Network Management and Monitoring Command Reference

HomeSupportReference GuidesCommand ReferencesH3C WX2800X&WSG1800X Command References(R5605P11)-6W10020-Network Management and Monitoring Command Reference
01-System maintenance and debugging commands
Title Size Download
01-System maintenance and debugging commands 133.50 KB

Ping, tracert, and system debugging commands

debugging

Use debugging to enable debugging for a module.

Use undo debugging to disable debugging for a module or for all modules.

Syntax

debugging module-name [ option ]

undo debugging { all | module-name [ option ] }

Default

Debugging is disabled for all modules.

Views

User view

Predefined user roles

network-admin

Parameters

module-name: Specifies a module by its name, such as arp or device. For a list of supported modules, use the debugging ? command.

option: Specifies the debugging option for a module. Available options vary by module. To display the debugging options supported by a module, use the debugging module-name ? command.

all: Specifies all modules.

Usage guidelines

CAUTION

CAUTION:

Output of excessive debugging messages increases the CPU usage and downgrades the system performance. To guarantee system performance, enable debugging only for modules that are in an exceptional condition.

 

The system sends generated debug messages to the device information center, which then sends the messages to appropriate destinations based on the log output configuration. For more information about the information center, see System Management Configuration Guide.

Examples

# Enable debugging for the device management module.

<Sysname> debugging dev

Related commands

display debugging

display debugging

Use display debugging to display the enabled debugging features for a module or for all modules.

Syntax

display debugging [ module-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

module-name: Specifies a module by its name. For a list of supported modules, use the display debugging ? command. If you do not specify a module name, this command displays the enabled debugging features for all modules.

Examples

# Display all enabled debugging features.

<Sysname> display debugging

DEV debugging switch is on

Related commands

debugging

ping

Use ping to test the reachability of the destination IP address and display ping statistics.

Syntax

ping [ ip ] [ -a source-ip | -c count | -f | -h ttl | -i interface-type interface-number | -m interval | -n | -p pad | -q | -r | -s packet-size | -t timeout | -tos tos | -v  ] * host

Views

Any view

Predefined user roles

network-admin

Parameters

ip: Distinguishes between a destination host name and the ping command keywords if the name of the destination host is i, ip, ipv, ipv6, l, ls, or lsp. For example, you must use the command in the form of ping ip ip instead of ping ip if the destination host name is ip.

-a source-ip: Specifies an IP address of the device as the source IP address of ICMP echo requests. If you do not specify this option, the source IP address of ICMP echo requests is the primary IP address of the outbound interface.

-c count: Specifies the number of ICMP echo requests that are sent to the destination. The value range is 1 to 4294967295, and the default is 5.

-f: Sets the "Don’t Fragment" bit in the IP header.

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

-i interface-type interface-number: Specifies the source interface of ICMP echo requests. If you do not specify this option, the system looks up the routing table or forwarding table for a matching route and uses the output interface of that route as the source interface of ICMP echo requests.

-m interval: Specifies the interval (in milliseconds) to send ICMP echo requests. The value range is 1 to 65535, and the default is 200.

-n: Disables domain name resolution for the host argument. If the host argument represents the host name of the destination, and if this keyword is not specified, the device translates host into an address.

-p pad: Specifies the value of the pad field in an ICMP echo request, in hexadecimal format, 1 to 8 bits. The pad argument is in the range of 0 to ffffffff. If the specified value is less than 8 bits, 0s are added in front of the value to extend it to 8 bits. For example, if pad is configured as 0x2f, then the packets are padded with 0x0000002f to make the total length of the packet meet the requirements of the device. By default, the padded value starts from 0x01 up to 0xff, where another round starts again if necessary, such as 0x010203…feff01….

-q: Displays only the summary statistics. If this keyword is not specified, the system displays all the ping statistics.

-r: Records the addresses of the hops (up to 9) the ICMP echo requests passed. If this keyword is not specified, the addresses of the hops that the ICMP echo requests passed are not recorded.

-s packet-size: Specifies the length (The value range for the packet-size argument varies by device model. in bytes) of ICMP echo requests (excluding the IP packet header and the ICMP packet header). The value range for the packet-size argument is 20 to 8100. The default setting is 56 bytes.

-t timeout: Specifies the timeout time (in milliseconds) of an ICMP echo reply. The value range is 0 to 65535, and the default is 2000. If the source does not receive an ICMP echo reply within the timeout, it considers the ICMP echo reply timed out.

-tos tos: Specifies the ToS value of ICMP echo requests. The value range is 0 to 255, and the default is 0. To use this parameter, enter the complete string -tos. If only part of the parameter is entered, those characters will be treated as the hostname.

-v: Displays non-ICMP echo reply packets. If this keyword is not specified, the system does not display non-ICMP echo reply packets.

host: Specifies the IP address or host name of the destination. The host name is a case-insensitive string of 1 to 253 characters. It can contain letters, digits, and special characters such as hyphen (-), underscore (_), and dot (.).

Usage guidelines

To ping a device identified by its host name, configure the DNS settings on the device first. If the DNS settings are not configured, the ping operation fails.

To abort the ping operation during the execution of the command, press Ctrl+C.

Examples

# Test whether the device with an IP address of 1.1.2.2 is reachable.

<Sysname> ping 1.1.2.2

Ping 1.1.2.2 (1.1.2.2): 56 data bytes, press CTRL+C to break

56 bytes from 1.1.2.2: icmp_seq=0 ttl=254 time=2.137 ms

56 bytes from 1.1.2.2: icmp_seq=1 ttl=254 time=2.051 ms

56 bytes from 1.1.2.2: icmp_seq=2 ttl=254 time=1.996 ms

56 bytes from 1.1.2.2: icmp_seq=3 ttl=254 time=1.963 ms

56 bytes from 1.1.2.2: icmp_seq=4 ttl=254 time=1.991 ms

 

--- Ping statistics for 1.1.2.2 ---

5 packet(s) transmitted, 5 packet(s) received, 0.0% packet loss

round-trip min/avg/max/std-dev = 1.963/2.028/2.137/0.062 ms

# Test whether the device with an IP address of 1.1.2.2 is reachable. Only results are displayed.

<Sysname> ping -q 1.1.2.2

Ping 1.1.2.2 (1.1.2.2): 56 data bytes, press CTRL+C to break

 

--- Ping statistics for 1.1.2.2 ---

5 packet(s) transmitted, 5 packet(s) received, 0.0% packet loss

round-trip min/avg/max/std-dev = 1.962/2.196/2.665/0.244 ms

# Test whether the device with an IP address of 1.1.2.2 is reachable. The IP addresses of the hops that the ICMP packets passed in the path are displayed.

<Sysname> ping -r 1.1.2.2

Ping 1.1.2.2 (1.1.2.2): 56 data bytes, press CTRL+C to break

56 bytes from 1.1.2.2: icmp_seq=0 ttl=254 time=4.685 ms

RR:      1.1.2.1

         1.1.2.2

         1.1.1.2

         1.1.1.1

56 bytes from 1.1.2.2: icmp_seq=1 ttl=254 time=4.834 ms  (same route)

56 bytes from 1.1.2.2: icmp_seq=2 ttl=254 time=4.770 ms  (same route)

56 bytes from 1.1.2.2: icmp_seq=3 ttl=254 time=4.812 ms  (same route)

56 bytes from 1.1.2.2: icmp_seq=4 ttl=254 time=4.704 ms  (same route)

 

--- Ping statistics for 1.1.2.2 ---

5 packet(s) transmitted, 5 packet(s) received, 0.0% packet loss

round-trip min/avg/max/std-dev = 4.685/4.761/4.834/0.058 ms

The output shows the following information:

·     The destination is reachable.

·     The route is 1.1.1.1 <-> {1.1.1.2; 1.1.2.1} <-> 1.1.2.2.

Table 1 Command output

Field

Description

Ping 1.1.2.2 (1.1.2.2): 56 data bytes, press CTRL+C to break

Test whether the device with IP address 1.1.2.2 is reachable. There are 56 bytes in each ICMP echo request.

Press escape key Ctrl+C to abort the ping operation. The escape key is configurable by using the escape-key command. For more information about this command, see login management commands in Fundamentals Command Reference.

56 bytes from 1.1.2.2: icmp_seq=0 ttl=254 time=4.685 ms

Received ICMP echo replies from the device whose IP address is 1.1.2.2. If no echo reply is received within the timeout period, no information is displayed.

·     bytes—Number of bytes in the ICMP echo reply.

·     icmp_seq—Packet sequence, used to determine whether a segment is lost, disordered or repeated.

·     ttl—TTL value in the ICMP echo reply.

·     time—Response time.

RR:

Routers through which the ICMP echo request passed. They are displayed in inversed order, which means the router with a smaller distance to the destination is displayed first.

--- Ping statistics for 1.1.2.2 ---

Statistics on data received and sent in the ping operation.

5 packet(s) transmitted

Number of ICMP echo requests sent.

5 packet(s) received

Number of ICMP echo replies received.

0.0% packet loss

Percentage of unacknowledged packets to the total packets sent.

round-trip min/avg/max/std-dev = 4.685/4.761/4.834/0.058 ms

Minimum/average/maximum/standard deviation response time, in milliseconds.

 

ping ipv6

Use ping ipv6 to test the reachability of the destination IPv6 address and display IPv6 ping statistics.

Syntax

ping ipv6 [ -a source-ipv6 | -c count | -i interface-type interface-number | -m interval | -q | -s packet-size | -t timeout | -tc traffic-class| -v ] * host

Views

Any view

Predefined user roles

network-admin

Parameters

-a source-ipv6: Specifies an IPv6 address of the device as the source IP address of ICMP echo requests. If you do not specify this option, the source IPv6 address of ICMP echo requests is the IPv6 address of the outbound interface. See RFC 3484 for information about the address selection rule.

-c count: Specifies the number of ICMPv6 echo requests that are sent to the destination. The value range is 1 to 4294967295, and the default is 5.

-i interface-type interface-number: Specifies the source interface of ICMPv6 echo requests. If you do not specify this option, the system looks up the routing table or forwarding table for a matching route and uses the output interface of that route as the source interface of ICMPv6 echo requests. You must specify this option if the destination address is a multicast address or a link-local address.

-m interval: Specifies the interval (in milliseconds) to send an ICMPv6 echo reply. The value range is 1 to 65535, and the default is 1000.

-q: Displays only the summary statistics. If you do not specify this keyword, the system displays all the ping statistics.

-s packet-size: Specifies the length (in bytes) of ICMPv6 echo requests (excluding the IPv6 packet header and the ICMPv6 packet header). The value range for the packet-size argument is 20 to 8100. The default setting is 56 bytes.

-t timeout: Specifies the timeout time (in milliseconds) of an ICMPv6 echo reply. The value range is 0 to 65535, and the default is 2000.

-tc traffic-class: Specifies the traffic class value in an ICMPv6 packet. The value range is 0 to 255 and the default is 0.

-v: Displays detailed information (including the dst field and the idx field) about ICMPv6 echo replies. If this keyword is not specified, the system only displays brief information (not including the dst field and the idx field) about ICMPv6 echo replies.

host: Specifies the IPv6 address or host name of the destination. The host name is a case-insensitive string of 1 to 253 characters. It can contain letters, digits, and special characters such as hyphen (-), underscore (_), and dot (.).

Usage guidelines

To ping a device identified by its host name, configure the DNS settings on the device first. If the DNS settings are not configured, the IPv6 ping operation fails.

To abort the IPv6 ping operation during the execution of the command, press Ctrl+C.

Examples

# Test whether the IPv6 address (2001::2) is reachable.

<Sysname> ping ipv6 2001::2

Ping6(56 data bytes) 2001::1 --> 2001::2, press CTRL+C to break

56 bytes from 2001::2, icmp_seq=0 hlim=64 time=62.000 ms

56 bytes from 2001::2, icmp_seq=1 hlim=64 time=23.000 ms

56 bytes from 2001::2, icmp_seq=2 hlim=64 time=20.000 ms

56 bytes from 2001::2, icmp_seq=3 hlim=64 time=4.000 ms

56 bytes from 2001::2, icmp_seq=4 hlim=64 time=16.000 ms

 

--- Ping6 statistics for 2001::2 ---

5 packet(s) transmitted, 5 packet(s) received, 0.0% packet loss

round-trip min/avg/max/std-dev = 4.000/25.000/62.000/20.000 ms

# Test whether the IPv6 address (2001::2) is reachable. Only the statistics are displayed.

<Sysname> ping ipv6 –q 2001::2

Ping6(56 data bytes) 2001::1 --> 2001::2, press CTRL+C to break

 

--- Ping6 statistics for 2001::2 ---

5 packet(s) transmitted, 5 packet(s) received, 0.0% packet loss

round-trip min/avg/max/std-dev = 4.000/25.000/62.000/20.000 ms

# Test whether the IPv6 address (2001::2) is reachable. Detailed ping information is displayed.

<Sysname> ping ipv6 –v 2001::2

Ping6(56 data bytes) 2001::1 --> 2001::2, press CTRL+C to break

56 bytes from 2001::2, icmp_seq=0 hlim=64 dst=2001::1 idx=3 time=62.000 ms

56 bytes from 2001::2, icmp_seq=1 hlim=64 dst=2001::1 idx=3 time=23.000 ms

56 bytes from 2001::2, icmp_seq=2 hlim=64 dst=2001::1 idx=3 time=20.000 ms

56 bytes from 2001::2, icmp_seq=3 hlim=64 dst=2001::1 idx=3 time=4.000 ms

56 bytes from 2001::2, icmp_seq=4 hlim=64 dst=2001::1 idx=3 time=16.000 ms

 

--- Ping6 statistics for 2001::2 ---

5 packet(s) transmitted, 5 packet(s) received, 0.0% packet loss

round-trip min/avg/max/std-dev = 4.000/25.000/62.000/20.000 ms

Table 2 Command output

Field

Description

Ping6(56 data bytes)

2001::1 --> 2001::2, press CTRL+C to break

An ICMPv6 echo reply with a data length of 56 bytes is sent from 2001::1 to 2001::2.

Press escape key Ctrl+C to abort the IPv6 ping operation. The escape key is configurable by using the escape-key command. For more information about this command, see login management commands in Fundamentals Command Reference.

56 bytes from 2001::2,

icmp_seq=1 hlim=64 dst=2001::1 idx=3 time=62.000 ms

Received ICMPv6 echo replies from the device whose IPv6 address is 2001::2.

·     The number of data bytes is 56.

·     The packet sequence is 1.

·     The hop limit value is 64.

·     The destination address is 2001::1. Specify the -v keyword to display this field.

·     The index for the packet inbound interface is 3. Specify the -v keyword to display this field.

·     The response time is 62 milliseconds.

--- Ping6 statistics for 2001::2 ------

Statistics on data received and sent in an IPv6 ping operation.

5 packet(s) transmitted

Number of ICMPv6 echo requests sent.

5 packet(s) received

Number of ICMPv6 echo replies received.

0.0% packet loss

Percentage of unacknowledged packets to the total packets sent.

round-trip min/avg/max/ std-dev =4.000/25.000/62.000/20.000 ms

Minimum/average/maximum/standard deviation response time, in milliseconds.

 

ping tcp

Use ping tcp to test the reachability of the device (as a TCP client) to a TCP server and the TCP connection speed.

Syntax

ping tcp [ -c count | -t timeout | -m interval | -h ttl | -passroute | -a source-ip | -tos tos | -i interface-type interface-number ] * destination [ destination-port ]

Views

Any view

Predefined user roles

network-admin

Parameters

-c count: Specifies the number of attempts to send the TCP SYNC message, in the range of 1 to 4294967295. The default is 5.

-t timeout: Specifies the timeout value (in milliseconds) of a TCP SYNC ACK, in the range 0 to 65535. The default is 2000.

-m interval: Specifies the interval (in milliseconds) to send a TCP SYNC, in the range 1 to 10000. The default is 500.

-h ttl: Specifies the TTL value, in the range of 1 to 255. The default is 30.

-passroute: Enables the device to send packets without searching the routing table. To use this parameter, enter the complete string -passroute. If only part of the parameter is entered, those characters will be treated as the hostname. If you do not specify this keyword, the device searches the routing table before sending packets.

-a source-ip: Specifies an IP address of the device as the source IP address of TCP SYNC packets. The IP address must exist on the device. If this option is not specified, the source IP address of TCP SYNC packets is the primary IP address of the outbound interface.

-tos tos: Specifies the ToS value of TCP SYNC packets, in the range of 0 to 255. The default is 0. To use this parameter, enter the complete string -tos. If only part of the parameter is entered, those characters will be treated as the hostname.

-i interface-type interface-number: Specifies the source interface for TCP SYNC packets. If you do not specify this option, the system uses the primary IP address of the matching route's egress interface as the source interface for TCP SYNC packets.

destination: Specifies a TCP server by ist IPv4 address or hostname. A hostname can be a case-insensitive string of 1 to 253 characters. Valid characters include letters, digits, hyphens (-), underscores (_), and dots (.).

destination-port: Specifies a port number in the range of 1 to 65535. The default port number is 7.

Usage guidelines

Use this command to test the reachability of the device (as a TCP client) to a TCP server, and the TCP connection speed. The test result can be used to check the connectivity, packet loss, and latency of the network.

Examples

# Test the reachability of the TCP server with an IP address of 10.1.1.1 and port number of 3000, and the TCP connection speed.

<Sysname> ping tcp 10.1.1.1 3000

Ping TCP 10.1.1.1: 3000, press CTRL+C to break

Reply from 10.1.1.1: Sequence=1 time=3 ms

Reply from 10.1.1.1: Sequence=2 time=3 ms

Reply from 10.1.1.1: Sequence=3 time=3 ms

Reply from 10.1.1.1: Sequence=4 time=3 ms

Reply from 10.1.1.1: Sequence=5 time=4 ms

 

--- Ping statistics for 10.1.1.1 ---

5 packet(s) transmitted, 5 packet(s) received, 0.0% packet loss

round-trip min/avg/max/std-dev = 1.963/2.028/2.137/0.062 ms

Table 3 Command output

Field

Description

PING TCP 10.1.1.1: 3000, press CTRL+C to break

IP address and port number for the destination host of the ping TCP operation. If you configure the ping command without specifying a destination port number, this field displays the default destination port number 7. To stop the ping operation, press Ctrl+C. You can change the escape key by using the escape-key command. For more information about the escape-key command, see Fundamentals Command Reference.

Reply from 10.1.1.1: Sequence=1 time=3 ms

Received TCP SYNC ACK packets from the device at 10.1.1.1.

·     Sequence—Sequence number of the packet, used to determine whether the packet is lost, out of order, or duplicated.

·     time—Response time, from the time when a TCP SYNC packet was sent to the time when a TCP SYNC ACK packet was received.

·     If no TCP SYNC ACK packet is received before the timeout timer expires, Request time out is displayed.

Ping statistics for 10.1.1.1

Statistics on data received and sent in a TCP ping operation.

·     packet(s) transmitted—Number of TCP SYNC packet sent.

·     packet(s) received—Number of TCP SYNC ACK packets received.

·     Percentage of unacknowledged packets to the total packets sent.

·     Minimum/average/maximum/standard deviation response time, in milliseconds.

 

tracert

Use tracert to trace the path that the IPv4 packets traverse from source to destination.

Syntax

tracert [ -a source-ip | -f first-ttl | -i interface-type interface-number | -m max-ttl | -p port | -q packet-number | -s packet-size | -t tos | -w timeout ] * host

Views

Any view

Predefined user roles

network-admin

Parameters

-a source-ip: Specifies an IP address of the device as the source IP address of probe packets. If you do not specify this option, the source IP address of probe packets is the primary IP address of the outbound interface.

-f first-ttl: Specifies the TTL of the first packet sent to the destination. The value range is 1 to 255, and the default is 1. It must be no greater than the value of the max-ttl argument.

-i interface-type interface-number: Specifies the source interface of probe packets. If you do not specify this option, the system looks up the routing table or forwarding table for a matching route and uses the output interface of that route as the source interface of probe packets.

-m max-ttl: Specifies the maximum number of hops allowed for a probe packet. The value range is 1 to 255, and the default is 30. It must be no smaller than the value of the first-ttl argument.

-p port: Specifies an invalid UDP port of the destination. The value range is 1 to 65535, and the default is 33434.

-q packet-number: Specifies the number of probe packets to send per hop. The value range is 1 to 65535, and the default is 3.

-s packet-size: Specifies the payload length of a probe packet. The value is in the range of 12 to 9600, in bytes. The default is 12.

-t tos: Specifies the ToS value of probe packets. The value range is 0 to 255, and the default is 0.

-w timeout: Specifies the timeout time in milliseconds of the reply packet for a probe packet. The value range is 1 to 65535, and the default is 5000.

host: Specifies the IP address or host name of the destination. The host name is a case-insensitive string of 1 to 253 characters. It can contain letters, digits, and special characters such as hyphen (-), underscore (_), and dot (.).

Usage guidelines

After identifying network failure with the ping command, use the tracert command to locate failed nodes.

The output from the tracert command includes IP addresses of all the Layer 3 devices that the packets traverse from source to destination. Asterisks (* * *) are displayed if the device cannot reply with an ICMP error message. The reason might be the destination is unreachable or sending ICMP timeout/destination unreachable packets is disabled.

Before starting a tracert operation, you must enable sending of ICMP destination unreachable messages on the intermediate devices between the source and destination. The tracert operation stops if any of the following ICMP destination unreachable messages is received:

·     !N—Network unreachable.

·     !H—Destination host unreachable.

·     !P—Protocol unreachable. The protocol number is unknown.

·     !F—Fragmentation needed. This message indicates that packet fragmentation is needed but the "Don’t Fragment" bit is set on an immediate device.

·     !W—Destination host unknown.

·     !Q—Network unreachable for ToS.

·     !T—Host unreachable for ToS.

·     !X—Communication administratively prohibited by filtering policies.

·     !V—Host precedence violation.

·     !C—Precedence cutoff in effect.

To abort the tracert operation during the execution of the command, press Ctrl+C.

Examples

# Display the path that the packets traverse from source to destination (1.1.2.2).

<Sysname> tracert 1.1.2.2

traceroute to 1.1.2.2 (1.1.2.2), 30 hops at most, 40 bytes each packet, press CTRL+C to break

 1  1.1.1.2 (1.1.1.2) 673 ms 425 ms 30 ms

 2  1.1.2.2 (1.1.2.2) [AS 100] 580 ms 470 ms 80 ms

Table 4 Command output

Field

Description

traceroute to 1.1.2.2 (1.1.2.2)

Display the route that the IP packets traverse from the current device to the device whose IP address is 1.1.2.2.

hops at most

Maximum number of hops of the probe packets, which can be set by the -m keyword.

bytes each packet

Number of bytes of a probe packet.

press CTRL+C to break

During the execution of the command, press escape key Ctrl+C to abort the tracert operation. The escape key is configurable by using the escape-key command. For more information about this command, see login management commands in Fundamentals Command Reference.

2  1.1.2.2 (1.1.2.2) [AS 100] 580 ms 470 ms 80 ms

Probe result of the probe packets that contain a TTL value of 2, including the following information about the second hop:

·     Domain name of the hop. If no domain name is configured, the IP address is displayed as the domain name.

·     IP address of the hop. The IP address is displayed in parentheses.

·     Number of the AS that the hop belongs to. The AS number appears only when it is found for the hop in the specified routing table.

·     The round-trip time of the probe packets.

The number of packets that can be sent in each probe can be set by using the -q keyword.

 

tracert ipv6

Use tracert ipv6 to display the path that the IPv6 packets traverse from source to destination.

Syntax

tracert ipv6 [ -a source-ipv6 | -f first-hop | -i interface-type interface-number | -m max-hops | -p port | -q packet-number | -s packet-size | -t traffic-class | -w timeout ] * host

Views

Any view

Predefined user roles

network-admin

Parameters

-a source-ipv6: Specifies a valid IPv6 address on the device as the source IPv6 address of the probe packets. If you do not specify a source IPv6 address, the source IPv6 address of the probe packets is the IPv6 address of the outbound interface. For information about the address selection rule, see RFC 3484.

-f first-hop: Specifies the TTL value of the first packet. The value range is 1 to 255, and the default is 1. The value must be no greater than the value of the max-hops argument.

-i interface-type interface-number: Specifies the source interface of probe packets. If you do not specify this option, the system looks up the routing table or forwarding table for a matching route and uses the output interface of that route as the source interface of probe packets. You must specify this option if the destination address is a multicast address or a link-local address.

-m max-hops: Specifies the maximum number of hops allowed for a packet. The value range is 1 to 255, and the default is 30. The value must be no smaller than the value of the first-hop argument.

-p port: Specifies an invalid UDP port of the destination. The value range is 1 to 65535, and the default is 33434.

-q packet-number: Specifies the number of probe packets sent each time. The value range is 1 to 65535, and the default is 3.

-s packet-size: Specifies the payload length of an IPv6 probe packet. The value is in the range of 12 to 9600, in bytes. The default is 12.

-t traffic-class: Specifies the traffic class value in an IPv6 probe packet. The value range is 0 to 255, and the default is 0.

-w timeout: Specifies the timeout time (in milliseconds) of the reply packet of a probe packet. The value range is 1 to 65535, and the default is 5000.

host: Specifies the IPv6 address or host name of the destination. The host name is a case-insensitive string of 1 to 253 characters. It can contain letters, digits, and special characters such as hyphen (-), underscore (_), and dot (.).

Usage guidelines

After identifying network failure with the ping ipv6 command, you can use the tracert ipv6 command to locate failed nodes.

The output from the tracert ipv6 command includes IPv6 addresses of all the Layer 3 devices that the packets traverse from source to destination. Asterisks (* * *) are displayed if the device cannot reply with an ICMP error message. The reason might be the destination is unreachable or sending ICMP timeout/destination unreachable packets is disabled.

Before starting an IPv6 tracert operation, you must enable sending of ICMPv6 destination unreachable messages on the intermediate devices between the source and destination. The IPv6 tracert operation stops if any of the following ICMPv6 destination unreachable messages is received:

·     !N—No route to destination.

·     !P—Communication with destination administratively prohibited by filtering policies.

·     !A—Address unreachable. The unreachable reason is unknown.

·     !S—Beyond scope of source address. This message is displayed if the probe packet has a link-local source address and a non-link-local destination address. Such a packet cannot be delivered to the destination without leaving the scope of the source address.

To abort the tracert operation during the execution of the command, press Ctrl+C.

Examples

# Display the path that the packets traverse from source to destination (2001:3::2).

<Sysname> tracert ipv6 2001:3::2

traceroute to 2001:3::2(2001:3::2), 30 hops at most, 60 byte packets, press CTRL+C to break

 1  2001:1::2  0.661 ms  0.618 ms  0.579 ms

 2  2001:2::2 [AS 100]  0.861 ms  0.718 ms  0.679 ms

 3  2001:3::2 [AS 200]  0.822 ms  0.731 ms  0.708 ms

Table 5 Command output

Field

Description

traceroute to 2001:3::2

Display the route that the IPv6 packets traverse from the current device to the device whose IP address is 2001:3:2.

hops at most

Maximum number of hops of the probe packets, which can be set by the -m keyword.

byte packets

Number of bytes of a probe packet.

press CTRL+C to break

During the execution of the command, press escape key Ctrl+C to abort the IPv6 tracert operation. The escape key is configurable by using the escape-key command. For more information about this command, see login management commands in Fundamentals Command Reference.

2  2001:2::2 [AS 100]  0.861 ms  0.718 ms  0.679 ms

Probe result of the probe packets that contain a hoplimit value of 2, including the following information about the second hop:

·     IPv6 address of the hop.

·     Number of the AS the hop belongs to. The AS number appears only when it is found for the hop in the specified routing table.

·     The round-trip time of the probe packets.

The number of packets that can be sent in each probe can be set by using the -q keyword.

 

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Intelligent Storage
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
  • Technical Blogs
All Support
  • Become A Partner
  • Partner Policy & Program
  • Global Learning
  • Partner Sales Resources
  • Partner Business Management
  • Service Business
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网