Table of Contents

1 HWPing Commands· 1-1

HWPing Client Commands· 1-1

count 1-1

datasize· 1-1

destination-ip· 1-2

destination-port 1-3

display hwping· 1-4

dns-server 1-10

dns resolve-target 1-10

filename· 1-11

frequency· 1-12

ftp-operation· 1-13

history-records· 1-13

http-operation· 1-14

http-string· 1-15

hwping· 1-15

hwping-agent enable· 1-16

jitter-interval 1-16

jitter-packetnum·· 1-17

password· 1-18

probe-failtimes· 1-19

send-trap· 1-19

source-interface· 1-20

source-ip· 1-21

source-port 1-22

test-type· 1-23

test-enable· 1-23

test-failtimes· 1-24

timeout 1-25

tos· 1-25

username· 1-26

HWPing Server Commands· 1-27

hwping-server enable· 1-27

hwping-server tcpconnect 1-28

hwping-server udpecho· 1-28

 

HWPing Client Commands

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

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

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 a HWPing test.

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

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

Related commands: destination-port.

 

 

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

destination-port

Syntax

destination-port port-number

undo destination-port

View

HWPing test group view

Parameters

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

Description

Use the destination-port command to configure a destination port number for a 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.

 

 

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

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 result of the test group with the administrator name being administrator, and the operation tag being 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

Field	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 result of the test group with the administrator name being administrator, and the operation tag being 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 result of the test group with the administrator name being administrator, and the operation tag being 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

 

 

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.

 

 

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

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.

 

 

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 dns

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

[Sysname-hwping-administrator-dns] dns resolve-target www.test.com

filename

Syntax

filename file-name

undo filename

View

HWPing test group view

Parameters

file-name: Name of the file to be downloaded/uploaded in FTP tests, a string of 1 to 255 characters.

Description

Use the filename command to specify a file to be downloaded/uploaded in FTP tests.

Use the undo filename command to remove the configured file name.

By default, no file name is configured for FTP tests.

Related commands: username, password, and ftp-operation.

 

 

Examples

# Specify to transmit “config.txt” between HWPing client and FTP server in an FTP test.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping administrator ftp

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

[Sysname-hwping-administrator-ftp] filename config.txt

frequency

Syntax

frequency interval

undo frequency

View

HWPing test group view

Parameters

interval: Automatic test interval in seconds. It ranges from 0 to 65,535.

Description

Use the frequency command to configure the time interval of performing automatic tests.

Use the undo frequency command to restore the default.

If interval is configured greater than 0, the system performs automatic tests at this interval.

interval defaults to 0, which means no automatic test is performed by default.

Related commands: count.

 

 

Examples

# Set the automatic test interval to 10 seconds in an ICMP test.

<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

[Sysname-hwping-administrator-icmp] frequency 10

ftp-operation

Syntax

ftp-operation { get | put }

View

HWPing test group view

Parameters

get: Specifies the test operation as download from the FTP server.

put: Specifies the test operation as upload to the FTP server.

Description

Use the ftp-operation command to configure the FTP operation mode, which can be get and put.

By default, the FTP operation mode is get.

Related commands: username, password.

 

 

Examples

# Set the FTP operation mode to put in an FTP test.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping administrator ftp

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

[Sysname-hwping-administrator-ftp] ftp-operation put

history-records

Syntax

history-records number

undo history-records

View

HWPing test group view

Parameters

Number: Maximum number of history records that can be saved in a test group, in the range of 0 to 50, and 50 by default.

Description

Use the history-records command to set the maximum number of history records that can be saved in a test group.

Use the undo history-records to restore the default.

By default, up to 50 records can be saved in a test group.

Examples

# Set the maximum number of history records that can be saved 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] history-records 10

http-operation

Syntax

http-operation { get | post }

View

HWPing test group view

Parameters

get: Specifies the test operation to be download from the HTTP server.

post: Specifies the test operation to be uploaded to the HTTP server.

Description

Use the http-operation command to configure the HTTP operation mode.

By default, the HTTP operation mode is get.

 

 

Examples

# Set the HTTP operation mode to post in an HTTP test.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping administrator http

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

