Cisco Unified Communications Manager Express SIP Trunk Integration Guide for Cisco Unity Connection Release 7.x
Setting Up a Cisco Unified CallManager Express SIP Trunk Integration with Cisco Unity Connection
Downloads: This chapterpdf (PDF - 157.0KB) The complete bookPDF (PDF - 702.0KB) | Feedback

Setting Up a Cisco Unified Communications Manager Express SIP Trunk Integration with Cisco Unity Connection

Table Of Contents

Setting Up a Cisco Unified Communications Manager Express SIP Trunk Integration with Cisco Unity Connection

Integration Tasks

Requirements

Programming the Cisco Unified Communications Manager Express Phone System for Integrating with Cisco Unity Connection

Creating a New Integration with Cisco Unified Communications Manager Express


Setting Up a Cisco Unified Communications Manager Express SIP Trunk Integration with Cisco Unity Connection


For detailed instructions for setting up a Cisco Unified Communications Manager Express SIP trunk integration with Cisco Unity Connection, see the following sections in this chapter:

Integration Tasks

Requirements

Programming the Cisco Unified Communications Manager Express Phone System for Integrating with Cisco Unity Connection

Creating a New Integration with Cisco Unified Communications Manager Express

This document does not apply to the configuration in which Cisco Unity Connection is installed as Cisco Unified Communications Manager Business Edition (CMBE)—on the same server with Cisco Unified Communications Manager.


Note Cisco Unified Communications Manager Express does not support Keypad Markup Language (KPML) for sending DTMF keystrokes in a SIP message (out-of-band).


Integration Tasks

Before doing the following tasks to integrate Cisco Unity Connection with Cisco Unified CM Express through a SIP trunk, confirm that the Cisco Unity Connection server is ready for the integration by completing the applicable tasks in the Installation Guide for Cisco Unity Connection.

1. Review the system and equipment requirements to confirm that all phone system and Cisco Unity Connection server requirements have been met. See the "Requirements" section.

2. Plan how the voice messaging ports will be used by Cisco Unity Connection. See Chapter 2, "Planning How the Voice Messaging Ports Will Be Used by Cisco Unity Connection."

3. Program Cisco Unified CM Express. See the "Programming the Cisco Unified Communications Manager Express Phone System for Integrating with Cisco Unity Connection" section.

4. Create the integration. See the "Creating a New Integration with Cisco Unified Communications Manager Express" section.

5. Test the integration. See Chapter 4, "Testing the Integration."

6. If this integration is a second or subsequent integration, add the applicable new user templates for the new phone system. See Chapter 5, "Adding New User Template for Multiple Integrations."

Requirements

The Cisco Unified CM Express SIP integration supports configurations of the following components:

Phone System

A compatible version of Cisco Unified CM Express.

For details on compatible versions of Cisco Unified CM Express, refer to the SIP Trunk Compatibility Matrix: Cisco Unity Connection, Cisco Unified Communications Manager, and Cisco Unified Communications Manager Express at http://www.cisco.com/en/US/products/ps6509/products_device_support_tables_list.html.

A compatible Cisco IOS software version. Refer to the Cisco Unified CME and Cisco IOS Software Version Compatibility Matrix at http://www.cisco.com/en/US/products/sw/voicesw/ps4625/prod_installation_guide09186a00805acf50.html.

Cisco Unified CM Express feature license.

Cisco IP phone feature licenses, and Cisco licenses for other H.323-compliant devices or software (such as Cisco VirtualPhone and Microsoft NetMeeting clients) that will be connected to the network, as well as one license for each Cisco Unity Connection port.

For the Cisco Unified CM Express extensions, SIP phones that support DTMF relay as described in RFC-2833. For a list of supported Cisco IP phone models, refer to the applicable Supported Firmware, Platforms, Memory, and Voice Products document at http://www.cisco.com/en/US/products/sw/voicesw/ps4625/prod_installation_guides_list.html.

For the Cisco Unified CM Express extensions, one of the following configurations:

Only SIP phones.

Both SCCP phones and SIP phones.

