admission-control

Enables admission control across all radios for one or more access categories. Enabling admission control for an access category ensures clients associated to an access point complete WMM admission control before using that access category.

Supported in the following platforms:

  • Access Points — AP505i, AP510i/e, AP560i/h
  • Service Platforms — NX5500, NX7500, NX9500, NX9600, VX9000

Syntax

admission-control [background|best-effort|firewall-detected-traffic|implicit-tspec|
video|voice]
admission-control [firewall-detected-traffic|implicit-tspec]
admission-control [background|best-effort|video|voice] 
{max-airtime-percent|max-clients|max-roamed-clients|reserved-for-roam-percent}
admission-control [background|best-effort|video|voice] {max-airtime-percent <0-150>|
max-clients <0-256>|max-roamed-clients <0-256>|reserved-for-roam-percent <0-150>}

Parameters

admission-control [firewall-detected-traffic|implicit-tspec]

admission-control firewall-detected-traffic

Enforces admission control for traffic whose access category is detected by the firewall ALG. For example, SIP voice calls. This feature is enabled by default.

When enabled, the firewall simulates reception of frames for voice traffic when the voice traffic was originated via SIP or SCCP control traffic. If a client exceeds configured values, the call is stopped and/or received voice frames are forwarded at the next non admission controlled traffic class priority. This applies to clients that do not send TPSEC frames only.

admission-control implicit-tspec

Enables implicit traffic specifiers for clients that do not support WMM TSPEC, but are accessing admission-controlled access categories. This feature is enabled by default.

This feature requires wireless clients to send their traffic specifications to an access point before they can transmit or receive data. If enabled, this setting applies to this radio QoS policy. When enabled, the access point simulates the reception of frames for any traffic class by looking at the amount of traffic the client is receiving and sending. If the client sends more traffic than has been configured for an admission controlled traffic class, the traffic is forwarded at the priority of the next non admission controlled traffic class. This applies to clients that do not send TPSEC frames only.

admission-control [background|best-effort|video|voice] 
{max-airtime-percent|max-clients|max-roamed-clients|reserved-for-roam-percent}

admission-control background

Configures background access category admission control parameters

admission-control best-effort

Configures best effort access category admission control parameters

admission-control video

Configures video access category admission control parameters

admission-control voice

Configures voice access category admission control parameters

max-airtime-percent <0-150>

Optional. Specifies the maximum percentage of airtime, including over subscription, for the following access category:

  • background – Sets the maximum airtime (in the form of a percentage of the radio‘s bandwidth) allotted to admission control for low (background) client traffic. Background traffic only needs a short radio airtime to process, so set an intermediate airtime value if this radio QoS policy is reserved to support background data.

  • best-effort – Sets the maximum airtime (in the form of a percentage of the radio‘s bandwidth) allotted to admission control for normal (best-effort) client traffic. Normal best effort traffic needs a short radio airtime to process, so set an intermediate airtime value if this radio QoS policy is reserved for best effort data support.

  • video – Sets the maximum airtime (in the form of a percentage of the radio‘s bandwidth) allotted to admission control for voice supported client traffic. Video traffic requires longer radio airtime to process, so set a longer airtime value if this radio QoS policy is intended to support video.

  • voice – Sets the maximum airtime (in the form of a percentage of the radio‘s bandwidth) allotted to admission control for voice supported client traffic. Voice traffic requires longer radio airtime to process, so set a longer airtime value if this radio QoS policy is intended to support voice.

The following keyword is common to all of the above traffic types:

  • <0-150> – Specify a value from 0 - 150. This is the maximum percentage of airtime, including over subscription, for the selected access category. The default is 75%.

max-clients <0-256>

Optional. Specifies the maximum number of wireless clients admitted to the following access categories:

  • background – Sets the number of wireless clients supporting low (background) traffic allowed to exist (and consume bandwidth) within the radio‘s QoS policy

  • best-effort – Sets the number of wireless clients supporting normal (best-effort) traffic allowed to exist (and consume bandwidth) within the radio‘s QoS policy

  • video – Sets the number of video supported wireless clients allowed to exist (and consume bandwidth) within the radio‘s QoS policy.

  • voice – Sets the number of voice supported wireless clients allowed to exist (and consume bandwidth) within the radio‘s QoS policy.

Since voice and video supported wireless clients use a greater portion of a controller‘s resources than lower bandwidth traffic (like low and best effort categories), consider setting the max-client value proportionally to the number of other QoS policies supporting voice access category clients.

The following keyword is common to all of the above traffic types:

  • <0-256> – Specify a value from 0 - 256. This is the maximum number of wireless clients admitted to the selected access category. The default is 100 clients.

max-roamed-clients <0-256>

Optional. Specifies the maximum number of roaming wireless clients admitted to the selected access category

  • background – Sets the number of low (background) supported wireless clients allowed to roam to a different access point radio

  • best-effort – Sets the number of normal (best-effort) supported wireless clients allowed to roam to a different access point radio

  • video – Sets the number of video supported wireless clients allowed to roam to a different access point radio

  • voice – Sets the number of voice supported wireless clients allowed to roam to a different access point radio

The following keyword is common to all of the above traffic types:

  • <0-256> – Specify a value from 0 - 256. This is the maximum number of roaming wireless clients admitted to the selected access category. The default is 10 roamed clients.

reserved-for-roam-percent <0-150>

Optional. Calculates the percentage of air time, including over subscription, allocated exclusively for roaming clients. This value is calculated relative to the configured max air time for this access category.

  • background – Sets the roam utilization (in the form of a percentage of the radio‘s bandwidth) allotted to admission control for low (background) supported clients who have roamed to a different radio.

  • best-effort – Sets the roam utilization (in the form of a percentage of the radio‘s bandwidth) allotted to admission control for normal (best-effort) supported clients who have roamed to a different radio.

  • video – Sets the roam utilization (in the form of a percentage of the radio‘s bandwidth) allotted to admission control for video supported clients who have roamed to a different radio.

  • voice – Sets the roam utilization (in the form of a percentage of the radio‘s bandwidth) allotted to admission control for voice supported clients who have roamed to a different radio.

The following keyword is common to all of the above traffic types:

  • <0-150> – Specify a value from 0 - 150. This is the percentage of air time, including over subscription, allocated exclusively for roaming clients associated with the selected access category. The default is 10%.

Examples

nx9500-6C8809(config-radio-qos-test)#admission-control best-effort max-clients 200
nx9500-6C8809(config-radio-qos-test)#admission-control voice reserved-for-roam-percent 8
nx9500-6C8809(config-radio-qos-test)#admission-control voice max-airtime-percent 9
nx9500-6C8809(config-radio-qos-test)#show context
radio-qos-policy test
 admission-control voice max-airtime-percent 9
 admission-control voice reserved-for-roam-percent 8
 admission-control best-effort max-clients 200
 accelerated-multicast stream-threshold 15
 accelerated-multicast client-timeout 500
nx9500-6C8809(config-radio-qos-test)#

Related Commands

no

Reverts or resets admission control settings to their default