PIMG Integration Guide for Cisco Unity Connection Release 10.x

Setting Up an Avaya S8300/S8500/S8700 Digital PIMG Integration with Cisco Unity Connection

---

For detailed instructions for setting up an Avaya S8300/S8500/S8700 digital PIMG integration with Cisco Unity Connection, see the following sections in this chapter:

• Task List to Create an Avaya S8300/S8500/S8700 PIMG Integration
• Requirements
• Programming Avaya S8300/S8500/S8700 PIMG Phone System for Integration
• Setting Up the Digital PIMG Units
• Creating a New Integration with the Avaya S8300/S8500/S8700 Phone System

Task List to Create an Avaya S8300/S8500/S8700 PIMG Integration

Before doing the following tasks to integrate Unity Connection with the Avaya S8300/S8500/S8700 phone system using PIMG units (media gateways), confirm that the Unity Connection server is ready for the integration after completing the server installation, following the tasks in the “Installing Cisco Unity Connection” chapter of the Install, Upgrade, and Maintenance Guide for Cisco Unity Connection, Release 10.x, available at http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/10x/install_upgrade/guide/10xcuciumgx/10xcuciumg010.html.

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

2. Plan how the voice messaging ports are used by Cisco Unity Connection. See the “Planning the Usage of Voice Messaging Ports in Cisco Unity Connection” chapter.

3. Program the Avaya S8300/S8500/S8700 phone system and extensions. See the “Programming Avaya S8300/S8500/S8700 PIMG Phone System for Integration” section.

4. Set up the PIMG units. See the “Setting Up the Digital PIMG Units” section.

5. Create the integration. See the “Creating a New Integration with the Avaya S8300/S8500/S8700 Phone System” section.

6. Test the integration. See the “Testing the Integration” chapter.

7. If this integration is a second or subsequent integration, add the applicable new user templates for the new phone system. See the “Adding New User Templates for Multiple Integrations” chapter.

Requirements

The Avaya S8300/S8500/S8700 integration supports configurations of the following components:

Phone System

• An Avaya S8300, Avaya S8500, or Avaya S8700 phone system. The voice messaging ports that connect to the PIMG units must be compatible with the 7434ND, 8434, 8434D, or 8434DX digital phones.

---

Caution You must use 2-wire line cards for these voice messaging ports. Otherwise, the voice messaging ports are not compatible with the 7434ND, 8434, 8434D, or 8434DX digital phones.

---

• Software version Communication Manager 2.0.
• One or more of the applicable PIMG units. For details, see the “Introduction” chapter.
• The voice messaging ports in the phone system connected by digital lines to the ports on the PIMG units.

To simplify troubleshooting, we recommend that you connect the voice messaging ports on the phone system to the ports on the PIMG units in a planned manner. For example, connect the first phone system voice messaging port to the first port on the first PIMG unit, connect the second phone system voice messaging port to the second port on the first PIMG unit, and so on. Alternatively, if you have multiple PIMG units, you can reduce answer times in the event of a PIMG unit failure by connecting the phone system ports to the PIMG units in a round-robin fashion. For example, connect the first phone system voice messaging port to the first port on the first PIMG unit, connect the second phone system voice messaging port to the first port on the second PIMG unit, and so on.

• The PIMG units connected to the same LAN or WAN that Unity Connection is connected to.
• If the PIMG units connect to a WAN, the requirements for the WAN network connections are:

– For G.729a codec formatting, a minimum of 32.76 Kbps guaranteed bandwidth for each voice messaging port.

– For G.711 codec formatting, a minimum of 91.56 Kbps guaranteed bandwidth for each voice messaging port.

– No network devices that implement network address translation (NAT).

– A maximum 200 ms one-way network latency.

Programming Avaya S8300/S8500/S8700 PIMG Phone System for Integration

If you use programming options other than those supplied in the following procedure, the performance of the integration may be affected.

The following programming instructions are provided as an example only. The specific programming for your phone system may vary depending on its configuration.

Caution In programming the phone system, do not send calls to voice messaging ports in 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.

---

To Program the Avaya S8300/S8500/S8700Phone System

Step 1 Create a coverage path which contains the PIMG unit hunt group number as the coverage point.

Step 2 Assign the coverage path that you created in Step 1 to the user stations that must forward to the voice messaging ports on the PIMG units when calls are not answered or when the user station is busy, based on one of the Unity Connection call transfer types shown in Table 6-1 .

