40-HWPing Command

Download


Chapter 1  HWPing Commands

 

&  Note:

l      The configuration of eight test types, including DHCP, FTP, HTTP, DNS, SNMP, Jitter, TCP and UDP tests is added. For the detailed configuration of these tests, refer to the introduction in this chapter.

l      The configuration of the maximum number of history records that can be saved in a test group is added. For the detailed configuration, refer to section history-records.

 

1.1  HWPing Client Commands

1.1.1  count

Syntax

count times

undo count

View

HWPing test group view

Parameters

times: Number of probes in each test. The times argument ranges from 1 to 15.

Description

Use the count command to set the number of probes in each test.

Use the undo count command to restore the default.

For tests except jitter test, only one packet is sent in a probe. In a jitter test, you can use the jitter-packetnum command to set the number of packets to be sent in a probe.

By default, the number of probes in each test is 1.

Related commands: frequency.

Examples

# Set the number of probes made in an ICMP test to 10.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping administrator icmp

[Sysname-hwping-administrator-icmp] test-type icmp

[Sysname-hwping-administrator-icmp] count 10

1.1.2  datasize

Syntax

datasize size

undo datasize

View

HWPing test group view

Parameters

size: Size of a test packet in bytes. The value range varies with the test types.

Table 1-1 Value range of the HWPing test packets

Test type

Value range (in bytes)

Default (in bytes)

Jitter

68 to 8100

68

ICMP

4 to 8100

56

Udpprivate

4 to 8100

100

Udppublic

4 to 8100

100

 

The packet size configuration applies to ICMP, UDP, and jitter tests only.

Description

Use the datasize command to configure the size of a test packet in a test.

Use the undo datasize command to restore the default.

Examples

# Set the size of ICMP test packets to 50 bytes.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] hwping administrator icmp

[Sysname-hwping-administrator-icmp] test-type icmp

[Sysname-hwping-administrator-icmp] datasize 50

1.1.3  destination-ip

Syntax

destination-ip ip-address

undo destination-ip

View

HWPing test group view

Parameters

ip-address: Destination IP address of a HWPing (pronounced Hua’Wei Ping) test.

Description

Use the destination-ip command to configure a destination IP address of an HWPing test.

Use the undo destination-ip command to remove the configured destination IP address.

By default, no destination IP address is configured for an HWPing test.

Related commands: destination-port.

 

&  Note:

The destination address can be an IP address or a host name in HTTP test, while in other types of tests, it must be an IP address.

 

Examples

# Set the destination IP address of an ICMP test to 169.254.10.3.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping administrator icmp

[Sysname-hwping-administrator-icmp] test-type icmp

[Sysname-hwping-administrator-icmp] destination-ip 169.254.10.3

1.1.4  destination-port

Syntax

destination-port port-number

undo destination-port

View

HWPing test group view

Parameters

port-number: Destination port number for an HWPing test, in the range of 1 to 65535.

Description

Use the destination-port command to configure a destination port number for an HWPing test.

Use the undo destination-port command to remove the configured destination port number.

By default, no destination port number is configured for a test.

Related commands: destination-ip.

 

&  Note:

l      The destination-port command has effect on jitter, TCP-Private, and UDP-Private tests only.

l      It is not recommended to perform a TCP, UDP, or jitter test on a well-known port (ports with a number ranging from 1 to 1023) or on a port with a port number greater than 50000. Otherwise, the HWPing test will fail or the corresponding service of the well-known port will become unavailable.

 

Examples

# Set the destination port number for a tcpprivate test to 9000.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping administrator tcp

[Sysname-hwping-administrator-tcp] test-type tcpprivate

[Sysname-hwping-administrator-tcp] destination-port 9000

1.1.5  display hwping

Syntax

display hwping { results | history } [ administrator-name operation-tag ]

View

Any view

Parameters

results: Displays results of the last test.

history: Displays the history records of tests.

administrator-name: Name of the administrator who created the HWPing test operation, a string of 1 to 32 characters.

operation-tag: Operation tag, a string of 1 to 32 characters.

Description

Use the display hwping command to display the result of the last HWPing test or the history of HWPing tests.

Without administrator-name test-operation-tag specified, the command displays the results of all test groups; without administrator-name test-operation-tag specified, the command displays the results of the specified test group.

