This document assumes that the reader is installing one or both of the two server-side components of the Cisco Unified Application Environment on a single machine that has been prepped by following the CUAE SDK Prerequisites guide. The product names of these two components are the Cisco Unified Application Server and the Cisco Unified Media Engine.
Note: It is just as technically valid to install an application server on one system and a media engine on a different system, as long as the CUAE SDK Prerequisites guide has been followed for both machines.
The entire installation process consists of running two or three installers (depending on what components are installed) as well as a small manual modification to the Apache configuration file. The three installers are described below:
The platform services installer provisions the common framework code used by the application server and the media engine. This installer must be installed for both application server and media engine. This installer must always be executed before either of the other two installers.
The application server installer installs the software specific to the Cisco Unified Application Server product. The application server installer does not need to be run if only installing a media engine on the target system.
The media engine installer installs the software specific to the Cisco Unified Media Engine product. The media engine installer does not need to be run if only installing an application server on the target system.
The Cisco Unified Application Designer is very straightforward to install, and the procedure for installation is not covered explicitly here. The designer can be installed co-located with the server components.
If any two or more components of the Cisco Unified Application Environment are installed on the same system, then one should be sure to synchronize the versions of all such components.
To download any of the Cisco Unified Application Environment installers, one must create an account on http://www.cisco.com and by selecting the ‘Register’ link. This free account is the only relationship with Cisco required to obtain the software.
Before running the Cisco Unified Application Environment installers, obtain console access to the machine, either directly or using virtual network computing (VNC). All installation steps must be executed via one of these two methods. Do not use Remote Desktop to install this software.
To upgrade from 2.4.2, follow these steps:
Download the platform services installer from the Cisco UAE Downloads page to the target system. The platform services installer is named CUAE-platsvc-2.4.3.0008.exe.
Download the application server installer from the Cisco UAE Downloads page to the target system. The application server installer is named CUAS-2.4.3.0008.exe.
Download the media engine installer from the Cisco UAE Downloads page to the target system. The media engine installer is named CUME-2.4.3.0008.exe.
Follow the instructions below to execute the three installers.
To upgrade from 2.4.1, follow these steps:
Download and install WSE 3.0 Redistributable Runtime which can be found at the Microsoft Download Center.
Download the platform services installer from the Cisco UAE Downloads page to the target system. The platform services installer is named CUAE-platsvc-2.4.3.0008.exe.
Download the application server installer from the Cisco UAE Downloads page to the target system. The application server installer is named CUAS-2.4.3.0008.exe.
Download the media engine installer from the Cisco UAE Downloads page to the target system. The media engine installer is named CUME-2.4.3.0008.exe.
Follow the instructions below to execute the three installers.
To upgrade to 2.4.2, follow these steps:
Download and install WSE 3.0 Redistributable Runtime which can be found at the Microsoft Download Center.
Download the platform services installer from the Cisco UAE Downloads page to the target system. The platform services installer is named CUAE-platsvc-2.4.2.0009.exe.
Download the application server installer from the Cisco UAE Downloads page to the target system. The application server installer is named CUAS-2.4.2.0009.exe.
Download the media engine installer from the Cisco UAE Downloads page to the target system. The media engine installer is named CUME-2.4.2.0009.exe.
Follow the instructions below to execute the three installers.
To install platform services, follow these steps:
Download the platform services installer from the Cisco UAE Downloads page to the target system. The platform services installer is named CUAE-platsvc-<version>.exe.
Execute the installer.
The Cisco Unified Platform Services installation Wizard appears. Click Next.
The end-user license agreement appears. Read it, and if you agree with the terms, select I accept the terms in the license agreement. Click Next.
A MySQL Database Server dialog appears. One must specify the credentials for a MySQL adminstrative user which has sufficient privileges to create users and databases. Click Next.
A MySQL Database User dialog appears. One must specify the credentials for a MySQL user which has proper read and write permissions on the database. If this user is not the same as the user specified in step 5, then the installer will attempt to create the new user using the credentials specified in step 5. The credentials specified in this dialog will be stored in the C:\Program Files\Cisco Systems\Unified Application Environment\cuae-common.config file after this installer completes. Click Next.
A Ready to Install the Program dialog box appears. Click Install.
The dialog window indicates progress as the installation proceeds.
Once this dialog has completed, alter the Apache configuration file by adding this line to the bottom of the file: Include "C:/Program Files/Cisco Systems/Unified Application Environment/System/Apache/conf/". The Apache configuration file is by default located at C:\Program Files\Apache Group\Apache\conf\httpd.conf. Apache must be restarted after making this change, which can be done either by using the Administrative Tools > Services control panel or by executing the following at the command prompt: net stop apache and then net start apache.
Click Finish when the installation is complete.
You do not have to restart the machine yet.
To install the Cisco Unified Application Server, follow these steps:
Download the application server installer from the Cisco UAE Downloads page to the target system. The application server installer is named CUAS-<version>.exe.
Execute the installer.
The Cisco Unified Application Server installation Wizard appears. Click Next.
The end-user license agreement appears. Read it, and if you agree with the terms, select I accept the terms in the license agreement. Click Next.
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.
A Ready to Install the Program dialog box appears. Click Install.
A dialog will indicate when the installation is complete. Click Finish.
If you do not intend to install the media engine, or if you have already run its installer (and so this is the last installer), restart the system.
To install the Cisco Unified Media Engine, follow these steps:
Download the media engine installer from the Cisco UAE Downloads page to the target system. The media engine installer is named CUME-<version>.exe.
Execute the installer.
The Cisco Unified Media Engine installation Wizard appears. Click Next.
The end-user license agreement appears. Read it, and if you agree with the terms, select I accept the terms in the license agreement. Click Next.
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.
A Ready to Install the Program dialog box appears. Click Install.
A dialog will indicate when the installation is complete. Click Finish.
If you do not intend to install the media engine, or if you have already run its installer (and so this is the last installer), restart the system.
Once the system has restarted after executing the last installer, the Cisco Unified Application Environment is considered installed. At this point, the integration between the Cisco Unified Application Environment and a test Cisco Unified Communications Manager can now be undertaken, in order to verify that the installation is functional. To perform this basic integration test, navigate to the example configuration and test applications section in the Cisco Unified Application Environment Administration Guide and go through these steps to verify basic functionality of the installation:
Open the Cisco Unified Application Environment Administration Guide.
Navigate to Getting Started.
Navigate to Configuring an Example Environment.
Follow the steps in the Configuring an Example Environment section until you complete Task 4: Install, Configure, and Test Sample Applications.
If the AnswerCall and MakeCall applications work, then you have a working Cisco Unified Application Environment installation!