Cisco Unified Application Environment

Table Of Contents

Cisco Unified Application Environment
Release Notes, Release 2.5(1) SR2

Contents

Related Documentation

New and Changed Information

JTAPI Address Change Notifications

Enhanced Cisco Unified Communications Manager Support

New Messaging Plugin

Core Addendum and Prerequisite Upgrade

Installation and Upgrade Notes

Upgrading from Release 2.3 or 2.4 to Release 2.5(1) SR2

Upgrading From Release 2.5(1) to Release 2.5(1) SR2

Installing Cisco Unified Application Environment Developer Tools

Installing the Cisco Unified Application Environment Messaging Plugin

Caveats

Using Bug Toolkit

Open Caveats

Resolved Caveats

Obtaining Documentation and Submitting a Service Request

Cisco Unified Application Environment
Release Notes, Release 2.5(1) SR2

---

Revised: March 2009, OL-19337-01

These release notes describe the new features and caveats for the Cisco Unified Application Environment, Release 2.5(1) SR2.

Contents

•Related Documentation

•New and Changed Information

•Installation and Upgrade Notes

•Caveats

•Obtaining Documentation and Submitting a Service Request

Related Documentation

There are two types of related documentation: product and developer.

•Table 1 provides links to product documentation.

•For developer documentation, go to: http://developer.cisco.com/web/cuae

Table 1 Product Documentation 

Related Information	URL
Cisco Unified Application Environment Administration Guide, Release 2.5.1	http://www.cisco.com/en/US/products/ps7058/prod_maintenance_guides_list.html
Cisco Unified Application Environment Installation Guide, Release 2.5.1	http://www.cisco.com/en/US/products/ps7058/prod_installation_guides_list.html
Cisco Unified Application Environment Messaging Plugin Installation Guide, Release 2.5.1 SR1	http://www.cisco.com/en/US/products/ps7058/prod_installation_guides_list.html
Cisco Unified Application Environment Upgrade Guide, Release 2.5.1	http://www.cisco.com/en/US/products/ps7058/prod_installation_guides_list.html
Cisco Unified Application Environment Hardware Compatibility Matrix, Release 2.5.1	http://www.cisco.com/en/US/products/ps7058/products_device_support_tables_list.html
Cisco Unified Application Environment Software Compatibility Matrix, Release 2.5.1
Open Source License Notices for the Cisco Unified Application Environment	http://www.cisco.com/en/US/docs/voice_ip_comm/cuae/openssl_license/cuae_ssllic.html
Cisco Unified Communications Manager Documentation	http://www.cisco.com/en/US/products/sw/voicesw/ps556/tsd_products_support_series_home.html

New and Changed Information

This section contains the following topics that describe new features and changes that are pertinent to the Cisco Unified Application Environment:

•JTAPI Address Change Notifications

•Enhanced Cisco Unified Communications Manager Support

•New Messaging Plugin

•Core Addendum and Prerequisite Upgrade

JTAPI Address Change Notifications

The following new triggering events were added to the JTAPI 3rd-party API to provide address change notifications for monitored devices:

•JTapiAddressAddedToTerminal

•JTapiAddressRemovedFromTerminal

•JTapiAddressInService

•JTapiAddressOutService

The following new action was added to the JTAPI 3rd-party API:

•JTapiGetAddressesOnTerminal

When a device comes online or when an application gets a JTapiTerminalInService event, you can use the JTapiGetAddressesOnTerminal query to get the extensions that are mapped on the device.

The output of the notifications is a string array of address names. The string array is null if there are no addresses mapped on the device.

Enhanced Cisco Unified Communications Manager Support

Cisco Unified Application Environment now supports Cisco Unified Communications Manager 7.1 and 4.3. Two new JTAPI services for Cisco Unified Communications Manager were added and appear in the Services page in the Cisco Unified Application Environment Administration.

New Messaging Plugin

Released with Cisco Unified Application Environment Release 2.5(1) SR1, the new Messaging Plugin enables developers to build applications that interact with Cisco Unity and Cisco Unity Connection, Release 7.0. It consists of the following components:

•Messaging Plugin—Enables communication between the Cisco Unified Application Environment and the Cisco Unity Server or Cisco Unity Connection Server to allow developers to programmatically read, create, and send voicemail.

