Table Of Contents
Configuration Guide for Cisco UC Integration for Cisco WebEx Connect 6.x
Revised: March 8, 2011
1 Cisco UC Integration for Cisco WebEx Connect Overview
The Cisco UC Integration for Cisco WebEx Connect adds a phone tab to Cisco WebEx Connect. This new space turns the user's computer into a full-featured phone, allowing them to place, receive, and manage calls.
Cisco UC Integration for Cisco WebEx Connect is built on a client services framework integration which provides call control services, call history, message waiting indicators, media, and so on.
The Cisco WebEx Connect service in the cloud provides the remaining services, including instant messaging, presence, and spaces. You can perform the following tasks from the phone tab:
•Place and receive phone calls.
•Call your voice message service.
•Display your communications history.
•Set options for the communications pane.
•Switch phone modes. You can choose whether you want to control your desk phone from the computer, or use the audio and microphone on your computer to handle calls. You can easily toggle between these options.
2 Configuration Summary
The major tasks for configuring Cisco UC Integration for Cisco WebEx Connect are as follows:
3 Configuring the Device Type on Cisco Unified Communications Manager
Configuring Cisco Unified Communications Manager for Cisco UC Integration for Cisco WebEx Connect, involves adding the device type to Cisco Unified Communications Manager and setting up the directory number. Before you begin you must have a properly working Cisco Unified Communications configuration with the following services enabled:
•Cisco Unified Communications Manager service. For information about the Cisco Unified Communications Manager service see the documentation at the following URL:
•Cisco Trivial File Transfer Protocol (TFTP) service. For information about Cisco TFTP service, see the Cisco Unified Communications Manager System Guide at the following URL:
•Cisco CTIManager service. For information about Cisco CTIManager service, see the Cisco Unified Communications Manager System Guide at the following URL:
•Cisco Unified Communications Manager IP Phone (CCMCIP) service.
Preparing Cisco Unified Communications Manager
The Cisco UC Integration for Cisco WebEx Connect requires a new Cisco Unified Communications Manager device type called Client Services Framework. Depending on which release of Cisco Unified Communications Manager is installed in your Cisco Unified Communications system, you might need to patch Cisco Unified Communications Manager with a Cisco Options Package (COP) file.
You must run the COP file if your Cisco Unified Communications Manager does not have the Client Services Framework device type. You run the COP file on the Cisco Unified Communications Manager publisher server. After you apply the COP file, you must restart the Cisco Unified Communications Manager publisher server, and all other servers.
The COP file is available from the Administration Toolkit. To access the Administration Toolkit, navigate to Cisco UC Integration for Cisco WebEx Connect from the Download Software page at the following URL:
Please note you must run the COP file to create the Client Services Framework device type on Cisco Unified Communications Manager versions 6.1(3).
For more information refer to the Cisco Unified Communications Manager release notes:
Creating Devices and Directory Numbers for Users
Step 1 Select Device > Phone in Cisco Unified Communications Manager Administration.
Step 2 Select Add New.
Step 3 Select Client Services Framework from the Phone Type list box.
Step 4 Select Next.
Step 5 Enter information for the phone in the Phone Configuration window, as follows:
Note Cisco UC Integration for Cisco WebEx Connect does not support secure phone device configurations.
Step 6 Select Save.
Step 7 Select the Add a new DN link in the Association Information section on the Phone Configuration window.
Step 8 Enter information for the directory number on the Directory Number Configuration window.
Step 9 Select Save.
Step 10 Select Associate End Users on the Directory Number Configuration window.
Step 11 Search for the user in the Find and List Users window, select the user, then select Add Selected.
Step 12 Select Save.
Step 13 Select User Management > End User in Cisco Unified Communications Manager Administration.
Step 14 Search for the user in the Find and List Users window, then select the user.
Step 15 Verify that the device is listed for the user in the Controlled Devices list box in the Device Associations group.
4 Configuring and Installing Dialing Rules
Dialing rules provide phone number translation between the directory service and Cisco Unified Communications Manager.
Application dialing rules automatically strip numbers from or add numbers to telephone numbers that a user dials. For example, the dialing rules automatically add the digit 9 in front of a 7-digit telephone number to provide access to an outside line. Directory lookup rules transform caller identification numbers into numbers that can be looked up in the directory.
You must create a set of dialing rules for contact name resolution. You must configure and export application dialing rules and directory lookup dialing rules every time dialing rules are changed. An XML file is created that Cisco Unified CSF clients download and interpret.
Contact name resolution is required to access all functionality offered by Cisco UC Integration for Cisco WebEx Connect. Numbers entered by users in their profile settings must be synchronized with Cisco Unified Communications Manager settings. These numbers can also be set in the Cisco WebEx Connect Administration Console.
Tip Ensuring that these rules exist and are available is a requirement. Most dialing related issues are a result of non-existent rules, old rules, or invalid rules.
Configuring Dialing Rules
For detailed conceptual and task-based information on dialing rules, see the Cisco Unified Communications Manager Administration online help or the Cisco Unified Communications Manager Administration Guide and the Cisco Unified Communications Manager System Guide:
The following rule types are required:
•Application dialing rules
•Directory lookup dialing rules
Note You may already have these rules configured for other Cisco applications. If they exist, you may skip the following procedure.
Installing Dialing Rules
If your Cisco Unified Communications Manager uses dialing rules, you must ensure that Cisco Unified Communications Integration for Cisco WebEx Connect can access these dialing rules.
You must run a Cisco Options Program (COP) file to generate copies of the dialing rules in XML format, which Cisco UC Integration for Cisco WebEx Connect can access, download and interpret. The COP file is available from the Administration Toolkit. To access the Administration Toolkit, navigate to Cisco UC Integration for Cisco WebEx Connect from the Download Software page at the following URL:
Step 1 Select Software Upgrades -> Install/Upgrade in Cisco Unified Operating System Administration.
Step 2 Select New install.
Step 3 Specify the source of the COP file Software Installation/Upgrade window.
Step 4 Select Next.
Step 5 Select the appropriate COP file from the Available Software list box.
Step 6 Select Next.
Step 7 Select Install.
Verifying the Dialing Rules Installation
Verify that the following files are present in the /usr/local/cm/tftp/CUPC directory of the TFTP server:
Restarting the TFTP Service
After you verify the generation of the copies of the dialing rules, restart the TFTP service. You must restart the TFTP service on every server on which you ran the COP file.
For information about how to restart TFTP services, see Cisco Unified Serviceability Administration Guide at the following URL:
5 Adding Users to the Standard CTI User Groups
If you want Cisco UC Integration for Cisco WebEx Connect to be able to control the desk phone of the user, you must select the Allow Control of Device from CTI option when you create the device for the user. You must also ensure that the user is added to the Standard CTI Enabled user group.
If the phone of the user is a Cisco Unified IP Phone 6900, 8900 or 9900 series model, you must also add the user to the Standard CTI Allow Control of Phones supporting Connected Xfer and conf user group.
Step 1 Select User Management > End User in Cisco Unified Communications Manager Administration.
Step 2 Select the user that you want to add.
Step 3 Select Add to User Group in the Permissions Information group in the End User Configuration window.
Step 4 Search for "Standard CTI" in the Find and List User Groups window.
Step 5 Select the Standard CTI Enabled user group.
If the phone of the user is a Cisco Unified IP Phone 6900, 8900 or 9900 series model, select the Standard CTI Allow Control of Phones supporting Connected Xfer and conf user group also.
Step 6 Select Add Selected.
Step 7 Select Save in the End User Configuration window.
6 Configuring Cisco UC Integration for Cisco WebEx Connect
There are multiple methods to configure Cisco WebEx Connect to work with the Cisco Unified Client Services Framework:
1. Cisco WebEx Connect Administration Console: Access the online help for the WebEx Connect Administration Console for complete information. This is the preferred configuration method. You can access the help at the following location:
Note Using multiple Cisco Unified CSF clients is not a supported scenario.
2. Use a generic Windows application configuration mechanism, such as Active Directory group policy, or running a batch script, to populate registry values. See Table 2 for registry values that need to be populated.
3. Cisco WebEx Connect, the Unified Communications tab within the Settings page: The user can input configuration settings. It is important to note if you use this method you cannot configure backup servers. This option can be used after step 6 Installing Cisco UC Integration for Cisco WebEx Connect is complete.
For more information about the Settings page, you access the Cisco WebEx Connect help at the following location:
For Your Reference: Key Name Values
Table 2 lists the name-value pairs that you must use to specify the servers and voice message service configuration. Please note, all of these values have the REG_SZ data type. Specify the Cisco Unified CSF configuration in the following registry key:
HKEY_CURRENT_USER\Software\Cisco Systems, Inc.\Client Services Framework\AdminData
7 Installing Cisco UC Integration for Cisco WebEx Connect
Before you install Cisco UC Integration for Cisco WebEx Connect, check that your system meets all the necessary prerequisites. Ensure that you have the correct versions of all the required software, as listed in the release notes at the following URLs:
Please note, in addition to a single installer package that contains both applications, Cisco UC Integration for Cisco WebEx Connect and Cisco WebEx Connect Version C6 are available as two separate installers. There is no specific order to follow for installation. If you have already installed Cisco WebEx Connect, make sure you exit the application before you install the Cisco Unified Communications Integration component.
Installation Package Contents
The Cisco UC Integration for Cisco WebEx Connect installation package contains the following:
–An executable file. Users can run the executable file on their computer.
–A Microsoft Installer (MSI) file. This file assumes that .NET 2.0 or later is already installed. This is used for silent installation with a push mechanism such as Active Directory Group Policy, Microsoft System Management Server (SMS), Altiris and so on.
Note Before you install the MSI file, each user's machine must have .NET 2.0 or later installed.
8 Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:
Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS Version 2.0.
CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco IronPort, the Cisco logo, Cisco Nurse Connect, Cisco Pulse, Cisco SensorBase, Cisco StackPower, Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flipshare (Design), Flip Ultra, Flip Video, Flip Video (Design), Instant Broadband, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Capital, Cisco Capital (Design), Cisco:Financed (Stylized), Cisco Store, Flip Gift Card, and One Million Acts of Green are service marks; and Access Registrar, Aironet, AllTouch, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Lumin, Cisco Nexus, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, Continuum, EtherFast, EtherSwitch, Event Center, Explorer, Follow Me Browsing, GainMaker, iLYNX, IOS, iPhone, IronPort, the IronPort logo, Laser Link, LightStream, Linksys, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, PCNow, PIX, PowerKEY, PowerPanels, PowerTV, PowerTV (Design), PowerVu, Prisma, ProConnect, ROSA, SenderBase, SMARTnet, Spectrum Expert, StackWise, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0910R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2011 Cisco Systems, Inc. All rights reserved.