Guest

Cisco Unified Application Environment

Release Notes for Cisco Unified Application Environment, Release 8.5

  • Viewing Options

  • PDF (200.0 KB)
  • Feedback
Release Notes for Cisco Unified Application Environment, Release 8.5

Table Of Contents

Release Notes for Cisco Unified Application Environment, Release 8.5

Contents

Related Documentation

What is New in This Release

New and Changed Information for Release 8.5

Installation and Upgrade Notes

Installing Cisco Unified Application Environment, Release 8.5

Installing the Cisco Unified Application Environment Core Addendum

Installing the Cisco Unified Application Environment Platform Services

Installing the Cisco Unified Application Server

Installing the Cisco Unified Media Engine

Upgrading Cisco Unified Application Environment Release 2.4 and Later to Release 8.5

Installing Cisco Unified Application Environment Developer Tools

Backing Up the Cisco Unified Application Environment Database

Restoring the Cisco Unified Application Environment Database

Caveats

Using Bug Toolkit

Open Caveats

Resolved Caveats

Obtaining Documentation and Submitting a Service Request


Release Notes for Cisco Unified Application Environment, Release 8.5


Revised: September, 2010, OL-21907-01

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

Contents

Related Documentation

What is New in This Release

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 8.5

http://www.cisco.com/en/US/docs/voice_ip_comm/cuae/8_0/english/administration/guide/cuae_8_0_admin_guide.html

Cisco Unified Application Environment Installation Guide, Release 8.5

http://www.cisco.com/en/US/docs/voice_ip_comm/cuae/8_0/english/install/guide/uaein.html

Cisco Unified Application Environment Upgrade Guide, Release 8.5

http://www.cisco.com/en/US/docs/voice_ip_comm/cuae/8_0/english/upgrade/guide/uaeupg.html

Cisco Unified Application Environment Hardware Compatibility Matrix, Release 8.5

http://www.cisco.com/en/US/docs/voice_ip_comm/cuae/8_0/english/compat/guide/hwcompat.html

Cisco Unified Application Environment Software Compatibility Matrix, Release 8.5

http://www.cisco.com/en/US/docs/voice_ip_comm/cuae/8_0/english/compat/guide/swcompat.html

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


What is New in This Release

This chapter gives information of the new and changed information of every release of the Cisco Unified Application Environment.

New and Changed Information for Release 8.5

This section lists the updates in this release of the Cisco Unified Application Environment.

Enhanced Limit for CTI Devices —Allows monitoring of up to 10,000 CTI devices.

Increase in Media Port Density— The media port density is enhanced to 480 for RTP, Conference, Voice and to 240 for Speech Integration.

New Media Features — The SeekAndPlay API helps you play, stop or resume playing a media file from a particular position.

Cisco Unified Application Environment supports Microsoft Windows 2008 server.

Installation and Upgrade Notes

The following sections describe the upgrade procedures:

Installing Cisco Unified Application Environment, Release 8.5

Upgrading Cisco Unified Application Environment Release 2.4 and Later to Release 8.5

Installing Cisco Unified Application Environment Developer Tools

Installing Cisco Unified Application Environment, Release 8.5

1. Perform a Cisco Unified Application Environment database back up. (See Backing Up the Cisco Unified Application Environment Database.)

2. Go to this URL: http://developer.cisco.com/web/cuae/downloads.

3. Download the following executable files, and save them on your system.

a. CUAE-coreadd-8.5.x.exe (Cisco Unified Application Environment Core Addendum)

b. CUAE-platsvc-8.5.x.exe (Cisco Unified Application Environment Platform Services)

c. CUAE-appserver-8.5.x.exe (Cisco Unified Application Server)

d. CUAE-mediaengine-8.5.x.exe (Cisco Unified Media Engine)

Installing the Cisco Unified Application Environment Core Addendum

To install the Cisco Unified Application Environment Core Addendum, follow these steps:

Procedure


Step 1 Locate and double click this executable file where you downloaded it on your local system: CUAE-coreadd-8.5.x.exe.

Step 2 Click Run.

The end-user license agreement appears.

Step 3 Read it, and if you agree with the terms, select I Agree.

The Cisco Unified AE OS Addendum Setup dialog box appears with a message indicating that older versions of third-party software has been detected.

Step 4 Click Yes to remove the older versions of the third-party software.

A console appears that indicates progress. The system then reboots, and a Clean-up Utility console appears.


Note You may get a security warning indicating that the publisher could not be verified. Proceed to Step 5.


