Configuration Guide for Cisco UC Integration for Cisco WebEx Connect 6.x

Table Of Contents

Configuration Guide for Cisco UC Integration for Cisco WebEx Connect 6.x

Cisco UC Integration for Cisco WebEx Connect Overview

Configuration Summary

Configuring the Device Type on Cisco Unified Communications Manager

Preparing Cisco Unified Communications Manager

Creating Devices and Directory Numbers for Users

Configuring and Installing Dialing Rules

Configuring Dialing Rules

Installing Dialing Rules

Verifying the Dialing Rules Installation

Restarting the TFTP Service

Adding Users to the Standard CTI User Groups

Configuring Cisco UC Integration for Cisco WebEx Connect

For Your Reference: Key Name Values

Installing Cisco UC Integration for Cisco WebEx Connect

Installation Package Contents

Obtaining Documentation and Submitting a Service Request

Configuration Guide

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:

1. Configuring the Device Type on Cisco Unified Communications Manager

2. Configuring and Installing Dialing Rules

3. Configuring Cisco UC Integration for Cisco WebEx Connect

4. Installing Cisco UC Integration for Cisco WebEx Connect

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:

http://www.cisco.com/en/US/products/sw/voicesw/ps556/tsd_products_support_general_information.html

•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:

http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_maintenance_guides_list.html

•Cisco CTIManager service. For information about Cisco CTIManager service, see the Cisco Unified Communications Manager System Guide at the following URL:

http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_maintenance_guides_list.html

•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:

http://tools.cisco.com/support/downloads/go/Redirect.x?mdfid=278875240

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:

http://www.cisco.com/en/US/docs/voice_ip_comm/cucm/rel_notes/7_0_1/cucm-rel_notes-701.html#wp684478

Creating Devices and Directory Numbers for Users

Procedure

---

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:

Table 1 Phone Configuration Window Fields

Field	Description
Device Name	Enter a name to identify the Cisco Unified Client Services Framework device. The name can contain 1 to 15 characters, including alphanumeric characters, periods, hyphens, and underscores. The device name does not need to relate to the user ID of the user.
Device Pool	Select the device pool to which you want the phone assigned. The device pool defines sets of common characteristics for devices, such as region, date/time group, softkey template, and Multilevel Precedence and Preemption (MLPP) information.
Phone Button Template	Select the appropriate phone button template. The phone button template determines the configuration of buttons on a phone and identifies which feature (line, speed dial, and so on) is used for each button.
Allow Control of Device from CTI	Select this option if you want Cisco UC Integration for Cisco WebEx Connect to be able to control the desk phone of the user with the Computer Telephony Integration (CTI) server. Ensure that the user is added to the Standard CTI Enabled user group.
Device Security Profile	Select the security profile you require for the phone. If you select Client Services Framework- Standard SIP Secure Profile, do the following: 1. Enter certification and authentication information in the Certification Authority Proxy Function (CAPF) Information section. 2. Select Generate String. 3. Email the contents of the Authentication String field to the user.
SIP Profile	Select the default SIP profile or a specific profile that was previously created. SIP profiles provide specific SIP information for the phone such as registration and keepalive timers, media ports, and do not disturb control.

---

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:

http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_maintenance_guides_list.html

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:

http://tools.cisco.com/support/downloads/go/Redirect.x?mdfid=278875240

Procedure

---

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:

•AppDialRules.xml

•DirLookupDialRules.xml

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:

http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_maintenance_guides_list.html

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.

Procedure

---

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:

http://www.webex.com/webexconnect/orgadmin/help/index.htm

---

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:

http://www.webex.com/webexconnect/help/wwhelp.htm

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

Table 2 Server and Voice Message Service Key Names

Value Names	Description
TftpServer1, TftpServer2, TftpServer3	Enter the IP address of the primary TFTP server in your Cisco Unified Communications system, and any other TFTP servers.
CtiServer1, CtiServer2	Enter the IP address of the primary CTIManager server in your Cisco Unified Communications system, and the secondary CTIManager server, if present.
CcmcipServer1, CcmcipServer2	Enter the IP address of the primary CCMCIP server in your Cisco Unified Communications system, and the secondary CCMCIP server, if present.
CcmcipServerValidation	Enter the validation certificate type Cisco Unified CSF will use when using HTTPS to sign in to Cisco Unified Communications Manager to retrieve the device list. 0 - CSF accepts all certificates. 1 - (default) CSF accepts certificates defined in the keystore and self signed certificate 2 - CSF only accepts certificates defined in the keystore. (located at {location_of_jre}/lib/security. By default, the JRE is located at "C:\Program Files\Common Files\Cisco Systems\Client Services Framework") Note: This is the certificate used by Cisco Unified CSF to verify the validity of the Cisco Unified Communications Manager server. Once the certificate is accepted, Cisco Unified CSF has to use the user's credentials to log into Cisco Unified Communications Manager.
VoicemailPilotNumber	Enter the number of the voice message service in your Cisco Unified Communications system.

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:

http://www.cisco.com/en/US/products/ps10627/prod_release_notes_list.html

http://www.webex.com/m/connectreleasenotes_c6.pdf

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:

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

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.