WLAN Basic Configuration Commands

1. WLAN Basic Configuration Commands

2. WLAN STAMG Commands

3. WLAN CAPWAP Commands

4. WBS Commands

5. ETH-MNG Commands

6. DATA-PLANE Commands

7. WLOG Commands
Command Reference WLAN Basic Configuration Commands

1 WLAN Basic Configuration Commands

1.1 ac-controller

Use this command to enter the AC configuration mode from the global configuration mode.

ac-controller

Parameter Parameter Description

Description N/A N/A

Defaults N/A

Command Global configuration mode

Mode

Usage Guide N/A

The following example enters the AC configuration mode.

Configuration
Ruijie(config)# ac-controller
Examples
Ruijie(config-ac)#

Related Command Description

Commands N/A N/A

Platform N/A
Description

1.2 acctrl-trap

Use this command to control the switch of a specific trap on AC in AC configuration mode. Use the no
form of this command to restore the default setting.

acctrl-trap [ acap-updown-ctrl | acap-joinfail-ctrl | acap-decryeroreport-ctrl | acap-imageupdt-ctrl

| acap-timestamp-ctrl | acsta-oper-ctrl ]

no acctrl-trap [ acap-updown-ctrl | acap-joinfail-ctrl | acap-decryeroreport-ctrl |

acap-imageupdt-ctrl | acap-timestamp-ctrl | acsta-oper-ctrl ]

Parameter Description
Parameter
acap-updown-ctrl Controls the forwarding of the trap message about
Description
up/down of the CAPWAP tunnel.
acap-joinfail-ctrl Controls the forwarding of the trap message that AP
failed to join AC.

1-1
Command Reference WLAN Basic Configuration Commands

acap-decryeroreport-ctrl Controls the forwarding of the trap message that the

decryption of CAPWAP messages is failed.
acap-imageupdt-ctrl Controls the forwarding of the trap message about bin file
updating of AP.
acap-timestamp-ctrl Controls the forwarding of the trap message about
synchronization.
acsta-oper-ctrl Controls the forwarding of the trap message about login
and logout of STA.

Defaults This function is disabled by default.

Command AC configuration mode

Mode

Usage Guide The command is used to control the switch of a specified trap on AC.

The following example enables the forwarding of the trap message about login and logout of STA on
Configuration
AC.
Examples
Ruijie(config-ac)# acctrl-trap acsta-oper-ctrl

Related Command Description

Commands N/A N/A

Platform
Description

1.3 ac-name

Use this command to configure an AC name for users to identify the AC. Use the no form of this
command to restore the default setting.

ac-name ac-name

no ac-name

Parameter Description
Parameter
ac-name Indicates an AC name, which can consist of up to 63
Description
characters, excluding any space.

The default is the last six bits of the MAC address. For example. the default name for the AC with the
Defaults
MAC address 001a.a916.e7b8 is Ruijie_Ac_16e7b8.

Command AC configuration mode

Mode

1-2
Command Reference WLAN Basic Configuration Commands

Usage Guide Configure different names for different ACs to make it easy for users to manage.

Configuration The following example sets the AC name to ruijie-ac.

Examples Ruijie(config-ac)# ac-name ruijie-ac

Related Command Description

Commands N/A N/A

Platform
Description

1.4 ap-auth
Use this command to enable a specified AP with the access authentication function. Use the no form
of this command to restore the default setting.
ap-auth { serial serial-string | password password | ac-cert ac-cert-name | ap-cert ap-cert-name }
no ap-auth { serial | password | ac-cert | ap-cert }

Parameter
Parameter Description
Description
serial-string The serial number of the specified AP.
password The password of the specified AP.
ac-cert-name The certificate name of the specified AC.
ap-cert-name The certificate name of the specified AP.

Defaults This function is disabled by default.

Command AP configuration mode

Mode

Usage Guide The access authentication only occurs when the AP goes online. If the AP is already online,
authentication occurs the next time the AP gets access.
The ap-auth-serial command is not supported in all modes for every AP has different serial number.
The certificate configured by the ap-auth ap-cert command is saved as cert.crt uniformly on the AP
and the name cannot be changed.

Configuration The following example sets the serial number for AP1 to 123456.
Examples Ruijie# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Ruijie(config)# ap-config AP1
Ruijie(config-ap)# ap-auth serial 123456
The following example restores the default setting.
Ruijie# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.

1-3
Command Reference WLAN Basic Configuration Commands

Ruijie(config)# ap-config AP1

Ruijie(config-ap)# no ap-auth serial

Related
Command Description
Commands
N/A N/A

Platform
Description

1.5 ap-auth enable

Use this command to enable a specified AP with the access authentication function. Use the no form
of this command to restore the default setting.
ap-auth [ serial | password | certificate ] enable
no ap-auth [ serial | password | certificate ] enable

Parameter
Parameter Description
Description
serial Serial-number-based authentication.
password Password-based authentication.
certificate Certificate-based authentication.

Defaults This function is disabled by default.

Command AC configuration mode

Mode

Usage Guide N/A

Configuration The following example enables the AP with the serial-number-based authentication.
Examples Ruijie(config)# ac-controller
Ruijie(config-ac)# ap-auth serial enable
The following example restores the default setting.
Ruijie(config)# ac-controller
Ruijie(config-ac)# no ap-auth serial enable

Related
Command Description
Commands
N/A N/A

Platform
Description

1-4
Command Reference WLAN Basic Configuration Commands

1.6 ap-auth serial-update

Use this command to enable all online APs to update their serial numbers.
ap-auth serial-update

Parameter
Parameter Description
Description
N/A N/A

Defaults This function is disabled by default.

Command AC configuration mode

Mode

Usage Guide N/A

Configuration The following example enables all online APs to update their serial numbers.
Examples Ruijie(config)# ac-controller
Ruijie(config-ac)# ap-auth serial-update

Related
Command Description
Commands
N/A N/A

Platform
Description

1.7 ap-backup group

Use this command to configure an AP backup group in AC configuration mode. Use the no form of
this command to delete an AP backup group.
ap-backup group name
no ap-backup group name

Parameter
Parameter Description
Description
name AP backup group name. “default” is system reserved, namely,
“default” cannot be used for backup group configuration.

Defaults By default, the AC device has only one AP backup group named “default”, which takes no effect on
the backup function.

Command AC configuration mode

Mode

1-5
Command Reference WLAN Basic Configuration Commands

Usage Guide If an AP backup group is deleted, the AP device in this group will be added to the “default” group. The
“default” group takes no effect on the backup function.

Configuration The following example configures an AP backup group named apbackup-test-group.

Examples Ruijie(config)# ac-controller
Ruijie(config-ac)# ap-backup group apbackup-test-group

The following example deletes an AP backup group named apbackup-test-group.

Ruijie(config)# ac-controller
Ruijie(config-ac)# no ap-backup group apbackup-test-group

Related
Command Description
Commands
N/A N/A

Platform
Description

1.8 ap-backup group

Use this command to configure an AP backup group in AP configuration mode. Use the no form of
this command to remove an AP device from the AP backup group or disable its master AP role.
ap-backup-group name [ master ]
no ap-backup-group [ name ] [ master ]

Parameter
Parameter Description
Description
name AP backup group name
master (Optional) Designates the AP device as a master AP in the backup
group.

Defaults By default, the “default” backup group does not have any AP.

Command AP configuration mode

Mode

Usage Guide The backup group must exist before you add an AP device into it.
The master parameter designates the AP device as a master AP in the backup group. There is only
one master AP in a backup group. If you want to designate a new master AP, use the no form of this
command to disable the old master AP.

Configuration The following example adds an AP into backup group “backup-test-group” and designates it as a

1-6
Command Reference WLAN Basic Configuration Commands

Examples master AP.

Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# ap-backup-group backup-test-group master

The following example disables a master AP in the backup group.

Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# no ap-backup-group backup-test-group master

The following example removes an AP from the backup group.

Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# no ap-backup-group

Related
Command Description
Commands
N/A N/A

Platform
Description

1.9 ap-config

Use this command to enter the configuration mode of a specified AP, which must have been added into
an AC. Use the no form of this command to restore the default setting.

ap-config ap-name

no ap-config ap-name

Parameter Parameter Description

Description ap-name Indicates the name of the AP to be configured.

Defaults N/A

Command Global configuration mode

Mode

To enter the configuration mode of a specified AP, ensure this AP must have been added into an
AC. The ap-config all command can be used to enter the configuration mode of all APs, and the
configuration in this mode will be applicable to all APs associated with the AC. The ap-config
Usage Guide
ap-name command prevails over the ap-config all command.
The no ap-config ap-name command is used to remove the specified AP configuration. If the target
AP is online, it will go offline and then online upon configuration change,

Configuration The following example configures the AP that has been added with a name AP0001.

1-7
Command Reference WLAN Basic Configuration Commands

Examples Ruijie(config-ap)# ap-config AP0001

The following example configures the AP that has been offline with a name AP0001.
Ruijie(config-ap)# no ap-config AP0001

Related Command Description

Commands N/A N/A

Platform
Description

1.10 ap-group(AP Configuration Mode)

Use this command to add the AP to a specified AP group. Use the no form of this command to restore
the default setting.
ap-group ap-group-name
no ap-group

Parameter
Parameter Description
Description
ap-group-name AP group name.

Defaults The AP joins in the default group by default.

Command AP configuration mode

Mode

Usage Guide When the AP group is deleted, the member APs of this group are switched to the default group.

Configuration The following example adds the AP to test-group.

Examples Ruijie(config)# ap-group test-group
Ruijie(config-ap-group)#
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# ap-group test-group
The following example restores the default setting.
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# no ap-group test-group

Related
Command Description
Commands
N/A N/A

Platform
Description

1-8
Command Reference WLAN Basic Configuration Commands

1.11 ap-group

All APs added into an AC always belong to one and only one specific AP group in a certain moment.
Any newly added AP belongs to the default AP group: default. Use this command to create a new AP
group or enter the configuration mode of an existing AP group. If you use this command to create an
AP group, you will enter the configuration mode of this AP group once created. Use the no form of this
command to restore the default setting.

[no] ap-group ap-group-name

Parameter Description
Parameter
ap-group-name Indicates an AP group name, which consists of up to 150
Description
characters or 64 bytes, excluding any space.

By default, the system, once started, will create automatically a default AP group (called default),
Defaults
which cannot be created or deleted manually.

Command AP configuration mode.

Mode

Usage Guide N/A

The following example creates an AP group named test-group.

Ruijie(config)# ap-group test-group
Ruijie(config-ap-group)#
Configuration
The following example deletes an AP group named test-group.
Examples
Ruijie(config)#no ap-group test-group
The following example enters an AP group named default.
Ruijie(config)# ap-group default

Related Command Description

Commands N/A N/A

Platform
Description

1.12 ap-mac
Use this command to configure MAC-address-binding. Use the no form of this command to remove
the configuration.
ap-mac ap-mac
no ap-mac

Parameter Parameter Description

1-9
Command Reference WLAN Basic Configuration Commands

Description
ap-mac MAC address of the AP.

Defaults N/A

Command AP configuration mode

Mode

Usage Guide  With this command configured, the AP configuration takes affect only on the AP whose MAC
address is bound.
 In general, MAC-address-binding has a higher priority over name-binding. As long as the AP
MAC address is consistent with the preset bound MAC address, the AP adopts the configuration
after it goes online.
 Automatic MAC-address-binding: If the specified AP is not configured with
MAC-address-binding, when it goes online, the MAC address is bound automatically. The
binding is still effective when the AP goes offline.
 MAC-address-binding is also used for AP access control. See the bind-ap-mac command for
details.
 MAC-address-binding can be performed only on the offline AP.
 In hot backup environment, binding MAC address ensures the consistency of configuration on
two ACs.

Configuration The following example sets the MAC address bound with ap test to 00ff.ffff.1111.
Examples Ruijie(config)# ap-config test
Ruijie(config-ap)# ap-mac 00ff.ffff.1111

Related
Command Description
Commands
N/A N/A

Platform
Description

1.13 ap-name
Use this command to configure the AP name. Use the no form of this command to remove the
configuration.
ap-name ap-name
no ap-name

Parameter
Parameter Description
Description
ap-name AP name, containing up to 63 characters without blank space.

1-10
Command Reference WLAN Basic Configuration Commands

Defaults N/A

Command AP configuration mode

Mode

Usage Guide If the specified AP is online, the AP name configuration takes effect immediately. The name of the AP
configuration mode (the string after ap-config) is replaced by the new name.
If the specified AP is offline, the AP name configuration takes effect when it goes online. The name of
the AP configuration mode does not change until the AP goes online.
After configuring the AP name, you don’t need to exit AP configuration mode before continuing
configuration.
If the specified AP is online, the no form of this command is not supported
If the specified AP is offline, the no form of this command is used to remove the configuration.
If the new name is in use, the configuration fails.
The AP name contains up to 63 characters without blank space.
The AP name cannot be set to all or AP.
Don’t configure the same name for multiple offline APs. If multiple different offline APs are configured
with the same name, the first online AP adopts the new name while the other APs keep the old
names.

Configuration The following example sets the AP0001 name to AP_NEW on an AC.
Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# ap-name AP_NEW

The following example sets the AP name to AP_TEST.

Ruijie(config)# ap-name AP_ TEST

Related
Command Description
Commands
N/A N/A

Platform The command is supported on ACs and fit APs.

Description

1.14 ap-priority
Use this command to enable or disable the support for the Failover priority of APs on an AC.
ap-priority { enable | disable }

Parameter
Parameter Description
Description
enable Enables the support for the Failover priority of APs
disable Disables the support for the Failover priority of APs

1-11
Command Reference WLAN Basic Configuration Commands

Defaults This function is disabled by default.

Command AP configuration mode

Mode

Usage Guide N/A

Configuration The following example establishes a connection between AP0001 and AC1. Configure the priority of
Examples AP0001 to 3, and enable the support for the Failover priority of AC1.
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# priority 3
Ruijie(config-ap)# exit
Ruijie(config)# ac-controller
Ruijie(config-ac)# ap-priority enable

Related
Command Description
Commands
N/A N/A

Platform
Description

1.15 bind-ap-mac

Use this command to enable AP validity check. Use the no form of this command to restore the default
setting.

bind-ap-mac

no bind-ap-mac

Parameter Parameter Description

Description N/A N/A

Defaults This function is disabled by default.

Command AC configuration mode

Mode

When the AP validity check is enabled, only the AP with offline configurations that binds the MAC
Usage Guide address can associate the AC. You can configure the command ap-mac to binds the MAC address
to the offline AP in the AP configuration mode.

Configuration The following example enables AP validity check.

Examples Ruijie(config)# ac-controller

1-12
Command Reference WLAN Basic Configuration Commands

Ruijie(config-ac)# bind-ap-mac
The following example disables AP validity check.
Ruijie(config)# ac-controller
Ruijie(config-ac)# no bind-ap-mac

Related Command Description

Commands ap-mac Binds the MAC address to the offline AP.

Platform
Description

1.16 credential

Use this command to configure a username and a password for an AP. Use the no form of this
command to restore the default setting.

[no] credential user-name password

Parameter Description
user-name Indicates a username to be used on an AP, which can
Parameter
consist of up to 255 characters, excluding any space.
Description
password Indicates a password to be set on an AP, which can
consist of up to 255 characters, excluding any space.

Defaults N/A

Command AP configuration mode or AP group configuration mode

Mode

Usage Guide N/A

The following example configures a username first-ap and a password 123456 for AP0001.
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# credential first-ap 123456
Configuration
The following example configures a username first-ap and a password 123456 for all APs in the AP
Examples
group (default).
Ruijie(config)# ap-group default
Ruijie(config-ap-group)# credential first-ap 123456

Related Command Description

Commands N/A N/A

Platform
Description

1-13
Command Reference WLAN Basic Configuration Commands

1.17 enable-broad-ssid

Use this command to enable SSID broadcast in the WLAN configuration mode. Use Tthe no form of
this command to disable this function.

[no] enable-broad-ssid

Parameter Parameter Description

Description N/A N/A

Defaults This function is enabled by default.

Command WLAN configuration mode

Mode

When you configure the Suppress SSID information of this WLAN, the configuration will take effect
Usage Guide
only if completed before the WLAN is applied.

The following example enables SSID broadcast on this WLAN.

Configuration Ruijie(config-wlan)#enable-broad-ssid
Examples The following example disables SSID broadcast on this WLAN.
Ruijie(config-wlan)#no enable-broad-ssid

Related Command Description

Commands N/A N/A

Platform
Description

1.18 factory-reset

Use this command to restore the factory setting of a specified AP, that is, to reset this AP.

factory-reset ap-name

Parameter Description
Parameter
ap-name indicates the name of the AP that needs to restore factory
Description
setting.

Defaults N/A

Command AC configuration mode

Mode

Usage Guide The configuration will restore the factory setting of a specified AP, and as a result, the operation will

1-14
Command Reference WLAN Basic Configuration Commands

reset this AP.

Configuration The following example configures AP0001 to restore its factory setting.
Examples Ruijie(config-ac)# factory-reset AP0001

Related Command Description

Commands N/A N/A

Platform
Description

1.19 interface-mapping

Use interface-mapping in AP group configuration mode to map wlan-vlan or wlan-vlan-group

mapping (the mapping in all descriptions of this cli refers to map wlan-vlan or wlan-vlan-group
mapping) to the radios of all the APs in an AP group. The related WLAN configuration can be applied to
the specified radio through such mapping. Use the no form this command to remove the related
mapping configuration.

interface-mapping wlan-id [ vlan-id I group vlan-group-id ] [ radio {radio-id | [802.11b | 802.11a]}]

[ ap-wlan-id ap-wlan-id ]

no interface-mapping wlan-id [ vlan-id I group vlan-group-id ] [ radio {radio-id | [802.11b | 802.11a]}]

[ ap-wlan-id ap-wlan-id ]

Parameter Description
wlan-id ID of the WLAN to be mapped. This WLAN must be created
already. Its ID ranges from 1 to 4094.
vlan-id ID of the VLAN to be mapped. This VLAN must be created
already. Its ID ranges from 1 to 4094.
Parameter vlan-group-id ID of the VLAN-group to be mapped. This VLAN-group
Description must be created already. Its ID ranges from 1 to 128.
radio-id An AP’s radio to which the specified mapping is applied. Its
reserved range is the standard, defined 1 to 48. Currently,
the product should use the range of 1 to 2.
If no radio-id is specified, the mapping will be applied to all
the radios of all the APs in the AP group.
802.11b Applies the mapping to 2.4G radio.
802.11a Applies the mapping to 5.8G radio.
Specifies the WLAN ID on the AP, in the range from 1 to
64.
ap-wlan-id
If the WLAN ID is not specified, the mapping selects an
available ID automatically.

Defaults N/A

1-15
Command Reference WLAN Basic Configuration Commands

Command AP group configuration mode

Mode

Usage Guide N/A

The following example configures VLAN 2 and a WLAN with its ID of 4094, and apply the mapping of
wlan4094-vlan2 to radio 1 of all the APs in the default AP group.
Ruijie(config)#vlan 2
Ruijie(config)#wlan-config 4094 pro-4094 ssid-4094
Ruijie(config-wlan)#exit
Ruijie(config)#ap-group default
Ruijie(config-ap-group)#interface-mapping 4094 2 radio 1
The following example configures VLAN-group 3 and a WLAN with its ID of 4094, and apply the
Configuration mapping of wlan4094-vlan-group3 to all the radios of all the APs in the default AP group.
Examples Ruijie(config)#vlan-group 3
Ruijie(config)#wlan-config 4094 pro-4094 ssid-4094
Ruijie(config-wlan)#exit
Ruijie(config)#ap-group default
Ruijie(config-ap-group)#interface-mapping 4094 group 3
The following example configures the default AP group and delete the configured wlan4094-vlan2
mapping.
Ruijie(config)# ap-group default
Ruijie(config-ap-group)# no interface-mapping 4094 2 radio 1

Related Command Description

Commands N/A N/A

Platform
Description

1.20 logging on
Use this command globally to allow logs to be displayed on different devices. Use the no form of this
command to disable this fucntion.
logging on
no logging on

Parameter
Parameter Description
Description
N/A N/A

Defaults Logs are allowed to be displayed on different devices by default.

1-16
Command Reference WLAN Basic Configuration Commands

Command
AP configuration mode
Mode

Usage Guide

Configuration The following example disables the log display on the device.
Examples Ruijie(config)# no logging on

Related
Command Description
Commands
logging buffered Records the logs to a memory buffer.
logging Sends logs to the Syslog server.
logging file flash: Records logs on the extended FLASH.
Allows the log level to be displayed on the
logging console
console.
Allows the log level to be displayed on the VTY
logging monitor
window (such as telnet window) .
Sets the log level to be sent to the Syslog
logging trap
server.

Platform
Description

1.21 logging server

Use this command to record the logs in the specified Syslog Sever. Use the no form of the command
to restore the default setting.
logging server ip-address [ udp-port num ]
no logging server ip-address

Parameter
Parameter Description
Description
ip-address IP address of the host that receives log information.
num Port number of the host that receives log information.

Defaults N/A

Command
AP configuration mode/All APs configuration mode
Mode

Usage Guide This command specifies a Syslog server to receive the logs of the device. Users are allowed to
configure up to 5 Syslog servers. The log information will be sent to all the configured Syslog servers

1-17
Command Reference WLAN Basic Configuration Commands

at the same time.

Configuration The following example specifies a syslog server of the address 202.101.11.1:
Examples Ruijie(config)# logging server 202.101.11.1

Related
Command Description
Commands
logging on Turns on the log switch.
Views log messages and related log
show logging
configuration parameters in the buffer.
Sets the level of logs allowed to be sent to
logging trap
Syslog server.

Platform
Description

1.22 nas-id
Use this command to set the access ID for the WLAN user or AC. Use the no form of this command
to restore the default setting.
nas-id nas-id
no nas-id

Parameter
Parameter Description
Description
nas-id Access ID, containing 32 characters without blank space.

Defaults The default WLAN user access ID is an empty string.

The default AC access ID is the AC MAC address in dotted format.

Command WLAN configuration mode/AC configuration mode

Mode

Usage Guide N/A

Configuration The following example sets the access ID for the WLAN user to 0000059159100460.
Examples Ruijie(config)#show wlan-config cb 1
WLAN ID.................................. 1
SSID..................................... 1-leichen-test-wlan
Profile..................................
MAC Mode................................. Local
Tunnel Mode.............................. 802.3 Tunnel

1-18
Command Reference WLAN Basic Configuration Commands

Suppress SSID............................ Disable

Sta-limit................................ 0
NAS ID................................... 0000059159100460
Band Select.............................. Disable
SSID Code................................

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

1.23 priority
Use this command to set the Failover priority of APs. After you enable the support for the Failover
priority of APs on an AC, the AC can accept the access of APs according to their priority order.
priority priority-value

Parameter
Parameter Description
Description
The parameter indicates the Failover priority of APs.
priority-value
The allowed value is 1, 2, 3, and 4.

Defaults The default is 1.

Command AP configuration mode

Mode

Usage Guide Configure the Failover priority of devices. 1 indicates the lowest priority, and 4 indicate the highest
priority. Add the AC sequence (priority of APs) to the AP. The configurations are saved in the AP.
When the AP is associated next time, the configurations take effect.

Configuration The following example sets the Failover priority of the AP group named apgroup to 3.
Examples Ruijie#config terminal
Ruijie(config)#ap-config apgroup
Ruijie(config-ap)#priority 3

Related
Command Description
Commands
N/A N/A

Platform

1-19
Command Reference WLAN Basic Configuration Commands

Description

1.24 reload at
Use this command to enable AP restart as scheduled every day. Use the no form of this command to
remove the configuration.
reload at time
no reload at

Parameter
Parameter Description
Description
time AP restart time every day, in the format of hh:mm:ss.

Defaults N/A

Command AP configuration mode

Mode

Usage Guide N/A

Configuration The following example enables AP restart at 1:00:00 every day.

Examples Ruijie(config)#ap-config Ruijie-AP1
Ruijie(config-ap)#reload at 1:00:00

Related
Command Description
Commands
N/A N/A

Platform
Description

1.25 reset

In the AC configuration mode, use this command to reset all APs, reset any AP with an updated
software version, and reset any specified AP.

reset{all | |single ap-name}

Parameter Description
Parameter
all Indicates that all APs will be reset.
Description
single ap-name Indicates that a specified AP will be reset.

Defaults N/A

Command AC configuration mode

1-20
Command Reference WLAN Basic Configuration Commands

Mode

Usage Guide N/A

The following example resets all APs.

Configuration Ruijie(config-ac)# reset all
Examples The following example resets the AP named AP0001.
Ruijie(config-ac)# reset AP0001

Related Command Description

Commands N/A N/A

Platform
Description

1.26 show ac-config

Use this command to display the basic configuration information about the current AC.

show ac-config

Parameter Parameter Description

Description N/A N/A