•Messaging Plugin Developer Tools—Includes API reference documentation and the Messaging Plugin Etch IDL.

To install the Messaging Plugin or the Messaging Plugin Developer Tools, see the Cisco Unified Application Environment Messaging Plugin Installation Guide listed in the Related Documentation.

Core Addendum and Prerequisite Upgrade

With the Cisco Unified Application Environment Release 2.5(1) SR1, the core addendum includes an updated version of Dialogic HMP 3.0.

Production installations are automatically updated to Dialogic HMP 3.0 version SU 225 when you run the Core Addendum Installer. For more information, see the "Upgrading From Release 2.5(1) to Release 2.5(1) SR2" section.

You must manually upgrade SDK installations to Dialogic HMP 3.0 version SU 225. For more information, see the Cisco Unified Application Environment wiki, Downloads page: http://developer.cisco.com/web/cuae/downloads.

---

Note For best results, do not use a version older than Dialogic HMP 3.0 SU 225.

---

Installation and Upgrade Notes

The following sections describe the upgrade procedures:

•Upgrading from Release 2.3 or 2.4 to Release 2.5(1) SR2

•Upgrading From Release 2.5(1) to Release 2.5(1) SR2

•Installing Cisco Unified Application Environment Developer Tools

•Installing the Cisco Unified Application Environment Messaging Plugin

Upgrading from Release 2.3 or 2.4 to Release 2.5(1) SR2

To upgrade from Release 2.3 or 2.4 to Release 2.5(1) SR2, you must first update to Release 2.5(1). For more information, see the Upgrade Guide for the Cisco Unified Application Environment, Release 2.5, listed in the Related Documentation.

After you upgrade to Release 2.5(1), see the instructions in the "Upgrading From Release 2.5(1) to Release 2.5(1) SR2" section.

Upgrading From Release 2.5(1) to Release 2.5(1) SR2

To upgrade from Release 2.5(1) to Release 2.5(1) SR2, install the following components:

1. Cisco Unified Core Addendum

2. Cisco Unified Platform Services

3. Cisco Unified Application Server

4. Cisco Unified Media Engine

---

Note You are not required to uninstall the previous version of the Cisco Unified Application Environment before installing this version.

---

Before You Begin

Locate the following executable files on the Release 2.5(1) SR2 DVD or download them from the Cisco Unified Application Environment wiki Downloads page http://developer.cisco.com/web/cuae/downloads:

1. CUAE-coreadd-2.5.x.exe (Cisco Unified Core Addendum)

2. CUAE-platsvc-2.5.x.exe (Cisco Unified Platform Services)

3. CUAE-appserver-2.5.x.exe (Cisco Unified Application Server)

4. CUAE-mediaengine-2.5.x.exe (Cisco Unified Media Engine)

Procedure

---

Step 1 Install the following Cisco Unified Application Environment components. Refer to the procedures in the Installation Guide for the Cisco Unified Application Environment, Release 2.5(1). See Related Documentation.

1. CUAE-coreadd-2.5.x.exe (Cisco Unified Core Addendum).

2. CUAE-platsvc-2.5.x.exe (Cisco Unified Platform Services)

3. CUAE-appserver-2.5.x.exe (Cisco Unified Application Server)

4. CUAE-mediaengine-2.5.x.exe (Cisco Unified Media Engine)

Step 2 After installing the components and rebooting the server, log into the Cisco Unified Application Environment Administration to verify that the installation is complete.

Installing Cisco Unified Application Environment Developer Tools

Developers can download the CUAE-devtools-2.5.1.x.exe executable file and installation instructions on the Cisco Unified Application Environment wiki: http://developer.cisco.com/web/cuae/downloads.

Installing the Cisco Unified Application Environment Messaging Plugin

To install the new Messaging Plugin, Messaging Plugin Service or Messaging Plugin Developer Tools, refer to the procedures in the Installation Guide for the Cisco Unified Application Environment Messaging Plugin, Release 2.5(1) SR1. See Related Documentation.

Caveats

This section includes these topics:

•Using Bug Toolkit

•Open Caveats

•Resolved Caveats

Using Bug Toolkit

Known problems (bugs) are graded according to severity level. These release notes contain descriptions of:

•All severity level 1 or 2 bugs.

•Significant severity level 3 bugs.

You can search for problems by using the Cisco Software Bug Toolkit. To access Bug Toolkit, you need the following items:

•Internet connection

•Web browser

•Cisco.com user ID and password

To use the Software Bug Toolkit, follow these steps:

Procedure

---

Step 1 To access the Bug Toolkit, go to http://tools.cisco.com/Support/BugToolKit/action.do?hdnAction=searchBugs.

Step 2 Log in with your Cisco.com user ID and password.

Step 3 To look for information about a specific problem, enter the bug ID number in the "Search for Bug ID" field, then click Go.

---

Open Caveats

Table 2 lists the open caveats. For information about an individual bug, click the Identifier to access the online record, including workarounds.

---

Note Because defect status continually changes, be aware that Table 2 reflects a snapshot of the defects that were open at the time the release notes were compiled. For an updated view of open defects, access Bug Toolkit and follow the instructions as described in the "Using Bug Toolkit" section.

---

.

Table 2 Open Caveats for the Cisco Unified Application Environment, Release 2.5(1) SR2

Identifier	Headline
CSCsr40650	An intermittent issues occurs that causes the Bridge action to fail with JTAPI - CTIERR_HOLDFAILED error.
CSCsu03054	P2P Bridged Inbound CTI Route Point - CTIERR_TIMEOUT after 15 seconds and 1-way audio from call recipient to caller. When a CTI port is used, the issue is not seen and the connectivity is not affected.
CSCzb50741	MakeCall_Complete: To not correct under forwarded conditions w/ H.323.
CSCzb50990	MakeCall_Complete: OriginalTo not populated by SCCP and H.323.
CSCzb50991	MakeCall_Complete: To not correct under forwarded conditions w/ H.323.
CSCzb51019	SCCP provider fails to handle conference call flow.
CSCsv97343	No two-way media using ICT after Hold and Resume with SIP.
CSCsw17052	Call Control State goes from TALKING state to DROPPED state.
CSCsw52764	The JTapi provider reports the error "E JTP Call encountered an error (CallIdUnknown): <no description>". This error message is caused due to a harmless race condition.
CSCsw31182	Cisco Unified Application Designer does not support the Messaging Plugin.
CSCsx05179	An intermittent issue occurs during uninstallation of the Messaging Plugin. When the uninstaller alerts the user that the connection to the CUAE server has timed out, the uninstaller proceeds to continue uninstallation of the plugin from the machine, but it is unclear to the user that the uninstallation was successful.
CSCsx04874	When uninstalling a plugin package, the CUAE command-line tool is calling the Management Service API. When the server-side API takes too long to respond, the client-side etch API throws a timeout exception before the server completes the processing and returns.
CSCsx05616	An intermittent issue occurs when the Cisco Unified Application Environment Messaging Plugin connects to the Unity Server. It appears that Login attempts to the AUTH web service of VMWS time out and no SOAP response is sent to the client.
CSCsx17101	Clicking the Cancel button on the Welcome screen or Choose Start Menu screen in the Messaging Plugin installer does not cancel the installation and returns an invalid error message.
CSCsx18881	When adding, editing, or deleting an application trigger using the Cisco Unified Application Environment Administration interface, an error message is written to the application server log file and the changes do not propagate to the Application Server. Use the mceadmin interface to avoid this issue.
CSCsx19837	The Messaging Plugin Developer Tools uninstaller does not return an error message when it cannot find the component that has been selected for removal.

Resolved Caveats

Table 3 lists Severity 1, 2 and 3 defects that are resolved since the last release of the Cisco Unified Application Environment.

For more information about an individual defect, you can access the online record for the defect by clicking the Identifier or going to the URL shown. You must be a registered Cisco.com user to access this online information.

Because defect status continually changes, be aware that Table 3 reflects a snapshot of the defects that were resolved at the time this report was compiled.

For an updated view of resolved defects, access Bug Toolkit as described in the "Using Bug Toolkit" section.

.

Table 3 Resolved Caveats for the Cisco Unified Application Environment 

Identifier	Heading
CSCsx48448	Registering Etch Based Applicaitons With Multiple Partitions Will Fail.

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS version 2.0.

This document is to be used in conjunction with the documents listed in the "Related Documentation" section.

CCDE, CCENT, Cisco Eos, Cisco HealthPresence, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence, Cisco WebEx, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.

All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0812R)

Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.

©2009 Cisco Systems, Inc. All rights reserved.