Table of Contents

Chapter 1 NQA Configuration Commands. 1-1

1.1 NQA Client Commands. 1-1

1.1.1 count 1-1

1.1.2 datafill 1-2

1.1.3 datasize. 1-3

1.1.4 debugging nqa. 1-3

1.1.5 description. 1-4

1.1.6 destination-ip. 1-5

1.1.7 destination-port 1-6

1.1.8 display nqa. 1-7

1.1.9 filename. 1-11

1.1.10 frequency. 1-12

1.1.11 ftp-operation. 1-13

1.1.12 history-records. 1-14

1.1.13 http-operation. 1-14

1.1.14 http-string. 1-15

1.1.15 jitter-interval 1-16

1.1.16 jitter-packetnum.. 1-17

1.1.17 nqa. 1-17

1.1.18 nqa-agent enable. 1-18

1.1.19 nqa-agent max-requests. 1-19

1.1.20 password. 1-20

1.1.21 probe-failtimes. 1-20

1.1.22 send-trap. 1-21

1.1.23 sendpacket passroute. 1-22

1.1.24 source-interface. 1-23

1.1.25 source-ip. 1-24

1.1.26 source-port 1-25

1.1.27 test-enable. 1-25

1.1.28 test-failtimes. 1-26

1.1.29 test-type. 1-27

1.1.30 timeout 1-28

1.1.31 tos. 1-29

1.1.32 ttl 1-29

1.1.33 username. 1-30

1.1.34 vpninstance. 1-31

1.2 NQA Server Commands. 1-32

1.2.1 nqa-server enable. 1-32

1.2.2 nqa-server tcpconnect 1-33

1.2.3 nqa-server udpecho. 1-34

 

Chapter 1  NQA Configuration Commands

1.1  NQA Client Commands

1.1.1  count

Syntax

count times

undo count

View

NQA test group view

Default Level

2: System level

Parameters

times: Number of probes in a test, in the range 1 to 15.

Description

Use the count command to configure the number of probes in a test.

Use the undo count command to restore the default.

By default, one probe is performed in a test.

For a TCP test, one probe means one connection; for a Jitter test, the number of packets sent in one probe depends on the jitter-packetnum command; for an SNMP test, three packets are sent in one probe; for other types of tests, one packet is sent for one probe.

If the number of probes in a test is greater than 1, the system sends a second packet after it sends the first packet and receives a response packet. If the system does not receive a response packet, the system waits for the test timer to expire before sending a second test packet. The process is repeated until the specified probes are completed.

Examples

# Configure the number of probes in a test as 10.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] count 10

1.1.2  datafill

Syntax

datafill text

undo datafill

View

NQA test group view

Default Level

2: System level

Parameters

text: Contents to be filled in a test packet, a string of 1 to 200 characters.

Description

Use the datafill command to configure the string of fill characters for a test packet.

Use the undo datafill command to restore the default.

By default, the string of fill characters of an ICMP packet is the string corresponding with the ASCII code 00 to 09 and that for a UDP packet is the string corresponding with the ASCII code 00 to FF.

The fill data of an NQA test packet can be any string of characters. If the test packet is smaller than the fill data, the system uses only the first part of the character string to encapsulate the packet. If the test packet is larger than the fill data, the system fills the character string cyclically to encapsulate the test packet until the packet is full. For example, when the fill data is “abcd” and the size of a test packet is 3 byte, “adc” is used to fill. When the test packet size is 6 byte, “abcdab” is used to fill.

Because the first byte of a UDP packet has some specific usage, the configured character string is used to fill the remaining bytes in the packet.

Note that the datafill command is valid for an ICMP test and a UDP test.

Examples

# Configure the string of fill characters of a test packet as abcd.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] datafill abcd

1.1.3  datasize

Syntax

datasize size

undo datasize

View

NQA test group view

Default Level

2: System level

Parameters

size: Size of a test packet in bytes, in the range of 1 to 8100.

Description

Use the datasize command to configure the size of a test packet, namely, an echo request packet (IP header, ICMP header and UDP header excluded).

