Citrix EasyCall Gateway Telephony System Integrator s Guide for Cisco Unified Communications Manager Citrix EasyCall Gateway 1.2
Copyright and Trademark Notice Use of the product documented in this guide is subject to your prior acceptance of the End User License Agreement. A printable copy of the End User License Agreement is included on your product USB-ROM and in the documentation download page of the administration tool. Information in this document is subject to change without notice. Companies, names, and data used in examples herein are fictitious unless otherwise noted. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Citrix Systems, Inc. 2006-2008 Citrix Systems, Inc. All rights reserved. Citrix, ICA (Independent Computing Architecture), MetaFrame, MetaFrame XP, NFuse, and Program Neighborhood are registered trademarks, and SpeedScreen and EasyCall are trademarks of Citrix Systems, Inc. in the United States and other countries. RSA Encryption 1996-1997 RSA Security Inc., All Rights Reserved. This product includes software developed by The Apache Software Foundation (http://www.apache.org/) Presentation Server Client: Portions of this software are based on code owned and copyrighted by O'Reilly Media, Inc. 1998. (CJKV Information Processing, by Ken Lunde. ISBN: 1565922247.) All rights reserved. Licensing: Portions of this documentation that relate to Globetrotter, Macrovision, and FLEXlm are copyright 2005 Macrovision Corporation. All rights reserved. Trademark Acknowledgements Adobe, Acrobat, and PostScript are trademarks or registered trademarks of Adobe Systems Incorporated in the U.S. and/or other countries. DB2 is a registered trademark of International Business Machines Corp. in the U.S. and other countries. Java, Sun, and SunOS are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. Solaris is a registered trademark of Sun Microsystems, Inc. Sun Microsystems, Inc has not tested or approved this product. Portions of this software are based in part on the work of the Independent JPEG Group. Portions of this software contain imaging code owned and copyrighted by Pegasus Imaging Corporation, Tampa, FL. All rights reserved. Microsoft, MS-DOS, Windows, Windows Media, Windows Server, Windows NT, Win32, Outlook, ActiveX, Active Directory, and DirectShow are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. SpeechMike is a trademark of Koninklijke Philips Electronics N.V. UNIX is a registered trademark of The Open Group. Licensing: Globetrotter, Macrovision, and FLEXlm are trademarks and/or registered trademarks of Macrovision Corporation. All other trademarks and registered trademarks are the property of their respective owners. Document Code: March 9, 2008 (KP)
CONTENTS Contents Chapter 1 Integration Overview Call Detail Records...................................................6 Chapter 2 Integrating with Cisco Unified Communications Manager 4.1(3) Configuring the SIP Trunk.............................................7 Verifying the Integration.............................................10 Chapter 3 Integrating with Cisco Unified Communications Manager 4.2(3) Configuring the SIP Trunk............................................11 Verifying the Integration.............................................14 Chapter 4 Integrating with Cisco Unified Communications Manager 5.1 Configuring the SIP Trunk............................................15 Verifying the Integration.............................................17 Chapter 5 Integrating with Cisco Unified Communications Manager 6.0 Configuring the SIP Trunk............................................19 Verifying the Integration.............................................21 Chapter 6 Integrating with Cisco Unified Communications Manager Express 3.2/4.0 Configuring the SIP Trunk............................................23 Verifying the Integration.............................................24
4 EasyCall Gateway Telephony System Integrator s Guide
CHAPTER 1 Integration Overview The EasyCall Gateway has been tested for interoperability with Cisco Unified Communications Manager, versions 4.1, 4.2, 5.1, and 6.0. It has also been tested for interoperability with Cisco Unified Communication Manger Express, versions 3.2 and 4.0. To enable the EasyCall Gateway to work with those Cisco systems, you must configure a SIP trunk between the EasyCall Gateway and the Cisco system. EasyCall Gateway integrated with Cisco Unified Communications Manager The integration described in this guide can be done in tandem with EasyCall Gateway installation and configuration, which includes defining the properties of the telephony system trunk and defining any changes the EasyCall Gateway makes to telephone numbers before sending them to the telephony system for dialing. The EasyCall Gateway always listens on port 5060. By default, the EasyCall Gateway communicates with the SIP trunk over port 5060; that port is configurable. For information about EasyCall Gateway configuration, refer to the EasyCall Gateway Administrator s Guide. Those responsible for configuring the telephone system must take the specific characteristics of a site into consideration to determine the settings that are appropriate for the site. The following topics describe how to configure SIP trunks for the supported Cisco systems. Integrating with Cisco Unified Communications Manager 4.1(3) on page 7 Integrating with Cisco Unified Communications Manager 4.2(3) on page 11
6 EasyCall Gateway Telephony System Integrator s Guide Call Detail Records Integrating with Cisco Unified Communications Manager 5.1 on page 15 Integrating with Cisco Unified Communications Manager 6.0 on page 19 Integrating with Cisco Unified Communications Manager Express 3.2/4.0 on page 23 A Call Detail Record (CDR) is a file that contains information about calls placed through the EasyCall Gateway. Information provided in the CDRs can be used for billing calls to cost centers and for auditing potential abuse.
CHAPTER 1 Integrating with Cisco Unified Communications Manager 4.1(3) This chapter describes a sample configuration of Cisco Unified Communications Manager 4.1(3) for integration with the EasyCall Gateway through a SIP trunk. The examples show the Cisco Unified Communications Manager (previously referred to as CallManager) administration software screens. The following topics describe the integration: Configuring the SIP Trunk on page 7 Verifying the Integration on page 10 Configuring the SIP Trunk The following screens show a sample Trunk Configuration. The default values required for the trunk to be active are included. The table following the screens describes the values that are important for EasyCall Gateway integration.
8 EasyCall Gateway Telephony System Integrator s Guide Trunk Configuration page: version 4.1(3)
Chapter 1 Integrating with Cisco Unified Communications Manager 4.1(3) 9 Trunk Configuration page (continued): version 4.1(3) Setting Destination Address Destination Port Description The IP address of the EasyCall Gateway. The port of the proxy server. Defaults to 5060 and should not be changed. Incoming Port The listening port of the Unified Communication Manager. Defaults to 5062. Outgoing Transport Type Must be UDP. Preferred Originating Codec Must be 711ulaw. Note The PBX administrator must provide the following call routing information for Inbound Calls section of the SIP trunk configuration: Calling Search Space AAR Calling Search Space If either of these values is not required, select None.
10 EasyCall Gateway Telephony System Integrator s Guide Verifying the Integration Install the EasyCall Agent on one or more user PCs and place different types of calls (domestic, international).
CHAPTER 2 Integrating with Cisco Unified Communications Manager 4.2(3) This chapter describes a sample configuration of Cisco Unified Communications Manager 4.2(3) for integration with the EasyCall Gateway through a SIP trunk. The examples show the Cisco Unified Communications Manager (previously referred to as CallManager) administration software screens. The following topics describe the integration: Configuring the SIP Trunk on page 11 Verifying the Integration on page 14 Configuring the SIP Trunk The following screens show a sample Trunk Configuration. The default values required for the trunk to be active are included. The table following the screens describes the values that are important for EasyCall Gateway integration.
12 EasyCall Gateway Telephony System Integrator s Guide Trunk Configuration page: version 4.2(3)
Chapter 2 Integrating with Cisco Unified Communications Manager 4.2(3) 13 Trunk Configuration page (continued): version 4.2(3) Setting Destination Address Description The IP address of the EasyCall Gateway. Destination Port The port of the proxy server. Defaults to 5060 and should not be changed. Incoming Port The listening port of the Unified Communication Manager. Defaults to 5062. Outgoing Transport Type Must be UDP. Preferred Originating Must be 711ulaw. Codec Note The PBX administrator must provide the following call routing information for Inbound Calls section of the SIP trunk configuration: Calling Search Space AAR Calling Search Space If either of these values is not required, select None.
14 EasyCall Gateway Telephony System Integrator s Guide Verifying the Integration Install the EasyCall Agent on one or more user PCs and place different types of calls (domestic, international).
CHAPTER 3 Integrating with Cisco Unified Communications Manager 5.1 This chapter describes a sample configuration of Cisco Unified Communications Manager 5.1 for integration with the EasyCall Gateway through a SIP trunk. The examples show the Cisco Unified Communications Manager (previously referred to as CallManager) administration software screens. The following topics describe the integration: Configuring the SIP Trunk on page 15 Verifying the Integration on page 17 Configuring the SIP Trunk The following screens show a sample Trunk Configuration. The default values required for the trunk to be active are included. The table following the screens describes the values that are important for EasyCall Gateway integration.
16 EasyCall Gateway Telephony System Integrator s Guide Trunk Configuration page: version 5.1 Trunk Configuration page (continued): version 5.1
Chapter 3 Integrating with Cisco Unified Communications Manager 5.1 17 Trunk Configuration page (continued): version 5.1 Setting Destination Address Destination Port Description Note The PBX administrator must provide the following call routing information for Inbound Calls section of the SIP trunk configuration: Calling Search Space AAR Calling Search Space If either of these values is not required, select None. Verifying the Integration The address of the proxy server for the outgoing calls. The address can be the IP, FQDN, or DNS server. This is not the EasyCall Gateway address. The port of the proxy server. Defaults to 5060 and should not be changed. Incoming Port The listening port of the Unified Communication Manager. Defaults to 5062. SIP Trunk Security Profile Preferred Originating Codec Must be Non Secure SIP Trunk Profile. Must be 711ulaw. Install the EasyCall Agent on one or more user PCs and place different types of calls (domestic, international).
18 EasyCall Gateway Telephony System Integrator s Guide
CHAPTER 4 Integrating with Cisco Unified Communications Manager 6.0 This chapter describes a sample configuration of Cisco Unified Communications Manager 6.0 for integration with the EasyCall Gateway through a SIP trunk. The examples show the Cisco Unified Communications Manager (previously referred to as CallManager) administration software screens. The following topics describe the integration: Configuring the SIP Trunk on page 19 Verifying the Integration on page 21 Configuring the SIP Trunk The following screens show a sample Trunk Configuration. The default values required for the trunk to be active are included. The table following the screens describes the values that are important for EasyCall Gateway integration.
20 EasyCall Gateway Telephony System Integrator s Guide Trunk Configuration page: version 6.0 Trunk Configuration page (continued): version 6.0
Chapter 4 Integrating with Cisco Unified Communications Manager 6.0 21 Trunk Configuration page (continued): version 6.0 Setting Destination Address Destination Port Media Termination Point Required SIP Trunk Security Profile Preferred Originating Codec Description The address of the proxy server for the outgoing calls. The address can be the IP, FQDN, or DNS server. This is not the EasyCall Gateway address. The port of the proxy server. Defaults to 5060 and should not be changed. Note that this setting is no longer selected, as of Communication Manager 6.0. Must be Non Secure SIP Trunk Profile - UDP. Must be 711ulaw. Note The PBX administrator must provide the following call routing information for Inbound Calls section of the SIP trunk configuration: Calling Search Space AAR Calling Search Space If either of these values is not required, select None. Verifying the Integration Install the EasyCall Agent on one or more user PCs and place different types of calls (domestic, international).
22 EasyCall Gateway Telephony System Integrator s Guide
CHAPTER 5 Integrating with Cisco Unified Communications Manager Express 3.2/4.0 This chapter describes a sample configuration of Cisco Unified Communications Manager Express 3.2 and 4.0 for integration with the EasyCall Gateway through a SIP trunk. The following topics describe the integration: Configuring the SIP Trunk on page 23 Verifying the Integration on page 24 Configuring the SIP Trunk To configure the Cisco Unified Communications Manager Express for integration with the EasyCall Gateway through a SIP trunk, perform the following processes: 1. Log into Cisco Unified Communications Manager Express command-line utility. 2. Set the router to configuration mode with the following command: ccme# config terminal 3. Configure the codecs with the following commands: ccme(config)# voice class codec 1 ccme(config-class)# codec 1 g711ulaw ccme(config-class)# codec 2 g711alaw ccme(configu-class)# exit ccme(config)#
24 EasyCall Gateway Telephony System Integrator s Guide 4. Configure the Voice Over IP service with the following commands: ccme(config)# voice service voip ccme(conf-voi-serv)# allow-connections sip to sip ccme(conf-voi-serv)# exit ccme(config)# exit ccme# Verifying the Integration Install the EasyCall Agent on one or more user PCs and place different types of calls (domestic, international).