Related commands: test-enable.

Examples

# Display the test results of the test group with the administrator name administrator, and the operation tag icmp.

[Sysname-hwping-administrator-icmp] display hwping results administrator icmp

  HWPing entry(admin administrator, tag icmp) test result:

      Destinationip address:10.2.2.2

      Send operation times: 10             Receive response times: 10

      Min/Max/Average Round Trip Time: 1/2/1

      Square-Sum of Round Trip Time: 13

      Last succeeded test time: 2004-11-25 16:28:55.0

    Extend result:

      SD Maximal delay: 0                  DS Maximal delay: 0

      Packet lost in test: 0%

      Disconnect operation number:0        Operation timeout number:0

      System busy operation number:0       Connection fail number:0

      Operation sequence errors:0          Drop operation number:0

      Other operation errors:0

Table 1-2 Description on the fields of the display hwping result command

Filed

Description

Destination ip address

Destination IP address

Send operation times

Number of probes made

Receive response times

Number of received response packets

Min/Max/Average Round Trip Time

Minimum/maximum/average roundtrip time, in milliseconds

Square-Sum of Round Trip Time

Square sum of roundtrip time

Last succeeded test time

Completion time of the last successful test

SD Maximal delay

Maximum delay from the source to the destination

DS Maximal delay

Maximum delay from the destination to the source

Packet lost in test

Average packet loss ratio

Disconnect operation number

Number of times the test was disconnected by the remote end

System busy operation number

Number of times the test failed because the system was busy

Operation sequence errors

Number of out-of-sequence packets received

Other operation errors

Number of other errors

Operation timeout number

Number of time-out occurrences in a test

Connection fail number

Number of failures to connect with the remote end

Drop operation number

Number of system resource allocation failures

 

# Display the history records of HWPing tests.

[Sysname-hwping-administrator-icmp] display hwping history administrator icmp

  HWPing entry(admin administrator, tag icmp) history record:

    Index     Response    Status      LastRC      Time

        1            1         1           0    2004-11-25 16:28:55.0

        2            1         1           0    2004-11-25 16:28:55.0

        3            1         1           0    2004-11-25 16:28:55.0

        4            1         1           0    2004-11-25 16:28:55.0

        5            1         1           0    2004-11-25 16:28:55.0

        6            2         1           0    2004-11-25 16:28:55.0

        7            1         1           0    2004-11-25 16:28:55.0

        8            1         1           0    2004-11-25 16:28:55.0

        9            1         1           0    2004-11-25 16:28:55.9

       10            1         1           0    2004-11-25 16:28:55.9

Table 1-3 Description on the fields of the display hwping history command

Field

Description

Response

Roundtrip time in the case of a successful test, timeout time in the case of test timeout, or 0 in the case of a test failure (in milliseconds)

Status

Test result values, including:

1: responseReceived: Response received

2: unknown: Unknown error.

3: internalError: System internal error

4: requestTimeOut: Request timed out

5: unknownDestinationAddress: Unknown destination address

6: noRouteToTarget: Destination unreachable

7: interfaceInactiveToTarget: Interface to destination address inactive

8: arpFailure: ARP operation failed.

9: maxConcurrentLimitReached: Maximum limit of concurrent accesses reached

10: unableToResolveDnsName: Unable to resolve DNS domain name

11: invalidHostAddress: Invalid host address

LastRC

Response code in the last ICMP response packet received. (The device does not support this field at present, so that this field is always displayed as 0)

Time

Test completion time

 

# Display the test results of the test group with administrator name administrator, and the operation tag http.

