Table Of Contents
Cisco Unified Communications Manager SCCP Integration Guide for Cisco Unity Connection in Cisco Unified CMBE 7.x
Integration Tasks
Task List to Create the Integration
Requirements
Integration Description
Call Information
Integration Functionality
Integrations with Multiple Phone Systems
Planning How the Voice Messaging Ports Will Be Used by Cisco Unity Connection
The Number Voice of Messaging Ports to Install
The Number of Voice Messaging Ports That Will Answer Calls
The Number of Voice Messaging Ports That Will Dial Out, and Not Answer Calls
Programming the Cisco Unified Communications Manager Phone System
Creating a New Integration with Cisco Unified Communications Manager
Testing the Integration
Appendix: Cisco Unified Communications Manager Authentication and Encryption of Cisco Unity Connection Voice Messaging Ports
Cisco Unified CM Security Features
Functional Overview
Requirements
Security Mode Settings in Cisco Unity Connection
Appendix: Documentation and Technical Assistance
Documentation Conventions
Obtaining Documentation and Submitting a Service Request
Cisco Unified Communications Manager SCCP Integration Guide for Cisco Unity Connection in Cisco Unified CMBE 7.x
Published August 25, 2008
This document provides instructions for integrating Cisco Unified Communications Manager (CM) (formerly known as Cisco Unified CallManager) with Cisco Unity Connection by Skinny Call Control Protocol (SCCP) in a Cisco Unified CMBE installation.
This document applies only when Cisco Unity Connection is installed as Cisco Unified Communications Manager Business Edition (CMBE)—on the same server with Cisco Unified Communications Manager. This document does not apply to the configuration in which Cisco Unity Connection is installed on a separate server from Cisco Unified Communications Manager.
Cisco Unity Connection supports an SCCP integration when Cisco Unified CM has only SCCP phones or has both SCCP and SIP phones.
Integration Tasks
Before doing the following tasks to integrate Cisco Unity Connection with the Cisco Unified Communications Manager phone system, confirm that Cisco Unity Connection is ready for the integration by completing the applicable tasks in the Installation Guide for Cisco Unity Connection.
The following task list describes the process for creating the integration.
Task List to Create the Integration
Use the following task list to set up a new integration with the Cisco Unified Communications Manager SCCP phone system when it is installed as Cisco Unified CMBE.
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 the "Planning How the Voice Messaging Ports Will Be Used by Cisco Unity Connection" section.
3. Program Cisco Unified Communications Manager. See the "Programming the Cisco Unified Communications Manager Phone System" section.
4. Create the integration. See the "Creating a New Integration with Cisco Unified Communications Manager" section.
5. Test the integration. See the "Testing the Integration" section.
Requirements
The Cisco Unified Communications Manager integration supports configurations of the following components:
Phone System
•A Cisco IP telephony applications server consisting of Cisco Unified Communications Manager Business Edition (CMBE) 7.x.
•The following phones or combinations of phones for the Cisco Unified CM extensions:
–Only IP phones for the Cisco Unified CM extensions.
–Both IP phones and SIP phones for the Cisco Unified CM extensions without a media termination point (MTP) on the Cisco Unified CM server.
–Both IP phones and SIP phones for the Cisco Unified CM extensions with a media termination point (MTP) on the Cisco Unified CM server.
Cisco Unity Connection Server
•Cisco Unity Connection installed as Cisco Unified CMBE.
Caution Cisco Unity Connection cannot be installed on a separate computer from Cisco Unified CM. Otherwise, the integration for the Cisco Unified CMBE installation may not function correctly.
•A license that enables the applicable number of voice messaging ports.
Integration Description
The Cisco Unified Communications Manager integration makes connections through a LAN or WAN. A gateway provides connections to the PSTN.
Call Information
The phone system sends the following information with forwarded calls:
•The extension of the called party
•The extension of the calling party (for internal calls) or the phone number of the calling party (if it is an external call and the system uses caller ID)
•The reason for the forward (the extension is busy, does not answer, or is set to forward all calls)
Cisco Unity Connection uses this information to answer the call appropriately. For example, a call forwarded to Cisco Unity Connection is answered with the personal greeting of the user. If the phone system routes the call to Cisco Unity Connection without this information, Cisco Unity Connection answers with the opening greeting.
Integration Functionality
The Cisco Unified Communications Manager integration with Cisco Unity Connection provides the following features:
•Call forward to personal greeting
•Call forward to busy greeting
•Caller ID
•Easy message access (a user can retrieve messages without entering an ID because Cisco Unity Connection identifies the user based on the extension from which the call originated; a password may be required)
•Identified user messaging (Cisco Unity Connection identifies the user who leaves a message during a forwarded internal call, based on the extension from which the call originated)
•Message waiting indication (MWI)
Integrations with Multiple Phone Systems
When Cisco Unity Connection is installed as Cisco Unified Communications Manager Business Edition (CMBE)—on the same server with Cisco Unified Communications Manager—Cisco Unity Connection cannot be integrated with multiple phone systems at one time. In the Cisco Unified CMBE configuration, Cisco Unity Connection can integrate only with Cisco Unified CM by Skinny Call Control Protocol (SCCP). No other phone system integrations are supported.
Planning How the Voice Messaging Ports Will Be Used by Cisco Unity Connection
Before programming the phone system, you need to plan how the voice messaging ports will be used by Cisco Unity Connection. The following considerations will affect the programming for the phone system (for example, setting up the hunt group or call forwarding for the voice messaging ports):
•The number of voice messaging ports installed.
•The number of voice messaging ports that will answer calls.
•The number of voice messaging ports that will only dial out, for example, to send message notification, to set message waiting indicators (MWIs), and to make telephone record and playback (TRAP) connections.
The following table describes the voice messaging port settings in Cisco Unity Connection that can be set on Telephony Integrations > Port of Cisco Unity Connection Administration.
Table 1 Settings for the Voice Messaging Ports
Field
|
Considerations
|
Enabled
|
Check this check box.
|
Answer Calls
|
Check this check box.
Caution All voice messaging ports connecting to the phone system must have the Answer Calls box checked. Otherwise, calls to Cisco Unity Connection may not be answered.
|
Perform Message Notification
|
Check this check box to designate the port for notifying users of messages.
|
Send MWI Requests
|
Check this check box to designate the port for turning MWIs on and off.
|
Allow TRAP Connections
|
Check this check box so that users can use the phone as a recording and playback device in Cisco Unity Connection web applications.
|
Outgoing Hunt Order
|
Enter the priority order in which Cisco Unity Connection will use the ports when dialing out (for example, if the Perform Message Notification, Send MWI Requests, or Allow TRAP Connections check box is checked). The highest numbers are used first. However, when multiple ports have the same Outgoing Hunt Order number, Cisco Unity Connection will use the port that has been idle the longest.
|
Security Mode
|
Click the applicable security mode:
•Non-secure—The integrity and privacy of call-signaling messages will not be ensured because call-signaling messages will be sent as clear (unencrypted) text and will be connected to Cisco Unified CM through a non-authenticated port rather than an authenticated TLS port. In addition, the media stream will not be encrypted.
•Authenticated—The integrity of call-signaling messages will be ensured because they will be connected to Cisco Unified CM through an authenticated TLS port. However, the privacy of call-signaling messages will not be ensured because they will be sent as clear (unencrypted) text. In addition, the media stream will not be encrypted.
•Encrypted—The integrity and privacy of call-signaling messages will be ensured on this port because they will be connected to Cisco Unified CM through an authenticated TLS port, and the call-signaling messages will be encrypted. In addition, the media stream will be encrypted.
|
The Number Voice of Messaging Ports to Install
The number of voice messaging ports to install depends on numerous factors, including:
•The number of calls Cisco Unity Connection will answer when call traffic is at its peak.
•The expected length of each message that callers will record and that users will listen to.
•The number of users.
•The number of ports that will be set to dial out only.
•The number of calls made for message notification.
•The number of MWIs that will be activated when call traffic is at its peak.
•The number of TRAP connections needed when call traffic is at its peak. (TRAP connections are used by Cisco Unity Connection web applications to play back and record over the phone.)
•The number of calls that will use the automated attendant and call handlers when call traffic is at its peak.
It is best to install only the number of voice messaging ports that are needed so that system resources are not allocated to unused ports.
The Number of Voice Messaging Ports That Will Answer Calls
The calls that the voice messaging ports answer can be incoming calls from unidentified callers or from users. Typically, the voice messaging ports that answer calls are the busiest.
You can set voice messaging ports to both answer calls and to dial out (for example, to send message notifications). However, when the voice messaging ports perform more than one function and are very active (for example, answering many calls), the other functions may be delayed until the voice messaging port is free (for example, message notifications cannot be sent until there are fewer calls to answer). For best performance, dedicate certain voice messaging ports for only answering incoming calls, and dedicate other ports for only dialing out. Separating these port functions eliminates the possibility of a collision, in which an incoming call arrives on a port at the same time that Cisco Unity Connection takes the port off-hook to dial out.
The Number of Voice Messaging Ports That Will Dial Out, and Not Answer Calls
Ports that will only dial out and will not answer calls can do one or more of the following:
•Notify users by phone, pager, or e-mail of messages that have arrived.
•Turn MWIs on and off for user extensions.
•Make a TRAP connection so that users can use the phone as a recording and playback device in Cisco Unity Connection web applications.
Typically, these voice messaging ports are the least busy ports.
Caution In programming the phone system, do not send calls to voice messaging ports in Cisco Unity Connection that cannot answer calls (voice messaging ports that are not set to Answer Calls). For example, if a voice messaging port is set only to Send MWI Requests, do not send calls to it.
Programming the Cisco Unified Communications Manager Phone System
After the Cisco Unified Communications Manager software is installed, do the following procedures in the order given.
To Add Partitions and a Calling Search Space to Contain the Voice Mail Ports
Step 1 In Cisco Unified CM Administration, click Call Routing > Class of Control > Partition.
Step 2 On the Find and List Partitions page, click Add New.
Step 3 On the Partition Configuration page, enter the name and description you want for the partition that will contain all voice mail port directory numbers. For example, enter "VMRestrictedPT, Partition for voice mail port directory numbers."
Step 4 Click Save.
Step 5 Click Add New.
Step 6 Enter the name and description you want for the partition that will contain the hunt pilot, which will be the voice mail pilot number. For example, enter "VMPilotNumberPT, Partition for the voice mail pilot number."
Step 7 Click Save.
Step 8 Click Call Routing > Class of Control > Calling Search Space.
Step 9 On the Find and List Calling Search Spaces page, click Add New.
Step 10 On the Calling Search Space Configuration page, in the Name field, enter a name for the calling search space that will include the partition created in Step 2 through Step 4. For example, enter "VMRestrictedCSS."
Step 11 Optionally, in the Description field, enter a description of the calling search space. For example, enter "Voice mail port directory numbers."
Step 12 In the Available Partitions list, click the name of the partition created in Step 2 through Step 4. For example, click "VMRestrictedPT."
Step 13 Click the down arrow below the Available Partitions list.
The name of the partition appears in the Selected Partitions list.
Step 14 Click Save.
Step 15 In the Related Links field, click Back to Find/List and click Go.
Step 16 On the Find and List Calling Search Spaces page, click Find.
Step 17 Click the name of the calling search space that is used by user phones.
Step 18 On the Calling Search Space Configuration page, in the Available Partitions list, click the name of the partition created in Step 5 through Step 7. For example, click "VMPilotNumberPT."
Caution If the partition that contains the hunt pilot (which will be the voice mail pilot number) is not in the calling search space that is used by user phones, the phones will not be able to dial the Cisco Unity Connection server.
Step 19 Click the down arrow below the Available Partition list.
The name of the partition appears in the Selected Partitions list.
Step 20 Click Save.
Step 21 Repeat Step 17 through Step 20 for each remaining calling search space that needs to access Cisco Unity Connection.
To Add a Device Pool for the Voice Mail Ports
Step 1 In Cisco Unified CM Administration, click System > Device Pool.
Step 2 On the Find and List Device Pools page, click Add New.
Step 3 On the Device Pool Configuration page, enter the following device pool settings.
Table 2 Settings for the Device Pool Configuration Page
Field
|
Setting
|
Device Pool Name
|
Enter Cisco Unity Connectionn Voice Mail Ports or other description for this device pool.
|
Cisco Unified Communications Manager Group
|
Click the Cisco Unified Communications Manager group to assign to the voice mail ports in this device pool.
|
Date/Time Group
|
Click the date/time group to assign to the voice mail ports in this device pool.
|
Region
|
Click the Cisco Unified CM region to assign to the voice mail ports in this device pool.
|
SRST Reference
|
If applicable, click the survivable remote site telephony (SRST) reference to assign to the voice mail ports in this device pool.
|
Step 4 Click Save.
In the following procedure, add a voice mail port to Cisco Unified CM for each voice mail port that you will connect to Cisco Unity Connection.
To Add Voice Mail Ports to Cisco Unified CM
Step 1 In Cisco Unified CM Administration, click Voice Mail > Cisco Voice Mail Port Wizard.
Step 2 On the What Would You Like to Do page, click Create a New Cisco Voice Mail Server and Add Ports to It, then click Next.
Step 3 On the Cisco Voice Mail Server page, the name of the voice mail server appears. We recommend that you accept the default name for the voice mail server. If you must use a different name, however, the name must have no more than nine characters.
The voice mail server name must match the Device Name Prefix field in Cisco Unity Connection on the Port Group Basics page for the voice messaging ports.
Step 4 Click Next.
Step 5 On the Cisco Voice Mail Ports page, click the number of voice mail ports that you want to add (which must not be more voice mail ports than the Cisco Unity Connection licenses enable), then click Next.
Step 6 On the Cisco Voice Mail Device Information page, enter the following voice mail device settings.
Table 3 Settings for the Cisco Voice Mail Device Information Page
Field
|
Setting
|
Description
|
Enter Cisco Voice Mail Port or another description for the voice mail device.
|
Device Pool
|
Click the name of the device pool you created for the voice mail ports. For example, click Cisco Unity Connection Voice Mail Ports.
|
Calling Search Space
|
Click the name of a calling search space that allows calls to the user phones and any required network devices.
This calling search space must include partitions that contain all devices Cisco Unity Connection needs to access (for example, during call transfers, message notifications, and MWI activations).
|
AAR Calling Search Space
|
Accept the default of None.
|
Location
|
Click Hub_None.
|
Device Security Mode
|
Click the security mode that you want to use for the voice mail ports. For details on the settings for Cisco Unified CM authentication and encryption of the voice mail ports, see the "Appendix: Cisco Unified Communications Manager Authentication and Encryption of Cisco Unity Connection Voice Messaging Ports" section.
|
Step 7 Click Next.
Step 8 On the Cisco Voice Mail Directory Numbers page, enter the following voice mail directory number settings.
Table 4 Settings for the Cisco Voice Mail Directory Numbers Page
Field
|
Setting
|
Beginning Directory Number
|
Enter the extension number of the first voice mail port.
|
Partition
|
Click the name of the partition that you set up for all voice mail port directory numbers. For example, click "VMRestrictedPT."
|
Calling Search Space
|
Click the name of a calling search space that you set up to contain the partition with all voice mail port directory numbers, as set in Step 9 of the "To Add Partitions and a Calling Search Space to Contain the Voice Mail Ports" procedure. For example, click "VMRestrictedCSS."
Because this calling search space is not used by user phones, users are not able to dial the voice mail ports. However, users can dial the voice mail pilot number.
|
AAR Group
|
Click the automated alternate routing (AAR) group for the voice mail ports. The AAR group provides the prefix digits that are used to route calls that are otherwise blocked due to insufficient bandwidth. If you click None, no rerouting of blocked calls will be attempted.
|
Internal Caller ID Display
|
Accept the default of VoiceMail.
This text appears on the phone when the pilot number is dialed.
|
Internal Caller ID Display (ASCII Format)
|
Accept the default of VoiceMail.
This text appears on the phone when the pilot number is dialed.
|
External Number Mask
|
Leave this field blank, or specify the mask used to format caller ID information for external (outbound) calls. The mask can contain up to 50 characters. Enter the literal digits that you want to appear in the caller ID information, and enter X for each digit in the directory number of the device.
|
Step 9 Click Next.
Step 10 On the Do You Want to Add These Directory Numbers to a Line Group page, click No, I Will Add Them Later, and click Next.
Step 11 On the Ready to Add Cisco Voice Mail Ports page, confirm that the settings for the voice mail ports are correct, and click Finish.
If the settings are not correct, click Back and enter the correct settings.
To Add Voice Mail Ports to Line Groups
Step 1 In Cisco Unified CM Administration, click Call Routing > Route/Hunt > Line Group.
Step 2 On the Find and List Line Groups page, click Add New.
This line group will contain directory numbers for voice mail ports that will answer calls. Directory numbers for voice mail ports that will only dial out (for example, to set MWIs) must not be included in this line group.
Step 3 On the Line Group Configuration page, enter the following settings.
Table 5 Settings for the Line Group Configuration Page for Answering Ports
Field
|
Setting
|
Line Group Name
|
Enter Cisco Unity Connection Answering Ports or another unique name for line groups.
|
RNA Reversion Timeout
|
Accept the default of 10.
|
Distribution Algorithm
|
Click Longest Idle Time.
|
No Answer
|
Accept the default of Try Next Member; Then, Try Next Group in Hunt List.
|
Busy
|
Accept the default of Try Next Member; Then, Try Next Group in Hunt List.
|
Not Available
|
Accept the default of Try Next Member; Then, Try Next Group in Hunt List.
|
Step 4 Under Line Group Member Information, in the Partition list, click the name of the partition that you set up for all voice mail port directory numbers. For example, click "VMRestrictedPT."
Step 5 Click Find.
Step 6 In the Available DN/Route Partition list, click the first directory number of a voice mail port that will answer calls, and click Add to Line Group.
Caution The directory numbers in the Selected DN/Route Partition list must appear in numerical sequence with the lowest number on top. Otherwise, the integration will not function correctly.
Step 7 Repeat Step 6 for all remaining directory numbers of voice mail ports that will answer calls.
Caution Do not include directory numbers of voice mail ports that will only dial out (for example, to set MWIs). Otherwise, the integration will not function correctly.
Step 8 Click Save.
To Add the Line Group to a Hunt List
Step 1 In Cisco Unified CM Administration, click Call Routing > Route/Hunt > Hunt List.
Step 2 On the Find and List Hunt Lists page, click Add New.
Step 3 On the Hunt List Configuration page, enter the following settings for the hunt list.
Table 6 Settings for the Hunt List Configuration Page for Answering Ports
Field
|
Setting
|
Name
|
Enter Cisco Unity Connection Answering Ports or another unique name for the hunt list.
|
Description
|
Enter Cisco Unity Connection ports that answer calls or another description.
|
Cisco Unified Communications Manager Group
|
Click Default or the name of the Cisco Unified Communications Manager group that you are using.
|
Enable This Hunt List
|
Check this check box.
|
For Voice Mail Usage
|
Check this check box.
|
Step 4 Click Save.
Step 5 Under Hunt List Member Information, click Add Line Group.
Step 6 On the Hunt List Detail Configuration page, in the Line Group list, click the line group you created for the directory numbers of voice mail ports that will answer calls, then click Save.
Caution In the hunt list, do not include line groups with voice mail ports that Cisco Unity Connection will use to dial out. Otherwise, the integration will not function correctly.
Step 7 When alerted that the line group has been inserted, click OK.
Step 8 On the Hunt List Configuration page, click Reset.
Step 9 When asked to confirm resetting the hunt list, click Reset.
Step 10 When alerted that the hunt list has been reset, click Close.
To Add the Hunt List to a Hunt Pilot Number
Step 1 In Cisco Unified CM Administration, click Call Routing > Route/Hunt > Hunt Pilot.
Step 2 On the Find and List Hunt Pilots page, click Add New.
Step 3 On the Hunt Pilot Configuration page, enter the following settings for the hunt pilot.
Table 7 Settings for Hunt Pilot Configuration Page
Field
|
Setting
|
Hunt Pilot
|
Enter the hunt pilot number for the voice mail ports. The hunt pilot number must be different from the extension numbers of the voice mail ports.
The hunt pilot number is the extension number that users enter to listen to their voice messages.
|
Route Partition
|
Click the name of the partition that you set up for the voice mail pilot number. For example, click "VMPilotNumberPT."
|
Description
|
Enter Connection Hunt Pilot or another description.
|
Numbering Plan
|
Accept the default setting, or click the numbering plan that you have set up for your system.
|
Route Filter
|
Click None, or click the name of the route filter that you set up for your system.
|
MLPP Precedence
|
Accept the default setting, or click another setting.
|
Hunt List
|
Click the hunt list of voice mail ports that answer calls, which you set up in the "To Add the Line Group to a Hunt List" procedure.
|
Route Option
|
Click Route This Pattern.
|
Provide Outside Dial Tone
|
Uncheck the check box.
|
Step 4 Click Save.
To Specify MWI Directory Numbers
Step 1 In Cisco Unified CM Administration, click Voice Mail > Message Waiting.
Step 2 On the Find and List Message Waiting Numbers page, click Add New.
Step 3 On the Message Waiting Configuration page, enter the following settings for turning MWIs on.
Table 8 Settings for Turning MWIs On
Field
|
Setting
|
Message Waiting Number
|
Enter the unique extension that turns MWIs on.
|
Partition
|
Click the name of the partition that you set up for the voice mail pilot number. For example, click "VMPilotNumberPT."
|
Description
|
Enter DN to turn MWIs on or another description.
|
Message Waiting Indicator
|
Click On.
|
Calling Search Space
|
Click a calling search space that is used by user phones.
|
Step 4 Click Save.
Step 5 Click Add New.
Step 6 Enter the following settings for turning MWIs off.
Table 9 Settings for Turning MWIs Off
Field
|
Setting
|
Message Waiting Number
|
Enter the unique extension that turns MWIs off.
|
Partition
|
Click the name of the partition that you set up for the voice mail pilot number. For example, click "VMPilotNumberPT."
|
Description
|
Enter DN to turn MWIs off or another description.
|
Message Waiting Indicator
|
Click Off.
|
Calling Search Space
|
Click a calling search space that is used by user phones.
|
Step 7 Click Save.
In the following procedure, you will add the voice mail pilot number, which is the extension that you dial to listen to your voice messages. Your Cisco IP phone automatically dials the voice mail pilot number when you press the Messages button.
To Add a Voice Mail Pilot Number for the Voice Mail Ports
Step 1 In Cisco Unified CM Administration, click Voice Mail > Voice Mail Pilot.
Step 2 On the Find and List Voice Mail Pilots page, click Add New.
Step 3 On the Voice Mail Pilot Configuration page, enter the following voice mail pilot number settings.
Table 10 Settings for the Voice Mail Pilot Configuration Page
Field
|
Setting
|
Voice Mail Pilot Number
|
Enter the voice mail pilot number that users will dial to listen to their voice messages. This number must be the same as the hunt pilot number that you entered when adding voice mail ports earlier.
|
Calling Search Space
|
Click the calling search space that includes partitions containing the user phones and the partition you set up for the voice mail pilot number.
|
Description
|
Enter Cisco Unity Connection Pilot or another description.
|
Make This the Default Voice Mail Pilot for the System
|
Check this check box. When this check box is checked, this voice mail pilot number replaces the current default pilot number.
|
Step 4 Click Save.
To Set Up the Voice Mail Profile
Step 1 In Cisco Unified CM Administration, click Voice Mail > Voice Mail Profile.
Step 2 On the Find and List Voice Mail Profiles page, click Add New.
Step 3 On the Voice Mail Profile Configuration page, enter the following voice mail profile settings.
Table 11 Settings for the Voice Mail Profile Configuration Page
Field
|
Setting
|
Voice Mail Profile Name
|
Enter a name to identify the voice mail profile.
|
Description
|
Enter Cisco Unity Connection Profile or another description.
|
Voice Mail Pilot
|
Click one of the following:
•The applicable voice mail pilot number that you defined on the Voice Mail Pilot Configuration page
•Use Default
|
Voice Mail Box Mask
|
When multitenant services are not enabled on Cisco Unified CM, leave this field blank.
When multitenant services are enabled, each tenant uses its own voice mail profile and must create a mask to identify the extensions (directory numbers) in each partition that is shared with other tenants. For example, one tenant can use a mask 972813XXXX, while another tenant can use the mask 214333XXXX. Each tenant also uses its own translation patterns for MWIs.
|
Make This the Default Voice Mail Profile for the System
|
Check this check box to make this voice mail profile the default.
When this check box is checked, this voice mail profile replaces the current default voice mail profile.
|
Step 4 Click Save.
To Set Up the Voice Mail Server Service Parameters
Step 1 In Cisco Unified CM Administration, click System > Service Parameters.
Step 2 On the Service Parameters Configuration page, in the Server field, click the name of the Cisco Unified CM server.
Step 3 In the Service list, click Cisco CallManager. The list of parameters appears.
Step 4 Under Clusterwide Parameters (Feature - General), locate the Multiple Tenant MWI Modes parameter.
Step 5 If you use multiple tenant MWI notification, click True.
When this parameter is set to True, Cisco Unified CM uses any configured translation patterns to convert voice mail extensions into directory numbers when turning on or off an MWI.
Step 6 If you changed any settings, click Save. Then shut down and restart the Cisco Unified CM server.
Creating a New Integration with Cisco Unified Communications Manager
After ensuring that Cisco Unified Communications Manager 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 following settings and click Save.
Table 12 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 SCCP 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.
|
Device Name Prefix
|
Enter the prefix that Cisco Unified CM adds to the device name for voice ports. This prefix must match the prefix used by Cisco Unified CM.
|
Create MWI On Extension From
|
Click Co-resident Cisco Unified Communications Manager and click the extension that you specified in Cisco Unified CM Administration for turning MWIs on.
|
Create MWI Off Extension From
|
Click Co-resident Cisco Unified Communications Manager and click the extension that you specified in Cisco Unified CM Administration for turning MWIs off.
|
Port
|
Enter the TCP port of the primary Cisco Unified CM server that you are integrating with Cisco Unity Connection. We recommend that you use the default setting.
|
TLS Port
|
Enter the TLS port of the primary Cisco Unified CM server 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 13 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.
|
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.
|
Security Mode
|
Click the Cisco Unified CM security mode that you want to use for the voice messaging ports.
|
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 0-14 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.
|
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.
|
Outgoing Hunt Order
|
Enter the priority order in which Cisco Unity Connection will use the ports when dialing out (for example, if the Perform Message Notification, Send MWI Requests, or Allow TRAP Connections check box is checked). The highest numbers are used first. However, when multiple ports have the same Outgoing Hunt Order number, Cisco Unity Connection will use the port that has been idle the longest.
|
Security Mode
|
Click the applicable security mode:
•Non-secure—The integrity and privacy of call-signaling messages will not be ensured because call-signaling messages will be sent as clear (unencrypted) text and will be connected to Cisco Unified CM through a non-authenticated port rather than an authenticated TLS port. In addition, the media stream will not be encrypted.
•Authenticated—The integrity of call-signaling messages will be ensured because they will be connected to Cisco Unified CM through an authenticated TLS port. However, the privacy of call-signaling messages will not be ensured because they will be sent as clear (unencrypted) text. In addition, the media stream will not be encrypted.
•Encrypted—The integrity and privacy of call-signaling messages will be ensured on this port because they will be connected to Cisco Unified CM through an authenticated TLS port, and the call-signaling messages will be encrypted. In addition, the media stream will be encrypted.
Caution The Security Mode setting for Cisco Unity Connection voice messaging ports must match the security mode setting for the Cisco Unified CM ports. Otherwise, Cisco Unified CM authentication and encryption will fail. The Cisco Unity Connection system clock must be synchronized with the Cisco Unified CM system clock for Cisco Unified CM authentication to function immediately. Otherwise, Cisco Unified CM will reject the Cisco Unity Connection voice messaging ports until the Cisco Unified CM system clock has passed the time stamp in the Cisco Unity Connection device certificates.
Note For requirements and additional information about authentication and encryption with Cisco Unified CM and Cisco Unity Connection, see the "Appendix: Cisco Unified Communications Manager Authentication and Encryption of Cisco Unity Connection Voice Messaging Ports" section
|
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 15 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.
Testing the Integration
To test whether Cisco Unity Connection and the phone system are integrated correctly, do the following procedures in the order listed.
If any of the steps indicate a failure, see the following documentation as applicable:
•The installation guide for the phone system.
•Troubleshooting Guide for Cisco Unity Connection, available at http://www.cisco.com/en/US/products/ps6509/prod_troubleshooting_guides_list.html.
•The setup information earlier in this guide.
To Set Up the Test Configuration
Step 1 Set up two test extensions (Phone 1 and Phone 2) on the same phone system that Cisco Unity Connection is connected to.
Step 2 Set Phone 1 to forward calls to the Cisco Unity Connection pilot number when calls are not answered.
Caution The phone system must forward calls to the Cisco Unity Connection pilot number in no fewer than four rings. Otherwise, the test may fail.
Step 3 In Cisco Unity Connection Administration, expand Users, then click Users.
Step 4 On the Search Users page, click the display name of a user to use for testing. The extension for this user must be the extension for Phone 1.
Step 5 On the Edit User Basics page, uncheck the Set for Self-enrollment at Next Login check box.
Step 6 In the Voice Name field, record a voice name for the test user.
Step 7 Click Save.
Step 8 On the Edit menu, click Message Waiting Indicators.
Step 9 On the Message Waiting Indicators page, click the message waiting indicator. If no message waiting indication is in the table, click Add New.
Step 10 On the Edit Message Waiting Indicator page, enter the following settings.
Table 16 Settings for the Edit MWI Page
Field
|
Setting
|
Enabled
|
Check this check box to enable MWIs for the test user.
|
Display Name
|
Accept the default or enter a different name.
|
Inherit User's Extension
|
Check this check box to enable MWIs on Phone 1.
|
Step 11 Click Save.
Step 12 On the Edit menu, click Transfer Options.
Step 13 On the Transfer Options page, click the active option.
Step 14 On the Edit Transfer Option page, under Transfer Action, click the Extension option and enter the extension of Phone 1.
Step 15 In the Transfer Type field, click Release to Switch.
Step 16 Click Save.
Step 17 Minimize the Cisco Unity Connection Administration window.
Do not close the Cisco Unity Connection Administration window because you will use it again in a later procedure.
Step 18 Log on to the Real-Time Monitoring Tool (RTMT).
Step 19 On the Unity Connection menu, click Port Monitor. The Port Monitor tool appears in the right pane.
Step 20 In the right pane, click Start Polling. The Port Monitor will display which port is handling the calls that you will make.
To Test an External Call with Release Transfer
Step 1 From Phone 2, enter the access code necessary to get an outside line, then enter the number outside callers use to dial directly to Cisco Unity Connection.
Step 2 In the Port Monitor, note which port handles this call.
Step 3 When you hear the opening greeting, enter the extension for Phone 1. Hearing the opening greeting means that the port is configured correctly.
Step 4 Confirm that Phone 1 rings and that you hear a ringback tone on Phone 2. Hearing a ringback tone means that Cisco Unity Connection correctly released the call and transferred it to Phone 1.
Step 5 Leaving Phone 1 unanswered, confirm that the state of the port handling the call changes to "Idle." This state means that release transfer is successful.
Step 6 Confirm that, after the number of rings that the phone system is set to wait, the call is forwarded to Cisco Unity Connection and that you hear the greeting for the test user. Hearing the greeting means that the phone system forwarded the unanswered call and the call-forward information to Cisco Unity Connection, which correctly interpreted the information.
Step 7 On the Port Monitor, note which port handles this call.
Step 8 Leave a message for the test user and hang up Phone 2.
Step 9 In the Port Monitor, confirm that the state of the port handling the call changes to "Idle." This state means that the port was successfully released when the call ended.
Step 10 Confirm that the MWI on Phone 1 is activated. The activated MWI means that the phone system and Cisco Unity Connection are successfully integrated for turning on MWIs.
To Test Listening to Messages
Step 1 From Phone 1, enter the internal pilot number for Cisco Unity Connection.
Step 2 When asked for your password, enter the password for the test user. Hearing the request for your password means that the phone system sent the necessary call information to Cisco Unity Connection, which correctly interpreted the information.
Step 3 Confirm that you hear the recorded voice name for the test user (if you did not record a voice name for the test user, you will hear the extension number for Phone 1). Hearing the voice name means that Cisco Unity Connection correctly identified the user by the extension.
Step 4 Listen to the message.
Step 5 After listening to the message, delete the message.
Step 6 Confirm that the MWI on Phone 1 is deactivated. The deactivated MWI means that the phone system and Cisco Unity Connection are successfully integrated for turning off MWIs.
Step 7 Hang up Phone 1.
Step 8 On the Port Monitor, confirm that the state of the port handling the call changes to "Idle." This state means that the port was successfully released when the call ended.
To Set Up Supervised Transfer on Cisco Unity Connection
Step 1 In Cisco Unity Connection Administration, on the Edit Transfer Option page for the test user, in the Transfer Type field, click Supervise Transfer.
Step 2 In the Rings to Wait For field, enter 3.
Step 3 Click Save.
Step 4 Minimize the Cisco Unity Connection Administration window.
Do not close the Cisco Unity Connection Administration window because you will use it again in a later procedure.
To Test Supervised Transfer
Step 1 From Phone 2, enter the access code necessary to get an outside line, then enter the number outside callers use to dial directly to Cisco Unity Connection.
Step 2 On the Port Monitor, note which port handles this call.
Step 3 When you hear the opening greeting, enter the extension for Phone 1. Hearing the opening greeting means that the port is configured correctly.
Step 4 Confirm that Phone 1 rings and that you do not hear a ringback tone on Phone 2. Instead, you should hear the indication your phone system uses to mean that the call is on hold (for example, music).
Step 5 Leaving Phone 1 unanswered, confirm that the state of the port handling the call remains "Busy." This state and hearing an indication that you are on hold mean that Cisco Unity Connection is supervising the transfer.
Step 6 Confirm that, after three rings, you hear the greeting for the test user. Hearing the greeting means that Cisco Unity Connection successfully recalled the supervised-transfer call.
Step 7 During the greeting, hang up Phone 2.
Step 8 On the Port Monitor, confirm that the state of the port handling the call changes to "Idle." This state means that the port was successfully released when the call ended.
Step 9 Click Stop Polling.
Step 10 Exit RTMT.
If Cisco Unity Connection is set up for Cisco Unified CM authentication or encryption, do the following procedure.
To Test Cisco Unified CM Authentication and Encryption
Step 1 From Phone 1, dial the internal pilot number for Cisco Unity Connection.
Step 2 Confirm that the authentication icon and/or the encryption icon appear on the LCD of the phone.
Step 3 Hang up Phone 1.
Appendix: Cisco Unified Communications Manager Authentication and Encryption of Cisco Unity Connection Voice Messaging Ports
A potential point of vulnerability for a Cisco Unity Connection system is the connection between Cisco Unity Connection and Cisco Unified Communications Manager. Possible threats include:
•Man-in-the-middle attacks (a process in which an attacker observes and modifies the information flow between Cisco Unified CM and the Cisco Unity Connection voice messaging ports)
•Network traffic sniffing (a process in which an attacker uses software to capture phone conversations and signaling information that flow between Cisco Unified CM, the Cisco Unity Connection voice messaging ports, and IP phones that are managed by Cisco Unified CM)
•Modification of call signaling between the Cisco Unity Connection voice messaging ports and Cisco Unified CM
•Modification of the media stream between the Cisco Unity Connection voice messaging ports and the endpoint (for example, a phone or gateway)
•Identity theft of the Cisco Unity Connection voice messaging port (a process in which a non-Cisco Unity Connection device presents itself to Cisco Unified CM as a Cisco Unity Connection voice messaging port)
•Identity theft of the Cisco Unified CM server (a process in which a non-Cisco Unified CM server presents itself to Cisco Unity Connection voice messaging ports as a Cisco Unified CM server)
Cisco Unified CM Security Features
Cisco Unified CM can secure the connection with Cisco Unity Connection against these threats. The Cisco Unified CM security features that Cisco Unity Connection can take advantage of are described in Table 17.
