No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

Command Reference

S1720, S2700, S5700, and S6720 V200R011C10

This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
iPCA Configuration Commands

iPCA Configuration Commands

Command Support

Only the S5720HI supports iPCA.

ach

Function

The ach command creates an Atomic Closed Hop (ACH) and displays the ACH view. If the ACH already exists, the command displays the ACH view directly.

The undo ach command deletes an ACH and all configurations in the ACH view.

By default, no ACH is created.

Format

ach ach-id

undo ach ach-id

Parameters

Parameter Description Value
ach-id Specifies an ACH ID.

The value is an integer ranging from 1 to 2147483647.

Views

IPFPM-MCP instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An ACH consists of two target logical ports (TLPs) and is used to identify a segment between two specified devices on the network. In IP FPM hop-by-hop measurement, you need to specify the ACH for the target flow in a measurement instance and configure the direction and measurement points for the target flow in the ACH view. You can create an ACH and enter the ACH view by running the ach command.

Prerequisites

The instance command has been run to configure an IP FPM instance on an MCP.

Example

# Create an ACH.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm mcp
[HUAWEI-nqa-ipfpm-mcp] instance 1
[HUAWEI-nqa-ipfpm-mcp-instance-1] ach 1

authentication-mode (IPFPM-DCP view)

Function

The authentication-mode command configures the authentication mode and password on a Data Collecting Point (DCP).

The undo authentication-mode command deletes the authentication mode and password on a DCP.

By default, no authentication mode or password is configured on a DCP.

Format

authentication-mode hmac-sha256 key-id key-id [ cipher ] password

undo authentication-mode hmac-sha256

Parameters

Parameter Description Value
hmac-sha256 Uses HMAC-SHA256 to encrypt and authenticate packets sent by a DCP to the MCP. -
key-id key-id Specifies the ID of the authentication password configured on a DCP. The value is an integer that ranges from 1 to 64.
cipher Specifies the cipher-text authentication password on a DCP. -
password Specifies the authentication password on a DCP. The value is a case-sensitive character string without spaces.
  • The value is a string of 1 to 255 characters in plain text.
  • The value is a string of 32 to 392 characters in cipher text.

Views

IPFPM-DCP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enhance network security and performance statistics reliability, run the authentication-mode command so that authentication is performed during IP FPM performance statistics. An MCP and its associated DCPs must have the same authentication mode and password configured. The MCP processes packets only from the authenticated DCPs.

Prerequisites

Global DCP has been enabled using the nqa ipfpm dcp command.

Example

# Configure the authentication mode and password on a DCP.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm dcp
[HUAWEI-nqa-ipfpm-dcp] authentication-mode hmac-sha256 key-id 1 cipher huawei

authentication-mode (IPFPM-DCP instance view)

Function

The authentication-mode command configures the authentication mode and password for a measurement instance on a DCP.

The undo authentication-mode command deletes the authentication mode and password of a measurement instance on a DCP.

By default, no authentication mode or password is configured for a measurement instance on a DCP.

Format

authentication-mode hmac-sha256 key-id key-id [ cipher ] password

undo authentication-mode hmac-sha256

Parameters

Parameter Description Value
hmac-sha256 Uses HMAC-SHA256 to encrypt and authenticate packets sent by a DCP to the MCP. -
key-id key-id Specifies the ID of the authentication password configured for a measurement instance. The value is an integer that ranges from 1 to 64.
cipher Specifies the cipher-text authentication password for a measurement instance. -
password Specifies the authentication password for a measurement instance. The value is a case-sensitive character string without spaces.
  • The value is a string of 1 to 255 characters in plain text.
  • The value is a string of 32 to 392 characters in cipher text.

Views

IPFPM-DCP instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a network demanding high security, when iPCA is used to measure network-level packet loss, enable authentication. After the same authentication mode and password are configured on the MCP and DCPs, the MCP accepts the packets only from authenticated DCPs. This improves network security and reliability of packet loss measurement. The authentication-mode command configures the authentication mode and password for a measurement instance on a DCP.

Prerequisites

A measurement instance has been created on the DCP using the instance command.

Precautions

If the authentication-mode command is not used to configure the authentication mode and password, all measurement instances of the DCP use the authentication mode and password configured by the authentication-mode (IPFPM-DCP view) command.

Example

# Configure the authentication mode and password for a measurement instance.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm dcp
[HUAWEI-nqa-ipfpm-dcp] instance 1
[HUAWEI-nqa-ipfpm-dcp-instance-1] authentication-mode hmac-sha256 key-id 1 cipher huawei

authentication-mode (IPFPM-MCP view)

Function

The authentication-mode command configures the authentication mode and password on the Measurement Control Point (MCP).

The undo authentication-mode command deletes the authentication mode and password on the MCP.

By default, no authentication mode or password is configured on the MCP.

Format

authentication-mode hmac-sha256 key-id key-id [ cipher ] password

undo authentication-mode hmac-sha256 key-id key-id

Parameters

Parameter Description Value
hmac-sha256 Uses HMAC-SHA256 to decrypt and authenticate packets sent by a DCP to the MCP. -
key-id key-id Specifies the ID of the authentication password configured on the MCP. The value is an integer that ranges from 1 to 64.
cipher Specifies the cipher-text authentication password configured on the MCP. -
password Specifies the authentication password configured on the MCP. The value is a case-sensitive character string without spaces.
  • The value is a string of 1 to 255 characters in plain text.
  • The value is a string of 32 to 392 characters in cipher text.

Views

IPFPM-MCP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a network demanding high security, when iPCA is used to measure network-level packet loss, enable authentication. After the same authentication mode and password are configured on the MCP and DCPs, the MCP accepts the packets only from authenticated DCPs. This improves network security and reliability of packet loss measurement. The authentication-mode command configures the authentication mode and password on the MCP.

Prerequisites

Global MCP has been enabled using the nqa ipfpm mcp command.

Precautions

The MCP and DCP must be configured with the same authentication mode and password; otherwise, the MCP cannot obtain packet loss measurement from the DCP.

Example

# Configure the authentication mode and password on the MCP.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm mcp
[HUAWEI-nqa-ipfpm-mcp] authentication-mode hmac-sha256 key-id 1 huawei

color-flag loss-measure

Function

The color-flag loss-measure command configures the color bit used in network-level packet loss measurement.

The undo color-flag command restores the default color bit used in network-level packet loss measurement.

By default, bit 6 in the ToS field is used as the color bit for network-level packet loss measurement. The default configuration is recommended.

Format

color-flag loss-measure { tos-bit tos-bit | flags-bit0 }

undo color-flag

Parameters

Parameter Description Value
tos-bit tos-bit Specifies a bit in the range of bits 3 to 7 in the ToS field of IP packets as the color bit for network-level packet loss measurement. The value is an integer that ranges from 3 to 7.
flags-bit0 Specifies bit 0 in the Flags field of IP packets as the color bit for network-level packet loss measurement. -

Views

IPFPM-DCP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Before deploying Packet Conservation Algorithm for Internet (iPCA) to implement network-level packet loss measurement, run this command to configure the color bit. You can select a color bit according to the actual situation and network planning.

Prerequisites

Global DCP has been enabled using the nqa ipfpm dcp command.

Precautions

All devices on a network must use the same color bit setting. When the DS field is used to provide differentiated service, it is not recommended that you configure bits 3-5 as color bits because the measurement result may be inaccurate.

When both network-level and device-level packet loss measurements are enabled on a device, the color bits must be differentiated.

Example

# Configure bit 3 in the ToS field as the color bit for network-level packet loss measurement.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm dcp
[HUAWEI-nqa-ipfpm-dcp] color-flag loss-measure tos-bit 3
Related Topics

dcp

Function

The dcp command associates the DCP ID with a measurement instance on the MCP.

The undo dcp command disassociates the DCP ID from a measurement instance on the MCP.

By default, no DCP ID is associated with a measurement instance on the MCP.

Format

dcp dcp-id

undo dcp [ dcp-id ]

Parameters

Parameter Description Value
dcp-id Specifies the DCP ID to be associated with a measurement instance. The value is in dotted decimal notation.

Views

IPFPM-MCP instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Each measurement instance of the MCP contains one or more DCP IDs. The MCP checks whether the statistics data is complete based on the DCP ID, so the DCP ID must be specified for a measurement instance created on the MCP. The dcp command associates the DCP ID with a measurement instance on the MCP.

Prerequisites

A measurement instance has been created on the MCP using the instance command.

Precautions

The DCP ID associated with the measurement instance on the MCP must be the same as the DCP ID configured by the dcp id command on the DCP.

The undo dcp command without dcp-id specified deletes all DCP IDs associated with a measurement instance.

Example

# Associate a DCP ID with measurement instance 1 on the MCP.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm mcp
[HUAWEI-nqa-ipfpm-mcp] instance 1
[HUAWEI-nqa-ipfpm-mcp-instance-1] dcp 10.1.1.1

dcp id

Function

The dcp id command sets the DCP ID.

The undo dcp id command deletes the DCP ID.

By default, no DCP ID is configured.

Format

dcp id dcp-id

undo dcp id

Parameters

Parameter Description Value
dcp-id Specifies the DCP ID. It is recommended that you configure the router ID of the device as the DCP ID. The value is in dotted decimal notation.

Views

IPFPM-DCP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the MCP communicates with a DCP, the DCP encapsulates statistics data collected from Target Logical Ports (TLPs) in a packet and sends the packet with the DCP ID as the source IP address. After receiving the packet sent from the DCP, the MCP compares the DCP ID in the packet with the DCP ID configured by the dcp command:
  • If the two DCP IDs are the same, the MCP accepts the packet, and then summarizes and calculates the statistics data.
  • If the two DCP IDs are different, the MCP considers the packet invalid and discards it.

Prerequisites

Global DCP has been enabled using the nqa ipfpm dcp command.

Precautions

Each DCP has a unique ID on the network. It is recommended that you configure the router ID of the device as the DCP ID. The DCP ID must be the same as the DCP ID in the measurement instance configured by the dcp command on the MCP.

Example

# Set the DCP ID.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm dcp
[HUAWEI-nqa-ipfpm-dcp] dcp id 10.1.1.1

description (IPFPM-DCP instance view)

Function

The description command configures the description for a measurement instance on a DCP.

The undo description command deletes the description of a measurement instance on a DCP.

By default, no description is configured for a measurement instance on a DCP.

Format

description text

undo description

Parameters

Parameter Description Value
text Specifies the description of a measurement instance. The value is a string of 1 to 64 case-sensitive characters with spaces supported.

Views

IPFPM-DCP instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An IP FPM instance is identified by an integer ID, and therefore its functions are not easy to understand. The description command configures the description for a measurement instance on a DCP, which helps you understand the function of the measurement instance.