Defaults N/A

Command Any mode

Mode

Usage Guide N/A

The following example displays the basic configuration information of the current AC.
Ruijie(config)#show ac-config
AC Configuration info:
max_wtp :128
sta_limit :4096
license wtp max :128
Configuration license sta max :4096
Examples serial auth :Disable
password auth :Disable
certificate auth :Disable
Bind AP MAC :Disable
AP Priority :Disable
ac_name :Ruijie_Ac_231455
ac location :Ruijie_COM

1-21
Command Reference WLAN Basic Configuration Commands

AC State info:
sta_num :0
act_wtp :12
used wtp :8( 4 normal 8 half)
remain wtp :120 normal 240 half
HW Ver :1.0
SW Ver :AC_RGOS 11.1(1)B1
Mac address :001a.9923.1455
Product ID :WS5708
NET ID :9876543210012345
NAS ID :001a.9923.1455

Related Command Description

Commands N/A N/A

Platform
Description

1.27 show ac-config ap-backup-group

Use this command to display the AP backup group.

show ac-config ap-backup-group [ group-name ]

Parameter Description
Parameter
group-name AP backup group name.
Description
The “default” group is not displayed.

Defaults N/A

Command Any mode

Mode

Usage Guide N/A

The following example displays the all AP backup groups.

Ruijie#show ac-config ap-backup-group
Cnt Group-Name Master-AP cnt Standby-AP cnt
Master-AP-Name Working
Configuration
------ ---------------------------------- ------------ -----------
Examples
------------ -----------
1 AP-BACKUP-GROUP1 1 2 AP4210-1
false

1-22
Command Reference WLAN Basic Configuration Commands

The following example displays details of backup group “AP-BACKUP-GROUP1”.

Ruijie#show ac-config ap-backup-group AP-BACKUP-GROUP1
Cnt Ap-Name Ap-Mac Online Is-Master
Inherit-Wlan Cnt
------- ------------------------ -------------------- ------- ------------
-----------------
1 AP4210-1 8832.0000.1111 true Yes 0
2 APD-M-1 - false No 0
3 APD-M-2 0011.4477.8833 true No 0

Related Command Description

Commands N/A N/A

Platform
Description

1.28 show ap-config bssid

Use this command to display the BSSID list.

show ap-config bssid

Parameter Parameter Description

Description N/A N/A

Defaults N/A

Command Any mode

Mode

Usage Guide N/A

The following example displays the BSSID list.

Ruijie(config)#show ap-config bssid
Configuration AP Mac Radio ID WLAN ID BSSID
Examples -------------- -------- -------- --------------
5869.6c75.7677 1 2 0669.6c75.7679
5869.6c75.7677 2 2 0669.6c75.767a

Related Command Description

Commands N/A N/A

Platform
Description

1-23
Command Reference WLAN Basic Configuration Commands

1.29 show ap-config cb

Use this command to display the status information of an AP.

show ap-config cb ap-name

Parameter Parameter Description

Description ap-name Indicates the name of the AP to be queried.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the status information of an AP.

ac#show ap-config cb wlan-ap-0001
Configuration:
ap name :wlan-ap-0001
ap id :1
discovery timer :20
echo request timer :30
error report timer :120
client timeout timer :300
statistisc time :120
ap fallback :1
image id :RGOS 10.4 (1t7)(1T7), Release(73413)
group name :default
dhcp_option :standard
Configuration
Core dump server ip :0.0.0.0
Examples
Core dump file name :

Status:
local ipv4 :192.168.120.2
Tran protocol :udp
Discovery type :unknow
ECN Support :0
location data :Not Setting
mtu :0
session id :0x0f075476,0x0f075476,0x0f075476,0x0f075476
tunnel mode :0xe(NELR)
mac type :full support
WTP Name :wlan-ap-0001
STA Limit :30

1-24
Command Reference WLAN Basic Configuration Commands

STA num :2
radio num :1

Related Command Description

Commands N/A N/A

Platform
Description

1.30 show ap-config inherit-wlan

Use this command to display the WLAN inherited by the specified AP device in backup group.

show ap-config inherit-wlan ap-name

Parameter Parameter Description

Description ap-name AP name

Defaults N/A

Command Any mode

Mode

Usage Guide N/A

The following example displays the WLAN inherited by the specified AP in the backup group.
ac#show ap-config inherit-wlan wlan-ap-0001
WLAN ID SSID VLAN-Id/VLAN-Group ID Radio ID
Configuration AP WLAN ID
Examples -------- ---------------------- -------------------------
-------------------------- ----------
1 ruijie-wifi 1100 ALL

Related Command Description

Commands N/A N/A

Platform
Description

1.31 show ap-config product

Use this command to display the AP device list.

show ap-config product

1-25
Command Reference WLAN Basic Configuration Commands

Parameter Parameter Description

Description N/A N/A

Defaults N/A

Command Any mode

Mode

Usage Guide N/A

The following example displays the AP device list.

Ruijie#show ap-config product
Product ID Hardware Version Count Used Wtp
Configuration -------------------- ---------------- -------- --------
Examples AP120 1.0 10 5.0
AP220-E 1.0 5 5.0
AP320 2.0 8 8.0
AP530-PPC 1.5 2 2.0

Related Command Description

Commands N/A N/A

Platform
Description

1.32 show ap-config summary

Use this command to display the AP list.

show ap-config summary

Parameter Parameter Description

Description N/A N/A

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the AP list.

Configuration
Ruijie#show ap-config summary
Examples
========= show ap status =========

1-26
Command Reference WLAN Basic Configuration Commands

Radio: Radio ID or Band: 2.4G = 1#, 5G = 2#

E = enabled, D = disabled, N = Not exist
Current Sta number
Channel: * = Global
Power Level = Percent

Online AP number: 2
Offline AP number: 1

AP Name IP Address Mac Address Radio

Radio Up/Off time State
---------------------------------------- --------------- --------------
------------------- ------------------- ------------- -----
AP220E-2 22.22.22.11 00d0.1414.3f67 1 E 0
11* 100 2 E 0 153* 100 0:00:37:34 Run
xh-ap 10.21.121.4 00d0.f822.33d6 1# N 0
- - 2# N 0 - - 0:23:56:05 Run
AP220E_V2.0_19 - 1414.4b13.96f7 1 N -
- - 2 N - - - 0:00:14:07 Quit

Related Command Description

Commands N/A N/A

Platform
Description

1.33 show ap-config summary ap-auth

Use this command to display authentication information on all APs.
show ap-config summary ap-auth

Parameter
Parameter Description
Description
N/A N/A

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

Configuration The following example displays authentication information on all APs.

Examples Ruijie#sh ap-config summary ap-auth

1-27
Command Reference WLAN Basic Configuration Commands

AP Name Mac Address Bind bind-ap-serial Bind

bind-ap-cert Bind bind-ap-password Bind State
-------------------------- -------------- ----- ---------------- -----
------------------------- ----- ---------------- ----- -----
ap220 1414.4b13.9ff3 FALSE TRUE
FALSE TRUE Run
0011.0000.0101 FALSE TRUE
FALSE TRUE Quit
0011.0000.0201 FALSE TRUE
FALSE TRUE Quit

Related
Command Description
Commands
N/A N/A

Platform
Description

1.34 show ap-config summary deny-ap

Use this command to display the list of APs that are refused in attempt to associate with the AC.
show ap-config summary deny-ap

Parameter
Parameter Description
Description
N/A N/A

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

Configuration The following example displays the list of APs that are refused in attempt to associate with the AC.
Examples Ruijie#sh ap-config summary deny-ap
AP Name IP Address Mac Address Reason
----------- ----------------- -------------- --------------
AP1 192.168.10.10 1414.4b13.9ff3 By bind-ap-mac
AP2 192.168.10.11 00d0.f822.33b0 By bind-ap-mac

Related
Command Description
Commands
N/A N/A

1-28
Command Reference WLAN Basic Configuration Commands

Platform
Description

1.35 show ap-group aps

Use this command to display the list of APs connected to a specified AP group.

show ap-group aps ap-group-name

Parameter Parameter Description

Description ap-group-name Indicates an AP group name.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the basic configuration information of the current AC.
Ruijie(config)#show ap-group aps default
Configuration
Ap Name Mac Addr Pid
Examples
-------------------- --------------- --------------------
rrm-ap 0011.1122.3333 AP220E

Related Command Description

Commands N/A N/A

Platform
Description

1.36 show ap-group aps summary

Use this command to display the APs of all AP groups.
show ap-group aps summary

Parameter
Parameter Description
Description
N/A N/A

Defaults N/A

Command Privileged EXEC mode

Mode

1-29
Command Reference WLAN Basic Configuration Commands

Usage Guide N/A

Configuration The following example displays the APs of all AP groups.

Examples Ruijie(config)#show ap-group aps summary
AP Group Name AP Name Mac Addr
-------------------- -------------------- ---------------
default rrm-ap 0011.1122.3333
default ap0001 0011.1122.4444

Related
Command Description
Commands
N/A N/A

Platform
Description

1.37 show ap-group cb

Use this command to display the basic configuration information of a specified AP group.

show ap-group cb ap-group-name

Parameter Parameter Description

Description ap-group-name Indicates an AP group name.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the basic configuration information of the default AP group.
Ruijie(config)#show ap-group cb default

Ap Group info:
Configuration
apg_name :default
Examples
discovery_timer :20
echo_req_timer :30
error_report_timer :120
sta_time_out :300

1-30
Command Reference WLAN Basic Configuration Commands

stati_time :120
ap_fallback :Enable
image_id :

Related Command Description

Commands N/A N/A

Platform
Description

1.38 show ap-group intf-wlan-map

Use this command to display the WLAN-to-VLAN mapping table of a specified AP group.

show ap-group intf-wlan-map ap-group-name

Parameter Parameter Description

Description ap-group-name Indicates an AP group name.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the basic configuration information of the current AC.
Ruijie(config)#show ap-group intf-wlan-map default
Configuration
WlAN ID SSID Vlan Id Radio id Mib index
Examples
--------- ---------------- ---------------- ---------- ----------------
500 ssid-500 2 ALL 1

Related Command Description

Commands N/A N/A

Platform
Description

1.39 show ap-group summary

Use this command to display the list of all AP groups configured for the current AC.

show ap-group summary

Parameter Parameter Description

1-31
Command Reference WLAN Basic Configuration Commands

Description N/A N/A

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the list of all AP groups configured for the current AC.
Ruijie(config)#show ap-group summary
Configuration Total Ap Group Num : 2
Examples Ap Group Name
1. default
2. test-group

Related Command Description

Commands N/A N/A

Platform
Description

1.40 show wlan-config cb

Use this command to display the configuration details of a specified WLAN.

show wlan-config cb wlan-id

Parameter Parameter Description

Description N/A N/A

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the configuration of WLAN 512.

Ruijie(config)#show wlan-config cb 512
WLAN ID.................................. 512
Configuration SSID..................................... ssid-512
Examples Profile.................................. <NULL>
Short Preamble........................... Disable
Spectrum Management...................... Disable
QoS...................................... Disable

1-32
Command Reference WLAN Basic Configuration Commands

Short Slot Time.......................... Disable

APSD..................................... Disable
Delayed Block ACK........................ Disable
Immediate Block ACK...................... Disable
MAC Mode................................. Local
Tunnel Mode.............................. 802.3 Tunnel
Suppress SSID............................ Enable
RTS Threshold............................ 2347
Long Retry............................... 4
Short Retry.............................. 7

Related Command Description

Commands N/A N/A

Platform
Description

1.41 show wlan-config summary

Use this command to display the WLAN configuration list on the AC.

show wlan-config summary

Parameter Parameter Description

Description N/A N/A

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the WLAN configuration list on the AC.
Ruijie(config)#show wlan-config summary
Total Wlan Num : 3
Configuration Wlan id Profile Name SSID STA NUM
Examples -------- -------------------- -------------------- --------
1 pro-1 ssid-1 0
2 pro-2 ssid-2 0
4095 <NULL> ssid-4095 0

Related Command Description

Commands N/A N/A

1-33
Command Reference WLAN Basic Configuration Commands

Platform
Description

1.42 ssid
Use this command to set SSID.
ssid ssid-string

Parameter
Parameter Description
Description
ssid-string SSID character string, consisting of up to 32 characters.

Defaults N/A

Command WLAN configuration mode

Mode

Usage Guide If a WLAN is deployed, changing SSID will disconnected the STAs associated with WLAN.

Configuration The following example changes the SSID of WLAN1 to ruijie.

Examples Ruijie(config)#wlan-config 1
Ruijie(config-wlan)#ssid ruijie

Related
Command Description
Commands
N/A N/A

Platform
Description

1.43 statistics-timer

Use this command to configure statistics timer for a specified AP or all APs in a specified AP group.
Use the no form of this command to restore the default configuration.

statistics-timer timer-num

no statistics-timer

Parameter Description
Parameter
timer-num Indicates a timer interval to be configured, in the range
Description
from 1 to 65535 in the unit of seconds.

Defaults The default is 120 seconds.

1-34
Command Reference WLAN Basic Configuration Commands

Command AP configuration mode or AP group configuration mode

Mode

The command is used to set statistics timer for a specified AP. This command prefixed with no can
Usage Guide
be used to restore the default value.

The following example enters the configuration mode of AP0001 to configure its statistics timer to
200 seconds.
Ruijie(config)# ap-config AP0001
Ruieji(config-ap)# statistics-timer 200
The following example enters the configuration mode of AP0001 to restore the default setting.
Ruijie(config)# ap-config AP0001
Configuration
Ruieji(config-ap)# no statistics-timer
Examples
The following example enters the default AP group to configure its statistics timer to 200 seconds.
Ruijie(config)# ap-group default
Ruijie(config-ap-group)# statistics-timer 200
The following example enters the default AP group to restore the default setting.
Ruijie(config)# ap-group default
Ruijie(config-ap-group)# no statistics-timer

Related Command Description

Commands N/A N/A

Platform
Description

1.44 wlan-config

Use this command create a WLAN and enter the WLAN configuration mode. Use the no form of this
command to remove the configuration.

wlan-config wlan-id [ profile-string ] [ ssid-string ]

no wlan-config wlan-id

Parameter Description
wlan-id Indicates an ID for the WLAN to be created, ranging from
1 to 4094.
Parameter
profile-string Indicates a descriptor for the WLAN, which can be
Description
omitted.
ssid-string Indicates the SSID character string corresponding to the
WLAN.

Defaults N/A

1-35
Command Reference WLAN Basic Configuration Commands

Command WLAN configuration mode

Mode

To create a WLAN, you must specify ssid-string but can omit profile-string as mentioned in the
command description. When a WLAN is created, cli will automatically enter the configuration mode
of this WLAN.
Usage Guide
To enter the configuration mode of a WLAN, you only need to specify the existing ID of this WLAN.
One SSID can correspond to more than one WLAN, but one WLAN cannot be associated with
multiple SSIDs at the same time.

The following example creates a WLAN with an ID of 2048 and a SSID of ssid-test.
Ruijie(config)# wlan-config 2048 profile-test ssid-test
Ruijie(config-wlan)# exit
Configuration
Ruijie(config)#
Examples
The following example enters the configuration mode of the WLAN with the ID of 2048.
Ruijie(config)# wlan-config 2048
Ruijie(config-wlan)# exit

Command Description
Related
interface-mapping wlan-id vlan-id
Commands Applies this WLAN to a specified radio.
[radio radio-id]

Platform
Description

1.45 wtp-limit

Use this command to configure the maximum number of AP supported on the AC. Use the no form of
this command to restore the default setting.

wtp-limit wtp-num

no wtp-limit

Parameter Description
Parameter
wtp-num The parameter indicates the maximum number of AP
Description
connected to the AC.

Defaults The default is 16 for WS5302 , and 128 for WS5708.

Command AC configuration mode

Mode

The command is used to configure the maximum number of AP supported on the AC. This number
Usage Guide
can exceed neither the maximum number supported by the AC nor the maximum number allowed by

1-36
Command Reference WLAN Basic Configuration Commands

the license.

Different model of AP product has the different weight of supported number, for example, two
wall APs occupy one of the maximum number. The AC device will calculate the real number of
occupied APs according to the weight ratio. This command is used to configure the weight number of
APs instead of real number of APs.

The following example configures the AC to connect 100 APs at most.

Configuration Ruijie(config-ac)# wtp-limit 100
Examples The following example configures the AC to connect a default maximum of 128 APs.
Ruijie(config-ac)# no wtp-limit

Command Description
Related
Configures the maximum number of clients supported by
Commands sta-limit
the AC.

Platform
Description

1-37
Command Reference WLAN STAMP Commands

2 WLAN STAMP Commands

2.1 ap
Use this command to configure the AP information in the association control zone. Use the no form of
this command to delete the specified AP from the association control zone.
ap WORD
no ap [ WORD ]

Parameter
Parameter Description
Description
WORD AP name. The name length range is from 1 to 64.

Defaults No AP information in the association control zone is configured by default.

Command Association control zone configuration mode
mode
Usage Guide Up to five APs can be configured in an association control zone. The system will prompt an error
message if the number of the configured APs exceeds five. In addition, when configuring AP
information for an association control zone, we do not require that APs are online.
Configuration
The following example configures a set of AP information with MAC address of 00d0.f800.1001 for an
Examples
association control zone named “Class (1) Grade 1”.

Ruijie(config)#control-zone Class (1) Grade 1

Ruijie(config-cznoe)# ap 00d0.f800.1001
Related
Command Description
Commands
show control-zone Displays the association control zone.
Platform This command is supported only on ACs.
Description

2.2 assoc-control
Use this command to enable the association control function. Use no form of this command to restore
the default setting.
assoc-control
no assoc-control

Parameter
Parameter Description
Description
N/A N/A
Defaults This function is disabled by default.
Command Global configuration mode

2-1
Command Reference WLAN STAMP Commands

mode
Usage Guide When the association control function is disabled, the association control related commands can still
be configured with the ineffective association control function.
Configuration The following example enables the association control function.
Examples Ruijie(config)#assoc-control
The following example disables the association control function.
Ruijie (config)#no assoc-control

Related
Command Description
Commands
N/A N/A
Platform This command is supported only on ACs.
Description

2.3 client-kick

Use this command to delete the MAC address of a specified wireless user.

client-kick sta-mac

Parameter Parameter Description

Description sta-mac Indicates the MAC address of a wireless user.

Defaults N/A

Command AC configuration mode

Mode

Usage Guide N/A

The following example deletes the wireless user with the MAC address aaaa.bbbb.cccc.
Configuration
Ruijie(config)# ac-controller
Examples
Ruijie(config-ac)# client-kick aaaaa.bbbbb.ccccc

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.4 control-zone
Use this command to create an association control zone and enter association control zone
configuration mode. Use the no form of this command to restore the default setting.

2-2
Command Reference WLAN STAMP Commands

control-zone czone-name
no control-zone czone-name

Parameter
Parameter Description
Description
czone-name Association control zone name. The name length range is 1 to 64.
Defaults N/A
Command Global configuration mode
mode
Usage Guide Up to 300 association control zones can be configured on an AC. Only one association control zone
is allowed to be configured on a fat AP. The system will prompt an error message if the upper limit is
exceeded.
Configuration The following example configures an association control zone named “Class (1) Grade 1”.
Examples Ruijie(config)#control-zone Class (1) Grade 1
Ruijie(config- czone)#
The following example deletes an association control zone named “Class (1) Grade 1”.
Ruijie(config)# no control-zone Class (1) Grade 1
The operation will clear the control zone configuration, which may cause
corresponding STAs offline. Continue? [no] y
Ruijie(config)#
Related
Command Description
Commands
Displays the summary of association control
show control-zone summary
zones.
Platform This command is supported only on ACs.
Description

2.5 flow-balance-group add

Use this command to add a specified AP to a specified load balancing group.

flow-balance-group add group-name ap-name

Parameter Description
group-name Indicates the name of the specified balancing group.
Parameter
Each flow-based load balancing group supports 10 APs
Description
at the most.
ap-name Indicates the AP’s name to be added

Defaults N/A

Command AC configuration mode

Mode

Usage Guide N/A

2-3
Command Reference WLAN STAMP Commands

The following example adds ap1 and ap2 to the balancing group named test-group
Configuration Ruijie(config)# ac-controller
Examples Ruijie(config-ac)# flow-balance-group add test-group ap1
Ruijie(config-ac)# flow-balance-group add test-group ap2

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.6 flow-balance-group base

Use this command to configure the traffic base value for load balancing. Use the no form of this
command to restore the default setting.

flow-balance-group base number

no flow-balance-group base

Parameter Parameter Description

Description number Traffic base value. The range is from 1 to 100.

Defaults The traffic base value is 10 Mbps by default.

Command AC configuration mode

Mode

Usage Guide N/A

The following example sets the traffic base value for load balancing to 50 Mbps
Configuration
Ruijie(config)# ac-controller
Examples
Ruijie(config-ac)# flow-balance-group base 50

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.7 flow-balance-group create

Use this command to configure the load-balancing group based on the flow. Use the no form of this
command to remove the configuration.

2-4
Command Reference WLAN STAMP Commands

flow-balance-group create group-name

no-flow-balance-group create group-name

Parameter Description
Parameter group-name The name of a load balancing group, allows a maximum
Description of 55 characters and excludes space. It supports 80
flow-balancing groups at most.

Defaults N/A

Command AC configuration mode

Mode

Usage Guide The no option of this command is used to delete configuration of a specific balancing group.

The following example creates a load balancing group named test-group.

Ruijie(config)# ac-controller
Configuration Ruijie(config-ac)# flow-balance-group create test-group
Examples The following example deletes the load balancing group named test-group.
Ruijie(config)# ac-controller
Ruijie(config-ac)# no flow-balance-group create test-group

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.8 flow-balance-group del

Use this command to delete a specified AP from a specified load balancing group.

flow-balance-group del group-name ap-name

Parameter Description
Parameter group-name The load balancing group for operation.
Description ap-name The name of AP to be deleted from the load balancing
group.

Defaults N/A

Command AC configuration mode

Mode

Usage Guide N/A

2-5
Command Reference WLAN STAMP Commands

The following example deletes ap1 from balancing group named test-group.
Configuration
Ruijie(config)# ac-controller
Examples
Ruijie(config-ac)# flow-balance-group del test-group ap1

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.9 flow-balance-group enable

Use this command to configure a threshold value for the traffic of associated AP devices to enable load
balancing. Use the no form of this command to restore the default threshold value.

flow-balance-group enable group-name number

no flow-balance-group enable group-name number

Parameter Description
group-name The load balancing group for operation.
Parameter
number The traffic threshold value. The unit is %. The range is
Description
from 0 to 500.
“0” indicates load balancing is disabled.

Defaults The default traffic threshold is 5%.

Command AC configuration mode

Mode

Usage Guide N/A

The following example sets the traffic threshold of load balancing group test-group to 100 Kbps.
Configuration
Ruijie(config)# ac-controller
Examples
Ruijie(config-ac)# flow-balance-group enable test-group 1

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2-6
Command Reference WLAN STAMP Commands

2.10 flow-balance-group flow

Use this command to configure the load threshold of the balancing group. Use the no form of this
command to remove the configuration.

[no] flow-balance-group flow group-name ap-name

Parameter Description
group-name Name of load balancing group for operation.
Parameter number The threshold of the balancing group, the unit is 100
Description Kbps, the default is 500 Kbps, and the scope is 0-100000
kbps. 0 indicates this balancing group does not enable
flow-based load balancing function.

Defaults The default traffic threshold is 5%.

Command AC configuration mode

Mode

Usage Guide N/A

The following example configures the threshold of balancing group named test-group as 100 Kbps.
Configuration
Ruijie(config)# ac-controller
Examples
Ruijie(config-ac)# flow-balance-group flow test-group 1

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.11 flow-balance-group radio-flow

Use this command to configure the load balancing group based on the traffic reported by the AP
periodically. Use the no form of this command to remove the configuration.
flow-balance-group radio-flow group-name
no flow-balance-group radio-flow group-name
Parameter
Parameter Description
Description
group-name Load balancing group name.
Defaults By default, the traffic calculated from the CAPWAP data channel on the AC device is used.
Command AC configuration mode
mode
Usage Guide N/A

2-7
Command Reference WLAN STAMP Commands

Configuration
The following example configures the load balancing group based on the traffic reported by the AP
Examples
periodically.

Ruijie(config)# ac-controller
Ruijie(config-ac)# flow-balance-group radio-flow test-group
Related
Command Description
Commands
N/A N/A
Platform This command is supported only on ACs.
Description

2.12 inter-radio-balance flow-balance dual-band

