Cisco Catalyst 9800 Series Wireless Controller Software Configuration Guide, Cisco IOS XE 26.1.x

PDF

Cisco Catalyst 9800 Series Wireless Controller Software Configuration Guide, Cisco IOS XE 26.1.x

Air time fairness on mesh

Want to summarize with AI?

Log in

Explains how ATF on mesh ensures fair airtime distribution and optimizes performance wirelessly in mesh networks.


Air time fairness (ATF) on mesh is a wireless quality of service feature that

  • regulates downlink airtime distribution in mesh networks using token bucket mechanisms

  • ensures fair access to radio airtime across mesh access points and their clients, and

  • operates on both client access radios and backhaul radios to provide network-wide fairness.

ATF on mesh operation details

The Air Time Fairness (ATF) on Mesh feature is conceptually similar to the ATF feature for local access points (APs). ATF is a form of wireless quality of service (QoS) that regulates downlink airtime (as opposed to egress bandwidth). Before a frame is transmitted, the ATF budget for that SSID is checked to ensure that there is sufficient airtime budget to transmit the frame. Each SSID can be thought of as having a token bucket (1 token = 1 microsecond of airtime). If the token bucket contains enough airtime to transmit the frame, it is transmitted over air. Otherwise, the frame can either be dropped or deferred. Deferring a frame means that the frame is not admitted into the Access Category Queue (ACQ). Instead, it remains in the Client Priority Queue (CPQ) and transmitted at a later time when the corresponding token bucket contains a sufficient number of tokens (unless the CPQ reaches full capacity, at which point, the frame is dropped). The majority of the work involved in the context of ATF takes place on the APs. The wireless controller is used to configure the ATF on Mesh and display the results.

In a mesh architecture, the mesh APs (parent and child MAPs) in a mesh tree access the same channel on the backhaul radio for mesh connectivity between parent and child MAPs. The root AP is connected by wire to the controller, and MAPs are connected wirelessly to the controller. Hence, all the CAPWAP and Wi-Fi traffic are bridged to the controller through the wireless backhaul radio and through RAP. In terms of physical locations, normally, RAPs are placed at the roof top and MAPs in multiple hops are placed some distance apart from each other based on the mesh network segmentation guidelines. Hence, each MAP in a mesh tree can provide 100 percent of its own radio airtime downstream to its users though each MAP accessing the same medium. Compare this to a non-mesh scenario, where neighboring local-mode unified APs in the arena next to each other in different rooms, serving their respective clients on the same channel, and each AP providing 100% radio airtime downstream. ATF has no control over clients from two different neighboring APs accessing the same medium. Similarly, it is applicable for MAPs in a mesh tree.

For outdoor or indoor mesh APs, ATF must be supported on client access radios that serve regular clients similarly to how it is supported on ATF on non-mesh unified local mode APs to serve the clients. Additionally, it must also be supported on backhaul radios which bridge the traffic to/from the clients on client access radios to RAPs (one hop) or through MAPs to RAPs (multiple hops). It is a bit tricky to support ATF on the backhaul radios using the same SSID/Policy/Weight/Client fair-sharing model. Backhaul radios do not have SSIDs and it always bridge traffic through their hidden backhaul nodes. Therefore, on the backhaul radios in a RAP or a MAP, the radio airtime downstream is shared equally, based on the number of backhaul nodes. This approach provides fairness to users across a wireless mesh network, where clients associated to second-hop MAP can stall the clients associated to first-hop MAP where second-hop MAP is connected wireless to first-hop MAP through backhaul radio even though the Wi-Fi users in the MAPs are separated by a physical location. In a scenario where a backhaul radio has an option to serve normal clients through universal client access feature, ATF places the regular clients into a single node and groups them. It also enforces the airtime by equally sharing the radio airtime downstream, based on the number of nodes (backhaul nodes plus a single node for regular clients).


Configure ATF on mesh (GUI)

Configure ATF to optimize bandwidth allocation among clients on a mesh network.

Procedure

1.

Choose Configuration > Wireless > Airtime Fairness > Global Config.

2.

For 5 GHz Band and 2.4 GHz Band, enable the Status and the Bridge Client Access toggle button.

3.

To select the Mode, click the Monitor or Enforced radio button.

4.

Enable or disable the Optimization toggle button.

5.

Enter Airtime Allocation.

6.

Click Apply to Device.

The ATF settings are applied and mesh APs operate with the new airtime fairness parameters.


Configure ATF on mesh

Ensure fair airtime allocation and optimize wireless performance for mesh environments.

Procedure

1.

Enter global configuration mode.

Example:

Device# configure terminal
2.

Configure an RF profile to enter RF profile configuration mode.

Example:

Device(config)# ap dot11 {24ghz | 5ghz | 6gh} rf-profile rf-profile1
3.

Configure airtime allocation weight percentage for mesh APs.

Example:

Device(config-rf-profile)# airtime-fairness bridge-client-access airtime-allocation allocation-weight-percentage

You have now configured mesh APs for ATF. Balanced airtime allocation improves wireless network efficiency.

Device# configure terminal
Device(config)# ap dot11 24ghz rf-profile rfprof24_1
Device(config-rf-profile)# airtime-fairness bridge-client-access airtime-allocation 10

Create an ATF policy for a MAP