Note that older SCCP phone models may require a Media Termination Point (MTP) to function correctly.

A LAN connection in each location where you will plug the applicable phone into the network.

Cisco Unity Connection Server

The applicable version of Cisco Unity Connection. For details on compatible versions of Cisco Unity Connection, refer to the SIP Trunk Compatibility Matrix: Cisco Unity Connection, Cisco Unified Communications Manager, and Cisco Unified Communications Manager Express at http://www.cisco.com/en/US/products/ps6509/products_device_support_tables_list.html.

Cisco Unity Connection installed and ready for the integration, as described in the Installation Guide for Cisco Unity Connection at http://www.cisco.com/en/US/products/ps6509/prod_installation_guides_list.html.

A license that enables the applicable number of voice messaging ports.

Programming the Cisco Unified Communications Manager Express Phone System for Integrating with Cisco Unity Connection

Revised December 11, 2008

For details on programming the Cisco Unified Communications Manager Express router for the integration with Cisco Unity Connection, refer to the "Integrating Voice Mail" chapter of the Cisco Unified Communications Manager Express System Administrator Guide at http://www.cisco.com/en/US/products/sw/voicesw/ps4625/products_installation_and_configuration_guides_list.html.

After you have configured the Cisco Unified CM Express router for the integration, do the applicable following procedures:

For Cisco Unified CM Express 4.1 or later, if calls can be received from a Cisco Unified Communications Manager SIP trunk, do the "To Configure the Cisco Unified Communications Manager Express Router When It is Connected to a Cisco Unified Communications Manager SIP Trunk (Cisco Unified Communications Manager Express 4.1 or Later)" procedure.

For a Cisco Unity Connection cluster, do the "To Configure the Cisco Unified Communications Manager Express Router for a Cisco Unity Connection Cluster" procedure.

To Configure the Cisco Unified Communications Manager Express Router When It is Connected to a Cisco Unified Communications Manager SIP Trunk (Cisco Unified Communications Manager Express 4.1 or Later)


Step 1 On the Cisco Unified CM Express router, go into the global configuration mode by entering the following command:

configure terminal

Step 2 To enter the voice service configuration mode, enter the following command:

voice service voip

Step 3 To disable the 302 "Moved Temporarily" SIP message, enter the following command:

no supplementary-service sip moved-temporarily

Step 4 To exit the global configuration mode, enter the following command:

exit


To Configure the Cisco Unified Communications Manager Express Router for a Cisco Unity Connection Cluster


Step 1 On the Cisco Unified CM Express router, go into the global configuration mode by entering the following command:

configure terminal

Step 2 To enter dial-peer configuration mode for port group for the publisher server, enter the following command:

dial-peer voice <number> voip

Step 3 To set the description for the dial-peer, enter the following command:

description <name of publisher server>

Step 4 To set the Cisco Unity Connection pilot number for the dial-peer, enter the following command:

destination-pattern <pilot number>

Step 5 To configure the dial-peer to use Session Initiation Protocol (SIP) for calls, enter the following command:

session protocol sipv2

Step 6 To specify the IP address (or DNS name) of the publisher server, enter the following command:

session target {ipv4:<IP address>|dns:<host name>}

Step 7 To enable DTMF relay, enter the following command:

dtmf-relay rtp-nte

Step 8 To set the codec for calls, enter the following command:

codec <codec used for calls>

Step 9 To equalize the number of calls sent to each Cisco Unity Connection server in the Connection cluster, enter the following command:

max-conn <number of ports handled by publisher server>

Step 10 To set the dial-peer preference for port group so that the calls will be routed first to the subscriber server, then to the publisher server if no ports are available on the subscriber server, enter the following command:

preference 2

Step 11 To enable huntstop, enter the following command:

huntstop

Step 12 To exit the global configuration mode, enter the following command:

exit

Step 13 To set a dial-peer that will prevent Cisco Unified CM Express from hunting beyond the dial-peers for the Cisco Unity Connection port groups, entering the following command:

configure terminal