[Sysname-hwping-administrator-http] http-operation post

http-string

Syntax

http-string string version

undo http-string

View

HWPing test group view

Parameters

string: HTTP operation string used to specify the webpage to be accessed, in the range 1 to 255 characters.

version: HTTP version, in the range 1 to 255 characters. At present, this argument can only be HTTP/1.0, where HTTP must be capitalized.

Description

Use the http-string command to configure the HTTP operation string and version in an HTTP test.

Use the undo http-string command to remove the configured HTTP operation string and version.

By default, HTTP operation string and version are not configured.

Note that the http-string command applies to HTTP tests only.

Related commands: http-operation.

Examples

# Set the webpage to be accessed by an HTTP test as /index.htm and the HTTP version as HTTP/1.0.

<Sysname> system-view

[Sysname] hwping administrator http

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

[Sysname-hwping-administrator-http] http-string /index.htm HTTP/1.0

hwping

Syntax

hwping administrator-name operation-tag

undo hwping administrator-name operation-tag

View

System view

Parameters

administrator-name: Name of the administrator to create a HWPing test group, a string of 1 to 32 characters.

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

Description

Use the hwping command to create a HWPing test group and enter HWPing test group view. If the specified HWPing test group already exists, this command leads you to HWPing test group view directly.

Use the undo hwping command to delete the test group.

Examples

# Create a HWPing test group of which the administrator name is “administrator” and operation tag is “ICMP”.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping administrator icmp

[Sysname-hwping-administrator-icmp]

hwping-agent enable

Syntax

hwping-agent enable

undo hwping-agent enable

View

System view

Parameters

None

Description

Use the hwping-agent enable command to enable the HWPing client function.

Use the undo hwping-agent enable command to disable the HWPing client function.

By default, the HWPing client function is disabled.

You can perform tests only after you enable the HWPing client function.

Related commands: hwping-server enable.

Examples

# Enable HWPing client.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping-agent enable

jitter-interval

Syntax

jitter-interval interval

undo jitter-interval

View

HWPing test group view

Parameters

interval: Interval in milliseconds between jitter test packets. The value is in the range of 10 to 1000.

Description

Use the jitter-interval command to configure the interval between sending jitter test packets.

Use the undo jitter-interval command to restore the default.

By default, the interval between sending jitter test packets is 20 milliseconds.

Related commands: jitter-packetnum.

 

 

Examples

# Set the interval between sending jitter test packets to 30 milliseconds.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping administrator jitter

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

[Sysname-hwping-administrator-jitter] jitter-interval 30

jitter-packetnum

Syntax

jitter-packetnum number

undo jitter-packetnum

View

HWPing test group view

Parameters

number: Number of packets to be transmitted in one probe for a jitter test, in the range of 10 to 100.

Description

Use the jitter-packetnum command to configure the number of packets to be sent in one probe for a jitter test.

Use the undo jitter-packetnum command to restore the default.

By default, 10 packets are sent in a probe for a jitter test.

Related commands: jitter-interval.

 

 

Examples

# Configure to send 30 packets in a probe for a jitter test.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping administrator jitter

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

[Sysname-hwping-administrator-jitter] jitter-packetnum 30

password

Syntax

password password

undo password

View

HWPing test group view

Parameters

password: Password for logging in to an FTP server, a string of 1 to 32 characters.

Description

Use the password command to configure a password for logging in to the FTP server.

Use the undo password command to remove the configured password.

By default, the password for logging in to the FTP server is not configured.

Related commands: username and ftp-operation.

 

 

Examples

# Configure the password for logging into the FTP server as “hwping” in an FTP test.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping administrator ftp

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

[Sysname-hwping-administrator-ftp] password hwping

probe-failtimes

Syntax

probe-failtimes times

undo probe-failtimes

View

HWPing test group view

Parameters

times: Number of consecutive failed probes, in the range of 1 to 15.

Description

Use the probe-failtimes command to configure the number of consecutive times the probe fails before the switch sends out a trap message.

Use the undo probe-failtimes command to restore the default.

By default, the switch sends a trap about probe failure each time when a probe fails.

Examples

# Configure the switch to send a trap after the probe in an ICMP test fails for three consecutive times.

<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] probe-failtimes 3

send-trap

Syntax

send-trap { all | { probefailure | testcomplete | testfailure }* }

undo send-trap { all | { probefailure | testcomplete | testfailure }* }

View

HWPing test group view

Parameters

probefailure: Sends a trap when a probe fails.

testcomplete: Sends a trap after a test is finished.

testfailure: Sends a trap when a test fails.

all: Sends a trap when any of the above-mentioned scenarios occurs.

Description

Use the send-trap command to enable debugging for a trap.

Use the undo send-trap command to disable debugging for a trap.

By default, no trap is output.

Examples

# Send a trap message after an ICMP test is finished.

<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] send-trap testcomplete

source-interface

Syntax

source-interface interface-type interface-number

undo source-interface

View

HWPing test group view

Parameters

interface-type interface-number: Interface type and interface number.

Description

For ICMP tests, use the source-interface command to specify a source interface for sending ICMP requests. The corresponding IP address of the specified interface is used as the source IP address of ICMP requests. For DHCP tests, use the source-interface command to specify an interface for DHCP probes.

For ICMP tests, use the undo source-interface command to remove the specified source interface, and its corresponding IP address is no longer used as the source IP address of ICMP requests. For DHCP tests, use the undo source-interface command to remove the specified interface for DHCP probes.

By default, no source interface is specified for ICMP tests and no interface is configured for DHCP probes.

 

 

Examples

# Configure the source interface that sends test packets in DHCP tests as Vlan-interface 1.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping administrator dhcp

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

[Sysname-hwping-administrator-dhcp] source-interface Vlan-interface 1

source-ip

Syntax

source-ip ip-address

undo source-ip

View

HWPing test group view

Parameters

ip-address: Source IP address for a test.

Description

Use the source-ip command to configure the source IP address for the test.

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

By default, the IP address of the interface that sends test packets serves as the source IP address.

 

 

Examples

# Configure the source IP address as 169.254.10.2 for this ICMP test.

<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] source-ip 169.254.10.2

source-port

Syntax

source-port port-number

undo source-port

View

HWPing test group view

Parameters

port-number: Protocol source port number, in the range of 1 to 65,535.

Description

Use the source-port command to configure the protocol source port number for the current test.

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

 

 

Examples

# Configure the source port number as 8000 for this HTTP test.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping administrator http

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

[Sysname-hwping-administrator-http] source-port 8000

test-type

Syntax

test-type type

View

HWPing test group view

Parameters

type: Test type. It can be any of the following keywords:

l          dhcp: Indicates a DHCP test.

l          dns: Indicates a DNS test.

l          ftp: Indicates an FTP test.

l          http: Indicates an HTTP test.

l          icmp: Indicates an ICMP test.

l          jitter: Analyzes the delay change of UDP packet transmission.

l          snmpquery: Indicates an SNMP test.

l          tcpprivate: Indicates a TCP test on a specified (unknown) port.

l          tcppublic: Indicates a TCP test on port 7.

l          udpprivate: Indicates a UDP test on a specified (unknown) port.

l          udppublic: Indicates a UDP test on port 7.

Description

Use the test-type command to configure the test type. The default type is icmp.

Examples

# Configure the test type as an FTP test.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping administrator ftp

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

test-enable

Syntax

test-enable

undo test-enable

View

HWPing test group view

Parameters

None

Description

Use the test-enable command to enable a HWPing test.

Use the undo test-enable command to disable a HWPing test.

Related commands: display hwping.

 

 

Examples

# Perform a HWPing test on an ICMP test group with the administrator name and operation tag being administrator and icmp respectively.

<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

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

test-failtimes

Syntax

test-failtimes times

undo test-failtimes

View

HWPing test group view

Parameters

times: Number of times of consecutive test failure, in the range of 1 to 15.

Description

Use the test-failtimes command to configure the number of consecutive times a HWPing test fails before the switch sends out a trap message.

Use the undo test-failtimes command to restore the default.

By default, the switch sends a trap about test failure each time when a test fails.

Examples

# Configure the switch to send out a trap message after an ICMP test fails for three consecutive times.

<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] test-failtimes 3