Use this command to configure the enabling threshold and balancing threshold for the traffic
balancing between the different radios (2.4G and 5.0G) of AP devices or AP groups. Use the no form
of this command to restore the default settings.
inter-radio-balance flow-balance dual-band enable-load en-num threshold thrs-num
no inter-radio-balance flow-balance dual-band
Parameter
Parameter Description
Description
The enabling threshold value. Load balancing is enabled only when
en-num the traffic on the associated radio exceeds the threshold. The unit is
100 Kbps. The range is from 1 to 1000.
The balancing threshold value. The STA will be disassociated with the
thrs-num radio when the traffic difference between the associated radio and
lowest load radio. The unit is 100 Kbps. The range is from 1 to 1000.
Defaults By default, the enabling threshold is 1 Mbps and the balancing threshold is 1 Mbps.
Command AP /AP group configuration mode
mode
Usage Guide When the load balancing between radios is enabled, if the traffic of associated radio exceeds the
enabling threshold and the traffic difference between the associated radio and lowest load radio
exceeds the balancing threshold, the STA will be disassociated with the radio and the traffic will be
balanced to radio of lower load. This configuration takes effect only when the radio of lowest load is
on the different radio to be associated. The inter-radio-balance flow-balance same-band takes
effect If the two radios are on the same radio.
Configuration
The following example configures the enabling threshold and balancing threshold to 800 Kbps and
Examples
800 Kbps respectively for the different radios on AP0001.

Ruijie(config)# ap-config AP0001

Ruijie(config-ap)# inter-radio-balance flow-balance same-band enable-load 8
threshold 8

The following example restores the default load balancing settings for different radios on AP0001.

2-8
Command Reference WLAN STAMP Commands

Ruijie(config)# ap-config AP0001

Ruijie(config-ap)# no inter-radio-balance flow-balance dual-band

The following example configures the enabling threshold and balancing threshold to 300 Kbps and

500 Kbps respectively for different radios of AP devices in the AP group.

Ruijie(config)# ap-group default

Ruijie(config-group)# inter-radio-balance flow-balance dual-band enable-load
3 threshold 5

The following example configures the enabling threshold and balancing threshold to 3 Mbps and 3

Mbps respectively for different radios on all AP devices.

Ruijie(config)# ap-config all

Ruijie(config-ap)# inter-radio-balance flow-balance dual-band enable-load 30
threshold 30
Related
Command Description
Commands
N/A N/A
Platform This command is supported only on ACs.
Description

2.13 inter-radio-balance flow-balance enable

Use this command to enable load balancing for traffic between different radios (2.4G and 5.0G) on
the AP device or AP group. Use the no form of this command to disable load balancing between
radios on the AP device or AP group.
inter-radio-balance flow-balance enable
no inter-radio-balance flow-balance enable
Parameter
Parameter Description
Description
N/A N/A
Defaults By default, load balancing between radios is disabled.
Command AP /AP group configuration mode
mode
Usage Guide After load balancing between radios is enabled on an AP device, the AC device will make the traffic
difference between radios on the AP device not exceed the threshold value.
Configuration
The following example enables load balancing for traffic between radios on AP0001.
Examples
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# inter-radio-balance flow-balance enable

2-9
Command Reference WLAN STAMP Commands

The following example disables load balancing for traffic between radios on AP0001.

Ruijie(config)# ap-config AP0001

Ruijie(config-ap)# no inter-radio-balance flow-balance enable

The following example enables load balancing for traffic between radios on the AP devices in the

default group.

Ruijie(config)# ap-group default

Ruijie(config-group)# inter-radio-balance flow-balance enable

The following example enables load balancing for traffic between radios on all AP devices.

Ruijie(config)# ap-config all

Ruijie(config-ap)# inter-radio-balance flow-balance enable
Related
Command Description
Commands
N/A N/A
Platform This command is supported only on ACs.
Description

2.14 inter-radio-balance flow-balance same-band

Use this command to configure the enabling threshold and balancing threshold for the traffic
balancing between the same radios (both 2.4G or 5.0G) of AP devices or AP groups. Use the no form
of this command to restore the default settings.
inter-radio-balance flow-balance same-band enable-load en-num threshold thrs-num
no inter-radio-balance flow-balance same-band
Parameter
Parameter Description
Description
The enabling threshold value. Load balancing is enabled only when
en-num the traffic on the associated radio exceeds the threshold. The unit is
100 Kbps. The range is from 1 to 1000.
The balancing threshold value. The STA will be disassociated with the
thrs-num radio when the traffic difference between the associated radio and
lowest load radio. The unit is 100 Kbps. The range is from 1o to 1000.
Defaults By default, the enabling threshold is 500 Kbps and the balancing threshold is 500 Kbps.
Command AP /AP group configuration mode
mode
Usage Guide When the load balancing between radios is enabled, if the traffic of associated radio exceeds the
enabling threshold and the traffic difference between the associated radio and lowest load radio
exceeds the balancing threshold, the STA will be disassociated with the radio and the traffic will be
balanced to the radio of lower load. This configuration takes effect only when the radio of lowest load
is on the different the radio to be associated. The inter-radio-balance flow-balance dual-band

2-10
Command Reference WLAN STAMP Commands

takes effect If the two radios are on the different radio.

Configuration
The following example configures the enabling threshold and balancing threshold to 800 Kbps and
Examples
800 Kbps respectively for the same radios on AP0001.

Ruijie(config)# ap-config AP0001

Ruijie(config-ap)# inter-radio-balance flow-balance same-band enable-load 8
threshold 8

The following example restores the default load balancing settings for the same radios on AP0001.

Ruijie(config)# ap-config AP0001

Ruijie(config-ap)# no inter-radio-balance flow-balance same-band

The following example configures the enabling threshold and balancing threshold to 300 Kbps and

500 Kbps respectively for the same radios of AP devices in the AP group.

Ruijie(config)# ap-group default

Ruijie(config-group)# inter-radio-balance flow-balance same-band enable-load
3 threshold 5

The following example configures the enabling threshold and balancing threshold to 3 Mbps and 3

Mbps respectively for the same radios on all AP devices.

Ruijie(config)# ap-config all

Ruijie(config-ap)# inter-radio-balance flow-balance same-band enable-load 30
threshold 30
Related
Command Description
Commands
N/A N/A
Platform This command is supported only on ACs.
Description

2.15 inter-radio-balance num-balance dual-band

Use this command to configure the enabling threshold and balancing threshold for STA balancing
between the different radios (2.4G and 5.0G) of AP devices or AP groups. Use the no form of this
command to restore the default settings.
inter-radio-balance num-balance dual-band enable-load en-num threshold thrs-num
no inter-radio-balance num-balance dual-band
Parameter
Parameter Description
Description
The enabling threshold value. Load balancing is enabled only when
en-num
the number of STAs associated with the radio exceeds the threshold.

2-11
Command Reference WLAN STAMP Commands

The range is from 1 to 20.

The balancing threshold value. The STA will be disassociated with the
thrs-num radio when the STA number difference between the associated radio
and lowest load radio. The range is from 1 to 20.
Defaults By default, the enabling threshold is 8 and the balancing threshold is 8.
Command AP /AP group configuration mode
mode
Usage Guide When the load balancing between radios is enabled, if the number of STAs associated with the radio
exceeds the enabling threshold and the STA number difference between the associated radio and
lowest load radio exceeds the balancing threshold, the STA will be disassociated with the radio and
the STAs will be balanced to radio of lower load. This configuration takes effect only when the radio of
lowest load is on the different radio to be associated. The inter-radio-balance num-balance
same-band takes effect If the two radios are on the same radio.
Configuration
The following example configures the enabling threshold and balancing threshold to 10 and 10
Examples
respectively for the different radios on AP0001.

Ruijie(config)# ap-config AP0001

Ruijie(config-ap)# inter-radio-balance num-balance dual-band enable-load 10
threshold 10

The following example restores the default load balancing settings for different radios on AP0001.

Ruijie(config)# ap-config AP0001

Ruijie(config-ap)# no inter-radio-balance num-balance dual-band

The following example configures the enabling threshold and balancing threshold to 4 and 5

respectively for different radios of AP devices in the AP group.

Ruijie(config)# ap-group default

Ruijie(config-group)# inter-radio-balance num-balance dual-band enable-load
4 threshold 5

The following example configures the enabling threshold and balancing threshold to 5 and 5

respectively for different radios on all AP devices.

Ruijie(config)# ap-config all

Ruijie(config-ap)# inter-radio-balance num-balance dual-band enable-load 5
threshold 5
Related
Command Description
Commands
N/A N/A
Platform This command is supported only on ACs.
Description

2-12
Command Reference WLAN STAMP Commands

2.16 inter-radio-balance num-balance enable

Use this command to enable load balancing for the number of STAs between different radios (2.4G
and 5.0G) on the AP device or AP group. Use the no form of this command to disable load balancing
between radios on the AP device or AP group.
inter-radio-balance num-balance enable
no inter-radio-balance num-balance enable

Parameter
Parameter Description
Description
N/A N/A
Defaults By default, load balancing between radios is disabled.
Command AP /AP group configuration mode
mode
Usage Guide After load balancing between radios is enabled on an AP device, the AC device will make the STA
number difference between radios on the AP device not exceed the threshold value.
Configuration
The following example enables load balancing for the number of STAs between radios on AP0001.
Examples
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# inter-radio-balance num-balance enable

The following example disables load balancing for the number of STAs between radios on AP0001.

Ruijie(config)# ap-config AP0001

Ruijie(config-ap)# no inter-radio-balance num-balance enable

The following example enables load balancing for the number of STAs between radios on the AP

devices in the default group.

Ruijie(config)# ap-group default

Ruijie(config-group)# inter-radio-balance num-balance enable

The following example enables load balancing for the number of STAs between radios on all AP

devices.

Ruijie(config)# ap-config all

Ruijie(config-ap)# inter-radio-balance num-balance enable
Related
Command Description
Commands
N/A N/A
Platform This command is supported only on ACs.
Description

2-13
Command Reference WLAN STAMP Commands

2.17 inter-radio-balance num-balance same-band

Use this command to configure the enabling threshold and balancing threshold for STA balancing
between the same radios (both 2.4G or 5.0G) of AP devices or AP groups. Use the no form of this
command to restore the default settings.
inter-radio-balance num-balance same-band enable-load en-num threshold thrs-num
no inter-radio-balance num-balance same-band
Parameter
Parameter Description
Description
The enabling threshold value. Load balancing is enabled only when
en-num the number of STAs associated with the radio exceeds the threshold.
The range is from 1 to 20.
The balancing threshold value. The STA will be disassociated with the
thrs-num radio when the STA number difference between the associated radio
and lowest load radio. The range is from 1o to 20.
Defaults By default, the enabling threshold is 2 and the balancing threshold is 2.
Command AP /AP group configuration mode
mode
Usage Guide When the load balancing between radios is enabled, if the number of STAs associated with the radio
exceeds the enabling threshold and the STA number difference between the associated radio and
lowest load radio exceeds the balancing threshold, the STA will be disassociated with the radio and
the STAs will be balanced to the radio of lower load. This configuration takes effect only when the
radio of lowest load is on the different the radio to be associated. The inter-radio-balance
num-balance dual-band takes effect If the two radios are on the different radio.
Configuration
The following example configures the enabling threshold and balancing threshold to 3 and 3
Examples
respectively for the same radios on AP0001.

Ruijie(config)# ap-config AP0001

Ruijie(config-ap)# inter-radio-balance num-balance same-band enable-load 3
threshold 3

The following example restores the default load balancing settings for the same radios on AP0001.

Ruijie(config)# ap-config AP0001

Ruijie(config-ap)# no inter-radio-balance num-balance same-band

The following example configures the enabling threshold and balancing threshold to 3 and 5

respectively for the same radios of AP devices in the AP group.

Ruijie(config)# ap-group default

Ruijie(config-group)# inter-radio-balance num-balance same-band enable-load
3 threshold 5

2-14
Command Reference WLAN STAMP Commands

The following example configures the enabling threshold and balancing threshold to 5 and 5

respectively for the same radios on all AP devices.

Ruijie(config)# ap-config all

Ruijie(config-ap)# inter-radio-balance num-balance same-band enable-load 5
threshold 5
Related
Command Description
Commands
N/A N/A
Platform This command is supported only on ACs.
Description

2.18 num-balance-group add

Use this command to add a specified AP to a specified load balancing group.

num-balance-group add group-name ap-name

Parameter Description
group-name The name of the specified balancing group. Each
Parameter
number-based balancing group supports 10 APs at the
Description
most.
ap-name The name of the AP to be added

Defaults N/A

Command AC configuration mode

Mode

Usage Guide N/A

The following example adds ap1 to the balancing group test-group.

Configuration
Ruijie(config)# ac-controller
Examples
Ruijie(config-ac)# num-balance-group add test-group ap1

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.19 num-balance-group create

Use this command to create load balancing group based on number. Use the no form of this command
to remove the configuration.

2-15
Command Reference WLAN STAMP Commands

num-balance-group create group-name

no num-balance-group create group-name

Parameter Description
Parameter group-name The name of the load balancing group, allows a maximum
Description of 55 characters, blank space is not included. It supports
80 number-based balancing groups at most.

Defaults N/A

Command AC configuration mode

Mode

Usage Guide N/A

The following example creates a load balancing group named test-group.

Ruijie(config)# ac-controller
Configuration Ruijie(config-ac)# num-balance-group create test-group
Examples The following example deletes a load balancing group named test-group.
Ruijie(config)# ac-controller
Ruijie(config-ac)# no num-balance-group create test-group

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.20 num-balance-group del

Use this command to delete a specified AP from a specified load balancing group.

num-balance-group del group-name ap-name

Parameter Description
Parameter group-name The load balancing group for operation.
Description ap-name The name of the AP to be deleted from the balancing
group.

Defaults N/A

Command The AC configuration mode

Mode

Usage Guide N/A

2-16
Command Reference WLAN STAMP Commands

The following example deletes ap1 from the balancing group named test-group.
Configuration
Ruijie(config)# ac-controller
Examples
Ruijie(config-ac)# num-balance-group del test-group ap1

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.21 num-balance-group enable

Use this command to configure a threshold value for the number of STAs associated with AP devices
to enable load balancing. Use the no form of this command to restore the default threshold value.

num-balance-group enable group-name number

no num-balance-group enable group-name number

Parameter Description
group-name The load balancing group for operation.
Parameter
ap-name The enabling threshold value. The range is from 0 to 10.
Description
“0” indicates load balancing for the number of STAs is
disabled.

Defaults The default enabling threshold is 3.

Command AC configuration mode

Mode

Usage Guide N/A

The following example sets the enabling threshold for the number of STAs associated to 1.
Configuration
Ruijie(config)# ac-controller
Examples
Ruijie(config-ac)# num-balance-group enable test-group 1

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2-17
Command Reference WLAN STAMP Commands

2.22 num-balance-group mode

Use this command to configure the mode of load balancing group. Use the no form of the command to
restore the default setting.

num-balance-group mode group-name { radio-mode | ap-mode }

no num-balance-group mode group-name

Parameter Description
Parameter
group-name The name of the load balancing group for operation.
Description
radio-mode The radio-based mode of the load balancing group.
ap-mode The AP-based mode of the load balancing group.

Defaults The default is AP-based mode.

Command AC configuration mode.

Mode

Usage Guide N/A

The following example configures the radio-based mode for the balancing group named test-group
Configuration
Ruijie(config)# ac-controller
Examples
Ruijie(config-ac)# num-balance-group mode test-group radio-mode

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.23 num-balance-group num

Use this command to configure the load threshold of the load balancing group. Use the no form of this
command to remove the configuration.

[no] flow-balance-group flow group-name ap-name

Parameter Description
group-name The name of the load balancing group for the operation.
Parameter
number The threshold of balancing group. The range is from 0 to
Description
20. 0 indicates this balancing group disables the
flow-based load balancing function..

Defaults The default threshold is 3

2-18
Command Reference WLAN STAMP Commands

Command The AC configuration mode

Mode

Usage Guide N/A

The following example configures the threshold of the balancing group named test-group as 1.
Configuration
Ruijie(config)# ac-controller
Examples
Ruijie(config-ac)# num-balance-group flow test-group 1

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.24 package
Use this command to create a terminal package and enter terminal package configuration mode. Use
the no form of this command to restore the default setting.
package pkg-name
no package [ pkg-name ]
Parameter
Parameter Description
Description
pkg-name Terminal package name. The name length range is from 1 to 32.
Defaults No terminal packets are configured by default.
Command Global configuration mode
mode
Usage Guide Up to 300 terminal packages can be configured on an AC. Only 50 terminal packages are allowed to
be configured on a fat AP. The system will prompt an error message if the upper limit is exceeded.
Configuration The following example configures a terminal package named “Cart”1.
Examples Ruijie(config)#package Cart 1
Ruijie(config-package)#
The following example configures the package named “Cart”1.
Ruijie(config)# no package Cart 1
The operation will clear package(s) configuration, which may cause
corresponding STAs offline. Continue? [no] y
Ruijie(config)#
Related
Command Description
Commands
show package Displays the terminal package configuration.
Platform This command is supported only on ACs.
Description

2-19
Command Reference WLAN STAMP Commands

2.25 primary-sta
Use this command to configure a primary STA in a terminal package. Use the no form of this
command to remove the configuration.
primary-sta mac-address
no primary-sta
Parameter
Parameter Description
Description
mac-address The MAC address of the primary STA, in the format of H.H.H.
Defaults N/A
Command Terminal package configuration mode
mode
Usage Guide A terminal package can be configured up to one primary STA. Therefore the newly configured
primary STA will cover the one which has been configured in a terminal packet.
Configuration The following example configures a primary STA with MAC address of 00d0.f800.0001 for the
Examples terminal package “Cart 1”.
Ruijie(config)#package Cart 1
Ruijie(config- package)#primary-sta 00d0.f800.0001
Related
Command Description
Commands
show package Displays the terminal package configuration.
Platform This command is supported only on ACs .
Description

2.26 secondary-sta
Use this command to configure secondary STAs in a terminal package. Use the no form of this
command to remove the configuration.
secondary-sta mac-address
no secondary-sta [ mac-address ]
Parameter
Parameter Description
Description
mac-address The MAC address of the secondary STA, in the format of H.H.H.
Defaults N/A
Command Terminal package configuration mode
mode
Usage Guide Up to 100 secondary STAs can be configured in one terminal package. The system will prompt the
error message in the following conditions if you use this command to configure the secondary STA:
The secondary STA configured has existed in the terminal package.
The number of STAs in a terminal package exceeds 100.
Configuration The following example configures a secondary STA with MAC address of 00d0.f800.0002 for the
Examples package “Cart 1”.
Ruijie(config)#package Cart 1
Ruijie(config- package)#secondary-sta 00d0.f800.0002

2-20
Command Reference WLAN STAMP Commands

Related
Command Description
Commands
show package Displays the terminal package configuration.
Platform This command is supported only on ACs.
Description

2.27 show ac-config client

Use this command to display the information about all the STAs connected with the current AC.

show ac-config client [ by-ap-name | 802.11a | 802.11b | 802.11n | 802.11g | 802.11ac | other ]

Parameter Description
by-ap-name Indicates that the STAs are sorted by AP name.
802.11a Displays information about users of 802.11a.
Parameter 802.11b Displays information about users of 802.11b.
Description 802.11n Displays information about users of 802.11n.
802.11g Displays information about users of 802.11g.
802.11ac Displays information about users of 802.11ac.
other Displays information about unknown users.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the information about all the STAs connected with the current AC.
AC#show ac-config client
========= show sta status =========
AP : ap name/radio id
Status: Speed/Power Save/Work Mode, E = enable power save, D = disable power
save
Configuration
Examples Total Sta Num : 1
STA MAC IP Address AP Wlan Vlan
Status Asso Auth Link Auth Up time
-------------- --------------- ----------------------------------------
---- ---- ----------- --------- --------- -------------
78e4.00d3.1183 192.168.248.2 te/1 1 1
65.0M/D/bn Open Open 0:00:08:10

Related Command Description

Commands N/A N/A

2-21
Command Reference WLAN STAMP Commands

Platform This command is supported only on ACs.

Description

2.28 show ac-config client detail

Use this command to display the details of a specified wireless user.

show ac-config client detail mac-addr

Parameter Parameter Description

Description mac-addr Indicates the MAC address of a wireless user.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the details of a specified wireless user.

AC#show ac-config client detail 0023.cdae.5260
Mac Address :0023.cdae.5260
IP Address :0.0.0.0
Wlan Id :123
Configuration Vlan Id :2
Examples Roam State :Local
Association ID :0

Associated Ap Information:
AP Name :youzt
AP IP :10.1.1.2

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.29 show ap-config client-statistic

Use this command to display online/offline times and total roaming times in different. time.

show ap-config client-statistic

Parameter Parameter Description

2-22
Command Reference WLAN STAMP Commands

Description N/A N/A

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the statistics about the specified wireless user.
AC# #show ac-config client statistic
========= show sta statistic =========
STA online times in 5 second: 13
STA offline times in 5 second: 10
STA roaming times in 5 second: 2

STA online times in 1 minute: 30

Configuration
STA offline times in 1 minute: 25
Examples
STA roaming times in 1 minute: 10

STA online times in 1 hour: 200

STA offline times in 1 hour: 300
STA roaming times in 1 hour: 100

Maxinum rate of STA-online in 1 hour: 20/s

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.30 show ac-config flow-balance summary

Use this command to display detailed configuration information of flow-based load balancing group.

show ap-config flow-balance summary

Parameter Parameter Description

Description N/A N/A

Defaults N/A

Command Privileged EXEC mode

2-23
Command Reference WLAN STAMP Commands

Mode

Usage Guide N/A

The following example displays detailed configuration information of flow-based load balancing
group.
Ruijie(config)#show ac-config flow-balance summary
Group Threshold AP NAME
Configuration
--------------- --------------
Examples
-------------------------------------------------------------------------
-------
test-group1 5*100kbps ap1, ap2, ap3
test-group2 6*200kbps ap4, ap5, ap6

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.31 show ac-config num-balance summary

Use this command to display the detailed configuration information of the number-based load
balancing group.

show ap-config num-balance summary

Parameter Parameter Description

Description N/A N/A

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the detailed configuration information of the number-based load
balancing group.
Ruijie(config)#show ac-config num-balance summary
Configuration
Group Threshold AP NAME
Examples
---------------- --------- -------------------------
test-group1 1 ap1, ap2, ap3
test-group2 2 ap4, ap5, ap6

2-24
Command Reference WLAN STAMP Commands

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.32 show assoc-control

Use this command to display the state of the association control.
show assoc-control
Parameter
Parameter Description
Description
N/A N/A

Defaults N/A
Command
Privileged EXEC mode
mode
Usage Guide N/A
Configuration The following example displays the state of the association control.
Examples Ruijie# show assoc-control
Association control is enabled.
The following example displays the state of the association control.
Ruijie# show assoc-control
Association control is disabled.
Related
Command Description
Commands
N/A N/A
Platform This command is supported only on ACs.
Description

2.33 show control-zone

Use this command to display the association control-zone configuration.
show control-zone [ summary | czone-name ]
Parameter
Parameter Description
Description
summary Displays summary information.
The name of the association control-zone to be displayed. The name
czone-name
length range is from 1 to 64.
Defaults N/A
Command Privileged EXEC mode
mode
Usage Guide Use the show control-zone summary command to display the configured association control zone.
Use the show control-zone or the show control-zone czone-name command to display not only

2-25
Command Reference WLAN STAMP Commands

the association control zone information but also the AP information in the control zone.
Configuration The following example displays all association control zones.
Examples Ruijie# show control-zone summary
control zone num : 4
Class 1 Grade 1
Class 2 Grade 1
Class 3 Grade 1
Class 1 Grade 2
The following example displays all association control zones.
Ruijie# show control-zone summary
No control zone configuration.
The following example displays the detailed configuration information of all the association control
zones.
Ruijie# show control-zone
control zone num : 3
control-znoe AP
------------- ------------------------
Class 1 Grade 1 AP1(1)-1 00d0.f800.889f
AP1(1)-2 00d0.f800.7869
Class 2 Grade 2 AP2(2)-1 00d0.f800.889f
Class 3 Grade 3 AP2(3)-1 offline
Class 3 Grade 2 n/a
The following example displays the detailed configuration information of all association control zone.
Ruijie# show control-zone
No control zone configuration.
The following example displays the detailed configuration information of the association control zone
named “Class 1 Grade 1”.
Ruijie# show control-zone Class 1 Grade 1
control-zone AP
------------- ------------------------
Class 1 Grade 1 AP1(1)-1 00d0.f800.889f
AP1(1)-2 00d0.f800.7869
Class 2 Grade 2 AP2(2)-1 00d0.f800.889f
Class 3 Grade 3 AP2(3)-1 offline
Class 3 Grade 2 n/a
The following example displays the detailed configuration information of the association control zone
named “Class 1 Grade 5”.
Ruijie# show control-zone Class 1 Grade 5
No such control zone configuration.
Related
Command Description
Commands
Configures an association control zone and
control-zone enter association control zone configuration
mode.

2-26
Command Reference WLAN STAMP Commands

Configures AP information in the association