It is recommended that the description command be used to configure the description for a measurement instance in the following situations:
  • Many measurement instances are configured, and it is difficult to differentiate functions of each measurement instance.
  • The interval for using the same measurement instance is too long, and functions of measurement instances change.

Precautions

If an IP FPM instance is configured but does not have a description, it may be misused.

Example

# Configure the description for measurement instance 1.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm dcp
[HUAWEI-nqa-ipfpm-dcp] instance 1
[HUAWEI-nqa-ipfpm-dcp-instance-1] description NanJinToHeFei

description (IPFPM-MCP instance view)

Function

The description command configures the description for a measurement instance on the MCP.

The undo description command deletes the description of a measurement instance on the MCP.

By default, no description is configured for a measurement instance on the MCP.

Format

description text

undo description

Parameters

Parameter Description Value
text Specifies the description of a measurement instance. The value is a string of 1 to 64 case-sensitive characters with spaces supported.

Views

IPFPM-MCP instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An IP FPM instance is identified by an integer ID, and therefore its functions are not easy to understand. The description command configures the description for a measurement instance on a DCP, which helps you understand the function of the measurement instance.

It is recommended that the description command be used to configure the description for a measurement instance in the following situations:
  • Many measurement instances are configured, and it is difficult to differentiate functions of each measurement instance.
  • The interval for using the same measurement instance is too long, and functions of measurement instances change.

Precautions

If an IP FPM instance is configured but does not have a description, it may be misused.

Example

# Configure the description for measurement instance 1 on the MCP.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm mcp
[HUAWEI-nqa-ipfpm-mcp] instance 1
[HUAWEI-nqa-ipfpm-mcp-instance-1] description NanJinToHeFei

display ipfpm dcp

Function

The display ipfpm dcp command displays the DCP configuration in the IP Flow Performance Measurement (FPM) system.

Format

display ipfpm dcp

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to check the DCP configuration.

Example

# Display the DCP configuration.

<HUAWEI> display ipfpm dcp

Specification Information(Main Board):
 Max Instance Number                       : 512
 Max 10s Instance Number                   : 512
 Max 1s Instance Number                    : 1
 Max TLP Number                            : 512
 Max TLP Number Per Instance               : 8

Configuration Information:
 DCP ID                                    : 10.1.1.1
 Loss-measure Flag                         : tos-bit6(default)
 Authentication Mode                       : --
 Test Instances MCP ID                     : 10.2.2.2
 Test Instances MCP Port                   : 65030(default)
 Current Instance Number                   : 1  
Table 16-46  Description of the display ipfpm dcp command output

Item

Description

Specification Information(Main Board)

Specification information of the main board.

Max Instance Number

Maximum number of measurement instances supported.

Max 10s Instance Number

Maximum number of measurement instances at intervals of 10s.

Max 1s Instance Number

Maximum number of measurement instances at intervals of 1s.

Max TLP Number

Maximum number of TLPs supported .

Max TLP Number Per Instance

Maximum number of TLPs supported by each measurement instance.

Configuration Information

DCP configuration.

DCP ID

DCP ID.

To configure this parameter, run the dcp id command.

Loss-measure Flag

Color bit used in packet loss measurement:
  • tos-bit3: bit 3 in the ToS field
  • tos-bit4: bit 4 in the ToS field
  • tos-bit5: bit 5 in the ToS field
  • tos-bit6: bit 6 in the ToS field
  • tos-bit7: bit 7 in the ToS field
  • flag-bit0: bit 0 in the Flags field

To configure this parameter, run the color-flag loss-measure command.

Authentication Mode

Authentication mode on the DCP:
  • hmac-sha256: HMAC-SHA256 encrypted authentication
  • --: non-authentication

To configure the authentication mode on a DCP, run the authentication-mode (IPFPM-DCP view) command.

Test Instances MCP ID

MCP ID. To associate an MCP ID with a measurement instance of a DCP, run the mcp (IPFPM-DCP instance view) command.

Test Instances MCP Port

MCP Port. To configure the UDP port number through which the DCP and MCP communicate with each other, run the mcp (IPFPM-DCP instance view) command.

Current Instance Number

Number of measurement instances.

Related Topics

display ipfpm mcp

Function

The display ipfpm mcp command displays the MCP configuration and status in the IP Flow Performance Measurement (FPM) system.

Format

display ipfpm mcp

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to check the MCP configuration and status.

Example

# Display the MCP configuration.

<HUAWEI> display ipfpm mcp
Specification Information:
 Max Instance Number                       :128
 Max DCP Number Per Instance               :128
 Max ACH Number Per Instance               :16
 Max TLP Number Per ACH                    :16

Configuration Information:
 MCP ID                                    :10.1.1.1
 Status                                    :Active
 Protocol Port                             :65030(default)
 Current Instance Number                   :1
Table 16-47  Description of the display ipfpm mcp command output

Item

Description

Specification Information

Specifications of the MCP.

Max Instance Number

Maximum number of measurement instances supported by the MCP.

Max DCP Number Per Instance

Maximum number of DCPs supported by each measurement instance on the MCP.

Max ACH Number Per Instance

Maximum number of ACHs supported by each measurement instance on the MCP.

Max TLP Number Per ACH

Maximum number of TLPs supported by ACH on the MCP.

Configuration Information

MCP configuration.

MCP ID

MCP ID. To set the MCP ID, run the mcp id command on the MCP.

Status

MCP status:
  • Active: The MCP works properly.
  • Deleting: The undo nqa ipfpm mcp command is being used to disable global MCP.

Protocol Port

UDP port number through which the DCP and MCP communicate with each other. To configure the UDP port number through which the DCP and MCP communicate with each other, run the protocol udp port command.

Current Instance Number

Total number of measurement instances.

Related Topics

display ipfpm statistic-type

Function

The display ipfpm statistic-type command displays packet loss statistics of a specified measurement instance in the IP Flow Performance Measurement (FPM) system.

Format

display ipfpm statistic-type loss instance instance-id [ ach ach-id ]

Parameters

Parameter Description Value
loss Displays packet loss statistics. -
instance instance-id Displays packet loss statistics of a specified measurement instance. The value is an integer that ranges from 1 to 16777214.
ach ach-id

Displays hop-by-hop performance statistics for an Atomic Closed Hop (ACH).

The value is an integer ranging from 1 to 2147483647.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The packet loss statistics of a specified measurement instance include the indicators such as the number of discarded packets, number of discarded bytes, and packet loss ratio. To view packet loss statistics of a specified measurement instance, run the display ipfpm statistic-type command.

To locate and diagnose network faults when network performance deteriorates, run the display ipfpm statistic-type command with ach configured to check statistics for a specified ACH.

Precautions

This command can be only executed on the MCP.

The first statistics record obtained through the IP FPM may be inaccurate, so do not use the first statistics record to determine network performance.

If the packet loss ratio is a negative value, the service packets may be unknown unicast packets or the color bits on devices participating in measurement may be different.

Example

# Display packet loss statistics of measurement instance 1.

<HUAWEI> display ipfpm statistic-type loss instance 1
Latest loss statistics of forward flow:
Unit: p - packet, b - byte      
------------------------------------------------------------------------------------------ 
 Period               Loss(p)              LossRatio(p)  Loss(b)              LossRatio(b) 
------------------------------------------------------------------------------------------ 
 136118757            20                      20.000000% 2000                   20.000000%
 136118756            20                      20.000000% 2000                   20.000000%
 136118755            20                      20.000000% 2000                   20.000000%
 136118753            20                      20.000000% 2000                   20.000000%
 136118752            20                      20.000000% 2000                   20.000000%
 136118751            20                      20.000000% 2000                   20.000000%
 136118750            20                      20.000000% 2000                   20.000000%
 136118749            20                      20.000000% 2000                   20.000000%
 136118748            20                      20.000000% 2000                   20.000000%
 136118747            20                      20.000000% 2000                   20.000000%
 136118746            20                      20.000000% 2000                   20.000000%
 136118745            20                      20.000000% 2000                   20.000000%
           
Latest loss statistics of backward flow:
Unit: p - packet, b - byte      
------------------------------------------------------------------------------------------ 
 Period               Loss(p)              LossRatio(p)  Loss(b)              LossRatio(b) 
------------------------------------------------------------------------------------------ 
 136118757            20                      20.000000% 2000                   20.000000%
 136118756            20                      20.000000% 2000                   20.000000%
 136118755            20                      20.000000% 2000                   20.000000%
 136118753            20                      20.000000% 2000                   20.000000%
 136118752            20                      20.000000% 2000                   20.000000%
 136118751            20                      20.000000% 2000                   20.000000%
 136118750            20                      20.000000% 2000                   20.000000%
 136118749            20                      20.000000% 2000                   20.000000%
 136118748            20                      20.000000% 2000                   20.000000%
 136118747            20                      20.000000% 2000                   20.000000%
 136118746            20                      20.000000% 2000                   20.000000%
 136118745            20                      20.000000% 2000                   20.000000%
Table 16-48  Description of the display ipfpm statistic-type command output

Item

Description

Latest loss statistics of forward flow

-

Latest loss statistics of backward flow

-

Period

Measurement interval.

Loss(p)

Number of discarded packets.

LossRatio(p)

Packet loss ratio.

Loss(b)

Number of discarded bytes.

LossRatio(b)

Packet loss ratio of bytes.

display iplpm configuration brief

Function

The display iplpm configuration brief command displays the brief configuration of device-level packet loss measurement (including measurement on the entire device and direct link).

Format

display iplpm configuration brief

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To view parameters of device-level packet loss measurement, run this command.

Example

# Display the brief configuration of device-level packet loss measurement.

<HUAWEI> display iplpm configuration brief
Configuration information:
----------------------------------------------------------------
Loss-measure flag               : flags-bit0(default)
Global loss-measure interval(s) : 10(default)
Global loss-measure status      : disable
Global loss-measure alarm       : disable
Loss-measure board number       : 1
Loss-measure board list         : 0
Loss-measure port number        : 9
Loss-measure port list          : GigabitEthernet0/0/1
                                  GigabitEthernet0/0/2
                                  GigabitEthernet0/0/3
                                  GigabitEthernet0/0/4
                                  GigabitEthernet0/0/5
                                  GigabitEthernet0/0/6
                                  GigabitEthernet0/0/7
                                  GigabitEthernet0/0/8
                                  GigabitEthernet0/0/9
----------------------------------------------------------------  
Table 16-49  Description of the display iplpm configuration brief command output

Item

Description

Configuration information

Configuration of device-level packet loss measurement.

Loss-measure flag

Color bit for packet loss measurement. To configure the color bit, run the iplpm loss-measure color-flag command.

  • tos-bit6: bit 6 in the ToS field
  • tos-bit7: bit 7 in the ToS field
  • flags-bit0: bit 0 in the Flags field

The value default indicates that the default color bit is used.

Global loss-measure interval(s)

Measurement interval of packet loss measurement on the device. To set the measurement interval, run the iplpm global loss-measure interval command.

The value default indicates that the default measurement interval is used.

Global loss-measure status

Whether packet loss measurement on the device is enabled. To packet loss measurement for a device, run the iplpm global loss-measure enable command.

  • enable
  • disable

Global loss-measure alarm

Whether the alarm and clear alarm of packet loss ratio are enabled. To enable the alarm and clear alarm of packet loss ratio, run the iplpm global loss-measure alarm enable command.

  • enable
  • disable

Loss-measure board number

Number of devices that support device-level packet loss measurement.

Loss-measure board list

List of slot numbers of devices that support device-level packet loss measurement. The value -- indicates that no device supports device-level packet loss measurement.

Loss-measure port number

Number of interfaces where packet loss measurement for direct links is enabled.

Loss-measure port list

List of interfaces where packet loss measurement for direct links is enabled. The value -- indicates that no interface is enabled with packet loss measurement for direct links.

display iplpm loss-measure statistics global

Function

Run the display iplpm loss-measure statistics global command displays the packet loss measurement result on a device.

Format

display iplpm loss-measure statistics global

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view the packet loss measurement result on a device, including the number of discarded packets, packet loss ratio, and error information.

Example

# Display the packet loss measurement result on a device.

<HUAWEI> display iplpm loss-measure statistics global 
Latest global loss statistics:
--------------------------------------------------------------------------------
 StartTime(DST)        Loss Packets            LossRatio         ErrorInfo      
--------------------------------------------------------------------------------
 2014-06-12 18:47:30   344127                  4.513519%         OK 
 2014-06-12 18:47:20   381085                  4.513196%         OK 
 2014-06-12 18:47:10   381192                  4.513290%         OK 
 2014-06-12 18:47:00   381339                  4.513341%         OK 
 2014-06-12 18:46:50   381465                  4.513392%         OK 
 2014-06-12 18:46:40   381444                  4.513487%         OK 
 2014-06-12 18:46:30   381129                  4.513309%         OK 
--------------------------------------------------------------------------------
Table 16-50  Description of the display iplpm loss-measure statistics global command output

Item

Description

Latest global loss statistics

Latest statistics about packet loss measurement on the device.

StartTime(DST)

Time the packet loss measurement result was generated (standard DST), which is also the start time of each measurement interval.

Loss Packets

Number of discarded packets in the current measurement interval.

LossRatio

Packet loss ratio in the current measurement interval.

ErrorInfo

Error code about packet loss measurement in the current measurement interval:

  • OK: There is no error, and the packet loss measurement result is normal.
  • Incomplete: The statistics data is incomplete. The possible reason is the inter-chassis communication error. Part of statistics on the standby or slave switch cannot be sent to the master switch.

display iplpm loss-measure statistics history-record

Function

The display iplpm loss-measure statistics history-record command displays the historical records of packet loss measurement on a device and a direct link.

Format

display iplpm loss-measure statistics history-record { global | interface interface-type interface-number }

Parameters

Parameter Description Value
global Displays the historical records of packet loss measurement on a device. -
interface interface-type interface-number Displays the historical records of packet loss measurement on a direct link. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

When the measurement interval is 1s, 10s, or 60s, the system summarizes statistics results in each measurement interval every 5 minutes to obtain the maximum and minimum packet loss ratios within 5 minutes. When the measurement interval is 600s, the system summarizes statistics results in each measurement interval every 60 minutes to obtain the maximum and minimum packet loss ratios within 60 minutes. The system saves a maximum of four summarized records. You can run this command to view historical records.

Example

# Display the historical records of packet loss measurement on a device.

<HUAWEI> display iplpm loss-measure statistics history-record global
Latest global history record(every 5 minutes):
------------------------------------------------------------------------
 Record no                      : 29
 Period(DST)                    : 2014-03-19 16:20:10 to 2014-03-19 16:25:10
 Valid statistic data number    : 30
 Maximum loss ratio             : 0.000000%
 Minimum loss ratio             : 0.000000%
 Total loss packets             : 0
 Total receive packets          : 0

 Record no                      : 28
 Period(DST)                    : 2014-03-19 16:15:10 to 2014-03-19 16:20:10
 Valid statistic data number    : 30
 Maximum loss ratio             : 0.000000%
 Minimum loss ratio             : 0.000000%
 Total loss packets             : 0
 Total receive packets          : 0

 Record no                      : 27
 Period(DST)                    : 2014-03-19 16:10:10 to 2014-03-19 16:15:10
 Valid statistic data number    : 30
 Maximum loss ratio             : 0.000000%
 Minimum loss ratio             : 0.000000%
 Total loss packets             : 0
 Total receive packets          : 0

 Record no                      : 26
 Period(DST)                    : 2014-03-19 16:05:10 to 2014-03-19 16:10:10
 Valid statistic data number    : 30
 Maximum loss ratio             : 0.000000%
 Minimum loss ratio             : 0.000000%
 Total loss packets             : 0
 Total receive packets          : 0

------------------------------------------------------------------------

# Display the historical records of packet loss measurement on a direct link of GE0/0/1.

<HUAWEI> display iplpm loss-measure statistics history-record interface gigabitethernet 0/0/1
Latest history record of interface GigabitEthernet0/0/1(every 5 minutes):
----------------------------------------------------------------------------
 Record no                      : 29
 Period(DST)                    : 2014-03-19 16:20:10 to 2014-03-19 16:25:10
 Valid statistic data number    : 30
 Maximum forward loss ratio     : 0.000000%
 Minimum forward loss ratio     : 0.000000%
 Total forward loss packets     : 0
 Total forward receive packets  : 0
 Maximum backward loss ratio    : 20.000000%
 Minimum backward loss ratio    : 19.980020%
 Total backward loss packets    : 6000
 Total backward receive packets : 30001

 Record no                      : 28
 Period(DST)                    : 2014-03-19 16:15:10 to 2014-03-19 16:20:10
 Valid statistic data number    : 30
 Maximum forward loss ratio     : 0.000000%
 Minimum forward loss ratio     : 0.000000%
 Total forward loss packets     : 0
 Total forward receive packets  : 0
 Maximum backward loss ratio    : 20.079920%
 Minimum backward loss ratio    : 19.980020%
 Total backward loss packets    : 6001
 Total backward receive packets : 30003

 Record no                      : 27
 Period(DST)                    : 2014-03-19 16:10:10 to 2014-03-19 16:15:10
 Valid statistic data number    : 30
 Maximum forward loss ratio     : 0.000000%
 Minimum forward loss ratio     : 0.000000%
 Total forward loss packets     : 0
 Total forward receive packets  : 0
 Maximum backward loss ratio    : 20.039880%
 Minimum backward loss ratio    : 19.960080%
 Total backward loss packets    : 6001
 Total backward receive packets : 30005

 Record no                      : 26
 Period(DST)                    : 2014-03-19 16:05:10 to 2014-03-19 16:10:10
 Valid statistic data number    : 30
 Maximum forward loss ratio     : 0.000000%
 Minimum forward loss ratio     : 0.000000%
 Total forward loss packets     : 0
 Total forward receive packets  : 0
 Maximum backward loss ratio    : 20.059880%
 Minimum backward loss ratio    : 19.980020%
 Total backward loss packets    : 6001
 Total backward receive packets : 30004
---------------------------------------------------------------------------------
Table 16-51  Description of the display iplpm loss-measure statistics history-record command output

Item

Description

Latest global historical record(every 5 minutes)

Latest statistics about packet loss measurement in every five minutes on the device.

Latest historical record of interface x (every 5 minutes)

Latest statistics about packet loss measurement on a direct link of the x interface in every five minutes.

Record no

Historical record ID.

Period(DST)

Time historical records were generated (standard DST).

Valid statistic data number

Number of valid historical statistics records.

Maximum loss ratio

Maximum packet loss ratio of the device.

Minimum loss ratio

Minimum packet loss ratio of the device.

Total loss packets

Total number of packets discarded by the device.

Total receive packets

Total number of packets received by the device.

Maximum forward loss ratio

Maximum packet loss ratio of a forward flow (a forward flow is sent by the local device interface and received by the remote device interface).

Minimum forward loss ratio

Minimum packet loss ratio of a forward flow.

Total forward loss packets

Total number of discarded packets of a forward flow.

Total forward receive packets

Total number of received packets (including the number of discarded packets) of a forward flow.

Maximum backward loss ratio

Maximum packet loss ratio of a backward flow (a backward flow is sent by the remote device interface and received by the local device interface).

Minimum backward loss ratio

Minimum packet loss ratio of a backward flow.

Total backward loss packets

Total number of discarded packets of a backward flow.

Total backward receive packets

Total number of received packets (including the number of discarded packets) of a backward flow.

display iplpm loss-measure statistics interface

Function

The display iplpm loss-measure statistics interface command displays the packet loss measurement result on the direct link of a specified interface.

Format

display iplpm loss-measure statistics interface interface-type interface-number [ forward | backward ]

Parameters

Parameter Description Value
interface-type interface-number Displays the packet loss measurement result on the direct link of a specified interface. -
forward Displays the packet loss measurement result of a forward flow on the direct link of a specified interface. A forward flow is sent by the local device interface and received by the remote device interface. -
backward Displays the packet loss measurement result of a backward flow on the direct link of a specified interface. A backward flow is sent by the remote device interface and received by the local device interface. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view the packet loss measurement result in the forward and backward directions, including the number of discarded packets and packet loss ratio.

Example

# Display the packet loss measurement result on the direct link of GE0/0/1.

<HUAWEI> display iplpm loss-measure statistics interface gigabitethernet 0/0/1
Latest forward loss statistics of interface GigabitEthernet0/0/1:
-------------------------------------------------------------------------------------------------------                                                    
 StartTime(DST)        Forward Loss Packets  Forward LossRatio   ErrorInfo                                                         
-------------------------------------------------------------------------------------------------------                                                    
 2014-03-19 15:50:50    200                   19.980020%          OK                                                                
 2014-03-19 15:50:40    200                   20.000000%          OK                                                                
 2014-03-19 15:50:30    200                   19.980020%          OK                                                                
 2014-03-19 15:50:20    200                   20.020020%          OK                                                                
 2014-03-19 15:50:10    200                   20.000000%          OK                                                                
 2014-03-19 15:50:00    200                   19.980020%          OK
--------------------------------------------------------------------------------------------------------
Latest backward loss statistics of interface GigabitEthernet0/0/1:                                                                 
---------------------------------------------------------------------------------------------------------                                                    
 StartTime(DST)        Backward Loss Packets  Backward LossRatio  ErrorInfo                                                        
---------------------------------------------------------------------------------------------------------                                                    
 2014-03-19 15:50:50    0                      0.000000%           OK                                                               
 2014-03-19 15:50:40    0                      0.000000%           OK                                                               
 2014-03-19 15:50:30    0                      0.000000%           OK                                                               
 2014-03-19 15:50:20    0                      0.000000%           OK                                                               
 2014-03-19 15:50:10    0                      0.000000%           OK                                                               
 2014-03-19 15:50:00    0                      0.000000%           OK
------------------------------------------------------------------------------------------------------------
Table 16-52  Description of the display iplpm loss-measure statistics interface command output

Item

Description

Latest forward loss statistics of interface x

Latest statistics about packet loss measurement of a forward target flow on the direct link of the x interface (a forward flow is sent by the local device interface and received by the remote device interface).

Latest backward loss statistics of interface x

Latest statistics about packet loss measurement of a backward target flow on the direct link of the x interface (a backward flow is sent by the remote device interface and received by the local device interface).

StartTime(DST)

Time the packet loss measurement result was generated (standard DST), which is also the start time of each measurement interval.

Forward Loss Packets

Number of discarded packets of a forward flow in the current measurement interval.

Forward LossRatio

Packet loss ratio of a forward flow in the current measurement interval.

Backward Loss Packets

Number of discarded packets of a backward flow in the current measurement interval.

Backward LossRatio

Packet loss ratio of a backward flow in the current measurement interval.

ErrorInfo

Error code about packet loss measurement in the current measurement interval:

  • Init: The device is in initialized state and there is no statistics data.
  • OK: There is no error, and the packet loss measurement result is normal.
  • NoRecvData: The local end does not receive statistics data from the remote end. The possible causes may be that the packet loss measurement on a direct link is not enabled on the remote device or the direct link becomes faulty or there is a forwarding node on the link.
  • DataErr: The local end receives error statistics data from the remote end.
  • DiffAuth: The authentication modes or passwords on both ends are different.
  • DiffIntvl: The measurement intervals on both ends are different.
  • ASynClock: The time on both ends is asynchronous. When this code occurs, check the NTP configuration.
  • PortIsDown: The interface is Down.

display iplpm loss-measure statistics port-flow interface

Function

The display iplpm loss-measure statistics port-flow interface command displays statistics about discarded packets on an interface.

Format

display iplpm loss-measure statistics port-flow interface interface-type interface-number

Parameters

Parameter Description Value
interface-type interface-number Displays statistics about discarded packets on a specified interface. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

When you find packet loss on an interface in the packet loss measurement result on the direct link in the display iplpm loss-measure statistics interface command output, you can run the display iplpm loss-measure statistics port-flow interface command to check the statistics data. Then you can check whether the fault on the local interface causes packet loss.

Example

# Display statistics about discarded packets on GE0/0/1.

<HUAWEI> display iplpm loss-measure statistics port-flow interface gigabitethernet 0/0/1
Latest port loss statistics of interface GigabitEthernet0/0/1:
--------------------------------------------------------------------------------
 StartTime(DST)         Output Packets Loss Ratio     Input Packets Loss Ratio  
--------------------------------------------------------------------------------
 2014-04-01 18:09:40    0.000000%                     0.000000%                 
 2014-04-01 18:09:30    0.000000%                     0.000000%                 
 2014-04-01 18:09:20    0.000000%                     0.000000%                 
 2014-04-01 18:09:10    0.000000%                     0.000000%              
---------------------------------------------------------------------------------
Table 16-53  Description of the display iplpm loss-measure statistics port-flow interface command output

Item

Description

Latest port loss statistics of interface x

Latest statistics about packet loss measurement on the x interface.

StartTime(DST)

Time the packet loss measurement result was generated (standard DST), which is also the start time of each measurement interval.

Output Packets Loss Ratio

Packet loss rate of packets sent from the local interface and received by the peer interface during the current statistics interval.

Input Packets Loss Ratio

Packet loss rate of packets sent from the peer interface and received by the local interface during the current statistics interval.

display iplpm loss-measure statistics qos-queue interface

Function

The display iplpm loss-measure statistics qos-queue interface command displays statistics about sent packets in QoS queues on an interface.

Format

display iplpm loss-measure statistics qos-queue interface interface-type interface-number

Parameters

Parameter Description Value
interface-type interface-number Displays statistics about sent packets in QoS queues on a specified interface. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

When you find packet loss on an interface in the packet loss measurement result on the direct link in the display iplpm loss-measure statistics interface command output, you can run the display iplpm loss-measure statistics qos-queue interface command to check the statistics about sent packets in QoS queues on an interface. Then you can check whether congestion in queues causes packet loss.

Example

# Display statistics about sent packets in QoS queues on GE0/0/1.

<HUAWEI> display iplpm loss-measure statistics qos-queue interface gigabitethernet 0/0/1
Latest qos queue loss statistics of interface GigabitEthernet0/0/1:                                                                 
---------------------------------------------------------------------------------                                                             
StartTime(DST): 2014-03-19 16:25:10                                       
 Queue0   : 0.000000%           Queue1: 0.000000%                                               
 Queue2   : 0.000000%           Queue3: 0.000000%                                                  
 Queue4   : 0.000000%           Queue5: 0.000000%                                                  
 Queue6   : 0.000000%           Queue7: 0.000000%                                                
 UserQueue: 0.000000%                                                                                                               
                                                                                                                                    
StartTime(DST): 2014-03-19 16:25:00                                                                                                 
 Queue0   : 0.000000%           Queue1: 0.000000%                                                                                   
 Queue2   : 0.000000%           Queue3: 0.000000%                                                                                   
 Queue4   : 0.000000%           Queue5: 0.000000%                                                                                   
 Queue6   : 0.000000%           Queue7: 0.000000%                                                                                   
 UserQueue: 0.000000%                             
                                                                                                                                    
---------------------------------------------------------------------------------
Table 16-54  Description of the display iplpm loss-measure statistics qos-queue interface command output

Item

Description

StartTime(DST)

Time the packet loss measurement result was generated (standard DST), which is also the start time of each measurement interval.

Queue0-Queue7

Packet loss ratios of queues 0 to 7 in the measurement interval, which is used for reference only.

UserQueue

Packet loss ratio of the subscriber queue on the interface in the current measurement interval. The value of this field can be obtained only when HQoS is configured, and is used for reference only.

display snmp-agent trap feature-name ipfpm all

Function

The display snmp-agent trap feature-name ipfpm all command displays whether the switch is enabled to send traps of IP Flow Performance Measurement (IP FPM) module to the NMS.

Format

display snmp-agent trap feature-name ipfpm all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

After running the snmp-agent trap enable feature-name ipfpm command to enable the function of sending traps of IP FPM modules to the NMS, you can run the display snmp-agent trap feature-name ipfpm all command to check whether this function is enabled.

Prerequisites

SNMP has been enabled. For details, see snmp-agent.

Example

# Display whether the switch is enabled to send traps of IP FPM module to the NMS.

<HUAWEI> display snmp-agent trap feature-name ipfpm all
------------------------------------------------------------------------------  
Feature name: IPFPM                                                             
Trap number : 4                                                                 
------------------------------------------------------------------------------  
Trap name                       Default switch status   Current switch status   
hwIpfpmLossRatioExceed          off                     on                      
hwIpfpmLossRatioRecovery        off                     on                      
hwIpfpmTlpExceed                off                     on                      
hwIpfpmTlpRecovery              off                     on     
Table 16-55  Description of the display snmp-agent trap feature-name ipfpm all command output

Item

Description

Feature name

Name of the feature that generates traps.

Trap number

Number of traps generated by IP FPM module.

Trap name

Name of the trap. Traps of the IP FPM module include:
  • hwIpfpmLossRatioExceed: The packet loss ratio exceeds the threshold.
  • hwIpfpmLossRatioRecovery: The default packet loss ratio is restored.
  • hwIpfpmTlpExceed: The number of TLPs exceeds the limit.
  • hwIpfpmTlpRecovery: The default number of TLPs is restored.

Default switch status

Default status of a trap:
  • on: The switch is enabled to send this trap to the NMS.
  • off: The switch is disabled to send this trap to the NMS.

Current switch status

Current status of a trap:
  • on: The switch is enabled to send this trap to the NMS.
  • off: The switch is disabled to send this trap to the NMS.

This status can be configured using the snmp-agent trap enable feature-name ipfpm command.

display snmp-agent trap feature-name iplpm all

Function

The display snmp-agent trap feature-name iplpm all command displays whether the switch is enabled to send traps of IP Local Performance Measurement (IP LPM) module to the NMS.

Format

display snmp-agent trap feature-name iplpm all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

After running the snmp-agent trap enable feature-name iplpm command to enable the function of sending traps of IP LPM modules to the NMS, you can run the display snmp-agent trap feature-name iplpm all command to check whether this function is enabled.

Prerequisites

SNMP has been enabled. For details, see snmp-agent.

Example

# Display whether the switch is enabled to send traps of IP LPM module to the NMS.

<HUAWEI> display snmp-agent trap feature-name iplpm all
------------------------------------------------------------------------------
Feature name: iplpm                                                           
Trap number : 4                                                               
------------------------------------------------------------------------------
Trap name                       Default switch status   Current switch status 
hwIplpmGlobalLossRatioExceed    on                      on                    
hwIplpmGlobalLossRatioRecovery  on                      on                    
hwIplpmLinkForwardLossRatioExceed                                             
                                on                      on                    
hwIplpmLinkForwardLossRatioRecovery                                           
                                on                      on  
Table 16-56  Description of the display snmp-agent trap feature-name iplpm all command output

Item

Description

Feature name

Name of the feature that generates traps.

Trap number

Number of traps generated by IP LPM module.

Trap name

Name of the trap. Traps of the IP LPM module include:
  • hwIplpmGlobalLossRatioExceed: The packet loss ratio of the entire device exceeds the upper limit.
  • hwIplpmGlobalLossRatioRecovery: The packet loss ratio of the entire device falls below the upper limit.
  • hwIplpmLinkForwardLossRatioExceed: The packet loss ratio of the link between directly connected devices exceeds the upper limit.
  • hwIplpmLinkForwardLossRatioRecovery: The packet loss ratio of the link between directly connected devices falls below the upper limit.

Default switch status

Default status of a trap:
  • on: The switch is enabled to send this trap to the NMS.
  • off: The switch is disabled to send this trap to the NMS.

Current switch status

Current status of a trap:
  • on: The switch is enabled to send this trap to the NMS.
  • off: The switch is disabled to send this trap to the NMS.

This status can be configured using the snmp-agent trap enable feature-name iplpm command.

flow (IPFPM-DCP instance view)

Function

The flow command configures a target flow in a measurement instance on a DCP.

The undo flow command deletes the target flow from a measurement instance on a DCP.

By default, no target flow is configured in a measurement instance on a DCP.

Format

# Define a unidirectional flow.
  • When the protocol of a target flow is TCP or UDP, run the following command:

    flow { forward | backward } { protocol { tcp | udp } { source-port src-port-number1 [ to src-port-number2 ] | destination-port dest-port-number1 [ to dest-port-number2 ] } * | dscp dscp-value | source src-ip-address [ src-mask-length ] | destination dest-ip-address [ dest-mask-length ] } *

  • When the protocol of a target flow is not TCP or UDP, run the following command:

    flow { forward | backward } { protocol protocol-number | dscp dscp-value | source src-ip-address [ src-mask-length ] | destination dest-ip-address [ dest-mask-length ] } *

# Define a bidirectional symmetrical flow.
  • When the protocol of a target flow is TCP or UDP, run the following command:

    flow bidirectional { protocol { tcp | udp } { source-port src-port-number1 [ to src-port-number2 ] | destination-port dest-port-number1 [ to dest-port-number2 ] } * | dscp dscp-value | source src-ip-address [ src-mask-length ] | destination dest-ip-address [ dest-mask-length ] } *

  • When the protocol of a target flow is not TCP or UDP, run the following command:

    flow bidirectional { protocol protocol-number | dscp dscp-value | source src-ip-address [ src-mask-length ] | destination dest-ip-address [ dest-mask-length ] } *

# Cancel the configured target flow.

undo flow { forward | backward | bidirectional }

Parameters

Parameter Description Value
forward Indicates the forward flow. -
backward Indicates the backward flow. -
protocol { tcp | udp } Indicates that the protocol of a target flow is TCP or UDP. -
source-port src-port-number1 Specifies the start source port number of a target flow. The value is an integer that ranges from 1 to 65535.
src-port-number2 Specifies the end source port number of a target flow. The value is an integer that ranges from 1 to 65535. src-port-number2 must be larger than src-port-number1.
destination-port dest-port-number1 Specifies the start destination port number of a target flow. The value is an integer that ranges from 1 to 65535.
dest-port-number2 Specifies the end destination port number of a target flow. The value is an integer that ranges from 1 to 65535. dest-port-number2 must be larger than dest-port-number1.
dscp dscp-value Specifies the value of a Differentiated Services CodePoint (DSCP) of a target flow. The value is an integer that ranges from 0 to 63.
source src-ip-address Specifies the source IP address of a target flow. Only unicast IP addresses are supported. The value is in dotted decimal notation.
src-mask-length Specifies the mask length of the source IP address of a target flow. The value is an integer that ranges from 1 to 32.
destination dest-ip-address Specifies the destination IP address of a target flow. Only unicast IP addresses are supported. The value is in dotted decimal notation.
dest-mask-length Specifies the mask length of the destination IP address of a target flow. The value is an integer that ranges from 1 to 32.
protocol protocol-number Specifies the protocol type of a target flow. The value is an integer ranging from 1 to 5, 7 to 16, or 18 to 255.
NOTE:

The value 6 indicates TCP and the value 17 indicates UDP.

bidirectional Indicates the bidirectional symmetrical flow.
NOTE:
If the target flow is symmetrical bidirectional, set src-ip-address to specify a source IP address and dest-ip-address to specify a destination IP address for the target flow.
-

Views

IPFPM-DCP instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The target flow must be specified before each measurement.

A target flow is the objective in iPCA measurement, and can be defined by any combinations of source IP address, destination IP address, protocol type, DSCP value, source port number, and destination port number. Specifying more attributes can make the target flow accurate. Therefore, it is recommended that you specify more attributes to improve precision of measurement results.

Precautions

An instance can have only one target flow configured, either unidirectional or bidirectional. A bidirectional target flow is logically two unidirectional flows in opposite directions.
  • If the target flow in an instance is unidirectional, you can specify forward to configure a forward flow or backward to configure a backward flow.

  • If the target flow in an instance is bidirectional, two situations are available:
    • If the bidirectional target flow is symmetrical, you can specify bidirectional to configure the bidirectional target flow characteristics, and you must specify the source and destination IP addresses. By default, the characteristics specified are used for the forward flow, and the reverse of those are used for the backward flow. Specifically, the source and destination IP addresses and port numbers specified for the forward flow are used respectively as the destination and source IP addresses and port numbers for the backward flow.
    • If the bidirectional target flow is asymmetrical, you must configure forward and backward in two command instances to configure the forward and backward flow characteristics.

Target flows in different IP FPM instances cannot have the same characteristics. The forward and backward target flows in an IP FPM instance cannot have the same characteristics neither.

Example

# Configure a target flow of measurement instance 1 on a DCP.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm dcp
[HUAWEI-nqa-ipfpm-dcp] instance 1
[HUAWEI-nqa-ipfpm-dcp-instance-1] flow bidirectional protocol udp source-port 1025 source 10.1.1.1 destination 10.2.2.2

flow (IPFPM-MCP-ACH view)

Function

The flow command configures the target flow direction in the Atomic Closed Hop (ACH) view.

The undo flow command deletes the target flow direction in the ACH view.

By default, no direction is configured for target flows in the ACH view.

Format

flow { forward | backward }

undo flow

Parameters

Parameter Description Value
forward Indicates the forward target flow.

-

backward Indicates the backward target flow.

-

Views

IPFPM-MCP-ACH view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Run the flow command in IP FPM hop-by-hop performance statistics scenarios.

Prerequisites

The ach command has been run to create an ACH and display the ACH view.

Example

# Configure the forward target flow in the ACH view.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm mcp
[HUAWEI-nqa-ipfpm-mcp] instance 1
[HUAWEI-nqa-ipfpm-mcp-instance-1] ach 1
[HUAWEI-nqa-ipfpm-mcp-instance-1-ach-1] flow forward

in-group

Function

The in-group command creates a Target Logical Port (TLP) in-group for the target flow.

The undo in-group command deletes a TLP in-group or deletes a TLP from a TLP in-group.

By default, no TLP in-group is configured for the target flow.

Format

in-group dcp dcp-id tlp tlp-id

undo in-group [ dcp dcp-id tlp tlp-id ]

Parameters

Parameter Description Value
dcp dcp-id Specifies a DCP to which TLPs in a TLP in-group belongs.

This value is in dotted decimal notation.

tlp tlp-id Indicates a TLP in a TLP in-group.

The value is an integer ranging from 1 to 16777215.

Views

IPFPM-MCP-ACH view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In IP FPM hop-by-hop performance statistics scenarios, a hop is a set of links and interfaces that service packets travel through, from one measurement point or group to the next measurement point or group, and therefore is represented by (TLP in-group, TLP out-group). Performance statistics are implemented on the TLP in-point or in-group through which service packets enter a network and the TLP out-point or out-group through which service packets leave the network.

Prerequisites

The ach command has been run to create an ACH and display the ACH view.

Example

# Create a TLP in-group for the target flow.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm mcp
[HUAWEI-nqa-ipfpm-mcp] instance 1
[HUAWEI-nqa-ipfpm-mcp-instance-1] ach 1
[HUAWEI-nqa-ipfpm-mcp-instance-1-ach-1] in-group dcp 10.1.1.1 tlp 100

instance (IPFPM-DCP view)

Function

The instance command creates an IPFPM-DCP instance and displays the IPFPM-DCP instance view, or directly displays the view of an existing IPFPM-DCP instance.

The undo instance command deletes an IPFPM-DCP instance.

By default, no IPFPM-DCP instance is created on a DCP.

Format

instance instance-id

undo instance instance-id

Parameters

Parameter Description Value
instance-id Specifies the ID of an IPFPM-DCP instance. The value is an integer that ranges from 1 to 8355838.

Views

IPFPM-DCP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The DCP collects statistics data based on measurement instances. Each measurement instance consists of the target flow, TLP, and measurement interval. The MCP reports measurement results based on measurement instances. The MCP summarizes and analyzes statistics data of the same measurement instance on all DCPs, and reports measurement results of target flows.

Prerequisites

Global DCP has been enabled using the nqa ipfpm dcp command.

Follow-up Procedure

Run the flow command to configure a target flow, run the tlp command to configure the TLPs of the measurement instance, and run the interval command to configure the measurement interval.

Precautions

To measure packet loss for a specified service flow, create the same measurement instance on the MCP and DCP.

Example

# Create IPFPM-DCP instance 1.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm dcp
[HUAWEI-nqa-ipfpm-dcp] instance 1

instance (IPFPM-MCP view)

Function

The instance command creates an IPFPM-MCP instance and displays the IPFPM-MCP instance view, or directly displays the view of an existing IPFPM-MCP instance.

The undo instance command deletes an IPFPM-MCP instance.

By default, no IPFPM-MCP instance is created on the MCP.

Format

instance instance-id

undo instance instance-id

Parameters

Parameter Description Value
instance-id Specifies the ID of an IPFPM-MCP instance. The value is an integer that ranges from 1 to 8355838.

Views

IPFPM-MCP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The DCP collects statistics data based on measurement instances. Each measurement instance consists of the target flow, TLP, and measurement interval. The MCP reports measurement results based on measurement instances. The MCP summarizes and analyzes statistics data of the same measurement instance on all DCPs, and reports measurement results of target flows.

Prerequisites

Global MCP has been enabled using the nqa ipfpm mcp command.

Precautions

To measure packet loss for a specified service flow, create the same measurement instance on the MCP and DCP.

Example

# Create IPFPM-MCP instance 1.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm mcp
[HUAWEI-nqa-ipfpm-mcp] instance 1

interval (IPFPM-DCP instance view)

Function

The interval command sets the measurement interval of a measurement instance on a DCP.

The undo interval command restores the default measurement interval of a measurement instance on a DCP.

By default, the measurement interval of a measurement instance on a DCP is 10 seconds.

Format

interval interval

undo interval

Parameters

Parameter Description Value
interval Specifies the measurement interval of a measurement instance on a DCP. The value is of the enumerated type and can be 1, 10, 60, or 600, in seconds.

Views

IPFPM-DCP instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The measurement interval of a measurement instance on a DCP is the interval at which a TLP collects statistics on packets or bytes and records the timestamp of packet receiving or sending. It is also the interval at which a DCP reports statistics data to the MCP. A shorter interval indicates a higher frequency at which a DCP reports statistics data to the MCP, so the interval adjustment affects the performance of the DCP and MCP.

Considering factors such as the clock synchronization offset, maximum transmission delay, and device performance, you can run this command to change the measurement interval.

Precautions

The measurement intervals of the same measurement instances on all DCPs must be the same; otherwise, the statistics data will be empty.

The measurement interval of a measurement instance cannot be changed when the measurement instance is running. If the measurement interval of a running measurement instance is changed, the statistics reported by MCP may be inaccurate. To change the measurement interval, run the measure disable command in the IPFPM-MCP instance view to disable the measurement, and then run the measure enable command to enable the measurement.

Example

# Set the measurement interval of measurement instance 1 to 60s.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm dcp
[HUAWEI-nqa-ipfpm-dcp] instance 1
[HUAWEI-nqa-ipfpm-dcp-instance-1] interval 60

ipfpm tlp

Function

The ipfpm tlp command binds a Target Logical Port (TLP) to an interface in a measurement instance on a DCP.

The undo ipfpm tlp command unbinds a TLP from an interface in a measurement instance on a DCP.

By default, an interface is not bound to a TLP in a measurement instance on a DCP.

Format

ipfpm tlp tlp-id

undo ipfpm tlp { tlp-id | all }

Parameters

Parameter Description Value
tlp-id Specifies the ID of a TLP. The value is an integer that ranges from 1 to 16777215.
all Cancels the binding between all TLPs and interfaces. -

Views

GE interface view, XGE interface view, Eth-Trunk interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Before performing packet loss measurement, run this command to bind a TLP to an interface.

Prerequisites

A Layer 2 or Layer 3 interface can be bound to a TLP. You can run the undo portswitch command to switch the interface to Layer 3 mode.

Precautions

A TLP can be bound to only one interface on the DCPs associated with an MCP, and an interface can bound only one TLP.

Example

# Bind GE0/0/1 to TLP 100.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] ipfpm tlp 100
Related Topics

iplpm global loss-measure alarm enable

Function

The iplpm global loss-measure alarm enable command enables the alarm and clear alarm of the packet loss ratio for device-level packet loss measurement.

The undo iplpm global loss-measure alarm enable command restores the default setting.

By default, the alarm and clear alarm of the packet loss ratio are disabled.

Format

iplpm global loss-measure alarm enable

undo iplpm global loss-measure alarm enable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

After this command is used, the alarm threshold and clear alarm threshold of the packet loss ratio are 5% and 1%.
  • If the packet loss ratio in five consecutive measurement intervals exceeds the alarm threshold, the device reports the hwIpfpmLossRatioExceed alarm to the NMS to notify the link fault in real time.
  • If the packet loss ratio in five consecutive measurement intervals falls below or is equivalent to the clear alarm threshold, the device reports the hwIpfpmLossRatioRecovery alarm to the NMS to notify link recovery in real time.

Example

# Enable the alarm and clear alarm of the packet loss ratio for device-level packet loss measurement.

<HUAWEI> system-view
[HUAWEI] iplpm global loss-measure alarm enable

iplpm global loss-measure enable

Function

The iplpm global loss-measure enable command enables packet loss measurement for a device.

The undo iplpm global loss-measure enable command disables packet loss measurement for a device.

By default, packet loss measurement for a device is disabled.

Format

iplpm global loss-measure enable

undo iplpm global loss-measure enable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

To measure the packet loss of a switch, run this command to enable packet loss measurement for the switch.

Example

# Enable packet loss measurement for a device.

<HUAWEI> system-view
[HUAWEI] iplpm global loss-measure enable

iplpm global loss-measure interval

Function

The iplpm global loss-measure interval command configures the device-level packet loss measurement interval.

The undo iplpm global loss-measure interval command restores the default device-level packet loss measurement interval.

By default, the device-level packet loss measurement interval is 10s.

Format

iplpm global loss-measure interval interval

undo iplpm global loss-measure interval

Parameters

Parameter Description Value
interval

Specifies the device-level packet loss measurement interval.

The value is of the enumerated type and can be 1, 10, 60, or 600, in seconds.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

The device-level packet loss measurement interval refers to the period from received packet statistics collection to sent packet statistics collection. To ensure accuracy of statistics data, run the undo iplpm global loss-measure enable command to disable device-level packet loss measurement in the system view before changing the measurement interval.

Example

# Set the device-level packet loss measurement interval to 60s.

<HUAWEI> system-view
[HUAWEI] iplpm global loss-measure interval 60

iplpm link authentication-mode

Function

The iplpm link authentication-mode command configures the authentication mode and password for packet loss measurement on a direct link.

The undo iplpm link authentication-mode command deletes the authentication mode and password.

By default, no authentication mode or password is configured for packet loss measurement on a direct link.

Format

iplpm link authentication-mode hmac-sha256 key-id key-id [ cipher ] password

undo iplpm link authentication-mode

Parameters

Parameter Description Value
hmac-sha256 Uses HMAC-SHA256 to authenticate packets between devices. -
key-id key-id Specifies the ID of the authentication password. The value is an integer that ranges from 1 to 64.
cipher Specifies the cipher-text authentication password. -
password Specifies the authentication password. The value is a character string without spaces.
  • The value is a string of 1 to 255 characters in plain text.
  • The value is a string of 32 to 392 characters in cipher text.

Views

GE interface view, XGE interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After packet loss measurement is configured on a direct link, statistics data on received and sent packets on an interface at one end is sent to an interface at the other end and summarized for packet loss measurement. This command is used to authenticate communication packets on the direct link, improving security.

Precautions

When the authentication mode and password are configured on an interface, packets encapsulated with local statistics data sent from the interface are authenticated. Therefore, both interfaces of the direct link must be configured with the same authentication mode and password.

Example

# Set the authentication mode to hmac-sha256 and password to huawei in cipher text for packet loss measurement on a direct link on the GE0/0/1.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] iplpm link authentication-mode hmac-sha256 key-id 1 cipher huawei

iplpm link loss-measure alarm enable

Function

The iplpm link loss-measure alarm enable command enables the alarm and clear alarm of the packet loss ratio for packet loss measurement on a direct link.

The undo iplpm link loss-measure alarm enable command restores the default setting.

By default, the packet loss alarm and clear alarm are disabled for packet loss measurement on a direct link.

Format

iplpm link loss-measure alarm enable

undo iplpm link loss-measure alarm enable

Parameters

None

Views

GE interface view, XGE interface view

Default Level

2: Configuration level

Usage Guidelines

After this command is used, the alarm threshold and clear alarm threshold of the packet loss ratio are 5% and 1%.
  • If the packet loss ratio in five consecutive measurement intervals exceeds the alarm threshold, the device reports the hwIpfpmLossRatioExceed alarm to the NMS to notify the link fault in real time.
  • If the packet loss ratio in five consecutive measurement intervals falls below the clear alarm threshold, the device reports the hwIpfpmLossRatioRecovery alarm to the NMS to notify link recovery in real time.

Example

# On the GE0/0/1, enable the alarm and clear alarm of the packet loss ratio for packet loss measurement on a direct link.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] iplpm link loss-measure alarm enable

iplpm link loss-measure enable

Function

The iplpm link loss-measure enable command enables packet loss measurement on the direct link.

The undo iplpm link loss-measure enable command disables packet loss measurement on the direct link.

By default, packet loss measurement is disabled on the direct link.

Format

iplpm link loss-measure enable

undo iplpm link loss-measure enable

Parameters

None

Views

GE interface view, XGE interface view

Default Level

2: Configuration level

Usage Guidelines

To accurately locate packet loss on a link, run the iplpm link loss-measure enable command to enable packet loss measurement on the direct link between two devices.

This function must be enabled on both device interfaces of the direct link.

Example

# On the GE0/0/1, enable packet loss measurement on the direct link.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] iplpm link loss-measure enable

iplpm link loss-measure interval

Function

The iplpm link loss-measure interval command configures the interval for packet loss measurement on the direct link.

The undo iplpm link loss-measure interval command restores the default interval for packet loss measurement on the direct link.

By default, the interval for packet loss measurement on the direct link is 10s.

Format

iplpm link loss-measure interval interval

undo iplpm link loss-measure interval

Parameters

Parameter Description Value
interval Specifies the interval for packet loss measurement on the direct link. The value is an integer that can be 1, 10, 60, or 600, in seconds.

Views

GE interface view, XGE interface view

Default Level

2: Configuration level

Usage Guidelines

The interval for packet loss measurement on the direct link refers to the period from received packet statistics collection to sent packet statistics collection on a specified interface. To ensure accuracy of statistics data, run the undo iplpm link loss-measure enable command to disable packet loss measurement on the direct link in the interface view before changing the measurement interval.

Example

# On the GE0/0/1, set the interval for packet loss measurement on the direct link to 60s.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] iplpm link loss-measure interval 60

iplpm loss-measure color-flag

Function

The iplpm loss-measure color-flag command configures the color bit used in device-level packet loss measurement.

The undo iplpm loss-measure color-flag command restores the default color bit used in device-level packet loss measurement.

By default, bit 0 in the Flags field is used as the color bit for device-level packet loss measurement. The default configuration is recommended.

Format

iplpm loss-measure color-flag { tos-bit tos-bit | flags-bit0 }

undo iplpm loss-measure color-flag

Parameters

Parameter Description Value
tos-bit tos-bit Specifies bit 6 or 7 in the ToS field of IP packets as the color bit for device-level packet loss measurement. The value is 6 or 7.
flags-bit0 Specifies bit 0 in the Flags field of IP packets as the color bit for device-level packet loss measurement. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Device-level packet loss measurement contains measurement on the entire device and direct link. Before deploying Packet Conservation Algorithm for Internet (iPCA) to implement device-level packet loss measurement, run this command to configure the color bit. You can select a color bit according to the actual situation and network planning.

Precautions

Before changing the color bit for device-level packet loss measurement, run the undo iplpm global loss-measure enable command in the system view to disable device-level packet loss measurement. If packet loss measurement is configured on the direct link, run the undo iplpm link loss-measure enable command in the interface view to disable packet loss measurement on the direct link and ensure that the color bits on both devices of the direct link are changed to be the same.

When both network-level and device-level packet loss measurements are enabled on a device, the color bits must be differentiated.

Example

# Configure bit 7 in the ToS field as the color bit for device-level packet loss measurement.

<HUAWEI> system-view
[HUAWEI] iplpm loss-measure color-flag tos-bit 7

loss-measure enable

Function

The loss-measure enable command enables statistics collection based on the time range for a measurement instance on a DCP.

The undo loss-measure enable command disables statistics collection for a measurement instance on a DCP.

By default, statistics collection based on the time range is disabled for a measurement instance on a DCP.

Format

loss-measure enable [ mid-point ] [ time-range time-range ]

undo loss-measure enable [ [ mid-point ] time-range [ time-range ] ]

Parameters

Parameter Description Value
mid-point

Enables on-demand packet loss measurement for mid-points.

If this parameter is configured, on-demand packet loss measurement is enabled for all mid-points. If this parameter is not configured, on-demand packet loss measurement is enabled for all measurement points.

NOTE:

The mid-point is only applied to hop-by-hop measurement.

-
time-range time-range Specifies the time range for statistics collection. The value is 5, 10, 15, or 30, in minutes. The default value is 10 minutes.

Views

IPFPM-DCP instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The IP FPM performance statistics serve as a reliable reference for assessing IP network performance and therefore are useful for fault diagnosis and service statistics. To monitor on-demand packet loss performance in a specified period or diagnose network faults and locate faulty nodes when network performance deteriorates, run the loss-measure enable command.

Prerequisites

An IP FPM model has been established, including configuring a DCP and MCP, binding a TLP to a physical interface, and creating a target flow and IP FPM instance.

Precautions

This command is not recorded in the configuration file after being executed.

