H3C SR6600 Routers. Network Management and Monitoring. Command Reference. Hangzhou H3C Technologies Co., Ltd.

Transcription

1 H3C SR6600 Routers Network Management and Monitoring Command Reference Hangzhou H3C Technologies Co., Ltd. Document Version: C-1.08 Product Version: SR6600-CMW520-R2420

2 Copyright , Hangzhou H3C Technologies Co., Ltd. and its licensors All Rights Reserved No part of this manual may be reproduced or transmitted in any form or by any means without prior written consent of Hangzhou H3C Technologies Co., Ltd. Trademarks H3C,, Aolynk,, H 3 Care,, TOP G,, IRF, NetPilot, Neocean, NeoVTL, SecPro, SecPoint, SecEngine, SecPath, Comware, Secware, Storware, NQA, VVG, V 2 G, V n G, PSPT, XGbus, N-Bus, TiGem, InnoVision and HUASAN are trademarks of Hangzhou H3C Technologies Co., Ltd. All other trademarks that may be mentioned in this manual are the property of their respective owners. Notice The information in this document is subject to change without notice. Every effort has been made in the preparation of this document to ensure accuracy of the contents, but all statements, information, and recommendations in this document do not constitute the warranty of any kind, express or implied.

3 Preface The H3C SR6600 documentation set includes 13 command references, which describe the commands and command syntax options available for the H3C SR6600 Routers. The Network Management and Monitoring Command Reference describes the configuration commands applied during the management and maintenance process of routers and networks. This preface includes: Audience Conventions About the H3C SR6600 Documentation Set Obtaining Documentation Documentation Feedback Audience This documentation is intended for: Network planners Field technical support and servicing engineers Network administrators working with the SR6600 Conventions This section describes the conventions used in this documentation set. Command conventions Convention Boldface italic [ ] { x y... } [ x y... ] { x y... } * [ x y... ] * &<1-n> Bold text represents commands and keywords that you enter literally as shown. Italic text represents arguments that you replace with actual values. Square brackets enclose syntax choices (keywords or arguments) that are optional. Braces enclose a set of required syntax choices separated by vertical bars, from which you select one. Square brackets enclose a set of optional syntax choices separated by vertical bars, from which you select one or none. Asterisk marked braces enclose a set of required syntax choices separated by vertical bars, from which you select at least one. Asterisk marked square brackets enclose optional syntax choices separated by vertical bars, from which you may select multiple choices or none. The argument or keyword and argument combination before the ampersand (&) sign can be entered 1 to n times. # A line that starts with a pound (#) sign is comments.

4 Symbols Convention Means reader be extremely careful. Improper operation may cause bodily injury. Means reader be careful. Improper operation may cause data loss or damage to equipment. Means an action or information that needs special attention to ensure successful configuration or good performance. Means a complementary description. Means techniques helpful for you to make configuration with ease. About the H3C SR6600 Documentation Set The H3C SR6600 documentation set includes: Category Documents Purposes Product description and specifications Hardware specifications and installation Software configuration Operations and maintenance Marketing brochures Technology white papers Card datasheets Compliance and safety manual Installation guide Card manuals H3C N68 Cabinet Installation and Remodel Introduction Configuration guides Command references H3C SR6608 Release notes H3C SR6602 Release notes Describe product specifications and benefits. Provide an in-depth description of software features and technologies. Describe card specifications, features, and standards. Provides regulatory information and the safety instructions that must be followed during installation. Provides a complete guide to hardware installation and hardware specifications. Provide the hardware specifications of cards. Guides you through installing and remodeling H3C N68 cabinets. Describe software features and configuration procedures. Provide a quick reference to all available commands. Provide information about the product release, including the version history, hardware and software compatibility matrix, version upgrade information, technical support information, and software upgrading. Obtaining Documentation You can access the most up-to-date H3C product documentation on the World Wide Web at Click the links on the top navigation bar to obtain different categories of product documentation: [Technical Support & Documents > Technical Documents] Provides hardware installation, software upgrading, and software feature configuration and maintenance documentation. [Products & Solutions] Provides information about products and technologies, as well as solutions.

5 [Technical Support & Documents > Software Download] Provides the documentation released with the software version. Technical Support Documentation Feedback You can your comments about product documentation to We appreciate your comments.

6 Table of Contents 1 System Maintenance and Debugging Commands 1-1 System Maintenance Commands 1-1 ping 1-1 ping ipv6 1-4 tracert 1-6 tracert ipv6 1-7 System Debugging Commands 1-8 debugging 1-8 display debugging NQA Configuration Commands 2-1 NQA Client Configuration Commands 2-1 advantage-factor 2-1 codec-type 2-1 data-fill 2-2 data-size 2-3 description (any NQA test type view) 2-4 destination ip 2-4 destination port 2-5 display nqa history 2-6 display nqa result 2-7 display nqa statistics 2-11 filename 2-15 frequency 2-15 history-record enable 2-16 history-record keep-time 2-17 history-record number 2-17 http-version 2-18 next-hop 2-18 nqa 2-19 nqa agent enable 2-20 nqa agent max-concurrent 2-20 nqa schedule 2-21 operation (FTP test type view) 2-22 operation (HTTP test type view) 2-22 operation interface 2-23 password (FTP test type view) 2-23 probe count 2-24 probe packet-interval 2-25 probe packet-number 2-25 probe packet-timeout 2-26 probe timeout 2-27 i

