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

+

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

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.

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.

Line 337:

Line 337:

'''cuae-backup.exe'''

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

+

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.

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 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 | http://www.cisco.com/techsupport/contacts]].

+

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 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:

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

Line 391:

Line 391:

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

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 | http://www.cisco.com/techsupport/contacts]].

+

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

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

Login attempts to the AUTH web service of VWMS times out and no SOAP response is sent to the client.

|-

|-

|

|

Line 575:

Line 569:

{| border = "1"

{| border = "1"

|-

|-

-

!width="100"|'''Identifier'''

+

|'''Identifier'''

|'''Headline'''

|'''Headline'''

Line 677:

Line 671:

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:

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:

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.

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.

-

Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be found at [[ # www.cisco.com/go/trademarks | www.cisco.com/go/trademarks]]. Third party trademarks mentioned 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. (1005R)

+

Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be found at [http://www.cisco.com/go/trademarks http://www.cisco.com/go/trademarks]. Third party trademarks mentioned 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. (1005R)

Hotfixes from Cisco Unified Application Environment 2.5(1) SR2—All defects that are mentioned under Closed Caveats and were part of 2.5(1) SR2 hot fixes are now part of Cisco Unified Application Environment 2.5(1) SR3.

Installation and Upgrade Notes

The following sections describe the upgrade procedures:

Installing Cisco Unified Application Environment 2.5(1) SR3

Before you install the Cisco Unified Application Environment 2.5(1)SR3, you must complete these prerequisite steps:

Installing the Cisco Unified Application Environment Core Addendum

Step 1 Locate and double-click this executable file where you downloaded it on your local system: CUAE-coreadd-2.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 Application Environment OS Addendum Setup dialog box appears with a message indicating that older versions of third-party software are detected.

Step 4 Click Yes to remove the older versions of the third-party software.
A console appears and 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. If so, proceed to Step 5.

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 Do one of the following:

a If you have Cisco Unified Application Environment Media Engine Release 2.5(1) installed, click No and proceed with the Cisco Unified Application Environment Media Engine installation.

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 the end-user license agreement , 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. A Ready to Install the Program dialog box appears.

Step 9 Click Install. A dialog box indicates when the installation is complete.

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

Step 11 Click Yes.

Upgrading From Release 2.3 or 2.4 to Release 2.5(1) SR3

To upgrade from Cisco unified Application Environment Release 2.3 or 2.4 to Release 2.5(1) SR3, you must first upgrade 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 section.

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.

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.

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.

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

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:

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

Open Caveats

The table below 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 the table reflects the list 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.

Login attempts to the AUTH web service of VWMS times out and no SOAP response is sent to the client.

CSCsx17101

The Cancel button on the Welcome screen in the Messaging plugin installer does not cancel the installation.

CSCsx18881

A router warning message is written to the application server log file even though the change is added to the database and can be retrieved using the Cisco Unified Application Environment admin interface.

CSCsx19837

The Messaging Plugin Developer Tools uninstaller does not display an error message when it cannot find the component that is selected for removal.

Resolved Caveats

The table below 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 the table 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.

Cisco Unified Application Environment script has a 2-second delay in playing prompts.

CSCtb49552

AcceptCallEarlyMedia action fails on simultaneous calls.

CSCtc84498

For a P2P call, AcceptCallEarlyMedia API fails with timeout.

CSCtf40965

Cisco Unified Presence notification does not come from the Cisco Unified Presence server.

CSCtd88311

QueryUsers Extension Mobility action does not take the failure path for an invalid user ID.

CSCtb56788

CiscoDeviceListX database does not populate the extension fields for all the phones that are added to the database.

CSCtc51556

DeviceListX plugin response invokes extensions that do not fetch all the device details.

CSCsz82718

The XML output from Cisco Unified Application Environment is corrupt when sent to Cisco Unified IP Phone 7940.

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:

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.

Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be found at http://www.cisco.com/go/trademarks. Third party trademarks mentioned 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. (1005R)