|
Table Of Contents
Configuring Video Support for SCCP-Based Endpoints
Prerequisites for Video Support for SCCP-Based Endpoints
Restrictions for Video Support for SCCP-Based Endpoints
Information About Video Support for SCCP-Based Endpoints
Matching Endpoint Capabilities
Retrieving Video Codec Information
Call Setup for Video Endpoints
How to Configure Video for SCCP-Based Endpoints
Enabling Slow Connect Procedures for H.323 Endpoints
Enabling Video Capabilities on a Specific Phone
Verifying Video Support for SCCP-Based Endpoints
Troubleshooting Video Support for SCCP-Based Endpoints
Feature Information for Video Support for SCCP-Based Endpoints
Configuring Video Support for SCCP-Based Endpoints
Last Updated: September 10, 2007This chapter describes the video support for SCCP-based endpoints in Cisco Unified Communications Manager Express (Cisco Unified CME).
Finding Feature Information in This Module
Your Cisco Unified CME version may not support all of the features documented in this module. For a list of the versions in which each feature is supported, see the Feature Information for Video Support for SCCP-Based Endpoints.
Contents
• Prerequisites for Video Support for SCCP-Based Endpoints
• Information About Video Support for SCCP-Based Endpoints
• How to Configure Video for SCCP-Based Endpoints
• Feature Information for Video Support for SCCP-Based Endpoints
Prerequisites for Video Support for SCCP-Based Endpoints
•H.323 or SIP network for voice calls is operational.
•Cisco IOS Release 12.4(9)T or a later version.
•Cisco Unified CME version is 4.0 or later version.
•Cisco Unified Communications Manager version is 4.0 or later.
•Cisco Unified IP phones are registered in Cisco Unified CME. Use the show ephone registered command to verify ephone registration.
•Connection between the Cisco Unified Video Advantage 1.02 or a later version and the Cisco Unified IP phone is up.
From a PC with Cisco Unified Video Advantage version 1.02 or later installed, ensure that the line between the Cisco Unified Video Advantage and the Cisco Unified IP phone is green. For more information, see the Cisco Unified Video Advantage User Guide.
•Correct video firmware is installed on the Cisco Unified IP phone. Use the show ephone phone-load command to view current ephone firmware. The following lists the minimum firmware version for video-enabled Cisco Unified IP phones:
–Cisco Unified IP Phone 7940G 6.0(4)
–Cisco Unified IP Phone 7960G 6.0(4)
–Cisco Unified IP Phone 7970G 7.0(3)
–Cisco Unified IP Phone 7941G 7.0(3)
–Cisco Unified IP Phone 7961G 7.0(3)
Note Other video-enabled endpoints, if registered with Cisco Unified Communications Manager, can place a video call to one of the Cisco Unified IP phones listed above if it is registered with Cisco Unified CME.
Restrictions for Video Support for SCCP-Based Endpoints
•This feature supports only the following video codecs:
–H.261
–H.263
•This feature supports only the following video formats:
–4CIF—Resolution 704x576
–16CIF—Resolution 1408x1152
–Common Intermediate Format (CIF)—Resolution 352x288
–One-Quarter Common Intermediate Format (QCIF)—Resolution 176x144
–Sub QIF (SQCIF)—Resolution 128x96
•The call start fast feature is not supported with an H.323 video connection. You must configure call start slow for H.323 video.
•Video capabilities are configured per ephone, not per line.
•All call feature controls (for example, mute and hold) apply to both audio and video calls, if applicable.
•This feature does not support the following:
–Dynamic addition of video capability—The video capability must be present before the call setup starts to allow the video connection.
–T-120 data connection between two SCCP endpoints
–Video security
–Far-end camera control (FECC) for SCCP endpoints
–Video codec renegotiation—The negotiated video codec must match or the call falls back to audio-only. The negotiated codec for the existing call can be used for a new call.
–Video codec transcoding
–SIP endpoints— When a video-capable SCCP endpoint connects to a SIP endpoint, the call falls back to audio-only.
–Video conferencing—The call falls back to audio-only.
–Features, such as conferencing, that mix the audio streams in Cisco Unified CME—In those cases, the call falls back to audio-only.
–Video supplementary services between Cisco Unified CME and Cisco Unified Communications Manager.
•If the Cisco Unified Communications Manager is configured for Media Termination Point (MTP) transcoding, a video call between Cisco Unified CME and Cisco Unified Communications Manager is not supported.
•Video telephony is not supported with CME MTP and codec g729/dspfarm-assist configuration under ephone.
•If an SCCP endpoint calls an SCCP endpoint on the local Cisco Unified CME and one of the endpoints transferred across an H323 network, a video-consult transfer between the Cisco Unified CME systems is not supported.
•When a video-capable endpoint connects to an audio-only endpoint, the call falls back to audio-only. During audio-only calls, video messages are skipped.
•For Cisco Unified CME, the video capabilities in the vendor configuration firmware is a global configuration. This means that, although video can be enabled per ephone, the video icon shows on all Cisco Unified IP phones supported by Cisco Unified CME.
•Because of the extra CPU consumption on RTP-stream mixing, the number of video calls supported on Cisco Unified CME crossing an H.323 network is less than the maximum number of ephones supported.
•Cisco Unified CME cannot differentiate audio-only streams and audio-in-video streams. You must configure the DSCP values of audio and video streams in the H.323 dial-peers.
•If RSVP is enabled on the Cisco Unified CME, a video call is not supported.
•A separate VoIP dial peer, configured for fast-connect procedures, is required to complete a video call from a remote H.323 network to a Cisco Unity Express system.
Information About Video Support for SCCP-Based Endpoints
To configure video support for SCCP endpoints, you should understand the following concepts:
• Matching Endpoint Capabilities
• Retrieving Video Codec Information
• Call Setup for Video Endpoints
• Flow of the RTP Video Stream
Video Support Overview
Video support allows you to pass a video stream, with a voice call, between two video-capable SCCP endpoints and between SCCP and H.323 endpoints. Through the Cisco Unified CME router, the video-capable endpoints can communicate with each other locally, to a remote H.323 endpoint through a gateway, or through an H.323 network.
Video capabilities are not enabled by default, and enabling video capabilities on Cisco Unified CME does not automatically enable video on all ephones. You must first enable video globally for all video-capable ephones associated with a Cisco Unified CME router and then enable video on each ephone individually.
Video parameters, like maximum bit rate, are set in video configuration mode.
Note After video is enabled globally, all video-capable ephones display the video icon.
Matching Endpoint Capabilities
During phone registration, information about endpoint capabilities is stored in the Cisco Unified CME. These capabilities are used to match with other endpoints during call setup. Endpoints can update at any time; however, the router recognizes endpoint-capability changes only during call setup. If a video feature is added to a phone, the information about it is updated in the router's internal data structure, but that information does not become effective until the next call. If a video feature is removed, the router continues to see the video capability until the call is terminated but no video stream is exchanged between the two endpoints.
Note The endpoint-capability match is executed each time a new call is set up or an existing call is resumed.
Retrieving Video Codec Information
Voice gateways use dial-peer configurations to retrieve codec information for audio codecs. Video codec selection is done by the endpoints and is not controlled by the H.323 service-provider interface (SPI) through dial-peer or other configuration. The video-codec information is retrieved from the SCCP endpoint using a capabilities request during call setup.
Call Fallback to Audio-Only
When a video-capable endpoint connects to an audio-only endpoint, the call falls back to an audio-only connection. Also, for certain features, such as conferencing, where video support is not available, the call falls back to audio-only.
Cisco Unified CME routers use a call-type flag to indicate whether the call is video-capable or audio-only. The call-type flag is set to video when the video capability is matched or set to audio-only when connecting to an audio-only TDM or an audio-only SIP endpoint.
Note During an audio-only connection, all video-related media messages are skipped.
Call Setup for Video Endpoints
The process for handling SCCP video endpoints is the same as that for handling SCCP audio endpoints. The video call must be part of the audio call. If the audio call setup fails, the video call fails.
During the call setup for video, media setup handling determines if a video-media-path is required. If so, the corresponding video-media-path setup actions are taken.
•For an SCCP endpoint, video-media-path setup includes sending messages to the endpoints to open a multimedia path and start the multimedia transmission.
•For an H.323 endpoint, video-media-path setup includes an exchange between the endpoints to open a logical channel for the video stream.
A call-type flag is set during call setup on the basis of the endpoint-capability match. After call setup, the call-type flag is used to determine whether an additional video media path is required. Call signaling is managed by the Cisco Unified CME router, and the media stream is directly connected between the two video-enabled SCCP endpoints on the same router. Video-related commands and flow-control messages are forwarded to the other endpoint. Routers do not interpret these messages.
Call Setup Between Two Local SCCP Endpoints
For interoperation between two local SCCP endpoints (that exist on the same router), video call setup uses all existing audio-call-setup handling, except during media setup. During media setup, a message is sent to establish the video-media-path. If the endpoint responds, the video-media-path is established and a start-multimedia-transmission function is called.
Call Setup Between SCCP and H.323 Endpoints
Call setup between SCCP and H.323 endpoints is the same as it is between SCCP endpoints except that if video capability is selected, the event is posted to the H.323 call leg to send out a video open logical channel (OLC) and the gateway generates an OLC for the video channel. Because the router needs to both terminate and originate the media stream, video must be enabled on the router before call setup begins.
Call Setup Between Two SCCP Endpoints Across an H.323 Network
If call setup between SCCP endpoints occurs across an H.323 network, the setup is a combination of the processes listed in the previous two sections. The router controls the video media setup between the two endpoints, and the event is posted to the H.323 call leg so that the gateway can generate an OLC.
Flow of the RTP Video Stream
For video streams between two local SCCP endpoints, the Real-Time Transport Protocol (RTP) stream is in flow-around mode. For video streams between SCCP and H.323 endpoints or two SCCP endpoints on different Cisco Unified CME routers, the RTP stream is in flow-through mode.
•Media flow-around mode enables RTP packets to stream directly between the endpoints of a VoIP call without the involvement of the gateway. By default, the gateway receives the incoming media, terminates the call, and then reoriginates it on the outbound call leg. In flow-around mode, only signaling data is passed to the gateway, improving scalability and performance.
•With flow-through mode, the video media path is the same as for an audio call. Media packets flow through the gateway, thus hiding the networks from each other.
Use the show voip rtp connection command to display information about RTP named-event packets, such as caller-ID number, IP address, and port for both the local and remote endpoints, as show in the following sample output.
Router# show voip rtp connections
VoIP RTP active connections :
No. CallId dstCallId LocalRTP RmtRTP LocalIP RemoteIP
1 102 103 18714 18158 10.1.1.1 192.168.1.1
2 105 104 17252 19088 10.1.1.1 192.168.1.1
Found 2 active RTP connections
============================
How to Configure Video for SCCP-Based Endpoints
This section contains the following tasks:
• Enabling Slow Connect Procedures for H.323 Endpoints (required)
• Setting Video Parameters (optional)
• Enabling Video Capabilities on a Specific Phone (required)
Enabling Slow Connect Procedures for H.323 Endpoints
Video streams require slow-connect procedures for Cisco Unified CME. H.323 endpoints also require slow-connect because the endpoint capability match occurs after the connect message. To enable slow connect procedures in Cisco Unified CME for H.323 endpoints, perform the following steps.
Note For more information on slow-connect procedures, see Configuring Quality of Service for Voice.
SUMMARY STEPS
1. enable
2. configure terminal
3. voice service voip
4. h323
5. call start slow
6. end
DETAILED STEPS
Setting Video Parameters
To set video parameters for all video-capable phones associated with a Cisco Unified CME router, perform the following steps.
SUMMARY STEPS
1. enable
2. configure terminal
3. telephony-service
4. service phone videoCapability {0 | 1}
5. video
6. maximum bit-rate value
7. end
DETAILED STEPS
Enabling Video Capabilities on a Specific Phone
To enable video for each video-capable SCCP phone associated with a Cisco Unified CME router, perform the following steps.
Prerequisites
Use the show ephone registered command to identify individual video-capable SCCP phones, by ephone-tag, that are registered in Cisco Unified CME. The following example shows that ephone 1 has video capabilities and ephone 2 is an audio-only phone.
Router# show ephone registered
ephone-1 Mac:0011.5C40.75E8 TCP socket:[1] activeLine:0 REGISTERED in SCCP ver 6 + Video and Server in ver 5 mediaActive:0 offhook:0 ringing:0 reset:0 reset_sent:0 paging 0 debug:0 caps:7 IP:10.1.1.6 51833 7970 keepalive 35 max_line 8 button 1: dn 1 number 8003 CH1 IDLE CH2 IDLE
ephone-2 Mac:0006.D74B.113D TCP socket:[2] activeLine:0 REGISTERED in SCCP ver 6 and Server in ver 5 mediaActive:0 offhook:0 ringing:0 reset:0 reset_sent:0 paging 0 debug:0 caps:7 IP:10.1.1.4 51123 Telecaster 7960 keepalive 36 max_line 6 button 1: dn 2 number 8004 CH1 IDLE CH2 IDLE button 2: dn 4 number 8008 CH1 IDLE CH2 IDLE
===========================================
SUMMARY STEPS
1. enable
2. configure terminal
3. ephone phone-tag
4. video
5. end
DETAILED STEPS
What to Do Next
If you are done modifying parameters for phones in Cisco Unified CME, generate a new configuration file and restart the phones. See "Generating Configuration Files for Phones" on page 265.
Verifying Video Support for SCCP-Based Endpoints
Step 1 Use the show running-config command to verify the video settings in the configuration.
•See the telephony-service portion of the output for commands that configure video support on the Cisco Unified CME.
•See the ephone portion of the output for commands that configure video support for a specific ephone.
The following example shows the telephony-service portion of the output:
telephony-service
video
maximum bit-rate 256
load 7960-7940 P00306000404
max-ephones 24
max-dn 24
ip source-address 10.0.180.130 port 2000
service phone videoCapability 1
timeouts interdigit 4
timeouts ringing 100
create cnf-files version-stamp Jan 01 2002 00:00:00
keepalive 60
max-conferences 4 gain -6
call-park system redirect
call-forward pattern .T
web admin system name cisco password cisco
web customize load xml.jeff
dn-webedit
time-webedit
transfer-system full-consult
transfer-pattern .T
The following example shows the ephone portion of the output:
ephone 6
video
mac-address 000F.F7DE.CAA5
type 7960
button 1:6
Troubleshooting Video Support for SCCP-Based Endpoints
Step 1 For SCCP endpoint troubleshooting, use the following debug commands:
•debug cch323 video—Enables video debugging trace on the H.323 service-provider interface (SPI).
•debug ephone detail—Debugs all Cisco Unified IP phones that are registered to the router, and displays error and state levels.
•debug h225 asn1—Displays Abstract Syntax Notation One (ASN.1) contents of H.225 messages that have been sent or received.
•debug h245 asn1—Displays ASN.1 contents of H.245 messages that have been sent or received.
•debug voip ccapi inout—Displays the execution path through the call-control application programming interface (CCAPI).
Step 2 For ephone troubleshooting, use the following debug commands:
•debug ephone message—Enables message tracing between Cisco Unified IP phones.
•debug ephone register—Sets registration debugging for Cisco Unified IP phones.
•debug ephone video—Sets ephone video traces, which provide information about different video states for the call, including video capabilities selection, start, and stop.
Step 3 For basic video-to-video call checking, use the following show commands:
•show call active video—Displays call information for SCCP video calls in progress.
•show ephone offhook—Displays information and packet counts for ephones that are off hook.
•show ephone registered—Displays the status of registered ephones.
•show voip rtp connections—Displays information about RTP named-event packets, such as caller ID number, IP address, and port for both the local and remote endpoints.
Additional References
The following sections provide references related to Cisco Unified CME features.
Related Documents
Related Topic Document TitleCisco Unified CME configuration
• Cisco Unified CME Command Reference
Cisco IOS commands
• Cisco IOS Voice Command Reference
Cisco IOS configuration
• Cisco IOS Voice Configuration Library
Phone documentation for Cisco Unified CME
Technical Assistance
Feature Information for Video Support for SCCP-Based Endpoints
Table 60 lists the features in this module and enhancements to the features by version.
To determine the correct Cisco IOS release to support a specific Cisco Unified CME version, see the Cisco Unified CME and Cisco IOS Software Version Compatibility Matrix at http://www.cisco.com/en/US/products/sw/voicesw/ps4625/products_documentation_roadmap09186a0080189132.html.
Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which Cisco IOS software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Note The following table lists the Cisco Unified CME version that introduced support for a given feature. Unless noted otherwise, subsequent versions of Cisco Unified CME software also support that feature.
Posted: Mon Sep 10 16:55:16 PDT 2007
All contents are Copyright © 1992--2007 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.