Guest

Cisco Unified Application Environment

Installation Guide for the Cisco Unified Application Environment (8.0)

  • Viewing Options

  • PDF (193.2 KB)
  • Feedback
Installation Guide for the Cisco Unified Application Environment, Release 8.0

Table Of Contents

Installation Guide for the Cisco Unified Application Environment, Release 8.0

Conventions

Related Documentation

Installing the Cisco Unified Application Environment

Hardware and Software Requirements

Hardware Requirements

Software Requirements

Software Requirements for VMware ESXi 4.0

Connecting the Server to the Network

Performing Pre-Installation Tasks

Installing the Cisco Unified Application Environment

Installing the Cisco Unified Core Addendum

Installing the Cisco Unified Platform Services

Installing the Cisco Unified Application Server

Installing the Cisco Unified Media Engine

Performing Post Installation Tasks

Logging In

Configuring IP Addresses on the Cisco MCS NIC (Optional)

Uploading Required Licenses (Required)

Installation Error Messages

Frequently Asked Questions

Obtaining Documentation and Submitting a Service Request


Installation Guide for the Cisco Unified Application Environment, Release 8.0


Use this document to install the Cisco Unified Application Environment. This guide includes the following topics:

Conventions

Installing the Cisco Unified Application Environment

Frequently Asked Questions

Obtaining Documentation and Submitting a Service Request

Conventions

Consider the following documentation conventions as you review this installation document:

Blue Text—To quickly navigate to a section or URL, click text that appears in blue.


Note Reader, take note. Notes contain helpful suggestions or references to material not covered in the publication.



Caution Reader, be careful. You may do something that could result in equipment damage or loss of data.

Related Documentation

Table 1 provides links to related documentation.

Table 1 Related Documentation 

Related Information
URL

Cisco Media Convergence Server (MCS) data sheets

http://www.cisco.com/en/US/products/hw/voiceapp/ps378/index.html

Cisco MCS Server Operating system installation documentation

http://www.cisco.com/en/US/docs/voice_ip_comm/cucm/win_os/install/os200312.html

Cisco Unified Application Environment Hardware Compatibility Matrix 8.0

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 8.0

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

Cisco Unified Application Environment Administration Guide, Release 8.0

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

Cisco Unified Application Environment Release Notes, Release 8.0

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


Installing the Cisco Unified Application Environment

This section includes the following topics:

Hardware and Software Requirements

Connecting the Server to the Network

Performing Pre-Installation Tasks

Installing the Cisco Unified Application Environment

Performing Post Installation Tasks

Installation Error Messages

Hardware and Software Requirements

This section describes the hardware and software requirements for Cisco Unified Application Environment.

Hardware Requirements

The Cisco Unified Application Environment has the following hardware requirements:

A machine with at least 1.5 GB RAM and hosting both the Cisco Unified Application Server and Cisco Unified Media Engine

An Intel processor to run the Cisco Unified Media Engine

Software Requirements

The Cisco Unified Application Environment has the following software requirements:

Microsoft Windows 2003 Standard Edition SP1/ Microsoft Windows XP Professional SP2 / Microsoft Windows Vista

Microsoft .NET Framework 3.0 Redistributable Package

Microsoft .NET Web Services Enhancements 3.0

Apache 1.3.x

J2SE JDK 5.0

MySQL ODBC Connector 3.51

MySQL 5

Dialogic HMP 3.0

NeoSpeech TTS 3.7

For more information, see Cisco Developer Network.

Software Requirements for VMware ESXi 4.0

VMware ESXi 4.0 has the following software requirements:

Microsoft Windows 2003 SP2

Dialogic HMP 3.0 Service Update 267 (For SDK install)


Note Cisco Unified Application Environment 8.0 supports virtualization in a lab/demo environment only and not in production.


Connecting the Server to the Network

Before you begin the installation, make sure that you connect your server to the network.

The Cisco MCS servers contain two network interface cards (NIC), but the Cisco IP telephony application supports only one NIC. When you connect the server to the network, use the NIC 1 connector because the other NIC is automatically disabled during the installation.

Performing Pre-Installation Tasks

Table 2 describes the pre-installation tasks that you must complete before starting installation.

Table 2 Pre-Installation Tasks 

Task
Pre-Installation Tasks
Important Notes

1.

Make sure that the Cisco-provided Microsoft Windows operating system, is installed on the Cisco MCS.1