Use the undo datasize command to restore the size of a test request packet to the default value.

By default, the size of an ICMP test packet is 56 bytes and that of a UDP test packet is 100 bytes.

Note that:

l           The datasize command is valid only for ICMP and UDP tests.

l           For an ICMP test, if the value of the size argument is less than 20, the system automatically fills ICMP test packets to 20 bytes with a string of fill characters.

l           When you perform a UDP test, the size of test packets is subject to the configuration.

Related commands: datafill.

Examples

# Configure the size of a test packet as 50 bytes.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] datasize 50

1.1.4  debugging nqa

Syntax

debugging nqa { all | error | event }

undo debugging nqa { all | error | event }

View

User view

Default Level

2: System level

Parameters

all: Enables all debugging for NQA.

error: Enables error debugging for NQA.

event: Enables event debugging for NQA.

Description

Use the debugging nqa command to enable NQA debugging.

Use the undo debugging nqa command to disable NQA debugging.

By default, NQA debugging is disabled.

Examples

# Enable NQA event debugging.

<Sysname> terminal debugging

<Sysname> debugging nqa event

1.1.5  description

Syntax

description text

undo description

View

NQA test group view

Default Level

2: System level

Parameters

text: Description for a test group, a string of 1 to 200 characters.

Description

Use the description command to give a brief description of a test group, usually, the test type or test purpose of a test group.

Use the undo description command to remove the description information.

By default, no descriptive string is available for a test group.

Examples

# Configure a descriptive string for a test group as icmp-test.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] description icmp-test

1.1.6  destination-ip

Syntax

destination-ip ip-address

undo destination-ip

View

NQA test group view

Default Level

2: System level

Parameters

ip-address: Destination IP address of a test request packet.

Description

Use the destination-ip command to configure a destination IP address for a test request packet.

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

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

Related commands: destination-port.

Examples

# Set the destination IP address of a test request packet to 10.1.1.1.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] destination-ip 10.1.1.1

1.1.7  destination-port

Syntax

destination-port port-number

undo destination-port

View

NQA test group view

Default Level

2: System level

Parameters

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

Description

Use the destination-port command to configure a destination port number for a test request packet.

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

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

Related commands: destination-ip.

 

 

Examples

# Set the destination port number of a test request packet to 9000.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] destination-port 9000

1.1.8  display nqa

Syntax

display nqa { results | history | jitter } [ admin-name operation-tag ]

View

Any view

Default Level

2: System level

Parameters

results: Displays the results of the last test.

history: Displays the history records of tests.

jitter: Displays the recorded delay jitter of UDP packet transmission in the last NQA jitter test.

admin-name: Name of the administrator who creates NQA test groups, a string of 1 to 32 characters.

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

Description

Use the display nqa command to display results of an NQA test or tests.

If neither of the test group arguments (admin-name and operation-tag) is specified, results of all test groups are displayed. Otherwise, results of only the specified test group(s) are displayed.

Related commands: test-enable.

Examples

# Display the results of the last test.

<Sysname> display nqa results administrator icmp

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

      Destination ip address: 169.254.10.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:

      Packet lost in test: 0%

      Failures due to Timeout: 0

      Failures due to System Busy: 0

      Failures due to Disconnect: 0

      Failures due to No Connection: 0

      Failures due to Sequence Error: 0

      Failures due to Internal Error: 0

      Failures due to Other Errors: 0

Table 1-1 display nqa results command output description

Field	Description
Destination ip address	IP address of the destination
Send operation times	Number of probe packets sent
Receive response times	Number of response packets received
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 disconnections by the peer
Failures due to Timeout	Number of time-out occurrences in a test
Failures due to System Busy	Number of test failures owing to the system being busy
Failures due to Disconnect	Number of disconnections by the peer
Failures due to No Connection	Number of failures to connect with the peer
Failures due to Sequence Error	Number of failures owing to out-of-sequence packets
Failures due to Internal Error	Number of failures owing to internal errors
Failures due to Other Errors	Number of failures owing to other errors

 

# Display the history records of tests.