ap
control zone.
Platform This command is supported only on ACs.
Description

2.34 show package

Use this command to display the terminal package configuration.
show package [ pkg-name ]
Parameter
Parameter Description
Description
The name of the terminal package to be displayed. The name length
pkg-name
range is from 1 to 32.
Defaults N/A
Command Privileged EXEC mode
mode
Usage Guide N/A
Configuration The following example displays the configuration of all terminal packages.
Examples Ruijie# show package
total package num : 2
========= package_1 =========
primary STA : none
secondary STA num : 0
========= package_2 =========
primary STA : 00d0.f809.0092
secondary STA num : 4
00d0.f809.0096
00d0.f809.0097
00d0.f809.0098
00d0.f809.0099
The following example displays the configuration of all terminal packages.
Ruijie# show package
No package configuration
Related
Command Description
Commands
package Enters terminal package configuration mode
primary-sta Configures a primary STA.
secondary-sta Configures a secondary STA.
Platform This command is supported only on ACs.
Description

2.35 show sta-blacklist

Use this command to display the STA blacklist.

2-27
Command Reference WLAN STAMP Commands

show sta-blacklist
Parameter
Parameter Description
Description
N/A N/A
Defaults N/A
Command Privileged EXEC mode
mode
Usage Guide N/A
Configuration
The following example displays the STA blacklist.
Examples
Ruijie#show sta-blacklist
Num STA MAC Add time
---------- -------------- --------------------
1 0080.1111.1111 2013-07-02 13:56:22
2 0090.2222.3333 2013-07-02 13:56:35
3 0070.1111.2233 2013-07-02 13:57:08
Related
Command Description
Commands
N/A N/A
Platform This command is supported only on ACs.
Description

2.36 sta-balance num-limit enable

Use this command to enable the STA to terminate load balancing automatically after association
failures. Use the no form of this command to restore the default setting.
sta-balance num-limit enable
no sta-balance num-limit enable
Parameter
Parameter Description
Description
N/A N/A
Defaults This function is disabled by default.
Command AC configuration mode
mode
Usage Guide By default, the STA keeps attempting to associate e with the AP selected by load balancing. After the
sta-balance function is enabled, the maximum number of its attempts is five times. If the association
fails for five times, the STA will terminate load balancing next time.
Configuration
The following example enables the sta-balance function.
Examples
Ruijie(config)# ac-controller
Ruijie(config-ap)# sta-balance num-limit enable
Related
Command Description
Commands
N/A N/A

2-28
Command Reference WLAN STAMP Commands

Platform This command is supported only on ACs.

Description

2.37 sta-blacklist
Use this command to enable the STA blacklist function, set aging time for the blacklisted STAs and
identify the STA as the attack source. Use the no form of this command to restore the default setting.
sta-blacklist { enable | lifetime | detect-time | fail-limit } [ seconds | number ]
no sta-blacklist { enable | lifetime | detect-time | fail-limit } [ seconds | number ]
Parameter
Parameter Description
Description
enable Enables the STA blacklist function.
lifetime Sets aging time for the blacklisted STAs.
Detection time. Once the STA fails to associate with the AP, it is
identified as the attack source. If the STA association failure count
detect-time
reaches fail-limit within detect-time, the STA is added to the
blacklist.
fail-limit Limits the STA access failure count within detec-time.
In the unit of seconds.
seconds lifetime: in the range from 60 to 1200.
detect-time: in the range from 5 to 60.
number Sets the STA access failure count, in the range from 1 to 100.
Defaults The STA blacklist function is disabled by default.
The default lifetime is 300 seconds.
The default detect-time is 60 seconds.
The default number is 5 seconds.
Command AC configuration mode
mode
Usage Guide N/A
Configuration
The following example enables the STA blacklist function.
Examples
Ruijie(config)# ac-controller
Ruijie(config-ac)# sta-blacklist enable
The following example disables the STA blacklist function.
Ruijie(config)# ac-controller
Ruijie(config-ac)# no sta-blacklist enable
The following example sets the blacklisted STA aging time to 60 seconds.
Ruijie(config)# ac-controller
Ruijie(config-ac)# sta-blacklist lifetime 60
The following example sets detect-time to 10 seconds.
Ruijie(config)# ac-controller
Ruijie(config-ac)# sta-blacklist detect-time 10
The following example limits association failure count.

2-29
Command Reference WLAN STAMP Commands

Ruijie(config)# ac-controller
Ruijie(config-ac)# sta-blacklist fail-limit 20
Related
Command Description
Commands
N/A N/A
Platform This command is supported only on ACs.
Description

2.38 sta-idle-timeout

Use this command to configure aging time for a wireless user in a specified AP or AP group. Use the
no form of this command to restore the default setting.

sta-idle-timeout timer-num

no sta-idle-timeout

Parameter Description
Parameter
timer-num Indicates that you set the aging time, in the range from 60
Description
to 86400 in the unit of seconds.

Defaults The default is 300 seconds.

Command AP configuration mode/AP group configuration mode

Mode

If no information is received from a wireless user within the setting time, the wireless user will be
Usage Guide
regarded to have left the WLAN, and will be deleted from the network by the system.

The following example enters the configuration mode of AP0001 to configure its client timeout timer
to 600 seconds.
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# sta-idle-timeout 600
The following example enters the configuration mode of AP0001 to restore its client timeout timer to
the default setting.
Ruijie(config)# ap-config AP0001
Configuration Ruijie (config-ap)# no sta-idle-timeout-timer
Examples The following example enters the default AP group to configure its client timeout timer to 600
seconds.
Ruijie(config)# ap-group default
Ruijie (config-ap-group)# sta-idle-timeout 600
The following example enters the default AP group to restore its client timeout timer to the default
setting.
Ruijie(config)# ap-group default
Ruijie(config-ap-group)# no sta-idle-timeout-timer

2-30
Command Reference WLAN STAMP Commands

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.39 sta-limit

Use this command to configure the maximum number of wireless users that can be connected. In the
AC configuration mode, this command can provide global configuration. In the AP group and AP
configuration mode , this command can be used to configure the maximum number of wireless users
that can be connected to a specified AP. In the WLAN configuration mode,this command can be used
to configure the maximum number of wireless users that can be connected to a specified WLAN.Use
the no form of this command to restore the default setting.

sta-limit client-num

no sta-limit client-num

Parameter Description
client-num Indicates the maximum number of wireless users that can
be connected.
In the AC configuration mode:
The value is equal to 32 multipled by the number of APs
suppprted by the AC (depending on lincense limit)
Parameter
In the AP group configuration mode, the value is 512.
Description
In the AP configuration mode, for offline APs or ap-config
all mode, the value is 512. For online APs, the value
depends on the product model.
In the WLAN configuration mode, the value is equal to 32
multipled by the number of APs suppprted by the AC
(depending on lincense limit).

In the AC configuration mode:

The default is equal to 32 multipled by the number of APs suppprted by the AC .
In theAP group configuration mode, the default is 32.
Defaults
In the AP configuration modem, the default for the offline APs or ap-config all mode is 32 and the
default for the online APs is determined by the AP model.
In the WLAN configuration mode, the default is no limit.

AC configuration mode
Command AP group configuration mode
Mode AP configuration mode
WLAN configuration mode

2-31
Command Reference WLAN STAMP Commands

This command is used to configure how many clients the device can serve at most. This value
should not exceed the maximum number supported by an AC or the maximum number limited by the
license. The maximum number of wireless users that can be supported varies with AC products.
Usage Guide For the ap-config all, ap-group and off-line AP configuration, the range is from 1 to 512. If the value
configured by the user exceed the STA number supported by an AP, it will automatically adjust the
value to the maximum STA number supported by the AP when the AP is online.
For online APs, the maximum value is number of STAs supported by the AP.

The following example configures an AC to provide service for 2400 clients at most.
Ruijie(config-ac)# sta-limit 2400
Configuration The following example configures all APs in the AP group (Default) to admit 20 wireless users at
Examples most.
Ruijie(config)# ap-group default
Ruijie(config-ap-group)# sta-limit 20

Related Command Description

Commands N/A N/A

Platform This command is supported only on ACs.

Description

2.40 sta-limit per-ap

Use this command to configure the maximum number of STAs associated with each AP. Use the no
form of this command to restore the default setting.
sta-limit per-ap client-num
no sta-limit per-ap

Parameter
Parameter Description
Description
Sets the maximum number of STAs associated with each AP in the
client-num
range from 1 to 1536.

Defaults The default is no limit.

Command WLAN configuration mode

mode
Usage Guide If the configured value exceeds the AP capacity, the AP capacity prevails.

Configuration
The following example sets the maximum number of STAs associated with each AP in WLAN 1 to 10.
Examples
Ruijie(config)# wlan-config 1
Ruijie(config-wlan)# sta-limit per-ap 10

2-32
Command Reference WLAN STAMP Commands

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

2.41 sta-limit radio

Use this command to configure the maximum number of wireless users that can be connected. In the
AP group and AP configuration mode, you can specify the maximum number of wireless users
connected on a specific radio of an AP. Use the no form of this command to restore the default setting.

sta-limit client-num radio radio_id

no sta-limit client-num radio radio_id

Parameter Description
client-num Indicates the maximum number of wireless users that can
Parameter
be connected, in the range from 1 to 156 (or the
Description
maximum number of users supported by the AP).
radio-id Indicates the radio identifier.

Defaults By default, there is no limit.

Command AP configuration mode/ AP group configuration mode

Mode

The limit number of user in this command has no dependence on that of the sta-limit command. In
other words, the limit number of user in this command can be greater than that of the sta-limit
command.
Usage Guide For the ap-config all, ap-group and off-line AP configuration, the range is from 1 to 156. If the value
configured by the user exceed the STA number supported by an AP, it will automatically adjust the
value to the maximum STA number supported by the AP when the AP is online.
For online APs, the maximum value is number of STAs supported by the AP.

The following example configures the maximum number of wireless users that can be added into
Configuration radio 1 of an AP to 20.
Examples Ruijie(config)# ap-config ap1
Ruijie(config-ap)# sta-limit 20 radio 1

Related Command Description

Commands N/A N/A

2-33
Command Reference WLAN STAMP Commands

Platform This command is supported only on ACs.

Description

2.42 sta-logging rate-limit

Use this command to set the maximum number of syslogs printed per second, including STA
online/offline information and STA change messages. Use the no form of this command to restore the
default setting.
sta-logging rate-limit limit-num
no sta-logging rate-limit
Parameter
Parameter Description
Description
Sets the maximum number of syslogs printed per second, in the
limit-num
range from 0 to 10000.
Defaults The default is 5.
Command AC configuration mode
mode
Usage Guide N/A
Configuration
The following example sets the maximum number of syslogs printed per second to 100.
Examples
Ruijie(config)# ac-controller
Ruijie(config-ac)# sta-logging rate-limit 100
Related
Command Description
Commands
N/A N/A
Platform This command is supported only on ACs.
Description

2-34
Command Reference WLAN CAPWAP Commands

3 WLAN CAPWAP Commands

3.1 ac-domain-name

Use this command to enable the AP to discover the AC domain name. Use the no form of this
command to restore the default setting.

ac-domain-name ac-domain-name

no ac-domain-name

Parameter Description
Parameter ac-domain-name Configures the AC domain name that the AP is to be
Description discovered. The maximum length of the AC domain name
is 64 characters, containing no spaces.

Defaults By default, the AC domain name is ac.ruijie.com.cn.

Command AP configuration mode/AP group configuration mode

Mode

AP is able to discover the AC through DNS. You can use this command to revise the AC domain
Usage Guide
name to be discovered by the AP, so as to allow the AP to discover different APs.

The following example enables the AP to discover the AC with the domain name as ruijie-ac.com.
Configuration
Ruijie(config)# ap-config AP001
Examples
Ruijie(config-ap)# ac-domain-name ruijie-ac.com

Related Command Description

Commands N/A N/A

Platform N/A
Description

3.2 acip ipv4

Use this command to configure the AP to join a specified AC. Use the no form of this command to
remove the configuration.

acip ipv4 ip-address [ ip-address ]

no acip ipv4

3-1
Command Reference WLAN CAPWAP Commands

Parameter Description
Parameter
ip-address Indicates the static IP address. Up to six static addresses
Description
can be configured.

Defaults N/A

Command AP global configuration mode/AP configuration mode on the AC

Mode

In general, the fit AP has no configuration. You can find AC through broadcast, multicast, DHCP and
DNS or joining AC through the AC address configured by the static address. AP sends a discovery
request packet to these IP addresses to detect whether AC is valid, and then add an AC.
Usage Guide
If this command is configured for the fit AP and the AC connected with it, then the final
configuration is the AC configuration.

The following example configures the static IP address list for the fit AP to join AC as 192.168.1.1
and 192.168.2.1.
Ruijie(config)# acip ipv4 192.168.1.1 192.168.2.1
Configuration
The following example configures the static IP address list for AP0001 to join AC as 192.168.1.1 and
Examples
192.168.2.1.
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# acip ipv4 192.168.1.1 192.168.2.1

Related Command Description

Commands N/A N/A

Platform N/A
Description

3.3 active-bin-file

Use this command to activate an AP software version on an AC, and only the activated AP software
version can be used to upgrade. Use the no form of this command to remove the configuration.

active-bin-file filename [ rgos10 ]

no active-bin-file filename [ rgos10 ]

Parameter Description
Parameter
filename Specifies software version name, including the suffix.
Description
This command can activate up to five software versions.

3-2
Command Reference WLAN CAPWAP Commands

Activates the transition version between RGOS 10 to

rgos10
RGOS 11. The software only applies to the AP.

Defaults N/A

Command AC configuration mode

Mode

To configure an AC as the upgraded version of the specified AP product series, finish these three
steps first: creating AP product series, configuring the software version corresponding to the
Usage Guide
specified AP, and activating the software version. Moreover, before the configuration, ensure this
software version is available in the AC system files.

The following example activates an AP software version file ap.bin on the AC.
Ruijie(config-ac)# active-bin-file ap.bin
Configuration
Ruijie(config-ac)#
Examples
The following example removes the activated AP software version file ap.bin from the AC.
Ruijie(config-ac)# no active-bin-file ap.bin

Command Description
Creates an AP product series name and specify which
Related ap-serial hardware version AP product models belong to this
Commands series.
Upgrades a specified AP software version with a
ap-image
specified activated file.

Platform
N/A
Description

3.4 ap-image

Use this command to configure AC upgrade to use a specified file to upgrade a specified series of
APs. This command applies to all APs connected to the current AC. Use the no form of this
command to remove the configuration.

ap-image { auto-upgrade | filename serial-name }

no ap-image { auto-upgrade | filename serial-name }

Parameter Description
Parameter auto-upgrade Automatically matches the proper AP for upgrade.
Description filename Indicates a software version name, including the suffix.
serial-name Indicates the AP model series to be upgraded.

3-3
Command Reference WLAN CAPWAP Commands

Defaults N/A

Command AC configuration mode

Mode

This command is intended to use a specified file to upgrade a specified series of APs. This
command applies to all APs connected to the current AC. To configure an AC as the upgraded
Usage Guide version of the specified AP product series, finish these three steps first: creating AP product series,
configuring the software version corresponding to the specified AP, and activating the software
version. Moreover, before configuration, ensure this software version exists in the AC system files.

The following exmaple configures the product series name as test-serial, and upgrades it with the
ap.bin file.
Configuration Ruijie(config-ac)# ap-serial test-serial AP210-E, AP210, AP220-E, AP220
Examples hw-ver 1.0
Ruijie(config-ac)#
Ruijie(config-ac)# ap-image ap.bin test-serial

Related Command Description

Commands N/A N/A

Platform N/A
Description

3.5 ap-image

Use this command to upgrade a specified AP with a specified file. This command does not support
the ap-config all mode. Use the no form of this command to remove the settings.

ap-image filename

no ap-image

Parameter Description
Parameter
filename Specifies an AP software version filename for upgrade,
Description
including the suffix.

Defaults N/A

Command AP configuration mode

Mode

3-4
Command Reference WLAN CAPWAP Commands

Usage Guide N/A

The following exmaple upgrades AP0001 with the file ap.bin.

Ruijie(config-ac)# ap-serial test-serial 1.0 AP220-E hw-ver 1.0
Configuration Ruijie(config-ac)# active-bin-file ap.bin
Examples Ruijie(config-ac)# exit
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# ap-image ap.bin

Related Command Description

Commands N/A N/A

Platform N/A
Description

3.6 apip ipv4

Use this command to configure a static IP address for a specified AP. Use the no form of the
command to remove the configuration.

apip ipv4 ip-address network-mask gateway

no apip ipv4

Parameter Description
Parameter ip-address The static IP address.
Description network-mask The subnet mask.
gateway The gateway address.

Defaults N/A

Command AP global configuration mode

Mode

In general, the fit AP has no configuration. Its IP address and gateway can be dynamically obtained
by DHCP. When the CAPWAP tunnel between AP and AC is established, AC delivers the static IP
address for AP, so that the address of AP maintains unchanged after AP is rebooted. In special
application scenario, you can configure this command in AP global configuration mode to manually

Usage Guide set the static IP address for the fit AP.

1. With the AP address configured as static, the DHCP is disabled, and the AC address cannot
be obtained through the OPTION of DHCP. Therefore, after this command is configured, you
need to configure the AC address using the command “acip” on the AP so that the AP can find
and join the AC when the AP and the AC are not in the same subnet.

3-5
Command Reference WLAN CAPWAP Commands

2. The configuration of this command will be automatically saved after the AP configuration. No
command of saving is required to be executed.
3. This command serves the same purpose as the command “ip address” on the AC in the AP
configuration mode. However, when the AP joins the AC, if the command “ip address” exists in
the AP configuration mode of the AC and conflicts with the command “apip”, the static address
of the AP will be updated and the CAPWAP tunnel will be re-created.

The following example configures the static IP address of the fit AP as 192.168.1.2, the subnet mask
Configuration
as 255.255.255.0, and the gateway as 192.168.1.1..
Examples
Ruijie(config)# apip ipv4 192.168.1.2 255.255.255.0 192.168.1.1

Command Description
Related
acip Specifies the AC address to be connected with by an AP.
Commands
ip address Configures the static address of the AP.

Platform N/A
Description

3.7 apip pppoe

Use this command to enable the AP to obtain the address through PPPoE. Use the no form of this
command to restore the default setting.
apip pppoe
no apip pppoe

Parameter
Parameter Description
Description
N/A N/A

Defaults This function is disabled by default.

Command AP global configuration mode

Mode

Usage Guide After configuring this command, you should perform PPPoE and configure the default route to point to
the dialer interface to enable communication between the AP and the AC.

CAPWAP can select only dialer 1 as the source port. Therefore, PPPoE dial requires dialer 1.

Configuration The following example enables the fit AP to obtain the address through PPPoE.
Examples Ruijie(config)# apip pppoe

Related
Command Description
Commands

3-6
Command Reference WLAN CAPWAP Commands

N/A N/A

Platform N/A
Description

3.8 ap-serial

Use this command to configure an AP series on an AC. Only when the AP hardware version and
product model are configured to a series can its software version be upgraded through the AC. Use
the no form of this command to remove the configuration.

ap-serial serial-name hardware-version ap-pid1, ap-pid2, ..., ap-pidn [ hw-ver hardware-version ]

no ap-serial serial-name

Parameter Description
serial-name Indicates an AP series name to be created. The
maximum character configuration number is 64, blank
space is not included. The maximum number of the AP
series that can be supported at the same time: WS5708
Parameter series: 16, WS5302 series:8
Description ap-pid1 ap-pid2 ... ap-pidn Product models
hardware-version Indicates the AP hardware version, the maximum
configuration character is 64, blank space is not included.
The hardware version name is a decimal, the mark is ‘x’
or ‘X” which can be used to configure the following
character.

Defaults N/A

Command AC configuration mode

Mode

To configure an AC as the upgraded version of the specified AP product series, finish these three
steps first: creating AP product series, configuring the software version corresponding to the
Usage Guide
specified AP, and activating the software version. Moreover, before configuration, ensure this
software version exists in the AC system files.

The following example creates an AP series named test-serial of which the designate AP hardware
version is 1.0 on an AC, including these AP models: AP220-SE AP220-SH, AP220-E.
Configuration
Ruijie(config-ac)# ap-serial test-serial 1.0 AP220-SE AP220-SH, AP220-E
Examples
hw-ver 1.0
Ruijie(config-ac)# active-bin-file ap.bin

3-7
Command Reference WLAN CAPWAP Commands

Ruijie(config-ac)# ap-image test-serial ap.bin

The following exmaple removes the configuration from the AC to make the APs in the product series
named test-serial no longer use the ap.bin file for upgrade.
Ruijie(config-ac)# no ap-image test-serial ap.bin

Command Description
Related
Activates an AP software version file to upgrade an AP
Commands active-bin-file
software version.

Platform N/A
Description

3.9 ap-subif
Use this command to enable the AP to create the sub interface of the WAN port. Use the no form of
this command to remove the configuration.
ap-subif enable
no ap-subif enable

Parameter
Parameter Description
Description
N/A N/A

Defaults N/A

Command AP configuration mode

Mode

Usage Guide If the AP obtains its address through PPPoE, the sub interface of the WAN port is removed
automatically. This command cannot enable the AP to create the sub interface of the WAN port in
PPPoE mode.

Configuration The following example enables AP1 to remove the sub interface from the WAN port.
Examples Ruijie(config)# ap-config AP1
Ruijie(config-ap)# no ap-subif enable

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3-8
Command Reference WLAN CAPWAP Commands

3.10 ap-vlan
Use this command to set the Native VLAN for the AP. Use the no form of this command to restore the
default setting.
ap-vlan vlan-id
no ap-vlan

Parameter
Parameter Description
Description
vlan-id Specifies the VLAN on the wired network port, in the range from 1 to
4094.

Defaults The default is 1.

Command AP configuration mode

Mode

Usage Guide The AP untags the frame of the Native VLAN before forwarding it. In local forwarding mode, if the
user VLAN is the same as the Native VLAN, the frame is forwarded untagged and the access switch
determines the VLAN where the user resides.

This command forces the online AP to go offline and enables reconnection.

In WDS deployment, when ROOT-BRIDGE and NONROOT-BRIDGE devices are configured

with local forwarding, they should reside in the same AP-VLAN. Otherwise, the
NONROOT-BRIDGE device cannot share the address pool with the ROOT-BRIDGE device;
packet forwarding on the NONROOT-BRIDGE device may even be affected.

This command is configured only when the STA of a WLAN wants to access the VLAN where
the switch resides while another WLAN requires that its STA resides in VLAN 1, which is not the
Native VLAN.

If the static DHCP address pool is configured, and BVI 1 port number is used as client ID, this
configuration will bring changes to the BVI port. In this case, the DHCP server configuration
should be modified. Otherwise, the address cannot be obtained.

When the AP obtains the address through PPPoE and CAPWAP selects dialer 1 as the source
port, the STA traffic is forwarded untagged even if this command is configured.

Configuration The following example sets the Native VLAN for AP 1 to 20.
Examples Ruijie(config)# ap-config AP1
Ruijie(config-ap)# ap-vlan 20

Related
Command Description
Commands
N/A N/A

3-9
Command Reference WLAN CAPWAP Commands

Platform N/A
Description

3.11 ap-upgrade bandwidth

Use this command to configure the upgrade bandwidth for AP devices. Use the no form of this
command to restore the default setting.
ap-upgrade band-width num
no ap-upgrade band-width

Parameter
Parameter Description
Description
num Bandwidth for AP upgrade, namely, the push rate for the AP upgrade
file. The range is from 1 to 1,024. The unit is 1 KB. The default value
is 0.

Defaults Upgrade bandwidth is not limited by default.

Command AP configuration mode

Mode

Usage Guide During upgrading AP devices, the AC device occupies more transmission bandwidth to reduce
upgrade time. However, in some small networks, the bandwidth for wired services should be
guaranteed during AP upgrade to avoid impacting wired services. You can configure the upgrade
bandwidth for AP devices to control the percentage of upgrade bandwidth.
The bandwidth limit configured
1. This command configuration controls the bandwidth for centralized upgrade of AP devices from
the AC device, the distributed upgrade of AP devices is not impacted. As distributed upgrade
data source is from central upgrade, the distributed upgrade is indirectly influenced.
2. The bandwidth unit is 1KB. For example, the minimum link bandwidth between AC and AP
devices is 1 Mbps, the bandwidth value is 128.

Configuration The following example sets the upgrade bandwidth for an AP device to 1 Mbps.
Examples Ruijie(config-ac)# ap-upgrade band-width 128

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3-10
Command Reference WLAN CAPWAP Commands

3.12 ap-upgrade group

Use this command to add an AP device to the upgrade group. Use the no form of this command to
remove the AP device from the upgrade group.
ap-upgrade group group-name
no ap-upgrade group

Parameter
Parameter Description
Description
group-name Upgrade group name.

Defaults N/A

