S1720, S2700, S5700, and S6720 V200R011C10 Command Reference
This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
WLAN Mesh Configuration Commands
display mesh-profile
Function
The display mesh-profile command displays reference or configuration information about Mesh profiles.
Usage Guidelines
You can run the display mesh-profile command to view the number of times a Mesh profile is referenced or configuration information of a specified Mesh profile.
Example
# Display reference information about all Mesh profiles.
<HUAWEI> display mesh-profile all
--------------------------------------------------------------------------------
Profile name Reference
--------------------------------------------------------------------------------
default 0
test 2
--------------------------------------------------------------------------------
Total: 2
Item |
Description |
|---|---|
Profile name |
Mesh profile name. To create a Mesh profile, run the mesh-profile command. |
Reference |
Number of times a Mesh profile is referenced. |
# Display information about the Mesh profile test.
<HUAWEI> display mesh-profile name test -------------------------------------------------------------------------------- Mesh handover profile : Security profile : default-mesh Mesh ID : HUAWEI-WLAN-MESH Max link number : 32 Link RSSI threshold(dBm) : -90 Link report interval(s) : 30 Link aging timeout(s) : 60 FWA switch : enable FWA EDCA mode : manual DHCP trust port : enable Priority map trust : DSCP Priority map mode : DSCP map 802.11e 0-7 map 0 8-15 map 1 16-23 map 2 24-31 map 3 32-39 map 4 40-47 map 5 48-55 map 6 56-63 map 7 Client mode : disable Beacon 2.4G rate(Mbps) : 1 Beacon 5G rate(Mbps) : 6 -------------------------------------------------------------------------------- Mesh WMM EDCA client parameters: -------------------------------------------------------------------------------- ECWmax ECWmin AIFSN TXOPLimit AC_VO 10 4 7 0 AC_VI 4 3 2 94 AC_BE 10 4 3 0 AC_BK 10 4 7 0 --------------------------------------------------------------------------------
Item |
Description |
|---|---|
Mesh handover profile |
Mesh handover profile bound to a Mesh profile. To bind a Mesh handover profile to a Mesh profile, run the mesh-handover-profile (Mesh profile view) command. |
Security profile |
Security profile bound to a Mesh profile. To bind a security profile to a Mesh profile, run the security-profile (Mesh profile view) command. |
Mesh ID |
Mesh ID of a Mesh profile. To set a Mesh ID, run the mesh-id command. |
Max link number |
Maximum number of Mesh links allowed on an AP. To set the maximum number of Mesh links, run the max-link-number command. |
Link RSSI threshold |
RSSI threshold of a Mesh link. To set the RSSI threshold of a Mesh link, run the link-rssi-threshold command. |
Link report interval |
Interval for reporting Mesh link information. To set the interval for reporting Mesh link information, run the link-report-interval command. |
Link aging timeout |
Aging time of a Mesh link. To set the aging time of a Mesh link, run the link-aging-time command. |
FWA switch |
FWA status in a Mesh profile.
To configure FWA, run the fwa enable command. |
FWA EDCA mode |
EDCA mode.
To set the EDCA mode, run the fwa wmm edca-mode command. |
DHCP trust port |
Whether to enable a DHCP trusted port in a Mesh profile.
To enable a DHCP trusted port in a Mesh profile, run the dhcp trust port (Mesh profile view) command. |
Priority map trust |
Priority mapping trusted by the Mesh air interface. To configure the parameter, run the priority-map trust (Mesh profile view) command. |
Priority map mode |
Mapping from DSCP priorities to 802.11e user priorities on the Mesh air interface. To configure the parameter, run the priority-map dscp (Mesh profile view) command. |
Client mode |
Whether to enable the Mesh client mode.
|
Beacon-2g-rate |
Transmit rate of 2.4 GHz Beacon frames configured in the WDS profile. To configure the parameter, run the beacon-2g-rate command. |
Beacon-5g-rate |
Transmit rate of 5 GHz Beacon frames configured in the WDS profile. To configure the parameter, run the beacon-5g-rate command. |
AC_VO |
AC_VO packets. |
AC_VI |
AC_VI packets. |
AC_BE |
AC_BE packets. |
AC_BK |
AC_BK packets. |
ECWmax |
Exponent form of the maximum contention window (ECWmax). ECWmin and ECWmax determine the average backoff time. To configure the parameter, run the fwa wmm edca-client command. |
ECWmin |
Exponent form of the minimum contention window (ECWmin). ECWmin and ECWmax determine the average backoff time. To configure the parameter, run the fwa wmm edca-client command. |
AIFSN |
Arbitration inter frame spacing number (AIFSN), which determines the channel idle time. To configure the parameter, run the fwa wmm edca-client command. |
TXOPLimit |
Transmission opportunity limit (TXOPLimit), which determines the maximum duration in which a STA can occupy a channel. A larger TXOPLimit value indicates a longer duration to occupy a channel. To configure the parameter, run the fwa wmm edca-client command. |
display mesh-whitelist-profile
Function
The display mesh-whitelist-profile command displays reference or configuration information about a Mesh whitelist profile.
Usage Guidelines
You can run the display mesh-whitelist-profile command to view the number of times a Mesh whitelist profile is referenced or MAC addresses added in a specified Mesh whitelist profile.
Example
# Display reference information about all Mesh whitelist profiles.
<HUAWEI> display mesh-whitelist-profile all
--------------------------------------------------------------------------------
Profile name Reference
--------------------------------------------------------------------------------
default 0
test 2
--------------------------------------------------------------------------------
Total: 2
Item |
Description |
|---|---|
Profile name |
Name of a Mesh whitelist profile. To create a Mesh whitelist profile, run the mesh-whitelist-profile command. |
Reference |
Number of times a Mesh whitelist profile is referenced. |
# Display information about the Mesh whitelist profile test.
<HUAWEI> display mesh-whitelist-profile name test
--------------------------------------------------------------------------------
Mesh whitelist name: test
Mesh whitelist MAC list information:
--------------------------------------------------------------------------------
Index MAC
--------------------------------------------------------------------------------
0 dcd2-fcf4-64a0
1 e468-a34f-6b00
--------------------------------------------------------------------------------
Total: 2
Item |
Description |
|---|---|
Index |
Mesh whitelist ID in a Mesh whitelist profile. |
MAC |
MAC address on a Mesh whitelist. To add a MAC address to a Mesh whitelist, run the peer-ap mac (Mesh whitelist profile view) command. |
display mesh vap
Format
display mesh vap { ap-group ap-group-name | ap-id ap-id [ radio radio-id ] | ap-name ap-name [ radio radio-id ] } [ mesh-id mesh-id ]
display mesh vap { all | mesh-id mesh-id }
Parameters
Parameter |
Description |
Value |
|---|---|---|
ap-group ap-group-name |
Displays information about all Mesh VAPs in a specified AP group. |
The AP group must exist. |
ap-id ap-id |
Displays information about Mesh VAPs on the AP with a specified ID. |
The AP ID must exist. |
ap-name ap-name |
Displays information about Mesh VAPs on the AP with a specified name. |
The AP name must exist. |
| radio radio-id | Displays information about Mesh VAPs of a specified AP radio. |
The radio ID must exist. |
| mesh-id mesh-id | Displays information about Mesh VAPs of a specified Mesh ID. |
The Mesh ID must exist. |
all |
Displays information about all Mesh VAPs. |
- |
Usage Guidelines
You can run the display mesh vap command to view information about a specified Mesh VAP or all Mesh VAPs.
Example
# Display information about all Mesh VAPs.
<HUAWEI> display mesh vap all
WID : WLAN ID
------------------------------------------------------------------------------------------------
AP ID AP name RfID WID Mesh ID BSSID Auth type Mesh links
------------------------------------------------------------------------------------------------
1 AP2 0 16 mesh 60DE-4474-964F WPA2-PSK 0
0 AP1 0 16 mesh 60DE-4474-964F Open 0
------------------------------------------------------------------------------------------------
Total: 2
Item |
Description |
|---|---|
AP ID |
AP ID. |
AP name |
AP name. |
RfID |
Radio ID. |
WID |
WLAN ID of a VAP. |
Mesh ID |
Mesh ID. To set a Mesh ID, run the mesh-id command. |
BSSID |
MAC address of a VAP. |
Auth type |
Authentication type. |
Mesh links |
Number of Mesh links. |
display references mesh-profile
Function
The display references mesh-profile command displays reference information about a Mesh profile.
Usage Guidelines
You can run the display references mesh-profile command to check reference information about a Mesh profile.
Example
# Display reference information about the Mesh profile test.
<HUAWEI> display references mesh-profile name test
--------------------------------------------------------------------------------
Reference type Reference name Reference radio WLAN ID
--------------------------------------------------------------------------------
AP group test1 Radio-0 16
--------------------------------------------------------------------------------
Total: 1
Item |
Description |
|---|---|
Reference type |
Type of the profile to which the Mesh profile is bound. |
Reference name |
Name of the profile to which the Mesh profile is bound.
|
Reference radio |
AP radio to which a Mesh profile is applied. |
WLAN ID |
WLAN ID to which a Mesh profile is bound. |
display references mesh-whitelist-profile
Function
The display references mesh-whitelist-profile command displays reference information about a Mesh whitelist profile.
Usage Guidelines
You can run the display references mesh-whitelist-profile command to check reference information about a specified Mesh whitelist profile.
Example
# Display reference information about the Mesh whitelist profile test.
<HUAWEI> display references mesh-whitelist-profile name test
--------------------------------------------------------------------------------
Reference type Reference name
--------------------------------------------------------------------------------
AP group default
--------------------------------------------------------------------------------
Total: 1
Item |
Description |
|---|---|
Reference type |
Type of the profile by which a Mesh whitelist profile is referenced. |
Reference name |
Name of the profile by which a Mesh whitelist profile is referenced. To bind a Mesh whitelist profile to a Mesh profile, run the mesh-whitelist-profile (AP group radio view or AP radio view) command in the Mesh profile view. |
display wlan mesh link
Format
display wlan mesh link { all | ap-id ap-id [ radio radio-id ] | ap-name ap-name [ radio radio-id ] | mesh-profile profile-name }
Parameters
Parameter |
Description |
Value |
|---|---|---|
all |
Displays information about all Mesh links. |
- |
ap-id ap-id |
Displays information about Mesh links on the AP with a specified ID. |
The AP ID must exist. |
ap-name ap-name |
Displays information about Mesh links on the AP with a specified name. |
The AP name must exist. |
| radio radio-id | Displays information about Mesh links of a specified AP radio. |
The radio ID must exist. |
| mesh-profile profile-name | Displays information about Mesh links in a specified Mesh profile. |
The Mesh profile must exist. |
Usage Guidelines
You can run the display wlan mesh link command to view information about a Mesh link.
Example
# Display information about all Mesh links.
<HUAWEI> display wlan mesh link all
Rf : radio ID Dis : coverage distance(100m)
Ch : channel Per : drop percent(%)
TSNR : total SNR(dB) P- : peer
Mesh : Mesh mode Re : retry ratio(%)
RSSI : RSSI(dBm) MaxR : max RSSI(dBm)
----------------------------------------------------------------------------------------------------------------------------------
APName P-APName P-APMAC Rf Dis Ch Mesh P-Status RSSI MaxR Per Re TSNR SNR(Ch0~3:dB)
----------------------------------------------------------------------------------------------------------------------------------
a858-40dd-ef80 area_2 dcd2-fc04-b500 0 3 6 node normal -40 -20 1 17 59 56/55/-/-
area_2 a858-40dd-ef80 a858-40dd-ef80 0 3 6 portal normal -48 -7 0 18 45 34/35/44/-
----------------------------------------------------------------------------------------------------------------------------------
Total: 2
Item |
Description |
|---|---|
APName |
Name of the local AP. |
P-APMAC |
MAC address of the peer AP. |
P-APName |
Name of the peer AP. |
Rf |
Radio ID of the local AP. |
Dis |
Radio coverage distance parameter of the local AP. |
Ch |
Working channel of a Mesh link. |
Mesh |
Mesh role of the local AP. |
P-Status |
Status of the peer AP. |
RSSI |
RSSI of the peer AP. |
MaxR |
Maximum RSSI threshold of a Mesh link. |
Per |
Packet error ratio of a Mesh link. |
Re |
Packet retransmission ratio of a Mesh link. |
TSNR |
Total SNR of Mesh links. |
SNR(Ch0~3:dB) |
SNR of each spatial stream of a Mesh link. |
display wlan mesh route
Parameters
| Parameter | Description | Value |
|---|---|---|
| ap-id | Displays routing information of the AP with a specified ID on a Mesh network. |
The AP ID must exist. |
| ap-name | Displays routing information of the AP with a specified name on a Mesh network. |
The AP name must exist. |
| all | Displays all APs' routing information on a Mesh network. |
- |
Usage Guidelines
You can use this command to view specified or all APs' routing information on a Mesh network, which helps you locate faults on the Mesh network.
Example
# Display all APs' routing information on a Mesh network.
<HUAWEI> display wlan mesh route all
-------------------------------------------------------------------------------
AP name/MAC/Mesh role/Radio Next-hop name/MAC/Mesh role/Radio
-------------------------------------------------------------------------------
ap1/60de-4474-9640/MP/0 ap2/60de-4476-e360/MPP/0
-------------------------------------------------------------------------------
Total: 1
fwa wmm edca-client
Function
The fwa wmm edca-client command configures EDCA parameters used by the remote AP to negotiate with the AT.
The undo fwa wmm edca-client command restores the default EDCA parameters used by the remote AP to negotiate with the AT.
Format
fwa wmm edca-client { ac-vo | ac-vi | ac-be | ac-bk } { aifsn aifsn-value | ecw ecwmin ecwmin-value ecwmax ecwmax-value | txoplimit txoplimit-value } *
undo fwa wmm edca-client
Parameters
Parameter |
Description |
Value |
|---|---|---|
ac-vo |
Indicates AC_VO packets. |
- |
ac-vi |
Indicates AC_VI packets. |
- |
ac-be |
Indicates AC_BE packets. |
- |
ac-bk |
Indicates AC_BK packets. |
- |
aifsn aifsn-value |
Specifies the arbitration inter frame spacing number (AIFSN), which determines the channel idle time. |
The value is an integer that ranges from 1 to 15. |
ecwmin ecwmin-value |
Specifies the exponent form of the minimum contention window. ecwmin-value and ecwmax-value determine the average backoff time. |
The value is an integer that ranges from 0 to 15 and must be smaller than the ecwmax-value value. |
ecwmax ecwmax-value |
Specifies the exponent form of the maximum contention window. ecwmin-value and ecwmax-value determine the average backoff time. |
The value is an integer that ranges from 0 to 15 and must be greater than the ecwmin-value value. |
txoplimit txoplimit-value |
Specifies the transmission opportunity limit (TXOPLimit), which determines the maximum duration in which a STA can occupy a channel. A larger TXOPLimit value indicates a longer duration to occupy a channel. |
The value is an integer that ranges from 0 to 255. The unit is 32 microseconds.
NOTE:
If the TXOPLimit value is 0, the STA can send only one data frame every time it occupies a channel. |
Usage Guidelines
Usage Scenario
WMM classifies data packets into the following access categories (ACs): AC_VO, AC_VI, AC_BE, and AC_BK. A set of EDCA parameters is set for each AC queue. These parameters determine the capabilities of a queue to occupy a channel. You can set EDCA parameters for packets of different ACs to provide differentiated priorities to the packets and different capabilities to compete for channels. In this way, differentiated services are implemented.
Parameter |
Meaning |
|---|---|
Arbitration Interframe Spacing Number (AIFSN) |
The DIFS has a fixed value. WMM provides different DIFS values for different ACs. A large AIFSN value means that the STA must wait for a long time and has a low priority. |
Exponent form of CWmin (ECWmin) and exponent form of CWmax (ECWmax) |
ECWmin specifies the minimum backoff time, and ECWmax specifies the maximum backoff time. Together, they determine the average backoff time. Large ECWmin and ECWmax values mean a long average backoff time for the STA and a low STA priority. |
Transmission Opportunity Limit (TXOPLimit) |
After preempting a channel, the STA can occupy the channel within the period of TXOPLimit. A large TXOPLimit value means that the STA can occupy the channel for a long time. If the TXOPLimit value is 0, the STA can only send one data frame every time it preempts a channel. |
Precautions
- The EDCA parameters configured using the fwa wmm edca-client command take effect only after you set the EDCA mode to manual mode using the fwa wmm edca-mode manual command.
- By default, queues of AC_VO, AC_VI, AC_BE, and AC_BK are in descending order of priority. Priorities of the four queues are determined by their EDCA parameters.
| Packet Type | Parameters | Description |
|---|---|---|
| AC_VO | ECWmax | 4 |
| ECWmin | 2 | |
| AIFSN | 2 | |
| TXOPLimit | 0 | |
| AC_VI | ECWmax | 5 |
| ECWmin | 3 | |
| AIFSN | 5 | |
| TXOPLimit | 0 | |
| AC_BE | ECWmax | 10 |
| ECWmin | 6 | |
| AIFSN | 5 | |
| TXOPLimit | 0 | |
| AC_BK | ECWmax | 10 |
| ECWmin | 8 | |
| AIFSN | 12 | |
| TXOPLimit | 0 |
| Packet Type | Parameters | Description |
|---|---|---|
| AC_VO | ECWmax | 4 |
| ECWmin | 2 | |
| AIFSN | 2 | |
| TXOPLimit | 0 | |
| AC_VI | ECWmax | 5 |
| ECWmin | 3 | |
| AIFSN | 5 | |
| TXOPLimit | 0 | |
| AC_BE | ECWmax | 10 |
| ECWmin | 6 | |
| AIFSN | 12 | |
| TXOPLimit | 0 | |
| AC_BK | ECWmax | 10 |
| ECWmin | 8 | |
| AIFSN | 12 | |
| TXOPLimit | 0 |
Example
# Configure EDCA parameters of AC_VO packets used by the remote AP to negotiate with the AT.
<HUAWEI> system-view [HUAWEI] wlan [HUAWEI-wlan-view] mesh-profile name test [HUAWEI-wlan-mesh-prof-test] fwa wmm edca-mode manual [HUAWEI-wlan-mesh-prof-test] fwa wmm edca-client ac-vo aifsn 7 ecw ecwmin 4 ecwmax 10 txoplimit 0
fwa wmm edca-mode
Parameters
Parameter |
Description |
Value |
|---|---|---|
auto |
Sets the EDCA mode to auto. In automatic EDCA mode, ATs automatically adjust EDCA parameters based on the number of ATs connecting to the remote AP. |
- |
manual |
Sets the EDCA mode to manual. In manual mode, you can run the fwa wmm edca-client command to configure EDCA parameters of the AT. The remote AP negotiates with the AT according to the configured parameters. |
- |
Usage Guidelines
Usage Scenario
In scenarios where the AT connects to the remote AP through Mesh links, ATs automatically adjust EDCA parameters based on the number of ATs connecting to the remote AP. In manual mode, you can run the fwa wmm edca-client command to configure EDCA parameters of the AT. The remote AP negotiates with the AT according to the configured parameters.
- The fwa wmm edca-mode command takes effect only after the FWA mode is enabled in the Mesh profile using the fwa enable command.
- In automatic EDCA mode, the EDCA parameters manually configured using the fwa wmm edca-client command do not take effect on the AP.
- This command applies only to scenarios where the AT connects to the remote AP through Mesh links.
fwa enable
Usage Guidelines
Usage Scenario
An outdoor Access Terminal (AT) needs to set up a Mesh link with a remote AP to provide network access for the connected users. You need to configure Mesh service on the remote AP and enable Fixed Wireless Access (FWA) in the Mesh profile so that the AT can connect to the remote AP.
Configuration Impact
FWA and vehicle-ground fast link handover are mutually exclusive in a Mesh profile.
After you enable FWA for a Mesh profile using the fwa enable command, the default value of link-num in the max-link-number link-num command is 32, and the value ranges from 1 to 32.
After you enable FWA in a Mesh profile using the fwa enable command, the RSSI threshold of a Mesh link is fixed as -90 dBm, and not changed by the link-rssi-threshold command.
After you enable FWA in a Mesh profile using the fwa enable command, you can complete Mesh service configuration without the need to bind a Mesh whitelist profile to the Mesh profile.
After you enable FWA for a Mesh profile using the fwa enable command, the radio bound to the Mesh profile allows access from only ATs. Do not enable FWA when ATs are not used to prevent a Mesh service configuration failure.
Example
# Enable FWA for the Mesh profile named test.
<HUAWEI> system-view [HUAWEI] wlan [HUAWEI-wlan-view] mesh-profile name test [HUAWEI-wlan-mesh-prof-test] fwa enable
<HUAWEI> system-view [HUAWEI] wlan [HUAWEI-wlan-view] mesh-profile name test [HUAWEI-wlan-mesh-prof-test] undo fwa enable
link-aging-time
Usage Guidelines
If a Mesh node cannot receive keepalive packets from a neighboring node for a period of time greater than or equal to the aging time of a Mesh link, the Mesh node considers the Mesh link disconnected and will reselect a link.
In a fast changing radio environment, if the aging time of a Mesh link is set to a small value, Mesh links may be frequently disconnected or reselected, causing network flapping. If the aging time of a Mesh link is set to a large value, a Mesh node cannot reselect Mesh links in a timely manner, causing service interruption. Therefore, you need to configure a proper aging time for Mesh links based on actual situations.
link-report-interval
Function
The link-report-interval command sets the interval at which an MP reports Mesh link information to the AC.
The undo link-report-interval command restores the default interval at which an MP reports Mesh link information to the AC.
By default, an MP reports Mesh link information to the AC at an interval of 30 seconds.
Usage Guidelines
Usage Scenario
When the network is unstable, an MP may frequently send Mesh link establishment or teardown information to the AC, affecting AC's processing of user services. To solve this problem, run the link-report-interval command to configure an MP to periodically send Mesh link information to the AC. After the command is executed, the MP sends link information to the AC only at specified intervals, ensuring normal processing of user services.
link-rssi-threshold
Function
The link-rssi-threshold command sets the received signal strength indicator (RSSI) threshold of a mesh link.
The undo link-rssi-threshold command restores the default RSSI threshold of a mesh link.
By default, the RSSI threshold of a mesh link is -75 dBm. After the FWA mode is enabled in a Mesh profile, the RSSI threshold of a Mesh link is fixed as -90 dBm.
Usage Guidelines
Usage Scenario
The RSSI threshold of a mesh link indicates the minimum RSSI of the mesh link. If the RSSI of an MP that joins a WMN is lower than the RSSI threshold configured using the link-rssi-threshold command, the routing information table of the mesh link is updated and routing information about the MP is deleted.
The RSSI threshold of a mesh link depends on the distance between two MPs that establish the mesh link. If the two MPs are far from each other, a smaller RSSI threshold is recommended. If the two MPs are close to each other, a larger RSSI threshold is recommended.
max-link-number
Function
The max-link-number command sets the maximum number of mesh links that can be established between APs.
The undo max-link-number command restores the default maximum number of mesh links that can be established between APs.
By default, a maximum of eight mesh links can be established between APs. After you enable FWA for a mesh profile using the fwa enable command, a maximum of 32 mesh links can be established between APs by default.
Parameters
Parameter |
Description |
Value |
|---|---|---|
link-num |
Specifies the maximum number of mesh links that can be established between APs. |
The value is an integer that ranges from 1 to 32. NOTE:
After you enable FWA for a mesh profile using the fwa enable command, the default value of link-num is 32, and the value ranges from 1 to 32. |
Usage Guidelines
Usage Scenario
When an AP sets up too many Mesh links with neighboring APs, network indicators, such as the throughput cannot meet customer needs, affecting user experience. To improve user experience, you can run the max-link-number command to set the maximum number of mesh links that can be established between APs according to actual situations.
Impact
If the number of mesh links of an AP has reached the maximum, the AP does not set up new Mesh links with neighboring APs.
mesh-id
Usage Guidelines
The Mesh ID of a Mesh profile is similar to the SSID. On a Mesh network, AP radios discover available Mesh services of other APs based on the Mesh ID.
Each Mesh profile must have a Mesh ID. The default Mesh ID of a Mesh profile is HUAWEI-WLAN-MESH. You can run the mesh-id command to set a Mesh ID for a Mesh profile.
mesh-profile
Parameters
Parameter |
Description |
Value |
|---|---|---|
name profile-name |
Specifies the name of a Mesh profile. |
The value is a string of 1 to 35 case-insensitive characters. It does not contain question marks (?) or spaces, and cannot start or end with double quotation marks (" "). |
all |
Deletes all Mesh profiles. NOTE:
The Mesh profile default cannot be deleted. |
- |
Usage Guidelines
Usage Scenario
After a Mesh profile is applied to an AP radio, Mesh VAPs are created on the radio.
Each Mesh profile must have a Mesh ID. The default Mesh ID of a Mesh profile is HUAWEI-WLAN-MESH. You can run the mesh-id command to set a Mesh ID for a Mesh profile.
mesh-profile radio
Format
mesh-profile profile-name radio { all | radio-id }
undo mesh-profile radio { all | radio-id }
Usage Guidelines
Usage Scenario
After a Mesh profile is bound to an AP group or AP, a Mesh VAP will be generated on AP radios to provide Mesh services for users.
Prerequisites
A Mesh profile has been created and properly configured.
Precautions
Among the VAPs created after a Mesh profile is bound to a radio, the VAP with the WLAN ID 16 cannot be occupied.
An AP radio can only have one Mesh profile bound.
On a triple-radio AP, radio 2 does not support the Mesh function.
Since the WLAN WDS and Mesh functions are mutually exclusive, the WDS and Mesh profiles cannot be applied to an AP radio at the same time.
mesh-profile (AP group radio view or AP radio view)
Usage Guidelines
Usage Scenario
After a Mesh profile is bound to an AP group radio or an AP radio, a Mesh VAP will be generated on the specified AP radio to provide Mesh services for users.
Prerequisites
A Mesh profile has been created and properly configured.
Precautions
Among the VAPs created after a Mesh profile is bound to a radio, the VAP with the WLAN ID 16 cannot be occupied.
An AP radio can only have one Mesh profile bound.
On a triple-radio AP, radio 2 does not support the Mesh function.
This command has the same function as the mesh-profile radio command. You can use either of them.
mesh-role
Usage Guidelines
- MP (mesh-node): Any Mesh points (MPs) that can support AP functions. They provide both Mesh service and user access service.
- MPP (mesh-portal): Mesh points that connect the Mesh network to other types of networks and forward communication traffic on a Mesh network.
Configure Mesh roles of APs according to service requirements. If an AP needs to provide Mesh and user access services, set the Mesh role of the AP to mesh-node. If an AP is located at Mesh network ingress or needs to connect MPs to external networks, set the Mesh role of the AP to mesh-portal.
mesh-whitelist-profile
Format
mesh-whitelist-profile name whitelist-name
undo mesh-whitelist-profile { all | name whitelist-name }
Parameters
Parameter |
Description |
Value |
|---|---|---|
name whitelist-name |
Specifies the name of a Mesh whitelist profile. |
The value is a string of 1 to 35 case-insensitive characters. It does not contain question marks (?) or spaces, and cannot start or end with double quotation marks (" "). |
all |
Deletes all Mesh whitelist profiles. |
- |
Usage Guidelines
After a Mesh whitelist profile is created, run the peer-ap mac (Mesh whitelist profile view) command in the Mesh whitelist profile view to add MAC addresses of the allowed peer APs to the profile.
Example
# Create the Mesh whitelist profile whitelist and add the MAC address 0001-0001-0001 to the whitelist profile. Bind the Mesh whitelist profile whitelist to radio 0 of APs in the AP group group1.
<HUAWEI> system-view [HUAWEI] wlan [HUAWEI-wlan-view] mesh-whitelist-profile name whitelist [HUAWEI-wlan-mesh-whitelist-whitelist] peer-ap mac 0001-0001-0001 [HUAWEI-wlan-mesh-whitelist-whitelist] quit [HUAWEI-wlan-view] ap-group name group1 [HUAWEI-wlan-ap-group-group1] radio 0 [HUAWEI-wlan-group-radio-group1/0] mesh-whitelist-profile whitelist
mesh-whitelist-profile (AP group radio view or AP radio view)
Usage Guidelines
After a Mesh whitelist profile is applied to an AP radio, the AP radio can only set up Mesh links with neighboring APs whose MAC addresses are in the Mesh whitelist profile.
An AP radio can only have one Mesh whitelist profile bound. If you run the command multiple times on the same AP radio, the latest configuration overwrites the old one.
On a triple-radio AP, radio 2 does not support the Mesh function.
Example
# Create the Mesh whitelist profile whitelist and add the MAC address 0001-0001-0001 to the whitelist profile. Bind the Mesh whitelist profile whitelist to radio 0 of APs in the AP group group1.
<HUAWEI> system-view [HUAWEI] wlan [HUAWEI-wlan-view] mesh-whitelist-profile name whitelist [HUAWEI-wlan-mesh-whitelist-whitelist] peer-ap mac 0001-0001-0001 [HUAWEI-wlan-mesh-whitelist-whitelist] quit [HUAWEI-wlan-view] ap-group name group1 [HUAWEI-wlan-ap-group-group1] radio 0 [HUAWEI-wlan-group-radio-group1/0] mesh-whitelist-profile whitelist
mpp-active-reselection enable
Usage Guidelines
Usage Scenario
After active MPP reselection is enabled on an MP, the MP evaluates MPPs of the same Mesh ID and on the same channel based on the signal strength of Mesh links, and the numbers of link hops and Mesh links. If a more preferable MPP is available, the MP selects the MPP as its Mesh gateway.
By default, active MPP reselection is disabled, and an MP can only passively reselect MPPs. Only when the minimum RSSI of all Mesh links on the optimal route to the current MPP is lower than the RSSI threshold of a Mesh link, the MP triggers the MPP reselection process.
Precautions
The configuration does not take effect on MPPs or vehicle-mounted APs in train-ground communication scenarios because the vehicle-mounted APs select MPPs based on the fast link handover algorithm.
Active MPP reselection will cause service loss. Configure the function according to actual needs.
peer-ap mac (Mesh whitelist profile view)
Function
The peer-ap mac command adds MAC addresses of neighboring APs that are allowed to connect to an AP to a Mesh whitelist profile.
The undo peer-ap mac command deletes the MAC addresses of neighboring APs from a Mesh whitelist profile.
By default, no MAC address of a neighboring AP is added to a Mesh whitelist profile.
Usage Guidelines
Usage Scenario
After a Mesh whitelist profile is created, you can run the peer-ap mac command to add neighboring APs' MAC addresses to the profile.
If a Mesh whitelist profile is bound to a Mesh profile, only APs with MAC addresses in the Mesh whitelist profile can access the local AP, and other APs are denied access.
Precautions
The maximum number of MAC addresses in the Mesh whitelist is 64.
Example
# Create the Mesh whitelist profile whitelist and add the MAC address 0001-0001-0001 to the whitelist profile. Bind the Mesh whitelist profile whitelist to radio 0 of APs in the AP group group1.
<HUAWEI> system-view [HUAWEI] wlan [HUAWEI-wlan-view] mesh-whitelist-profile name whitelist [HUAWEI-wlan-mesh-whitelist-whitelist] peer-ap mac 0001-0001-0001 [HUAWEI-wlan-mesh-whitelist-whitelist] quit [HUAWEI-wlan-view] ap-group name group1 [HUAWEI-wlan-ap-group-group1] radio 0 [HUAWEI-wlan-group-radio-group1/0] mesh-whitelist-profile whitelist
priority-map dscp (Mesh profile view)
Function
The priority-map dscp command configures the mapping from DSCP priorities to 802.11e user priorities on the Mesh air interface.
The undo priority-map dscp command restores the default mapping from DSCP priorities to 802.11e user priorities on the Mesh air interface.
Format
priority-map dscp { dscp-value1 [ to dscp-value2 ] } &<1-10> dot11e dot11e-value
undo priority-map dscp
Parameters
Parameter |
Description |
Value |
|---|---|---|
dscp dscp-value1 |
Specifies the DSCP priority of 802.3 packets. |
The value is an integer that ranges from 0 to 63. A larger value indicates a higher priority. |
to dscp-value2 |
Specifies the DSCP priority of 802.3 packets. |
The value is an integer that ranges from 0 to 63. A larger value indicates a higher priority. |
dot11e dot11e-value |
Specifies the 802.11e user priority. |
The value is an integer that ranges from 0 to 7. A larger value indicates a higher priority. |
priority-map trust (Mesh profile view)
Function
The priority-map trust command configures the priority mapping to be trusted by the Mesh air interface.
The undo priority-map trust command restores the default priority mapping to be trusted by the Mesh air interface.
By default, the Mesh air interface trusts the mapping from DSCP priorities to 802.11e user priorities.
security-profile (Mesh profile view)
Usage Guidelines
Usage Scenario
Before a Mesh profile is applied to an AP radio to establish Mesh links, the Mesh profile must have a security profile bound to ensure Mesh link security.
Precautions
After a security profile is bound to a Mesh profile, the authentication policy and encryption mode in the security profile cannot be changed, but the authentication key can be changed.
A Mesh profile can only have one security profile bound. If you run the command multiple times in the same Mesh profile view, the latest configuration overwrites the old one.
Example
# Create the security profile sec and set the security policy to WPA2+PSK+AES. Create the Mesh profile test and bind the security profile to the Mesh profile.
<HUAWEI> system-view [HUAWEI] wlan [HUAWEI-wlan-view] security-profile name sec [HUAWEI-wlan-sec-prof-sec] security wpa2 psk pass-phrase huawei@123 aes [HUAWEI-wlan-sec-prof-sec] quit [HUAWEI-wlan-view] mesh-profile name test [HUAWEI-wlan-mesh-prof-test] security-profile sec Warning: This action may cause service interruption. Continue?[Y/N]y
wideband enable
Function
The wideband enable command enables the wideband function, that is, the 4.9 GHz frequency band, of the regulatory domain profile.
The undo wideband enable command disables the wideband function, that is, the 4.9 GHz frequency band, of the regulatory domain profile.
By default, the wideband function of the regulatory domain profile is disabled.
Only the AP8130DN-W support the 4.9 GHz frequency band.
Usage Guidelines
The wideband function enables AP radios on the 5 GHz frequency band to use the 4.9 GHz frequency band. The 4.9 GHz frequency band is applicable to outdoor backhaul scenarios but not wireless coverage services. It is mainly used by WDS and Mesh backhaul links. The 4.9 GHz frequency band is out of the channel range reselected using DFS.
| Channel No. | Parameters | Description |
|---|---|---|
| 184 | Frequency Band | 4.9G |
| Center Frequency (MHz) | 4920 | |
| Upper Frequency (MHz) | 4910 | |
| Lower Frequency (MHz) | 4930 | |
| 188 | Frequency Band | 4.9G |
| Center Frequency (MHz) | 4940 | |
| Upper Frequency (MHz) | 4930 | |
| Lower Frequency (MHz) | 4950 | |
| 192 | Frequency Band | 4.9G |
| Center Frequency (MHz) | 4960 | |
| Upper Frequency (MHz) | 4950 | |
| Lower Frequency (MHz) | 4970 | |
| 196 | Frequency Band | 4.9G |
| Center Frequency (MHz) | 4980 | |
| Upper Frequency (MHz) | 4970 | |
| Lower Frequency (MHz) | 4990 |
The 4.9 GHz frequency band supports channel bandwidths of 20 MHz and 40 MHz. Channels 184+188 or 192+196 can be bundled into a 40 MHz channel. Similar to the 5 GHz frequency band, the 4.9 GHz frequency band complies with 802.11a/n/ac.
After the wideband function of the regulatory domain profile is enabled, APs bound to this profile are automatically reset.
Example
# Enable the wideband function of the regulatory domain profile.
<HUAWEI> system-view [HUAWEI] wlan [HUAWEI-wlan-view] regulatory-domain-profile name huawei [HUAWEI-wlan-regulate-domain-huawei] wideband enable Warning: To use the 4.9 GHz frequency band, you must apply for a license from th e related dept. When the 4.9 GHz frequency band takes effect, the AP will be res et. Continue? [Y/N]y Info: This operation may take a few seconds. Please wait for a moment.done.
- Command Support
- dhcp trust port (Mesh profile view)
- display mesh-profile
- display mesh-whitelist-profile
- display mesh vap
- display references mesh-profile
- display references mesh-whitelist-profile
- display wlan mesh link
- display wlan mesh route
- fwa wmm edca-client
- fwa wmm edca-mode
- fwa enable
- link-aging-time
- link-report-interval
- link-rssi-threshold
- max-link-number
- mesh-id
- mesh-profile
- mesh-profile radio
- mesh-profile (AP group radio view or AP radio view)
- mesh-role
- mesh-whitelist-profile
- mesh-whitelist-profile (AP group radio view or AP radio view)
- mpp-active-reselection enable
- peer-ap mac (Mesh whitelist profile view)
- priority-map dscp (Mesh profile view)
- priority-map trust (Mesh profile view)
- security-profile (Mesh profile view)
- wideband enable