Table Of Contents
Installation Guide for the Cisco Unified Application Environment, Release 2.4
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 MCS OS Core Addendum
Installing the Cisco Unified Platform Services
Installing the Cisco Unified Application Server
Installing the Cisco Unified Media Engine
Performing Post-Installation Tasks
Installation Error Messages
Obtaining Documentation, Obtaining Support, and Security Guidelines
Cisco Product Security Overview
Installation Guide for the Cisco Unified Application Environment, Release 2.4
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, Obtaining Support, and Security Guidelines
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 Table 2 for the supported servers.
Table 2 Supported Servers
Cisco MCS Server Family
|
Cisco Unified Communications Manager Appliance 1
|
CPU
|
RAM
|
7845
|
MCS-7845-H1
|
2x Intel Xeon Processor (3.4GHz)
|
4GB DDR2
|
MCS-7845-I1
|
MCS-7845-H2
|
2x Intel Xeon 5140 Processor
(Dual core 2.33GHz)
|
MCS-7845-I2
|
7835
|
MCS-7835-I1
|
Intel Xeon (3.4GHz)
|
2GB DDR2
|
MCS-7835-H2
|
2x Intel Xeon 5140 Processor
(Dual core 2.33GHz)
|
MCS-7835-I2
|
Intel Xeon 5140 Processor
(Dual core 2.33GHz)
|
7825
|
MCS-7825-H2
|
Intel P4
(3.4 GHz)
|
MCS-7825-I2
|
Intel P4 Pentium D Processor
(3.4 GHz)
|
7816
|
MCS 7816-I3
|
Intel Celeron D 352
(3.2GHz)
|
Q. May I install other software on the server?
A. You may only install supported software applications on the server.f 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 Installing the Cisco Unified Application Environment 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 servers in Table 3 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 connector that is listed in the table because the other NIC is automatically disabled during the installation.
Table 3 Network Server Connections
Server
|
NIC Connector
|
MCS-7825
|
Use the lower NIC connector.
|
MCS-7835 and MCS-7845
|
Use the NIC 1 connector.
|
Performing Pre-Installation Tasks
Table 4 describes the pre-installation tasks that you must complete before starting installation.
Table 4 Pre-Installation Tasks
Task
|
Pre-Installation Tasks
|
Important Notes
|
1.
|
Make sure that the Cisco-provided Microsoft Windows operating system, version 2003.1.2 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/docs/voice_ip_comm/cucm/win_os/install/os200312.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 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 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 Administrator Guide, Release 2.4 at the following URL:
http://www.cisco.com/en/US/products/ps7058/products_administration_guide_book09186a00807dcce7.html
|
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 MCS OS Core Addendum—See Installing the Cisco Unified MCS OS 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 MCS OS Core Addendum
To install the Cisco Unified MCS OS 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: Cisco Unified MCS OS Core Addendum-2.4.X.exe.
The package is extracted and runs a verification. Then end-user license agreement appears.
Step 3 Read it, and if you agree with the terms, select I Agree.
The Cisco Unified MCS OS Core Addendum 2.4.X Setup dialog box appears.
Step 4 Enter a root-user password to use for the MySQL database.
Note Remember this password. You will be prompted for it again.
Step 5 Click Next.
Step 6 Click OK when the pop-up appears reminding you to remember the password.
Step 7 Click OK when prompted to begin the installation setup.
A console appears with output indicating the progress of the installation setup.
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.
Step 10 After the server reboots, install the platform services (see Installing the Cisco Unified Platform Services).
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.4.x.exe.
The Cisco Unified 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.
The Create Services User dialog box appears.
Step 5 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 6 Click Next.
A CUAE Platform Services 2.4.X InstallSheild Wizard appears.
Step 7 Enter the MySQL password you created in Step 4 of Installing the Cisco Unified MCS OS Core Addendum. Do not change the default Database Server or Login ID.
Step 8 Click Next.
Step 9 A Ready to Install the Program dialog box appears.
Step 10 Click Install.
The dialog window indicates progress as the installation proceeds.
Step 11 Click Finish when the installation is complete.
Step 12 Install the Cisco Unified Application Server (see Installing the Cisco Unified Application 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: CUAS-2.4.x.exe.
Step 3 Click Install when the InstallShield Wizard appears.
The Cisco Unified 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, then reenter it.
This is the password you created in Step 5 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 Install the Cisco Unified Application Server (see Installing the Cisco Unified Media Engine).
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: CUME-2.4.x.exe.
The Cisco Unified Media Engine 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, then reenter it.
This is the password you created in Step 5 of Installing the Cisco Unified 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 Reboot the server.
Performing Post-Installation Tasks
Table 5 describes post-installation tasks.
Installation Error Messages
Table 6 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.40.x-core-addendum-installer.log
•C:\2.40.x-cisco_unified_application_server-install.log
•C:\2.40.x-cisco_unified_media_engine-install.log
•C:\2.40.x.-cuae_platform_services-install.log
Table 6 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 MCS OS 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 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 May 15 18:59:46 2007] [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.
|
Obtaining Documentation, Obtaining Support, and Security Guidelines
For information on obtaining documentation, obtaining support, providing documentation feedback, security guidelines, and also recommended aliases and general Cisco documents, 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.
Cisco Product Security Overview
This product contains cryptographic features and is subject to United States and local country laws governing import, export, transfer and use. Delivery of Cisco cryptographic products does not imply third-party authority to import, export, distribute or use encryption. Importers, exporters, distributors and users are responsible for compliance with U.S. and local country laws. By using this product you agree to comply with applicable laws and regulations. If you are unable to comply with U.S. and local laws, return this product immediately.
A summary of U.S. laws governing Cisco cryptographic products may be found at: http://www.cisco.com/wwl/export/crypto/tool/stqrg.html. If you require further assistance please contact us by sending email to export@cisco.com.
Feedback