Step 5 Click Yes to run the Cisco Unified Application Environment Core Addendum software.

The end-user license agreement appears.

Step 6 Read it, and if you agree with the terms, select I Agree.

The Cisco Unified AE OS Addendum Setup dialog box appears.

Step 7 Click OK when prompted to begin the installation setup.

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

Step 8 Click Close when the output stops and the Close button is no longer grayed out.

A window appears indicating that the installation is complete, and that the server must be rebooted.

Step 9 Click Yes to reboot the server.


Installing the Cisco Unified Application Environment Platform Services

To install the platform services, follow these steps:

Procedure


Step 1 Locate and double click this executable file where you downloaded it on your local system: CUAE-platsvc-8.5.x.exe.

Step 2 Click Run.

The Cisco Unified Application Environment Platform Services installation wizard appears.

Step 3 Click Next.

The end-user license agreement appears.

Step 4 Read it, and if you agree with the terms, select I accept the terms in the license agreement.

A notice about cryptographic features appears.

Step 5 Read it, and if you agree to comply with the applicable laws and regulations described in the notice, then click Next.

The Create Services User dialog box appears.

Step 6 Enter a password for the Cisco Unified Application Environment service user, then reenter it.


Note Remember this password. You will be prompted for it again when you run other Cisco Unified Application Environment installers.


Step 7 Click Next. A MySQL Database Server dialog box appears.

Step 8 Enter the MySQL password; the same one used for the earlier release.

Step 9 Click Next.

Step 10 A Ready to Install the Program dialog box appears.

Step 11 Click Install.

The dialog window indicates progress as the installation proceeds.

Step 12 Click Finish when the installation is complete.


Installing the Cisco Unified Application Server

To install the Cisco Unified Application Server, follow these steps:

Procedure


Step 1 Locate and double click this executable file where you downloaded it on your local system: CUAE-appserver-8.5.x.exe.

Step 2 Click Run.

The Cisco Unified Application Environment Application Server installation wizard appears.

Step 3 Click Next.

The end-user license agreement appears.

Step 4 Read it, and if you agree with the terms, select I accept the terms in the license agreement.

Step 5 Click Next.

A notice about cryptographic features appears.

Step 6 Read it, and if you agree to comply with the applicable laws and regulations described in the notice, then click Next.

The Service User Password dialog box appears.

Step 7 Enter the password for the Cisco Unified Application Environment service user.

This is the password you created in Step 6 of Installing the Cisco Unified Application Environment Platform Services.

Step 8 Click Next.

Step 9 A Ready to Install the Program dialog box appears.

Step 10 Click Install.

A dialog will indicate when the installation is complete.

Step 11 Click Finish.

Step 12 A dialog appears asking if you want to restart the system.

Step 13 If you have Cisco Unified Media Engine Release 8.0(1) already installed, click No and proceed with the Cisco Unified Media Engine installation. Click Yes if you do not have Cisco Unified Media Engine Release 8.0(1) already installed.


Installing the Cisco Unified Media Engine

To install the Cisco Unified Media Engine, follow these steps:

Procedure


Step 1 Locate and double click this executable file where you downloaded it on your local system: CUAE-mediaengine-8.5.x.exe.

Step 2 Click Run.

Step 3 If you do not have the Nuance OpenSpeech Recognizer 3.0 installed on the server, a prompt appears asking if you want to install it. Click Install.

Step 4 If you already have the Nuance OpenSpeech Recognizer 3.0 installed, the Cisco Unified Application Environment Media Engine installation wizard appears. Click Next.

The end-user license agreement appears.

Step 5 Read it, and if you agree with the terms, select I accept the terms in the license agreement.

Step 6 Click Next.

A notice about cryptographic features appears.

Step 7 Read it, and if you agree to comply with the applicable laws and regulations described in the notice, then click Next.

The Service User Password dialog box appears.

Step 8 Enter the password for the Cisco Unified Application Environment service user.

This is the password you created in Step 6 of Installing the Cisco Unified Application Environment Platform Services.

Step 9 Click Next.

Step 10 A Ready to Install the Program dialog box appears.

Step 11 Click Install.

A dialog box indicates when the installation is complete.

Step 12 Click Finish.

A dialog appears indicating that you must restart the system for the changes to take effect.

Step 13 Click Yes.


Upgrading Cisco Unified Application Environment Release 2.4 and Later to Release 8.5

Cisco Unified Application Environment, Release 8.5 supports direct upgrade from Cisco Unified Application Environment, Release 2.4 and later. For more information, see the Upgrade Guide for the Cisco Unified Application Environment, Release 8.5, listed in the Related Documentation.

