Tags
In this post we will see the Media Stream configuration via CLI. If you want to configure this across multiple controllers it is good idea to learn CLI commands in order to save some time during your lab exam.
Here are the steps of configuring this feature.
1. Enable Multicast direct globally & set the General settings.
2. Define Media stream with RRC parameters.
3. Configure CAC for voice/video (Media) under each radio band.
4. Enable this feature for a WLAN
5. Ensure WLC is configured for Multicast & IGMP
6. Test/Verify the configuration.
First of all you need to enable this feature globally & define general settings and steam specific information. Here are the two GUI screen if you are familiar with it.
Here are the CLI config for this
(WLC3) >config media-stream ? add Configure New Media Stream by template or individual parameters admit Allow traffic for the media stream delete Remove Media Stream Configuration deny Block traffic for the media stream multicast-direct Configure Media Stream Multicast-direct message Configure Session Announcement Message (WLC3) >config media-stream multicast-direct ? enable Enable Global Multicast to Unicast Conversion disable Disable Global Multicast to Unicast Conversion (WLC3) >config media-stream multicast-direct enable WARNING: Media Stream Multicast-direct requires Load Based CAC to run, Voice deployment employing Static CAC needs to convert to Load Based CAC. (WLC3) >config media-stream message ? url Configure Session Announcement URL email Configure Session Announcement e-mail phone Configure Session Announcement phone number note Configure Session Announcement notes state Configure Session Announcement Message State (WLC3) >config media-stream message state ? enable Configure Session Announcement Message State Enable disable Configure Session Announcement Message State Disable (WLC3) >config media-stream message state enable (WLC3) >config media-stream message note ? denial Configure Session Announcement notes denial (WLC3) >config media-stream message note denial CIO-IS-SPEAKING
Here are the CLI config for this.
(WLC3) >config media-stream add ?
multicast-direct Add Media Stream for Multicast-direct
(WLC3) >config media-stream add multicast-direct ?
<Media Stream Name> Media Stream Name
(WLC3) >config media-stream add multicast-direct MRN-TV ?
<Start IP Address> IP Multicast Destination Start Address
(WLC3) >config media-stream add multicast-direct MRN-TV 239.239.239.1 ?
<End IP Address> IP Multicast Destination End Address
(WLC3) >config media-stream add multicast-direct MRN-TV 239.239.239.1 239.239.239.1 ?
detail Configure Media Stream with Specific Parameters
template Configure Media Stream from Templates
(WLC3) >config media-stream add multicast-direct MRN-TV 239.239.239.1 239.239.239.1 template ?
very-coarse Apply very-coarse template (< 300 Kbps Bandwidth)
coarse Apply Coarse template (< 500 Kbps Bandwidth)
ordinary Apply Ordinary template (< 750 Kbps Bandwidth)
low-resolution Apply Low-Resolution template (< 1 Mbps Bandwidth)
med-resolution Apply Medium-Resolution template (< 3 Mbps Bandwidth)
high-resolution Apply High-Resolution template (< 5 Mbps Bandwidth)
(WLC3) >config media-stream add multicast-direct MRN-TV 239.239.239.1 239.239.239.1 template high-resolution
Even though you entered above line if you check your WLC configuration you would see something like this in your configuration.That mean in High Resolution template bandwidth is 5000kbps, packet size 1200 bytes, enable periodic update, RRC priority 3 and drop as traffic violation policy.
config media-stream add multicast-direct MRN-TV 239.239.239.1 239.239.239.1 detail 5000 1200 periodic video 3 drop
If a given task is not fulfill by these default values you have to configure it in detail method with specific setting you require. Let’s say scenario like this “MRN TV streaming channel use 239.239.239.1. Streaming Video feeds are high quality, but still less than 5Mbps. Ensure flow will get highest priority and the other denied flow will get a message saying “CIO-IS-SPEAKING”.
So we will first delete the media stream created & re-configure it with this new settings.
(WLC3) >config media-stream delete MRN-TV IGMP snooping will be disabled and enabled again. All clients will observe a glitch on Multicast traffic. Are you sure you want to continue? (y/n) media-stream is deleted (WLC3) >config media-stream add multicast-direct MRN-TV 239.239.239.1 239.239.239.1 ? detail Configure Media Stream with Specific Parameters template Configure Media Stream from Templates (WLC3) >config media-stream add multicast-direct MRN-TV 239.239.239.1 239.239.239.1 detail ? <Max Bandwidth> Maximum Expected Stream Bandwidth, <1-35000> Kbps (WLC3) >config media-stream add multicast-direct MRN-TV 239.239.239.1 239.239.239.1 detail 5000 ? <Average Packet Size> Average Packet Size, <100-1500> (WLC3) >config media-stream add multicast-direct MRN-TV 239.239.239.1 239.239.239.1 detail 5000 1200 ? periodic Periodic admission evaluation initial Initial admission evaluation (WLC3) >config media-stream add multicast-direct MRN-TV 239.239.239.1 239.239.239.1 detail 5000 1200 periodic ? <Qos> Over the AIR QoS class, <'video'> ONLY (WLC3) >config media-stream add multicast-direct MRN-TV 239.239.239.1 239.239.239.1 detail 5000 1200 periodic video ? <Usage Priority> Media Stream Priotity, <1:Lowest - 8:Highest> (WLC3) >config media-stream add multicast-direct MRN-TV 239.239.239.1 239.239.239.1 detail 5000 1200 periodic video 8 ? drop Stream will be dropped on periodic re-evaluation fallback Stream demoted to BestEffort class on periodic re-evaluation (WLC3) >config media-stream add multicast-direct MRN-TV 239.239.239.1 239.239.239.1 detail 5000 1200 periodic video 8 fallback
Then you need to configure required admission control or CAC in 802.11a/n or 802.11b/g/n band as required. In my example I will only configure 802.11b/g/n. In GUI this is under “Wireless > 802.11b/g/n > Media” section & default settings shown in the screenshot.
Here are the CLI commands to change these settings. You have to makesure radio interface is disabled prior to this configuration & enable it once you finish config. We will customize this to allow max 3 stream session per client.
(WLC3) >config 802.11b disable network (WLC3) >config 802.11b media-stream multicast-direct enable (WLC3) >config 802.11b media-stream multicast-direct radio-maximum ? <value> From 1 to 20 streams no-limit Maximum number of allowed streams on 2.4/5 GHz band (WLC3) >config 802.11b media-stream multicast-direct radio-maximum no-limit (WLC3) >config 802.11b media-stream multicast-direct admission-besteffort ? enable Enable/Disable media stream BestEffort queue admission disable Enable/Disable media stream BestEffort queue admission (WLC3) >config 802.11b media-stream multicast-direct admission-besteffort disable (WLC3) >config 802.11b media-stream multicast-direct client-maximum ? <value> From 1 to 20 streams no-limit Maximum number of allowed streams on individual client (WLC3) >config 802.11b media-stream multicast-direct client-maximum 3 (WLC3) >config 802.11b cac ? defaults Set Default CAC parameters for 802.11b radio. media-stream Configure CAC parameters for media stream access category multimedia Configure CAC parameters for media access category, used for voice and video. video Configure CAC parameters for video access category, used for voice signalling. voice Configure CAC parameters for voice access category. (WLC3) >config 802.11b cac media-stream ? multicast-direct Configure CAC parameters for multicast-direct streams (WLC3) >config 802.11b cac media-stream multicast-direct ? max-retry-percent Configure CAC parameter maximum retry percent for multicast-direct streams min-client-rate Configure CAC parameter minimun physical rate for multicast-direct streams (WLC3) >config 802.11b cac media-stream multicast-direct min-client-rate ? <dot11-rate> Kbps: 1000, 2000, 5500, 6000, 9000, 11000, 12000, 18000, 24000, 36000, 48000, 54000 or 11n rates (WLC3) >config 802.11b cac media-stream multicast-direct max-retry-percent ? <retry-percentage> 0 to 100 maximum retry percent for multicast-direct streams (WLC3) >config 802.11b cac media-stream multicast-direct max-retry-percent 80 (WLC3) >config 802.11b cac multimedia ? max-bandwidth Configure the max bandwidth allocated to WMM clients for media in % (5-85). (WLC3) >config 802.11b cac multimedia max-bandwidth ? <bandwidth> Configure the max bandwidth allocated to WMM clients for media in % (5-85). (WLC3) >config 802.11b cac multimedia max-bandwidth 80
When you check the WLC configuration you will not see default setting config lines (lines highlighted in purple).
config 802.11b media-stream multicast-direct client-maximum 3
config 802.11b media-stream multicast-direct radio-maximum no-limit
config 802.11b media-stream multicast-direct enable
config 802.11b media-stream multicast-direct admission-besteffort disable
config 802.11b cac media-stream multicast-direct min-client-rate 6000
config 802.11b cac media-stream multicast-direct max-retry-percent 80
config 802.11b cac multimedia max-bandwidth 80
Since Media bandwidth settings is for both voice & video, you need to ensure voice and video bandwidth reservation does not exceed 80% configured under media tab. Also remember that Voice CAC should be “load-based” when you enable Video Stream feature. In this example we will allocate max RF bandwidth 50% for Video & 30% voice. Here is the default setting GUI screenshot.
You can use “config 802.11b cac {voice|video} x ” CLI configuration to do the necessary modification.
(WLC3) >config 802.11b cac ? defaults Set Default CAC parameters for 802.11b radio. media-stream Configure CAC parameters for media stream access category multimedia Configure CAC parameters for media access category, used for voice and video. video Configure CAC parameters for video access category, used for voice signalling. voice Configure CAC parameters for voice access category. (WLC3) >config 802.11b cac video ? acm Enable/disable admission control on video access category. max-bandwidth Configure the max RF bandwidth allocated to WMM clients for video. tspec-inactivity-timeout Configure TSPEC inactivity timeout processing mode. (WLC3) >config 802.11b cac video acm ? disable Disable admission control on video AC. enable Enable admission control on video AC. (WLC3) >config 802.11b cac video acm enable (WLC3) >config 802.11b cac video ? acm Enable/disable admission control on video access category. max-bandwidth Configure the max RF bandwidth allocated to WMM clients for video. tspec-inactivity-timeout Configure TSPEC inactivity timeout processing mode. (WLC3) >config 802.11b cac video max-bandwidth ? <bandwidth> Enter the max RF bandwith for Video in % (5-85). (WLC3) >config 802.11b cac video max-bandwidth 50
Here is the Voice specific settings.
(WLC3) >config 802.11b cac voice ? acm Enable/disable admission control on voice access category. cac-method Configure CAC method(static or dynamic) on voice access category. max-bandwidth Configure the max RF bandwidth allocated to WMM clients for voice. roam-bandwidth Configure the % of max RF bandwidth reserved for roaming clients for voice (0-25). sip Configure CAC parameters for SIP based Calls. stream-size Max data rate of the stream acceptable tspec-inactivity-timeout Configure TSPEC inactivity timeout processing mode. (WLC3) >config 802.11b cac voice max-bandwidth ? <bandwidth> Enter the max RF bandwith for Voice in % (5-85). (WLC3) >config 802.11b cac voice max-bandwidth 30 (WLC3) >config 802.11b cac voice acm enable
You can configure EDCA parameters to optimize both Voice & Video.
(WLC3) >config advanced 802.11b edca-parameters ?
custom-voice Enable Custom Voice EDCA parameters for 802.11b.
optimized-video-voice Enable combined video-voice-optimized parameters for 802.11b.
optimized-voice Enable non-spectralink voice-optimized parameters for 802.11b.
svp-voice Enable SpectraLink Voice Priority (SVP) parameters for 802.11b.
wmm-default Enable WMM default parameters for 802.11b.
(WLC3) >config advanced 802.11b edca-parameters optimized-video-voice
Once you configure the above you can enable the radio band. It is good idea to enable 802.11n support with this feature.
(WLC3) >config 802.11b 11nSupport ? a-mpdu Configure 802.11n-2.4Ghz A-MPDU mode a-msdu Configure 802.11n-2.4Ghz A-MSDU mode antenna Configure 802.11n - 2.4 GHz antenna selection disable Disable 802.11n-2.4Ghz support enable Enable 802.11n-2.4Ghz support guard_interval Configure 802.11n-2.4Ghz guard interval mcs Configure 802.11n-2.4Ghz MCS rates rifs Configure 802.11n-2.4Ghz rifs (WLC3) >config 802.11b 11nSupport enable (WLC3) >config 802.11b enable network
You can enable it on a WLAN like below
(WLC3) >config wlan media-stream multicast-direct 17 ?
enable Enables Multicast-direct on the WLAN
disable Disables Multicast-direct on the WLAN.
(WLC3) >config wlan media-stream multicast-direct 17 enable
In Summary here are the CLI config required in my example. So if you want to configure this feature any other WLC, you can simply paste the below config on them.
config media-stream multicast-direct enable config media-stream message state enable config media-stream message note denial CIO-IS-SPEAKING config media-stream add multicast-direct MRN-TV 239.239.239.1 239.239.239.1 detail 5000 1200 periodic video 8 fallback config 802.11b disable network config 802.11b media-stream multicast-direct enable config 802.11b media-stream multicast-direct client-maximum 3 config 802.11b cac multimedia max-bandwidth 80 config 802.11b cac video acm enable config 802.11b cac video max-bandwidth 50 config 802.11b cac voice max-bandwidth 30 config 802.11b cac voice acm enable config advanced 802.11b edca-parameters optimized-video-voice config 802.11b 11nSupport enable config 802.11b enable network
You can use following CLI verification commands to verify your settings.
(4402-a) >show media-stream group summary Stream Name Start IP End IP Operation Status ------------- -------------- -------------- ---------------- MRN-TV 239.239.239.1 239.239.239.1 Multicast-direct (4402-a) >show media-stream group detail MRN-TV Media Stream Name................................ MRN-TV Start IP Address................................. 239.239.239.1 End IP Address................................... 239.239.239.1 RRC Parmmeters Avg Packet Size(Bytes).......................... 1200 Expected Bandwidth(Kbps)........................ 5000 Policy.......................................... Admit RRC re-evaluation............................... periodic QoS............................................. Video Status.......................................... Multicast-direct Usage Priority.................................. 8 Violation....................................... fallback (4402-a) >show 802.11b media-stream rrc Multicast-direct................................. Enabled Best Effort...................................... Disabled Video Re-Direct.................................. Enabled Max Allowed Streams Per Radio.................... Auto Max Allowed Streams Per Client................... 3 Max Video Bandwidth.............................. 50 Max Voice Bandwidth.............................. 30 Max Media Bandwidth.............................. 80 Min PHY Rate..................................... 6000 Max Retry Percentage............................. 80 (4402-a) >show media-stream message details URL.............................................. E-mail........................................... Phone............................................ Note............................................. CIO-IS-SPEAKING State............................................ enable
It is important to note that your infrastructure network should be configured to support Multicast & WLC multicast/IGMP needs to be enabled to get this feature working. Even in the exam if they asked to configure this feature, you need to verify your L3 multicast & WLC multicast properly enabled with IGMP support.
Related Posts
1. Understanding Video Stream Feature
2. Wireless Multicast Not working-Why ?
3. Configuring Multicast on WLC
mrn-cciew 
Wow!! Thanks Nayarasi. This is a excellent post that will save lots of time, I remember wasting time using GUI. JT
Date: Fri, 24 May 2013 06:52:14 +0000 To: jose_tomas_perez@hotmail.com
Thanks Jose, I have to practice this many times in order to remember this well. I agreed it is worth trying …
Regards
Rasika
No reason to enable Voice CAC for this.
Yes, If you are purely thinking about Video Stream. Normally we configure WLC for both Voice & Video. So it is good practice to configure Voice CAC in that case
HTH
Rasika
Do we need to enable video CAC and media stream cofig under radios. If we just care about media stream on particular WLAN?
No you do not.
If you enable it some time video may not play as most client does not support video CAC.
HTH
Rasika
Thanks for the response. One more: If I want to ensure that my media stream flow is to be received as video QoS priority, I am enabling multicast-direct globally and setting up the media stream group as required, and adding it under WLAN (QoS > multicast-direct enabled). But does my configuration on QoS for WLAN profile matter?
Because enabling or disabling GOLD Profile, show commands shows QoS priority, so that is confusing.
this is configured on 3850 with 3.6.x code train.
Usually you need to have Gold or Platinum profiles configure for your WLAN (as you expecte AF34 for video traffic)
HTH
Rasika
Thanks. So I was referring this: http://www.cisco.com/c/en/us/td/docs/switches/lan/catalyst3850/software/release/3se/videostream/configuration_guide/b_Video_3se_3850_cg/b_Video_3se_3850_cg_chapter_010.html where it doesnt tell you need for GOLD!