Define and enable an Airtime Fairness (ATF) policy for a Mesh Access Point (MAP). This policy optimizes wireless network performance and ensures equitable airtime distribution among connected clients.

Procedure

1.

Enter global configuration mode.

Example:

Device# configure terminal
2.

Configure WLAN policy profile to enter wireless policy configuration mode.

Example:

Device(config)# wireless profile policy  rr-xyz-policy-1
3.

Enable ATF in the existing RF profile.

Example:

Device(config-wireless-policy)# dot11 24ghz airtime-fairness atf-policy
Airtime Fairness is applied to the specified MAP when the policy is enabled.
Device# configure terminal
Device(config)# wireless profile policy rr-xyz-policy-1 
Device(config-wireless-policy)# dot11 24ghz airtime-fairness atf-policy1

Create an ATF policy (GUI)

Create a new Air Time Fairness (ATF) policy and apply it to a MAP (Managed Access Point) for optimal client traffic sharing.

Procedure

1.

Choose Configuration > Air Time Fairness > Profiles.

2.

On the Profiles window, click Add.

3.

In the Add ATF Policy window, specify a name, ID, and weight for the ATF policy.

Note

A weighted ratio is used instead of percentages, allowing the total to exceed 100. The minimum weight that you can set is 5.

4.

Use the slider to enable or disable the Client Sharing feature.

5.

Click Save & Apply to Device to save your ATF configuration.

6.

(Optional) To delete a policy, check the check box next to the appropriate policy and click Delete.

7.

(Optional) To edit an existing ATF policy, select the check box next to the policy you want to edit.

In the Edit ATF Policy window that is displayed, you can modify the weight and client sharing details for the policy.

You have created and applied the new ATF policy to the selected MAP.


Add an ATF to a policy profile (GUI)

Enable ATF on your selected policy profiles to assign fair radio resource allocation policies to wireless clients.

Procedure

1.

Choose Configuration > Tags & Profiles > Policy.

2.

Click the name of your policy profile.

3.

Click the Advanced tab.

4.

In the Air Time Fairness Policies section, choose the appropriate status for the 2.4 GHz Policy and 5 GHz Policy.

5.

Click Update & Apply to Device.

Your selected policy profile is updated and now includes the ATF settings you chose.


Enable ATF mode in an RF profile (GUI)

Enable Airtime Fairness mode to distribute wireless bandwidth more equitably among clients in an RF profile.

Procedure

1.

Choose Configuration > Tags & Profiles > RF.

2.

Click the name of the corresponding RF profile.

3.

In the RF Profile window, click the Advanced tab.

4.

In the ATF Configuration section, choose the appropriate status:

  • Status: If you choose Enabled as the status, select the Mode as either Monitor or Enforced. You can also enable or disable optimization for this mode.

  • Bridge Client Access

  • Airtime Allocation: Enter the allocation value. You can set the value only after you enable the Bridge Client Access.

5.

Click Update & Apply to Device.

ATF mode is enabled for the selected RF profile, and the corresponding settings are applied to the device.


Verify ATF configuration on mesh

You can verify Cisco ATF configurations on mesh APs using these commands.

Use this show command to display the ATF configuration summary of all the radios:

Device# show ap airtime-fairness summary

AP Name                          MAC Address       Slot Admin    Oper        Mode           Optimization
-------------------------------- ----------------- ---- -------- ----------- -------------- ------------
ap1/2                            6c:99:89:0c:73:a0 0    ENABLED  DOWN        Enforce-Policy Enabled 
ap1/2                            6c:99:89:0c:73:a0 1    ENABLED  UP          Enforce-Policy Enabled
ap1/3                            6c:99:89:0c:73:a1 0    ENABLED  DOWN        Enforce-Policy Enabled 
ap1/3                            6c:99:89:0c:73:a1 1    ENABLED  UP          Enforce-Policy Enabled

Use this show command to display the ATF configuration for a 2.4-GHz radio:

Device# show ap dot11 24ghz airtime-fairness

AP Name                          MAC Address       Slot Admin    Oper        Mode           Optimization 
------------------------------ -----------------   ---- -------- ----------- -------------- ------------
ap1/2                            6c:99:89:0c:73:a0 1    ENABLED  UP          Enforce-Policy Enabled

Use this show command to display the ATF WLAN statistics:

Device# show ap name ap1 dot11 24ghz airtime-fairness wlan 12 statistics

AP Name                          MAC Address       Slot Admin    Oper        Mode           Optimization 
-------------------------------- ----------------- ---- -------- ----------- -------------- ------------
ap1/2                            6c:99:89:0c:73:a0 0    ENABLED  DOWN        Enforce-Policy Enabled 
ap1/2                            6c:99:89:0c:73:a0 1    ENABLED  UP          Enforce-Policy Enabled      Network level

Use this show command to display the wireless mesh summary:

Device# show wireless profile mesh summary

Number of Profiles: 2

Profile-Name                       BGN         Security  Bh-access  Description                       
----------------------------------------------------------------------------------------------------
mesh1                                          EAP       DISABLED                                     
default-mesh-profile                           EAP       DISABLED   default mesh profile  

Use this show command to display the mesh ATF client access information:

Device# show mesh atf client-access

AP Name             Client Access Allocation   Override   Current nodes 
                     Default %    Current %
------------------   ---------    ---------    --------   ------------- 
RAP                     25           40        Enabled          4
RAP                     33           40        Enabled          3