To upgrade from Release 2.4 and later to Release 8.5, install the following components:

1. Cisco Unified Application Environment Core Addendum—Installing the Cisco Unified Application Environment Core Addendum

2. Cisco Unified Application Environment Platform Services—For more information, see Installing the Cisco Unified Application Environment Platform Services.

3. Cisco Unified Application Environment Application Server—For more information, see Installing the Cisco Unified Application Server

4. Cisco Unified Application Environment Media Engine—For more information, see Installing the Cisco Unified Media Engine


Note 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-8.5.x.exe executable file from the Cisco Unified Application Environment wiki:
http://developer.cisco.com/web/cuae/downloads.

Install the downloaded Cisco Unified Application Environment Developer Tools on a machine running Windows XP.


Note Before you install Cisco Unified Application Environment Developer Tools, uninstall the existing version from Control Panel.


In Cisco Unified Application Environment, Release 8.5 and earlier, the developer tools contains two main components, both of which allow you to develop Unified Communications applications:

Cisco Unified Application Designer--The legacy.Net / C# based IDE.

Etch Tools--The cross-platform, language independent ETCH framework and the cuae command-line utility.

To install the Cisco Unified Application Environment Developer Tools, follow these steps:

Procedure


Step 1 Download the developer tools installer: CUAE-devtools-<version>.exe

Step 2 Run the installer.

Installshield checks for prerequisites.

Step 3 Cisco Unified Application Environment Developer Tools installer might display any pending requirements to be installed. Click Install.

Step 4 After the prerequisites are installed, the Welcome page appears. Click Next.

The end-user license agreement appears.

Step 5 Read it, and if you agree with the terms, select I accept the terms in the license agreement. Click Next.

Step 6 A notice about cryptographic features appears. Read it, and if you agree to comply with the applicable laws and regulations described in the notice, then click Next.

Step 7 Accept the defaults until the completed window appears. Click Finish.

If needed, restart the computer for environment settings to take effect once the installation is complete.


Backing Up the Cisco Unified Application Environment Database

Use the system backup feature to take a snapshot of the current configuration settings in the Cisco Unified Application Environment Administration, to save applications, and to save application configurations.

Cisco recommends backing up systems regularly to prevent data loss in the unlikely event of system failure. See Restoring the System for instructions on restoring a previously backed up system.

A system backup generates a .cuae file located in the C:\Program Files\Cisco Systems\Unified Application Environment\Backups folder. Make a copy of the backup folder and move it to a safe location outside the Cisco Unified Application Environment machine.

Follow these steps to perform system backups:

Procedure


Step 1 Use the server console or VNC to open a command window.

Step 2 Change the current directory to C:\Program Files\Cisco Systems\Unified Application Environment\Framework\1.0, and locate the executable file: cuae-backup.exe


Note Arguments with spaces in their names must have double quotes around them.


For example:

cd "C:\Program Files\Cisco Systems\Unified Application Environment\Framework\1.0"

Step 3 Step 3 Enter the following command:

cuae-legacy-backup.exe [ +database_name ...]

where +database_name is the name of a database you want to backup in addition to the system database.


Note The system database is automatically backed up during the backup process. If you do not need to back up additional application-specific databases, do not specify database names.


In general, if you have any applications that use their own, customized, MySQL database on the server, you need to specify their database names. Check with the developers who created the applications that are installed on the system to find out if there are custom databases associated with the applications, and whether they should be backed up. For example, to back up only the system database, enter:

cuae-backup.exe

After running the cuae-backup.exe tool, the backup file is saved in C:\Program Files\Cisco Systems\Unified Application Environment\Backups. Cisco strongly recommends you remove the backup file from the MCS server and store it in a safe location.


Restoring the Cisco Unified Application Environment Database

Use the system restore feature to install and activate a previously-generated system backup file. (See Caveats.)


Note If the upgrade is successful, there is no need to restore backed up data.



Caution The configuration in the backup folder overwrites the current configuration. Once started, the process cannot be stopped or undone. Always back up the system before you restore a system backup file.

To restore a backup, follow these steps:

Procedure


Step 1 Place the Backup folder anywhere on the MCS server.

Step 2 Log in to the Cisco Unified Application Environment Administration.

Step 3 From the Cisco Unified Application Environment Management, choose Serviceability >Services, select Watchdog Server, then click Stop to stop all the services.

Step 4 Use the server console or VNC to open a command window.

Step 5 Change the current directory to C:\Program Files\Cisco Systems\Unified Application Environment\Framework\1.0, and locate the executable file: cuae-restore.exe


Note Arguments with spaces in their names must have double quotes around them.


For example:

cd "C:\Program Files\Cisco Systems\Unified Application Environment\Framework\1.0"

Step 6 Enter the following command to do a restore of the same software version as the backup was taken:

cuae-restore.exe [path_to_backup_file]

where path_to_backup_file is the location of the file generated by the cuae-legacy-backup tool, which is located in the Backup folder on the server.

For example, if you want to restore a file called backup1.cuae located in the C:\Program Files\Cisco Systems\Unified Application Environment\Backups folder, enter:

cuae-restore.exe "C:\Program Fil"s\Cisco Systems\Unified Application Environment\Backups\backup1.cuae"

Step 7 Enter the following command to test the restore:

cuae-dbtool -t upgrade

If the test is successful, the following message appears "The trial run was successful." and you can proceed to the next step.

If the test fails, the following error message appears "The trial run failed." Contact the Cisco Technical Assistance Center (TAC). For a complete list of Cisco TAC contacts, go to this URL: http://www.cisco.com/techsupport/contacts.

Step 8 Enter the following command to do a restore on a later build from when the backup was taken:

cuae-dbtool upgrade

If the migration is successful, the following message appears "The migration was successful." and you can proceed to the next step.

If the migration fails, the following error message appears "The migration failed." Contact the Cisco Technical Assistance Center (TAC). or a complete list of Cisco TAC contacts, go to this URL: http://www.cisco.com/techsupport/contacts.

Step 9 If the upgraded server is a media engine, then you must reset the password; the cuae-dbtool.exe does not restore the password for the media engine software. From the Main Control Panel on the Cisco Unified Application Environment management console, click Media Engine Configuration, and enter a password for the media engine.


Note You must also enter the same password under Main Control Panel > Media Engine Configuration on any application servers that use this media engine. This enables the application servers to communicate with the media engine.


Step 10 Return to the Main Control Panel, and click Service Control, then click Restart for the Watchdog Server. This restarts all of the services in order of dependency.


Caveats

This section includes these topics:

Using Bug Toolkit

Open Caveats

Resolved Caveats

Obtaining Documentation and Submitting a Service Request

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 8.5

Identifier
Headline

CSCsr40650

The bridge action fails with JTAPI CTIERR_HOLDFAILED error.

CSCtg06511

Name parameter must be mandatory in few AXL802 APIs.

CSCti78231

If the SeekAndPlay API is configured with a negative value for audioFilePosition, then the audio file plays from the beginning instead of displaying an error message.

CSCtk62176

Mute action parameter of SetConfereeAttribute API is not working.


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

CSCte54214

AddPhone801 action fails because the required parameters are not parsed into the AXL request.

CSCte69038

Failure paths of GeoLocation APIs (AddGeoLocation713, UpdateGeoLocation713, GetGeoLocation713, and RemoveGeoLocation713) are not defined.

CSCte89824

AddVoiceMailProfile713 and UpdateVoiceMailProfile713 APIs return SOAP-Fault message. This response is not propagated to applications when only Unified CM login details are provided.

CSCtf02112

RemoveTransofmationPattern713 API fails to return the failure or fault message to the application.

CSCtf94264

The AXL802 APIs do not return SOAP-Fault messages.

CSCtf94421

UpdateGeoLocation802 overwrites the existing configuration in Cisco Unified Communications Manager.

CSCtf95410

AddGeoLocationFilter802 and UpdateGeoLocationFilter802 APIs fail if all the parameters are not specified.

CSCtg06383

AddPhone802 and UpdatePhone802 APIs display the error message "Index outside bound".

CSCti34935

The error message displayed while installing Cisco Unified Platform Services is incorrect.

CSCte97062

In the UpdateUser713 API, the UserId attribute is missing.

CSCtf00396

UpdateLine713 API fails to update the line in Cisco Unified Communications Manager.

CSCtf98903

AddRoutePartition802, UpdateRoutePartition802, and ListRoutePartition802 APIs must be assigned all the properties to configure the Cisco Unified Communications Manager.

CSCtf99054

AddTranspattern802 and UpdateTranspattern802 APIs require values for all parameters.

CSCtg06039

PresenceGroupName parameter value is not passed to Cisco Unified Communications Manager in AXL80(2).

CSCtg07969

AXL SecurityProfileName parameters in Add VoiceMailPort802 and Update VoiceMailPort 802 is shown as empty when passed to the Cisco Unified Communications Manager.


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.