Step 3 Use the Add Station <extension number> command (for example, Add Station 2999) to assign an extension number for each voice messaging port, which is a digital line that connects to the PIMG unit. Set the voice messaging port options ( Table 6-2 ) and button assignments ( Table 6-3 ), and press Enter.

Note We recommend that you distribute the voice messaging ports among multiple phone system line cards so that call processing can continue even if a line card becomes inactive.

Step 4 Use the Add Hunt <hunt group number> command (for example, Add Hunt 1) to assign a the voice messaging ports to a hunt group. Set the following options.

Step 5 Enter the group member assignments for the voice messaging ports that answer calls and press Enter.

If you plan to set the voice messaging ports to either answer calls or to dial out (for example, to set MWIs), make sure that you include in the hunt group only the voice messaging ports that are set to answer calls.

For smaller systems, include in the hunt group all voice messaging ports when the ports are set to both answer calls and dial out (for example, to set MWIs).

Setting Up the Digital PIMG Units

Do the following procedures to set up the digital PIMG units that are connected to the Avaya S8300/S8500/S8700 phone system.

These procedures require that the following tasks have already been completed:

• The phone system is connected to the PIMG units using digital lines.
• The PIMG units are ready to be connected to the LAN or WAN.
• The PIMG units are connected to a power source.

Fields that are not mentioned in the following procedures must keep their default values. For the default values of all fields, see the manufacturer documentation for the PIMG units.

To Download the PIMG Firmware Update Files for Digital PIMG Units

Step 1 On a Windows workstation with a high-speed Internet connection that access to the PIMG units, go to the following link:

http://software.cisco.com/download/navigator.html?mdfid=280082558&i=rm.

Note To access the software download page, you must be signed in to Cisco.com as a registered user.

This procedure describes the steps when using Internet Explorer as your web browser. If you are using a different web browser, the steps may differ.

Step 2 In the tree control on the Downloads Home page, expand Unified Communications> Unified Communications Applications > Messaging > Cisco Unity and select Cisco Unity Telephony Integration.

Step 3 On the Log In page, enter your username and password, then select Log In.

Step 4 On the Select a Release page, under Latest Releases, select the most recent release.

Step 5 In the right column, select the version of the firmware for digital PIMG units.

Step 6 On the Download Image page, select Download.

Step 7 On the Supporting Document(s) page, select Agree.

Step 8 In the File Download dialog box, select Save.

Step 9 In the Save As dialog box, browse to the Windows workstation that access the PIMG units, browse to a directory where you want to save the file, and select Save.

Step 10 In the Download Complete dialog box, select Open. The window for extracting the PIMG firmware update files appears and select Extract.

Step 11 In the Extract dialog box, browse to the directory where you want the extracted files, and select Extract.

Step 12 Close the window for the extracting application.

To Set Up the Digital PIMG Units (Firmware Version 6.x)

Step 1 On the Windows workstation, add a temporary route to enable access to the PIMG units.

a. On the Windows Start menu, select Run.

b. Enter cmd, and press Enter. The Command Prompt window appears.

c. At the command prompt, enter route add 10.12.13.74 <IP Address of Workstation>, and press Enter.

For example, if the IP address of the workstation is 198.1.3.25, enter “route add 10.12.13.74<space>198.1.3.25” in the Command Prompt window.

d. Close the Command Prompt window.

Step 2 Connect a PIMG unit to the network.

Step 3 In the web browser, go to http://10.12.13.74.

Step 4 To sign in, enter the following case-sensitive settings.

Step 5 Select OK.

Step 6 On the System menu, select Upgrade.

Step 7 On the Upgrade page, select Browse.

Step 8 In the Choose File dialog box, browse to the directory on the Windows workstation that has the extracted PIMG firmware update files.

Step 9 Select Ami<xx>.app (where <xx> is multiple digits), and select Open.

Step 10 On the Upgrade page, select Install File.

Step 11 After the file is installed, a message prompting you to restart the PIMG unit appears. Select Cancel.

Step 12 Repeat Step 6 through Step 11 for each of the following files:

• Ami_<xx>.fsh
• Run<xx>FskEcho.dsp
• iNim<xx>.ibt
• iNim<xx>.ilc
• iNim<xx>.iap

Step 13 On the Configuration menu, select Import/Export.

Step 14 On the Import/Export page, select Browse.

Step 15 In the Choose File dialog box, browse to the file DNI_Cfg_Lucent.ini.

Step 16 Select DNI_Cfg_Lucent.ini, and select Open.

Step 17 On the Import/Export page, select Import File.

Step 18 After the file is imported, a message prompting you to restart the PIMG unit appears. Select OK.