Command AP configuration mode

Mode

Usage Guide The following configuration restrictions are applied on the AP devices which are added to a upgrade
group:
1. The AP devices in the same group need to be configured with the ap-grade band-width
command, so that the upgrade bandwidth of the AP devices is identical.
2. The capwap upgrade group command should be configured before this command.

Configuration The following example adds an AP device to the upgrade group UPGRADE-GROUP1.
Examples Ruijie(config-ac)# ap-upgrade group UPGRADE-GROUP1

Related
Command Description
Commands
N/A N/A

Platform N/A.
Description

3.13 capwap ctrl-ip

Use this command to set the IPv4 address for the CAPWAP tunnel between the AC and the AP. Use
the no form of this command to restore the default setting.
capwap ctrl-ip ip-address
no capwap ctrl-ip

Parameter
Parameter Description
Description
ip-address Specifies the IP address for the CAPWAP tunnel between the AC and
the AP. It should be an interface IP address of the AC.

3-11
Command Reference WLAN CAPWAP Commands

Defaults

Command AC configuration mode

Mode

Usage Guide The AC generally uses a Loopback address to create the CAPWAP tunnel. This command enables
the AC to create the CAPWAP tunnel with interface addresses in other three layers.

This command may force the AP offline.

Configuring an IP address not existing on the AC causes failure to create the CAPWAP tunnel.

If the gateway of the AP is not on the AC, the AP address pool option should be set to the IP
address in this command (if it is configured).

In the AC hot backup environment, if this command is used to set the CAPWAP tunnel address,
use the peer-ip A.B.C.D command to set the same IP address on the peer-to-peer backup AC.,

Configuration The following example sets the IP address for the CAPWAP tunnel between the AC and the AP to
Examples 10.0.0.1..
Ruijie(config-ac)# capwap ctrl-ip 10.0.0.1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3.14 capwap dtls enable

Use this command to enable DTLS encryption for the CAPWAP tunnel. Use the no form of this
command to disable this function.
capwap dtls enable
no capwap dtls enable

Parameter
Parameter Description
Description
N/A N/A

Defaults This function is enabled by default.

Command AC configuration mode

Mode

3-12
Command Reference WLAN CAPWAP Commands

Usage Guide This function is enabled by default to ensure security of communication between the AC and the AP.
This function is disabled in some cases, for example, for test purpose.

Configuration The following example enables DTLS encryption for the CAPWAP tunnel.
Examples Ruijie(config)# ac-controller
Ruijie(config-ac)# capwap dtls enable

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3.15 capwap fragment enable

Use this command to enable CAPWAP fragmentation. Use the no form of this command to restore
the default setting.
capwap fragment enable
no capwap fragment enable

Parameter
Parameter Description
Description
N/A N/A

Defaults This function is disabled by default.

Command AP configuration mode/AP group configuration mode

Mode

Usage Guide After the packets are encapsulated through the CAPWAP tunnel, its length may exceed IP MTU,
causing IP fragmentation. If IP MTUs of multiple nodes on a link are inconsistent, the packet may go
through fragmentation and defragmentation for many times, affecting packet forwarding. This
command is used to enable CAPWAP fragmentation, that is, the packet is fragmented during
CAPWAP encapsulation. The length of fragmented packets can be set to the minimum MTU using
the capwap mtu command to avoid another IP fragmentation.

Configuration The following example enables CAPWAP fragmentation on AP1.

Examples Ruijie(config)# ap-config AP1
Ruijie(config-ap)# capwap fragment enable

Related Command Description

3-13
Command Reference WLAN CAPWAP Commands

Commands
N/A N/A

Platform N/A
Description

3.16 capwap max-concurrent

Use this command to set the maximum number of concurrent online APs. Use the no form of this
command to restore the default setting.
capwap max-concurrent num
no capwap max-concurrent

Parameter
Parameter Description
Description
num The maximum number of concurrent online APs, in the range from 1
to 200.

Defaults The default is 50.

Command AC configuration mode

Mode

Usage Guide If too many APs go online concurrently, AC CPU may increase even to 100%. This will cause the
tunnel disconnection. Therefore, it is necessary to limit the number of concurrent online APs.

If you set a small value, the total online time of all APs associated to the AC will be long.

Configuration The following example sets the maximum number of concurrent online APs to 100.
Examples Ruijie(config-ac)#capwap max-concurrent 100

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3.17 capwap max-retransmit

Use this command to set the maximum count of CAPWAP packet retransmission. Use the no form of
this command to restore the default setting.

3-14
Command Reference WLAN CAPWAP Commands

capwap max-retransmit num

no capwap max-retransmit

Parameter
Parameter Description
Description
num Sets the maximum count of CAPWAP packet retransmission, in the
range from 3 to 60.

Defaults The default is 5.

Command AP configuration mode/AP group configuration mode

Mode

Usage Guide If the CAPWAP request packet is not responded, the packet is retransmitted, The retransmission
interval increases by the initial retransmission interval (the smaller value between three seconds and
half echo-interval) and the maximum retransmission interval should be no greater than the smaller
value between half echo-interval and 60 seconds. If the device does not receive the response packet
within the maximum count, the tunnel is considered disconnected. This command is only effective
when the tunnel is in the Run state.

Configuration The following example sets the maximum retransmission count to 20.
Examples Ruijie(config)# ap-config AP1
Ruijie(config-ap)#capwap max-retransmit 20

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3.18 capwap upgrade group

Use this command to configure an AP upgrade group. Use the no form of this command to remove an
AP upgrade group.
capwap upgrade group group-name [ max-concurrent num ]
no capwap upgrade group [ group-name max-concurrent ]

Parameter
Parameter Description
Description
num The number of AP devices which can be upgraded concurrently in
centralized mode. The range is from 1 to 200. The default is 5.

3-15
Command Reference WLAN CAPWAP Commands

group-name Upgrade group name

Defaults

Command AC configuration mode

Mode

Usage Guide The AP number should be equal to the available bandwidth divided by max bandwidth of each AP.

Configuration The following example creates an AP upgrade group Upgrade-Group1 and sets the concurrent
Examples number to 10.
Ruijie(config-ac)# capwap upgrade group Upgrade-Group1 max-current 10

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3.19 capwap mtu

Use this command to set the Path MTU (PMTU) for the CAPWAP tunnel. Use the no form of this
command to restore the default setting.
capwap mtu num
no capwap mtu

Parameter
Parameter Description
Description
num Sets the PMTU for the CAPWAP tunnel, in the range from 68 to 1500
in the unit of bytes.

Defaults The default is 1500.

Command AP configuration mode/AP group configuration mode

Mode

Usage Guide If the CAPWAP-encapsulated packet is longer than the PMTU, the packet is fragmented. Set the
PMTU equal to the maximum IP MTU so as to avoid IP fragmentation and defragmentation.

A small PMTU will produce a large quantity of packet fragments, affecting packet forwarding or
even leading to transmission failure. It is recommended to set a reasonable PMTU.

Configuration The following example sets the PMTU for the CAPWAP tunnel to 1200 bytes.

3-16
Command Reference WLAN CAPWAP Commands

Examples Ruijie(config)# ap-config AP1

Ruijie(config-ap)# capwap mtu 1200

Related
Command Description
Commands
N/A N/A

Platform N/A.
Description

3.20 capwap upgrade max-concurrent

Use this command to set the maximum number of concurrently upgrading APs. Use the no form of
this command to restore the default setting.
capwap upgrade max-concurrent num
no capwap upgrade max-concurrent

Parameter
Parameter Description
Description
num The maximum number of concurrently upgrading APs, in the range
from 1 to 200.

Defaults The default is 15.

Command AC configuration mode

Mode

Usage Guide If too many APs upgrade concurrently, AC CPU may increase even to 100%. This will cause tunnel
disconnection. Therefore, it is necessary to limit the number of concurrently upgrading APs.

Configuration The following example sets the maximum number of concurrently upgrading APs to 10.
Examples Ruijie(config-ac)#capwap upgrade max-concurrent 10

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3-17
Command Reference WLAN CAPWAP Commands

3.21 echo-interval

Use this command to configure the keep-alive interval for CAPWAP. Use the no form of this
command to restore the default setting.

echo-interval seconds

no echo-interval

Parameter Description
Parameter seconds This parameter indicates the keep-alive interval for
Description CAPWAP, in the range from 5 to 255 in the unit of
seconds.

Defaults The default is 30 seconds.

Command AP configuration mode or AP group configuration mode

Mode

In the fit AP network frame, AC and AP are connected through the CAPWAP tunnel. Echo Request
and Echo Response are used to keep the validity of the link. In the case of no other request packets,
AP sends the Echo Request packet to keep alive every echo interval. If AP does not receive a
response, the packet will be retransmitted at the multiple original retransmission interval (3 seconds
or half the echo interval, taking the smaller value) and the longest retransmission interval cannot
exceed half the echo interval or 60 seconds (taking the smaller value). It is considered that the tunnel
is interrupted if the AP does not receive the response packet within the maximum retransmit times,
which means the failure time of keep alive of the tunnel is the keep-alive time plus retransmission
intervals. This command only takes effect in the Run status of the tunnel. By default, the
Usage Guide
echo-interval is 30 seconds, the maximum retransmit times are 5. Namely, the AP device sends a
request and does not receive a response after 0 second, the request packet will be retransmitted at
the interval of 3 seconds, 6 seconds, 12 seconds, 15 seconds and 15 seconds.

In the deployment of wireless networks, you can adjust the echo interval based on network size
to plan the convergence capability of the network. During the adjustment, make sure that you
know the network size and the network does require the convergence capability to prevent
impacts on the network environment due to too low value in the wireless network deployed by
massive APs.

The following exmaple configures a 10-second echo interval for AP0001.

Ruijie(config)# ap-config AP0001
Configuration
Ruijie(config-ap)# echo-interval 10
Examples
The following example configures a 10-second echo interval for all APs.
Ruijie(config)# ap-config all

3-18
Command Reference WLAN CAPWAP Commands

Ruijie(config-ap)# echo-interval 10
The following example configures a 10-second echo interval for all APs in the default AP group.
Ruijie(config)# ap-group default
Ruijie(config-ap-group)# echo-interval 10

Related Command Description

Commands N/A N/A

Platform N/A
Description

3.22 exec-cmd
Use this command to configure an AP to execute a command. Use the no form of this command to
remove the setting.
exec-cmd mode exec-mode cmd once
no exec-cmd mode exec-mode cmd exec-cmd
Use this command to configure all APs in an AP group to execute a command.
no exec-cmd mode exec-mode cmd exec-cmd

Parameter
Parameter Description
Description
exec-mode Indicates the mode in which a command is executed on the AP.
exec-cmd Indicates the command to be executed on the AP.
once Indicates that the command is executed only once and is not saved.

Defaults N/A

Command Single AP configuration mode/All APs configuration mode/AP group configuration mode
Mode

Usage Guide Some configuration commands are supported currently only by the AP and they are unavailable on
the AC. To configure the commands for APs on the AC, run the exec-cmd command. To cancel or
change the configuration of the exec-cmd command, run the no exec-cmd command to remove the
configuration and then run the exec-cmd command to cancel or change the required configuration. If
ap-config all and ap-config are configured simultaneously, for online APs, the later configuration will
take effect; for offline APs, ap-config has a higher priority than ap-config all.
Some configuration commands are available only in AP configuration mode and they are unavailable
in AP group configuration mode. To configure such a command for all APs in an AP group, run the
exec-cmd command in the AP group.

Configuration The following example disables Eweb for an AP.

Examples Ruijie(config)#ap-config AP1

3-19
Command Reference WLAN CAPWAP Commands

Ruijie(config-ap)# exec-cmd mode configure cmd "no enable service web-server

all"
The following example enables Eweb for an AP,
Ruijie(config-ap)# no exec-cmd mode configure cmd "no enable service web-server
all"
Ruijie(config-ap)# exec-cmd mode configure cmd "enable service web-server all"
The following example configures Bluetooth iBeacon for all APs in the AP group.
Ruijie(config)#ap-group default
Ruijie(config-group)#exec-cmd ibeacon uuid ffffffffffffffffffffffffffffffff
major ffff minor ffff
The following example disables Eweb for all APs in the AP group.
Ruijie(config-group)#exec-cmd exec-cmd mode configure cmd "no enable service
web-server all"

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3.23 ip address

Use this command to configure the static IP address of a specified AP. Use the no form of this
command to restore the default setting.

ip address ip-address network-mask gateway

no ip address

Parameter Description
Parameter ip-address Interface address of the AP.
Description network-mask Address mask of the AP.
gateway Gateway of the AP.

Defaults N/A

Command AP configuration mode

Mode

The AP can obtain its IP address through static configuration or DHCP. If the AP has not a static IP
Usage Guide address, it will obtain an address dynamically by DHCP and join the AC. In this case, you can use
this command to configure the static address of the AP so that the address keeps unchanged after

3-20
Command Reference WLAN CAPWAP Commands

the AP restarts.

1. With the AP address configured as static, the DHCP is disabled, and the AC address cannot
be obtained through the OPTION of DHCP. Therefore, before this command is configured, you
need to configure the address of the AC connected by using the command “acip” in AP
configuration mode so that the AP can find and join the AC when the AP and the AC are not in
the same subnet.
2. If the current address of the AP is not the same as the one specified through this command,
the static address will be updated and the CAPWAP tunnel will be re-created.

The following example configures the address of AP0001 as 1.1.1.1, its mask as 255.255.255.0, and
Configuration its next hop as 1.1.1.2.
Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# ip address 1.1.1.1 255.255.255.0 1.1.1.2

Command Description
Related
apip Configures the static address of an AP on the AP.
Commands
acip Specifies the AC address to be connected with by an AP.

Platform N/A
Description

3.24 link-latency

Use this command to check the link status between an AC and the APs in a specified AP group. Use
the no form of this command to remove the configuration.

[ no ] link-latency

Parameter Parameter Description

Description N/A N/A

Defaults N/A

Command AP configuration mode/AP group configuration mode

Mode

Usage Guide N/A

The following example enables inspection of the link status between specified AP-0001 and an AC,
Configuration and check information about the corresponding link status.
Examples Ruijie(config)#ap-config AP-0001
Ruijie(config-ap)#link-latency

3-21
Command Reference WLAN CAPWAP Commands

The following example enables inspection of the link status between an AC and the APs in the
default AP group, and check the link status information about the specified AP-0001.
Ruijie(config)# ap-group default
Ruijie(config-ap-group)# link-latency

Related Command Description

Commands show ap-config link-latency Checks link status between AC and AP.

Platform N/A
Description

3.25 location

Use this command to configure information about AC and AP location. Use the no form of this
command to restore the default setting.

location location-string

no location

Parameter Description
Parameter
location-string Indicates AC location information, which can consist of up
Description
to 255 characters without any space.

Defaults By default, the AC location information is Ruijie_COM, the AP location information is null.

Command AC configuration mode/AP configuration mode

Mode

Usage Guide N/A

The following example configures the location of a specific AC to the second floor of the computer
department building (computer-layer2).
Configuration Ruijie(config-ac)# location computer-layer2
Examples The following example configures AP0001 location information to AP-company.
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# location AP-company

Related Command Description

Commands N/A N/A

Platform N/A
Description

3-22
Command Reference WLAN CAPWAP Commands

3.26 set version

Use this command to set the version number.
set-version string

Parameter
Parameter Description
Description
string Sets the version number.

Defaults N/A

Command AC configuration mode

Mode

Usage Guide This command is used to set the version number and push version number to APs.

Configuration The following example sets the version number to RGOS 10.4(2B17)-SP2.
Examples Ruijie(config)# ac-controller
Ruijie(config-ac)# set-version RGOS 10.4(2B17)-SP2

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3.27 show ac-config active-file

Use this command to display a list of activated files on the current AC. The Used field indicates how
many APs are using this file, and the Ready field indicates whether this file has been activated
completely.

show ac-config active-file

Parameter Parameter Description

Description N/A N/A

Defaults N/A

Command Privileged EXEC mode

Mode

3-23
Command Reference WLAN CAPWAP Commands

Usage Guide N/A

The following example displays a list of activated files on the current AC.
Ruijie#show ac-config active-file
Cnt File Name Image Id Software number
Type Used Cnt DL Cnt Ready
Configuration ------ ---------------------------------- --------------------
Examples -------------------- ---------- ---------- ---------- --------
1 ap220ev1.1-mid(6-3).bin RGOS 10.X-UPG NA
rgos10 0 0 Init
2 ap220.bin 1.0.0.017ed304 M09092708272014
main 0 0 Init

Related Command Description

Commands N/A N/A

Platform N/A
Description

3.28 show ac-config serial-product

Use this command to display the correspondence association between the AP product series and
product models configured of the AC, and display which files should be used to upgrade the
corresponding product series.

show ac-config serial-product

Parameter Parameter Description

Description N/A N/A

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the AP product series and product models configured for the current
Configuration AC.
Examples
Ruijie#show ac-config serial-product

3-24
Command Reference WLAN CAPWAP Commands

Cnt Serial Name Hardware Version File Name AP Product ID

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

1 ap-ser1.x 1.x ap220-1.bin AP220-E

AP220-SE

AP220-SH

AP620-H

AP220-E(M)

2 ap-ser2.x 2.x ap220.bin AP220-E

AP220-SH

AP220-E(M)

Related Command Description

Commands N/A N/A

Platform N/A
Description

3.29 show ac-config upgrade-group

Use this command to display the upgrade groups and AP devices on the AC device.
show ac-config upgrade-group [group-name]

Parameter
Parameter Description
Description
group-name AP upgrade group name.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

Configuration The following example displays AP upgrade groups.

Examples Ruijie#show ac-config upgrade-group
Cnt Group-Name Max-Concurrent Token cnt Upgrading cnt
------ ---------------------------------- ------------ -----------
------------

3-25
Command Reference WLAN CAPWAP Commands

1 UPGRADE-GROUP1 10 2 1

The following example displays the AP devices in the upgrade group.

Ruijie#show ac-config upgrade-group UPGRADE-GROUP1
Group have 2 ap, online 1 offline 1
Cnt Ap-Name Ap-Mac Online Upgrade
Band-width
------- ------------------------ -------------------- ------- ------------
---------
1 ap220e 8832.0000.1111 true true 128
2 ap330 - false false 128

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3.30 show ap-config board-data

Use this command to display the board data information of an AP.

show ap-config board-data ap-name

Parameter Parameter Description

Description ap-name Indicates the name of the AP to be queried.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the board data information of an AP.

ac#show ap-config board-data wlan-ap-0001
Ap(wlan-ap-0001)'s board data:
Configuration
wtp model num :
Examples
wtp serial num :1234567890123
board id :AP220E
board reversion :AP2

3-26
Command Reference WLAN CAPWAP Commands

base address :0011.2233.4455

Related Command Description

Commands N/A N/A

Platform N/A
Description

3.31 show ap-config inventory

Use this command to display the manufacturer information about an AP.

show ap-config inventory ap-name

Parameter Parameter Description

Description ap-name Indicates the name of the AP to be queried.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the manufacturer information of an AP.

ac#show ap-config inventory wlan-ap-0001
AP Name: wlan-ap-0001
Configuration
Location:
Examples
Product Id: AP220E
Vendor Id: 31762
SN: 1531991320

Related Command Description

Commands N/A N/A

Platform N/A
Description

3.32 show ap-config link-latency

Use this command to check the link status between AC and AP.

3-27
Command Reference WLAN CAPWAP Commands

show ap-config link-latency {all | single ap-name}

Parameter Description
all Indicates that you check the link status information of all
Parameter
APs associated with the AC.
Description
single ap-name Indicates that you check the link status information of a
single AP.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the link status information of the specified AP-0001.
Ruijie(config)#show ap-config link-latency single AP-0001
Configuration
AP Name Status Current Maximum Minimum
Examples
--------- ----------- ---------- --------- ---------
AP-0001 Enabled 4 ms 22 ms 2 ms

Related Command Description

Commands N/A N/A

Platform N/A
Description

3.33 show ap-config reboot

Use this command to display the reboot information about an AP.

show ap-config reboot ap-name

Parameter Parameter Description

Description ap-name Indicates the name of the AP to be queried.

Defaults N/A

Command Privileged EXEC mode

Mode

3-28
Command Reference WLAN CAPWAP Commands

Usage Guide N/A

The following example displays the reboot information of an AP.

ac#show ap-config reboot wlan-ap-0001
Ap(wlan-ap-0001)'s reboot statistic:
Reboot Cnt :0
AC Init Cnt :0
Configuration
Link Fail Cnt :0
Examples
SW Fail Cnt :0
HW Fail Cnt :0
Other Fail Cnt :0
Unknow Fail Cnt :0
Last Fail Type :0

Related Command Description

Commands N/A N/A

Platform N/A
Description

3.34 show ap-config static-ip

Use this command to display static address information on the AP.
show ap-config static-ip { all | single ap-name }

Parameter
Parameter Description
Description
all Displays all APs.
single Displays one single AP.
ap-name The AP name.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage N/A
Guide

Configurati The following example displays static address information, including the AP name. IP address, network
on mask and gateway.
Examples Ruijie#show ap-config static-ip single 0034.5612.78a0
AP Name Static IP Net Mask Getway
---------------------------------------------------------------- ------------

3-29
Command Reference WLAN CAPWAP Commands

---
0034.5612.78a0 Enabled 22.22.22.22 255.255.255.0 22.22.22.53

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3.35 show ap-config summary location

Use this command to display location information on all APs.
show ap-config summary location

Parameter
Parameter Description
Description
N/A N/A

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

Configuration The following example displays location information on all APs, including the AP name, MAC
Examples address, location, and status (online/offline).
Ruijie#show ap-config summary location
AP Name IP Address Mac Address Location
State
---------------------------------------- --------------- --------------
---------------------------------------- -----
ap220 172.18.100.4 1414.4b13.9ff3
Bangongshi_4# Run
ap3 172.18.100.16 001a.a94e.d40d building
20#3F Run

Related
Command Description
Commands
N/A N/A

3-30
Command Reference WLAN CAPWAP Commands

Platform N/A
Description

3.36 show ap-config updating-list

Use this command to display upgrade information on the AP.
show ap-config updating-list

Parameter
Parameter Description
Description
N/A N/A

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

Configuration The following example displays upgrade information on the AP.

Examples Ruijie#show ap-config updating-list
AP NAME AP PID File Tx Time AP Reset
Ready
-------------------------- --------------- -------- -------- ---------------
AP220-I AP220-I 100 00:00:45 Y
00d0.1414.3f67 AP220-E 98 00:00:48 N
Field Description
AP NAME AP name.
AP PID AP ID.
File Tx File transfer process.
Time Upgrade duration.
AP Reset Ready Resets after upgrade is complete.

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3.37 show ap-config wtp-descriptor

Use this command to display the status description of an AP.

3-31
Command Reference WLAN CAPWAP Commands

show ap-config wtp-descriptor ap-name

Parameter Parameter Description

Description ap-name Indicates the name of the AP to be queried.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the status description of an AP.

ac#show ap-config wtp-descriptor wlan-ap-0001
Ap(wlan-ap-0001)'s wtp descriptor:
max radio :2
radio in used :2

encrypt num :2
Configuration Cnt WBID Encry Cap
Examples 1 0x1 0xc

sub descriptor num :3

Cnt vonder id version type version len version
1 0x7c12 BOOT Ver 28 MainVer10.SubVer4.SvnVer3634
2 0x7c12 ACT SW Ver 30 RGOS 10.4 (1t7)(1T7),
Release(73413)
3 0x7c12 HW Ver 3 1.0

Related Command Description

Commands N/A N/A

Platform N/A
Description

3.38 show ap-config wtp-info

Use this command to display the AP device status.
show ap-config wtp-info ap-name

Parameter
Parameter Description
Description

3-32
Command Reference WLAN CAPWAP Commands

ap-name AP device name

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

Configuration The following example displays the AP device status.

Examples Ruijie#show ap-config wtp-info ap220e
Ap(ap220e)'s status:
AC IP(status): :101.101.101.101
AP IP(status): :10.10.10.8 255.255.255.0 10.10.10.2
AP IPV6(status): :::/0 ::
AP IPV4 ENABLE: :enable
Location Data: :
Session ID: :88320000,111163fb,5c3b3cb3,2cac585a
mac type :full support
WTP Name: :ap220e
AP Domain Name: :ac.ruijie.com.cn
wired vlan :0 port id 1
wired vlan :0 port id 2
wired vlan :0 port id 3
wired vlan :0 port id 4
Cw_interface_name :BVI 1
Cw_wan_interface_ifx::1
Cw_wan_interface_ifx::0
Upgrading State :Init
AP Image file :NA
Real version :1.0.0.641d31e6
Custom version :AP_RGOS 11.1(2)B1
Upgrade version :NA
Upgrade from AP :FALSE
Upgrade for other AP:FALSE
Upgrade from AC :FALSE
Wait for upgrade :FALSE
Support distr-upg :TRUE
Upgrade-banfwidth :128
Upgrade group :Upgrade-group1

