Table Of Contents
Configuring VideoStream
Overview of the VideoStream
Guidelines for Configuring VideoStream on the Controller
Configuring VideoStream
Using the GUI to Configure the VideoStream on the Controller
Using the CLI to Configure the VideoStream to the Controller
Configuring VideoStream
This chapter describes how to configure Cisco VideoStream functionality on the controller. It contains these sections:
•
Overview of the VideoStream
•
Guidelines for Configuring VideoStream on the Controller
•
Configuring VideoStream
Overview of the VideoStream
The IEEE 802.11 wireless multicast delivery mechanism does not provide a reliable way to acknowledge lost or corrupted packets. As a result, if any multicast packet is lost in the air, it is not sent again which may cause an IP multicast stream unviewable.
The VideoStream feature makes the IP multicast stream delivery reliable over the air, by converting the broadcast frame over the air to a unicast frame. Each VideoStream client acknowledges receiving a video IP multicast stream.
Guidelines for Configuring VideoStream on the Controller
Follow these guidelines when configuring VideoStream on the controller:
•
The AP1100 and AP1200 do not support the reliable multicast feature.
•
Make sure that the multicast feature is enabled. We recommend configuring IP multicast on the controller with multicast-multicast mode.
•
Check for the IP address on the client machine. The machine should have an IP address from the respective VLAN.
•
If there is a mismatch in the version of code on your controller, upgrade the controller code to 7.0.98.0 or later.
•
Verify that the access points have joined the controllers.
•
Make sure that the clients are able to associate to the configured WLAN at 802.11a/n speed.
•
VideoStream is supported on the following access points: Cisco Aironet 3500, 1260, 1250, 1240AG, 1140, 1130AG, 1040
Configuring VideoStream
This section describes how to configure VideoStream on the controller. This section contains the following topics:
•
Using the GUI to Configure the VideoStream on the Controller
•
Using the CLI to Configure the VideoStream to the Controller
Using the GUI to Configure the VideoStream on the Controller
To configure the VideoStream on the controller using the controller GUI, follow these steps:
Note
To enable the multicast feature using the controller GUI, perform Step 1 through Step 8.
Step 1
Choose WIRELESS > Media Stream > General to open the Media Stream > General page (see Figure 5-1).
Step 2
Select the Multicast Direct Feature check box to enable the multicast direct feature. The default value is disabled.
Note
Enabling the Multicast Direct feature does not automatically reset the existing client state. The wireless clients must rejoin the multicast stream after enabling the Multicast Direct feature on the controller.
Figure 5-1 Media Stream > General Page
Step 3
Under the Session Message Config, select Session announcement State to enable the session announcement mechanism. If this feature is enabled, clients are informed each time a controller is not able to serve the multicast direct data to the client.
Step 4
In the Session announcement URL text box, enter the URL where the client can find more information when an error occurs during the multicast media stream transmission.
Step 5
In the Session announcement Email text box, enter the e-mail address of the person who can be contacted.
Step 6
In the Session announcement Phone text box, enter the phone number of the person who can be contacted.
Step 7
In the Session announcement Note text box, enter a reason as to why a particular client cannot be served with a multicast media.
Step 8
Click Apply to commit your changes.
Note
To add a media stream using the controller GUI, perform Step 9 through Step 16.
Step 9
Choose WIRELESS > Media Stream > Streams to open the Media Stream page (see Figure 5-2).
Figure 5-2 Media Streams Page
Step 10
Click Add New to configure a new media stream. The Media Stream > New page (see Figure 5-3) appears.
Figure 5-3 Media Stream > New Page
Note
The Stream Name, Multicast Destination Start IP Address, and Multicast Destination End IP Address text boxes are mandatory. You must enter information in these text boxes.
Step 11
In the Stream Name text box, enter the media stream name. The stream name can be up to 64 characters.
Step 12
In the Multicast Destination Start IP Address text box, enter the start IP address of the multicast media stream.
Step 13
In the Multicast Destination End IP Address text box, enter the end IP address of the multicast media stream.
Step 14
In the Maximum Expected Bandwidth text box, enter the maximum expected bandwidth that you want to assign to the media stream. The values can range between 1 to 35000 kbps.
Note
We recommend that you use a template to add a media stream to the controller.
Step 15
From the Select from Predefined Templates drop-down list under Resource Reservation Control (RRC) Parameters, choose one of the following options to specify the details about the resource reservation control:
•
Very Coarse (below 300 kbps)
•
Coarse (below 500 kbps)
•
Ordinary (below 750 kbps)
•
Low (below 1 Mbps)
•
Medium (below 3 Mbps)
•
High (below 5 Mbps)
Note
When you select a predefined template from the drop-down list, the following text boxes under the Resource Reservation Control (RRC) Parameters list their default values that are assigned with the template.
•
Average Packet Size (100-1500 bytes)—Specifies the average packet size. The value can be in the range of 100 to 500 bytes. The default value is 1200.
•
RRC Periodic update—Enables the RRC (Resource Reservation Control Check) Periodic update. By default, this option is enabled. RRC periodically updates the admission decision on the admitted stream according to the correct channel load. As a result, it may deny certain low priority admitted stream requests.
•
RRC Priority (1-8)—Specifies the priority bit set in the media stream. The priority can be any number between 1 and 8. The larger the value means the higher the priority is. For example, a priority of 1 is the lowest value and a value of 8 is the highest value. The default priority is 4. The low priority stream may be denied in the RRC periodic update.
•
Traffic Profile Violation—Specifies the action to perform in case of a violation after a re-RRC. Choose an action from the drop-down list. The possible values are as follows:
–
Drop —Specifies that a stream is dropped on periodic revaluation.
–
Fallback—Specifies that a stream is demoted to BestEffort class on periodic reevaluation.
The default value is drop.
Step 16
Click Apply to save the configuration changes.
Note
To enable the media stream using the controller GUI, perform Step 17 through Step 20.
Note
The media stream added needs to be enabled for multicast-direct.
Step 17
Choose WLANs > WLAN ID to open the WLANs > Edit page.
Step 18
Choose the QoS tab and select Gold (Video) from the Quality of Service (QoS) drop-down list.
Step 19
Enable Multicast Direct.
Step 20
Click Apply to save the configuration changes.
Note
To set the EDCA parameters to voice and video optimized using the controller GUI, perform Step 21 through Step 23.
Note
Setting the EDCA parameters to voice and video optimized is an optional procedure.
Step 21
Choose WIRELESS > 802.11a/n or 802.11b/g/n > EDCA Parameters.
Step 22
From the EDCA Profile drop-down list, choose Voice and Video Optimized option.
Step 23
Click Apply to save the changes made.
Note
To enable the admission control on desired band for video using the controller GUI, perform Step 24 through Step 27.
Note
Enabling the admission control on the desired band for video is optional.
Note
Keep the voice bandwidth allocation to a minimum for better performance.
Step 24
Choose WIRELESS > 802.11a/n or 802.11b/g/n > Media to open the 802.11a/n (5 GHZ) or 802.11b/g/n > Media page.
Step 25
Choose the Video tab.
Step 26
Select the Admission Control (ACM) check box to enable bandwidth-based CAC for this radio band. The default value is disabled.
Step 27
Click Apply to save the configuration changes.
Note
To configure the video bandwidth using the controller GUI, perform Step 28 through Step 33.
Note
The template bandwidth that is configured for a media stream should be more than the bandwidth for the source media stream.
Note
The voice configuration is optional. Keep the voice bandwidth allocation to a minimum for better performance.
Step 28
Choose WIRELESS > 802.11a/n or 802.11b/g/n > Media to open the 802.11a/n (5 GHZ) or 802.11b/g/n > Media page.
Step 29
Choose the Video tab (see Figure 5-4).
Figure 5-4 802.11 a/n Video
Step 30
Select the Admission Control (ACM) check box to enable the video CAC for this radio band. The default value is disabled.
Step 31
In the Max RF Bandwidth field, enter the percentage of the maximum bandwidth allocated to clients for video applications on this radio band. Once the client reaches the value specified, the access point rejects new requests on this radio band.
The range is 5 to 85%.
The default value is 9%.
Step 32
Click Apply to commit your changes.
Step 33
Reenable all WMM WLANs and click Apply.
Note
To configure the media bandwidth using the controller GUI, perform Step 34 through Step 42.
Step 34
Choose Wireless > 802.11a/n or 802.11b/g/n > Media to open the 802.11a (or 802.11b) > Media > Parameters page.
Step 35
Choose the Media tab to open the Media page (see Figure 5-5).
Figure 5-5 Media Streams Page
Step 36
Select the Unicast Video Redirect check box to enable Unicast Video Redirect. The default value is disabled.
Step 37
In the Maximum Media Bandwidth (0-85%) text box, enter the percentage of the maximum bandwidth to be allocated for media applications on this radio band. Once the client reaches a specified value, the access point rejects new calls on this radio band.
The default value is 85%; valid values are from 0 to 85%.
Step 38
In the Client Phy Rate field, enter the minimum transmission data rate to the client. If the transmission data rate is below the phy rate, either the video will not start or the client may be classified as a bad client. The bad client video can be demoted for better effort QoS or subject to denial.
Step 39
In the Maximum Retry Percent (0-100%) field, enter the percentage of maximum retries that are allowed. The default value is 80. If it exceeds 80, either the video will not start or client may be classified as a bad client. The bad client video can be demoted for better effort QoS or subject to denial.
Step 40
Select the Multicast Direct Enable check box to enable the Multicast Direct Enable field. The default value is enabled.
Step 41
From the Multicast Direct Max Number of Streams drop-down list, select the maximum number of allowed multicast direct streams per radio. The range is 0 to 20. Select auto. The default value is set to auto. If you choose auto, then there is no limit set for the number of client subscriptions.
Step 42
Click Apply to save the configuration changes
Note
To enable WLANs using the controller GUI, perform Step 43 through Step 46.
Step 43
Choose WLANS > WLAN ID. The WLANs > Edit page is displayed.
Step 44
Enable the VideoStream feature for the WLAN.
Step 45
Select the Status check box to enable the WLAN.
Step 46
Click Apply to commit your changes.
Note
To enable the 802.11 a/n or 802.11 b/g/n network using the controller GUI, perform Step 47 through Step 49.
Step 47
Choose WIRELESS > Wireless > 802.11a/n or 802.11b/g/n > Network.
Step 48
Select the 802.11a or 802.11b/g Network Status check box to enable the network status.
Step 49
Click Apply to commit your changes.
Note
To verify if the clients are associated with the multicast groups and group-ides using the controller GUI, perform Step 50 through Step 54.
Step 50
Choose MONITOR > Clients. The Clients page appears.
Step 51
Check if the 802.11a or 802.11b/g network clients have the associated access points.
Step 52
Choose Monitor > Multicast. The Multicast Groups page appears.
Step 53
Select the MGID check box for the VideoStream to the clients.
Step 54
Click MGID. The Multicast Group Detail page appears. Check the Multicast Status details.
Using the CLI to Configure the VideoStream to the Controller
To configure the VideoStream to the controller using the controller GUI, follow these steps:
Step 1
Configure multicast-direct feature on WLANs media stream by entering this command:
config wlan media-stream multicast-direct {wlan_id | all} {enable | disable}
Step 2
Enable or disable the multicast feature by entering this command:
config media-stream multicast-direct {enable | disable}
Step 3
Configure various message configuration parameters by entering this command:
config media-stream message {state [enable | disable] | url url | email email |
phone phone _number | note note}
Step 4
Save your changes by entering this command:
save config
Step 5
View the configured media streams by entering this command:
show wlan wlan_id
Step 6
View the details of the media stream name by entering this command:
show 802.11{a | b | h} media-stream media-stream_name
Step 7
View the clients for a media stream by entering this command:
show 802.11a media-stream client media-stream-name
Step 8
See a summary of the media stream and client information by entering this command:
show media-stream group summary
Step 9
See details about a particular media stream group by entering this command:
show media-stream group detail media_stream_name
Step 10
Configure various global media-stream configurations by entering this command:
config media-stream add multicast-direct stream-name media_stream_name start_IP end_IP
[template {very-coarse | coarse | ordinary | low-resolution | med-resolution | high-resolution} | detail {Max_bandwidth bandwidth | packet size packet_size | Re-evaluation re-evaluation {periodic | initial}} video video priority {drop | fallback}
Note
•
The Resource Reservation Control (RRC) parameters are assigned with the predefined values based on the values assigned to the template.
•
The following templates are used to assign RRC parameters to the media stream:
–
Very Coarse (below 3000 kbps)
–
Coarse (below 500 kbps)
–
Ordinary (below 750 kbps)
–
Low Resolution (below 1 mbps)
–
Medium Resolution (below 3 mbps)
–
High Resolution (below 5 mbps)
Step 11
Delete a media stream by entering this command:
config media-stream delete media_stream_name
Step 12
Enable a specific enhanced distributed channel access (EDC) profile by entering this command:
config advanced {801.11a | 802.11b} edca-parameters optimized-video-voice
Step 13
Enable the admission control on desired bandwidth by entering the following commands:
•
Enable bandwidth-based voice CAC for 802.11a or 802.11b/g network by entering this command:
config {802.11a | 802.11b} cac voice acm enable
•
Set the percentage of the maximum bandwidth allocated to clients for voice applications on the 802.11a or 802.11b/g network by entering this command:
config {802.11a | 802.11b} cac voice max-bandwidth bandwidth
•
Configure the percentage of the maximum allocated bandwidth reserved for roaming voice clients on the 802.11a or 802.11b/g network by entering this command:
config {802.11a | 802.11b} cac voice roam-bandwidth bandwidth
Step 14
Save your changes by entering this command:
save config