Step 19 In the web browser, go to http://10.12.13.74.

Step 20 To sign in, enter the following case-sensitive settings.

Step 21 Select OK.

Step 22 Do the following substeps to configure an RTP port range of 16384 to 32767 and to configure updating the calling number.

Note The default RTP port range for PIMG units is 49000 to 50000. Some Unity Connection configurations require a different RTP port range.

a. On the Configuration menu, select Import/Export.

b. On the Import/Export page, under Export Settings, select Export All Settings.

c. In the File Download dialog box, select Save.

d. In the Save As dialog box, browse to the Windows workstation that has access to the PIMG units, browse to a directory where you want to save the file, and select Save.

e. In the Download Complete dialog box, select Open. Notepad opens the file Config.ini that you saved.

f. Locate the line with the following parameter:

g. Change the value of the parameter to “yes” so that the line reads as follows:

h. Locate the line with the following parameter:

i. Change the value of the parameter to 16384 so that the line reads as follows:

j. Locate the line with the following parameter:

k. Change the value of the parameter to 32767 so that the line reads as follows:

l. Save the file, and exit Notepad.

m. On the Configuration menu of the PIMG unit, select Import/Export.

n. On the Import/Export page, under Browse for Import File, select Browse.

o. In the Choose File dialog box, browse to the file Config.ini that you saved.

p. Select Config.ini, and select Open.

q. On the Import/Export page, select Import File.

r. When prompted to restart the PIMG unit, select OK.

s. When the PIMG unit has restarted, in the web browser, go to http://10.12.13.74.

t. To sign in, enter the following case-sensitive settings.

u. Select OK.

Step 23 On the System menu, select Password.

Step 24 On the Change Password page, enter the following settings.

Step 25 Select Change.

Step 26 On the Configuration menu, select Routing Table.

Step 27 On the Routing Table page, under Router Configuration, select VoIP Host Groups.

Step 28 Under VoIP Host Groups, enter the following settings for the first VoIP Host Group.

Step 29 For Unity Connection without a cluster, under Host List, enter the host name or IP address of the Unity Connection server and the server port in the format <host name or IP address>:5060.

For Unity Connection with a cluster configured, under Host List, enter the host name or IP address of the subscriber server (the second Unity Connection server that you installed) and the server port in the format <host name or IP address>:5060.

Step 30 For Unity Connection without a cluster, continue to Step 32. For Unity Connection with a cluster configured, select Add Host.

Step 31 In the second field, enter the host name or IP address of the publisher server (the first Unity Connection server that you installed) and the server port in the format <host name or IP address>:5060.

Step 32 Select Submit.

Step 33 Under Router Configuration, select TDM Trunk Groups.

Step 34 Under TDM Trunk Groups, select Add Trunk Group.

Step 35 Under TDM Trunk Groups, enter the following settings for the first TDM trunk group.

Step 36 Under TDM Trunk Groups, select Add Trunk Group.

Step 37 Enter the following settings for the second TDM trunk group.

Step 38 Under TDM Trunk Groups, select Add Trunk Group.

Step 39 Enter the following settings for the third TDM trunk group.

Step 40 Select Submit.

Step 41 Under Router Configuration, select Inbound VoIP Rules.

Step 42 Under Inbound VoIP Rules, uncheck the Enabled check box for the default rule.

Step 43 Select Add Rule.

Step 44 Under Inbound VoIP Rules, enter the following settings for the first new inbound VoIP rule.

Step 45 Under Inbound VoIP Request Matching, enter the following settings.

Step 46 Under Outbound Routes, enter the following settings.

Step 47 Under Inbound VoIP Rules, select Add Rule.

Step 48 Under Inbound VoIP Rules, enter the following settings for the second new inbound VoIP rule.

Step 49 Under Inbound VoIP Request Matching, enter the following settings.

Step 50 Under Outbound Routes, enter the following settings.

Step 51 Select Submit.

Step 52 Under Router Configuration, select Inbound TDM Rules.

Step 53 Under Inbound TDM Rules, enter the following settings for the first inbound TDM rule.

Step 54 Under Inbound TDM Request Matching, enter the following settings.

Step 55 Under Outbound Routes, enter the following settings.

Step 56 If you want to create more Inbound TDM rules, under Inbound TDM Rules, select Add Rule. Otherwise, continue to Step 58.

Step 57 Repeat Step 53 through Step 56 for all remaining inbound TDM rules that you want to create.

Step 58 Select Submit.

Step 59 On the Configuration menu, select TDM > Digital.