<Sysname> display nqa history administrator test

  NQA entry(admin administrator, tag test) 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 display nqa history command output description

Field	Description
Index	History record number
Response	Roundtrip delay of a test packet in the case of a successful test, time-out time in the case of time-out, or 0 in the case of a test failure (in milliseconds)
Status	Status value of test results, including: 1: responseReceived 2: unknown 3: internalError 4: requestTimedOut 5: unknownDestinationAddress 6: noRouteToTarget 7: interfaceInactiveToTarget 8: arpFailure 9: maxConcurrentLimitReached 10: unableToResolveDnsName 11: invalidHostAddress
LastRC	Temporarily, this field is not supported.
Time	Time when the test is completed

 

# Display the recorded delay jitter of UDP packet transmission in the last NQA jitter test.

<Sysname> display nqa jitter admin jitter

 

  NQA entry(admin admin, tag jitter) test jitter result:

      RTT Number: 10

      SD Maximal delay: 2                  DS Maximal delay: 2

      Min Positive SD: 1                   Min Positive DS: 1

      Max Positive SD: 1                   Max Positive DS: 1

      Positive SD Number: 4                Positive DS Number: 2

      Positive SD Sum: 4                   Positive DS Sum: 2

      Positive SD average: 1               Positive DS average: 1

      Positive SD Square Sum: 4            Positive DS Square Sum: 2

      Min Negative SD: 1                   Min Negative DS: 1

      Max Negative SD: 2                   Max Negative DS: 1

      Negative SD Number: 2                Negative DS Number: 3

      Negative SD Sum: 3                   Negative DS Sum: 3

      Negative SD average: 2               Negative DS average: 1

      Negative SD Square Sum: 5            Negative DS Square Sum: 3

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

      Unknown result lost packet number: 0

Table 1-3 display nqa jitter command output description

Field	Description
RTT Number	Number of received response packets
SD Maximal delay	Maximum delay from the source to the destination
DS Maximal delay	Maximum delay from the destination to the source
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 absolute value of negative jitter delays from the source to the destination
Negative DS average	Average absolute value 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

 

1.1.9  filename

Syntax

filename file-name

undo filename

View

NQA test group view

Default Level

2: System level

Parameters

file-name: Name of the file transferred between the FTP server and the FTP client, a string of 1 to 200 characters.

Description

Use the filename command to specify a file to be transferred between the FTP server and the FTP client.

Use the undo filename command to restore the default.

By default, no file is specified.

Note that the filename command is valid only for FTP tests.

Related commands: username, password, ftp-operation.

Examples

# Specify the config.txt file to be transferred between the FTP server and the FTP client.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] filename config.txt

1.1.10  frequency

Syntax

frequency interval

undo frequency

View

NQA test group view

Default Level

2: System level

Parameters

interval: Interval of performing a cyclic test in seconds, in the range 1 to 65535.

Description

Use the frequency command to configure the interval of performing a cyclic test. After you execute the test-enable command to start an NQA test, the test will be performed at intervals.

Use the undo frequency command to restore the default.

By default, no cyclic test is performed.

Note that the frequency command is invalid for the DHCP test.

Related commands: test-enable.

Examples

# Configure the interval of performing a cyclic test as 10 seconds.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] frequency 10

1.1.11  ftp-operation

Syntax

ftp-operation { get | put }

undo ftp-operation

View

NQA test group view

Default Level

2: System level

Parameters

get: Obtains a file from the FTP server.

put: Transfers a file to the FTP server.

Description

Use the ftp-operation command to configure the FTP operation type.

Use the undo ftp-operation command to restore the default.

By default, the FTP operation type is “get” (obtain a file from the FTP server).

Note that the ftp-operation command is valid only for FTP tests.

Related commands: username, password.

Examples

# Obtain a file from the FTP server.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] ftp-operation get

1.1.12  history-records

Syntax

history-records number

undo history-records

View

NQA test group view

Default Level

2: System level

Parameters

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

Description

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

Use the undo history-records command to restore the default.

By default, the maximum number of records that can be saved in a test group is 50.