7 reaction 2-27 reaction trap 2-28 resolve-target 2-29 route-option bypass-route 2-30 source interface 2-30 source ip 2-31 source port 2-32 statistics hold-time 2-32 statistics max-group 2-33 statistics interval 2-34 tos 2-34 ttl 2-35 type 2-35 url 2-36 username (FTP test type view) 2-37 vpn-instance (ICMP echo test type view) 2-37 NQA Server Configuration Commands 2-38 display nqa server status 2-38 nqa server enable 2-39 nqa server tcp-connect 2-39 nqa server udp-echo NTP Configuration Commands 3-1 NTP Configuration Commands 3-1 display ntp-service sessions 3-1 display ntp-service status 3-5 display ntp-service trace 3-6 ntp-service access 3-7 ntp-service authentication enable 3-8 ntp-service authentication-keyid 3-9 ntp-service broadcast-client 3-10 ntp-service broadcast-server 3-10 ntp-service in-interface disable 3-11 ntp-service max-dynamic-sessions 3-12 ntp-service multicast-client 3-12 ntp-service multicast-server 3-13 ntp-service refclock-master 3-14 ntp-service reliable authentication-keyid 3-15 ntp-service source-interface 3-15 ntp-service unicast-peer 3-16 ntp-service unicast-server IPC Configuration Commands 4-1 IPC Configuration Commands 4-1 display ipc channel 4-1 display ipc link 4-2 display ipc multicast-group 4-3 ii

8 display ipc node 4-4 display ipc packet 4-4 display ipc performance 4-5 display ipc queue 4-6 ipc performance enable 4-7 reset ipc performance SNMP Configuration Commands 5-1 SNMP Configuration Commands 5-1 display snmp-agent community 5-1 display snmp-agent group 5-2 display snmp-agent local-engineid 5-3 display snmp-agent mib-view 5-3 display snmp-agent statistics 5-5 display snmp-agent sys-info 5-6 display snmp-agent trap queue 5-7 display snmp-agent trap-list 5-8 display snmp-agent usm-user 5-9 enable snmp trap updown 5-10 snmp-agent 5-11 snmp-agent calculate-password 5-11 snmp-agent community 5-13 snmp-agent group 5-14 snmp-agent local-engineid 5-15 snmp-agent log 5-16 snmp-agent mib-view 5-17 snmp-agent packet max-size 5-18 snmp-agent sys-info 5-19 snmp-agent target-host 5-20 snmp-agent trap enable 5-21 snmp-agent trap if-mib link extended 5-23 snmp-agent trap life 5-24 snmp-agent trap queue-size 5-25 snmp-agent trap source 5-25 snmp-agent usm-user { v1 v2c } 5-26 snmp-agent usm-user v MIB Configuration Commands 6-1 MIB Configuration Commands 6-1 display mib-style 6-1 mib-style RMON Configuration Commands 7-1 RMON Configuration Commands 7-1 display rmon alarm 7-1 display rmon event 7-2 display rmon eventlog 7-3 display rmon history 7-4 iii

9 display rmon prialarm 7-7 display rmon statistics 7-8 rmon alarm 7-10 rmon event 7-12 rmon history 7-13 rmon prialarm 7-14 rmon statistics Sampler Configuration Commands 8-1 Sampler Configuration Commands 8-1 display sampler 8-1 reset sampler statistics 8-2 sampler Mirroring Configuration Commands 9-1 Mirroring Configuration Commands 9-1 display mirroring-group 9-1 mirroring-group 9-2 mirroring-group mirroring-port 9-3 mirroring-group monitor-egress 9-4 mirroring-group monitor-port 9-5 mirroring-group remote-probe vlan 9-6 mirroring-port 9-7 mirror-to 9-8 monitor-port NetStream Configuration Commands 10-1 NetStream Configuration Commands 10-1 display ip netstream cache 10-1 display ip netstream export 10-4 display ip netstream template 10-5 enable 10-7 ip netstream 10-8 ip netstream aggregation 10-8 ip netstream export host ip netstream export rate ip netstream export source ip netstream export v9-template refresh-rate packet ip netstream export v9-template refresh-rate time ip netstream export version ip netstream filter ip netstream max-entry ip netstream mpls ip netstream sampler ip netstream timeout active ip netstream timeout inactive reset ip netstream statistics iv

10 11 IPv6 NetStream Configuration Commands 11-1 IPv6 NetStream Configuration Commands 11-1 display ipv6 netstream cache 11-1 display ipv6 netstream export 11-5 display ipv6 netstream template 11-6 enable 11-8 ipv6 netstream 11-9 ipv6 netstream aggregation 11-9 ipv6 netstream export host ipv6 netstream export rate ipv6 netstream export source ipv6 netstream export v9-template refresh-rate packet ipv6 netstream export v9-template refresh-rate time ipv6 netstream export version ipv6 netstream max-entry ipv6 netstream timeout active ipv6 netstream timeout inactive reset ipv6 netstream statistics Information Center Configuration Commands 12-1 Information Center Configuration Commands 12-1 display channel 12-1 display info-center 12-2 display logbuffer 12-4 display logbuffer summary 12-6 display logfile buffer 12-7 display logfile summary 12-8 display trapbuffer 12-9 enable log updown info-center channel name info-center console channel info-center enable info-center format unicom info-center logbuffer info-center logfile enable info-center logfile frequency info-center logfile size-quota info-center logfile switch-directory info-center loghost info-center loghost source info-center monitor channel info-center snmp channel info-center source info-center synchronous info-center syslog channel info-center timestamp v

11 info-center timestamp loghost info-center trapbuffer logfile save reset logbuffer reset trapbuffer terminal debugging terminal logging terminal monitor terminal trapping Flow Logging Configuration Commands 13-1 Flow Logging Configuration Commands 13-1 display userlog export 13-1 reset userlog flow export 13-2 reset userlog flow logbuffer 13-3 userlog flow export host 13-3 userlog flow export host ipv userlog flow export source-ip 13-6 userlog flow export version 13-7 userlog flow syslog Command Index 14-1 vi

