Configure SIP Normalization and Transparency

Transcription

1 SIP Normalization and Transparency Overview, page 1 SIP Normalization and Transparency Prerequisites, page 2 SIP Normalization and Transparency Configuration Task Flow, page 3 SIP Normalization and Transparency Overview SIP normalization and transparency is an optional feature that handles SIP interoperability issues between Cisco Unified Communications Manager and endpoints, service providers, PBXs, or gateways that implement SIP differently. To configure SIP normalization and transparency, apply a customized lua script to a SIP trunk or SIP line. Cisco Unified Communications Manager applies the script to the SIP messaging that passes through the SIP trunks or SIP lines. Upon installation Cisco Unified Communications Manager contains default normalization and transparency scripts that you can assign to the SIP trunks and SIP profiles in your system. You can also create and import your own customized scripts. SIP Normalization SIP normalization scripts modify incoming and outgoing SIP messages. For example, if you are interoperating Cisco Unified Communications Manager with a Cisco TelePresence Video Communications Server, apply the vcs-interop script to the SIP trunk that connects the two. The script resolves the differences in the SIP messaging so that the two products can communicate. You can apply a normalization script to any SIP trunk connection, regardless of which protocol is being used by the endpoint that connects to that SIP trunk. SIP Transparency SIP transparency scripts enable Cisco Unified Communications Manager to transparently pass SIP information, such as proprietary headers, from one call leg to the other. For transparency to work, both call legs must be SIP. Another feature of SIP transparency is REFER transparency, which allows Cisco Unified Communications Manager to pass on REFER requests without acting on them. You can use REFER transparency in call center environments where a centralized agent may answer a call and then transfer the call to an agent who resides 1

2 Default Scripts for SIP Normalization and Transparency in the same geographical area as the caller. REFER transparency allows the centralized Cisco Unified Communications Manager to drop the call and shift call control to the new agent. Default Scripts for SIP Normalization and Transparency Uopn installation, Cisco Unified Communications Manager contains the following default scripts for SIP Normalization and Transparency. You can apply these scripts to a SIP trunk or SIP profile, but you cannot edit these scripts: HCS-PCV-PAI passthrough Provides Cisco HCS plaform integration with Enterprise IMS. cisco-telepresence-conductor-interop Provides interoperability for endpoints registered to TelePresence Conductor. cisco-telepresence-mcu-ts-direct-interop Provides interoperability between Cisco Unified Communications Manager and either Cisco TelePresence MCU or Cisco TelePresence Server. diversion-counter Provides capability to adjust the diversion counter. refer-passthrough Removes Cisco Unified Communications Manger from the call due to a blind transfer between SIP trunks. vcs-interop Provides interoperability for endpoints that are registered to the Cisco TelePresence Video Communications Server. SIP Normalization and Transparency Prerequisites Review the following prerequisites before configuring SIP Normalization and Transparency: Make sure that you understand how the SIP devices that you are deploying implement SIP. For example, if you are interoperating Cisco Unified Communications Manager with a Cisco TelePresence Video Communications Server, you must apply the vcs-interop script to the SIP trunk that connects the two products. Review the default scripts and verify if they meet your needs. For details, see Default Scripts for SIP Normalization and Transparency, on page 2. If you plan to interoperate Cisco Unified Communications Manager with a third-party SIP product, make sure that you understand how the third-party product implements SIP so that you know whether you need to create a custom script. If you plan to develop your own custom scripts, review the Developer Guide for SIP Normalization and Transparency at unified-communications-manager-callmanager/products-programming-reference-guides-list.html. 2

3 SIP Normalization and Transparency Configuration Task Flow SIP Normalization and Transparency Configuration Task Flow Command or Action Create New SIP Normalization and Transparency Scripts, on page 3 Apply Normalization or Transparency Script to SIP Trunk, on page 4 Purpose Optional. If none of the preinstalled scripts meet your needs, use this procedure to configure a customized script. You can create your new script in the SIP Normalization Script Configuration window or you can import a customized script. In the Trunk Configuration window, apply a script directly to a SIP trunk. Cisco Unified Communications Manager applies the script to all the SIP messaging that passes through the trunk Apply Normalization or Transparency Script to SIP Lines, on page 4 If you want to apply a normalization or transparency script to a SIP line, apply a script to the SIP profile that is associated to that SIP line. Cisco Unified Communications Manager applies the script to all SIP messaging that uses that SIP profile. Create New SIP Normalization and Transparency Scripts If the default normalization and transparency scripts do not meet your needs, use this procedure to create a new lua script. You can either write the new script in Cisco Unified Communications Manager or import a file into the system. Tip If the script that you want to create closely resembles a default script, open the default script in the SIP Normalization Script Configuration window and copy the Contents text box. Create a new script and paste the contents into the Contents text box. You can then edit the content in the new script. Step 4 Step 5 In Cisco Unified CM Administration, choose Device > Device Settings > SIP Normalization Script. Click Add New. The SIP Normalization Script Configuration window appears. Enter a Name and Description for your script. If you are writing a new script, edit the script in the Contents text box. Optional. If you have a external file that you want to import, do the following a) Click Import File. b) Browse to locate the file and select the file. 3

4 Apply Normalization or Transparency Script to SIP Trunk Step 6 Step 7 c) Click Import File. The SIP Normalization Script Configuration window displays the contents of the imported file in the Contents text box. Complete the fields in the SIP Normalization Script Configuration window. For help with the fields and their contents, refer to the online help. Click Save. What to Do Next Assign the script to a SIP profile or SIP trunk: Apply Normalization or Transparency Script to SIP Trunk, on page 4 Apply Normalization or Transparency Script to SIP Lines, on page 4 Apply Normalization or Transparency Script to SIP Trunk Use this procedure to apply a SIP normalization or transparency script to a SIP trunk. Cisco Unified Communications Manager applies the script to all SIP messaging that passes through the trunk. Step 4 Step 5 Step 6 From Cisco Unified CM Administration, choose Device > Trunk. Click Find and select the trunk to which you want to apply a script. From the Normalization Script drop-down list box, choose the script that you want to apply to the trunk. Optional. If you want to normalize specific parameters within the SIP messaging, do the following: a) Enter the Parameter Name that you want to normalize, and the Parameter Value for the value that you want to apply to the parameter. For example, you could enter a Location parameter and North Carolina as the value. b) To add additional parameters, click the (+) button to create additional lines where you can enter additional parameters and values. Optional. If you want to produce SDI traces against the script, check the Enable Trace check box. Note Cisco recommends that you enable tracing while debugging your scripts. Click Save. Apply Normalization or Transparency Script to SIP Lines You can apply a normalization or transparency script to a SIP line by applying the script to the SIP profile that is used by that SIP line. Cisco Unified Communications Manager applies the script to all the SIP messaging that uses that SIP profile. 4

5 Apply Normalization or Transparency Script to SIP Lines Step 4 Step 5 Step 6 From Cisco Unified CM Administration, choose Device > Device Settings > SIP Profile. Click Find and select the SIP profile to which you want to apply a script. From the Normalization Script drop-down list box, choose the script that you want to apply to the trunk. Optional. If you want to normalize specific parameters within the SIP messaging, do the following: a) Enter the Parameter Name that you want to normalize, and the Parameter Value for the value that you want to apply to the parameter. For example, you could enter a Location parameter and North Carolina as the value. b) To add additional parameters, click the (+) button to create additional lines where you can enter additional parameters and values. Optional. If you want to produce SDI traces against the script, check the Enable Trace check box. Note Cisco recommends that you enable tracing while debugging your scripts. Click Save. 5

6 Apply Normalization or Transparency Script to SIP Lines 6