If the history records exceed the predefined maximum number, the history record of the oldest probe will be discarded.

Examples

# Set the maximum number of history records that can be saved in a test group to 10.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] history-records 10

1.1.13  http-operation

Syntax

http-operation { get | post }

undo http-operation

View

NQA test group view

Default Level

2: System level

Parameters

get: Obtains data from the HTTP server.

post: Transfers data to the HTTP server.

Description

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

Use the undo http-operation command to restore the default.

By default, the HTTP operation type is “get” (obtain data from the HTTP server).

Note that the http-operation command is valid only for HTTP tests.

Related commands: http-string.

Examples

# Obtain data from the HTTP server.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] http-operation get

1.1.14  http-string

Syntax

http-string string version

undo http-string

View

NQA test group view

Default Level

2: System level

Parameters

string: HTTP operation string, which specifies a webpage to be accessed. The length of the string argument plus that of the version argument must be less than 200 characters.

version: HTTP version. Currently, it can only be “HTTP/1.0”, where HTTP must be capital.

Description

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

Use the undo http-string command to remove the configuration of the HTTP operation string and version information.

By default, no HTTP operation string or version information is configured.

Note that the http-string command is valid only for HTTP tests.

Related commands: http-operation.

Examples

# Set the web page accessible through HTTP to /index.htm and the HTTP version to HTTP/1.0.

<Sysname> system-view

[Sysname] nqa administrator test

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

1.1.15  jitter-interval

Syntax

jitter-interval interval

undo jitter-interval

View

NQA test group view

Default Level

2: System level

Parameters

interval: Interval for sending jitter test packets in milliseconds, in the range 10 to 1,000.

Description

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

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

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

Note that the jitter-interval command is valid only for a jitter test.

Related commands: jitter-packetnum.

Examples

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

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] jitter-interval 30

1.1.16  jitter-packetnum

Syntax

jitter-packetnum number

undo jitter-packetnum

View

NQA test group view

Default Level

2: System level

Parameters

number: Number of test packets sent in a probe, in the range 10 to 100.

Description

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

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

By default, the number of test packets sent in a probe is 10.

Note that the jitter-packetnum command is valid only for a jitter test.

Related commands: jitter-interval.

Examples

# Set the number of packets sent in a probe to 30.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] jitter-packetnum 30

1.1.17  nqa

Syntax

nqa admin-name operation-tag

undo nqa admin-name operation-tag

View

System view

Default Level

2: System level

Parameters

admin-name: Name of the administrator who creates NQA test groups, a string of 1 to 32 characters.

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

Description

Use the nqa command to create an NQA test group and enter its view. If the test group already exists, you will directly enter NQA test group view when you execute the nqa command.

Use the undo nqa command to remove the test group.

Examples

# Create an NQA test group whose administrator name is administrator and whose operation tag is test and enter NQA test group view.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test]

1.1.18  nqa-agent enable

Syntax

nqa-agent enable

undo nqa-agent enable

View

System view

Default Level

2: System level

Parameters

None

Description

Use the nqa-agent enable command to enable the NQA client.

Use the undo nqa-agent enable command to disable the NQA client.

By default, the NQA client is disabled.

Note that you can perform tests only after the NQA client is enabled.

Related commands: nqa-server enable.

Examples

# Enable the NQA client.

<Sysname> system-view

[Sysname] nqa-agent enable

1.1.19  nqa-agent max-requests

Syntax

nqa-agent max-requests max-number

undo nqa-agent max-requests

View

System view

Default Level

2: System level

Parameters

max-number: Maximum number of tests that the NQA client can simultaneously perform, in the range 1 to 5.

Description

Use the nqa-agent max-requests command to configure the maximum number of tests that the NQA client can simultaneously perform.

Use the undo nqa-agent max-requests command to restore the default.

By default, the maximum number of tests that the NQA client can simultaneously perform is five.

Examples

# Specify the NQA client to simultaneously perform four tests at most.

<Sysname> system-view

[Sysname] nqa-agent max-requests 4

1.1.20  password

Syntax

password password

undo password

View

NQA test group view

Default Level