Related
Command Description
Commands

3-33
Command Reference WLAN CAPWAP Commands

N/A N/A

Platform N/A
Description

3.39 show capwap detail

Use this command to display details about the CAPWAP tunnel.
show capwap [ index | [ ip-address [ port ] ] ] detail

Parameter
Parameter Description
Description
index Tunnel index.
ip-address Tunnel IP address.
port Tunnel port number.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

Configuration The following example displays details about the CAPWAP tunnel whose address is 1.1.1.1.
Examples Ruijie#show capwap 1.1.1.1 detail
CAPWAP process “capwap 1” with state Run
Process uptime is 3 days 0 hour 41 minutes
Echo interval is 30 secs, Dead interval is 81 secs
Current timers echo-interval
Peer address is 172.18.59.5
Peer control port is 10000, data port is 10001
My address is 55.55.55.60
The MAC of AP is 001a.a94e.d773
The Session ID of AP is 001a.a94e.d773.53e1.0801.53e1.0801.53e1
The Path MTU is 1500
Recent recieved request's sequence number 39
Recent recieved response's sequence number 11
Recent send request's sequence number 11
Retransmit Count 0, Discovery Count 0, Failed DTLS Session Count 0
Sending queue length 0, Receive queue length 0

Related
Command Description
Commands

3-34
Command Reference WLAN CAPWAP Commands

N/A N/A

Platform N/A
Description

3.40 show capwap state

Use this command to display the CAPWAP tunnel state.
show capwap state

Parameter
Parameter Description
Description
N/A N/A

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

Configuration The following example displays the CAPWAP tunnel state.

Examples Ruijie#show capwap state
CAPWAP tunnel state, 3 peers, 2 is run:
Index Peer IP Peer Port State Mac Address
1 192.168.0.1 10000 Run 001a.a900.0001
2 192.168.0.2 10000 Run 001a.a900.0002
3 192.168.0.3 10000 DTLS Teardown 001a.a900.0003
Field Description
Index Tunnel index.
Peer IP Peer IP address.
Peer Port Peer port number.
State Tunnel state.
Mac Address AP MAC address, only displayed on ACs.

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3-35
Command Reference WLAN CAPWAP Commands

3.41 show capwap statistics

Use this command to display statistics about the CAPWAP tunnel packets.
show capwap [ index | [ ip-address [ port ] ] ] statistics

Parameter
Parameter Description
Description
index Tunnel index.
ip-address Tunnel IP address.
port Tunnel port number.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

Configuration The following example displays packet statistics about the CAPWAP tunnel whose IP address is
Examples 1.1.1.1.
Ruijie#show capwap 1.1.1.1 statistics

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3.42 show version

Use this command to display the AP version.
show version { all | ap-name }

Parameter
Parameter Description
Description
all All APs.
ap-name Specifies an AP.

Defaults N/A

Command Privileged EXEC mode

3-36
Command Reference WLAN CAPWAP Commands

Mode

Usage Guide N/A

Configuration The following example displays the version information on all APs.
Examples Ruijie#show version all
AP(AP220E-0)'s version:
Product ID : AP220-E
System uptime : 0:3:9:32
Hardware version : 2.00
Software version : AP_RGOS 11.1(2)B1
Patch number : SP2
Software number : M05563609152014
Serial number : 1234942570005
MAC address : 00d0.f822.33b0

AP(AP220E-2)'s version:
Product ID : AP220-E
System uptime : 0:6:11:53
Hardware version : 2.00
Software version : AP_RGOS 11.1(2)B1
Patch number : SP2
Software number : M05563609152014
Serial number : 1234942570018
MAC address : 001a.a9bd.0c1b

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3.43 timestamp
Use this command to configure a specified AP or all APs in a specified AP group to synchronize with
the AC in time.
timestamp

Parameter Parameter Description

Description N/A N/A

Defaults N/A

3-37
Command Reference WLAN CAPWAP Commands

Command AP configuration mode/AP group configuration mode

Mode

Usage Guide N/A

The following example configures AP0001 to synchronize with the AC in time.

Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# timestamp
Configuration
The following example configures all APs in the AP group (Default) to synchronize with the AC in
Examples
time.
Ruijie(config)# ap-group default
Ruijie(config-ap-group)# timestamp

Related Command Description

Commands N/A N/A

Platform N/A
Description

3.44 tran-data-show

Use this command to display log information transmitted recently from a specified AP to the AC.

tran-data-show ap-name { exception | cpuinfo | memory | syslog | tech-support }

Parameter Description
ap-name Indicates the name of the specified AP.
Parameter exception Indicates the crash log information of the specified AP.
Description cpuinfo Indicates the CPU information of the specified AP.
memory Indicates the memory information of the specified AP.
syslog Indicates the general log information of the specified AP.
tech-support Indicates the console information of the specified AP.

Defaults N/A

Command AC configuration mode

Mode

Usage Guide N/A

3-38
Command Reference WLAN CAPWAP Commands

The following example displays the crash log of AP0001.

Ruijie(config-ac)# tran-data-show AP0001 exception
The following example displays the CPU information of AP0001.
Ruijie(config-ac)# tran-data-show AP0001 cpuinfo
Configuration The following example displays the memory information of AP0001.
Examples Ruijie(config-ac)# tran-data-show AP0001 memory
The following example displays the general log information of AP0001.
Ruijie(config-ac)# tran-data-show AP0001 syslog
The following example displays the console information of AP0001.
Ruijie(config-ac)# tran-data-show AP0001 tech-support

Related Command Description

Commands N/A N/A

Platform N/A
Description

3.45 tran-data-start

Use this command to obtain log information about a specified AP.

tran-data-start ap-name { exception | memory | tech-support | tech-package }

Parameter Description
ap-name Indicates the name of the specified AP.
exception Indicates the crash log information sent by the specified
Parameter AP.
Description memory Indicates the device status information sent by the
specified AP, including CPU information, memory
information, and general log information (including port
UP/DOWN information).
Indicates the console information.
tech-support

Indicates the package information.

tech-package

Defaults N/A

Command AC configuration mode

Mode

Usage Guide N/A

3-39
Command Reference WLAN CAPWAP Commands

The following example obtains the crash log information from AP0001, and saves it as
ap_AP0001_exception.log in the AC file system.
Ruijie(config-ac)# tran-data-start AP0001 exception

The following example obtains the general log information from AP0001, and saves it as
ap_AP0001_syslog.log, ap_AP0001_memory.log, and ap_AP0001_cpuinfo.log in the AC file
system.
Configuration Ruijie(config-ac)# tran-data-start AP0001 memory
Examples
The following example obtains the console information from AP0001, and saves it as
ap_AP0001_8832.0000.1111_tech-console.log in the AC file system.
Ruijie(config-ac)# tran-data-start AP0001 tech-support
The following example obtains the package information from AP0001, and saves it as
ap_AP0001_8832.0000.1111_tech-package.tar.gz in the AC file system.
Ruijie(config-ac)# tran-data-start AP0001 tech-package

Related Command Description

Commands N/A N/A

Platform N/A
Description

3.46 wired-interface
Use this command to enable the wired network port on the AP. Use the no form of this command to
disable the wired port. Use the default form of this command to restore the default setting.
wired-interface [port port-id ] enable
no wired-interface [port port-id ] enable
default wired-interface [port port-id ] enable

Parameter
Parameter Description
Description
port Configures the wired network port.
port-id Specifies the wired network port number, in the range from 1 to 4.
enable Enables the wired network port.

Defaults The wired network port is enabled by default.

Command AP configuration mode/ AP group configuration mode

Mode

Usage Guide 1. This command can be configured on all APs, but it takes effect only on the APs with wired
network port.

3-40
Command Reference WLAN CAPWAP Commands

2. If this command involves no port configuration, all wired network ports share the same
configuration; if the four ports are disabled, no port configuration is displayed.
3. The fit AP obtains its configuration from the AC. The AP saves the wired port configuration
automatically. When disconnected from the AC, the AP can restore the configuration after
restart. If the wired port is disabled through configuration, the port remains disabled even after
AP restart.

If the wired port on the AP is disabled, you cannot manage the AP through the wired port even
after AP restart. It is recommended to long press the reset button on the AP to restore the
factory setting.

Configuration The following example disables the wired network port on AP1.
Examples Ruijie(config)# ap-config AP1
Ruijie(config-ap)# no wired-interface

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3.47 wired-vlan
Use this command to configure the VLAN for the for the wired network port on the AP. Use the no
form of this command to restore the default setting.
wired-vlan vlan-id [port port-id ] auto-save
no wired-vlan [vlan-id [port port-id ] ] auto-save

Parameter
Parameter Description
Description
Specifies the VLAN where the wired network port resides, in the
vlan-id
range from 1 to 4094.
port Configures the wired network port.
port-id Specifies the wired network port number, in the range from 1 to 4.
Saves the configuration. The AP restores the configuration after
auto-save
restart.

Defaults The wired network port and the AP are in the same VLAN by default.

Command AP configuration mode/ AP group configuration mode

Mode

Usage Guide 1. This command can be configured on all APs, but it takes effect only on the APs with wired

3-41
Command Reference WLAN CAPWAP Commands

network port.
2. If this command involves no port configuration, all wired network ports are in the same VLAN; if
the four ports are configured in the same VLAN, no port configuration is displayed.
3. In access AP mode (the AP does not assign IP addresses), when the wired network port and the
AP are configured in the same VLAN, the VLAN where the wired network port resides is
determined by the access switch rather than by this configuration. If the packet on the wired
network port should be tagged, the Native VLAN of the access switch must be different from the
VLAN where the wired network port resides. Otherwise, the packet cannot be forwarded to the
wired network port.
4. In wireless routing mode (the AP assigns IP addresses), wired users obtain IP addresses from
the DHCP address pool on the AP. The VLAN where the address pool interface resides must be
consistent with the VLAN specified in this command.
5. The fit AP obtains its configuration from the AC. The auto-same parameter enables the AP to
save the wired port configuration automatically. When disconnected from the AC, the AP can
restore the configuration after restart to enable users to access the network through wired
network port.

When the wired network port is enabled with the auto-same function and the VLAN where the
wired network port resides is different from the Native VLAN of the AP, the AP cannot obtain the
IP address after restart. It is recommended to long press the reset button on the AP to restore
the factory setting.

Configuration The following example configures VLAN 20 for the wired network port on AP1.
Examples Ruijie(config)# ap-config AP1
Ruijie(config-ap)# wired-vlan 20

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

3-42
Command Reference WBS Commands

4 WBS Commands

4.1 11asuport enable

Use the command to enable the specified radio to support 802.11a on 5 GHz. Use the no form of this
command to disable the radio to support 802.11a on 5 GHz.
11asupport enable radio radio-id
no 11asupport enable radio radio-id

Parameter
Parameter Description
Description
radio-id Radio ID. The range is from 1 to 48.

Defaults By default, 802.11a is supported.

Command AP configuration mode

mode

Usage Guide N/A

Configuration The following example enables radio1 to support 802.11a on 5 GHz.

Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# 11asupport enable radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.2 11bsupport enable

Use the command to enable the specified radio to support 802.11b on 2.4 GHz. Use the no form of
this command to disable the radio to support 802.11b on 2.4 GHz.
11bsupport enable radio radio-id
no 11bsupport enable radio radio-id

Parameter
Parameter Description
Description
radio-id Radio ID. The range is from 1 to 48.

4-1
Command Reference WBS Commands

Defaults By default, 802.11b is supported.

Command AP configuration mode

mode

Usage Guide N/A

Configuration The following example enables radio1 to support 802.11b on 2.4 GHz.
Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# 11bsupport enable radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.3 11gsupport enable

Use this command to enable the specified radio to support 802.11g on 2.4 GHz. Use the no form of
this command to disable the radio to support 802.11g on 2.4 GHz.
11gsupport enable radio radio-id
no 11gsupport enable radio radio-id

Parameter
Parameter Description
Description
radio-id Radio ID. The range is from 1 to 48.

Defaults By default, 802.11g is supported.

Command AP configuration mode

mode

Usage Guide N/A

Configuration The following example enables radio1 to support 802.11g on 2.4 GHz.
Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# 11gsupport enable radio 1

Related
Command Description
Commands
N/A N/A

4-2
Command Reference WBS Commands

Platform N/A
Description

4.4 11nasupport enable

Use this command to enable the specified radio to support 802.11n on 5 GHz. Use the no form of this
command to disable the radio to support 802.11n on 5 GHz.
11nasupport enable radio radio-id
no 11nasupport enable radio radio-id

Parameter
Parameter Description
Description
radio-id Radio ID. The range is from 1 to 48.

Defaults By default, 802.11n is supported.

Command AP configuration mode

mode

Usage Guide N/A

Configuration The following example enables radio1 to support 802.11n on 5 GHz.

Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# 11nasupport enable radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.5 11ngsupport enable

Use this command to enable the specified radio to support 802.11n on 2.4 GHz. Use the no form of
this command to disable the radio to support 802.11n on 2.4 GHz.
11ngsupport enable radio radio-id
no 11ngsupport enable radio radio-id

Parameter
Parameter Description
Description
radio-id Radio ID. The range is from 1 to 48.

4-3
Command Reference WBS Commands

Defaults By default, 802.11n is supported.

Command AP configuration mode

mode

Usage Guide N/A

Configuration The following example enables radio1 to support 802.11n on 2.4 GHz.
Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# 11ngsupport enable radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.6 11acsupport enable

Use this command to enable the specified radio to support 802.11ac. Use the no form of this
command to disable the radio to support 802.11ac.
11acsupport enable radio radio-id
no 11acsupport enable radio radio-id

Parameter
Parameter Description
Description
radio-id Radio ID. The range is from 1 to 48.

Defaults By default, 802.11ac is supported when the radio ID is even.

Command AP configuration mode

mode

Usage Guide N/A

Configuration The following example enables radio1 to support 802.11ac.

Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# 11acsupport enable radio 1

Related
Command Description
Commands
N/A N/A

4-4
Command Reference WBS Commands

Platform N/A
Description

4.7 11axsupport enable

Use this command to enable the specified radio to support 802.11ax. Use the no form of this
command to disable the radio to support 802.11ax.
11axsupport enable radio radio-id
no 11axsupport enable radio radio-id

Parameter
Parameter Description
Description
radio-id Radio ID. The range is from 1 to 96.

Defaults By default, 802.11ax is disabled.

Command AP configuration mode

mode

Usage Guide N/A

Configuration The following example enables radio 2 to support 802.11ax.

Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# 11axsupport enable radio 2

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.8 802.11a network rate

Use this command to configure a RF rate list for the 802.11anetwork.

802.11a network rate { 6 | 9 | 12 | 18 | 24 | 36 | 48 | 54 } { disabled | mandatory | supported }

Parameter Description
6 Indicates 6Mbps rate.
Parameter 9 Indicates 9Mbps rate.
Description 12 Indicates 12Mbps rate.
18 Indicates 18Mbps rate.
24 Indicates 24Mbps rate.

4-5
Command Reference WBS Commands

36 Indicates 36Mbps rate.

48 Indicates 48Mbps rate.
54 Indicates 54Mbps rate.
disabled Not supported
mandatory Supported
supported Optional

By default, the default value varies with the modes of the AP. For the 802.11a networks, the rates of
Defaults 6, 12 and 24 are mandatory, and all others are supported.

Command AC configuration mode/AP configuration mode/AP group configuration mode

Mode

Usage Guide None

The following example disables 6Mbps for 802.11a users.

Ruijie(config)# ac-controller
Ruijie(config-ac)# 802.11a network rate 6 disabled
The following example disables 6Mbps for 802.11a users on AP001.

Configuration
Examples
Ruijie(config)# ap-config AP001
Ruijie(config-ap)# 802.11a network rate 6 disabled
The following example disables 6Mbps for 802.11a users on default group.
Ruijie(config)# ap-group default
Ruijie(config-group)# 802.11a network rate 6 disabled

Related Command Description

Commands - -

Platform N/A
Description

4.9 802.11b network rate

Use this command to configure a RF rate list for the 802.11b network.

802.11b network rate { 1 | 2 | 5 | 11 } { disabled | mandatory | supported }

Parameter Description
1 Indicates 1Mbps rate.
Parameter
2 Indicates 2Mbps rate.
Description
5 Indicates 5Mbps rate.
11 Indicates 11Mbps rate.

4-6
Command Reference WBS Commands

disabled Not supported

mandatory Supported
supported Optional

Defaults By default, 1Mbps, 2Mbps, 5.5Mbps, 11Mbps are mandatory.

Command AC configuration mode/AP configuration mode/AP group configuraiton mode

Mode
Usage Guide None

The following example disables 1Mbps for 802.11b users.

Ruijie(config)# ac-controller
Ruijie(config-ac)# 802.11b network rate 1 disabled
The following example disables 1Mbps for 802.11b users on AP0001.
Ruijie(config)# ap-config AP001
Configuration
Ruijie(config-ap)# 802.11b network rate 1 disabled
Examples

The following example disables 1Mbps for 802.11b users on default group.
Ruijie(config)# ap-group default
Ruijie(config-group)# 802.11b network rate 1 disabled

4.10 802.11g network rate

Use this command to configure a RF rate list for the 802.11g network.

802.11g network rate { 1 | 2 | 5 | 6 | 9 | 11 | 12 | 18 | 24 | 36 | 48 | 54 } { disabled | mandatory |

supported }

Parameter Description
1 Indicates 1Mbps rate.
2 Indicates 2Mbps rate.
5 Indicates 5Mbps rate.
6 Indicates 6Mbps rate.
9 Indicates 9Mbps rate.
Parameter
11 Indicates 11Mbps rate.
Description
12 Indicates 12Mbps rate.
18 Indicates 18Mbps rate.
24 Indicates 24Mbps rate.
36 Indicates 36Mbps rate.
48 Indicates 48Mbps rate.
54 Indicates 54Mbps rate.

4-7
Command Reference WBS Commands

disabled Not supported

mandatory Supported
supported Optional

Defaults By default, 1Mbps, 2Mbps, 5.5Mbps, 11Mbps are mandatory. The others are optional.

Command AC configuration mode/AP configuration mode/AP group configuration mode

Mode
Usage Guide None

The following example disables 1Mbps for 802.11g users..

Ruijie(config)# ac-controller
Ruijie(config-ac)# 802.11g network rate 1 disabled
The following example disables 1Mbps for 802.11g users on AP0001.
Configuration Ruijie(config)# ap-config AP001
Examples Ruijie(config-ap)# 802.11b network rate 1 disabled
The following example disables 1Mbps for 802.11g users on default group.
Ruijie(config)# ap-group default
Ruijie(config-group)# 802.11b network rate 1 disabled

4.11 {802.11a | 802.11b} network [disable | enable]

Use this command to configure whether to enable or disable the 2.4GHz or 5GHZ network. When the
2.4GHz or 5GHZ network is disabled, all the wireless users connected with this wireless network will go
offline.

{ 802.11a | 802.11b } network [ disable | enable ]

Parameter Parameter Description

Description N/A N/A

Defaults The default is enable.

Command ac configuration mode.

Mode

Usage Guide None

Configuration Example 1: Configure the 802.11a network disable

4-8
Command Reference WBS Commands

Examples Ruijie(config-ac)# 802.11a network disable

Related Command Description

Commands - -

Platform N/A
Description

4.12 80.211n a-mpdu enable

Use this command to enable the specified radio to support AMPDU. Use the no form of this
command to disable the radio to support AMPDU.
802.11n a-mpdu enable radio radio-id
no 802.11n a-mpdu enable radio radio-id

Parameter
Parameter Description
Description
radio-id Radio ID. The range is from 1 to 48.

Defaults AMPDU is enabled by default.

Command AP configuration mode

mode

Usage Guide This command takes effect only when the radio operates in 802.11n or 802.11ac,

Configuration The following example enables radio1 to support AMPDU.

Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# 802.11n a-mpdu enable radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.13 80.211n mcs support

Use this command to configure the modulation and coding scheme (MCS) index of 802.11n. Use the
no form of this command to restore the default MCS of 802.11n.
802.11n mcs support num radio radio-id
no 802.11n mcs support radio radio-id

4-9
Command Reference WBS Commands

Parameter
Parameter Description
Description
num MCS index. The range is from 0 to 31.
radio-id Radio ID. The range is from 1 to 96.

Defaults The default MCS index of 802.11n is 31.

Command AP configuration mode

mode

Usage Guide N/A

Configuration The following example configures the MCS index to 15 of 802.11n for radio1.
Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# 802.11n mcs support 15 radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.14 80.211ac mcs support

Use this command to configure the modulation and coding scheme (MCS) index of 802.11ac. Use the
no form of this command to restore the default MCS of 802.11ac.
802.11ac mcs support num radio radio-id
no 802.11ac mcs support radio radio-id

Parameter
Parameter Description
Description
num MCS index. The range is from 0 to 39.
radio-id Radio ID. The range is from 1 to 48.

Defaults The default MCS index of 802.11ac is 39.

Command AP configuration mode

mode

Usage Guide N/A

Configuration The following example configures the MCS index to 19 of 802.11ac for radio1.
Examples Ruijie(config)# ap-config AP0001

4-10
Command Reference WBS Commands

Ruijie(config-ap)# 802.11ac mcs support 19 radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.15 ampdu-retries

In a wireless network, AMPDU software retransmission is adopted to reduce the sub-frame loss. The
more retransmission attempts, the less the package loss. However excessive retransmission attempts
increase the workload of air interfaces, which reduce the immediacy of other packages. So, it is
recommended to configure more retransmission attempts when sub-frame loss frequently occurs.

ampdu-retries times radio radio_id

Parameter Description
Parameter
times Retransmission times. The range is from 1 to 10.
Description
radio-id Radio ID. The range is from 1 to 48.

Defaults By default, the retransmission times is 10.

Command AP configuration mode

Mode

Usage Guide N/A

The following example enters the configuration mode of AP0001 and sets the AMPDU software
Configuration retransmission times to 2.
Examples Ruijie(config)#ap-config AP0001
Ruiejie(config-ap)#ampdu-retries 2 radio 1

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.16 ampdu-rts

Use this command to enable the Request to Send (RTS) protection mode for the AMPDU packets.

4-11
Command Reference WBS Commands

Use the no form of this command to disable the RTS mode.

ampdu-rts radio { radio-id | 802.11b | 802.11a ] }

no ampdu-rts radio { radio-id | 802.11b | 802.11a ] }

Parameter Parameter Description

Description radio-id Radio ID. The range is from 1 to 48.
802.11b Configures radios on all 2.4 GHz frequency band.
802.11a Configures radios on all 5.8 GHz frequency band.

Defaults This function is disabled by default.

Command AP configuration mode

Mode

Usage Guide N/A

The following example enters the configuration mode of AP0001 and enables the AMPDU RTS
Configuration protection on the radio 1.
Examples Ruijie(config)# ap- config AP0001
Ruieji(config-ap)# ampdu-rts radio 1

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.17 antdetect enable

Use this command to enable extension cable link detection function. Use the no form of this
command to restore to disable extension cable detection.
antdetect enable
no antdetect enable

Parameter
Parameter Description
Description
N/A N/A

Defaults Extension cable detection is disabled by default.

Command AP configuration mode

4-12
Command Reference WBS Commands

Mode

Usage Guide N/A

Configuration The following example enables i-Share antenna extension cable link detection function:
Examples ruijie(config-ap)#antdetect enable

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.18 antdetect interval

Use this command to configure the time interval of the extension cable link detection. Use the no form
of this command to restore the default detection interval.
antdetect interval interval
no antdetect interval

Parameter
Parameter Description
Description
interval Indicates the detection interval. The unit is minute, and the range is
from 1 to 10,000.

Defaults The default detection interval is 1 minute.

Command AP configuration mode

Mode

Usage Guide N/A

Configuration The following example configures the time interval of detection as 1 minute:
Examples ruijie(config-ap)#antdetect enable
ruijie(config-ap)#antdetect interval 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4-13
Command Reference WBS Commands

4.19 antenna receive

Use this command to configure the receiving antenna type of the specified radio for the specified AP
or all APs of the specified AP group.
antenna receive value radio radio-id

Parameter
Parameter Description
Description
value Antenna mask. The range is from 1 to 15.
radio-id Radio ID. The range is from 1 to 48.

Defaults For AP configuration mode, the default receiving antenna type depends on device model.
For AP group configuration mode, there is no default setting.

Command AP configuration mode/AP group configuration mode

Mode

Usage Guide This command takes effect only on the AP device operating in 802.11n.

Configuration The following example configures the receiving antenna type to 5 for AP001.
Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# antenna receive 5 radio 1
The following example configures the receiving antenna type to 5 for AP group.
Ruijie(config)# ap-group default
Ruijie(config-group)# antenna receive 5 radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.20 antenna transmit

Use this command to configure the transmitting antenna type of the specified radio or all APs of the
specified AP group..
antenna transmit value radio radio-id

