Table Of Contents
Installation Guide for the Cisco Unified Application Environment, Release 2.5.1
Conventions
Installing the Cisco Unified Application Environment
Related Documentation
Frequently Asked Questions
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
Obtaining Documentation and Submitting a Service Request
Installation Guide for the Cisco Unified Application Environment, Release 2.5.1
Use this document to install the Cisco Unified Application Environment. This guide includes the following topics:
•
Conventions
•Installing the Cisco Unified Application Environment
•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.
Installing the Cisco Unified Application Environment
This section includes the following topics:
•Related Documentation
•Frequently Asked Questions
•Performing Pre-Installation Tasks
•Installing the Cisco Unified Application Environment
•Performing Post Installation Tasks
•Installation Error Messages
Related Documentation
Table 1 provides links to related documentation.
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.
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.
|
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 2.5.1 listed in Related Documentation.
|
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.
Step 2 Locate this executable file and run the self-extracting installer: CUAE-coreadd-2.5.1.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-2.5.1.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-2.5.1.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-2.5.1.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 2.5.1 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:\2.5.1.xxxx-core-addendum-installer.log
•C:\2.5.1.xxxx-cisco_unified_application_environment_application server-install.log
•C:\2.5.1.xxxx-cisco_unified_application_environment_media_engine-install.log
•C:\2.5.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.
|
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.
CCDE, CCENT, Cisco Eos, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence, Cisco WebEx, the Cisco logo, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website 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. (0809R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2008 Cisco Systems, Inc. All rights reserved.