2: System level

Parameters

password: Password used to log on to the FTP server, a string of 1 to 32 characters.

Description

Use the password command to configure a password used to log onto the FTP server.

Use the undo password command to remove the password.

By default, no password is configured.

Note that the password command is valid only for an FTP test.

Related commands: username and ftp-operation.

Examples

# Set the login password to nqa.

<Sysname> system-view

[Sysname] nqa administrator test

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

[Sysname-nqa-administrator-test] username aaa

[Sysname-nqa-administrator-test] password nqa

1.1.21  probe-failtimes

Syntax

probe-failtimes times

undo probe-failtimes

View

NQA test group view

Default Level

2: System level

Parameters

times: Number of consecutive probe failures in a test, in the range 1 to 15.

Description

Use the probe-failtimes command to configure the number of consecutive probe failures in an NQA test before a trap message is sent to the network management server to indicate a probe failure.

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

By default, a Trap message is sent to the network management (NM) server once one probe fails in an NQA test.

 

 

Examples

# Configure the system to send a Trap message after three consecutive probe failures in an NQA test.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] probe-failtimes 3

1.1.22  send-trap

Syntax

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

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

View

NQA test group view

Default Level

2: System level

Parameters

probefailure: Sends a Trap message when a probe fails.

testcomplete: Sends a Trap message when a test is completed.

testfailure: Sends a Trap message when a test fails (the number of probe failures in a test is greater than or equal to the number configured by the test-failtimes command). For a test, only one trap message is sent.

all: Sends a Trap message in any of the above cases.

Description

Use the send-trap command to enable the Trap debugging (A Trap message is sent to the network management server).

Use the undo send-trap command to disable the Trap debugging (No Trap message is sent to the network management server).

By default, no trap message is sent to the network management server.

Examples

# Send a Trap message when a test is completed.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] send-trap testcomplete

1.1.23  sendpacket passroute

Syntax

sendpacket passroute

undo sendpacket passroute

View

NQA test group view

Default Level

2: System level

Parameters

None

Description

Use the sendpacket passroute command to enable the routing table bypass function to test the direct connectivity to the destination.

Use the undo sendpacket passroute command to disable the routing table bypass function.

By default, the routing table bypass function is disabled.

After this function is enabled, the routing table is not searched, and the packet is directly sent to the destination in a directly connected network. If the destination is not in the directly connected network, an error will be prompted.

Note that the sendpacket passroute command is invalid for DHCP tests.

Examples

# Enable the routing table bypass function.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] sendpacket passroute

1.1.24  source-interface

Syntax

source-interface interface-type interface-number

undo source-interface

View

NQA test group view

Default Level

2: System level

Parameters

interface-type interface-number: Specifies the interface by its type and number.

Description

Use the source-interface command to specify the IP address of an interface as the source IP address of ICMP test request packets or specify an interface for a DHCP test.

Use the undo source-interface command to remove the configuration.

By default, no interface address is specified as the source IP address of ICMP test request packets, or no interface is specified for a DHCP test.

Note that:

l           For a DHCP test, the source-interface command is required, for an ICMP test, it is optional, and for other tests, it is invalid.

l           For an ICMP test, if a source IP address is configured by using the source-ip command, the configuration by using the source-interface command is invalid.

l           The interface specified by the source-interface command can be a VLAN interface only.

l           The interface specified by the command must be up. Otherwise, the test will fail.

Related commands: source ip.

Examples

# Specify VLAN-interface 12 as the source interface for sending test requests.

<Sysname> system-view

[Sysname] nqa administrator test

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

[Sysname-nqa-administrator-test] source-interface Vlan-interface 12

1.1.25  source-ip

Syntax

source-ip ip-address

undo source-ip

View

NQA test group view

Default Level

2: System level

Parameters

ip-address: Source IP address of a test request packet.

Description

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

Use the undo source-ip command to remove the configured source address. That is, the IP address of the interface sending a test request packet serves as the source IP address of the test request packet.

By default, no source IP address is specified. If a source interface is specified, the IP address of the source interface serves as the source IP address of a test request packet.