[Sysname-hwping-administrator-http] display hwping results administrator http

  HWPing entry(admin administrator, tag http) test result:

      Destination ip address:192.168.0.152

      Send operation times: 10              Receive response times: 10

      Min/Max/Average Round Trip Time: 47/87/74

      Square-Sum of Round Trip Time: 57044

      Last succeeded test time: 2000-4-2 20:41:50.4

  Extend result:

      SD Maximal delay: 0                   DS Maximal delay: 0

      Packet lost in test: 0%

      Disconnect operation number: 0        Operation timeout number: 0

      System busy operation number: 0       Connection fail number: 0

      Operation sequence errors: 0          Drop operation number: 0

      Other operation errors: 0

    Http result:

      DNS Resolve Time: 0                  HTTP Operation Time: 675

      DNS Resolve Min Time: 0              HTTP Test Total Time: 748

      DNS Resolve Max Time: 0          HTTP Transmission Successful Times: 1

      DNS Resolve Failed Times: 0          HTTP Transmission Failed Times: 0

      DNS Resolve Timeout Times: 0        HTTP Transmission Timeout Times: 0

      TCP Connect Time: 73                 HTTP Operation Min Time: 27

      TCP Connect Min Time: 5              HTTP Operation Max Time: 80

      TCP Connect Max Time: 20

      TCP Connect Timeout Times: 0                 

Table 1-4 Description on the fields of the display hwping result command

Field

Description

DNS Resolve Time

Time used for a DNS resolution

HTTP Operation Time

Total time used to establish an HTTP connection

DNS Resolve Min Time

Minimal time used for a DNS resolution

HTTP Test Total Time

Total time used for an HTTP test

DNS Resolve Max Time

Maximum time used for a DNS resolution

HTTP Transmission Successful Times

Number of successful HTTP transmissions

DNS Resolve Failed Times

Number of failed DNS resolutions

HTTP Transmission Failed Times

Number of failed HTTP transmissions

DNS Resolve Timeout Times

DNS resolution timeout times

HTTP Transmission Timeout Times

HTTP transmission timeout times

TCP Connect Time

Total time used to establish a TCP connection

HTTP Operation Min Time

Minimum time used to establish an HTTP connection

TCP Connect Min Time

Minimum time used to establish a TCP connection

HTTP Operation Max Time

Maximum time used to establish an HTTP connection

TCP Connect Max Time

Maximum time used to establish a TCP connection

TCP Connect Timeout Times

TCP connection timeout times

 

# Display the test results of the test group with administrator name administrator, and the operation tag Jitter.

[Sysname-hwping-administrator-Jitter] display hwping results administrator Jitter

HWPing entry(admin administrator, tag Jitter) test result:

      Destination ip address:10.2.2.2

      Send operation times: 100             Receive response times: 100

      Min/Max/Average Round Trip Time: 9/21/13

      Square-Sum of Round Trip Time: 18623

      Last succeeded test time: 2000-4-2 8:14:58.2

  Extend result:

      SD Maximal delay: 10                  DS Maximal delay: 10

      Packet lost in test: 0%

      Disconnect operation number: 0        Operation timeout number: 0

      System busy operation number: 0       Connection fail number: 0

      Operation sequence errors: 0          Drop operation number: 0

      Other operation errors: 0

    Jitter result:

      RTT Number:100

      Min Positive SD:1                    Min Positive DS:1

      Max Positive SD:6                    Max Positive DS:8

      Positive SD Number:38                Positive DS Number:25

      Positive SD Sum:85                   Positive DS Sum:42

      Positive SD average:2                Positive DS average:1

      Positive SD Square Sum:267           Positive DS Square Sum:162

      Min Negative SD:1                    Min Negative DS:1

      Max Negative SD:6                    Max Negative DS:8

      Negative SD Number:30                Negative DS Number:24

      Negative SD Sum:64                   Negative DS Sum: 41

      Negative SD average:2                Negative DS average:1

      Negative SD Square Sum:200           Negative DS Square Sum:161

      SD lost packets number:0             DS lost packet number:0

      Unkown result lost packet number:0           

Table 1-5 Description on the fields of the display hwping result command

Field

Description

RTT Number

Number of received response packets

Min Positive SD

Minimum positive jitter delay from the source to the destination

Min Positive DS

Minimum positive jitter delay from the destination to the source

Max Positive SD

Maximum positive jitter delay from the source to the destination

Max Positive DS

Maximum positive jitter delay from the destination to the source

Positive SD Number

Number of positive jitter delays from the source to the destination

Positive DS Number

Number of positive jitter delays from the destination to the source

Positive SD Sum

Sum of positive jitter delays from the source to the destination

Positive DS Sum

Sum of positive jitter delays from the destination to the source

Positive SD average

Average of positive jitter delays from the source to the destination

Positive DS average