Parameter
Parameter Description
Description
value Antenna mask. The range is from 1 to 15.
radio-id Radio ID. The range is from 1 to 48.

4-14
Command Reference WBS Commands

Defaults For AP configuration mode, the default receiving antenna type depends on device model.
For AP group configuration mode, there is no default setting.

Command AP configuration mode/AP group configuration mode

Mode

Usage Guide This command takes effect only on the AP device operating in 802.11n.

Configuration The following example configures the transmitting antenna type to 7 on AP001.
Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# antenna transmit 7 radio 1
The following example configures the transmitting antenna type to 7 on the AP group (default).
Ruijie(config)# ap-group default
Ruijie(config-group)# antenna transmit 7 radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.21 apsd
Use this command to enable the unscheduled-automatic power save delivery (U-APSD) mode for the
specified radio of an AP device.
apsd { enable | disable } radio radio-id

Parameter
Parameter Description
Description
enable Enables the U-APSD mode.
disable Disables the U-APSD mode.
radio-id Radio ID. The range is from 1 to 48.

Defaults U-APSD mode is enabled by default.

Command AP configuration mode

mode

Usage Guide N/A

Configuration The following example enables the U-APSD mode for radio1.
Examples Ruijie(config)# ap-config AP0001

4-15
Command Reference WBS Commands

Ruijie(config-ap)#apsd enable radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.22 autowifi

Use this command to enable one-click WLAN configuration on an unconfigured device. Use the no
form of this command to remove the one-click WLAN configuration.

autowifi

no autowifi

Parameter Parameter Description

Description N/A N/A

Defaults N/A

Command AC global configuration mode

Mode

One-click WLAN configuration function is provided for fast configuration on an unconfigured device,

Usage Guide In general, this function aims at helping the scenario investigator to improve efficiency and
helping the channel distributors to test WLAN performance in a more convenient way.

Configuration The following example configures one-click WLAN configuration.

Examples Ruijie(config)# autowifi

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.23 assoc-rssi
Use this command to configure the minimum RSSI for the STA to associate with the specified AP.

4-16
Command Reference WBS Commands

Use the no form of this command to restore the default setting.

response-rssi rssi radio radio-id
no response-rssi radio radio-id

Parameter
Parameter Description
Description
rssi Specifies the RSSI. The range is from 0 to 100. The unit is dBm.
radio-id Radio ID. The range is from 1 to 48.

Defaults The default RSSI is 0, namely, the STA any RSSI can associate with the AP.

Command AP configuration mode

mode

Usage Guide This command is used to clear sticky STAs in roaming scenario, It is recommended to set RSSI to a
value in the range from 15 to 30.

Configuration The following example enters AP0001 configuration mode and sets the minimum RSSI for the STA to
Examples associate with AP0001 to 15.
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# assoc-rssi 15 radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.24 beacon dtim-period

Use this command to configure the period of delivery transmission indication messages (DTIM) for the
specified radio.

beacon dtim-period period-num radio radio-id

Parameter Description
Parameter period-num DTIM period, which indicating the beacon periods. The
Description range is from 1 to 255.
radio-id Radio ID. The range is from 1 to 48.

Defaults The default DTIM period is 1 (namely, 1 beacon period).

Command AP configuration mode.

Mode

4-17
Command Reference WBS Commands

Usage Guide N/A

The following example configures the DTIM period of radio 1 of AP0001 to 30 beacon periods.
Configuration
Ruijie(config)# ap-config AP0001
Examples
Ruijie(config-ap)# beacon dtim-period 30 radio 1

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.25 beacon period

Use this command to configure the beacon period forthe specified radio of the specified AP.

beacon period milliseconds radio radio-id

Parameter Description
Parameter milliseconds Beacon period. The range is from 20 to 1,000. The unit is
Description millisecond.
radio-id Radio ID. The range is from 1 to 48.

Defaults The default is beacon period is 100 milliseconds.

Command AP configuration mode.

Mode

Usage Guide N/A

The following example configures the beacon period of radio 1 of AP0001 to 200 milliseconds.
Configuration
Ruijie(config)# ap-config AP0001
Examples
Ruijie(config-ap)# beacon period 200 radio 1

Related Command Description

Commands - -

Platform N/A
Description

4.26 beacon rate

Use this command to configure the beacon rate for the specified radio. Use the no form of this
command to restore the default beacon rate.

4-18
Command Reference WBS Commands

beacon rate rate-Mbps radio { radio-id | 802.11b | 802.11a ] }

no beacon rate radio { radio-id | 802.11b | 802.11a ] }

Parameter
Parameter Description
Description
Specifies the beacon rate.
1, The rate blocked in the rate set cannot be set as a beacon rate.
rate-Mbps
2. The rates of 1Mbps, 2Mbps, 5.5Mbps and 11 Mbps are not
supported by the radios on 5 GHz.
radio-id Radio ID. The range is from 1 to 48.
802.11b Configures radios on all 2.4 GHz frequency band.
802.11a Configures radios on all 5.8 GHz frequency band.

Defaults No beacon rate is configured by default.

Command AP configuration mode

mode

Usage Guide N/A

Configuration The following example configures the beacon rate of radio1 to 12Mbps.
Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# beacon rate 12.0 radio 1

Related
Command Description
Commands

N/A N/A

Platform N/A
Description

4.27 chan-width
Use this command to set the bandwidth of the specified radio.
chan-width { 20 | 40 | 80 | 160 } radio { radio-id | 802.11b | 802.11a ] }

Parameter
Parameter Description
Description
20 Sets the radio width to 20 Mbps.
40 Sets the radio width to 40 Mbps.
80 Sets the radio width to 80 Mbps.
160 Sets the radio width to 160 Mbps.
radio-id Sets radio ID. The range is from 1 to 48.

4-19
Command Reference WBS Commands

802.11b Configures radios on all 2.4 GHz frequency band.

802.11a Configures radios on all 5.8 GHz frequency band.

Defaults The default channel bandwidth of 20 Mbps.

Command AP configuration mode

mode

Usage Guide The radio bandwidth configuration takes effect only for the AP device operating at 802.11n mode.

Configuration The following example sets the radio width of radio1 to 40 Mbps.
Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# chan-width 40 radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.28 channel

Use this command to configure a channel for the specified radio of the specified AP.

channel { global | channel-id } radio radio-id

Parameter Description
chan-id Specifies the channel ID.
Parameter
global Indicates that the channel is specified through the radio
Description
resource management (RRM) function.
radio-id Sets radio ID. The range is from 1 to 48.

Defaults By default, the global parameter is used.

Command AP configuration mode.

Mode

Usage Guide N/A

The following example specifies channel 6 for radio 1.

Configuration
Ruijie(config)# ap-config AP0001
Examples
Ruijie(config-ap)# channel 6 radio 1

4-20
Command Reference WBS Commands

Related Command Description

Commands - -

Platform N/A
Description

4.29 country

Use this command to specify a country/region code for an AC device. Use the no form of this
command to remove the country/region code settings for an AC device.

country country-code

no country country-code

Use this command to specify a country/region code for the specified radio of an AP device.

country country-code radio { radio-id | [ 802.11b | 802.11a ] }

Parameter Description
Parameter
country-code Country/region code.
Description
radio-id Sets radio ID. The range is from 1 to 48.

802.11b Configures radios on all 2.4 GHz frequency band.

802.11a Configures radios on all 5.8 GHz frequency band.

By default, the country code supported by an AC device is CN, and the country code used by an AP
Defaults
device is CN.

Command AC/AP configuration mode.

Mode

1. The country code "CN" supported by an AC cannot be deleted.

2. This command cannot be configured for all APs at the same time.

3. There are two country codes available now: CN (China) and US (United States). The

country/region code is divided into indoor (IN) and outdoor (OUT), Tag the country/region code

Usage Guide with I or O to identify the environment. For example, CNI indicates China Indoor.

4. Before configuring a country/region code for an AP, add the country/region code to the country
code set supported by the AC. If the country/region code used by an AP changes, the radio
band, channel, and power of the AP change accordingly.
5. If 802.11b is specified, the country/region code is configured for all 2.4 GHz radios; the
configuration takes effect when the AP goes online for the first time, and it takes effect on the
specified radios only. When 802.11a is specified, the country/region code is configured for all

4-21
Command Reference WBS Commands

5.8 GHz radios; the configuration takes effect when the AP goes online for the first time and it
takes effect on the specified radios only.

The following example configures a country/region code supported by an AC device to US.

Ruijie(config)# ac-controller
Ruijie(config- ac)# country US
Configuration
Ruijie(config- ac)# exit
Examples
The following example configures a country/region code for radio 1 of AP0001 to US.
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# country US radio 1

Related Command Description

Commands - -

Platform N/A
Description

4.30 coverage-area-control
Use this command to set the coverage area control power. Use the no form of this command to
restore the default coverage area control power.
coverage-area-control power
no coverage-area-control

Parameter
Parameter Description
Description
Specifies the coverage area control power. The unit is dBm. The
power
range is from 0 to 32.

Defaults The default value is 0.

Command AP configuration mode/AP group configuration mode

mode

Usage Guide N/A

Configuration The following example enters AP0001 configuration mode and sets the coverage area control power
Examples to 20.
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# coverage-area-control 20
The following example enters AP group configuration mode and sets the coverage area control power
to 20.
Ruijie(config)# ap-group default
Ruijie(config-group)# coverage-area-control 20

4-22
Command Reference WBS Commands

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.31 ebag
Use this command to enable ebag network optimization. Use the no form of this command to disable
ebag network optimization.
ebag
no ebag

Parameter
Parameter Description
Description

N/A N/A

Defaults N/A

Command AP configuration mode

mode

Usage Guide This command is generally used in e-bag scenario. Use this function with caution in other scenarios.

Configuration The following example enables ebag network optimization.

Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# ebag

Related
Command Description
Commands

N/A N/A

Platform N/A
Description

4.32 enable-radio

Use this command to enable a/all radio for an AP device. Use the no form of this command to disable
a/all radios.

enable-radio { radio-id | all }

4-23
Command Reference WBS Commands

no enable-radio { radio-id | all }

Parameter Description
Parameter
radio-id Radio ID. The range is from 1 to 48.
Description
all Enables all radios.

Defaults By default, all radios of the AP device are enabled.

Command AP configuration mode.

Mode

Note:
Usage Guide
This operation may result in offline of all the wireless users connected to the specified radio.

The following example enters the configuration mode of AP0001 and disables radio 1.
Configuration
Ruijie(config)# ap- config AP0001
Examples
Ruieji(config-ap)# no enable-radio 1

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.33 eth-schd

Use this command to configure maximum number of Ethernet packets received on the AP device for
one time. Use the no form of this command to restore the default number of packets received for one
time.

eth-schd limit

no eth-schd

Parameter Description
Parameter
limit The maximum number of Ethernet packets received for one
Description
time. The range is from 1 to 256.

Defaults The default limit value varies by AP model.

Command AP configuration mode

Mode

Usage Guide You can improve the network performance by raising the received Ethernet packets limit for every

4-24
Command Reference WBS Commands

time on an AP, at the cost of reducing immediacy of packets of key services. With regard to
applications which are multi-user concurrent and real-time sensitive, such as electronic schoolbag,
requiring only ordinary networks, you are recommended to decrease the value of received Ethernet
packets limit per time to 25.

The following example enters the configuration mode of AP0001 and sets the maximum number of
Configuration the Ethernet packets received per time to 50.
Examples Ruijie(config)# ap- config AP0001
Ruieji(config-ap)# eth-schd 50

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.34 external-antenna enable

Use this command to enable the external antenna and disable the built-in antenna on the AP device.
external-antenna enable radio radio-id
no external-antenna enable radio radio-id

Parameter
Parameter Description
Description
radio-id Specifies the radio ID in the range from 1 to 48.

Defaults By default, the built-in antenna is enabled, and the external antenna is disabled.

Command AP configuration mode

mode

Usage Guide N/A

Configuration The following example enables the external antenna and disables the built-in antenna on AP001.
Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# external-antenna enable radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4-25
Command Reference WBS Commands

4.35 fragment-threshold
Use this command to set a fragment threshold for a radio. Use the no form of this command to
restore the default fragment threshold.
fragment-threshold value radio radio-id
no fragment-threshold radio radio-id

Parameter
Parameter Description
Description
Specifies the fragment threshold. The value is an even number
value
ranging from 256 to 2.346.
radio-id Radio ID. The range is from 1 to 48.

Defaults The default fragment threshold is 2,346.

Command AP configuration mode

mode

Usage Guide N/A

Configuration The following example sets the fragment threshold of radio1 to 1,538.
Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# fragment-threshold 1538 radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.36 green-field enable

Use this command to enable the green-field protection mode for the specified radio. Use the no form
of this command to disable the green-field protection mode.
green-field enable radio radio-id
no green-field enable radio radio-id

Parameter
Parameter Description
Description
radio-id Radio ID. The range is from 1 to 48.

Defaults By default, the green-field protection mode is disabled.

4-26
Command Reference WBS Commands

Command AP configuration mode

mode

Usage Guide This command is supported only for the radio on 2.4 GHz.

Configuration The following example enables the green-field protection mode for radio1.
Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# green-field enable radio 1

Related
Command Description
Commands

N/A N/A

Platform N/A
Description

4.37 ldpc

Use this command to enable low density parity check (LDPC) coding for the specified radio. Use the no
form of this command to disable LDPC coding.

ldpc radio radio-id

no ldpc radio radio-id

Parameter Parameter Description

Description radio-id Radio ID. The range is from 1 to 48.

Defaults By default, LDPC coding is enabled.

Command AP configuration mode

Mode

Usage Guide N/A

The following example enters the configuration mode of AP0001 and enables LDPC coding on radio
Configuration 1.
Examples Ruijie(config)# ap-config AP0001
Ruieji(config-ap)# ldpc radio 1

Related Command Description

Commands N/A N/A

4-27
Command Reference WBS Commands

Platform N/A
Description

4.38 link-check
Use this command to enable/disable link check.. Use the no form of this command to restore the
default setting.
link-check { enable | disable }
no link-check { enable | disable }

Parameter Parameter Description

Description enable Enables link check.

disable Disables link check.

Defaults Link check is disabled by default.

Command Global configuration mode

mode

Usage Guide N/A

Configuration The following example enables link check.

Examples Ruijie(config)# link-check enable

The following example disables link check.

Ruijie(config)# link-check disable
or
Ruijie(config)# no link-check enable

Related
Command Description
Commands

N/A N/A

Platform N/A
Description

4.39 linktest

Use this command to display the link information about a wireless client.

linktest H.H.H

Parameter Parameter Description

4-28
Command Reference WBS Commands

Description H.H.H MAC address of the wireless client.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the link information about a wireless client.
Ruijie# linktest cca2.2352.768d
Link test station(cca2.2352.768d):
Signal strength in the form of RSSI : 55
Configuration Signal quality in the form of SNR: -37
Examples Total number of packets that are retried: 9
Maximum retry count for a single packet: 16
Number of lost packets: 0
Data rate of a successfully transmitted packet: 0

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.40 mcast-rate
Use this command to configure the multicast rate for WLAN. Use the no form of this command to
restore the default multicast rate of WLAN.
mcast-rate mcast-num
no mcast-rate

Parameter
Parameter Description
Description
WLAN multicast rate.
mcast-num
The available rates: 1Mbps, 6Mbps, 11Mbps, 24Mbps, 54Mbps.

Defaults The default WLAN multicast rate is 24Mbps.

Command WLAN configuration mode

mode

Usage Guide N/A

4-29
Command Reference WBS Commands

Configuration The following example configures the multicast rate of WLAN2048 to 11Mbps.
Examples Ruijie(config)# wlan-config 2048
Ruijie(config-wlan)# mcast-rate 11

Related
Command Description
Commands

N/A N/A

Platform N/A
Description

4.41 mu-mimo enable

Use this command to enable MU-MIMO for the specified radio. Use the no or default form of this
command to restore the default setting.
mu-mimo enable radio radio-id
no mu-mimo enable radio radio-id

default mu-mimo enable radio radio-id

Parameter
Parameter Description
Description
radio-id Specifies a radio, in the range from 1 to 48.

Defaults If the specified radio does not support MU-MIMO, MU-MIMO is disabled by default. If the radio
supports MU-MIMO and it is enabled on the radio by default, it is enabled on the AC by default. If the
radio supports MU-MIMO and it is disabled on the radio by default, it is disabled on the AC by default.

Command AP configuration mode/ All-AP configuration mode/AP group configuration mode

Mode

Usage Guide

Configuration The following example enters AP0001 configuration mode and enable MU-MIMO for radio1.
Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# mu-mimo enable radio 1
The following example enters AP0001 configuration mode and disables MU-MIMO for radio2.
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# no mu-mimo enable radio 2
The following example enters AP0001 configuration mode and restores MU-MIMO setting for radio3.
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# default mu-mimo enable radio 3

4-30
Command Reference WBS Commands

The following example enters All-AP configuration mode and enables MU-MIMO for radio1.
Ruijie(config)# ap-config all
Ruijie(config-ap)# mu-mimo enable radio 1
The following example enters default configuration mode and enables MU-MIMO for radio1.
Ruijie(config)# ap-group default
Ruijie(config-group)# mu-mimo enable radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.42 peer-distance
Use this command to configure the maximum distance between the specified radio and the peer.
peer-distance val radio radio-id

Parameter
Parameter Description
Description
The maximum distance between the radio and the peer. The range is
val
from 1,000 to 25,000. The unit is meter.
radio-id Radio ID. The range is from 1 to 48.

Defaults The default distance between the radio and the peer is 1,000 meters.

Command AP configuration mode

mode

Usage Guide N/A

Configuration The following example configures the maximum distance between radio and the peer to 3,000
Examples meters.
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# peer-distance 3000 radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4-31
Command Reference WBS Commands

4.43 power local

Use this command to configure trasmit power for the specified radio of the specified AP.

power local { global | power } radio { radio-id | [ 802.11b | 802.11a ] }

Parameter Description
power Indicates the percentage of transmit power. The range is
from 1 to 100.
Parameter
Global Indicates that the transmit power is specified through
Description
RRM for the specified AP or all APs of the specified AP
group.
radio-id Radio ID. The range is from 1 to 48.
802.11b Configures 2.4GHz radio.

802.11a Configures 5.8GHz radio.

Defaults By default, the global parameter is used.

Command AP configuration mode/AP group configuration mode

Mode

Usage Guide N/A

The following example configures the transmit power of radio1 of AP0001 to 50%.
Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# power local 50 radio 1
Configuration
The following example configures the transmit power of radio 1 of AP group (default) to 50%.
Examples
Ruijie(config)# ap-group default
Ruijie(config-group)# power local 50 radio 1

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.44 preamable

Use this command configure the preamable attribute for the specified radio of the specified AP.

preamable { long | short } radio radio-id

Parameter Parameter Description

4-32
Command Reference WBS Commands

Description radio-id Radio ID. The range is from 1 to 48.

long Indicates that the AP transmits only frames of long
preamable.
short Indicates that the AP transmits frames of short or long
preamable.

Defaults By default, is short parameter is used.

Command AP configuration mode.

Mode

Usage Guide N/A

The following example configures the preamable attribute of radio 1 of AP0001 to long.
Configuration
Ruijie(config)# ap-config AP0001
Examples
Ruijie(config-ap)# preamable long radio 1

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.45 radio-type

Use this command to configure the RF mode for the specified radio of the specified AP.

radio-type radio-id {802.11a | 802.11b}

Parameter Description
Parameter radio-id Radio ID. The range is from 1 to 48.
Description 802.11a Indicates the 5GHz band is used.
802.11b Indicates the 2.4GHz band is used.

By default, the AP device with single radio (namely, radio1) operates in 2.4 GHz, while the AP device
Defaults
with dual radios can operate in 2.4 GHz (radio1) and 5 GHz (radio2).

Command AP configuration mode.

Mode

Usage Guide N/A

The following example configures radio 1 of AP0001 to operates in 2.4 GHz.

Configuration
Ruijie(config)# ap-config AP0001
Examples
Ruijie(config-ap)# radio-type 1 802.11a

4-33
Command Reference WBS Commands

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.46 response-rssi
Use this command to set the minimum received signal strength indication (RSSI) for wireless client to
associate with the AP. Use the no form of this command to restore the default setting.
response-rssi rssi radio { radio-id | [ 802.11b | 802.11a ] }
no response-rssi radio { radio-id | [ 802.11b | 802.11a ] }

Parameter
Parameter Description
Description
rssi Specifies the RSSI. The range is from 0 to 100. The unit is dBm.
radio-id Radio ID. The range is from 1 to 48.
802.11b Configures radios on all 2.4 GHz frequency band.
802.11a Configures radios on all 5.8 GHz frequency band.

Defaults The default RSSI is 0, namely, the wireless client of any RSSI can associate with the AP.

Command AP configuration mode

mode

Usage Guide N/A

Configuration The following example configures the minimum access RSSI to 20.
Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# response-rssi 20 radio 1

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.47 rts-threshold
Use this command to configure the RTS threshold of the specified radio. Use the no form of this
command to restore the default RTS threshold.
rts-threshold value radio radio-id

4-34
Command Reference WBS Commands

no rts-threshold radio radio-id

Parameter
Parameter Description
Description

value RTS threshold. The unit is byte. The range is from 257 to 2,347.

radio-id Radio ID. The range is from 1 to 48.

Defaults The default RTS threshold is 2,347.

Command AP configuration mode

mode

Usage Guide N/A

Configuration The following example configures the RTS threshold of radio1 to 1,539.
Examples Ruijie(config)# ap-config AP0001
Ruijie(config-ap)# rts-threshold 1539 radio 1

Related
Command Description
Commands

N/A N/A

Platform N/A
Description

4.48 short-gi

Use this command to enable the radio to support short-gi. Use the no form of this command to disable
the radio to support short-gi.

short-gi enable radio radio-id chan-width { 20 | 40 | 80 |160 }

no short-gi enable radio radio-id chan-width { 20 | 40 | 80 |160 }

Parameter Description
radio-id Radio ID. The range is from 1 to 48.
Parameter
20 Configures the channel bandwidth to 20 Mbps.
Description
40 Configures the channel bandwidth to 40 Mbps.
80 Configures the channel bandwidth to 80 Mbps.
160 Configures the channel bandwitdth to 160 Mbps.

Defaults By default, 20Mbps, 40Mbps, 80Mbps and 160Mbps are enabled.

Command AP configuration mode

4-35
Command Reference WBS Commands

Mode

Usage Guide N/A

The following example enables radio1 to support the short-gi of 20Mbps.

Ruijie(config)# ap-config AP0001
Configuration Ruijie(config-ap)# short-gi enable radio 1 chan-width 20
Examples The following example disables radio2 to support the short-gi of 40Mbps.
Ruijie(config)#ap-config AP0001
Ruijie(config-ap)# no short-gi enable radio 2 chan-width 40

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.49 short-slot-time
Use this command to enable short slot time for the AP device. Use the no form of this command to
disable short slot time.
short-slot-time radio radio-id
no short-slot-time radio radio-id

Parameter
Parameter Description
Description
radio-id Radio ID. The range is from 1 to 48.

Defaults By default, short slot time is enabled on the AP device.

Command AP configuration mode

mode

Usage Guide Short slot time takes effect only on the AP working in 5GHz.

Configuration The following example enables short slot time on radio1.

Examples Ruijie(config)#ap-config AP0001
Ruijie(config-ap)# short-slot-time radio 1

Related
Command Description
Commands

N/A N/A

4-36
Command Reference WBS Commands

Platform N/A
Description

4.50 stbc

Use this command to enable space-time block code (STBC) for the specified radio. Use the no form of
this command to disable STBC.

stbc radio radio-id

no stbc radio radio-id

Parameter Parameter Description

Description radio-id Radio ID. The range is from 1 to 48.

Defaults By default, STBC is enabled.

Command AP configuration mode

Mode

Usage Guide N/A

The following example enters the configuration mode of AP0001 and enable STBC for radio1.
Configuration
Ruijie(config)# ap- config AP0001
Examples
Ruieji(config-ap)# stbc radio 1

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.51 show ac-config { 802.11a | 802.11b } summary

Use this command to display the AP devices supporting in 802.11a/b on the AC device.

show ac-config { 802.11a | 802.11b } summary

Parameter Parameter Description

Description N/A N/A

Defaults N/A

Command Privileged EXEC mode

4-37
Command Reference WBS Commands

Mode

Usage Guide N/A

The following example displays the AP devices supporting 802.11a on the AC device.
Ruijie#show ac-config 802.11a summary
Index Ap name slot id Radio Base MAC state
load(%) noise(dBm) interfere(%)
Configuration ------ ---------------------------------------- -------- ---------------
Examples -------- -------- ---------- ---------------
1 ap320v1.0 2 0000.0000.0000 Enable
0 -110 0
2 00d0.fb88.7812 2 00d0.fb88.7815 Enable
0 -110 0

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.52 show antenna all