12 1 System Maintenance and Debugging Commands System Maintenance Commands ping 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 -vpn-instance vpn-instance-name ] * host Any view 0: Visit level ip: Supports IPv4 protocol. If this keyword is not provided, IPv4 is also supported. -a source-ip: Specifies the source IP address of an ICMP echo request (ECHO-REQUEST). It must be an IP address configured on the router. If this parameter is not provided, the source IP address of an ICMP echo request is the primary IP address of the outbound interface of the request. -c count: Specifies the number of times that an ICMP echo request is sent, which ranges from 1 to and defaults to 5. -f: Discards packets larger than the MTU of a given interface, which means the ICMP echo request is not allowed to be fragmented. -h ttl: Specifies the TTL value for an ICMP echo request, which ranges from 1 to 255 and defaults to i interface-type interface-number: Specifies the ICMP echo request sending interface by its type and number. If this parameter is not provided, the ICMP echo request sending interface is determined by searching the routing table or forwarding table according to the destination IP address. -m interval: Specifies the interval (in milliseconds) to send an ICMP echo response, which ranges from 1 to and defaults to 200 ms. If a response from the destination is received within the timeout time, the interval to send the next echo request equals the actual response period plus the value of interval. If no response from the destination is received within the timeout time, the interval to send the next echo request equals the timeout value plus the value of interval. -n: Specifies that the Domain Name System (DNS) is disabled for the host argument. When this keyword is not provided, if the host argument represents the host name of the destination, the router will translate 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, in the range 0 to ffffffff. If the specified value is less than 8 bits, 0s will be added in front of the value to extend it to 8 bits. For example, if pad is configured as 0x2f, then the packets will be padded with 1-1

13 0x f repeatedly to make the total length of the packet meet the requirements of the router. By default, the padded value starts from 0x01 up to 0xff, where another round starts again if necessary, like 0x feff01. -q: Presence of this parameter indicates that only statistics are displayed. Absence of this keyword indicates that all information is displayed. -r: Records routing information. If this keyword is not provided, routes are not recorded. -s packet-size: Specifies length (in bytes) of an ICMP echo request, which ranges from 20 to 8100 and defaults to 56. -t timeout: Specifies the timeout value (in milliseconds) of an ICMP echo reply (ECHO-REPLY). If the source does not receive an ICMP echo reply within the timeout, it considers the ICMP echo reply timed out. The value ranges from 0 to and defaults to tos tos: Specifies type of service (ToS) of an echo request, which ranges from 0 to 255 and defaults to 0. -v: Displays non ICMP echo reply received. If this keyword is not provided, the system does not display non ICMP echo reply. -vpn-instance vpn-instance-name: Specifies the name of an MPLS VPN instance, which is a case sensitive string of 1 to 31 characters. To check whether two nodes in an MPLS VPN can reach each other, use this keyword to specify the MPLS VPN instance to which the two nodes belong. host: IP address or host name (a string of 1 to 255 characters) of the destination. Use the ping command to verify whether the destination in an IP network is reachable, and to display the related statistics. After you execute the ping command, the source will send an ICMP echo request to the destination: If the destination name is unrecognizable, the system outputs Error: Ping: Unknown host host-name. If the source receives an ICMP echo reply from the destination within the timeout, the system outputs the related information of the reply. If the source does not receive an ICMP echo reply from the destination within the timeout, the system outputs Request time out. To use the name of the destination host to perform the ping operation, you must configure Domain Name System (DNS) on the router first; otherwise, the ping operation fails. For more information about DNS, see DNS in the Layer 3 - IP Services Configuration Guide. In addition, you must use the command in the form of ping ip ip instead of ping ip if the destination name is a key word, such as ip. Only the directly connected segment address can be pinged if the outgoing interface is specified with the -i argument. During the execution of the command, you can press Ctrl+C to abort the ping operation. # Check whether the router with an IP address of is reachable. <Sysname> ping PING : 56 data bytes, press CTRL_C to break Reply from : bytes=56 Sequence=1 ttl=254 time=205 ms Reply from : bytes=56 Sequence=2 ttl=254 time=1 ms Reply from : bytes=56 Sequence=3 ttl=254 time=1 ms 1-2

14 Reply from : bytes=56 Sequence=4 ttl=254 time=1 ms Reply from : bytes=56 Sequence=5 ttl=254 time=1 ms ping statistics packet(s) transmitted 5 packet(s) received 0.00% packet loss round-trip min/avg/max = 1/41/205 ms The above information indicates the following: The destination was reachable. All ICMP echo requests sent by the source got responses. The minimum time, average time, and maximum time for the packet s roundtrip time are 1 ms, 41 ms, and 205 ms respectively. # Check whether the router with an IP address of is reachable. Only the check results are displayed. <Sysname> ping -q PING : 56 data bytes, press CTRL_C to break ping statistics packet(s) transmitted 4 packet(s) received 20.00% packet loss round-trip min/avg/max = 1/12/29 ms # Check whether the router with an IP address of is reachable. The route information is required to be displayed. <Sysname> ping -r PING : 56 data bytes, press CTRL_C to break Reply from : bytes=56 Sequence=1 ttl=254 time=53 ms Record Route: Reply from : bytes=56 Sequence=2 ttl=254 time=1 ms Record Route: Reply from : bytes=56 Sequence=3 ttl=254 time=1 ms Record Route: Reply from : bytes=56 Sequence=4 ttl=254 time=1 ms Record Route:

15 Reply from : bytes=56 Sequence=5 ttl=254 time=1 ms Record Route: ping statistics packet(s) transmitted 5 packet(s) received 0.00% packet loss round-trip min/avg/max = 1/11/53 ms The above information indicates the following: The destination was reachable. The route is <-> { ; } <-> Table 1-1 ping command output description Field PING Check whether the router with IP address is reachable 56 data bytes Number of data bytes in each ICMP echo request press CTRL_C to break Reply from : bytes=56 Sequence=1 ttl=255 time=1 ms Record Route: During the execution of the command, you can press Ctrl+C to abort the ping operation. Received the ICMP reply from the router whose IP address is If no reply is received during the timeout period, Request time out will be displayed. bytes= indicates the number of data bytes in the ICMP reply. Sequence= indicates the packet sequence, used to determine whether a segment is lost, disordered or repeated. ttl= indicates the TTL value in the ICMP reply. time= indicates the response time. The routers through which the ICMP echo request passed. They are displayed in inversed order, that is, the router with a smaller distance to the destination is displayed first ping statistics --- 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 requests received 0.00% packet loss Percentage of packets not responded to the total packets sent round-trip min/avg/max = 0/4/20 ms Minimum/average/maximum response time, in ms. The field is not available for failed ping attempts in an IPv4 network. In an IPv6 network, however, the field is available and set to 0/0/0 ms. ping ipv6 ping ipv6 [ -a source-ipv6 -c count -m interval -s packet-size -t timeout ] * host [ -i interface-type interface-number ] 1-4

16 Any view 0: Visit level -a source-ipv6: Specifies the source IPv6 address of an ICMP echo request. It must be a legal IPv6 address configured on the router. If this parameter is not provided, the source IPv6 address of an ICMP echo request is the primary IPv6 address of the outbound interface of the request. -c count: Specifies the number of times that an ICMPv6 echo request is sent, which ranges from 1 to and defaults to 5. -m interval: Specifies the interval (in milliseconds) to send an ICMPv6 echo reply, which ranges from 1 to and defaults to 200 ms. If a response from the destination is received within the timeout time, the interval to send the next echo request equals the actual response period plus the value of interval. If no response from the destination is received within the timeout time, the interval to send the next echo request equals the timeout value plus the value of interval. -s packet-size: Specifies length (in bytes) of an ICMPv6 echo request, which ranges from 20 to 8100 and defaults to 56. -t timeout: Specifies the timeout value (in milliseconds) of an ICMPv6 echo reply, which ranges from 0 to and defaults to host: IPv6 address or host name of the destination, a string of 1 to 46 characters. -i interface-type interface-number: Specifies an outgoing interface by its type and number. This parameter can be used only in case that the destination address is the link local address and the specified outgoing interface must have a link local address (For more information about link local addresses, see IPv6 Basics in the Layer 3 - IP Services Configuration Guide.). If this parameter is not provided, the ICMP echo request sending interface is determined by searching the routing table or forwarding table according to the destination IP address. Use the ping ipv6 command to verify whether an IPv6 address is reachable, and display the corresponding statistics. You must use the command in the form of ping ipv6 ipv6 instead of ping ipv6 if the destination name is an ipv6 name. To abort the ping ipv6 operation during the execution of the command, press Ctrl+C. # Verify whether the IPv6 address 2001::1 is reachable. <Sysname> ping ipv6 2001::1 PING 2001::2 : 56 data bytes, press CTRL_C to break Reply from 2001::1 bytes=56 Sequence=1 hop limit=64 time = 62 ms Reply from 2001::1 bytes=56 Sequence=2 hop limit=64 time = 26 ms Reply from 2001::1 bytes=56 Sequence=3 hop limit=64 time = 20 ms 1-5

17 Reply from 2001::1 bytes=56 Sequence=4 hop limit=64 time = 4 ms Reply from 2001::1 bytes=56 Sequence=5 hop limit=64 time = 16 ms ::2 ping statistics packet(s) transmitted 5 packet(s) received 0.00% packet loss round-trip min/avg/max = 4/25/62 ms The hop limit field in this prompt information has the same meaning as the ttl field in the prompt information displayed by the IPv4 ping command, indicating the TTL value in the ICMPv6 echo request. For the description on other fields, see Table 1-1. tracert tracert [ -a source-ip -f first-ttl -m max-ttl -p port -q packet-number -vpn-instance vpn-instance-name -w timeout ] * host Any view 0: Visit level -a source-ip: Specifies the source IP address of a tracert packet. It must be a legal IP address configured on the router. If this parameter is not provided, the source IP address of an ICMP echo request is the primary IP address of the outbound interface of the tracert packet. -f first-ttl: Specifies the first TTL, that is, the allowed number of hops for the first packet, which ranges from 1 to 255 and defaults to 1. It must be less than the maximum TTL. -m max-ttl: Specifies the maximum TTL, that is, the maximum allowed number of hops for a packet, which ranges from 1 to 255 and defaults to 30. It must be greater than the first TTL. -p port: Specifies the UDP port number of the destination, which ranges from 1 to and defaults to You do not need to change this parameter. -q packet-number: Specifies the number of probe packets sent each time, which ranges from 1 to and defaults to 3. -vpn-instance vpn-instance-name: Specifies the name of an MPLS VPN instance, which is a string of 1 to 31 characters. -w timeout: Specifies the timeout time of a reply packet of a probe packet, which ranges from 1 to and defaults to 5000 ms. host: IP address or host name (a string of 1 to 255 characters) of the destination. Use the tracert command to trace the routers the packets traverse from source to destination. After having identified network failure with the ping command, you can use the tracert command to determine the failed node(s). 1-6