Step 60 On the Digital Telephony page, in the Telephony Switch Type field, select Lucent.

Step 61 Select Submit.

Step 62 On the Configuration menu, select TDM > General.

Step 63 On the TDM General Settings page, enter the following settings.

Step 64 Select Submit.

Step 65 On the Configuration menu, select TDM > Port Enable.

Step 66 On the TDM Port Enabling page, select No for the ports that you want to disable on the PIMG unit.

Step 67 Confirm that Yes is selected for all other ports on the PIMG unit.

Step 68 Select Submit.

Step 69 On the Configuration menu, select VoIP > General.

Step 70 On the VoIP General Settings page, enter the following settings.

Step 71 Select Submit.

Step 72 On the Configuration menu, select VoIP > Media.

Step 73 On the VoIP Media Settings page, enter the following settings.

Table 6-24 VoIP Media Settings Page Settings

Field	Settings
Audio
Audio Compression	Select the preferred codec for audio compression.
RTP Digit Relay Mode	Select RFC2833.
RTP Fax/Modem Tone Relay Mode	Select RFC2833.
RTP Source IP Address Validation	Select Off.
RTP Source UDP Port Validation	Select Off.
Signaling Digit Relay Mode	Select Off.
Voice Activity Detection	Select Off.
RFC 3960 Early Media Support	Select On Demand.
Frame Size	Select the applicable setting: G.711— 20 G.729AB— 10 Caution Failure to use the correct setting results in recorded messages containing nothing but silence.
Frames Per Packet	Select the applicable setting: G.711— 1 G.729AB— 2 Caution Failure to use the correct setting results in recorded messages containing nothing but silence.
Fax
Fax IP-Transport Mode
SRTP
SRTP Preference	Select RTP Only.
MKI on Transmit Stream	Select Yes.
Key Derivation Enable	Select Yes.
Key Derivation Rate	Enter 16.
Anti-replay Window Size Hint	Enter 64.
Cipher Mode	Select AES_Counter_Mode.
Authentication Type	Select SHA1.
Authentication Tag Length	Select SHA1_80_bit.

Step 74 Select Submit.

Step 75 On the Configuration menu, select VoIP > QOS.

Step 76 On the VoIP QOS Configuration page, enter the following settings.

Step 77 Select Submit.

Step 78 On the Configuration menu, select IP.

Step 79 On the IP Settings page, enter the following settings.

Step 80 Select Submit.

Step 81 On the Configuration menu, select Tone Detection.

Step 82 On the Tone Detection page, under Call Progress Tone - Learn, in the Learn Tone Event field, select Busy and do the following substeps to verify that the tone is correct.

a. From a available phone, call a second phone.

b. Answer the second phone when it rings, and leave both handsets off so that both phones are busy.

c. From a third phone, dial one of the busy phones.

d. Confirm that you hear a busy tone.

e. Hang up the third phone but leave the handsets for the other two phones off.

Step 83 Under Call Progress Tone - Learn, in the Dial String field, enter the extension that you dialed in Step 82c. from the third phone.

Step 84 Select Learn.

Step 85 On the Tone Detection page, under Call Progress Tone - Learn, in the Learn field, select Error and do the following substeps to verify that the tone is correct.

a. From an available phone, dial an extension that does not exist.

b. Confirm that you hear the reorder or error tone.

c. Hang up the phone.

Step 86 Under Call Progress Tone - Learn, in the Dial String field, enter the extension that you dialed in Step 85a.

Step 87 Select Learn.

Step 88 On the Tone Detection page, under Call Progress Tone - Learn, in the Learn field, select Ringback and do the following substeps to verify that the tone is correct.

a. From an available phone, dial an extension that does exist

b. Confirm that you hear the ringback tone.

c. Hang up the phone.

Step 89 Under Call Progress Tone - Learn, in the Dial String field, enter the extension that you dialed in Step 88a.

Step 90 Select Learn.

Step 91 Select Submit.

Step 92 Hang up the phones that you used in Step 82.

Step 93 On the System menu, select Restart.

Step 94 On the Restart page, select Restart Unit Now.

Step 95 Repeat Step 2 through Step 94 on all remaining PIMG units.

Creating a New Integration with the Avaya S8300/S8500/S8700 Phone System

After ensuring that the Avaya S8300/S8500/S8700 phone system, the PIMG units, and 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 In Cisco Unity Connection Administration, expand Telephony Integrations and select Phone System.

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

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

Step 4 If you want to use this phone system as the default for TRaP connections so that administrators and users without voicemail boxes can record and playback through the phone in Unity Connection web applications, check the Default TRAP Switch check box. If you want to use another phone system as the default for TRaP connections, uncheck this check box.