For information about installing the operating system, refer to Installing the Operating System on the Cisco Media Convergence Server at the following URL: http://www.cisco.com/en/US/products/hw/voiceapp/ps378/prod_installation_guides_list.html

2.

After installing the operating system, make sure you have console access to the Cisco MCS, either directly or using virtual network computing (VNC).

Accessing the Cisco MCS to install the Cisco Unified Application Environment software remotely using anything other than VNC will result in a faulty installation.

Note VNC is not installed on the Cisco MCS by default. You must install it.

3.

Make sure the server is running.

None.

4.

Obtain all the necessary the license files using the Product Authorization Key (PAK) in the Claim Certificate that is shipped with the server.

For information about the licenses, see the License Management chapter of the Cisco Unified Application Environment Administration Guide, Release 8.0 listed in Related Documentation.

1 For VMware, the recommended virtual machine configuration is 2vCPUs, memory of 2GB, and disk size of 20 GB



Note Cisco Unified Application Environment 8.0 supports virtualization in a lab/demo environment only and not in production.


Installing the Cisco Unified Application Environment

Install these Cisco Unified Application Environment components, in the order shown, using the Cisco Unified Application Environment DVD, which was shipped with the server.

1. Cisco Unified Core Addendum—See Installing the Cisco Unified Core Addendum

2. Cisco Unified Platform Services—See Installing the Cisco Unified Platform Services

3. Cisco Unified Application Server—See Installing the Cisco Unified Application Server

4. Cisco Unified Media Engine—See Installing the Cisco Unified Media Engine.

Installing the Cisco Unified Core Addendum

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

Procedure


Step 1 Insert the Cisco Unified Application Environment DVD into the drive.

Windows Explorer appears displaying the contents of the DVD.

Or

Download the Cisco Unified Application Environment installer from Cisco.com.

Step 2 Locate this executable file and run the self-extracting installer: CUAE-coreadd-8.0.exe.

Step 3 The package is extracted, and the end-user license agreement appears.

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

The Cisco Unified Core Addendum Setup dialog box appears.

Step 5 Enter, then re-enter a root-user password to use for the MySQL database.


Note Remember this password. You will be prompted for it again.


Step 6 Click Next.

Step 7 Click OK when the pop-up appears reminding you to remember the password.

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

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

Step 9 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 10 Click Yes to reboot the server.


Installing the Cisco Unified Platform Services

To install the platform services, follow these steps:

Procedure


Step 1 Open Windows Explorer and navigate to the DVD drive.

Step 2 On the Cisco Unified Application Environment DVD, locate this executable file and run it: CUAE-platsvc-8.0.exe.

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 to install other services.


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


Note Do not change the default Database Server or Login ID.


Step 8 Enter the MySQL password you created in Step 5 of Installing the Cisco Unified Core Addendum.

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. A dialog box prompts you to reboot the server.


Note Do not reboot the server if you are also installing the Cisco Unified Application Server and the Cisco Unified Media Engine on the server.



Installing the Cisco Unified Application Server

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

Procedure


Step 1 In Windows Explorer, navigate to the DVD drive.

Step 2 On the Cisco Unified Application Environment DVD, locate this executable file and run it: CUAE-appserver-8.0.exe.

Step 3 Click Install when the InstallShield Wizard appears.

The Cisco Unified Application Environment Application Server installation wizard appears.

Step 4 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 Platform Services.

Step 9 Click Next.

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

Step 11 Click Install.

A dialog will indicate when the installation is complete.

Step 12 Click Finish.

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


Note Do not restart the system if you are also installing the Cisco Unified Media Engine on the server.).



Installing the Cisco Unified Media Engine

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

Procedure


Step 1 In Windows Explorer, navigate to the DVD drive.

Step 2 On the Cisco Unified Application Environment DVD, locate this executable file and run it: CUAE-mediaengine-8.0.exe.

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


Performing Post Installation Tasks

This section includes:

Logging In

Configuring IP Addresses on the Cisco MCS NIC (Optional)

Uploading Required Licenses (Required)

Logging In

To log in to the Cisco Unified Application Environment Administration, follow these steps:

Procedure


Step 1 In the address bar of the web browser, enter the following URL: http://<serverIPaddress>/cuaeadmin.

The End User License Agreement appears.

Step 2 Read it, then click I Agree.

A page to set the Administrator and Cisco Unified Media Engine passwords appears.