18 Output information of the tracert command includes IP addresses of all the Layer 3 devices the packets traverse from source to destination. If a router times out, "* * *" will be displayed. To abort the tracert operation during the execution of the command, press Ctrl+C. # Display the routers the packets traverse from source to destination with an IP address of [Sysname] ip ttl-expires enable [Sysname] ip unreachables enable [Sysname] tracert traceroute to ( ) 30 hops max,40 bytes packet, press CTRL_C to break ms 425 ms 30 ms ms 470 ms 80 ms Table 1-2 tracert command output description Field traceroute to ( ) hops max bytes packet press CTRL_C to break ms 425 ms 30 ms Display the route the IP packets traverse from the current router to the router whose IP address is Maximum number of hops of the probe packets, which can be set through the -m keyword Number of bytes of a probe packet During the execution of the command, you can press Ctrl+C to abort the tracert operation. The probe result of the probe packets whose TTL is 1, including the IP address of the first hop and the roundtrip time of three probe packets. The number of packets that can be sent in each probe can be set through the -q keyword. tracert ipv6 tracert ipv6 [ -f first-ttl -m max-ttl -p port -q packet-number -w timeout ] * host Any view 0: Visit level -f first-ttl: Specifies the first TTL, which means the allowed number of hops for the first packet, in the range 1 to 255. It defaults to 1 and must be less than the maximum TTL. -m max-ttl: Specifies the maximum TTL, which means the maximum allowed number of hops for a packet, which ranges from 1 to 255 and defaults to 30, and must be greater than the first TTL. -p port: Specifies the UDP port number of the destination, which ranges from 1 to and defaults to It is unnecessary to modify this parameter. -q packet-number: Specifies the number of probe packets sent each time, which ranges from 1 to and defaults to

19 -w timeout: Specifies the timeout time of a reply packet of a probe packet, which ranges from 1 to and defaults to 5000 ms. host: IPv6 address or host name (a string of 1 to 46 characters) of the destination. Use the tracert ipv6 command to view the routers the IPv6 packets traverse from source to destination. After having identified network failure with the ping command, you can use the tracert command to determine the failed node(s). Output information of the tracert ipv6 command includes IPv6 addresses of all the Layer 3 devices the packets traverse from source to destination. If a router times out, "* * *" will be displayed. To abort the tracert operation during the execution of the command, press Ctrl+C. # the routes involved for packets to travel from source to destination with IPv6 address 2001::1. <Sysname> tracert ipv6 2001::1 traceroute to 2001::1 30 hops max,60 bytes packet, press CTRL_C to break ::1 3 ms <1 ms 19 ms For description on the fields in the above output information, see Table 1-2. System Debugging Commands debugging debugging { all [ timeout time ] module-name [ option ] } undo debugging { all module-name [ option ] } User view 1: Monitor level all: All debugging functions. timeout time: Specifies the timeout time for the debugging all command. When all debugging is enabled, the system automatically executes the undo debugging all command after the time. The value ranges from 1 to 1440, in minutes. module-name: Module name, such as arp or device. To display the current module name, use the debugging? command. option: Debugging option of a specific module. Different modules have different debugging options in terms of their number and content. To display the currently supported options, use the debugging module-name? command. Use the debugging command to enable the debugging of a specific module. Use the undo debugging command to disable the debugging of a specific module. By default, debugging functions of all modules are disabled. 1-8

20 Output of the debugging information may degrade system efficiency, so you are recommended to enable the debugging of the corresponding module for diagnosing network failure, and not to enable the debugging of multiple modules at the same time. Output of the debugging information may degrade system efficiency, especially during the execution of the debugging all command. Therefore, use the command with caution. describes the default level of the debugging all command. Different debugging commands may have different default levels. You must configure the debugging, terminal debugging and terminal monitor commands first to display detailed debugging information on the terminal. For more information about the terminal debugging and terminal monitor commands, see Information Center in the Network Management and Monitoring Command Reference. Related commands: display debugging. # Enable IP packet debugging. <Sysname> debugging ip packet display debugging display debugging [ interface interface-type interface-number ] [ module-name ] Any view 1: Monitor level interface interface-type interface-number: Displays the debugging settings of the specified interface, where interface-type interface-number represents the interface type and number. module-name: Module name. Use the display debugging command to display enabled debugging functions. Related commands: debugging. # Display all enabled debugging functions. <Sysname> display debugging IP packet debugging is on 1-9

21 2 NQA Configuration Commands NQA Client Configuration Commands advantage-factor advantage-factor factor undo advantage-factor Voice test type view 2: System level factor: Advantage factor, used to count Mean Opinion Scores (MOS) and Calculated Planning Impairment Factor (ICPIF) values. It ranges from 0 to 20. Use the advantage-factor command to configure the advantage factor that is used to count MOS and ICPIF values. Use the undo advantage-factor command to restore the default. By default, the advantage factor is 0. The evaluation of voice quality depends on users tolerance to voice quality, and this factor should be taken into consideration. For users with higher tolerance to voice quality, use the advantage-factor command to configure the advantage factor. When the system calculates the ICPIF value, this advantage factor is subtracted to modify ICPIF and MOS values and thus both the objective and subjective factors are considered when you evaluate the voice quality. # Configure the advantage factor for a voice test as 10. [Sysname] nqa entry admin test [Sysname-nqa-admin-test] type voice [Sysname-nqa-admin-test-voice] advantage-factor 10 codec-type codec-type { g711a g711u g729a } undo codec-type 2-1

