- Table of Contents
-
- H3C WX3000 Series Unified Switches Switching Engine Command Reference-6W103
- 00-Preface
- 01-CLI Command
- 02-Login Command
- 03-Configuration File Management Command
- 04-VLAN Command
- 05-Auto Detect Command
- 06-Voice VLAN Command
- 07-GVRP Command
- 08-Basic Port Configuration Command
- 09-Link Aggregation Command
- 10-Port Isolation Command
- 11-Port Security-Port Binding Command
- 12-DLDP Command
- 13-MAC Address Table Management Command
- 14-MSTP Command
- 15-802.1x and System Guard Command
- 16-AAA Command
- 17-MAC Address Authentication Command
- 18-IP Address and Performance Command
- 19-DHCP Command
- 20-ACL Command
- 21-QoS-QoS Profile Command
- 22-Mirroring Command
- 23-ARP Command
- 24-SNMP-RMON Command
- 25-Multicast Command
- 26-NTP Command
- 27-SSH Command
- 28-File System Management Command
- 29-FTP-SFTP-TFTP Command
- 30-Information Center Command
- 31-System Maintenance and Debugging Command
- 32-VLAN-VPN Command
- 33-HWPing Command
- 34-DNS Command
- 35-Smart Link-Monitor Link Command
- 36-PoE-PoE Profile Command
- 37-Routing Protocol Command
- 38-UDP Helper Command
- 39-Index
- Related Documents
-
Title | Size | Download |
---|---|---|
33-HWPing Command | 173.35 KB |
Table of Contents
HWPing Client Commands
count
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.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator icmp
[device-hwping-administrator-icmp] test-type icmp
[device-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 |
Default |
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.
<device> system-view
System View: return to User View with Ctrl+Z.
[device] hwping administrator icmp
[device-hwping-administrator-icmp] test-type icmp
[device-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 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.
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.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator icmp
[device-hwping-administrator-icmp] test-type icmp
[device-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 an HWPing test, in the range of 1 to 50000.
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.
l The destination-port command has effect on jitter, TCP-Private, and UDP-Private tests only.
l You are not recommended to perform a TCP, UDP, or jitter test to a known port (ports with a number ranging from 1 to 1023). Otherwise, the HWPing test will fail or the corresponding service of the port will become unavailable.
Examples
# Set the destination port number for a tcpprivate test to 9000.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator tcp
[device-hwping-administrator-tcp] test-type tcpprivate
[device-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.
[device-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 display hwping result command output description
Filed |
Description |
Destination ip address |
Destination IP address |
Send operation times |
Number of probes made |
Receive responds times |
Number of received response packets |
Min/Max/Average Round Trip Time |
Minimum/maximum/average roundtrip time |
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.
[device-hwping-administrator-icmp] display hwping history administrator icmp
HWPing entry(admin administrator, tag icmp) history record:
Index Response Status LasrRC 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 display hwping history command output description
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 |
LasrRC |
Last response code received (this code is based on the specific implementation). With ICMP echo enabled on the system, receiving ICMP response which includes ICMP_ECHOREPLY(0) indicates the probe succeeds. ICMP response is often defined in a file including ip_icmp. |
Time |
Test completion time |
# Display the result of the test group with the administrator name being administrator, and the operation tag being http.
[device-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: 10
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 display hwping result command output description
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.
[device-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 display hwping result command output description
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.
[device] 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 display hwping result command output description
Field |
Description |
DNS Resolve Current Time |
Default time used for a 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 |
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.
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.
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.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator dns
[device-hwping-administrator-dns] test-type dns
[device-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.
This command applies to DNS tests only.
Examples
# Configure the domain name to be resolved as www.test.com.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator dns
[device-hwping-administrator-dns] test-type dns
[device-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 230 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.
The filename command applies to FTP tests only.
Examples
# Specify to transmit “config.txt” between HWPing client and FTP server in an FTP test.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator ftp
[device-hwping-administrator-ftp] test-type ftp
[device-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.
The frequency command does not apply to DHCP tests.
Examples
# Set the automatic test interval to 10 seconds in an ICMP test.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator icmp
[device-hwping-administrator-icmp] test-type icmp
[device-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.
The ftp-operation command applies to FTP tests only.
Examples
# Set the FTP operation mode to put in an FTP test.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator ftp
[device-hwping-administrator-ftp] test-type ftp
[device-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.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator icmp
[device-hwping-administrator-icmp] test-type icmp
[device-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.
The http-operation command applies to HTTP tests only.
Examples
# Set the HTTP operation mode to post in an HTTP test.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator http
[device-hwping-administrator-http] test-type http
[device-hwping-administrator-http] http-operation post
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 an 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 an HWPing test group of which the administrator name is “administrator” and operation tag is “ICMP”.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator icmp
[device-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.
<device> system-view
System View: return to User View with Ctrl+Z
[device] 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.
The jitter-interval command applies to jitter tests only.
Examples
# Set the interval between sending jitter test packets to 30 milliseconds.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator jitter
[device-hwping-administrator-jitter] test-type jitter
[device-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 1000.
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.
This command applies to jitter tests only.
Examples
# Configure to send 30 packets in a probe for a jitter test.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator jitter
[device-hwping-administrator-jitter] test-type jitter
[device-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.
l To perform an FTP test successfully, the configured password must be consistent with the FTP user password configured on the server.
l This command applies to FTP tests only.
Examples
# Configure the password for logging into the FTP server as “hwping” in an FTP test.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator ftp
[device-hwping-administrator-ftp] test-type ftp
[device-hwping-administrator-ftp] password hwping
probe-failtimes
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 device sends out a trap message.
Use the undo probe-failtimes command to restore the default.
By default, the device sends a trap about probe failure each time when a probe fails.
Examples
# Configure the device to send a trap after the probe in an ICMP test fails for three consecutive times.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator icmp
[device-hwping-administrator-icmp] test-type icmp
[device-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.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator icmp
[device-hwping-administrator-icmp] test-type icmp
[device-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.
l For DHCP tests, this command is required. For ICMP tests, this command is optional. This command does not apply to other tests.
l For ICMP tests, if no IP address is configured for the specified source interface, the ICMP test will be failed. if a source IP address has been configured with the source-ip command, the source-interface command cannot change the configured IP address.
l The interface to be specified in this command can be only a VLAN interface.
l The interface to be specified must be Up; otherwise the test will fail.
Examples
# Configure the source interface that sends test packets in DHCP tests as Vlan-interface 1.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator dhcp
[device-hwping-administrator-dhcp] test-type dhcp
[device-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.
l For FTP tests, this command is required. This command does not apply to DHCP tests. For other tests, this command is optional.
l The specified source IP address by this command cannot be of an interface on a remote device, and the interface must be Up; otherwise the test will fail.
Examples
# Configure the source IP address as 169.254.10.2 for this ICMP test.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator icmp
[device-hwping-administrator-icmp] test-type icmp
[device-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: Source port number, in the range of 1 to 65,535.
Description
Use the source-port command to configure the source port number for this test.
Use the undo source-port command to remove the configured source port number.
This command does not apply to ICMP, DHCP, and DNS tests.
Examples
# Configure the source port number as 8000 for this ICMP test.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator icmp
[device-hwping-administrator-icmp] test-type icmp
[device-hwping-administrator-icmp] 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.
The default type is icmp.
Description
Use the test-type command to configure the test type.
Examples
# Configure the test type as an FTP test.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator ftp
[device-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.
The result of the HWPing test cannot be displayed automatically, and you need to use the display hwping command to display the test result.
Examples
# Perform a HWPing test on an ICMP test group with the administrator name and operation tag being administrator and icmp respectively.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator icmp
[device-hwping-administrator-icmp] test-type icmp
[device-hwping-administrator-icmp] destination-ip 169.254.10.3
[device-hwping-administrator-icmp] test-enable
test-failtimes
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 device sends out a trap message.
Use the undo test-failtimes command to restore the default.
By default, the device sends a trap about test failure each time when a test fails.
Examples
# Configure the device to send out a trap message after an ICMP test fails for three consecutive times.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator icmp
[device-hwping-administrator-icmp] test-type icmp
[device-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.
By default, the probe timeout time is 3 seconds.
Examples
# Set the timeout time for one probe in an ICMP test to 10 seconds.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator icmp
[device-hwping-administrator-icmp] test-type icmp
[device-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.
This command does not apply to DHCP tests.
Examples
# Set the ToS value in the header of an ICMP test packet to 1.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator icmp
[device-hwping-administrator-icmp] test-type icmp
[device-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.
l To perform an FTP test successfully, the configured username must be consistent with the username configured on the FTP server.
l This command applies to FTP tests only.
Examples
# Configure the username for logging into the FTP server in an FTP test as “administrator”.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping administrator ftp
[device-hwping-administrator-ftp] test-type ftp
[device-hwping-administrator-ftp] username administrator
HWPing Server Commands
l A HWPing server is required for only jitter, TCP, and UDP tests.
l You are not recommended to configure HWPing jitter/UDP/TCP servers on ports 1 through 1023 (well-known ports); otherwise, HWPing probes may fail or the services corresponding to these ports may be unavailable.
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 udpconnect.
Examples
# Enable a HWPing server.
<device> system-view
System View: return to User View with Ctrl+Z
[device] 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 from which a HWPing server performs TCP listening.
port-number: Port from which a HWPing server performs TCP listening. The value ranges from 1 to 50000.
Description
Use the hwping-server tcpconnect command to enable TCP listening.
Use the undo hwping-server tcpconnect command to disable TCP listening.
When performing a TCP connection test on a specified port of a HWPing client, you must enable TCP listening on the server if a device serves as a HWPing server; otherwise, the test may fail.
Related commands: hwping-server enable.
The port number used by HWPing server for TCP listening cannot be set to a special port number that is for a fixed function, such as 1701.
Examples
# Enable TCP listening, using 169.254.10.2 as the IP address and 9000 as the port number.
<device> system-view
System View: return to User View with Ctrl+Z
[device] 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 49999.
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 a device serves as a HWPing server; otherwise, the test may fail.
Related commands: hwping-server enable.
The port number used by HWPing server for UDP listening cannot be set to a special port number that is for a fixed function, such as 1701.
Examples
# Enable UDP listening, using 169.254.10.2 as the IP address and 9000 as the port number.
<device> system-view
System View: return to User View with Ctrl+Z
[device] hwping-server udpecho 169.254.10.2 9000