Step 3 Enter an administrator password, then re-enter it.

Step 4 Enter a Cisco Unified Media Engine password, then re-enter it.

Step 5 Click Set Passwords.

A confirmation appears indicating that the password setup is complete.

Step 6 To log in, click Log in to the administrator console.

Step 7 The Cisco Unified Application Environment Administration login page appears.

Step 8 Enter the username administrator and the password you set in Step 3.


Configuring IP Addresses on the Cisco MCS NIC (Optional)

To configure two IP addresses on the Cisco MCS server's network interface card (NIC) card, follow these steps:

Procedure


Step 1 In Windows Explorer, select Start > Control Panel > Network Connections > Local Area Connection.

Step 2 Click Properties in the Local Area Connection dialog.

Step 3 Highlight Internet Protocol (TCP/IP), then click Properties.

Step 4 Select Use the following IP address in the Internet Protocol (TCP/IP) Properties dialog box.

Step 5 Enter a static IP address and other information related to your network setup.


Uploading Required Licenses (Required)

Upload required licenses using the Cisco Unified Application Environment Administration.

See the Getting Started chapter in the Cisco Unified Application Environment Administration Guide, Release 8.0 at the following URL: http://www.cisco.com/en/US/products/ps7058/prod_maintenance_guides_list.html

Installation Error Messages

Table 3 describes installation error messages that might be displayed in the dialog boxes and log files during installation. You can obtain and review the log files from these locations:

C:\8.0.xxxx-core-addendum-installer.log

C:\8.0.1.xxxx-cisco_unified_application_environment_application server-install.log

C:\8.0.1.xxxx-cisco_unified_application_environment_media_engine-install.log

C:\8.0.1.xxxx-cisco_unified_application_environment_platform_services-install.log

If the installation was a success, you can either delete or archive the log files.

Table 3 Installation Error Messages 

Error Message
Possible Cause
Corrective Action

The Cisco Unified MCS OS Core Addendum must be installed before you can install the platform services.

You attempted to install the components out of order.

Install the components in the following order:

1. Cisco Unified Core Addendum

2. Cisco Unified Platform Services

3. Cisco Unified Application Server

4. Cisco Unified Media Engine

The CUAE Application Platform Services must be installed before installing the Application Server.

The CUAE Application Server must be installed before installing the Media Engine.

At least one service or driver failed during system startup. Use Event Viewer to examine the event log for details.

After you install the Cisco Unified MCS OS Core Addendum, and reboot the server, these errors might appear in the logs, and can be ignored:

Application Log

The Apache service named C:\Program Files\Apache Group\Apache\Apache.exe reported the following error:>>> [Tue Oct 15 18:59:46 2008] [warn] Loaded DSO c:/PHP/php5apache.dll uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -DEAPI) <<< before the error.log file could be opened.

System Log

The CT Bus Broker service hung on starting.

The Intel Dialogic product System Service depends on the CT Bus Broker service which failed to start because of the following error: After starting, the service hung in a start-pending state.

The DM3Config service depends on the CT Bus Broker service which failed to start because of the following error: After starting, the service hung in a start-pending state.

You installed the Cisco Unified MCS OS Core Addendum.

No corrective action is required; the installation is not affected by any of the errors.

After you install the Cisco Unified Platform Services, these errors might appear in the Application Log:

The Apache service named Apache.exe reported the following error: >>> [warn] Loaded DSO modules/mod_unique_id.so uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -DEAPI) <<< before the error.log file could be opened. More information may be available in the error.log file.

The Apache service named Apache.exe reported the following error: >>> [warn] Loaded DSO c:/PHP/php5apache.dll uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -DEAPI) <<< before the error.log file could be opened. More information may be available in the error.log file.

The Apache service named Apache.exe reported the following error: >>> Processing config directory: c:/program files/cisco systems/unified application environment/system/apache/conf <<< before the error.log file could be opened. More information may be available in the error.log file.

The Apache service named Apache.exe reported the following error: >>> Processing config file: c:/program files/cisco systems/unified application environment/system/apache/conf/mce.conf <<< before the error.log file could be opened. More information may be available in the error.log file.

You installed the Cisco Unified Platform.

No corrective action is required; the installation is not affected by any of the errors.

After you install the Cisco Unified Application Server, these errors might appear in the Application Log:

The Apache service named Apache.exe reported the following error: >>> [warn] Loaded DSO modules/mod_unique_id.so uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -DEAPI) <<< before the error.log file could be opened. More information may be available in the error.log file.

The Apache service named Apache.exe reported the following error: [warn] Loaded DSO c:/PHP/php5apache.dll uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -DEAPI) <<< before the error.log file could be opened. More information may be available in the error.log file.

The Apache service named Apache.exe reported the following error: >>> Processing config directory: c:/program files/cisco systems/unified application environment/system/apache/conf <<< before the error.log file could be opened. More information may be available in the error.log file.

The Apache service named Apache.exe reported the following error: >>> Processing config file: c:/program files/cisco systems/unified application environment/system/apache/conf/mce.conf <<< before the error.log file could be opened. More information may be available in the error.log file.

The Apache service named Apache.exe reported the following error: >>> Processing config file: c:/program files/cisco systems/unified application environment/system/apache/conf/metreos_http.conf <<< before the error.log file could be opened. More information may be available in the error.log file.

The Apache service named Apache.exe reported the following error: >>> [warn] Loaded DSO C:/Program Files/Cisco Systems/Unified Application Environment/System/Apache/modules/mod_metreos_http.so uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -DEAPI) <<< before the error.log file could be opened. More information may be available in the error.log file.

You installed the Cisco Unified Application Server.

No corrective action is required; the installation is not affected by any of the errors.

After you install the Cisco Unified Media Engine, these errors might appear in the Application Log:

The Apache service named C:\Program Files\Apache Group\Apache\Apache.exe reported the following error: >>> [warn] Loaded DSO c:/PHP/php5apache.dll uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -DEAPI) <<< before the error.log file could be opened.More information may be available in the error.log file.

The Apache service named C:\Program Files\Apache Group\Apache\Apache.exe reported the following error: >>> Processing config directory: c:/program files/cisco systems/unified application environment/system/apache/conf <<< before the error.log file could be opened. More information may be available in the error.log file.

The Apache service named C:\Program Files\Apache Group\Apache\Apache.exe reported the following error: >>> Processing config file: c:/program files/cisco systems/unified application environment/system/apache/conf/mce.conf <<< before the error.log file could be opened. More information may be available in the error.log file.

The Apache service named C:\Program Files\Apache Group\Apache\Apache.exe reported the following error: >>> Processing config file: c:/program files/cisco systems/unified application environment/system/apache/conf/media.conf <<< before the error.log file could be opened. More information may be available in the error.log file.

The Apache service named C:\Program Files\Apache Group\Apache\Apache.exe reported the following error: >>> Processing config file: c:/program files/cisco systems/unified application environment/system/apache/conf/metreos_http.conf <<< before the error.log file could be opened. More information may be available in the error.log file.

The Apache service named C:\Program Files\Apache Group\Apache\Apache.exe reported the following error: >>> [warn] Loaded DSO C:/Program Files/Cisco Systems/Unified Application Environment/System/Apache/modules/mod_metreos_http.so uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -DEAPI) <<< before the error.log file could be opened.More information may be available in the error.log file.

You installed the Cisco Unified Media Engine.

No corrective action is required; the installation is not affected by any of the errors.

Could not connect to MySQL '<hostname>'. [MySQL][ODBC 3.51 Driver]Access denied for user '<user>'@'<host>'..

The username and password credentials for the MySQL database are not correct.

Verify that the username and password are valid for the MySQL server, and that the user has permission to create databases, such as a root user. If necessary create such a user with the appropriate permission.

The service password is incorrect and could not be verified. Please try again.

The service user password entered for the Cisco Unified Application Server and/or the Cisco Unified Media Engine installer does not match the service user password defined in the Cisco Unified Platform Services installer.

Enter in the password you defined in the Cisco Unified Platform Services installer.


Frequently Asked Questions

Q. How long does it take to install the Cisco Unified Application Environment?

A. The entire installation process, excluding pre-/post-installation tasks, takes approximately 1 hour.

Q. Which servers does Cisco support for this installation?

A. See Cisco Unified Application Environment Hardware Compatibility Matrix listed in Related Documentation.

Q. Can I install other software on the server?

A. You may only install supported software applications on the server. If you do not know whether the software application is supported, do not install it on the server.


Caution Installing unsupported software applications on the server could cause severe performance problems and call-processing interruptions.

Q. What if I encounter problems during the installation?

A. See Installation Error Messages for a list of error messages, and suggestions for resolving them.

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.