22 Voice test type view 2: System level g711a: G.711 A-law codec type. g711u: G.711 µ-law codec type g729a: G.729 A-law codec type. Use the codec-type command to configure the codec type for a voice test. Use the undo codec-type command to restore the default. By default, the codec type for a voice test is G.711 A-law. # Configure the codec type for a voice test as g729a. [Sysname] nqa entry admin test [Sysname-nqa-admin-test] type voice [Sysname-nqa-admin-test-voice] codec-type g729a data-fill data-fill string undo data-fill ICMP echo, UDP echo, UDP jitter, voice test type view 2: System level string: A string of 1 to 200 case sensitive characters, used to fill a probe packet. Use the data-fill command to configure the string used to fill a probe packet. Use the undo data-fill command to restore the default. By default, the string used to fill a probe packet is the hexadecimal number If the data field of a probe packet is smaller than the fill data, the system uses only the first part of the character string to encapsulate the packet. If the data field of a probe packet is larger than the fill data, the system fills the character string cyclically to encapsulate the packet until it is full. For example, when the fill data is abcd and the size of the data field of a probe packet is 3 byte, abc is used to fill the packet. When the data field of a probe packet is 6 byte, abcdab is used to fill the packet. 2-2

23 In an ICMP echo test, the configured character string is used to fill the data field in the data field of an ICMP echo message. In a UDP echo test, because the first five bytes of the data field of a probe packet have some specific usage, the configured character string is used to fill the remaining bytes in the probe packet. In a UDP jitter test, because the first 68 bytes of the data field of a probe packet have some specific usage, the configured character string is used to fill the remaining bytes in the probe packet. In a voice test, because the first 16 bytes of the data field of a UDP packet have some specific usage, the configured character string is used to fill the remaining bytes in the UDP packet. # Configure the string used to fill an ICMP echo probe packet as abcd. [Sysname] nqa entry admin test [Sysname-nqa-admin-test] type icmp-echo [Sysname-nqa-admin-test-icmp-echo] data-fill abcd data-size data-size size undo data-size ICMP echo, UDP echo, UDP jitter, or voice test type view 2: System level size: Size of a probe packet in bytes, which ranges from 20 to 8100 for an ICMP echo or a UDP echo test, ranges from 68 to 8100 for a UDP jitter test, and ranges from 16 to 1500 for a voice test. Use the data-size command to configure the size of a probe packet sent. Use the undo data-size command to restore the default. The default values are as shown in Table 2-1. Table 2-1 Default values of the size of test packets sent Test Type Codec type Default value (in bytes) ICMP None 100 UDP echo None 100 UDP jitter None 100 Voice G.711 A-law 172 Voice G.711 µ-law 172 Voice G.729 A-law

24 By default, the size of a probe packet is 100 bytes. For an ICMP echo test, the size of a packet sent in a probe is the length of the data field in an ICMP echo message. For a UDP echo test, UDP jitter test, and voice test, the size of a packet sent in a probe is the length of the data field in a UDP packet. # Configure the size of an ICMP echo probe packet as 80 bytes. [Sysname] nqa entry admin test [Sysname-nqa-admin-test] type icmp-echo [Sysname-nqa-admin-test-icmp-echo] data-size 80 description (any NQA test type view) description text undo description Any NQA test type view 2: System level text: A string of 1 to 200 case sensitive characters, used to describe a test group. Use the description command to give a brief description of a test group, usually, the test type or test purpose of a test group. Use the undo description command to remove the configured description information. By default, no descriptive string is available for a test group. # Configure the descriptive string for a test group as icmp-probe. [Sysname] nqa entry admin test [Sysname-nqa-admin-test] type icmp-echo [Sysname-nqa-admin-test-icmp-echo] description icmp-probe destination ip destination ip ip-address undo destination ip 2-4

25 DLSw, DNS, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo, UDP jitter, voice test type view 2: System level ip-address: Destination IP address of a test operation. Use the destination ip command to configure a destination IP address for a test operation. Use the undo destination ip command to remove the configured destination IP address. By default, no destination IP address is configured for a test operation. # Configure the destination IP address of an ICMP echo test operation as [Sysname] nqa entry admin test [Sysname-nqa-admin-test] type icmp-echo [Sysname-nqa-admin-test-icmp-echo] destination ip destination port destination port port-number undo destination port TCP, UDP echo, UDP jitter, voice test type view 2: System level port-number: Destination port number of a test operation, in the range 1 to Use the destination port command to configure a destination port number for a test operation. Use the undo destination port command to remove the configured destination port number. By default, no destination port number is configured for a test operation. Note that you are not recommended to perform a UDP jitter test on ports from 1 to 1023 (known ports). Otherwise, the NQA test will fail or the corresponding services of this port will be unavailable. # Configure the destination port number of a test operation as [Sysname] nqa entry admin test [Sysname-nqa-admin-test] type udp-echo [Sysname-nqa-admin-test-udp-echo] destination port

26 display nqa history display nqa history [ admin-name operation-tag ] Any view 2: System level admin-name operation-tag: Displays history records of a test group. If these two arguments are not specified, history records of all test groups are displayed. admin-name represents the name of the administrator who creates the NQA operation. It is a case-insensitive string of 1 to 32 characters. operation-tag represents the test operation tag. It is a case-insensitive string of 1 to 32 characters. Use the display nqa history command to display history records of NQA tests. Note that the display nqa history command cannot show you the results of voice tests and UDP jitter tests. Therefore, to know the result of a voice test or a UDP jitter test, you are recommended to use the display nqa result command to view the probe results of the latest NQA test, or use the display nqa statistics command to view the statistics of NQA tests. # Display the history records of the NQA test in which the administrator name is administrator, and the operation tag is test. <Sysname> display nqa history administrator test NQA entry(admin administrator, tag test) history record(s): Index Response Status Time Succeeded :54: Succeeded :54: Succeeded :54: Succeeded :54: Succeeded :54: Succeeded :54: Succeeded :54: Succeeded :54: Succeeded :54: Succeeded :54:23.4 Table 2-2 display nqa history command output description Field Index Response History record number Roundtrip delay of a test packet in the case of a successful test, timeout time in the case of timeout, or 0 in the case that a test cannot be completed (in milliseconds) 2-6