Step 5 Under Message Waiting Indicator Settings, select Use Same Port for Enabling and Disabling MWIs.

Step 6 Select Save.

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

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

Table 6-27 Settings for the New Port Group Page

Field	Setting
Phone System	Select the name of the phone system that you entered in Step 3.
Create From	Select Port Group Template and select SIP to DMG/PIMG/TIMG 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.
SIP Security Profile	Select 5060.
SIP Transport Protocol	Select the SIP transport protocol that Unity Connection uses.
IPv4 Address or Host Name	Enter the IP address of the PIMG unit that you are integrating with Unity Connection.
IPv6 Address or Host Name	Do not enter a value in this field. IPv6 is not supported for PIMG integrations.
IP Address or Host Name	Enter the IP address of the PIMG unit that you are integrating with Unity Connection.
Port	Enter the SIP port of the PIMG unit that Unity Connection connects to. We recommend that you use the default setting. Caution This name must match the setting in the TCP/UDP Server Port field on the Configuration > VoIP > General page of the PIMG unit. Otherwise, the integration cannot function correctly.

Step 9 On the Port Group Basics page, under Message Waiting Indicator Settings, uncheck the Enable Message Waiting Indicators check box and select Save.

Step 10 In the Related Links drop-down box, select Add Ports and select Go.

Step 11 On the New Port page, enter the following settings and select Save.

Step 12 On the Search Ports page, select 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 13 On the Port Basics page, set the voice messaging port settings as applicable. (For information on each field, see Help> This Page).

Step 14 Select Save.

Step 15 Select Next.

Step 16 Repeat Step 13 through Step 15 for all remaining voice messaging ports for the phone system.

Step 17 In Cisco Unity Connection Administration, expand Telephony Integrations and select Phone System.

Step 18 On the Search Phone Systems page, under Display Name, select the name of the phone system that you entered in Step 3.

Step 19 Repeat Step 7 through Step 18 for each remaining PIMG unit is integrated with Unity Connection.

Note Each PIMG unit is connected to one port group with the applicable voice messaging ports. For example, a system that uses five PIMG units requires five port groups, one port group for each PIMG unit.

Step 20 To create a port group for MWIs, do the following substeps.

Note All MWI requests are handled by the master PIMG unit and sent to the phone system over the RS-232 serial cable (without using voice messaging ports). So the following substeps create a separate port group without voice messaging ports and enable the port group for MWIs that are “not port specific” (they do not use ports).

a. In Cisco Unity Connection Administration, expand Telephony Integrations and select Port Group.

b. On the Search Port Groups page, select Add New.

c. On the New Port Group page, enter the applicable settings and select Save.

Table 6-29 Settings for the New Port Group Page (MWIs)

Field	Setting
Phone System	Select the name of the phone system that you entered in Step 3.
Create From	Select Port Group Template and select SIP to DMG/PIMG/TIMG in the drop-down box.
Display Name	Enter a MWI Port Group or another descriptive name for the port group.
SIP Security Profile	Select 5060.
SIP Transport Protocol	Select the SIP transport protocol that Unity Connection uses.
IPv4 Address or Host Name	Enter the IP address of the master PIMG unit.
IPv6 Address or Host Name	Do not enter a value in this field. IPv6 is not supported for PIMG integrations.
IP Address or Host Name	Enter the IP address of the master PIMG unit.
Port	Enter the SIP port of the master PIMG unit. Caution This name must match the setting in the TCP/UDP Server Port field on the Configuration > VoIP > General page of the PIMG unit. Otherwise, the integration cannot function correctly.

d. On the Port Group Basics page, on the Edit menu, select Advanced Settings.

e. On the Edit Advanced Settings page, under SIP MWI Requests, select Not Port Specific. and select Save.

f. On the Edit menu, select Port Group Basics.

g. Under Port Group, select Reset.

h. Under Message Waiting Indicator Settings, confirm that the Enable Message Waiting Indicators check box is checked and select Save.

Step 21 If another phone system integration exists, in Cisco Unity Connection Administration, expand Telephony Integrations, then select Trunk. Otherwise, skip to Step 25.

Step 22 On the Search Phone System Trunks page, on the Phone System Trunk menu, select New Phone System Trunk.

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

Step 24 Repeat Step 22 and Step 23 for all remaining phone system trunks that you want to create.

Step 25 In the Related Links drop-down list, select Check Telephony Configuration and select 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 26 In the Task Execution Results window, select Close.