Step 14 To enter dial-peer configuration mode, enter the following command:

dial-peer voice <number> voip

Step 15 To set the description for the dial-peer, enter the following command:

description <name of subscriber server>

Step 16 To set the Cisco Unity Connection pilot number for the dial-peer, enter the following command:

destination-pattern <pilot number>

Step 17 To configure the dial-peer to use Session Initiation Protocol (SIP) for calls, enter the following command:

session protocol sipv2

Step 18 To specify the IP address (or DNS name) of the subscriber server, enter the following command:

session target {ipv4:<IP address>|dns:<host name>}

Step 19 To enable DTMF relay, enter the following command:

dtmf-relay rtp-nte

Step 20 To set the codec for calls, enter the following command:

codec <codec used for calls>

Step 21 To equalize the number of calls sent to each Cisco Unity Connection server in the Connection cluster, enter the following command:

max-conn <number of ports handled by subscriber server>

Step 22 To set the dial-peer preference so that the calls will be routed first to the subscriber server, then to the publisher server if no ports are available on the subscriber server, enter the following command:

preference 1

Step 23 To disable huntstop so that the calls will use the next available voice messaging port on the subscriber server, then use voice messaging ports on the publisher server if no ports are available on the subscriber server, enter the following command:

no huntstop

Step 24 To exit the global configuration mode, enter the following command:

exit


The following is an example of the configuration without a Cisco Unity Connection cluster:

!
dial-peer voice 2 voip
 description CUC1
 destination-pattern 8000
 session protocol sipv2
 session target ipv4:<IP address>
 dtmf-relay rtp-nte
 codec g711ulaw
 max-conn 4
 preference 1
 huntstop
!

The following is an example of the configuration with a Cisco Unity Connection cluster configured:

!
dial-peer voice 2 voip
 description CUC1
 destination-pattern <pilot number>
 session protocol sipv2
 session target ipv4:<IP address of publisher server>
 dtmf-relay rtp-nte
 codec g711ulaw
 max-conn 4
 preference 2
 huntstop
!
dial-peer voice 4 voip
 description CUC2
 destination-pattern <pilot number>
 session protocol sipv2
 session target ipv4:<IP address of subscriber server>
 dtmf-relay rtp-nte
 codec g711ulaw
 max-conn 4
 preference 1
 no huntstop
!

Creating a New Integration with Cisco Unified Communications Manager Express

After ensuring that Cisco Unified Communications Manager Express and Cisco Unity Connection are ready for the integration, do the following procedure to set up the integration and to enter the port settings.

To Create an Integration


Step 1 Log on to Cisco Unity Connection Administration.

Step 2 In Cisco Unity Connection Administration, expand Telephony Integrations, then click Phone System.

Step 3 On the Search Phone Systems page, under Display Name, click the name of the default phone system.

Step 4 On the Phone System Basics page, in the Phone System Name field, enter the descriptive name that you want for the phone system.

Step 5 If you want to use this phone system for TRaP connections (when users record and playback through the phone in Cisco Unity Connection web applications), check the Default TRAP Switch check box. If you want to use another phone system for TRaP connections, uncheck this check box.

Step 6 Click Save.

Step 7 On the Phone System Basics page, in the Related Links drop-down box, click Add Port Group and click Go.

Step 8 On the New Port Group page, enter the applicable settings and click Save.

Table 3-1 Settings for the New Port Group Page 

Field
Setting

Phone System

Click the name of the phone system that you entered in Step 4.

Create From

Click Port Group Template and click SIP in the drop-down box.

Display Name

Enter a descriptive name for the port group. You can accept the default name or enter the name that you want.

Authenticate with SIP Server

Check this check box if you want Cisco Unity Connection to authenticate with the Cisco Unified CM Express router.

Authentication User Name

Enter the name that Cisco Unity Connection will use to authenticate with the Cisco Unified CM Express router.

Authentication Password

Enter the password that Cisco Unity Connection will use to authenticate with the Cisco Unified CM Express router.

Contact Line Name