27 Field Status Time Status value of test results, including: Succeeded Unknown error Internal error Timeout Time when the test is completed display nqa result display nqa result [ admin-name operation-tag ] Any view 2: System level admin-name operation-tag: Displays results of the last test of a test group. If this argument is not specified, results of the last tests of all test groups are displayed. admin-name represents the name of the administrator who creates the NQA operation. It is a case-insensitive string of 1 to 32 characters. operation-tag represents the test operation tag. It is a case-insensitive string of 1 to 32 characters. Use the display nqa result command to display results of the last NQA test. # Display the results of the last UDP jitter test. <Sysname> display nqa result admin test NQA entry(admin admin, tag test) test results: Destination IP address: Send operation times: 10 Receive response times: 10 Min/Max/Average round trip time: 15/46/26 Square-Sum of round trip time: 8103 Last succeeded probe time: :56:38.7 Extended results: Packet lost in test: 0% Failures due to timeout: 0 Failures due to disconnect: 0 Failures due to no connection: 0 Failures due to sequence error: 0 Failures due to internal error: 0 Failures due to other errors: 0 Packet(s) arrived late: 0 UDP-jitter results: RTT number: 10 Min positive SD: 8 Min positive DS: 8 2-7

28 Max positive SD: 18 Max positive DS: 8 Positive SD number: 5 Positive DS number: 2 Positive SD sum: 75 Positive DS sum: 32 Positive SD average: 15 Positive DS average: 16 Positive SD square sum: 1189 Positive DS square sum: 640 Min negative SD: 8 Min negative DS: 1 Max negative SD: 24 Max negative DS: 30 Negative SD number: 4 Negative DS number: 7 Negative SD sum: 56 Negative DS sum: 99 Negative SD average: 14 Negative DS average: 14 Negative SD square sum: 946 Negative DS square sum: 1495 One way results: Max SD delay: 22 Max DS delay: 23 Min SD delay: 7 Min DS delay: 7 Number of SD delay: 10 Number of DS delay: 10 Sum of SD delay: 125 Sum of DS delay: 132 Square sum of SD delay: 1805 Square sum of DS delay: 1988 SD lost packet(s): 0 DS lost packet(s): 0 Lost packet(s) for unknown reason: 0 # Display the results of the last voice test. <Sysname> display nqa result admin test NQA entry(admin admin, tag test) test results: Destination IP address: Send operation times: 1000 Receive response times: 0 Min/Max/Average round trip time: 0/0/0 Square-Sum of round trip time: 0 Last succeeded probe time: :00:00.0 Extended results: Packet lost in test: 100% Failures due to timeout: 1000 Failures due to disconnect: 0 Failures due to no connection: 0 Failures due to sequence error: 0 Failures due to internal error: 0 Failures due to other errors: 0 Packet(s) arrived late: 0 Voice results: RTT number: 0 Min positive SD: 0 Min positive DS: 0 Max positive SD: 0 Max positive DS: 0 Positive SD number: 0 Positive DS number: 0 Positive SD sum: 0 Positive DS sum: 0 Positive SD average: 0 Positive DS average: 0 Positive SD square sum: 0 Positive DS square sum: 0 Min negative SD: 0 Min negative DS: 0 Max negative SD: 0 Max negative DS: 0 Negative SD number: 0 Negative DS number: 0 Negative SD sum: 0 Negative DS sum: 0 Negative SD average: 0 Negative DS average: 0 Negative SD square sum: 0 Negative DS square sum: 0 One way results: 2-8

29 Max SD delay: 0 Max DS delay: 0 Min SD delay: 0 Min DS delay: 0 Number of SD delay: 0 Number of DS delay: 0 Sum of SD delay: 0 Sum of DS delay: 0 Square sum of SD delay: 0 Square sum of DS delay: 0 SD lost packet(s): 0 DS lost packet(s): 0 Lost packet(s) for unknown reason: 1000 Voice scores: MOS value: 0.99 ICPIF value: 87 Table 2-3 display nqa result command output description Field Destination IP address Send operation times Receive response times Min/Max/Average round trip time Square-Sum of round trip time Last succeeded probe time Packet lost in test Failures due to timeout Failures due to disconnect Failures due to no connection Failures due to sequence error Failures due to internal error Failures due to other errors Packet(s) arrived late UDP-jitter results Voice results RTT number Min positive SD Min positive DS Max positive SD Max positive DS Positive SD number Positive DS number Positive SD sum Positive DS sum Positive SD average Positive DS average Positive SD square sum Positive DS square sum IP address of the destination Number of probe packets sent Number of response packets received Minimum/maximum/average roundtrip time in the unit of millisecond Square sum of roundtrip time Time when the last successful probe was finished Average packet loss ratio Number of timeout occurrences in a test Number of disconnections by the peer Number of failures to connect with the peer Number of failures owing to out-of-sequence packets Number of failures owing to internal errors Failures due to other errors Number of packets that arrived late UDP jitter test results, available only in UDP jitter tests. Voice test results, available only in voice tests. Number of response packets received Minimum positive jitter delay from source to destination Minimum positive jitter delay from destination to source Maximum positive jitter delay from source to destination Maximum positive jitter delay from destination to source Number of positive jitter delays from source to destination Number of positive jitter delays from destination to source Sum of positive jitter delays from source to destination Sum of positive jitter delays from destination to source Average of positive jitter delays from source to destination Average of positive jitter delays from destination to source Square sum of positive jitter delays from source to destination Square sum of positive jitter delays from destination to source 2-9

