11-WLAN Advanced Features Command Reference

HomeSupportResource CenterH3C FAT AP Command References(R5436)-6W10111-WLAN Advanced Features Command Reference
01-WLAN optimization commands
Title Size Download
01-WLAN optimization commands 103.68 KB

WLAN optimization commands

IMPORTANT

IMPORTANT:

Use WLAN optimization commands under the guidance of H3C Support.

 

option 4-way-handshake resend

Use option 4-way-handshake resend to set the maximum number of retransmissions for an EAPOL-Key packet and the retransmission interval.

Use undo option 4-way-handshake resend to restore the default.

Syntax

option 4-way-handshake resend max-count [ interval interval ]

undo option 4-way-handshake resend

Default

The maximum number of retransmissions for an EAPOL-Key packet is three, and the retransmission interval is 300 milliseconds.

Views

Service template view

Predefined user roles

network-admin

Parameters

resend max-count: Specifies the maximum number of retransmissions for an EAPOL-Key packet, in the range of 0 to 3.

interval interval: Specifies the retransmission interval in the range of 200 to 500 milliseconds.

Usage guidelines

In Robust Security Network Association (RSNA) authentication, an AP and a client use EAPOL-Key packets in the four-way handshake to negotiate the keys. After that, the AP and the client periodically exchange EAPOL-Key packets to update the keys.

During key negotiation or update, the AP keeps retransmitting an EAPOL-Key packet until a response is received or the maximum number of retries for an EAPOL-Key packet is reached.

The system starts to count the retries when the maximum number of retransmissions is reached.

To ensure successful RSN key negotiation or update, you can increase the maximum number of retransmissions and the maximum number of retries for an EAPOL-Key packet.

For more information about RSN key negotiation or update, see "Configuring WLAN security."

Examples

# In service template view, set the maximum number of retransmissions for an EAPOL-Key packet to one and the retransmission interval to 400 milliseconds.

<Sysname> system-view

[Sysname] wlan service-template service1

[Sysname-wlan-st-svervice1] option 4-way-handshake resend 1 interval 400

Related commands

option 4-way-handshake retry

option 4-way-handshake retry

Use option 4-way-handshake retry to set the maximum number of retries for an EAPOL-Key packet and the retry interval.

Use undo option 4-way-handshake retry to restore the default.

Syntax

option 4-way-handshake retry max-count [ interval interval ]

undo option 4-way-handshake retry

Default

The maximum number of retries for an EAPOL-Key packet is three, and the retry interval is 5 seconds.

Views

Service template view

Predefined user roles

network-admin

Parameters

retry max-count: Specifies the maximum number of retries for an EAPOL-Key packet, in the range of 0 to 3.

interval interval: Specifies the retry interval in the range of 2 to 5 seconds.

Usage guidelines

During RSN key negotiation or update, an AP keeps retransmitting an EAPOL-Key packet until a response is received or the maximum number of retries for an EAPOL-Key packet is reached.

The system starts to count the retries when the maximum number of retransmissions is reached.

If you execute this command for multiple times, the most recent configuration takes effect.

Examples

# In service template view, set the maximum number of retries for an EAPOL-Key packet to two and the retry interval to 3 seconds.

<Sysname> system-view

[Sysname] wlan service-template service1

[Sysname-wlan-st-service1] option 4-way-handshake retry 2 interval 3

Related commands

option 4-way-handshake resend

option broadcast-multicast-buffer

Use option broadcast-multicast-buffer enable to enable multicast and broadcast buffering.

Use option broadcast-multicast-buffer disable to disable multicast and broadcast buffering.

Use undo option broadcast-multicast-buffer to restore the default.

Syntax

option broadcast-multicast-buffer { disable | enable [ limit limit ] }

undo option broadcast-multicast-buffer

Default

Multicast and broadcast buffering is enabled.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

limit limit: Specifies the maximum number of multicast or broadcast packets that can be buffered. The value range for the limit argument is 1 to 600 and the default value is 100.

Usage guidelines

With this feature enabled, the AC stops sending broadcast and multicast packets and buffers them if an associated client is in sleep state. This mechanism affects the performance of real-time multicast applications.

With this feature disabled, the AC directly sends all broadcast and multicast packets regardless of whether an associated client is in sleep state.

Examples

# Disable multicast and broadcast buffering.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] option broadcast-multicast-buffer disable

option capacity-adjust

Use option capacity-adjust enable to enable transmit power adjustment.

Use option capacity-adjust disable to disable transmit power adjustment.

Use undo capacity-adjust to restore the default.

Syntax

option capacity-adjust { disable | enable [ all ] { increase | decrease } value }

undo option capacity-adjust

Default

Transmit power adjustment is disabled.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

all: Configures transmit power adjustment for all rates. If you do not specify this keyword, the command configures transmit power adjustment for mandatory rates.

increase: Increases the transmit power.

decrease: Decreases the transmit power.

value: Specifies the transmit power adjustment value in the range of 1 to 27 dBm.

Usage guidelines

This feature enables an AP to use the adjusted transmit power to transmit packets.

Examples

# Enable transmit power adjustment and increase the transmit power by 1 dBm for all rates.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] option capacity-adjust all increase 1

option channel-reuse-optimization

Use option channel-reuse-optimization enable to enable channel reuse.

Use option channel-reuse-optimization disable to disable channel reuse.

Use undo option channel-reuse-optimization to restore the default.

Syntax

option channel-reuse-optimization { disable | enable level level }

undo option channel-reuse-optimization

Default

Channel reuse is disabled.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

level level: Specifies the channel reuse level in the range of 1 to 10. The recommended channel reuse level is 6.

Usage guidelines

This feature enables an AP to ignore packets with a signal strength lower than the specified channel reuse level. This mechanism enables the AP to obtain more radio resources and improves the performance of APs working on the same channel.

Examples

# Enable channel reuse and set the channel reuse level to 5.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] option channel-reuse-optimization enable level 5

option channel-share

Use option channel-share enable to enable channel sharing.

Use option channel-share disable to disable channel sharing.

Use undo channel-share to restore the default.

Syntax

option channel-share { disable | enable power-level power-level }

undo channel-share

Default

Channel sharing is disabled.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

power-level power-level: Specifies the power level for channel sharing, in the range of 1 to 40. The recommended value is 30.

Usage guidelines

When this feature is enabled, an AP sends or does not send packets according to whether the detected signals are stronger or weaker than the specified power level. This mechanism avoids channel collision and interference.

Examples

# Enable channel sharing and set the power level to 30.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] option channel-share enable power-level 30

option client fast-forwarding

Use option client fast-forwarding enable to enable fast forwarding of AP-to-client data frames.

Use undo option client fast-forwarding to disable fast forwarding of AP-to-client data frames.

Syntax

option client fast-forwarding enable level level-value

undo option client fast-forwarding

Default

Fast forwarding of AP-to-client data frames is disabled.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

level level-value: Specifies the fast forwarding level in the range of 1 to 4.

Usage guidelines

This feature enables an AP to forward data frames to clients without extra processing (such as verification and counting) to improve processing efficiency.

Examples

# Enable fast forwarding of AP-to-client data frames.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] option client fast-forwarding enable level 1

option client hide-node-protection

Use option client hide-node-protection enable to enable hidden node protection.

Use undo option client hide-node-protection to disable hidden node protection.

Syntax

option client hide-node-protection enable

undo option client hide-node-protection

Default

Hidden node protection is disabled.

Views

Radio interface view

Predefined user roles

network-admin

Usage guidelines

This command takes effect only on 802.11g, 802.11n, and 802.11ac clients.

This feature enables clients to send RTS or CTS frames before transmitting frames to avoid interference from hidden nodes.

Examples

# Enable hidden node protection.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] option client hide-node-protection enable

option client reconnect

Use option client reconnect enable to enable AP-triggered client reassociation.

Use undo option client reconnect to disable AP-triggered client reassociation.

Syntax

option client reconnect enable [ rssi rssi-value ] [ interval interval ]

undo option client reconnect

Default

AP-triggered client reassociation is disabled.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

rssi rssi-value: Specifies the RSSI threshold in the range of 5 to 100. The default and recommended RSSI thresholds are 10 and 20, respectively.

interval interval: Specifies the interval at which an AP detects the signal strength of the clients. The value range for the interval argument is 3 to 10 seconds and the default interval is 3 seconds.

Usage guidelines

This feature enables an AP to send deauthentication frames to a client when the AP detects that the signal strength of the client is lower than the specified RSSI threshold. Then, the client can reassociate with the AP or roam to another AP.

Examples

# Enable AP-triggered client reassociation, and set the RSSI threshold and detection interval to 30 and 5 seconds, respectively.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] option client reconnect enable rssi 30 interval 5

option client reject

Use option client reject enable to enable an AP to reject weak-signal clients.

Use undo option client reject to disable an AP from rejecting weak-signal clients.

Syntax

option client reject enable [ rssi rssi-value ]

undo option client reject

Default

Weak-signal clients are not rejected.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

rssi rssi-value: Specifies the RSSI threshold in the range of 5 to 100. Both the default and recommended RSSI thresholds are 10.

Usage guidelines

This feature enables an AP to reject clients with an RSSI lower than the specified threshold to release channel resources and enhance WLAN performance.

After you enable this feature, wireless clients with an RSSI lower than the threshold might fail to access the WLAN.

After a client accesses the WLAN, an AP will not log off the client with an RSSI lower than the threshold but will reject the client after it disconnects from the network.

Examples

# Enable the AP to reject clients with an RSSI lower than 30 dBm.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] option client reject enable rssi 30

option dot11n-restraint

Use option dot11n-restraint enable to enable 802.11n packet suppression.

Use option dot11n-restraint disable to disable 802.11n packet suppression.

Use undo dot11n-restraint to restore the default.

Syntax

option dot11n-restraint { disable | enable packet-number packet-number packet-length packet-length } [ inbound | outbound ] [ tid tid-number ]

undo option dot11n-restraint

Default

802.11n packet suppression is disabled.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

packet-number packet-number: Specifies the maximum number of MPDUs that can be aggregated into an A-MPDU, in the range of 1 to 64. The recommended value is 8.

packet-length packet-length: Specifies the maximum A-MPDU length, in the range of 2000 to 380000 bytes. The recommended value is 6000.

inbound: Specifies 802.11n packet suppression in the inbound direction.

outbound: Specifies 802.11n packet suppression in the outbound direction.

tid tid-number: Specifies a traffic identifier, in the range of 0 to 7. The queue type varies by TID value.

·     0 and 3—AC-BE queue.

·     1 and 2—AC-BK queue.

·     4 and 5—AC-VI queue.

·     6 and 7—AC-VO queue.

If you do not specify this option, 802.11n packet suppression applies to all types of packets.

Usage guidelines

Perform this task to suppress 802.11n packets by defining the maximum number of aggregated MPDUs and the maximum A-MPDU length. The two thresholds take effect at the same time. If either threshold is reached, the AP stops aggregation and sends the A-MPDU.

Examples

# Enable 802.11n packet suppression. Set the maximum number of MPDUs that can be aggregated into an A-MPDU and the maximum A-MPDU length to 30 and 10000 bytes, respectively.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] option dot11n-restraint enable packet-number 30 packer-length 10000

option immediate-transmit

Use option immediate-transmit enable to enable RTS/CTS frame sending.

Use option immediate-transmit disable to disable RTS/CTS frame sending.

Use undo immediate-transmit to restore the default.

Syntax

option immediate-transmit { disable | enable }

undo immediate-transmit

Default

RTS/CTS frame sending is enabled.

Views

Radio interface view

Predefined user roles

network-admin

Usage guidelines

When you enable this feature, wireless devices send RTS/CTS frames to avoid channel collision. When you disable this feature, APs do not send RTS/CTS frames before sending packets to save system resources and improve network throughput. Disabling this feature might cause hidden node problems.

Examples

# Disable RTS/CTS frame sending.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] option immediate-transmit disable

option keep-active

Use option keep-active enable to enable decreasing the sleep interval of wireless clients.

Use option keep-active disable to disable decreasing the sleep interval of wireless clients.

Use undo option keep-active to restore the default.

Syntax

option keep-active { disable | enable }

undo option keep-active

Default

Decreasing the sleep interval of wireless clients is disabled.

Views

Radio interface view

Predefined user roles

network-admin

Usage guidelines

A wireless client in sleep state listens for traffic indication map (TIM) information in beacon frames to determine whether the associated AP has buffered packets for it. This feature enables an AP to modify the TIM information in beacon frames to decrease the sleep interval of wireless clients to improve transmission efficiency.

Examples

# Enable decreasing the sleep interval of wireless clients.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] option keep-active enable

option optimize-link-performance

Use option optimize-link-performance { inbound | outbound } enable to enable link performance optimization.

Use option optimize-link-performance { inbound | outbound } disable to disable link performance optimization.

Use undo optimize-link-performance to restore the default.

Syntax

option optimize-link-performance { inbound | outbound } { disable | enable } [ value ]

undo optimize-link-performance { inbound | outbound }

Default

Link performance optimization is disabled.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

inbound: Optimizes downlink performance.

outbound: Optimizes uplink performance.

value: Specifies the packet fragmentation threshold in the range of 0 to 2048 bytes.

Examples

# Enable uplink performance optimization and set the packet fragmentation threshold to 100 bytes.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] option optimize-link-performance outbound enable 100

option probe-response-try

Use option probe-response-try enable to set the maximum number of probe response attempts.

Use option probe-response-try disable to remove the configuration.

Use undo probe-response-try to restore the default.

Syntax

option probe-response-try { disable | enable number }

undo probe-response-try

Default

The maximum number of probe response attempts is 2.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

number: Specifies the maximum number of probe response attempts, in the range of 1 to 16.

Usage guidelines

Perform this task to reduce the number of probe responses sent by a radio to save resources and improve network performance.

Examples

# Set the maximum number of probe response attempts to 10.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] option probe-response-try enable 10

option roam-navigation

Use option roam-navigation enable to enable roaming navigation.

Use option roam-navigation disable to disable roaming navigation.

Use undo option roam-navigation to restore the default.

Syntax

option roam-navigation { disable | enable rssi rssi-value { beacon-power power-value | probe-response-power power-value } }

undo option roam-navigation

Default

Roaming navigation is disabled.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

rssi rssi-value: Specifies the RSSI threshold in the range of 1 to 50. The recommended RSSI threshold is 20.

beacon-power power-value: Specifies the transmit power for beacon frames, in the range of 1 to 30 dBm. The recommended transmit power is 10 dBm.

probe-response-power power-value: Specifies the transmit power for probe response frames, in the range of 1 to 30 dBm. The recommended transmit power is 10 dBm.

Usage guidelines

If you set the transmit power for beacons or probe responses, the system uses the default transmit power to transmit other packets.

Examples

# Enable roaming navigation. Set the RSSI threshold to 10 and the transmit power for beacon frames to 10 dBm.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] option roam-navigation enable rssi 10 probe-response-power 10

option signal-ignore

Use option signal-ignore enable to enable an AP to ignore weak signals.

Use option signal-ignore disable to disable an AP from ignoring weak signals.

Use undo option signal-ignore to restore the default.

Syntax

option signal-ignore { disable | enable rssi rssi-value }

undo option signal-ignore

Default

An AP does not ignore weak signals.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

rssi rssi-value: Specifies the RSSI threshold in the range of 1 to 30. The recommended RSSI threshold is 10.

Usage guidelines

This feature enables an AP to ignore packets with a signal strength lower than the specified RSSI threshold. Enabling this feature might cause collisions and interference among devices on the same channel.

Examples

# Enable the AP to ignore weak signals and set the RSSI threshold to 10.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] option signal-ignore enable rssi 10

option tpc

Use option tpc enable to enable per-packet transmit power control.

Use option tpc disable to disable per-packet transmit power control.

Use undo option tpc to restore the default.

Syntax

option tpc { disable | enable [ minpower minpower | powerstep powerstep | rssistep rssistep | rssithreshold rssithreshold ] }

undo option tpc

Default

Per-packet transmit power control is disabled.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

minpower minpower: Specifies the minimum transmit power in the range of 1 to 27. The default value is 10.

powerstep powerstep: Specifies the step value for transmit power decrease, in the range of 1 to 15. The default value is 5.

rssistep rssistep: Specifies the step value for RSSI adjustment, in the range of 1 to 20. The default value is 10.

rssithreshold rssithreshold: Specifies the RSSI threshold for per-packet transmit power control, in the range of 20 to 95. The default value is 65.

Usage guidelines

This feature enables an AP to dynamically perform transmit power control on a per packet basis. For example, the AP reduces the transmit power when it sends packets to a client with high RSSI. This feature can reduce power consumption, radiation, and interference to improve user experience.

This feature is not applicable to 5 GHz radios of 802.11ac APs.

Examples

# Enable per-packet transmit power control and set the minimum transmit power to 20.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/3

[Sysname-WLAN-Radio1/0/3] option tpc enable minpower 20

rrop software-retry

Use rrop software-retry enable to enable software retransmission and set the maximum number of software retransmissions.

Use rrop software-retry disable to disable software retransmission.

Use undo rrop software-retry to restore the default.

Syntax

rrop software-retry { unicast [ eap ] | broadcast-multicast } enable count count

rrop software-retry { unicast [ eap ] | broadcast-multicast } disable

undo rrop software-retry { unicast [ eap ] | broadcast-multicast }

Default

The maximum number of software retransmissions varies by device model.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

unicast: Configures software retransmission for unicast packets.

eap: Configures software retransmission for EAP packets.

broadcast-multicast: Configures software retransmission for broadcast and multicast packets.

count count: Specifies the maximum number of software retransmissions, in the range of 0 to 16.

Examples

# Set the maximum number of software retransmissions for EAP packets to the default.

<Sysname> system-view

[Sysname]interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] undo rrop software-retry unicast eap

wlan client inspect

Use wlan client inspect enable to enable client inspection.

Use undo wlan client inspect to restore the default.

Syntax

wlan client inspect enable

undo wlan client inspect

Default

Client inspection is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

The client inspection feature enables you to view information about packets exchanged and time consumed in each stage of the client association process.

In the current software version, the client inspection feature supports only client association, client association failure, and IP address lease extension events.

Examples

# Enable client inspection.

<Sysname> system-view

[Sysname] wlan client inspect enable