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

S12700 V200R013C00 Command Reference

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).
Performance Management Commands

Performance Management Commands

Command Support

Commands provided in this section and all the parameters in the commands are supported by all switch models by default, unless otherwise specified. For details, see specific commands.

binding

Function

The binding command binds an instance to a performance statistics collection task.

The undo binding command unbinds an instance from a performance statistics collection task.

By default, no instance is bound to a performance statistics collection task.

Format

binding instance-type instance-type all

binding instance-type instance-type instance instance-name &<1-5>

undo binding instance-type instance-type { all | instance instance-name &<1-5> }

Parameters

Parameter Description Value
instance-type instance-type

Specifies the type of an instance bound to a performance statistics collection task.

The enumerated values include:
  • ipfpm: collects IP FPM statistics.

  • uni-mng-as-port: collects statistics on an AS port.

  • wlan-ap: collects AP statistics:

  • wlan-radio: collects statistics about a specified AP radio.

  • wlan-ssid: collects statistics about a service set bound to a specific AP radio.

  • wlan-ap-wiredport: collects statistics on an AP wired port.

all

Binds all instances.

When all is specified, instance-type can only be ipfpm.

-

instance instance-name

Specifies the name of an instance of a specific type.

The value is a string of 1 to 255 case-insensitive characters.
  • When instance-type is ipfpm, the instance-name value is configured using the instance (IPFPM-MCP view) command.

  • When instance-type is uni-mng-as-port, the instance-name value is AS name+interface number, for example, as1 gigabitethernet1/0/1.

  • When instance-type is wlan-ap, the instance-name value is ap-id. For example, 1 indicates AP 1.

  • When instance-type is wlan-radio, the instance-name value is ap-id.radio-id. For example, 0.1 indicates radio 1 of AP 0.

  • When instance-type is wlan-ssid, the instance-name value is ap-id.radio-id.SSID name length.SSID name ASCII code. For example, 1.0.5.98.99.100.101.102 indicates the SSID with the name bcdef and name length 5 of radio 0 of AP 1.

  • When instance-type is wlan-ap-wiredport, the instance-name value is ap-id.port type x 100+port number. For example, 0.101 indicates FE port 1 of AP 0. The port type can be 1 (an FE port) or 2 (a GE port). The port number ranges from 0 to 99.

Views

Performance statistics collection task view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The binding command is used to bind an instance to a performance statistics task so that the system can collect the performance statistics about the instance. Multiple instances can be bound to a performance statistics collection task.

Prerequisites

The traffic statistics function has been enabled using the statistics enable command. Otherwise, the binding command cannot take effect.

Precautions

If multiple performance statistics tasks are bound to the same interface to collect interface statistics, the peak values of the tasks are inaccurate.

If instance-type is set to uni-mng-as-port, performance statistics on interfaces of the AS are collected. The interval for collecting traffic statistics on interfaces configured by the set flow-stat interval interval-time command must be shorter than the interval for collecting performance statistics configured by the statistics-cycle cycle command. If the value of interval-time is greater than the value of cycle, performance statistics on interfaces are incorrect. This is because the statistics about the rate and bandwidth usage on interfaces remain the same within the interval specified by interval-time.

Example

# Bind all instances in IP FPM to performance statistics collection task task1.

<HUAWEI> system-view
[HUAWEI] nqa ipfpm mcp
[HUAWEI-nqa-ipfpm-mcp] instance 1
[HUAWEI-nqa-ipfpm-mcp-instance-1] quit
[HUAWEI-nqa-ipfpm-mcp] quit
[HUAWEI] pm
[HUAWEI-pm] statistics-task task1
[HUAWEI-pm-statistics-task1] binding instance-type ipfpm all
Related Topics

display pm brief

Function

The display pm brief command displays brief PM information.

Format

display pm brief

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After PM is configured, you can run the display pm brief command to view brief PM information, such as the PM status, number of performance statistics tasks, number of performance statistics files.

Example

# Display brief PM information.

<HUAWEI> display pm brief
Statistics Status                   : disable
Statistics Start Time               : -
Number of Statistics Tasks          : 2
Number of Active Statistics Objects : 0
Number of Configured Pm Servers     : 0
Number of Statistics Files          : 0
Statistics Files Saved Directory    : /pmdata/
Table 16-44  Description of the display pm brief command output

Item

Description

Statistics Status
Whether the performance statistics function is enabled:
  • enable: enabled
  • disable: disabled

You can run the statistics enable command to configure this parameter.

Statistics Start Time Time when the performance statistics function starts.
Number of Statistics Tasks Number of performance statistics tasks.
Number of Active Statistics Objects Number of current performance statistics objects.
Number of Configured Pm Servers Number of configured PM servers.
Number of Statistics Files Number of performance statistics files.
Statistics Files Saved Directory Path where performance statistics files are saved.

display pm measure-info

Function

The display pm measure-info command displays information about performance statistics counters.

Format

display pm measure-info [ instance-type instance-type ]

Parameters

Parameter Description Value
instance-type instance-type

Specifies the type of an instance bound to a performance statistics task.

The enumerated values include:
  • ipfpm: collects IP FPM statistics.

  • uni-mng-as-port: collects statistics on an AS port.

  • wlan-ap: collects AP statistics:

  • wlan-radio: collects statistics about a specified AP radio.

  • wlan-ssid: collects statistics about a service set bound to a specific AP radio.

  • wlan-ap-wiredport: collects statistics on an AP wired port.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Before running the measure disable command to configure performance statistics counters for instances of a specific type, run the display pm measure-info command to view information about available performance statistics counters, including the name, type, maximum value, and minimum value of each counter.

Example

# Display information about performance statistics counters of the instance of the IPFPM type.

<HUAWEI> display pm measure-info instance-type ipfpm
Total instance types: 1, total measures: 10
--------------------------------------------------------------------------------
Instance Type: ipfpm, Measures Count: 10
  Measure Name                : forward-loss-ratio-max
  Measure Type                : Maximum
  Measure Counter Size(bits)  : 32
  Measure MaxValue            : 100000000
  Measure MinValue            : -100000000

  Measure Name                : forward-loss-ratio-min
  Measure Type                : Minimum
  Measure Counter Size(bits)  : 32
  Measure MaxValue            : 100000000
  Measure MinValue            : -100000000

  Measure Name                : forward-loss-pkts-inc
  Measure Type                : Increase
  Measure Counter Size(bits)  : 64
  Measure MaxValue            : 9223372036854775807
  Measure MinValue            : -9223372036854775808
......
Table 16-45  Description of the display pm measure-info command output

Item

Description

Total instance types

Total types of measurement instances.

total measures

Total statistics counters.

Instance Type

Type of an instance.

Measures Count

Number of a performance statistics counter.

Measure Name

Name of a performance statistics counter.

Measure Type

Type of a performance statistics counter. The value can be:

  • Increase: Accumulated performance statistics are compared with the counter.
  • Actual: The currently collected performance statistics are compared with the counter.
  • Maximum: The maximum performance statistics are compared with the counter.
  • Minimum: The minimum performance statistics are compared with the counter.
  • Average: The average performance statistics are compared with the counter.

Measure Counter Size(bits)

Size of a performance statistics counter, 32 bits or 64 bits.

Measure MaxValue

Maximum value of a performance statistics counter.

Measure MinValue

Minimum value of a performance statistics counter.

display pm statistics

Function

The display pm statistics command displays the collected performance statistics.

Format

display pm statistics task-name data-index index [ instance-type instance-type [ measure measure-name | instance instance-name &<1-5> ] * ]

Parameters

Parameter Description Value
task-name Displays the performance statistics of a specified performance statistics collection task.

The value is a string of 1 to 31 case-insensitive characters, spaces not supported. The string contains letters, digits, and underscores (_), and must start with letters or digits.

data-index index Displays the performance statistics collected at a specified interval.

The value is an integer that ranges from 0 to 16.

  • If the value is 0, the current performance statistics are displayed.

  • If the value is larger than 0, the performance statistics collected in one or more cycles are displayed. The smaller the value, the latest the statistics. If a short performance statistics collection cycle (5, 10, 15, 30, or 60 minutes) is set, the value of index ranges from 1 to 16. If a long performance statistics collection cycle (1440 minutes) is set, the value of index ranges from 1 to 3.

instance-type instance-type

Specifies the type of an instance bound to a performance statistics collection task.

The enumerated values include:
  • ipfpm: collects IP FPM statistics.

  • uni-mng-as-port: collects statistics on an AS port.

  • wlan-ap: collects AP statistics:

  • wlan-radio: collects statistics about a specified AP radio.

  • wlan-ssid: collects statistics about a service set bound to a specific AP radio.

  • wlan-ap-wiredport: collects statistics on an AP wired port.

measure measure-name Specifies the name of a statistics counter.

The value is a string of 1 to 63 case-insensitive characters without spaces. Select statistics counters according to the device configuration.

instance instance-name Specifies the name of an instance.
The value is a string of 1 to 255 case-insensitive characters.
  • When instance-type is ipfpm, the instance-name value is configured using the instance (IPFPM-MCP view) command.

  • When instance-type is uni-mng-as-port, the instance-name value is AS name+interface number, for example, as1 gigabitethernet1/0/1.

  • When instance-type is wlan-ap, the instance-name value is ap-id. For example, 1 indicates AP 1.

  • When instance-type is wlan-radio, the instance-name value is ap-id.radio-id. For example, 0.1 indicates radio 1 of AP 0.

  • When instance-type is wlan-ssid, the instance-name value is ap-id.radio-id.SSID name length.SSID name ASCII code. For example, 1.0.5.98.99.100.101.102 indicates the SSID with the name bcdef and name length 5 of radio 0 of AP 1.

  • When instance-type is wlan-ap-wiredport, the instance-name value is ap-id.port type x 100+port number. For example, 0.101 indicates FE port 1 of AP 0. The port type can be 1 (an FE port) or 2 (a GE port). The port number ranges from 0 to 99.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To view the current or historical performance statistics, run the display pm statistics command. The system can display the current performance statistics and historical performance statistics collected in a maximum of 16 cycles.

Prerequisites

  • An instance has been bound to the current performance statistics using binding command.
  • Performance statistics has been enabled for the current performance statistics task using statistics enable command.

Precautions

To display the performance statistics, confirm that the performance statistics task is running.

Example

# Display the current performance statistics of the performance statistics collection task task1.

<HUAWEI> display pm statistics task1 data-index 0
Total measures count: 10
--------------------------------------------------------------------------------
Instance Type        : ipfpm
Instance Name        : 1
Measure Name         : forward-loss-ratio-max
Measure Data         : 0
Valid Flag           : no statistics
Timestamp            : 2014-04-15 11:17:00

......
Table 16-46  Description of the display pm statistics command output

Item

Description

Total measures count

Number of a performance statistics counter.

Instance Type

Type of an instance bound to a performance statistics collection task.

Instance Name

Name of an instance bound to a performance statistics collection task.

Measure Name

Name of a performance statistics counter.

Measure Data

Statistics counter.

Valid Flag

Valid flag of the performance statistics. The value can be:

  • no statistics: The performance statistics are not collected.
  • valid: The performance statistics are valid.
  • incredible value: The performance statistics are not reliable.
  • measure not configured: The statistics counter is disabled.

Timestamp

Time when the performance statistics are collected.

display pm statistics-file

Function

The display pm statistics-file command displays performance statistics files.

Format

display pm statistics-file [ task-name ]

Parameters

Parameter Description Value
task-name Displays the performance statistics files generated for a performance statistics task.

The value is a string of 1 to 31 case-insensitive characters, spaces not supported. The string contains letters, digits, and underscores (_), and must start with letters or digits.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After a performance statistics task starts, the system automatically generates performance statistics files for the task. To view the performance statistics files generated for the performance statistics task, run the display pm statistics-file command.

Example

# Display performance statistics files for all performance statistics tasks.

<HUAWEI> display pm statistics-file
Total files count: 1                                                            
--------------------------------------------------------------------------------
Task Name: test                                                                 
  test20130701150001.txt                                                        
                                                                                
Table 16-47  Description of the display pm statistics-file command output

Item

Description

Total files count

Number of performance statistics files.

Task Name

Name of a performance statistics task.

You can run the statistics-task command to configure this parameter.

test20130701150001.txt

Name of the performance statistics file.

display pm statistics-task

Function

The display pm statistics-task command displays information about a performance statistics collection task.

Format

display pm statistics-task [ task-name ]

Parameters

Parameter Description Value
task-name Displays the information about a specified performance statistics collection task.

The performance statistics collection task must exists.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to check information about a performance statistics collection task, including the running status of the task, statistics collection cycle, and type of the instance bound to the task.

Example

# Display information about performance statistics collection tasks.

<HUAWEI> display pm statistics-task
Total task count: 1
--------------------------------------------------------------------------------
Task Name                : task1
Task State               : ready
Record-file Status       : enable
Threshold Alarm Status   : disable
Task Cycle               : 15 minutes
Sample Interval          : 3 minutes
Instance Type            : -
Record Interval(cycle)   : 4
File Format              : text
File Name Prefix         : task1
File Transfer Mode       : passive
Current File Name        : -
Table 16-48  Description of the display pm statistics-task command output

Item

Description

Total task count

Number of performance statistics collection tasks.

Task Name

Name of a performance statistics collection task.

The task name is specified in the statistics-task task-name command.

Task State

Running status of a performance statistics collection task.

Record-file Status

Whether performance statistics file generation is enabled. The value can be:
  • enable: This function is enabled.

  • disable: This function is not enabled.

This function is configured using the record-file disable command.

Threshold Alarm Status

Whether the threshold alarm function is enabled. The value can be:
  • enable: This function is enabled.

  • disable: This function is not enabled.

This function is configured using the threshold-alarm enable command.

Task Cycle

Performance statistics collection cycle configured in a performance statistics collection task.

This parameter is configured using the statistics-cycle cycle command.

Sample Interval

Sampling interval configured in a performance statistics collection task.

This parameter is configured using the sample-interval interval command.

Instance Type

Type of an instance bound to a performance statistics collection task.

This parameter is configured using the binding instance-type instance-type { all | instance instance-name &<1-5> } command.

Record Interval(cycle)

Interval at which the system generates performance statistics files.

This parameter is configured using the record-interval interval command.

File Format

Format of performance statistics files.

File Name Prefix

Name prefix of a performance statistics file.

File Transfer Mode

Mode in which statistics files are uploaded to the performance management server. The value can be:
  • active: The device automatically uploads statistics files to the performance management server, this function is configured using the upload auto command.

  • passive: The device uploads statistics files to the performance management server following the instructions from the command line interface or network management system, this function is configured using the upload command.

Current File Name

Name of the current performance statistics file.

display snmp-agent trap feature-name pm all

Function

The display snmp-agent trap feature-name pm all command displays whether the switch is enabled to send traps of PM feature to the NMS.

Format

display snmp-agent trap feature-name pm all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

After running the snmp-agent trap enable feature-name pm command to enable the function of sending traps of the PM feature to the NMS, you can run the display snmp-agent trap feature-name pm 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 PM feature to the NMS.

<HUAWEI> display snmp-agent trap feature-name pm all
------------------------------------------------------------------------------  
Feature name: PM                                                                
Trap number : 3                                                                 
------------------------------------------------------------------------------  
Trap name                       Default switch status   Current switch status   
hwPMStatisticsTaskThresholdTriggerAlarm                                         
                                on                      on                      
hwPMStatisticsTaskThresholdClearAlarm                                           
                                on                      on                      
hwPMMeasureExceed               on                      on                      
Table 16-49  Description of the display snmp-agent trap feature-name pm all command output

Item

Description

Feature name

Name of the feature that generates traps.

Trap number

Number of traps generated by PM feature.

Trap name

Name of the trap.

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 pm command.

measure disable

Function

The measure disable command disables statistics counters in a performance statistics task.

The undo measure disable or measure enable command enables statistics counters in a performance statistics task.

By default, all statistics counters of the instance bound to the performance statistics collection task are measured.

Format

measure disable [ measure-name ]

undo measure disable [ measure-name ]

measure enable [ measure-name ]

Parameters

Parameter Description Value
measure-name Specifies the name of a statistics counter in a performance statistics collection task.

The value is a string of 1 to 63 case-insensitive characters without spaces. Select statistics counters according to the device configuration.

Views

Performance statistics collection task view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the type of the instance bound to a performance statistics task is specified, statistics counters of instances of the specified type are enabled by default. The measure disable command can be used to disable some or all statistics counters.

After you run the measure disable [ measure-name ] command, some or all statistics counters are disabled. To add one or more counters that have been disabled to the performance statistics task again, run the measure enable [ measure-name ] or undo measure disable [ measure-name ] command to enable these counters.

Prerequisites

An instance has been bound to a performance statistics task using the binding instance-type instance-type-name instance instance-name command.

The performance statistics function has been enabled using the statistics enable command.

Example

# Disable measurement of the forward-loss-ratio-max counter for ipfpm instances.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] statistics-task task1
[HUAWEI-pm-statistics-task1] binding instance-type ipfpm all
[HUAWEI-pm-statistics-task1] measure disable forward-loss-ratio-max

path

Function

The path command configures the destination path to save performance statistics files on the PM server.

The undo path command deletes the configured destination path.

By default, performance statistics files are uploaded to the default path on a PM server.

Format

path destination-path

undo path

Parameters

Parameter Description Value
destination-path

Specifies the destination path to save performance statistics files on the PM server.

The value is a string of 1 to 63 case-sensitive characters without spaces.

Views

PM server view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To upload performance statistics files to a specific path on the PM server, run the path command to specify the destination path.

Precautions

The specified destination path must exist in the performance management server. Otherwise, the statistics file cannot be uploaded to the server.

Example

# Specify the destination path to save performance statistics on the PM server.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] pm-server server1
[HUAWEI-pm-server-server1] path d:/pmdata
Related Topics

pm

Function

The pm command displays the PM view.

Format

pm

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

To enable the performance statistics function of PM, run the pm command to display the PM view.

Example

# Display the PM view.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm]

pm-server

Function

The pm-server command creates a process serving the PM server and displays the view of the PM server created in the process. If there is an existing PM server view, the pm-server command displays the PM server view without creating a process.

The undo pm-server command deletes the created process.

By default, no process serving the PM server is created.

Format

pm-server server-name

undo pm-server server-name

Parameters

Parameter Description Value
server-name Specifies the name of the process serving the PM server.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. The string contains letters, digits, and underscores (_), and must start with letters or digits.

Views

PM view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To upload generated performance statistics files to the PM server, run the pm-server command to create a process serving the PM server.

Follow-up Procedure

Configure the IP address and port number for the PM server, and user name and password for logging in to the PM server. Performance statistics files are uploaded to the PM server using FTP or SFTP.

Precautions

If a device is enabled to upload performance statistics files to a PM server, the process serving the PM server cannot be deleted.

Example

# Create a process named server1 to serve the PM server.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] pm-server server1
[HUAWEI-pm-server-server1]

protocol (PM server view)

Function

The protocol command configures the parameters for connecting to a PM server.

The undo protocol command deletes the parameters for connecting to a PM server.

By default, no PM server connection parameter is configured.

Format

protocol { ftp | sftp } ip-address ip-address [ port port-number | { net-manager-vpn | vpn-instance vpn-instance-name } ] *

undo protocol

Parameters

Parameter Description Value
ftp Uses the FTP protocol to upload performance statistics files. -
sftp Uses the SFTP protocol to upload performance statistics files. -
ip-address ip-address Specifies the IP address of the PM server. The value is in dotted decimal notation.
port port-number

Specifies the port number.

The value is an integer that ranges from 1 to 65535. The default port number is 21 (using FTP) or 22 (using SFTP).

net-manager-vpn

Indicates the network management VPN.

-
vpn-instance vpn-instance-name

Specifies a VPN instance name.

The value must be an existing VPN instance name.

Views

PM server view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To upload statistics files to a PM server, use this command to configure connection parameters, including the transfer protocol, IP address, and port number of the PM server.

If the PM server uses a private IP address, you can use the net-manager-vpn parameter to specify a network management VPN or use the vpn-instance vpn-instance-name parameter to specify a VPN instance to upload a performance statistics file.

Precautions

Using FTP to upload performance statistics files is insecure. Therefore, using SFTP is recommended.

Example

# Configure the device to upload performance statistics files to the SFTP server with the IP address 10.1.1.1.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] pm-server server1
[HUAWEI-pm-server-server1] protocol sftp ip-address 10.1.1.1
Related Topics

record-file disable

Function

The record-file disable command disables performance statistics file generation.

The undo record-file disable command restores performance statistics file generation.

By default, a performance statistics file is automatically generated and saved on the device. A maximum of four performance statistics files can be generated for each performance statistics collection task.

Format

record-file disable

undo record-file disable

Parameters

None

Views

Performance statistics collection task view

Default Level

2: Configuration level

Usage Guidelines

To save system resources, reduce system cost and operations on storage devices, and prolong the lifespan of storage devices during performance statistics collection, run the record-file disable command to prevent performance statistics files from being generated.

The system-generated file name is named in the format of "name of a performance statistics task+time that a performance statistics file is generated", and is saved in the text format. Each performance statistics collection task can generate a maximum of four statistics files. If more than four statistics files are generated, the new file replaces the earliest one.

Example

# Disable performance statistics file generation.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] statistics-task task1
[HUAWEI-pm-statistics-task1] record-file disable
Related Topics

record-interval

Function

The record-interval command sets the number of performance statistics collection cycles after which the system generates a statistics file.

The undo record-interval command restores the default number of performance statistics collection cycles.

By default:
  • If a short performance statistics collection cycle (5, 10, 15, 30, or 60 minutes) is set, the system generates a statistics file after four cycles.
  • If a long performance statistics collection cycle (1440 minutes) is set, the system generates a statistics file after one cycle.

Format

record-interval interval

undo record-interval

Parameters

Parameter Description Value
interval Specifies the number of performance statistics collection cycles. The value is an integer. The value range depends on the performance statistics collection cycle:
  • If a short performance statistics collection cycle is set, the value of interval ranges from 1 to 16, and the default value is 4.
  • If a long performance statistics collection cycle is set, the value of interval ranges from 1 to 3, and the default value is 1.

Views

Performance statistics collection task view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After you configure a performance statistics collection task, the system periodically saves collected performance data to statistics files. To set the interval at which the system generates statistics files, run the record-interval command. Then the system generates performance statistics files every cycle x interval minutes, and automatically saves the performance data in the files. The system generates a maximum of four statistics files for each performance statistics collection task, and saves performance statistics files to the path flash: /pmdata by default.

Prerequisites

  1. The performance statistics function has been enabled using the statistics enable command.
  2. The cycle has been set using the statistics-cycle command.

Example

# Configure the system to save performance data to a statistics file every three performance statistics collection cycles. If the performance statistics collection cycle is 5 minutes, the system saves a performance data to a statistics file every 15 minutes.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] statistics enable
[HUAWEI-pm] statistics-task task1
[HUAWEI-pm-statistics-task1] statistics-cycle 5
Warning: All data of the statistics task will be deleted. Continue? [Y/N]: y
[HUAWEI-pm-statistics-task1] record-interval 3
Warning: This operation will cause some data to be lost. Continue? [Y/N]: y

reset pm current-data

Function

The reset pm current-data command deletes the collected performance statistics.

Format

reset pm current-data [ instance-type instance-type [ measure measure-name | instance instance-name &<1-5> ] * ]

Parameters

Parameter Description Value
instance-type instance-type

Deletes the performance statistics about instances of a specified type.

If instance-type instance-type is not specified, the system deletes the performance statistics about instances of all types.

The enumerated values include:
  • ipfpm: collects IP FPM statistics.

  • uni-mng-as-port: collects statistics on an AS port.

  • wlan-ap: collects AP statistics:

  • wlan-radio: collects statistics about a specified AP radio.

  • wlan-ssid: collects statistics about a service set bound to a specific AP radio.

  • wlan-ap-wiredport: collects statistics on an AP wired port.

measure measure-name Deletes the performance statistics about a specified counter.

The value is a string of 1 to 63 case-insensitive characters without spaces. Select statistics counters according to the device configuration.

instance instance-name Deletes the performance statistics about a specified instance.
The value is a string of 1 to 255 case-insensitive characters.
  • When instance-type is ipfpm, the instance-name value is configured using the instance (IPFPM-MCP view) command.

  • When instance-type is uni-mng-as-port, the instance-name value is AS name+interface number, for example, as1 gigabitethernet1/0/1.

  • When instance-type is wlan-ap, the instance-name value is ap-id. For example, 1 indicates AP 1.

  • When instance-type is wlan-radio, the instance-name value is ap-id.radio-id. For example, 0.1 indicates radio 1 of AP 0.

  • When instance-type is wlan-ssid, the instance-name value is ap-id.radio-id.SSID name length.SSID name ASCII code. For example, 1.0.5.98.99.100.101.102 indicates the SSID with the name bcdef and name length 5 of radio 0 of AP 1.

  • When instance-type is wlan-ap-wiredport, the instance-name value is ap-id.port type x 100+port number. For example, 0.101 indicates FE port 1 of AP 0. The port type can be 1 (an FE port) or 2 (a GE port). The port number ranges from 0 to 99.

Views

Performance statistics collection task view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

To delete the collected performance statistics and collect new performance statistics, run the reset pm current-data command.

Precautions

Performance statistics cannot be restored after being deleted. Confirm your action before using this command.

Example

# Delete the collected performance statistics.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] statistics-task task1
[HUAWEI-pm-statistics-task1] reset pm current-data
Related Topics

retry

Function

The retry command sets the number of retransmissions for a performance statistics file.

The undo retry command restores the number of retransmissions for a performance statistics file to the default value.

The default number of retransmissions for a performance statistics file is 3.

Format

retry retry-times

undo retry

Parameters

Parameter Description Value
retry-times Sets the number of retransmissions for a performance statistics file. The value is an integer ranging from 1 to 3. The default value is 3.

Views

PM server view

Default Level

2: Configuration level

Usage Guidelines

The system generates performance statistics files and transmits these files to a PM server. To set the number of retransmissions for a performance statistics file, run the retry command.

Example

# Set the number of retransmissions for a performance statistics file to 2.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] pm-server server1
[HUAWEI-pm-server-server1] retry 2
Related Topics

sample-interval

Function

The sample-interval command configures the sampling interval for a performance statistics task.

The undo sample-interval command restores the default setting.

By default, the sampling interval varies with the performance statistics interval as follows:

  • If the interval at which the performance statistics are collected is 5 minutes, the default sampling interval is 1 minute.
  • If the interval at which the performance statistics are collected is 10 minutes, the default sampling interval is 2 minutes.
  • If the interval at which the performance statistics are collected is 15 minutes, the default sampling interval is 3 minutes.
  • If the interval at which the performance statistics are collected is 30 minutes, the default sampling interval is 5 minutes.
  • If the interval at which the performance statistics are collected is 60 minutes, the default sampling interval is 5 minutes.
  • If the interval at which the performance statistics are collected is 1440 minutes, the default sampling interval is 15 minutes.

Format

sample-interval interval

undo sample-interval

Parameters

Parameter Description Value
interval Specifies the interval at which the performance statistics collected in a performance statistics task is sampled.

The value can be 1, 2, 3, 5, 10, 15, 30, or 60, in minutes:

  • If the interval at which performance statistics are collected is 5 minutes, the sampling interval is 1 minute by default and can be set to 1 minute or 5 minutes.
  • If the interval at which performance statistics are collected is 10 minutes, the sampling interval is 2 minutes by default and can be set to 1, 2, 5, or 10 minutes.
  • If the interval at which performance statistics are collected is 15 minutes, the sampling interval is 3 minutes by default and can be set to 1, 3, 5, or 15 minutes.
  • If the interval at which performance statistics are collected is 30 minutes, the sampling interval is 5 minutes by default and can be set to 1, 2, 3, 5, 10, 15, or 30 minutes.
  • If the interval at which performance statistics are collected is 60 minutes, the sampling interval is 5 minutes by default and can be set to 1, 2, 3, 5, 10, 15, 30, or 60 minutes.
  • If the interval at which performance statistics are collected is 1440 minutes, the sampling interval is 15 minutes by default and can be set to 1, 2, 3, 5, 10, 15, 30, or 60 minutes.

Views

Performance statistics task view

Default Level

2: Configuration level

Usage Guidelines

After the statistics task is configured, the system collects statistics at a specified sampling interval. The shorter the sampling interval, the more accurate the statistics. However, more system resources are consumed.

Example

# Set the sampling interval to 5 minutes.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] statistics-task task1
[HUAWEI-pm-statistics-task1] sample-interval 5
Related Topics

snmp-agent trap enable feature-name pm

Function

The snmp-agent trap enable feature-name pm command enables the trap function of the PM module.

The undo snmp-agent trap enable feature-name pm command disables the trap function of the PM module.

By default, the trap function of the PM module is enabled.

Format

snmp-agent trap enable feature-name pm [ trap-name trap-name ]

undo snmp-agent trap enable feature-name pm [ trap-name trap-name ]

Parameters

Parameter Description Value
trap-name trap-name Specifies the name of a trap.

This parameter has enumerated values. Select one from the displayed values.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

The snmp-agent trap enable feature-name pm command is used to enable a PM trap. After that, the trap generated during the device running will be sent to the NMS.

You can run the display snmp-agent trap feature-name pm all command to check the configuration result.

Example

# Enable hwpmstatisticstaskthresholdtriggeralarm for the PM module.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable feature-name pm trap-name hwpmstatisticstaskthresholdtriggeralarm

statistics enable

Function

The statistics enable command enables the performance statistics function.

The undo statistics enable command disables the performance statistics function.

By default, the performance statistics function is disabled.

Format

statistics enable

undo statistics enable

Parameters

None

Views

PM view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To collect performance statistics, run the statistics enable command to enable the performance statistics function.

Precautions

After the undo statistics enable command is run, the performance statistics task that is running will be stopped. Therefore, exercise caution when you run this command.

Example

# Enable the performance statistics function.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] statistics enable
Related Topics

statistics-cycle

Function

The statistics-cycle command configures the performance statistics collection interval for a performance statistics task.

The undo statistics-cycle command restores the default setting.

The default interval is 15 minutes.

Format

statistics-cycle cycle

undo statistics-cycle

Parameters

Parameter Description Value
cycle Specifies the performance statistics collection interval for a performance statistics task.

The value can be 5, 10, 15, 30, 60, or 1440, in minutes. The default value is 15 minutes.

The system defines the interval 1440 minutes as a long interval and the interval 5, 10, 15, 30, or 60 minutes as a short interval.

Views

Performance statistics task view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A specific performance statistics collection interval is set for each performance statistics task. After the performance statistics collection interval is set, bind an instance to the performance statistics task and enable statistics counter measurement so that the system can collect performance statistics at the specified interval. If the statistics interval is set to a small value, the obtained performance statistics are more accurate but more system resources are consumed.

Configuration Impact

Running the statistics-cycle command in the performance statistics task view has the following impacts:
  • Performance statistics of the performance statistics task are deleted.
  • The default interval at which the system generates performance statistics files is used. In the case of a short statistics collection interval, the system generates a performance statistics file every four performance statistics collection intervals; in the case of a long statistics collection interval, the system generates a performance statistics file every one performance statistics collection interval.

Prerequisites

The performance statistics function has been enabled using the statistics enable command.

Example

# Set the performance statistics collection interval for the performance statistics task named task1 to 5 minutes.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] statistics-task task1
[HUAWEI-pm-statistics-task1] statistics-cycle 5
Warning: All data of the statistics task will be deleted. Continue? [Y/N]: y
Related Topics

statistics-task

Function

The statistics-task command creates a performance statistics task or displays the performance statistics task view.

The undo statistics-task command deletes a performance statistics task.

By default, no performance statistics task is created.

Format

statistics-task task-name

undo statistics-task task-name

Parameters

Parameter Description Value
task-name Specifies the name of a performance statistics task.

The value is a string of 1 to 31 case-insensitive characters, spaces not supported. The string contains letters, digits, and underscores (_), and must start with letters or digits.

Views

PM view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A performance statistics task is the minimum statistics collection unit of PM. Before configuring the performance statistics function, run the statistics-task command to create a performance statistics task. Only one performance statistics collection interval can be configured for each performance statistics task. After a performance statistics task is configured, enable statistics counter measurement for the task.

Precautions

  • A maximum of 16 performance statistics tasks can be configured.

  • After the undo statistics-task command is run to delete a performance statistics task, performance statistics and performance statistics files of the task are deleted.

Prerequisites

The performance statistics function has been enabled using the statistics enable command.

Example

# Configure a performance statistics task named task1.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] statistics-task task1
[HUAWEI-pm-statistics-task1]
Related Topics

threshold-alarm enable

Function

The threshold-alarm enable command enables the threshold alarm.

The undo threshold-alarm enable command disables the threshold alarm.

By default, the threshold alarm function is disabled.

Format

threshold-alarm enable

undo threshold-alarm enable

Parameters

None

Views

Performance statistics task view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The threshold alarm function enables users to learn the device operating status in a timely manner so that the device maintenance level can be promoted. To monitor the running data, run the command to enable the threshold alarm.

Precautions

After the undo threshold-alarm enable command is run, the threshold alarm function will be disabled and threshold alarms will be cleared. Exercise caution before operation.

Follow-up Procedure

After the command is run, run the threshold-alarm measure command to configure monitoring rules for the threshold alarm. Otherwise, the threshold alarm function will not take effect.

Example

# Enable the threshold alarm function.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] statistics-task task1
[HUAWEI-pm-statistics-task1] threshold-alarm enable

threshold-alarm measure

Function

The threshold-alarm measure command creates monitoring rules for threshold alarms.

The undo threshold-alarm measure command deletes monitoring rules for threshold alarms.

By default, no monitoring rules are created for threshold alarms about performance statistics tasks.

Format

threshold-alarm measure measure-name operation { ge | le } trigger-value trigger-value-val clear-value clear-value-val

undo threshold-alarm measure measure-name operation { ge | le }

Parameters

Parameter Description Value
measure-name Specifies the threshold monitoring indicator The indicator name is predefined by each feature.

The value is a string of 1 to 63 case-insensitive characters without spaces. Select statistics counters according to the device configuration.

operation { ge | le } Specifies the type of triggering a threshold alarm. Enumerated value: ge or le
  • ge: the system triggers an alarm if the monitored indicator value is greater than or equal to the threshold value
  • le: the system triggers an alarm if the monitored indicator value is less than or equal to the threshold value.
trigger-value trigger-value-val Specifies the threshold information when the alarm is triggered. The value is an integer, and the value range is determined by measure-name.
clear-value clear-value-val Specifies the threshold information when the alarm is cleared. The value is an integer, and the value range is determined by measure-name.

Views

Performance statistics task view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The threshold alarm function is used for the system to periodically monitor the device operating status. If an alarm condition is triggered, the alarm will be sent to the NMS and cleared after the alarm condition is cleared.

The threshold-alarm measure command configures threshold monitoring rules for current performance statistics tasks. The threshold-alarm measure command configures the alarm triggering type, threshold for triggering an alarm and threshold for clearing an alarm based on the instance type and indicators of the threshold monitoring instance.

Prerequisites

Before the threshold-alarm measure command is run, run the binding instance-type instance-type { all | instance instance-name &<1-5> } command to bind a threshold monitoring instance, and run the threshold-alarm enable command to enable the threshold alarm function. Otherwise, alarms will not be sent.

Example

# Create threshold monitoring rules.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] statistics-task task1
[HUAWEI-pm-statistics-task1] binding instance-type ipfpm all
[HUAWEI-pm-statistics-task1] threshold-alarm enable
[HUAWEI-pm-statistics-task1] threshold-alarm measure forward-loss-ratio-max operation ge trigger-value 1000 clear-value 10

upload

Function

The upload command configures the device to upload performance statistics files to a PM server.

Format

upload request-name file filename &<1-16>

Parameters

Parameter Description Value
request-name Specifies the name of a request for uploading performance statistics files.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. The string contains letters, digits, and underscores (_), and must start with letters or digits.

file filename

Specifies the name of a performance statistics file.

The value is a string of 1 to 255 case-insensitive characters without spaces.

The file name can contain the file path. If multiple files are specified, separate them with spaces.

Views

PM view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

The system periodically generates performance statistics files based on the collected performance statistics. You can manually upload the statistics files to a PM server.

Prerequisites

A request for uploading performance statistics files to the PM server has been created using the upload-config request-name server server-name command.

Follow-up Procedure

View the performance statistics on the PM server.

Example

# Configure the device to upload performance statistics file to the PM server.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] pm-server ftpserver
[HUAWEI-pm-server-ftpserver] quit
[HUAWEI-pm] upload-config req1 server ftpserver
[HUAWEI-pm] upload req1 file stream20130703103001.txt
Related Topics

upload auto

Function

The upload auto command enables a device to automatically upload performance statistics files to a server.

The undo upload auto command disables a device from automatically uploading performance statistics files to a server.

By default, a device does not automatically upload performance statistics files to a server.

Format

upload auto request-name

undo upload auto

Parameters

Parameter Description Value
request-name Specifies the name of a request for uploading performance statistics files to a server.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. The string contains letters, digits, and underscores (_), and must start with letters or digits.

Views

Performance statistics collection task view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The system periodically generates performance statistics files based on the collected performance statistics. To enable the device to automatically upload performance statistics files to the PM server at a specific interval, run the upload auto command.

Prerequisites

A request for uploading performance statistics files to the PM server has been created using the upload-config request-name server server-name command.

Example

# Configure the device to automatically upload statistics files to a PM server.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] pm-server ftpserver
[HUAWEI-pm-server-ftpserver] quit
[HUAWEI-pm] upload-config req1 server ftpserver
[HUAWEI-pm] statistics-task task1
[HUAWEI-pm-statistics-task1] upload auto req1
Related Topics

upload-config

Function

The upload-config command creates a request for uploading performance statistics files to a specified PM server.

The undo upload-config command deletes a request for uploading performance statistics files to a specified PM server.

By default, no request for uploading performance statistics files is available on a device.

Format

upload-config request-name server server-name

undo upload-config request-name

Parameters

Parameter Description Value
request-name Specifies the name of a request for uploading performance statistics files.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. The string contains letters, digits, and underscores (_), and must start with letters or digits.

server server-name Specifies the name of the process serving the PM server.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. The string contains letters, digits, and underscores (_), and must start with letters or digits.

Views

PM view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a device to upload performance statistics files to a PM server, run the upload-config command to create a file uploading request.

Prerequisites

A PM server process has been created using the pm-server server-name command.

Follow-up Procedure

Enable the device to upload performance statistics files to the PM server.

  • Run the upload request-name file filename &<1-16> command in the PM view to manually upload statistics files to the PM server.

  • Run the upload auto request-name command in the performance statistics collection task view to configure the device to automatically upload statistics files to the PM server.

Example

# Create a request for uploading statistics files to a PM server.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] pm-server ftpserver
[HUAWEI-pm-server-ftpserver] quit
[HUAWEI-pm] upload-config req1 server ftpserver

username password

Function

The username password command configures the user name and password for logging in to the PM server.

The undo username command deletes the user name and password for logging in to the PM server.

By default, no user name and password for logging in to the PM server are configured.

Format

username user-name password password

undo username

Parameters

Parameter Description Value
user-name Specifies the user name for logging in to a PM server. The name is a string of 1 to 255 case-sensitive characters without spaces.
password Specifies the password for logging in to a PM server.
The value is a string of 1 to 128 characters or a string of 32 to 200 characters. The password can be in plain or cipher text.
  • The password in plain text is a string of 1 to 128 case-sensitive characters without spaces.
  • The password in cipher text is a string of 32 to 200 characters.

The password is displayed in ciphertext in the configuration file regardless of whether it is input in plain or cipher text.

NOTE:

A 24-character ciphertext password configured in an earlier version is also supported in this version.

Views

PM server view

Default Level

2: Configuration level

Usage Guidelines

To log in to a PM server for upload performance statistics files to the PM server, run the username password command to configure the user name and password.

Example

# Configure the user name and password for logging in to the PM server.

<HUAWEI> system-view
[HUAWEI] pm
[HUAWEI-pm] pm-server server1
[HUAWEI-pm-server-server1] username admin password Pwd@123
Related Topics
Translation
Download
Updated: 2019-04-09

Document ID: EDOC1100065659

Views: 123110

Downloads: 88

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