30 Field Min negative SD Min negative DS Max negative SD Max negative DS Negative SD number Negative DS number Negative SD sum Negative DS sum Negative SD average Negative DS average Negative SD square sum Negative DS square sum One way results Max SD delay Max DS delay Min SD delay Min DS delay Number of SD delay Number of DS delay Sum of SD delay Sum of DS delay Square sum of SD delay Square sum of DS delay SD lost packet(s) DS lost packet(s) Lost packet(s) for unknown reason Voice scores MOS value ICPIF value Minimum absolute value among negative jitter delays from source to destination Minimum absolute value among negative jitter delays from destination to source Maximum absolute value among negative jitter delays from source to destination Maximum absolute value among negative jitter delays from destination to source Number of negative jitter delays from source to destination Number of negative jitter delays from destination to source Sum of absolute values of negative jitter delays from source to destination Sum of absolute values of negative jitter delays from destination to source Average absolute value of negative jitter delays from source to destination Average absolute value of negative jitter delays from destination to source Square sum of negative jitter delays from source to destination Square sum of negative jitter delays from destination to source Uni-direction delay test result, displayed in a UDP jitter or voice test Maximum delay from source to destination Maximum delay from destination to source Minimum delay from source to destination Minimum delay from destination to source Number of delays from source to destination Number of delays from destination to source Sum of delays from source to destination Sum of delays from destination to source Square sum of delays from source to destination Square sum of delays from destination to source Number of lost packets from the source to the destination Number of lost packets from the destination to the source Number of lost packets for unknown reasons Voice parameters, displayed only in a voice test MOS value calculated for a voice test ICPIF value calculated for a voice test 2-10

31 display nqa statistics display nqa statistics [ admin-name operation-tag ] Any view 2: System level admin-name operation-tag: Displays statistics of the specified test group. If this argument is not specified, statistics of all test groups are displayed. admin-name represents the name of the administrator who creates the NQA operation. It is a case-insensitive string of 1 to 32 characters. operation-tag represents the test operation tag. It is a case-insensitive string of 1 to 32 characters. Use the display nqa statistics command to display statistics of a NQA test or tests. When the test operation begins, if not all the probes in the first test have been finished, statistics cannot be generated. In this case, if you display the statistics by using this command, the statistics are displayed as all 0s. # Display statistics of UDP jitter tests. <Sysname> display nqa statistics admin test NQA entry(admin admin, tag test) test statistics: NO. : 1 Destination IP address: Start time: :33:29.9 Life time: 8 Send operation times: 70 Receive response times: 70 Min/Max/Average round trip time: 1/63/19 Square-Sum of round trip time: Extended results: Packet lost in test: 0% Failures due to timeout: 0 Failures due to disconnect: 0 Failures due to no connection: 0 Failures due to sequence error: 0 Failures due to internal error: 0 Failures due to other errors: 0 Packet(s) arrived late: 0 UDP-jitter results: RTT number: 70 Min positive SD: 1 Min positive DS: 1 Max positive SD: 24 Max positive DS: 22 Positive SD number: 34 Positive DS number: 27 Positive SD sum: 415 Positive DS sum: 362 Positive SD average: 12 Positive DS average:

32 Positive SD square sum: 6593 Positive DS square sum: 6450 Min negative SD: 1 Min negative DS: 1 Max negative SD: 40 Max negative DS: 64 Negative SD number: 28 Negative DS number: 35 Negative SD sum: 28 Negative DS sum: 35 Negative SD average: 13 Negative DS average: 12 Negative SD square sum: 7814 Negative DS square sum: 420 One way results: Max SD delay: 31 Max DS delay: 31 Min SD delay: 7 Min DS delay: 7 Number of SD delay: 70 Number of DS delay: 70 Sum of SD delay: 628 Sum of DS delay: 656 Square sum of SD delay: 8156 Square sum of DS delay: 8704 SD lost packet(s): 0 DS lost packet(s): 0 Lost packet(s) for unknown reason: 0 # Display statistics of voice tests. <Sysname> display nqa statistics admin test NQA entry(admin admin, tag test) test statistics: NO. : 1 Destination IP address: Start time: :00:03.6 Life time: 638 Send operation times: Receive response times: 0 Min/Max/Average round trip time: 0/0/0 Square-Sum of round trip time: 0 Extended results: Packet lost in test: 100% Failures due to timeout: Failures due to disconnect: 0 Failures due to no connection: 0 Failures due to sequence error: 0 Failures due to internal error: 0 Failures due to other errors: 0 Packet(s) arrived late: 0 Voice results: RTT number: 0 Min positive SD: 0 Min positive DS: 0 Max positive SD: 0 Max positive DS: 0 Positive SD number: 0 Positive DS number: 0 Positive SD sum: 0 Positive DS sum: 0 Positive SD average: 0 Positive DS average: 0 Positive SD square sum: 0 Positive DS square sum: 0 Min negative SD: 0 Min negative DS: 0 Max negative SD: 0 Max negative DS: 0 Negative SD number: 0 Negative DS number: 0 Negative SD sum: 0 Negative DS sum: 0 Negative SD average: 0 Negative DS average: 0 Negative SD square sum: 0 Negative DS square sum: 0 One way results: Max SD delay: 0 Max DS delay: 0 Min SD delay: 0 Min DS delay: