Guest

Cisco Unified Application Environment

Release Notes for the Cisco Unified Application Environment (2.4.3)

  • Viewing Options

  • PDF (187.0 KB)
  • Feedback
Release Notes for the Cisco Unified Application Environment, Release 2.4.3

Table Of Contents

Release Notes for the
Cisco Unified Application Environment,
Release 2.4.3

Contents

Introduction

Related Documentation

New and Changed Information

Integration with Cisco Unified Communications Manager

Radianta Beacon Office

JTAPI Application

Cisco Unified Application Designer Web Folder

Grammar File Deployment

Localized Grammar File Deployment

API Native Actions

Multiple Recognition Results

SSML Support

Media Engine Configuration

Installation and Upgrade Notes

Upgrading From Release 2.2 or 2.3 to Release 2.4.3

Upgrading From Release 2.4.1 to Release 2.4.3

Upgrading From Release 2.4.2 to Release 2.4.3

Documentation Updates

Installation Guide for the Cisco Unified Application Environment, 2.4

Upgrade Guide for the Cisco Unified Application Environment, 2.4

Administration Guide for the Cisco Unified Application, 2.4

Configuring the Unified Media Engine

Getting Started

Caveats

Using Bug Toolkit

Open Caveats

Resolved Caveats

Obtaining Documentation and Submitting a Service Request


Release Notes for the
Cisco Unified Application Environment,
Release 2.4.3


Revised: February 7, 2012, OL-15346-01

Contents

Introduction

Related Documentation

New and Changed Information

Installation and Upgrade Notes

Documentation Updates

Caveats

Obtaining Documentation and Submitting a Service Request

Introduction

The Cisco Unified Application Environment is a development and runtime platform designed for creating, deploying, and executing converged voice and data applications. It is integrated with Cisco Unified Communications Manager and Cisco Unified Presence.

These release notes describe the new features and caveats for the Cisco Unified Application Environment, Release 2.4.3.

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://www.cisco.com/web/developer/cuae/content/docs.html.

Table 1 Product Documentation 

Related Information
URL

Administration Guide for the Cisco Unified Application Environment, Release 2.4

http://www.cisco.com/en/US/products/ps7058/prod_maintenance_guides_list.htm

Installation Guide for the Cisco Unified Application Environment, Release 2.4

http://www.cisco.com/en/US/products/ps7058/prod_installation_guides_list.html

Upgrade Guide for the Cisco Unified Application Environment, Release 2.4

http://www.cisco.com/en/US/products/ps7058/prod_installation_guides_list.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

The following sections describe new features and changes that are pertinent to the Cisco Unified Application Environment, Release 2.4.3.

Integration with Cisco Unified Communications Manager

Radianta Beacon Office

JTAPI Application

Cisco Unified Application Designer Web Folder

Grammar File Deployment

Localized Grammar File Deployment

API Native Actions

Multiple Recognition Results

SSML Support

Media Engine Configuration

Integration with Cisco Unified Communications Manager

Cisco Unified Application Environment, Release 2.4.3 is integrated with Cisco Unified Communications Manager, Releases 6.0 and 6.1, and continues to support for Cisco Unified CallManager, Releases 4.x and 5.x.

Radianta Beacon Office

A third-party suite of office productivity applications, Radianta Beacon Office, is included in this release. The applications are designed specifically for the Cisco IP telephony environment and can be accessed by both the phone and desktop interfaces. The suite includes: Call Back, Call Note, Call Recorder, Phone Lock, Dialer, Time Card, Paging, Web-Based Extension Mobility (EM) Login, and personal queues.

JTAPI Application

This feature enables you to verify the configuration and functionality of the JTAPI provider. For information about installing and configuring the application, see Getting Started under Documentation Updates.

Cisco Unified Application Designer Web Folder

This feature enables developers to define the folders and files to be packaged with an application that will be uploaded to the Cisco Unified Application Server.

Grammar File Deployment

These grammar files are new in this release:

Built-in—Commonly-used grammar files that are provided with the Voice Recognition Engine or which have been provisioned manually onto the Voice Recognition Engine.

Static—Grammar files used by the Cisco Unified Application Environment applications with grammar content that does not change during the application's life cycle.

Dynamic—Grammar files generated by a Cisco Unified Application Environment application while the application is running.

Localized Grammar File Deployment

Grammar files are localized for this release and follow the same model as media resource files: localized resources reside under each locale folder. (Only western languages are supported.)

API Native Actions

These Media Control actions have changed in this release:

The Play action supports more than three specified prompt files.

The VoiceRecognition action supports more than three specified grammar files.

The VoiceRecognition action supports Text-To-Speech (TTS).

Multiple Recognition Results

Multiple recognition results are supported by requesting the full result list from the voice recognition engine. The returned result list is in XML format, and it is one of the result data items of the VoiceRecognition action.

These are five new actions that serve as helper actions for a developer to retrieve the full voice recognition result:

XmlQuery—Use XPath to parse the XML content for results.

GetNumVoiceRecResults—Return the number of matching results from the voice recognition engine.

GetVoiceRecResult—Use the index to retrieve a single voice recognition result from the result list.

GetVoiceRecResultsByMeaning—Retrieve a list of results based on a meaning string comparison.

GetVoiceRecResultsByScore— Retrieve a list of results that have the same or higher confidence score than the input score.

SSML Support

Speech Synthesis Markup Language (SSML) syntax can be used within the Play and VoiceRecognition prompt fields, but only to the extent that the prompts are supported by the embedded TTS server, which is located on the Cisco Unified Media Engine. (SSML support provides the same support as NeoSpeech.)

Media Engine Configuration

On the main control panel of the Cisco Unified Application Environment management console, the item listed under Local Environment as Media Engine Configuration has been changed to Local System Configuration.

When you select Main Control Panel > Local System Configuration, the Media Configuration page displays with a new input box titled Server Host Name/IP Address to enter the Cisco Unified Media Engine's hostname or IP address.


Note For other servers to access the services on the Cisco Unified Media Engine, you must enter either a fully-qualified host name or an IP address in this section.


For additional information, see Configuring the Unified Media Engine in the Documentation Updates section.

Installation and Upgrade Notes

The following sections describe the upgrade procedures:

Upgrading From Release 2.2 or 2.3 to Release 2.4.3

Upgrading From Release 2.4.1 to Release 2.4.3

Upgrading From Release 2.4.2 to Release 2.4.3

Upgrading From Release 2.2 or 2.3 to Release 2.4.3

To upgrade from Release 2.2 or 2.3 to Release 2.4.3, refer to the Upgrade Guide for the Cisco Unified Application Environment, Release 2.4 listed in the Related Documentation.


Note Refer to Upgrade Guide for the Cisco Unified Application Environment, 2.4 for documentation updates to the upgrade guide.


Upgrading From Release 2.4.1 to Release 2.4.3

To upgrade from Release 2.4.1 to Release 2.4.3, install the following components:

1. Cisco Unified Core Addendum Update

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

1. From this location: http://www.cisco.com/cgi-bin/tablebuild.pl/CUAE, download this executable file: CUAE-coreadd-update-2.4.x.exe (Cisco Unified Core Addendum Update).

2. From this location: http://www.cisco.com/cgi-bin/tablebuild.pl/CUAE-pub, download the following executable files:

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

CUAS-2.4.x.exe (Cisco Unified Application Server)

CUME-2.4.x.exe (Cisco Unified Media Engine)

Procedure


Step 1 Run the CUAE-coreadd-update-2.4.x.exe self-extracting installer.

The package is extracted and runs a verification. Then end-user license agreement appears.

Step 2 Read it, and if you agree with the terms of the agreement, select I Agree.

A console appears with output indicating the progress of the installation setup.

Step 3 After the Cisco Unified Core Addendum Update is installed, use the procedures in the Installation Guide for the Cisco Unified Application Environment, Release 2.4 listed in the Related Documentation to install these components in the following order:


Note Refer to Installation Guide for the Cisco Unified Application Environment, 2.4 for documentation updates to the installation guide.


a. CUAE-platsvc-2.4.x.exe (Cisco Unified Platform Services)

b. CUAS-2.4.x.exe (Cisco Unified Application Server)

c. CUME-2.4.x.exe (Cisco Unified Media Engine)

Step 4 When you have finished installing all the components and the server has rebooted, log into the Cisco Unified Application Server to ensure that the installation has completed.


Upgrading From Release 2.4.2 to Release 2.4.3

To upgrade from Release 2.4.2 to Release 2.4.3, install the following components:

1. Cisco Unified Platform Services

2. Cisco Unified Application Server

3. 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

From this location: http://www.cisco.com/cgi-bin/tablebuild.pl/CUAE-pub, download the following executable files:

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

CUAS-2.4.x.exe (Cisco Unified Application Server)

CUME-2.4.x.exe (Cisco Unified Media Engine)

Procedure


Step 1 Perform the procedures in the Installation Guide for the Cisco Unified Application Environment, Release 2.4 listed in the Related Documentation to install these components in the following order:


Note Refer to Installation Guide for the Cisco Unified Application Environment, 2.4 for documentation updates to the installation guide.


a. CUAE-platsvc-2.4.x.exe (Cisco Unified Platform Services)

b. CUAS-2.4.x.exe (Cisco Unified Application Server)

c. CUME-2.4.x.exe (Cisco Unified Media Engine)

Step 2 When you have finished installing all the components and the server has rebooted, log into the Cisco Unified Application Server to ensure that the installation has completed.


Documentation Updates

There are changes and additions to the following guides for this release:

Installation Guide for the Cisco Unified Application Environment, 2.4

Upgrade Guide for the Cisco Unified Application Environment, 2.4

Administration Guide for the Cisco Unified Application, 2.4

Installation Guide for the Cisco Unified Application Environment, 2.4

Following are changes and additions to the installation guide:

Any reference to Media Engine Configuration, which is listed under Local Environment on the Main Control Panel, is now Local System Configuration.

In the "Installing the Cisco Unified Platform Service" section, a new dialog box displays after you click Install to indicate the installation is complete.

In the "Installing the Cisco Unified Application Server" section, the last step directing you to Install the Cisco Unified Application Server should be: Install the Cisco Unified Media Engine.

In the "Installing the Cisco Unified Application Server" section, an additional step has been added and must be performed after you click Finish.

When the installation has completed, a dialog box prompts you to reboot the server. You do not need to reboot the server if you are installing the Cisco Unified Media Engine on the server.

Upgrade Guide for the Cisco Unified Application Environment, 2.4

Following are changes and additions to the upgrade guide:

Any reference to Media Engine Configuration, which is listed under Local Environment on the Main Control Panel, is now Local System Configuration.

In the "Performing the Post Upgrade Task" section, an additional step has been added and must be performed as the last step in the procedure:

After all of the services have successfully restarted, from the Main Control Panel, click Service Control, then click Restart for the Application Server Service. This ensures that the application server re-verifies the status of the Cisco Unified Application Environment components.

Administration Guide for the Cisco Unified Application, 2.4

Following are sections in the administration guide with changes and additions:

Configuring the Unified Media Engine

Getting Started

Configuring the Unified Media Engine

Following are changes to this section:

All references to the Change Password input box on the Configuring the Cisco Unified Media Engine page are now Local Engine Media Password.

All references to Media Engine Configuration, which is listed under Local Environment on the Main Control Panel, are now Local System Configuration.

A new procedure has been added to the Local System Configuration. Use this procedure to enter the Cisco Unified Media Engine's server host name or IP address to enable other servers to access the services on the Cisco Unified Media Engine.

Procedure


Step 1 Log in to the Cisco Unified Application Environment management console.

Step 2 From the Main Control Panel, under Local Environment, click Local System Configuration.