timeout

Syntax

timeout time

undo timeout

View

HWPing test group view

Parameters

time: Timeout time for one probe, in the range of 1 to 60, in seconds.

Description

Use the timeout command to set the timeout time for a probe. That is, the value of the probe timer that is started after the HWPing client sends out a test packet.

Use the undo timeout command to restore the default value.

The HWPing client starts the probe timer after sending a test packet. If the HWPing client receives no response before the timer expires, it considers that the current probe has timed out.

By default, the probe timeout time is 3 seconds.

Examples

# Set the timeout time for one probe in an ICMP test to 10 seconds.

<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] timeout 10

tos

Syntax

tos value

undo tos

View

HWPing test group view

Parameters

value: ToS value in a HWPing test packet header, in the range of 0 to 255.

Description

Use the tos command to configure the ToS value in a HWPing test packet header.

Use the undo tos command to remove the ToS value in a HWPing test packet header.

By default, no ToS value is configured.

 

 

Examples

# Set the ToS value in the header of an ICMP test packet to 1.

<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] tos 1

username

Syntax

username name

undo username

View

HWPing test group view

Parameters

name: Username for logging in to an FTP server, a string of 1 to 32 characters.

Description

Use the username command to configure a username for logging in to the FTP server.

Use the undo username command to remove the configured username.

By default, no username for logging in to the FTP server is configured.

Related commands: password and ftp-operation.

 

 

Examples

# Configure the username for logging into the FTP server in an FTP test as “administrator”.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping administrator ftp

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

[Sysname-hwping-administrator-ftp] username administrator

HWPing Server Commands

 

 

hwping-server enable

Syntax

hwping-server enable

undo hwping-server enable

View

System view

Parameters

None

Description

Use the hwping-server enable command to enable the HWPing server function.

Use the undo hwping-server enable command to disable the HWPing server function.

By default, the HWPing server function is disabled.

Related commands: hwping-agent enable, hwping-server tcpconnect, hwping-server udpecho.

Examples

# Enable a HWPing server.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping-server enable

hwping-server tcpconnect

Syntax

hwping-server tcpconnect ip-address port-number

undo hwping-server tcpconnect ip-address port-number

View

System view

Parameters

ip-address: IP address specified for a TCP listening service on the HWPing server.

port-number: Port number specified for a TCP listening service on the HWPing server. The value ranges from 1 to 65535. It is not recommended to use the ports with a number greater than 50000 or some special ports (that is, those used for fixed functions, such as port 1701). Otherwise, the HWPing test may fail.

Description

Use the hwping-server tcpconnect command to create a TCP listening service on the HWPing server.

Use the undo hwping-server tcpconnect command to remove the created TCP listening service.

When performing a TCP connection test on a specified port of a HWPing client, you must create a TCP listening on the HWPing server if the server is an H3C S3100 series Ethernet switch; otherwise, the TCP test may fail.

Related commands: hwping-server enable.

 

 

Examples

# Enable TCP listening, using 169.254.10.2 as the IP address and 9000 as the port number.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping-server tcpconnect 169.254.10.2 9000

hwping-server udpecho

Syntax

hwping-server udpecho ip-address port-number

undo hwping-server udpecho ip-address port-number

View

System view

Parameters

ip-address: IP address from which a HWPing server performs UDP listening.

port-number: Port from which a HWPing server performs UDP listening. The value ranges from 1 to 65535. In is not recommended to use a port with a number greater than 50000 or some special ports (that is, those used for fixed functions, such as port 1701). Otherwise, the HWPing test may fail.

Description

Use the hwping-server udpecho command to enable UDP listening on a HWPing server.

Use the undo hwping-server udpecho command to disable UDP listening.

When performing a jitter test or a UDP connection test on a specified port of a HWPing client, you must enable UDP listening on the server if an S3100 switch serves as a HWPing server; otherwise, the test may fail.

Related commands: hwping-server enable.

 

 

Examples

# Enable UDP listening, using 169.254.10.2 as the IP address and 9000 as the port number.

<Sysname> system-view

System View: return to User View with Ctrl+Z

[Sysname] hwping-server udpecho 169.254.10.2 9000