Enter the voice messaging line name (or pilot number) that users will use to contact Cisco Unity Connection and that Cisco Unity Connection will use to register with the Cisco Unified CM Express router.

SIP Security Profile

Click the SIP security profile that Cisco Unity Connection will use.

Note Cisco Unified CM Express does not support Cisco Unified CM authentication and encryption.

SIP Transport Protocol

Click the SIP transport protocol that Cisco Unity Connection will use.

IP Address or Host Name

Enter the IP address (or host name) of the Cisco Unified CM Express router that you are integrating with Cisco Unity Connection.

Port

Enter the IP port of the Cisco Unified CM Express router that you are integrating with Cisco Unity Connection. We recommend that you use the default setting.


Step 9 On the Port Group Basics page, in the Related Links drop-down box, click Add Ports and click Go.

Step 10 On the New Port page, enter the following settings and click Save.

Table 3-2 Settings for the New Port Page 

Field
Setting

Enabled

Check this check box.

Number of Ports

Enter the number of voice messaging ports that you want to create in this port group.

Note For a Cisco Unity Connection cluster, you must enter the total number of voice messaging ports that will be used by all Cisco Unity Connection servers. Each port will later be assigned to a specific Cisco Unity Connection server.

Phone System

Click the name of the phone system that you entered in Step 4.

Port Group

Click the name of the port group that you added in Step 8.

Server Name

Click the name Cisco Unity Connection server.


Step 11 On the Search Ports page, click the display name of the first voice messaging port that you created for this phone system integration.


Note By default, the display names for the voice messaging ports are composed of the port group display name followed by incrementing numbers.


Step 12 On the Port Basics page, set the voice messaging port settings as applicable. The fields in the following table are the ones that you can change.

Table 3-3 Settings for the Voice Messaging Ports 

Field
Considerations

Enabled

Check this check box to enable the port. The port is enabled during normal operation.

Uncheck this check box to disable the port. When the port is disabled, calls to the port get a ringing tone but are not answered. Typically, the port is disabled only by the installer during testing.

Server Name

(For Cisco Unity Connection clusters only) Click the name of the Cisco Unity Connection server that you want to handle this port.

Assign an equal number of answering and dial-out voice messaging ports to the Cisco Unity Connection servers so that they equally share the voice messaging traffic.

Answer Calls

Check this check box to designate the port for answering calls. These calls can be incoming calls from unidentified callers or from users.

Perform Message Notification

Check this check box to designate the port for notifying users of messages. Assign Perform Message Notification to the least busy ports.

Send MWI Requests

Check this check box to designate the port for turning MWIs on and off. Assign Send MWI Requests to the least busy ports.

Allow TRAP Connections

Check this check box so that users can use the port for recording and playback through the phone in Cisco Unity Connection web applications. Assign Allow TRAP Connections to the least busy ports.


Step 13 Click Save.

Step 14 Click Next.

Step 15 Repeat Step 12 through Step 14 for all remaining voice messaging ports for the phone system.

Step 16 If another phone system integration exists, in Cisco Unity Connection Administration, expand Telephony Integrations, then click Trunk. Otherwise, skip to Step 20.

Step 17 On the Search Phone System Trunks page, on the Phone System Trunk menu, click New Phone System Trunk.

Step 18 On the New Phone System Trunk page, enter the following settings for the phone system trunk and click Save.

Table 3-4 Settings for the Phone System Trunk 

Field
Setting

From Phone System

Click the display name of the phone system that you are creating a trunk for.

To Phone System

Click the display name of the previously existing phone system that the trunk will connect to.

Trunk Access Code

Enter the extra digits that Cisco Unity Connection must dial to transfer calls through the gateway to extensions on the previously existing phone system.


Step 19 Repeat Step 17 and Step 18 for all remaining phone system trunks that you want to create.

Step 20 In the Related Links drop-down list, click Check Telephony Configuration and click Go to confirm the phone system integration settings.

If the test is not successful, the Task Execution Results displays one or more messages with troubleshooting steps. After correcting the problems, test the connection again.

Step 21 In the Task Execution Results window, click Close.