Average of positive jitter delays from the destination to the source

Positive SD Square Sum

Sum of the square of positive jitter delays from the source to the destination

Positive DS Square Sum

Sum of the square of positive jitter delays from the destination to the source

Min Negative SD

Minimum absolute value of negative jitter delays from the source to the destination

Min Negative DS

Minimum absolute value of negative jitter delays from the destination to the source

Max Negative SD

Maximum absolute value of negative jitter delays from the source to the destination

Max Negative DS

Maximum absolute value of negative jitter delays from the destination to the source

Negative SD Number

Number of negative jitter delays from the source to the destination

Negative DS Number

Number of negative jitter delays from the destination to the source

Negative SD Sum

Sum of absolute values of negative jitter delays from the source to the destination

Negative DS Sum

Sum of absolute values of negative jitter delays from the destination to the source

Negative SD average

Average of negative jitter delays from the source to the destination

Negative DS average

Average of negative jitter delays from the destination to the source

Negative SD Square Sum

Sum of the square of negative jitter delays from the source to the destination

Negative DS Square Sum

Sum of the square of negative jitter delays from the destination to the source

SD lost packets number

Number of lost packets from the source to the destination

DS lost packet number

Number of lost packets from the destination to the source

Unknown result lost packet number

Number of lost packets for unknown reasons

 

# Display the result of the test group with the administrator name being administrator, and the operation tag being dns.

[Sysname] display hwping results administrator dns

HWPing entry(admin administrator, tag dns) test result:

      Destination ip address:10.2.2.2

      Send operation times: 10              Receive response times: 10

      Min/Max/Average Round Trip Time: 6/10/8

      Square-Sum of Round Trip Time: 756

      Last succeeded test time: 2006-11-28 11:50:40.9

  Extend result:

      SD Maximal delay: 0                   DS Maximal delay: 0

      Packet lost in test: 0%

      Disconnect operation number: 0        Operation timeout number: 0

      System busy operation number: 0       Connection fail number: 0

      Operation sequence errors: 0          Drop operation number: 0

      Other operation errors: 0

    Dns result:

      DNS Resolve Current Time: 10         DNS Resolve Min Time: 6

      DNS Resolve Times: 10                DNS Resolve Max Time: 10

      DNS Resolve Timeout Times: 0         DNS Resolve Failed Times: 0

Table 1-6 Description on the fields of the display hwping result command

Field

Description

DNS Resolve Current Time

Time used for the current DNS resolution

DNS Resolve Min Time

Minimum time used for a DNS resolution

DNS Resolve Times

Number of DNS resolutions

DNS Resolve Max Time

Maximum time used for a DNS resolution

DNS Resolve Timeout Times

DNS resolution timeout times

DNS Resolve Failed Times

Number of failed DNS resolutions

 

&  Note:

The description on a specific field is available for the test results of all types of tests, so that not the description on the output information of all types of tests is provided here.

 

1.1.6  dns-server

Syntax

dns-server ip-address

undo dns-server

View

HWPing test group view

Parameters

ip-address: IP address to be assigned to a domain name server (DNS).

Description

Use the dns-server command to configure the IP address of a DNS server.

Use the undo dns-server command to remove the IP address of a DNS server.

By default, no DNS server IP address is configured.

 

&  Note:

l      This command applies to DNS and HTTP tests only.

l      For an HTTP test, if configuring the destination address as the host name, you must configure the IP address of the DNS server to resolve the host name into an IP address, which is the destination IP address of this HTTP test

 

Examples

# Set 192.168.1.1 as the IP address of the DNS server.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping administrator dns

[Sysname-hwping-administrator-dns] test-type dns

[Sysname-hwping-administrator-dns] dns-server 192.168.1.1

1.1.7  dns resolve-target

Syntax

dns resolve-target domain-name

undo dns resolve-target

View

HWPing test group view

Parameters

domain-name: Domain name to be resolved, in the range of 1 to 60 characters.

Description

Use the dns resolve-target command to configure a domain name to be resolved.

Use the undo resolve-target command to remove a domain name to be resolved.

By default, no dns resolve-target information is configured.

 

&  Note:

This command applies to DNS tests only.

 

Examples

# Configure the domain name to be resolved as www.test.com.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping administrator