After device restart, statistics collection based on the time range becomes invalid, and needs to be reconfigured.

Statistics collection based on the time range and continual statistics collection cannot be enabled simultaneously.

Example

# Enable statistics collection based on the time range for a measurement instance on a DCP.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm dcp
[HUAWEI-nqa-ipfpm-dcp] instance 1
[HUAWEI-nqa-ipfpm-dcp-instance-1] loss-measure enable time-range 30

loss-measure enable continual

Function

The loss-measure enable continual command enables continual statistics collection for a measurement instance on a DCP.

The undo loss-measure enable continual command disables continual statistics collection for a measurement instance on a DCP.

By default, continual statistics collection is disabled for a measurement instance on a DCP.

Format

loss-measure enable continual

undo loss-measure enable continual

Parameters

None

Views

IPFPM-DCP instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you are unaware of network performance degrading and want to continuously monitor packet loss on the network, run the loss-measure enable continual command to enable continual statistics collection.

Prerequisites

An IP FPM model has been established, including configuring a DCP and MCP, binding a TLP to a physical interface, and creating a target flow and IP FPM instance.

Precautions

Continual statistics collection and statistics collection based on the time range cannot be enabled simultaneously.

Example

# Enable continual statistics collection for a measurement instance on a DCP.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm dcp
[HUAWEI-nqa-ipfpm-dcp] instance 1
[HUAWEI-nqa-ipfpm-dcp-instance-1] loss-measure enable continual

loss-measure ratio-threshold

Function

The loss-measure ratio-threshold command configures the alarm and clear alarm thresholds of the packet loss ratio for a measurement instance on the MCP.

The undo loss-measure ratio-threshold command restores the default setting.

By default, the alarm and clear alarm thresholds of the packet loss ratio are not configured for a measurement instance on the MCP. That is, no alarm is generated for packet loss.

Format

loss-measure ratio-threshold upper-limit upper-limit lower-limit lower-limit

undo loss-measure ratio-threshold

Parameters

Parameter Description Value
upper-limit upper-limit Specifies the alarm threshold for the packet loss ratio. The value is a string of 1 to 10 digits and in the range of 0.000001 to 100. The value is accurate to six decimal places, in percentage.
lower-limit lower-limit Specifies the clear alarm threshold for the packet loss ratio. The value is a string of 1 to 10 digits and in the range of 0.000001 to 100. The value is accurate to six decimal places, in percentage. lower-limit must be smaller than or equal to upper-limit.

Views

IPFPM-MCP instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the alarm and clear alarm thresholds of the packet loss ratio are configured for a measurement instance on the MCP:
  • If the packet loss ratio in five consecutive measurement intervals exceeds the alarm threshold, the MCP reports the hwIpfpmLossRatioExceed alarm to the NMS to notify the link fault in real time.
  • If the packet loss ratio in five consecutive measurement intervals falls below the clear alarm threshold, the MCP reports the hwIpfpmLossRatioRecovery alarm to the NMS to notify link recovery in real time.

To facilitate operation and maintenance, you are advised to run this command to configure the alarm and clear alarm thresholds of the packet loss ratio for a measurement instance on the MCP according to network performance.

Precautions

If you run the loss-measure ratio-threshold command multiple times, only the latest configuration takes effect.

This command only configures the alarm and clear alarm thresholds of the packet loss ratio for a measurement instance on the MCP. The hwIpfpmLossRatioExceed and hwIpfpmLossRatioRecovery alarms are triggered only when the alarm and clear alarm functions are enabled and the packet loss ratio in five consecutive measurement intervals reaches the threshold.

Example

# Set the alarm and clear alarm thresholds of the packet loss ratio to 10% and 5.5% for measurement instance 1.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm mcp
[HUAWEI-nqa-ipfpm-mcp] instance 1
[HUAWEI-nqa-ipfpm-mcp-instance-1] loss-measure ratio-threshold upper-limit 10 lower-limit 5.5

mcp (IPFPM-DCP view)

Function

The mcp command associates the MCP ID with all measurement instances of a DCP.

The undo mcp command disassociates the MCP ID from all measurement instances of a DCP.

By default, no MCP ID is associated with a measurement instance of a DCP.

Format

mcp mcp-id [ port port-number ] [ vpn-instance vpn-instance-name | net-manager-vpn ]

undo mcp

Parameters

Parameter Description Value
mcp-id Specifies the MCP ID associated with all measurement instances of a DCP. It is recommended that you configure the router ID of the device as the MCP ID. The value is in dotted decimal notation.
port port-number Specifies the UDP port number through which the DCP and MCP communicate with each other. The value is an integer that ranges from 1024 to 65535. The default value is 65030 and is recommended.
vpn-instance vpn-instance-name Specifies the VPN instance where the DCP and MCP communicate with each other. The value must be an existing VPN instance name.
net-manager-vpn Specifies the manager VPN where the DCP and MCP communicate with each other. -

Views

IPFPM-DCP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In the IP Flow Performance Measurement (FPM) system, each measurement instance belongs to an MCP. Before a DCP sends statistics data of a measurement instance from TLPs to the MCP, you must associate the MCP ID with the measurement instance. The mcp command associates the MCP ID with all measurement instances of a DCP.

A DCP encapsulates statistics data collected from Target Logical Ports (TLPs) and MCP ID associated with all measurement instances on the DCP in a packet, and sends the packet with the MCP ID as the destination IP address. After receiving the packet sent from the DCP, the MCP compares the MCP ID in the packet with the MCP ID configured by the mcp id command:
  • If the two MCP IDs are the same, the MCP accepts the packet, and then summarizes and calculates the statistics data.
  • If the two MCP IDs are different, the MCP considers the packet invalid and discards it.

Prerequisites

Global DCP has been enabled using the nqa ipfpm dcp command.

NOTE:
If the DCP is required to send statistics data to the MCP through a specified VPN instance or manager VPN, the VPN instance must have been created on the DCP before you run the mcp command with vpn-instance vpn-instance-name or net-manager-vpn specified.

Precautions

The MCP ID must be an IP address that DCPs can reach and must be the same as the MCP ID configured by the mcp id command on the MCP.

The UDP port number through which the DCP and MCP communicate with each other must be the same as the UDP port number configured by the protocol udp port command.

The mcp command associates the MCP ID with all measurement instances on the DCP. However, if some measurement instances on the DCP have been associated with the MCP ID configured by the mcp command, the measurement instances still use the MCP ID in the IPFPM-DCP instance view.

Example

# Associate the MCP ID with all measurement instances of a DCP.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm dcp
[HUAWEI-nqa-ipfpm-dcp] mcp 10.1.1.1

mcp (IPFPM-DCP instance view)

Function

The mcp command associates the MCP ID with a measurement instance of a DCP.

The undo mcp command disassociates the MCP ID from a measurement instance of a DCP.

By default, no MCP ID is associated with a measurement instance of a DCP.

Format

mcp mcp-id [ port port-number ] [ vpn-instance vpn-instance-name | net-manager-vpn ]

undo mcp

Parameters

Parameter Description Value
mcp-id Specifies the MCP ID associated with a measurement instance of a DCP. It is recommended that you configure the router ID of the device as the MCP ID. The value is in dotted decimal notation.
port port-number Specifies the UDP port number through which the DCP and MCP communicate with each other. The value is an integer that ranges from 1024 to 65535. The default value 65030 is recommended.
vpn-instance vpn-instance-name Specifies the VPN instance where the DCP and MCP communicate with each other. The value is a string of 1 to 31 case-sensitive characters without spaces.
net-manager-vpn Specifies the manager VPN where the DCP and MCP communicate with each other. -

Views

IPFPM-DCP instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Before a DCP sends statistics data of a measurement instance from TLPs to the MCP, you must associate the MCP ID with the measurement instance. The mcp command associates the MCP ID with a measurement instance of a DCP.

A DCP encapsulates statistics data collected from Target Logical Ports (TLPs) and MCP ID associated with a measurement instance of the DCP in a packet, and sends the packet with the MCP ID as the destination IP address. After receiving the packet sent from the DCP, the MCP compares the MCP ID in the packet with the MCP ID configured by the mcp id command:
  • If the two MCP IDs are the same, the MCP accepts the packet, and then summarizes and calculates the statistics data.
  • If the two MCP IDs are different, the MCP considers the packet invalid and discards it.

Prerequisites

A measurement instance has been created on the DCP using the instance command.

Precautions

The MCP ID must be an IP address that DCPs can reach and must be the same as the MCP ID configured by the mcp id command on the MCP.

The UDP port number through which the DCP and MCP communicate with each other must be the same as the UDP port number configured by the protocol udp port command.

The VPN instance has been created on the DCP before you configure vpn-instance vpn-instance-name or net-manager-vpn to allow the DCP to report the statistics to the MCP through the specified VPN or management VPN.

Example

# Associate the MCP ID with a measurement instance of a DCP.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm dcp
[HUAWEI-nqa-ipfpm-dcp] instance 1
[HUAWEI-nqa-ipfpm-dcp-instance-1] mcp 10.1.1.1

mcp id

Function

The mcp id command configures the MCP ID in the IP Flow Performance Measurement (FPM) system.

The undo mcp id command deletes the MCP ID.

By default, no MCP ID is configured.

Format

mcp id mcp-id

undo mcp id

Parameters

Parameter Description Value
mcp-id Specifies the MCP ID. It is recommended that you configure the router ID of the device as the MCP ID. The value is in dotted decimal notation.

Views

IPFPM-MCP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the MCP communicates with a DCP, the DCP encapsulates statistics data collected from TLPs and MCP ID associated with a measurement instance by the mcp command in a packet, and sends the packet with the MCP ID as the destination IP address. After receiving the packet sent from the DCP, the MCP compares the MCP ID in the packet with the MCP ID of the device:
  • If the two MCP IDs are the same, the MCP accepts the packet, and then summarizes and calculates the statistics data.
  • If the two MCP IDs are different, the MCP considers the packet invalid and discards it.
This command configures the MCP ID.

Prerequisites

Global MCP has been enabled using the nqa ipfpm mcp command.

Precautions

The MCP ID must be an IP address that a DCP can reach and must be the same as the MCP ID configured by the mcp command on the DCP. If you have changed the MCP ID, you must change the MCP ID associated with measurement instances on the DCP; otherwise, the DCP cannot communicate with the MCP.

Example

# Set the MCP ID.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm mcp
[HUAWEI-nqa-ipfpm-mcp] mcp id 10.1.1.1

measure disable (IPFPM-MCP instance view)

Function

The measure disable command disables measurement of all indicators in a measurement instance on the MCP.

Both the undo measure disable and measure enable commands enable measurement of all indicators in a measurement instance on the MCP.

By default, measurement of all indicators is enabled in a measurement instance on the MCP.

Format

measure disable

measure enable

undo measure disable

Parameters

None

Views

IPFPM-MCP instance view