Use this command to display antenna status of all APs.
show antenna all

Parameter
Parameter Description
Description
N/A N/A

Defaults N/A

Command Privileged EXEC Mode.

Mode

Usage Guide Use this command to display the antenna status.

Configuration The following example displays the antenna status of all APs.
Examples Ruijie# show antenna all
ap's antenna state R1 R2
R3 R4 R5 R6
ap 0 1 2 3 0 1 2 3 0
1 2 3 0 1 2 3 0 1 2 3 0 1 2 3
---------------------------------------------------------------- -------

4-38
Command Reference WBS Commands

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

APD-M4 -NN- -NY- -
N N - - N N - - - - - - - - -

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.53 show antenna single

Use this command to display antenna status of the specified AP.
show antenna single ap-name

Parameter
Parameter Description
Description
ap-name AP device name.

Defaults N/A

Command Privileged EXEC Mode.

Mode

Usage Guide Use this command to display the antenna status of the specified AP.

Configuration The following example displays the antenna status of “APD-M4”:

Examples
Ruijie# show antenna single APD-M4

ap[APD-M4] antenna state

R1-1: N

R1-2: N

R2-1: N

R2-2: N

R3-1: N

R3-2: N

R4-1: N

R4-2: N

4-39
Command Reference WBS Commands

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.54 show ap-config radio

Use this command to display the radio configuration of all APs .

show ap-config radio

Parameter Parameter Description

Description N/A N/A

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the radio configuration of all AP devices.

Ruijie#show ap-config radio
Show all AP radios:
AP Name MAC Address Radio MAC
Radio MAC
---------------------------------------- -------------------
Configuration
------------------- -------------------
Examples
AP0001 N/A N/A N/A
Field Description
AP Name AP Name
MAC Address AP MAC address
Radio MAC MAC address of odd Radio ID
Radio MAC MAC address of even Radio ID

Related Command Description

Commands N/A N/A

Platform N/A
Description

4-40
Command Reference WBS Commands

4.55 show ap-config radio ap-name

Use this command to display the radio configuration of all APs.

show ap-config radio ap-name ap-name

Parameter Parameter Description

Description ap-name AP device name

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the radio configuration of all APs.

Ruijie#show ap-config radio ap-name
Radio ID Radio Type STA NUM Channel Power Radio Base MAC Status
-------- --------------- -------- -------- ------ --------------- -------
1 802.11b/g/n 10 6* 100 000c.3067.fbd7 Enable
2 802.11a/n/ac 0 149* 100 000c.3067.fbd8 Disable

Configuration
Field Description
Examples
Radio ID RF port ID
Radio Type Radio band
STA NUM STA number
Channel Channel
Power Power
Radio Base MAC MAC address of RF port
Status RF port status

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.56 show ap-config radio config

Use this command to display the radio configuration of the specified AP.

4-41
Command Reference WBS Commands

show ap-config radio radio-id config ap-name

Parameter Description
Parameter
ap-name AP device name
Description
radio-id Radio ID. The range is from 1 to 48.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the radio configuration of the specified AP.
Ruijie# show ap-config radio 1 config 220em
Admin State................................ Enable
Current Tx Power........................... Global
Configuration Num of BSSIDs.............................. 1
Examples DTIM Period................................ 1
Beacon Period(milliseconds)................ 100
Country Code............................... CN
Current Channel............................ Global

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.57 show ap-config radio info

Use this command to display radio information of the specified AP.
show ap-config radio info ap-name

Parameter
Parameter Description
Description
ap-name Specifies an AP

Defaults N/A

Command Privileged EXEC mode

mode

4-42
Command Reference WBS Commands

Usage Guide N/A

Configuration The following example displays radio information of all APs.

Examples Ruijie#show ap-config radio info ap-name
Radio ID Radio Type MU-MIMO Radio Base MAC Status
-------- ------------ ---------- --------------- -------
1 802.11b/g/n Nonsupport 000c.3067.fbd7 Enable
2 802.11a/n/ac Enable 000c.3067.fbd8 Disable

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.58 show ap-config radio radio-id status

Use this command to display details about the radio configuration of the specified AP device.

show ap-config radio radio-id status ap-name

Parameter Description
Parameter
radio-id Radio ID. The range is from 1 to 48.
Description
ap-name AP device name.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays details about the radio configuration of the specified AP.
Ruijie# show ap-config radio 1 s 220em
Admin State.............................. Enable
Oper State............................... Normal
WTP Radio Statistics
Configuration
Last Fail Type.......................... Statistic Not Supported
Examples
Reset Count............................. 0
SW Failure Count........................ 0
HW Failure Count........................ 0
Other Failure Count..................... 0
Unknown Failure Count................... 0

4-43
Command Reference WBS Commands

Config Update Count..................... 0

Channel Change Count.................... 2
Band Change Count....................... 197
Current Noise Floor..................... -102
Assigned WTP BSSID
WLAN ID................................. 0
MAC Address............................. 0000.0000.0000
MIC Countermeasures
WLAN ID................................. 0
MAC Address............................. 0000.0000.0000
RSNA Error Report From Station
Client MAC Address...................... 0000.0000.0000
Radio Base MAC.......................... 0000.0000.0000
Radio ID................................ 1
WLAN ID................................. 0
TKIP ICV Errors......................... 0
TKIP Local MIC Failures................. 0
TKIP Remote MIC Failures................ 0
CCMP Replays............................ 0
CCMP Decrypt Errors..................... 0
TKIP Replays............................ 0
Statistics
Tx Fragment Count....................... 0
Multicast Tx Count...................... 0
Failed Count............................ 0
Retry Count............................. 0
Multiple Retry Count.................... 0
Frame Duplicate Count................... 0
RTS Success Count....................... 0
RTS Failure Count....................... 0
ACK Failure Count....................... 0
Rx Fragment Count....................... 0
Multicast RX Count...................... 0
FCS Error Count......................... 0
Tx Frame Count ......................... 0
Decryption Errors....................... 0
Discarded QoS Fragment Count............ 0
Associated Station Count................ 0
QoS CF Polls Received Count............. 0
QoS CF Polls Unused Count............... 0
QoS CF Polls Unusable Count............. 0
Current Tx Power......................... 100
Current Tx Power Value................... 28
Tx Power Level Num....................... 0

4-44
Command Reference WBS Commands

WebAuth online sta Count..................0

DOT1x online sta Count....................0
Security sta Count........................0
WTP Radio Fail Alarm Indication
Type.................................... Unknown
Status.................................. 0
Pad..................................... 0
WTP Radio Information
Radio Type............................... 802.11b
WTP Radio Config
Short Preamble.......................... 0
Number of BSSIDs........................ 1
DTIM Period............................. 0
Radio Base MAC.......................... 00d0.f822.33da
Beacon Period(milliseconds)............. 100
Country String.......................... CNI
Direct Sequence Control
Current Channel......................... 11
Current CCA............................. 1
Energy Detect Threshold................. 1
MAC Operation
RTS Threshold........................... 2347
Short Retry............................. 7
Long Retry.............................. 4
Fragmentation Threshold................. 2346
Tx MSDU Lifetime........................ 0
Rx MSDU Lifetime........................ 0
Multi-Domain Capability
First Channel........................... 0
Number of Channels...................... 0
Max Tx Power Level...................... 0
OFDM Control
Current Channel......................... 0
Band Supported.......................... 0
TI Threshold............................ 0
Capability
Power Default........................... 28
Power Max............................... 28
Power Min............................... 1
Power Per Default....................... 100
Power Per Max........................... 100
Power Per Min........................... 4

4-45
Command Reference WBS Commands

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.59 show ap-config radio status

Use this command to display the radio list of an AP device.

show ap-config radio status ap-name

Parameter Parameter Description

Description ap-name AP device name.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

The following example displays the radio list of the specified AP.
Ruijie# show ap-config radio status 220em
Radio Slot Radio Type Sub Band Admin Status Oper Status Regulary
Domain Radio Base MAC
----------- --------------- ---------- --------------- ---------------
Configuration
-------------------- --------------------
Examples
1 802.11b/g/n - Enable -
Supported 00d0.f822.33da
2 802.11a/n - Enable - Supported
00d0.f822.33db

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.60 show ap-config summary radio

Use this command to display all APs on the specified radio.
show ap-config summary radio [ radio-id ]

4-46
Command Reference WBS Commands

Parameter
Parameter Description
Description
radio-id Specifies a radio, in the range from 1 to 48.

Defaults N/A

Command Privileged EXEC mode

mode

Usage Guide N/A

Configuration The following example displays all APs on radio 1.

Examples Ruijie#sh ap-config summary radio 1
Ap Name Radio Base MAC STA NUM Radio Type AP IP
---------------------------------------- --------------- -------- ----------
---------------
AP530-I1.01 0014.4b74.d427 0 802.11b
172.18.57.195
AP330-I1.1 0014.4b6d.e18f 8 802.11b
172.18.57.227

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.61 show client details

Use this command to display the information of the specified wireless client.

show client details sta-mac

Parameter Parameter Description

Description sta-mac MAC address of the wireless client. The format is H.H.H.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

Configuration The following example displays the information of wireless client “0025.9c9b.aeb5”.

4-47
Command Reference WBS Commands

Examples Ruijie# show client details 0025.9c9b.aeb5

The Details of Client 0025.9c9b.aeb5:
RSSI.................... 28
SNR..................... -67
AID..................... 1
RX Data................. 51
RX Management........... 0
RX Control.............. 0
RX Unicast.............. 25
RX Multicast............ 0
RX Bytes................ 6174
TX Data................. 3
TX Management........... 0
TX Unicast.............. 3
TX Multicast............ 0
TX Bytes................ 228
TX Probe................ 0
TX Assoc................ 0
TX Assoc Fail........... 0
TX Auth................. 0
TX Auth Fail............ 0
TX Deauth............... 0
TX Disassoc............. 0
Packet Load............. 51216

Related Command Description

Commands N/A N/A

Platform N/A
Description

4.62 show smart bad radio

Use this command to display the bad radio on AP5280.
show smart bad radio

Parameter
Parameter Description
Description
N/A N/A

Defaults N/A

Command Privileged EXEC mode

4-48
Command Reference WBS Commands

mode

Usage Guide N/A

Configuration The following example displays the bad radio on AP5280.

Examples
AC#show smart bad radio

Ap-name ap-mac radio

------------------- --------------- ----------------
AP5280-1 00d0.1234.4565 1,2,3,4,
AP5280-2 00d0.1234.4568 7,8,
Field description
Field Description
Ap name AP Name
Ap-mac AP MAC Address
radio Bad Radio ID

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4.63 update-key-tsc enable

Use this command to enable the AP device to update key TSC during 802.1x reauthentication. Use
the no form of this command to disable the AP device to update the key TSC..
update-key-tsc enable
no update-key-tsc enable

Parameter
Parameter Description
Description
N/A N/A

Defaults N/A

Command AP configuration mode/ AP group configuration mode.

Mode

Usage Guide N/A

Configuration The following example enables the AP device to update key TSC during 802.1x reauthentication.
Examples

4-49
Command Reference WBS Commands

Ruijie(config)# ap-config AP0001

Ruijie(config-ap)# update-key-tsc enable

Related
Command Description
Commands
N/A N/A

Platform N/A
Description

4-50
Command Reference ETH-MNG Commands

5 ETH-MNG Commands

5.1 wired-rate
Use this command to configure the maximum bandwidths for various LAN interfaces and slots.
Fit AP: wired-rate value [ port port-id ]
Fat AP: wired-rate value

Parameter
Parameter Description
Description
Specifies the maximum bandwidth in the unit of 1Mbps. The
value default for AC, AP120-W and AP130-W are 1000, 100 and
1000 respectively.
Specifies the interface, in the range from 1to 4.There is no
port-id
default and this parameter is not available on the fat AP.

Defaults The maximum bandwidths of various LAN interfaces are not limited by default.

Command Modes Fit AP: AP configuration mode/AP group configuration mode

Fat AP: Interface configuration mode

Usage Guide If no port is specified, all LAN port bandwidths are configuredd

Configuration The following example sets the maximum bandwidth for interface0/2of an AP to 50 Mbps.
Examples Ruijie(config)#ap-config [ap-name]
Ruijie(config-ap)# wired-rate 50 interface 2

The following example sets the maximum bandwidth for interface 0/3for all APs to 30 Mbps.
Ruijie(config)#ap-config all
Ruijie(config-ap)# wired-rate 30 interface 3

The following example sets the maximum bandwidth for interface0/1 of an AP group to 80 Mbps.
Ruijie(config)#ap-group default
Ruijie(config-group)#wired-rate 80 port 1
The following example sets the maximum bandwidth for all LAN ports of an AP group to 90 Mbps.
Ruijie(config)#ap-group default
Ruijie(config-group)#wired-rate 90

Related Command Description

Commands show run Displays the current configuration.

5-1
Command Reference ETH-MNG Commands

Platform
N/A
Description

5-2
Command Reference DATA-PLANE Commands

6 DATA-PLANE Commands

6.1 data-plane
Use this command to configure the forwarding weights of different packets.
Use the no form of this command to restore the default setting.
data-plane queue-weight unicast-packet-weight multicast-packet-weight broadcast-packet-weight
unknown-multicast-packet-weight unknown-unicast-packet-weight
no data-plane queue-weight

Use this command to configure the update interval and token rate of token bucket.
Use the no form of this command to restore the default setting.
data-plane token token-interval token-base-rate
no data-plane token

Use this command to enable or disable the wireless broadcast function.

Use the no form of this command to restore the default setting.
data-plane wireless-broadcast { enable | disable }
no data-plane wireless-broadcast

Parameter
Parameter Description
Description
queue-weight Configures the forwarding weights for different packets.
wireless-broadcast Configures the wireless broadcast function.
Sets the forwarding weight of unicast packets. The range is from
unicast-packet-weight
1 to 100. The default value is 16.
Sets the forwarding weight of multicast packets. The range is
multicast-packet-weight
from 1 to 50. The default value is 4.
Sets the forwarding weight of broadcast packets. The range is
broadcast-packet-weight
from 1 to 50. The default value is 2.
Sets the forwarding weight of unknown multicast packets. The
unknown-multicast-packet-weight
range is from 1 to 25. The default value is 1.
Sets the forwarding weight of unknown unicast packets. The
unknown-unicast-packet-weight
range is from 1 to 25. The default value is 1.
token Configures the update interval and token rate of token bucket.
Sets the update interval of the token bucket. The default value is
token-interval
1 in the unit of 10 milliseconds.
Sets the token rate of the token bucket. The default value is 64
token-base-rate
for AC and 5 for AP.

Defaults The forwarding weight configuration for different types of packets is enabled by default.
The wireless broadcast function is disabled by default.

6-1
Command Reference DATA-PLANE Commands

Command Global configuration mode

Modes

Usage Guide N/A

Configuration The following example configures the forwarding weights of different packet types and enables the
Examples wireless broadcast function.
Ruijie(config)#data-plane queue-weight 100 50 50 25 25
Ruijie(config)#data-plane token 10 10
Ruijie(config)#data-plane wireless-broadcast enable

Platform
N/A.
Description

6-2
Command Reference WLOG Commands

7 WLOG Commands

7.1 show wlan diag ap

Use this command to display AP records on an AC.
show wlan diag ap [ ap-mac AP_MAC ] [ number NUMBER ]

Parameter
Parameter Description
Description
AP_MAC Specifies the MAC address of an AP to be displayed.
NUMBER Specifies the maximum number of records to be displayed.

Defaults N/A

Command Privileged EXEC mode

Mode
Usage Guide N/A

Configuration The following example displays AP records.

Examples Ruijie# show wlan diag ap ap-mac 00d0.f822.33b0 number 10

ap_record: ruijieAP[00d0.f822.33b0/1.1.1.2],down/up:2

IP Address:1.1.1.2
2012-05-28 09:30:00 [TIMER] AP UP Time:00:00:18:54
Wired port five in rate/out rate stat:612kbits/sec(in) 1208kbits/sec(out)
Unicast: 84595 bytes(in) 86625 bytes(out)
Multicast: 7 bytes(in) 4 bytes(out)
Broadcast: 2145 bytes(in) 117 bytes(out)
Error Frame:0 bytes(in) 0 bytes(out)
Radio channel power Active STA WEB_Auth DOT1X Rssi ErrorPkt
RetryPkt
-------- ------- ----------- ---------- ---------- ---------- --------
---------- ----------
1 11 100 2 1 0 0 0 0
2 157 100 0 0 0 0 0 0

IP Address:1.1.1.2
2012-05-28 09:49:18 [CW-DOWN] AP UP Time:00:00:38:12
Wired port five in rate/out rate stat:187kbits/sec(in) 905kbits/sec(out)
Unicast: 84789 bytes(in) 86810 bytes(out)
Multicast: 7 bytes(in) 5 bytes(out)
Broadcast: 2148 bytes(in) 133 bytes(out)

7-1
Command Reference WLOG Commands

Error Frame:0 bytes(in) 0 bytes(out)

Radio channel power Active STA WEB_Auth DOT1X Rssi ErrorPkt
RetryCnt
-------- ------- ----------- ---------- ---------- ---------- --------
---------- ----------
1 11 100 2 1 0 0 0 0
2 157 100 0 0 0 0 0 0
CAPWAP DOWN REASON:echo expired

Field Description

ap_record Specifies AP records.

Specifies the IP address of an AP whose information is

IP Address
collected.

TIMER Specifies information collected by a timer.

Specifies information collected when a CAPWAP

CW-DOWN
connection is interrupted.
Specifies the input or output rate on a wired port for the
Wired port five in rate/out rate stat
recent five minutes.
Specifies statistics about unicast packets on a wired
Unicast
port.
Specifies statistics about multicast packets on a wired
Multicast
port.
Specifies statistics about broadcast packets on a wired
Broadcast
port.
Specifies statistics about incorrect frames on a wired
Error Frame
port.

Radio Specifies a radio ID.

channel Specifies the working channel of the radio.

power Specifies the emission frequency of the radio.

Specifies the number of STAs associated with the

Active STA
radio.
Specifies the number of STAs associated with the radio
WEB_AUTH
and get online through the web interface.
Specifies the number of STAs associated with the radio
DOT1X
and get online through 802.1X authentication.
Specifies the number of incorrect frames received by
ErrorPkt
the radio.
Specifies the number of times that packets from the
RetryCnt
radio are retransmitted.
Specifies the reason for CAPWAP disconnection. This
CAPWAP DOWN REASON
item is displayed only when CW_DOWN is set.

7-2
Command Reference WLOG Commands

Related
Command Description
Commands
N/A N/A

Platform This command is supported on AC devices.

Description

7.2 show wlan diag network

Use this command to display the record information about the entire network.
show wlan diag network

Parameter
Parameter Description
Description
N/A N/A

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

Configuration Ruijie# show wlan diag network

Examples Time:2012-05-28 09:10:00
AC uptime: 1 h
Online AP:1
Online AP Version:
PID[AP220-E]:hwver[2.00] AP Number:1
Offline AP:7
ssid Active STA WEB Auth Dot1x Free STA
----------------------------- ---------- ---------- ---------- ----------
1T17-wlog-test1 0 0 0 0
1T17-wlog-test2 0 0 0

Field Description

Time Specifies the time for colleting a record.

AC Running Time Specifies the running time of an AC connection.

Current Online Number of AP Specifies the number of online APs.

Online AP Version Specifies the version of online APs.

Offline Number of AP Specifies the number of pre-configured but offline APs.

ssid Specifies the SSID of a WLAN.

7-3
Command Reference WLOG Commands

Active STA Specifies the total number of active STAs.

Specifies the number of STAs that get online through

WEB Auth
web authentication.
Specifies the number of STAs that get online through
Dot1x
802.1x authentication.

Free STA Specifies the number of STAs free of authentication.

Related
Command Description
Commands
N/A N/A

Platform This command is supported on AC devices.

Description

7.3 show wlan diag sta

Use the following command to display STA statistics on an AC:
show wlan diag sta [ sta-mac STA_MAC ] [ ip-range IP_PREFIX ] [ action ACTION [ result
RESULT ] ] [ number NUMBER ]
Use the following command to display STA statistics on an AP:
show wlan diag sta [ sta-mac STA_MAC ] [ number NUMBER ]

Parameter
Parameter Description
Description
STA_MAC Specifies the MAC address of an STA.
Specifies the range of IP addresses for the STA, which is limited by an IP
IP_PREFIX
prefix.
ACTION Specifies the type of STA action records.
RESULT Specifies the result of STA action records.
NUMBER Specifies the maximum number of records to be displayed.

Defaults N/A

Command Privileged EXEC mode

Mode

Usage Guide N/A

Configuratio This example displays STA statistics on an AC:

n Examples Ruijie# show wlan diag sta
sta_record: c83a.35c6.0c72
TIME IP Address Rssi Link Rate AP MAC SSID
RADIO Action Result Reason

7-4
Command Reference WLOG Commands

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

---------------------------------- --------- -----------------------------
------ ------------------------------
09:59:28 192.168.248.2 0 0 00d0.f822.33b0 lxh-ssid
1 STA UP BY APMG SUCCESS
10:12:07 192.168.248.2 21 5500 00d0.f822.33b0 lxh-ssid
1 STA DOWN BY RSNA SUCCESS AP circular AC user is offline

This example displays STA statistics on an AP:

Ruijie# show wlan diag sta
sta mac: c83a.35c6.0c72
==========================================================================
===============================================================
2012-05-28 19:31:08
wlan id state rssi_rt rs_rate_mcs tx_frm_cnts rx_frm_cnts tx_frm_flow
rx_frm_flow tx_cnts_error tx_flow_error mgmt_cnts mgmt_flow
-------- -------- -------- ----------- ----------- ----------- -----------
----------- ------------- ------------- --------- ---------
1 3 23 80 18 59 4384 5967
0 0 3 381

tx/rxmcs mcs0, mcs1 mcs2, mcs3 mcs4, mcs5 mcs6, mcs7 mcs8, mcs9
mcs10, mcs11 mcs12, mcs13 mcs14, mcs15
------------- ------------- ------------- ------------- -------------
------------- ------------- ------------- -------------
txmcspercent : 0 0 0 0 0 0 0 0
rxmcspercent : 0 0 0 0 0 0 0 0

tx/rxrate 1, 2 5.5, 11 6, 9 12, 18 24, 36 48, 54 -- --

------------- ------- ------- ------- ------- ------- ------- ------- -------
txratepercent: 16 0 0 7 50 27 0 0
rxratepercent: 57 3 0 5 13 22 0 0

Field Description

sta_record Specifies STA records.

TIME Specifies the time when STA records are collected.

Specifies the IP address of an STA whose statistics are

IP Address
collected.

Rssi Specifies signal strength.

Link Rate Specifies a connection rate.

Specifies the MAC address of an AP associated with

AP MAC
the STA.
Specifies the SSID of the WLAN associated with the
SSID
STA.

7-5
Command Reference WLOG Commands

RADIO Specifies the ID of the radio associated with the STA.

Action Specifies the type of STA action records.

Result Specifies the result of STA action records.

Reason Specifies the reason for STA action records.

Related
Command Description
Commands

N/A N/A

Platform This command is supported on ACs and fat AP.

Description

7.4 wlan diag enable

Use this command to enable the WLAN log (WLOG) . Use the no form of this command to disable
WLOG.
wlan diag enable
no wlan diag enable

Parameter
Parameter Description
Description
N/A N/A

Defaults The WLOG function is disabled on ACs and APs.

Command Global configuration mode

Mode

Usage Guide The memory pre-allocation is performed when the WLAN-WLOG function is enabled. If the memory is
insufficient, the WLAN-WLOG function cannot be enabled.
Memories of all saved information and pre-allocated memories are set free when the WLOG function
is disabled.

Configuration The following example enables and disables the WLOG function:
Examples Ruijie# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Ruijie(config)#wlan diag enable
Ruijie(config)#no wlan diag enable

Related
Command Description
Commands

7-6
Command Reference WLOG Commands

N/A N/A

Platform This command is supported on ACs.

Description

7.5 web-server enable api-path assoc-sta url

Use this command to configure the Elog server URL for the associated STA. Use the no form of this
command to remove the setting.
web-server enable api-path assoc-sta url url

Use this command to delete Elog server URLs.

no web-server enable api-path assoc-sta url

Parameter
Parameter Description
Description
url Sets the Elog server URL

Defaults No Elog server is configured by default.

Command Global configuration mode

Mode

Usage Guide N/A

Configuration The following example configures an Elog server URL and removes the settings.
Examples Ruijie# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Ruijie(config)#web-server enable api-path assoc-sta url
http://172.18.155.14:8080/elog/service/dc/updateSta
Ruijie(config)#no web-server enable api-path assoc-sta url
http://172.18.155.14:8080/elog/service/dc/updateSta

Related
Command Description
Commands
N/A N/A

Platform This command is supported on ACs.

Description

7-7