Enterprise products and services are set forth in the express warranty statements accompanying such
products and services. Nothing herein should be construed as constituting an additional warranty. Hewlett
Packard Enterprise shall not be liable for technical or editorial errors or omissions contained herein.
Confidential computer software. Valid license from Hewlett Packard Enterprise required for possession, use, or
copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software
Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s
standard commercial license.
Links to third-party websites take you outside the Hewlett Packard Enterprise website. Hewlett Packard
Enterprise has no control over and is not responsible for information outside the Hewlett Packard Enterprise
website.
Acknowledgments
Intel®, Itanium®, Pentium®, Intel Inside®, and the Intel Inside logo are trademarks of Intel Corporation in the
United States and other countries.
Microsoft® and Windows® are trademarks of the Microsoft group of companies.
Adobe® and Acrobat® are trademarks of Adobe Systems Incorporated.
Java and Oracle are registered trademarks of Oracle and/or its affiliates.
UNIX® is a registered trademark of The Open Group.
Contents
Ping, tracert, and system debugging commands ·····································1
NQA server commands ··············································································································· 77
display nqa server ··············································································································· 77
nqa server enable················································································································ 78
nqa server tcp-connect ········································································································· 78
nqa server udp-echo ············································································································ 79
display ip netstream cache ·································································································· 364
display ip netstream export·································································································· 371
display ip netstream template ······························································································ 372
enable ····························································································································· 375
ip netstream ····················································································································· 375
ip netstream filter ··············································································································· 376
ip netstream sampler ········································································································· 377
ip netstream aggregation ···································································································· 377
ip netstream export host ····································································································· 379
ip netstream export rate ······································································································ 380
ip netstream export source ·································································································· 381
vi
ip netstream export v9-template refresh-rate packet ································································· 382
ip netstream export v9-template refresh-rate time ···································································· 382
ip netstream export version ································································································· 383
ip netstream max-entry ······································································································· 384
ip netstream mpls ·············································································································· 385
ip netstream timeout active·································································································· 385
ip netstream timeout inactive ······························································································· 386
reset ip netstream statistics ································································································· 387
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. T o display the
debugging options supported by a module, use the debugging module-name ? command.
Usage guidelines
Output from debugging commands is memory intensive. To guarantee system performance, enable
debugging only for modules that are in an exceptional condition.
The system sends the debugging comm and output as debug m essages to the device i nformation
center. The information center then sends the m essages to appropri ate destinations based o n the
log output configuration. For more information about configuring debug message output, see
Network Management and Mon itori ng Conf ig ur ati on Guid e.
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 ]
1
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
module-name: S pecifies a module b y its name. For a list of suppor ted modules, use the display
debugging ? command. If you do not spec ify a module name, this comm and displays the enab led
debugging features for all modules.
Examples
# Display all enabled debugging features.
<Sysname> disp lay debugging
DEV debugging switch is on
Related commands
debugging
ping
Use ping to test the reachability of the destination IP address and disp lay ping statistics.
ip: Distinguishes between a destination host name and the ping command keywords if the name of
the destination host is i, ip, ipv, or ipv6. 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 this option is not specified, the source IP address of ICMP echo requests is the primary IP address
of the outbound interface.
-ccount: Specifies the number of ICMP echo req uests that are sent to the destination. The value
range is 1 to 4294967295, and the default is 5.
-f: Sets the "do-not-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.
-iinterface-type in ter fac e -number: Specifies t he s o urc e i nterface for ICMP echo reques ts. 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 ICMP echo requests.
-minterval: Specifies the interval (in milliseconds) to send ICMP echo requests. The value range is 1
to 65535, and the default is 200.
2
-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.
-ppad: Specifies the v alue of the pad field in an ICMP echo request, in hexa deci m al format , 1 to 8
bits. The pad argum ent is in th e ran ge of 0 to ffffffff. If the specified valu e is les s t han 8 b its, 0s are
added in front of t he valu e to ex tend it to 8 bits . For exam ple, if pad is conf igure d 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, t he padded value starts from 0x01 up to 0xff, where another round starts
again if necessary, such as 0x010203…feff01….
-q: Displays only the summ ar y statistics. If this keyword is not specified , the system displa ys all t he
ping statistics.
-r: Records the a ddresses 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 (in bytes) of ICMP echo requests (excluding the IP packet
header and the ICMP packet header). The value range is 20 to 8100, and the default is 56.
-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.
-tostos: Specifies the ToS value of ICMP echo requests. The value range is 0 to 255, and the default
is 0.
-v: Displays n on-ICMP echo reply packets. If this keyword is not specified, the system does not
display non-ICMP echo reply packets .
-topologytopo-name: Specifies the topolog y to which the des tin ation bel on gs , wher e topo-name is
a case-sensitive string of 1 to 31 characters. If the destination is on the public network, do not specify
this option.
-vpn-instance vpn-instance-name: Spec ifies the MPLS L3VPN instance to which th e destination
belongs, where the vpn-instance-name argum ent is a case-s ensitive string of 1 to 31 charac ters. If
the destination is on the public network, do not specify this option.
host: Specifies the IP addres s or hos t name of the destination. The hos t 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
T o 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 byt es, 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
3
# Test whether the device with an IP address of 1.1.2.2 in VPN 1 is reachable.
•
•
Field
Description
(1.1.2.2): 56 data
<Sysname> ping -vpn-instance vpn1 1.1.2.2
Ping 1.1.2.2 (1 .1.2.2): 56 data byt es, 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 in VPN instance vpn1 --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 byt es, 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.6 65/0.244 ms
# Test whether the devic e with an IP addres s of 1.1.2.2 is reachable. The IP address es of t he h ops
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 byt es, 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 that:
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
Ping 1.1.2.2
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
Ctrl+C
to abort the
ping operation.
4
Field
Description
Received ICMP echo replies
from the device whose IP address is
, used to determine whether a
displayed in inversed order, which means the router with a smaller
dev =
tandard deviation response time, in
1.1.2.2. If no echo reply is received within the timeout period, no
information is displayed.
56 bytes from 1.1.2.2: icmp_ se q=0
ttl=254 time=4.685 ms
RR:
--- Ping statistics for 1.1.2.2 --- Statistics on data received and sent in the ping operation.
• bytes—Number of bytes in the ICMP echo reply.
• icmp_seq—Packet sequence
segment is lost, disordered or repeated.
• ttl—TTL value in the ICMP echo reply.
• time—Response time.
Routers through which the ICMP echo request passed. They are
distance to the destination is displayed first.
--- Ping statistics for 1.1.2.2 in VPN
instance vpn1 ---
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-
4.685/4.761/4.834/0.058 ms
ping ipv6
Use ping ipv6 to test the reachability of the destination IPv6 address and display IPv6 ping statistics.
-a source-ipv6: Specifies an IPv6 addres s of the device as the source I P address of ICMP echo
requests. If this opt ion is n ot specif ied, th e sour ce IP v6 ad dress of ICMP ech o reques ts is t he I Pv6
address of the outbound interface. See RFC 3484 for information about the address selection rule.
-ccount: 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 f or ICMPv6 echo requests. This
option must be specified when the destination address is a multicast address or a link local address.
If you do not specif y this option, the system uses the primary IP address of the m atching route's
egress interface as the source interface for ICMPv6 echo requests.
-minterval: 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 s umm ar y statistics. If you do not specif y this k e yword, the s ys tem displays all
the ping statistics.
5
-s packet-size: Specifies the length (in b yt es) of ICMPv6 echo re quests (excluding the IP v6 pac ket
header and the ICMPv6 packet header). The value range is 20 to 8100, and the default is 56.
-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 t he traffic class val ue in an IC MPv6 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 k eyword is n ot specif ied, the s ystem only displays brief inform ation ( not includ ing the
dst field and the idx field) about ICMPv6 echo replies.
-vpn-instance vpn-instance-name: Spec ifies the MPLS L3VPN instance to which th e destination
belongs, where the vpn-instance-name argum ent is a case-s ensitive string of 1 to 31 charac ters. If
the destination is on the public network, do not specify this option.
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 le tters, digits, and special characters
such as hyphen (-), underscore (_), and dot (.).
Usage guidelines
T o 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 ipv6 operation fails.
To abort the ping ipv6 operation during the execution of the command, press Ctrl+C.
Examples
# Test whether the IPv6 address (2001::2) is reachable.
<Sysname> pi ng ipv6 2001::2
Ping6(56 data bytes) 2001::1 --> 2001::2, press CTRL_C to break
56 bytes from 2001::2, icmp_se q=0 hlim=64 time=62 .000 ms
56 bytes from 2001::2, icmp_se q=1 hlim=64 time=23 .000 ms
56 bytes from 2001::2, icmp_se q=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_se q=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 ip v6 –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 ip v6 –v 2001::2
Ping6(56 data bytes) 2001::1 --> 2001::2, press CTRL_C to break
56 bytes from 2001::2, icmp_se q=0 hlim=64 dst=200 1::1 idx=3 time=6 2.000 ms
56 bytes from 2001::2, icm p_seq=1 hlim=64 ds t=2001::1 idx=3 time=23.000 ms
56 bytes from 2001::2, icmp_se q=2 hlim=64 dst=200 1::1 idx=3 time=2 0.000 ms
56 bytes from 2001::2, icmp_se q=3 hlim=64 dst=200 1::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
6
•
•
Field
Description
icmp_seq=1 hlim=64 dst=2001::1
tandard deviation response time, in
--- 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
The output shows that:
The destination is reachable, and ICMPv6 echo requests are replied.The minimum/average/maximum/standard deviation roundtrip time of packets is 4 milliseconds,
25 milliseconds, 62 milliseconds, and 20 milliseconds.
Table 2 Command output
Ping6(56 data bytes)
2001::1 --> 2001::2, press CTRL_C
to break
56 bytes from 2001::2,
idx=3 time=62.000 ms
--- Ping6 statistics for 2001::2 ------ Statistics on data received and sent in an IPv6 p ing oper atio n.
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
An ICMPv6 echo reply with a data length of 56 bytes is sent from
2001::1 to 2001::2.
Ctrl+C
Press
Received ICMPv6 echo replies from the dev ice 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.
Minimum/average/maximum/s
milliseconds.
to abort the ping IPv6 operation.
tracert
Use tracert to trace the path the packets traverse from source to destination.
Syntax
tracert [ -a source-ip | -f first-ttl | -m max-ttl | -p port | -q packet-number | -t tos | { -topology
-a source-ip: Specifies an IP address of the device as the source IP address of probe packets. If this
option is not specified, the source IP address of probe packets is the primary IP address of the
outbound interface.
7
-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.
-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: Spec ifies an invalid UDP port of the des tination. The value range is 1 to 65535, and the
default is 33434. If the destinat ion addres s is a n EID a ddress at a rem ote LISP sit e, spec ify a por t
number in the range of 33434 to 65535.
-qpacket-number: Specifies the num ber of probe packets to send per hop. The valu e range is 1 to
65535, and the default is 3.
-t tos: Specifies the ToS value of probe packets. The value range is 0 to 255, and the default is 0.
-topology topo-name: Specifies the topolog y to which the des tin ation bel on gs , wher e topo-name is
a case-sensitive string of 1 to 31 characters. If the destination is on the public network, do not specify
this option.
-vpn-instance vpn-instance-name: Spec ifies the MPLS L3VPN instance to which th e destination
belongs, where the vpn-instance-name argument is a c ase-sensiti ve st ring of 1 to 31 c haracter s. If
the destination is on the public network, do not specify this option.
-resolve-as: Specifies a routing table for autonomous system (AS) resolution. Tracert searches the
specified routing tabl e f or the A S t hat eac h h op a lo ng the p ath bel on gs to. If you do no t s pec i fy th i s
keyword, the global rout ing tab le is used. If the AS info rmation is found, this command displays the
AS number next to the address of the hop in the probe result.
global: Specifies the global routing table.
none: Disables AS resolution.
vpn: Specifies the VPN routing table.
-w timeout: Specifies th e timeout time in milliseconds of the reply packet for a probe packet. The
value range is 1 to 65535, and the def ault is 5000.
host: Specifies the IP addres s or hos t name of the destination. The hos t 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 netw ork failure with t he ping command, use th e tracert command to locate failed
nodes.
If the destination address is on the public network, you do not need to specify the -resolve-as
keyword to obtain the AS information. The device automatically uses the global routing table for AS
resolution.
If the destination address is on a private network, address information of intermediate hops might be
stored in either the global routing table or t he VPN routing table. To learn the AS path that the
packets traverse, ex ecute the tracert com m and twice, once with t he -resolve-as global keywords
and again with the -resolve-as vpn keywords.
The output from the tracert command includes IP addresses of all the Layer 3 dev ices that the
packets traverse from source to destination. Asterisks (* * *) are displayed if the device cannot reply
with an ICMP error mess age. T he reas on might be the destin ati on is unr eac h ab le or sending ICMP
timeout/destination unreachable packets is disabled.
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
8
1 1.1.1.2 (1.1.1.2) 673 ms 425 ms 30 ms
Field
Description
LS Label=100048 Exp=0
on an MPLS network, carrying MPLS label
Label value that is used to identify a forwarding equivalence
2 1.1.2.2 (1.1.2.2) [AS 100] 580 ms 470 ms 80 ms
# Display the path that the packets traverse from sour ce to destination (1.1.3.2) in VPN ins tance
vpn1, as well as the AS information of the hops along the path.
<Sysname> tr acert –vpn-instanc e vpn1 –resolve-as vpn 1.1.3.2
traceroute to 1.1.3.2 (1.1.3.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) 580 ms 470 ms 80 ms
3 1.1.3.2 (1.1.3.2) [AS 65535] 530 ms 472 ms 380 ms
# Trace the path to destination (192.168.0.46) over an MPLS network.
<Sysname> tracert 192.168.0.46
traceroute to 1 92 .168.0.46(192.168.0.46), 30 hops at most, 40 bytes each packe t, press
CTRL_C to break
1 192.0.2.13 (192 .0.2.13) 0.661 ms 0.61 8 ms 0. 57 9 ms
2 192.0.2.9 (192 .0.2.9) 0.861 ms 0.718 ms 0.679 ms
MPLS Label=100048 Exp=0 TTL=1 S=1
3 192.0.2.5 (192. 0.2.5) 0.822 ms 0.731 ms 0 .70 8 ms
MPLS Label=100016 Exp=0 TTL=1 S=1
4 192.0.2.1 (192. 0.2.1) 0.961 ms 8.676 ms 0 .87 5 ms
Table 3 Command output
traceroute to 1.1.2.2 (1.1.2.2)
hops at most
Display the route that the IP packets tr averse from the curr ent device t o th e
device whose IP address is 1.1.2.2.
Maximum number of hops of th e probe packet s, 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
operation.
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.
2 1.1.2.2 (1.1.2.2) [AS 100]
580 ms 470 ms 80 ms
• IP address of the hop. The IP addr e ss is dis play ed in pare nt hese s.
• 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
-q
the
keyword.
ICMP timeout packets
information:
•Label—
MP
TTL=1 S=1
class (FEC).
• Exp—Reserved, usually used for class of service (CoS).
• TTL—TTL value.
• S—MPLS supports multiple le v els of la bel s. Value 1 indicates that the
label is at t he bo t tom of th e l abe l s t ac k, and va l u e 0 i ndic a t es th at t he
label is in another label stack.
Ctrl+C
to abort the tracert
9
tracert ipv6
•
•
•
Use tracert ipv6 to display the path that the IPv6 packets traverse from source to destination.
-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.
-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: Spec ifies an invalid UDP port of the des tination. The value range is 1 to 65535, and the
default is 33434.
-qpacket-number: Specifies the num ber of probe pac kets s ent each time. T he value range is 1 to
65535, and the default is 3.
-ttraffic-class: Specifies the traffic class value in an IPv6 probe packet. The value range is 0 to 255,
and the default is 0.
-vpn-instancevpn-instance-name: Spec ifies the MPLS L3VPN instance t o which the destination
belongs, where the vpn-instance-name argument is a c ase-sensiti ve st ring of 1 to 31 c haracter s. If
the destination is on the public network, do not specify this option.
-resolve-as: Specifies a routing table for AS resolution. Tracert searches the specified routing table
for the AS that each hop a long the path belongs to . If you do not specif y this keyword, the glob al
routing table is used. If t he AS infor mation is f ound, this command dis plays the A S number nex t to
the address of the hop in the probe result.
global: Specifies the global routing table.
none: Disables AS resolution.
vpn: Specifies the VPN routing table.
-w timeout: Specifies the ti meout time (in milliseconds) of the reply packet of a probe packet. T he
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 le tters, 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.
If the destination address is on the public network, you do not need to specify the -resolve-as
keyword to obtain the AS information. The device automatically uses the global routing table for AS
resolution.
If the destination address is on a private network, address information of intermediate hops might be
stored in either the global routing table or t he VPN routing table. To learn the AS path that the
packets traverse, execute the tracertipv6 command twice, once with the -resolve-as global
keywords and again with the -resolve-as vpn keywords.
10
The output from the tracertipv6 command includes IP v6 address es of all the La yer 3 de vices that
Field
Description
Number of the AS the hop belongs to. The AS number appears
the packets traverse from source to destina tion. Aster isks (* * *) are displa yed if the d evice ca nnot
reply with an ICMP error message. T he reason might be the des tination is unr eachabl e or sending
ICMP timeout/destination unreachable packets is disabled.
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> tr acert 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.61 8 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.73 1 ms 0.708 ms
# Display the path that the packets traverse fr om source to dest ination (2001:3::2) in VPN instanc e
vpn1, as well as the AS information of the hops along the path.
<Sysname> tr acert ipv6 –vpn-instance vpn1 –resolve-as vp n 2001:3::2
traceroute to 20 01: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 0.86 1 ms 0.718 ms 0.679 ms
3 2001:3::2 [AS 6553 5] 0.822 ms 0.731 ms 0.7 08 ms
Table 4 Command output
traceroute to 2001:3::2
hops at most
byte packets Number of bytes of a probe packet.
2 2001:2::2 [AS 100] 0.861 ms
0.718 ms 0.679 ms
Display the route that the IPv6 packets traverse from th e curr ent dev ice
to the device whose IP address is 2001:3:2.
Maximum number of hops of t he probe pa ckets, which can be set by the
-m
keyword.
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.
•
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.
11
NQA commands
NQA client commands
advantage-factor
Use advantage-factor to set the advantage f actor to be used for calculating Mean Opinion Scores
(MOS) and Calculated Planning Impairment Factor (ICPIF) values.
Use undo advantage-factor to restore the default.
Syntax
advantage-factor factor
undo advantage-factor
Default
The advantage factor is 0.
Views
Voice operation view
Predefined user roles
network-admin
Parameters
factor: Specifies the advantage factor in the range of 0 to 20.
Usage guidelines
The evaluat ion of voice quality depends on users ' tolerance for voice qua lity. For users with higher
tolerance for voice quali ty, use the advantage-factor command to set an advant age factor. When
the system calculat es the ICPIF value, it subtracts the ad vantage f actor to m odif y ICPIF a nd MO S
values for voice quality evaluation.
Examples
# Set the advantage factor to 10 for the voice operation.
<Sysname> sy stem-view
[Sysname] nq a entry admin test
[Sysname-nqa-admin-test] type voice
[Sysname-nqa-admin-test-voice] ad vantage-factor 10
codec-type
Use codec-type to configure the codec type for the voice operation.
string: Specifies a case-sensitive string of 1 to 200 characters.
Usage guidelines
If the payload length is smaller than the string len gth, only the first part of the str ing is filled. For
example, if you configure the string as abcd and set the payload size to 3 bytes, abc is filled.
If the payload leng th is greater than the str ing length, the s ystem fills the payload with th e string
cyclicall y until the p ayload is full. For example, if you conf igure the st ring as abcd and the pa yload
size as 6 bytes, abcdab is filled.
How the string is filled depends on the operation type.
For the ICMP echo operation, the string fills the whole payload of an ICMP echo request. For the UDP echo operation, the first five bytes of the payload of a UDP packet are for special
purpose. The string fills the remaining part of payload.
13
•
•
•
Operation type
Codec type
Default size (bytes)
For the UDP jitter operation, the first 68 bytes of the payload of a UDP packet are for special
purpose. The string fills the remaining part of the payload.
For the voice operation, the first 16 bytes of the payload of a UDP packet are for special
purpose. The string fills the remaining part of the payload.
For the path jitter operation, the first four bytes of the payload of an ICMP echo request are for
special purpose. The string fills the remaining part of payload.
Examples
# Specify abcd as the payload fill string for ICMP echo requests.
<Sysname> system-view
[Sysname] nq a entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-ec ho ] data-fill abcd
data-size
Use data-size to set the payload size for each probe packet.
Use undo data-size to restore the default.
Syntax
data-size size
Default
Views
undo data-size
The default payload size of a probe packet for different operations is described in Table 5.
size: Specifies the payload size. Available value ranges include:
20 to 65507 bytes for the ICMP echo, UDP echo, or UDP tracert operation. 68 to 65507 bytes for the UDP jitter or path jitter operation. 16 to 65507 bytes for the voice operation.
Usage guidelines
In ICMP echo and path jitter operations, the com mand sets the payload s ize for each ICMP echo
request.
In UDP echo, UDP jitter, UDP tracert, and voice operations , t he c om mand sets the payload s ize f or
each UDP packet.
Examples
# Set the payload size to 80 bytes for each ICMP echo request.
<Sysname> system-view
[Sysname] nq a entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-ec ho ] data-size 80
description
Use description to configure a description for an NQA operation, such as the operation type or
purpose.
Use undo description to restore the default.
Syntax
description text
undo description
Default
No description is configured for an NQA operation.
Views
DHCP/DLSw/DNS/FTP/HTTP/SNMP/TCP/voice operation view
ICMP/UDP echo operatio n vie w
ICMP/path/UDP jitter operation view
UDP tracert operation view
Predefined user roles
network-admin
Parameters
text: Specifies a description, a case-sensitive string of 1 to 200 characters.
Examples
# Configure the description as icmp-probe for the ICMP echo operation.
<Sysname> system-view
[Sysname] nq a entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-ec ho ] description icmp-probe
15
destination ip
Use destination ip to configure the destination IPv4 address for the operation.
Use undo destination ip to restore the default.
Syntax
destination ip ip-address
undo destination ip
Default
No destination IPv4 address is configured for an operation.
ip-address: Specifies the destination IPv4 address for the operation.
Examples
# Specify 10.1.1.1 as the destination IPv4 address for the ICMP echo operation.
<Sysname> system-view
[Sysname] nq a entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-ec ho ] destination ip 10.1.1.1
destination ipv6
Use destination ipv6 to configure the destination IPv6 address for the operation.
Use undo destination ipv6 to restore the default.
No destination IPv6 address is configured for an operation.
Views
ICMP echo operation view
Predefined user roles
network-admin
Parameters
ipv6-address: Specifies the destination IPv6 address for the operation. IPv6 link-local addresses are
not supported.
16
Examples
# In ICMP echo operation view , specify 1::1 as the destination IPv6 address for ICMP echo requests.
<Sysname> system-view
[Sysname] nq a entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-ec ho ] destination ipv6 1::1
destination por t
Use destination port to configure the destination port number for the operation.
Use undo destination port to restore the default.
Syntax
destination port port-number
undo destination port
Default
The destination port number is 33434 for the UDP tracert operation.
No destination port number is configured for other types of operations.
Views
TCP/voice operation view
UDP echo operation view
UDP jitter operat ion vie w
UDP tracert operation view
Predefined user roles
network-admin
Parameters
port-number: Specifies the destination port number for the operation, in the range of 1 to 65535.
Examples
# Set the destination port number to 9000 for the UDP ec ho operation.
<Sysname> system-view
[Sysname] nq a entry admin test
[Sysname-nqa-admin-test] type udp-echo
[Sysname-nqa-admin-test-udp-echo] destination port 900 0
display nqa hist ory
Use display nqa history to display the history records of NQA operations.
Syntax
display nqa history [ admin-nameoperation-tag ]
Views
Any view
Predefined user roles
network-admin
17
•
•
•
•
network-operator
Parameters
admin-name operation-tag: Specifies an NQA operation by its administrator name and operation tag.
The admin-name argument represents the name of the administrator who creates the NQA
operation. The operation-tag argum ent represents the operation ta g. Each of the arguments is a
case-insensitive string of 1 to 32 characters that cannot contain hyphens (-). If you do not specify an
NQA operation, the command displays the history records of all NQA operations.
Usage guidelines
The display nqa history command does not display the results or statistics of the following
operations:
ICMP jitter.
Path jitter.
UDP jitter.
Voice.
T o v iew the results or statistics of the ICMP jitter, path jitter, UDP jitter, and voice operations, use the
display nqa result or display nqa statistics command.
Examples
# Display the histor y records of the UDP tracert oper ation with adminis trator name administrator
and operation tag tracert.
<Sysname> display nqa history administrator tracert
NQA entry (adm in administrator, tag tracert) history records:
Index TTL Response Hop IP Status Time
1 2 328 4.1.1.1 Succeeded 2013-09-09 14:46:06.2
1 2 328 4.1.1.1 Succeeded 2013-09-09 14:46:05.2
1 2 328 4.1.1.1 Succeeded 2013-09-09 14:46:04.2
1 1 328 3.1.1.2 Succeeded 2013-09-09 14:46:03.2
1 1 328 3.1.1.1 Succeeded 2013-09-09 14:46:02.2
1 1 328 3.1.1.1 Succeeded 2013-09-09 14:46:01.2
# Display the history records of the NQA operation with administrator name administrator and
operation tag test.
<Sysname> display nqa history administrator test
NQA entry (admin administrator, tag test) history records:
Index Response Status Time
10 329 Succeeded 2011-04-29 20:54:26.5
9 344 Succeeded 2011-04-29 20:54:26.2
8 328 Succeeded 2011-04-29 20:54:25.8
7 328 Succeeded 2011-04-29 20:54:25.5
6 328 Succeeded 2011-04-29 20:54:25.1
5 328 Succeeded 2011-04-29 20:54:24.8
4 328 Succeeded 2011-04-29 20:54:24.5
3 328 Succeeded 2011-04-29 20:54:24.1
2 328 Succeeded 2011-04-29 20:54:23.8
1 328 Succeeded 2011-04-29 20:54:23.4
18
•
•
Table 6 Command output
Field Description
Index
TTL TTL value in the probe packet.
Response
Hop IP IP address of the node that sent the reply packet.
Status
Time Time when the operation was completed.
History record ID.
The history records in one UDP tracert operation have the same ID.
Round-trip time if the operation succeeds, timeout time upon timeout, or 0 if the
operation cannot be complete d, in milliseconds.
Status of the operation result:
• Succeeded.
• Unknown error.
• Internal error.
• Timeout.
display nqa reaction counters
Use display nqa reaction counters to display the current monitoring results of reaction entries.
admin-name operation-tag: Specifies an NQA operation by its administrator name and operation tag.
The admin-name argument represents the name of the administrator who creates the NQA
operation. The operation-tag argum ent represents the operation ta g. Each of the arguments is a
case-insensitive string of 1 to 32 characters that cannot contain hyphens (-). If you do not specify an
NQA operation, the command displ a ys t he c urr ent monitoring results of reac t ion entries f or a ll NQA
operations.
item-number: Specif ies a reaction entry by its ID in the range of 1 to 10. If you do not spec ify a
reaction entry, the command displays the results of all reaction entries.
Usage guidelines
The result fields display hyphens (-) in one of the following conditions:
The threshold type is the average value. The monitored performance metric is ICPIF or MOS of the voice operation.
The monitoring res ults of an operation are accum ulated, and are not cleared a fter the operation
completes.
Examples
# Display the monitoring results of all reaction entries of the ICMP echo operation with administrator
name admin and operation tag test.
19
Field
Description
been monitored for data
metric
robes after the
umber of
Number of probes with
duration exceeding the
robes after the
umber of
Number of probes with
duration exceeding the
robes after the
umber of
robes after the
umber of
ackets sent
after the
Number of sent
Number of packets with
ackets sent
after the
Number of sent
Number of packets with
way jitter
ackets sent
after the
Number of sent
way delay
ackets sent
after the
Number of sent
<Sysname> di splay nqa reaction counters admin tes t
NQA entry (adm in admin, tag test) reaction counters:
Index Checked Element Threshold Type Checked Num Over-threshold Num
1 probe-duration accumulate 12 4
2 probe-duration average - 3 probe-duration consecutive 160 56
4 probe-fail accumulate 12 0
5 probe-fail consecutive 162 2
Table 7 Command output
Index ID of a reaction entry.
Checked Element Monitored performance metric.
Threshold Type Threshold type.
Checked Num
Over-threshold Num Number of threshold violations.
Number of targets that have
collection.
Table 8 Description of the threshold monitoring fields
Monitored
performance
probe-duration
probe-fail
RTT
Threshold
type
accumulate
average N/A N/A N/A
consecutive
accumulate
consecutive
accumulate
Collect data in Checked Num Over-threshold Num
P
operation starts.
P
operation starts.
P
operation starts.
P
operation starts.
P
operation starts.
N
completed probes.
N
completed probes.
N
completed probes.
N
completed probes.
packets.
threshold.
threshold.
Number of probe failures.
Number of probe failures.
round-trip time exceeding
threshold.
jitter-DS/jitter-SD
OWD-DS/OWD-SD N/A
packet-loss accumulate
average N/A N/A N/A
accumulate
average N/A N/A N/A
P
operation starts.
P
operation starts.
P
operation starts.
20
packets.
packets.
packets.
the oneexceeding the threshold.
Number of packets with
the oneexceeding the threshold.
Total packet loss.
Loading...
+ 445 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.