Default Level

2: Configuration level

Usage Guidelines

If the MCP receives error data during the DCP configuration update, you can run the measure disable command to disable measurement of all indicators in a measurement instance on the MCP. When the DCP configuration update is complete, run the undo measure disable or measure enable command to enable measurement of all indicators in a measurement instance on the MCP so that data of the measurement instance is more accurate.

Example

# Disable measurement of all indicators in measurement instance 1 on the MCP.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm mcp
[HUAWEI-nqa-ipfpm-mcp] instance 1
[HUAWEI-nqa-ipfpm-mcp-instance-1] measure disable
Related Topics

nqa ipfpm dcp

Function

The nqa ipfpm dcp command enables global DCP and displays the IPFPM-DCP view, or directly displays the IPFPM-DCP view if global DCP has been enabled.

The undo nqa ipfpm dcp command disables global DCP.

By default, global DCP is disabled.

Format

nqa ipfpm dcp

undo nqa ipfpm dcp

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Before performing packet loss measurement for service traffic, run the nqa ipfpm dcp command to enable global DCP and enter the IPFPM-DCP view.

Follow-up Procedure

Run the dcp id command to set the DCP ID.

Precautions

DCP and MCP functions can be configured on the same device.

Example

# Enable global DCP and enter the IPFPM-DCP view.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm dcp
[HUAWEI-nqa-ipfpm-dcp]
Related Topics

nqa ipfpm mcp

Function

The nqa ipfpm mcp command enables global MCP and displays the IPFPM-MCP view, or directly displays the IPFPM-MCP view if global MCP has been enabled.

The undo nqa ipfpm mcp command disables global MCP.

By default, global MCP is disabled.

Format

nqa ipfpm mcp

undo nqa ipfpm mcp

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Before performing packet loss measurement for service traffic, run the nqa ipfpm mcp command to enable global MCP and enter the IPFPM-MCP view.

Follow-up Procedure

Run the mcp id command to set the MCP ID.

Precautions

MCP and DCP functions can be configured on the same device.

Example

# Enable global MCP and enter the IPFPM-MCP view.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm mcp
[HUAWEI-nqa-ipfpm-mcp]
Related Topics

out-group

Function

The out-group command creates a Target Logical Port (TLP) out-group for the target flow.

The undo out-group command deletes a TLP out-group or deletes a TLP from a TLP out-group.

By default, no TLP out-group is configured for the target flow.

Format

out-group dcp dcp-id tlp tlp-id

undo out-group [ dcp dcp-id tlp tlp-id ]

Parameters

Parameter Description Value
dcp dcp-id Indicates a DCP to which TLPs in a TLP out-group belongs.

This value is in dotted decimal notation.

tlp tlp-id Indicates a TLP in a TLP out-group.

The value is an integer ranging from 1 to 16777215.

Views

IPFPM-MCP-ACH view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To measure the packet loss or delay of service packets leaving a network, run the out-group command. In IP FPM hop-by-hop performance statistics scenarios, a hop is a set of links and interfaces that service packets travel through, from one measurement point or group to the next measurement point or group, and therefore is represented by (TLP in-group, TLP out-group). Performance statistics are implemented on the TLP in-point or in-group through which service packets enter a network and the TLP out-point or out-group through which service packets leave the network.

Prerequisites

The ach command has been run to create an ACH and display the ACH view.

Example

# Create a TLP out-group for the target flow.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm mcp
[HUAWEI-nqa-ipfpm-mcp] instance 1
[HUAWEI-nqa-ipfpm-mcp-instance-1] ach 1
[HUAWEI-nqa-ipfpm-mcp-instance-1-ach-1] out-group dcp 10.1.1.1 tlp 100

protocol udp port

Function

The protocol udp port command configures the UDP port number through which the DCP and MCP communicate with each other.

The undo protocol udp port command restores the default UDP port number through which the DCP and MCP communicate with each other.

By default, the DCP and MCP communicate with each other through UDP port 65030. The default configuration is recommended.

Format

protocol udp port port-number

undo protocol udp port

Parameters

Parameter Description Value
port-number Specifies the UDP port number through which the DCP and MCP communicate with each other. The value is an integer that ranges from 1024 to 65535.

Views

IPFPM-MCP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The DCP uses UDP and default port 65030 to send statistics data to the MCP. To change the UDP port number, run this command.

Prerequisites

Global MCP has been enabled using the nqa ipfpm mcp command.

Precautions

The UDP port number of the DCP must be the same as the UDP port number configured by the mcp (IPFPM-DCP instance view) command on the DCP. If a UDP port number is changed on an MCP, it must be changed for all DCPs associated with this MCP in an IP FPM instance. Otherwise, the MCP cannot process the statistics reported by the DCPs.

Example

# Specify UDP port 1024 through which the DCP and MCP communicate with each other.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm mcp
[HUAWEI-nqa-ipfpm-mcp] protocol udp port 1024

snmp-agent trap enable feature-name ipfpm

Function

The snmp-agent trap enable feature-name ipfpm command enables the trap function for the IP Flow Performance Measurement (FPM) module.

The undo snmp-agent trap enable feature-name ipfpm command disables the trap function for the IP FPM module.

By default, the trap function is disabled for the IP FPM module.

Format

snmp-agent trap enable feature-name ipfpm [ trap-name { hwipfpmlossratioexceed | hwipfpmlossratiorecovery | hwipfpmtlpexceed | hwipfpmtlprecovery } ]

undo snmp-agent trap enable feature-name ipfpm [ trap-name { hwipfpmlossratioexceed | hwipfpmlossratiorecovery | hwipfpmtlpexceed | hwipfpmtlprecovery } ]

Parameters

Parameter Description Value
trap-name Enables the trap function for the specified event. -
hwipfpmlossratioexceed Enables the trap function about the packet loss ratio exceeding the threshold. -
hwipfpmlossratiorecovery Enables the trap function about the packet loss ratio restoration. -
hwipfpmtlpexceed Enables the trap function for TLPs exceeding the specifications. -
hwipfpmtlprecovery Enables the trap function for TLP specification restoration. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The Simple Network Management Protocol (SNMP) is a network management standard widely used on the TCP/IP network. It uses a central computer (a network management station) that runs network management software to manage network elements. The SNMP agent reports trap messages to the network management station so that the network management station can obtain the network status in a timely manner, and the network administrator can take measures accordingly.

The snmp-agent trap enable feature-name ipfpm command enables the trap function for the IP FPM module.

Precautions

To enable the trap function for one or several events, specify trap-name. If trap-name is not specified, all trap functions are enabled for the IP FPM module.

Example

# Enable the trap function about the packet loss ratio exceeding the threshold.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable feature-name ipfpm trap-name hwipfpmlossratioexceed

snmp-agent trap enable feature-name iplpm

Function

The snmp-agent trap enable feature-name iplpm command enables the trap function for the IP Local Performance Measurement (LPM) module.

The undo snmp-agent trap enable feature-name iplpm command disables the trap function for the IP LPM module.

By default, the trap function is enabled for the IP LPM module.

Format

snmp-agent trap enable feature-name iplpm [ trap-name { hwiplpmgloballossratioexceed | hwiplpmgloballossratiorecovery | hwiplpmlinkforwardlossratioexceed | hwiplpmlinkforwardlossratiorecovery } ]

undo snmp-agent trap enable feature-name iplpm [ trap-name { hwiplpmgloballossratioexceed | hwiplpmgloballossratiorecovery | hwiplpmlinkforwardlossratioexceed | hwiplpmlinkforwardlossratiorecovery } ]

Parameters

Parameter Description Value
trap-name Enables the trap function for the specified event. -
hwiplpmgloballossratioexceed Enables the trap function about the packet loss ratio exceeding the threshold on the device. -
hwiplpmgloballossratiorecovery Enables the trap function about the packet loss ratio restoration on the device. -
hwiplpmlinkforwardlossratioexceed Enables the trap function about the packet loss ratio exceeding the threshold on the direct link. -
hwiplpmlinkforwardlossratiorecovery Enables the trap function about the packet loss ratio restoration on the direct link. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The Simple Network Management Protocol (SNMP) is a network management standard widely used on the TCP/IP network. It uses a central computer (a network management station) that runs network management software to manage network elements. The SNMP agent reports trap messages to the network management station so that the network management station can obtain the network status in a timely manner, and the network administrator can take measures accordingly.

The snmp-agent trap enable feature-name iplpm command enables the trap function for the IP LPM module.

Precautions

To enable the trap function for one or several events, specify trap-name. If trap-name is not specified, all trap functions are enabled for the IP LPM module.

Example

# Enable the trap function about the packet loss ratio exceeding the threshold on the direct link.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable feature-name iplpm trap-name hwiplpmlinkforwardlossratioexceed

tlp

Function

The tlp command configures Target Logical Ports (TLPs) of an IP FPM instance and their roles.

The undo tlp command deletes TLPs of a measurement instance.

By default, no TLP of a measurement instance is configured.

Format

tlp tlp-id { in-point | out-point } { ingress | egress }

tlp tlp-id mid-point flow { forward | backward | bidirectional } { ingress | egress }

undo tlp tlp-id

Parameters

Parameter Description Value
tlp-id Specifies the ID of a TLP. The value is an integer that ranges from 1 to 16777215.
in-point Indicates the in-point TLP. An in-point TLP colors a target flow. -
out-point Indicates the out-point TLP. An out-point TLP removes the color flag from a target flow. -
ingress Indicates the ingress TLP. An ingress TLP only receives packets. -
egress Indicates the egress TLP. An egress TLP only sends packets. -
mid-point

Indicates the TLP as a mid-point.

-
flow

Indicates the target flow.

-
forward

Indicates the forward target flow.

-
backward

Indicates the backward target flow.

-
bidirectional

Indicates the bidirectional target flows.

-

Views

IPFPM-DCP instance view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To locate faults in IP FPM performance statistics scenarios, run the tlp command to configure TLPs in an IP FPM instance. TLPs are measurement points along the path of the target flow and compile and output the statistics. TLPs can be in-points, mid-points, or out-points.

Precautions

A TLP that functions as the in-point for the forward target flow is the out-point for the backward target flow. The TLP role specified in the tlp command applies only to the forward target flow, and the reverse of the specified role is used for the backward target flow.

Mid-points apply only to IP FPM hop-by-hop performance statistics scenarios. Therefore, you must configure flow to specify the target flow direction when specifying a TLP as a mid-point.

A TLP cannot function as both the in-point and out-point for the same unidirectional target flow.

Example

# Configure TLP 100 and its role for measurement instance 1.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm dcp
[HUAWEI-nqa-ipfpm-dcp] instance 1
[HUAWEI-nqa-ipfpm-dcp-instance-1] tlp 100 in-point ingress
Translation
Download
Updated: 2019-10-09

Document ID: EDOC1000178165

Views: 47410

Downloads: 1159

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next