Table of Contents

Chapter 1 HWPing Commands. 1-1

1.1 HWPing Commands. 1-1

1.1.1 count 1-1

1.1.2 destination-ip. 1-1

1.1.3 display hwping. 1-2

1.1.4 frequency. 1-5

1.1.5 hwping. 1-6

1.1.6 hwping-agent enable. 1-7

1.1.7 test-enable. 1-7

1.1.8 test-type. 1-8

1.1.9 timeout 1-8

 

Chapter 1  HWPing Commands

1.1  HWPing Commands

1.1.1  count

Syntax

count times

undo count

View

HWPing test group view

Parameter

times: Number of the test packets to be sent in each test. It is in the range 1 to 15 and defaults to 1.

Description

Use the count command to configure the number of packets to be sent in each test.

Use the undo count command to restore the default.

If this parameter is set to a number greater than 1, the system sends the second test packet once it receives a response to the first one, or when the test timer times out if it receives no response after sending the first one, and so forth until the last test packet is sent out.

Related command: frequency.

Example

# Set the “administrator-icmp” test group to send 10 packets in each test.

<H3C> system-view

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

[H3C] hwping administrator icmp

[H3C-hwping-administrator-icmp] count 10

1.1.2  destination-ip

Syntax

destination-ip ip-address

undo destination-ip

View

HWPing test group view

Parameter

ip-address: Destination IP address in a test.

Description

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

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

Example

# Set the destination IP address in the test of the “administrator-icmp” test group to 1.1.1.99.

<H3C> system-view

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

[H3C] hwping administrator icmp

[H3C-hwping-administrator-icmp] destination-ip 1.1.1.99

1.1.3  display hwping

Syntax

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

View

Any view

Parameter

results: Specifies to display the test results.

history: Specifies to display the test history.

administrator-name: Name of the administrator creating the test.

operation-tag: Test operation tag.

Description

Use the display hwping command to view test result(s).

If a test group is specified using the arguments of administrator-name and test-operation-tag, the system displays only the test result of the group; if not, it displays the test results of all the test groups.

Related command: test-enable.

Example

# Use the display hwping results command to display the test result of the test group whose administrator name is “administrator” and operation tag is “icmp”.

<H3C> display hwping results administrator icmp

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

      Destination ip address:1.1.1.99

      Send operation times: 10              Receive response times: 10

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

      Square-Sum of Round Trip Time: 66

      Last complete test time: 2000-4-2 7:59:54.7

  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-1 Description on the fields of the display hwping results command

Field	Description
Destination ip address	Destination IP address
Send operation times	Number of send operations
Receive response times	Number of successful test operations
Min/Max/Average Round Trip Time	Smallest/biggest/average round-trip time
Square-Sum of Round Trip Time	The square sum of the round trip time
Last complete test time	Time of the last successful test
SD Maximal delay	Maximal delay from the source to the destination
DS Maximal delay	Maximal delay from the destination to the source
Packet lost in test	Packet lost ratio in the test.
Disconnect operation number	Number of forced disconnections by the opposite side
Operation timeout number	Number of timeout times in the test operation
System busy operation number	Number of test failures because the system is busy
Connection fail number	Number of connection failures
Operation sequence errors	Number of received sequence error packets
Drop operation number	Number of system resource allocation errors
Other operation errors	Number of other errors

 

# Use the display hwping history command to display test results.

<H3C> 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-2 Description on the fields of the display hwping history command

Field	Description
Index	Index of the displayed information
Response	Round trip test time, in milliseconds, or the timeout time. 0 means the test fails.
Status	Value of the test result. See the following detailed description: 1: responceReceived. It means response is received. 2: unknown. It means unknown error. 3: internalError. It means system internal error. 4: requestTimeOut. It means timeout before response. 5: unknownDestinationAddress. It means the destination address is unknown. 6: noRouteToTarget. It means there is no route to the destination address. 7: interfaceInactiveToTarget. It means the interface of destination address is not activated. 8: arpFailure. It means ARP operation fails. 9: maxConcurrentLimitReached. It means the maximum limit of concurrent accesses is reached. 10: unableToResolveDnsName. It means it is unable to resolve the DNS name. 11: invalidHostAddress. It means the invalid host address.
LastRC	Receive the last response code based on the implementation ways. With ICMP echo enabled, if the system receives ICMP response which includes ICMP_ECHOREPLY(0), the probe has succeeds. ICMP response often defined in the file containing ip_icmp.
Time	Test time

 

1.1.4  frequency

Syntax

frequency interval

undo frequency

View

HWPing test group view

Parameter

interval: Automatic test interval. It ranges from 0 to 65535 seconds and defaults to 0 seconds which means no automatic test.

Description

Use the frequency command to configure an automatic test interval.

Use the undo frequency command to disable automatic test.

The system automatically tests at intervals specified by this command, where the argument interval is greater than 0.

Related command: count.

Example

# Set the automatic test interval of the “administrator-icmp” test group to 10 seconds.

<H3C> system-view

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

[H3C] hwping administrator icmp

[H3C-hwping-administrator-icmp] frequency 10

1.1.5  hwping

Syntax

hwping administrator-name operation-tag

undo hwping administrator-name operation-tag

View

System view

Parameter

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

operation-tag: Test 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..

Use the undo hwping command to remove the HWPing test group.

Example

# Create an HWPing test group, where the administrator name is “administrator” and the test operation tag is “icmp”.

<H3C> system-view

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

[H3C] hwping administrator icmp

[H3C-hwping-administrator-icmp]

1.1.6  hwping-agent enable

Syntax

hwping-agent enable

undo hwping-agent enable

View

System view

Parameter

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.

Before you can perform a test, you must enable the HWPing client function.

Example

# Enable HWPing client.

<H3C> system-view

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

[H3C] hwping-agent enable

1.1.7  test-enable

Syntax

test-enable

undo test-enable

View

HWPing test group view

Parameter

None

Description

Use the test-enable command to execute an HWPing test.

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

 

 

Related command: display hwping.

Example

# Execute the HWPing test defined by the test group “administrator-icmp”.

<H3C> system-view

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

[H3C] hwping administrator icmp

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

1.1.8  test-type

Syntax

test-type type

View

HWPing test group view

Parameter

type: Test type.

Description

Use the test-type command to configure the type of the test.

Currently the system only supports ICMP test.

Example

# Set the test type of the “administrator-icmp” test group to ICMP.

<H3C> system-view

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

[H3C] hwping administrator icmp

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

1.1.9  timeout

Syntax

timeout time

undo timeout

View

HWPing test group view

Parameter

time: Timeout time. It ranges from 1 to 60 seconds and defaults to 3 seconds.

Description

Use the timeout command to configure a timeout time for a test.

Use the undo timeout command to restore to the default timeout time.

Example

# Set the timeout time of the “administrator-icmp” test group to 10 seconds.

<H3C> system-view

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

[H3C] hwping administrator icmp

[H3C-hwping-administrator-icmp] timeout 10