Step 3 Enter a fully qualified host name or an IP address.


Getting Started

Following is a new procedure to install the JTAPI Sample Application, which is added to the "Setting Up the Cisco Unified Application Environment" section, "Task 5: Install Sample Applications."

Use the application to verify the configuration and functionality of the JTAPI provider, which is used for third-party monitoring of changes in device state, as well as for control over devices.

Before You Begin

On the Cisco Unified Application Environment server, navigate to the directory C:\Program Files\Cisco Systems\Unified Application Environment\Tools\Apps, and locate the JTAPIConnect.mca file. If you are logged in to the Management Console remotely, you must store these files on your local machine. If you are logged in directly to the Management Console, you can copy them to the desktop.

Procedure


Step 1 Upload the JTAPI application into the Cisco Unified Application Environment.

a. Open the management console URL by entering: http://<serverIPaddress>/mceadmin.

b. From the Main Control Panel, click Applications.

c. Click Browse... and highlight the JTAPIConnect.mca file.

d. Click Open to make the file available for uploading.

e. Click Upload File.

The file is uploaded and added to the list on the Applications page.

Step 2 From the management console, add two test devices to the monitored device pool. See the Cisco Unified Application Environment Administration Guide for specific instructions.

Step 3 Using the management console, select Main Control Panel > Applications > JTAPIConnect.

Step 4 In the Device1 field enter the device name of first device from the monitored device pool. In the "Device2 field enter the device name of second device from the monitored device pool.

Step 5 In the Device1_Line field enter the line number of first device from the monitored device pool. In the Device2_Line field enter the line number of the second device from monitored device pool.

Step 6 Click Apply Parameter Values.

Step 7 Test the application by opening a web browser and entering http://<Application Server IP>:8000/JTAPIConnect.

Both devices (test phones) ring, then auto answer each other. After two seconds, the phones hang up, and the browser displays "Success."


Caveats

This section contains 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.4.3 

Identifier
Headline

CSCsk33427

DeviceListX Provider does not get device pool and CSS for 5.x/6.x.

CSCsk52936

CUAD Version Label Is Not Updated When Hotfixed.

CSCsk67710

Provider does not uninstall when accessed by another process.

CSCsk76463

New devices or locales break response parse of AXL-SOAP.

CSCsk99104

cuae-common.config file missing.

CSCsl19035

Action nodes can erroneously retain loop container metadata.

CSCsl20894

No end canvas tag in script file, causing corruption of script.

CSCsl46101

Remote Console breaks after long uptime.

CSCsl46909

Configs with periods in the name cannot be updated from mceadmin.

CSCsm56058

H.323 MakeCall retries second configured gateway on REJECT.

CSCsm93249

Can't set max/min for config item to empty if set to another value.

CSCsm93288

Rename script does not work.

CSCsm93350

Rename application does not work.

CSCsm93685

Bool config items must have a default value to deploy.

CSCsm93722

Number config items must have a default value to deploy.

CSCsm93736

TraceLevell config items must have a default value to deploy.

CSCsm93746

DateTime config items must have a default value to deploy.

CSCsm95409

Default values for HashTable and DataTable aren't displayed in MCE Admin.

CSCsm95691

Can't build an application with a TriggerLevel with no default value.

CSCsm95729

Default values for DateTime configurations are displayed incorrectly.

CSCsm97075

CUAD Project with references does not compile in different machines.

CSCsm99866

Two Application Servers controlling two Media Engines fail sporadically.

CSCso18196

Project DLL that reference Native Action or Type fails to add to project.

CSCso18240

VMWare Image 2.4.2 Upgrade Throws An Exception.


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 4 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 on page 5.

.

Table 3 Resolved Caveats for the Cisco Unified Application Environment

Identifier
Headline

CSCsi86907

License Management upload should verify MAC, reject if does not match.

CSCsj27456

CTIERR_MAXCALL_LIMIT_REACHED: Max call limit reached.


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.