Contents

WLAN process maintenance commands· 1

display maintain cpu-usage history· 1

display maintain memory-usage history· 2

display wlan statistics global 3

maintain enable· 4

maintain inactive-process restart enable· 5

maintain monitor process· 6

maintain process inactive-time· 6

maintain process memory-threshold· 7

 

WLAN process maintenance commands

The WX1800H series, WX2500H series, MAK series, and WX3000H series access controllers do not support parameters or commands that are available only in IRF mode.

The AP models and serial numbers in this document are used only as examples. Support for AP models and serial numbers depends on the AC model.

display maintain cpu-usage history

Use display maintain cpu-usage history to display CPU usage history of a WLAN process.

Syntax

Centralized devices:

display maintain cpu-usage history process process-name [ days-ago days ] [ start-time value ] [ interval interval ]

Centralized IRF devices:

display maintain cpu-usage history process process-name [ days-ago days ] [ start-time value ] [ interval interval ] [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

process-name: Specifies a process by its name, a case-insensitive string of 1 to 15 characters.

days-ago days: Specifies the number of past days, in the range of 1 to 7. If you do not specify this option, the command displays CPU history information for the current day.

start-time value: Specifies the start hour, in the range of 0 to 23. The default value is 0. If you specify 3, the command displays the CPU history after 3 o'clock.

interval interval: Specifies the statistics collection interval. The value can be 1, 5, or 20 minutes. The default value is 5.

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays client information on the master device. (In IRF mode.)

Examples

# Display the CPU usage of process stamgrd every five minutes from 9:00 yesterday on member device 1.

<Sysname> display maintain cpu-usage history process stamgrd days-ago 1 start-time 9 slot 1

CPU utilization rate

Process: stamgrd  Time: 2021-07-20 09:00  Interval: 5min  slot 1

(%)

100|

 90|

 80|

 70|

 60|                                    **    *

 50|                                 ***  **** **

 40|                     ************            *********

 30|   ******************                                 *********

 20|***                                                            *********

 10|

  0+-----------+-----------+-----------+-----------+-----------+-----------+

 09:00       10:00       11:00       12:00       13:00       14:00       15:00

Table 1 Command output

Field	Description
Process	Process name.
Time	Start time.
Interval	Statistics collection interval.

‌

display maintain memory-usage history

Use display maintain memory-usage history to display memory usage history of a WLAN process.

Syntax

Centralized devices:

display maintain memory-usage history process process-name [ days-ago days ] [ start-time value ] [ interval interval ]

Centralized IRF devices:

display maintain memory-usage history process process-name [ days-ago days ] [ start-time value ] [ interval interval ] [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

process-name: Specifies a process by its name, a case-insensitive string of 1 to 15 characters.

days-ago days: Specifies the number of past days, in the range of 1 to 7. If you do not specify this option, the command displays history information in the current day.

start-time value: Specifies the start hour, in the range of 0 to 23. The default value is 0. If you specify 3, the command displays the memory usage history after 3 o'clock.

interval interval: Specifies the statistics collection interval. The value can be 5, 20, or 60 minutes. The default value is 20.

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays client information on the master device. (In IRF mode.)

Examples

# Display the memory usage of process apmgrd every 20 minutes from yesterday on member device 1.

<Sysname> display maintain memory-usage history process apmgrd days-ago 1 slot 1

Memory utilization

Process: apmgrd  Time: 2021-07-20 00:00  Interval: 20min  Slot 1

(MB)

2048|

1792|                                     ***

1536|                                       

1280|                                 ****   *****

1024|                     ************            *********

 768|   ******************                                 *********

 512|***                                                            *********

 256|

   0+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+

    0  1  2  3  4  5  6  7  8  9 10 11 12 13 14 15 16 17 18 19 20 21 22 23  0

Table 2 Command output

Field	Description
Process	Process name.
Time	Start time.
Interval	Statistics collection interval.

‌

display wlan statistics global

Use display wlan statistics global to display global WLAN statistics.

Syntax

display wlan statistics global

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

The command output varies by network architecture:

·     In a non-IRF network, the command displays global WLAN statistics on the device.

·     In an IRF fabric, the command displays global WLAN statistics on all member devices.

Examples

# Display global WLAN statistics.

<Sysname> display wlan statistics global

APs (online/total)                : 1000/1200

APs (online/offline) in 300s      : 50/20

Sensor APs/WIPS APs/WLOC APs      : 210/33/112

Clients online                    : 1000

Clients (online/offline) in 300s  : 1000/2000

 

User authentication information:

 Auth type   Online users   Online in 300s   Offline in 300s   Failed in 300s

 802.1X      200            200              300               100

 MAC         300            300              500               100

 Portal      500            500              1200              100

 

BSS information:

 Slot number   Service templates   BSSs

 0             500                 444

 1             300                 222

 2             30                  11

Table 3 Command output

Field	Description
APs (online/total)	Number of online APs and total number of APs.
APs (online/offline) in 300s	Numbers of APs coming online and going offline in the past 300 seconds, respectively.
Sensor APs/WIPS APs/WLOC APs	Numbers of APs enabled with WLAN probe, WIPS, and wireless location, respectively.
Clients online	Number of online clients.
Clients (online/offline) in 300s	Number of clients coming online and going offline in the past 300 seconds, respectively.
Auth type	Authentication type: ·     Portal. ·     802.1X. ·     MAC.
Online users	Number of users that have passed authentication and come online.
Online in 300s	Number of users that came online in the past 300 seconds.
Offline in 300s	Number of users that went offline in the past 300 seconds.
Failed in 300s	Number of users that failed authentication in the past 300 seconds.
Slot number	Slot number.
Service templates	Number of created service templates.
BSSs	Number of BSSs.

‌

maintain enable

Use maintain enable to enable WLAN process maintenance.

Use undo maintain enable to disable WLAN process maintenance.

Syntax

maintain enable

undo maintain enable

Default

WLAN process maintenance is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

This feature enables the system to monitor the CPU usage, memory usage, and thread state of the apmgrd, stamgrd, and portald processes.

Examples

# Enable WLAN process maintenance.

<Sysname> system-view

[Sysname] maintain enable

maintain inactive-process restart enable

Use maintain inactive-process restart enable to enable defunct process restart.

Use undo maintain inactive-process restart enable to disable defunct process restart.

Syntax

maintain inactive-process restart enable

undo maintain inactive-process restart enable

Default

Defunct process restart is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

	CAUTION: Restarting a main WLAN process affects wireless services. Please configure this feature under the guidance of professionals and use this feature with caution.

‌

This feature enables the system to restart the apmgrd, stamgrd, and portald processes when they enter defunct state.

This feature takes effect only when WLAN process maintenance is enabled.

Examples

# Enable defunct process restart.

<Sysname> system-view

[Sysname] maintain inactive-process restart enable

Related commands

maintain enable

maintain process inactive-time

maintain monitor process

Use maintain monitor process to enable maintenance of the specified process.

Use undo maintain monitor process to disable maintenance of the specified process.

Syntax

maintain monitor process process-name

undo maintain monitor process process-name

Default

Maintenance of a process is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

process-name: Specifies the name of a process, a case-sensitive string of 1 to 15 characters.

Usage guidelines

Make sure WLAN process maintenance is enabled before you execute this command. The command execution will fail if WLAN process maintenance is disabled.

This feature enables the system to monitor the CPU usage and memory usage of the specified process.

Examples

# Enable maintenance of the WIPS process.

<Sysname> system-view

[Sysname] maintain enable

[Sysname] maintain monitor process wips

Related commands

maintain enable

maintain process inactive-time

Use maintain process inactive-time to set the inactive timeout for a process.

Use undo maintain process inactive-time to restore the default.

Syntax

maintain process process-name inactive-time value

undo maintain process process-name inactive-time

Default

The inactive timeout is 10 minutes.

Views

System view

Predefined user roles

network-admin

Parameters

process-name: Specifies the name of a process.

value: Specifies the inactive timeout in the range of 5 to 30 seconds.

Usage guidelines

When WLAN process maintenance is enabled, the system periodically sends a message to each monitored process to examine the process state. If the system fails to receive any response from a process when the inactive timeout expires, the system determines that the process is in defunct state.

You can set the inactive timeout only for the apmgrd, stamgrd, and portald processes.

The configuration starts to take effect the first time the system sends a message upon execution of the command.

Examples

# Set the inactive timeout for process apmgrd.

<Sysname> system-view

[Sysname] maintain process apmgrd inactive-time 20

maintain process memory-threshold

Use maintain process memory-threshold to set the memory usage threshold.

Use undo maintain process memory-threshold to restore the default.

Syntax

maintain process process-name memory-threshold value

undo maintain process process-name memory-threshold

Default

The memory usage threshold is 300 MB.

Views

System view

Predefined user roles

network-admin

Parameters

process-name: Specifies the name of a process.

value: Specifies the memory usage threshold in the range of 50 to 1000 MB.

Usage guidelines

The system outputs a log entry when the memory usage of the specified process exceeds the threshold.

You can set the threshold only for the apmgr, stamgr, and portal processes.

Examples

# Set the memory usage threshold to 100 MB for process apmgrd.

<Sysname> system-view

[Sysname] maintain process apmgrd memory-threshold 100