Note that:

l           For an FTP test, the source-ip command is required, for a DHCP test, it is invalid, and for other tests, it is optional.

l           The source IP address in the command must be the IP address of an interface on the device and the interface must be up. Otherwise, the test will fail.

Related commands: source interface.

Examples

# Configure the source IP address of a test request packet as 10.1.1.1.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] source-ip 10.1.1.1

1.1.26  source-port

Syntax

source-port port-number

undo source-port

View

NQA test group view

Default Level

2: System level

Parameters

port-number: Source port number for a test request packet, in the range 1 to 50000.

Description

Use the source-port command to configure a source port number for a test request packet.

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

By default, no source port number is specified.

Note that this command is valid only for jitter, UDP, and SNMP tests.

Examples

# Configure the source port number of a test request packet as 8000.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] source-port 8000

1.1.27  test-enable

Syntax

test-enable

undo test-enable

View

NQA test group view

Default Level

2: System level

Parameters

None

Description

Use the test-enable command to enable the NQA test.

Use the undo test-enable command to disable the NQA test.

Test results will not be displayed after you enable the NQA test. In this case, you need to execute the display nqa command to display the test results.

Related commands: display nqa.

Examples

# Enable the NQA test.

<Sysname> system-view

[Sysname] nqa-agent enable

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] test-enable

1.1.28  test-failtimes

Syntax

test-failtimes times

undo test-failtimes

View

NQA test group view

Default Level

2: System level

Parameters

times: Minimum number of probe failures in a test before a Trap message is sent to indicate a test failure, in the range 1 to 15.

Description

Use the test-failtimes command to configure the minimum number of probe failures in a test before a Trap message is sent to the network management server to indicate a test failure.

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

By default, a Trap message is sent to the NM server once a probe fails in a test.

 

 

Examples

# Configure the system to send a Trap message to indicate a test failure after three probe failures in an NQA test.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] test-failtimes 3

1.1.29  test-type

Syntax

test-type test-type

undo test-type

View

NQA test group view

Default Level

2: System level

Parameters

test-type: Type of a test, including the following keywords:

l           dhcp: DHCP test.

l           dlsw: DLSw test.

l           ftp: FTP test.

l           http: HTTP test.

l           icmp: ICMP test.

l           jitter: Analyzes and tests the delay jitter of UDP packet transmission.

l           snmpquery: SNMP test.

l           tcpprivate: Tests the TCP connection to a specified port.

l           tcppublic: Tests the TCP connection to port 7.

l           udpprivate: Tests the UDP connection to a specified port.

l           udppublic: Tests the UDP connection to port 7.

Description

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

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

By default, the test type is ICMP.

Examples

# Set the test type to FTP.

<Sysname> system-view

[Sysname] nqa administrator test

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

1.1.30  timeout

Syntax

timeout time

undo timeout

View

NQA test group view

Default Level

2: System level

Parameters

time: Time-out time in one probe, in the range 1 to 60, in seconds.

Description

Use the timeout command to configure the time-out time in one probe. If no response packet is received within the time-out time of a request packet, the probe fails.

Use the undo timeout command to restore the default.

By default, the time-out time in one probe is three seconds.

Examples

# Configure the time-out time in one probe as 10 seconds.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] timeout 10

1.1.31  tos

Syntax

tos value

undo tos

View

NQA test group view

Default Level

2: System level

Parameters

value: Value of the ToS field in the IP header in an NQA test packet, in the range 0 to 15.

Description

Use the tos command to configure the value of the ToS field in the IP header in an NQA test packet.

Use the undo tos command to restore the default.

By default, the ToS field in the IP header of an NQA test packet is 0.

Note that the tos command is invalid for DHCP tests.

Examples

# Set the ToS field in a IP packet header in an NQA test packet to 1.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] tos 1

1.1.32  ttl

Syntax

ttl number

undo ttl

View

NQA test group view

Default Level

2: System level

Parameters

number: Maximum number of hops a test request packet traverses in the network, in the range 1 to 255.

Description

Use the ttl command to configure the maximum number of hops a test request packet traverses in the network.

