Direct SIP: Cisco Unified Communications Manager 7.1
If you’re looking for an introduction about how to configure Cisco Unified Communications Manager (CUCM) version 7.1.3 with Office Communications Server 2007 R2, this article will help you. The proper way to connect and interoperate the two products is to set up a Direct SIP connection in Office Communications Server. On the Cisco side, this is referred to as a SIP trunk. This article covers how to configure a SIP trunk in CUCM 7.1.
Publication date: August 2010
Product version: Office Communications Server 2007 R2
If you’re looking for an introduction about how to configure Cisco Unified Communications Manager (CUCM) version 7.1.3 with Office Communications Server 2007 R2, this article will help you. The proper way to connect and interoperate the two products is to set up a Direct SIP connection in Office Communications Server’s parlance. In Cisco’s parlance, this is referred to as a SIP trunk. So, when discussing the configuration of CUCM, we’ll refer to this connection as a SIP trunk. When explaining the configuration of the Office Communications Server, we’ll refer to this connection as a Direct SIP.
If you’re trying to connect CUCM with Office Communications Server 2007 R2, you probably already have CUCM deployed in your environment for all your IP phones and CUCM configured to route all external calls to the PSTN through a PSTN trunk. In this case, you’ll want to configure Office Communications Server 2007 R2 Enterprise Voice to route external calls to the PSTN through the CUCM PSTN trunk. Calls between Communicator users and Cisco IP phone users should be possible by using each user’s unique extension number, and users are accessible via externally routable direct inward dialing (DID). This is illustrated in Figure 1.
It is worth clarifying that a new range of phone numbers assigned to Communicator endpoints must be defined in CUCM. This new range needs to be separate from any existing number range used for Cisco desk phone endpoints. For end users who have both a Cisco desk phone and a Communicator client, the same number cannot be used for inbound and outbound dialing. This restriction exists because call routing for Communicator clients in CUCM is achieved by creating a new SIP trunk that is used only for Communicator endpoints. Multiple device endpoints cannot share the same number when the call routing is defined on different SIP trunks.
For details about Office Communications Server telephony integration, including options for the coexistence of specific features, see "Integrating Telephony with Office Communications Server 2007 and 2007 R2".
There are two parts to interoperating the two products: configuring CUCM and configuring Office Communications Server. The high level steps for configuring CUCM are as follows:
Create a partition.
Create a calling search space.
Define translation patterns.
Provision a SIP trunk.
Set up route pattern.
The following sections describe the CUCM configuration steps in more detail. For details about how to configure Direct SIP on Office Communications Server 2007 R2 Mediation Server, see Direct SIP: Configuring Mediation Server.
Let’s dive into the configuration steps for CUCM. The connectivity between CUCM and the Mediation Server is referred to as SIP trunk to conform to Cisco’s terminology.
A CUCM partition contains a list of route patterns. Partitions facilitate call routing by dividing the route plan into logical subsets that are based on organization, location, and call type. For details about partitions, see "Partitions and Calling Search Spaces" in the CUCM System Guide.
This partition is specific to the SIP trunk that connects Office Communications Server to CUCM. It will store route pattern and translation pattern rules that are specific to handling incoming traffic to CUCM from the Mediation Server. For our example, this partition is named "OCSIncoming".
To create a CUCM partition
From your CUCM Administration console, click Call Routing, click Class of Control, and then click Partition (Figure 2).
Click Add New to create a new partition as showing in Figure 3.
In the Name field, specify the name of the partition and a description as shown in Figure 4. We’ve specified "OCSIncoming, OCSIncoming".
Click Save, and then click Find to verify that the partition was created. The new partition should appear in the result set as shown in Figure 5.
To view the configuration, click the new partition name (Figure 6).
|Whether a partition is required in a particular environment may depend on the rules required. Verify this with your CUCM administrator.|
A CUCM calling search space is an ordered list of route partitions. Calling search spaces determine which partitions and the order in which they are searched when CUCM routes a call. In our example, this calling search space is named "OCSIncoming" and is assigned to the OCSIncoming partition created earlier.
To create a calling search space
From the CUCM Administration console, click Call Routing, click Class of Control, and then click Calling Search Space (Figure 7).
Click Add New to create a new calling search space. Specify a name for the calling search space. In our example, the new calling search space is "OCSIncoming".
Select the OCSIncoming partition, and then click the down arrow to move it to the Selected Partitions area to assign this calling search space to the OCSIncoming partition (Figure 8).
Click Save to insert this calling search space into the CUCM configuration.
Next, translation patterns must be defined and assigned to the newly created partition. Translation patterns manipulate dial strings before a call is routed.
The translation patterns we’ll define are specific for handling inbound calls to the CUCM that come from Office Communications Server. A translation pattern converts dial strings for calls sent by the Mediation Server where the TO field matches the pattern. CUCM then uses the translated dial string to determine how to route the call.
One or more translation patterns must be defined depending on your needs. At a minimum, you need to define at least two translation patterns:
A translation pattern for incoming calls from Office Communications Server that are destined for the PSTN. This allows Office Communicator users who are enabled for Enterprise Voice to dial out externally.
A translation pattern for incoming calls from Office Communications Server that are destined for CUCM-assigned phone numbers. This allows Office Communicator users to dial Cisco phones within the organization.
If users are allowed to dial international numbers, you have to define a third translation pattern. Consider creating translation patterns for emergency numbers (for example, 911).
Office Communications Server to PSTN Translation Pattern
The first translation pattern (called 33.xxxxxxxxx, which means the TO string starting with 33 followed by 9 digits as shown in Figure 9) transforms all calls from Office Communications Server that are destined to a domestic PSTN number.
On your CUCM Administration console, click Call Routing, click Translation Pattern (Figure 9), and then click Add New to create a new translation pattern configuration.
The translation pattern is assigned to the OCSIncoming partition that you previously created.
The period (.) is a separator that indicates that all digits before the period are to be discarded. This separator is used in the Called Party Transformations section (see Figure 10) when the Discard Digits setting is set to PreDot. In our example, 33 will be removed from the dial string. For North America and the Caribbean, the Numbering Plan should be set to NANP as shown in Figure 10. NANP is the standard PSTN numbering plan for North America and the Caribbean. Configuring incoming call routing for other geographic regions requires a Numbering Plan setting that is standard for that region.
For the FROM field, the last 9 digits are retained. The country prefix (which is 33 for France) is stripped from the E.164 calling party dial string and is presented to the PSTN in the required format, 16986xxxx. In this case, the translation pattern transforms the dial string from 3316986xxxx to 16986xxxx.
For the TO field, the pattern strips the leading 33 and adds 00 as a prefix to the remaining string. The translation pattern transforms the dial string from 33xxxxxxxxx to 00xxxxxxxxx, where the first 0 is the outside line prefix that is required to obtain an outside line on CUCM.
Office Communications Server to CUCM Translation Pattern
The second translation pattern (in this example, 3316986xxxx) transforms all calls from Office Communications Server that are destined for a CUCM assigned number. The translation pattern is assigned to the OCSIncoming partition that you created earlier. Because all calls from Office Communications Server will likely be in RFC 3966 format, calls in this example are prefixed by the country code, 33 for France, and then followed by the prefix for all numbers that are assigned to Cisco IP phones, 16986, in the enterprise. This pattern is applied to calls where the TO field matches the pattern, 3316986xxxx. Because CUCM selects translation patterns on the basis of the best match, this translation pattern will be selected instead of the first translation pattern.
In our example, this translation pattern translates dial strings for calls sent by the Mediation Server where the TO field matches the pattern, 3316986xxxx. It strips all leading digits from TO and FROM fields and retains only the last 4 digits, xxxx. Dial strings with the pattern 3316986xxxx are translated to dial strings of the form xxxx. As shown in Figure 11, this translation is performed on the number of the user being called (TO field) and on the caller’s number (FROM field). The caller-id information originates from the line URI attribute of the Communicator caller, which is defined as a user property in Active Directory. This caller-id is formatted by any matching Office Communications Server normalization rules before being matched against the CUCM translation patterns.
|If the CUCM Simultaneous Ring feature is used, and the caller has a Cisco Remote Destination Profile set up with their Office Communications Server line URI attribute in the “Destination Number” field, the caller’s number will be mapped to their corresponding Cisco line number.|
A SIP trunk to the Mediation Server is created on the CUCM and is assigned the OCSIncoming calling search space that was created earlier. The SIP trunk uses SIP over TCP, which requires port 5060.
The CUCM SIP trunk is established to the IP address of the Mediation Server that represents the gateway listening IP address. The Mediation Server must be configured with two IP addresses. One IP address connects to the Office Communications Server infrastructure; the other IP address connects to the CUCM, which represents the gateway.
If you’re not sure which IP address is the gateway listening IP address for your Mediation Server, see Figure 4 in the article Direct SIP: Configuring Mediation Server.
In our example, the trunk name is Trunk_to_OCS, and the Mediation Server’s gateway listening IP address is 192.168.0.105.
To create a new SIP trunk
On the CUCM Administration console, click Device, and then click Trunk (Figure 12).
Click Add New, and then on the Trunk Type list, select SIP Trunk. Select SIP as the Device Protocol, and then click Next (Figure 13).
Specify the Device Name (in our example, Trunk_to_OCS), the Calling Search Space (in our example, OCSIncoming), the Rerouting Calling Search Space (in our example, OCSIncoming), the Destination Address to match the Mediation Server gateway listening IP address (in our example, 192.168.0.105), and Destination Port (in our example, 5060).
Table 1 lists the required Trunk Configuration settings and their values (Figure 14).
To successfully communicate with the Mediation Server, CUCM must use the codec, G.711. The device pool default setting in CUCM 7.1 is configured to use the G.711 codec. The Device Pool setting shown in Table 1 and Figure 14 should be set to "Default". If your CUCM default device pool does not use G.711 as the codec, you will need to use a device pool that uses G.711.
Click Save, and then reset the trunk by clicking the Reset icon at the top of the Trunk Configuration page to activate the SIP trunk changes.
Route patterns are designed for routing calls from CUCM to the Mediation Server over the SIP trunk so that users who are using a Cisco IP phone can call Office Communicator users. The route patterns determine which calls are sent to the SIP trunk based on a pattern match of the phone number in the TO field. Route patterns can also perform transformations of the dial strings for the TO and the FROM fields.
To set up the route pattern
From the CUCM Administration console, click Call Routing, click Route/Hunt, and then click Route Pattern (Figure 15).
Click Add New, and then configure the route pattern.
For example, if you want users who are using a Cisco IP phone to be able to dial an Office Communicator user using a 4-digit extension, create a route pattern that is associated to the Trunk_to_OCS SIP trunk that you created earlier that instructs CUCM to route to the Mediation Server all calls that match the TO dial string with the pattern xxxx. In this case, no transformation of the dial strings in the TO and the FROM fields is necessary. This route pattern configuration is illustrated in Figure 16.
You will need to define multiple CUCM routing patterns if you have different Office Communications Server numbering formats for specific offices or geographic locations.
That completes your introduction to configuring a SIP trunk on Cisco’s Unified Communications Manager (also known as CallManager).
Visit the Communications Server main page at http://go.microsoft.com/fwlink/?LinkId=132607.
View the complete Communications Server documentation library at http://go.microsoft.com/fwlink/?LinkId=132106.
Download the Communications Server content as Word documents at http://go.microsoft.com/fwlink/?LinkId=133609.
Download the Communications Server documentation as a compiled Help file at http://go.microsoft.com/fwlink/?LinkId=160355. (Scroll down to the Additional Information section and download OCSDocumentation.chm.)
Read weekly articles for Communications Server IT professionals on NextHop at http://go.microsoft.com/fwlink/?LinkId=181907.
Read NextHop articles in the Technical Library at http://go.microsoft.com/fwlink/?LinkId=185344.
Subscribe to NextHop feeds on the OPML List for NextHop page at http://go.microsoft.com/fwlink/?LinkId=185345.
Read weekly articles for Communications Server developers on UCode at http://go.microsoft.com/fwlink/?LinkId=177892.
Follow tweets from the Communications Server team at http://go.microsoft.com/fwlink/?LinkId=167909.