Use the undo ttl command to restore the maximum number of hops to the default.

By default, the maximum number of hops that a test request packet can traverse in a network is 20.

 

 

Examples

# Configure the maximum number of hops a test request packet traverses in the network as 16.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] ttl 16

1.1.33  username

Syntax

username name

undo username

View

NQA test group view

Default Level

2: System level

Parameters

name: Username used to log on to the FTP server, a string of 1 to 32 characters.

Description

Use the username command to configure a username used to log onto the FTP server.

Use the undo username command to remove the configured username.

By default, no username is configured.

Note that the username command is valid only for FTP tests.

Related commands: password, ftp-operation.

Examples

# Set the login username to administrator.

<Sysname> system-view

[Sysname] nqa administrator test

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

[Sysname-nqa-administrator-test] username administrator

1.1.34  vpninstance

Syntax

vpninstance name

undo vpninstance

View

NQA test group view

Default Level

2: System level

Parameters

name: VPN instance name, a string of 1 to 31 characters.

Description

Use the vpninstance command to specify a VPN instance. If there are multiple VPNs, you need to use this command to specify a VPN for test.

Use the undo vpninstance command to remove the specified VPN instance.

By default, no VPN instance is specified.

Note that:

l           The VPN instance specified must be an existing one.

l           The vpninstance command is valid only for ICMP tests.

Examples

# Specify the VPN instance vpn1.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] vpninstance vpn1

1.2  NQA Server Commands

 

 

1.2.1  nqa-server enable

Syntax

nqa-server enable

undo nqa-server enable

View

System view

Default Level

2: System level

Parameters

None

Description

Use the nqa-server enable command to enable the NQA server.

Use the undo nqa-server enable command to disable the NQA server.

By default, the NQA server is disabled.

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

Examples

# Enable the NQA server.

<Sysname> system-view

[Sysname] nqa-server enable

1.2.2  nqa-server tcpconnect

Syntax

nqa-server tcpconnect ip-address port-number

undo nqa-server tcpconnect ip-address port-number

View

System view

Default Level

2: System level

Parameters

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

port-number: Port number specified for the TCP listening service on the NQA server, in the range 1 to 50000. For a TCP-Public test, the port number must be 7.

Description

Use the nqa-server tcpconnect command to create a TCP listening service on the NQA server.

Use the undo nqa-server tcpconnect command to remove the TCP listening service from the NQA server.

Note that:

l           You need to configure the nqa-server tcpconnect command on the NQA server only for the TCP-Private and TCP-Public tests.

l           The IP address and port number must be consistent with those on the NQA client and must be different from those for an existing listening service.

l           The IP address must be that of an interface on the NQA server. Otherwise, the configuration will be invalid.

Related commands: nqa-server enable.

Examples

# Create a TCP listening service by using the IP address 169.254.10.2 and port 9000.

<Sysname> system-view

[Sysname] nqa-server tcpconnect 169.254.10.2 9000

1.2.3  nqa-server udpecho

Syntax

nqa-server udpecho ip-address port-number

undo nqa-server udpecho ip-address port-number

View

System view

Default Level

2: System level

Parameters

ip-address: IP address specified for the UDP listening service on the NQA server.

port-number: Port number specified for the UDP listening service on the NQA server, in the range 1 to 50000. For the UDP-Public test, the port number must be 7.

Description

Use the nqa-server udpecho command to create a UDP listening service on the NQA server.

Use the undo nqa-server udpecho command to remove the UDP connection.

Note that:

l           You need to configure the nqa-server udpecho command on the NQA server only for the jitter, UDP-Private, and UDP-Public tests.

l           The IP address and port number must be consistent with those of the NQA client and must be different from those of an existing listening service.

l           The IP address must be that of an interface on the NQA server and must not be 0.0.0.0. Otherwise, the configuration will be invalid.

Related commands: nqa-server enable.

Examples

# Create a UDP listening service by using the IP address 169.254.10.2 and port 9000.

<Sysname> system-view

[Sysname] nqa-server udpecho 169.254.10.2 9000