Cisco Unified Mobility Advantage Installation and Upgrade Guide

Cisco Unified Mobility Advantage
Installation and Upgrade Guide

Release 3.1.2
Revised Date: April 10, 2009
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
Text Part Number: OL-15528-02

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL
STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT
WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public
domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
CCDE, CCENT, Cisco Eos, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence, 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, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, 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. (0807R)
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.
Cisco Unified Mobility Advantage Installation and Upgrade Guide

© 2008 Cisco Systems, Inc. All rights reserved.
CONTENTS
Preface vii
Audience vii
Organization vii
Related Documentation viii
Obtaining Documentation, Obtaining Support, and Security Guidelines ix

Cisco Product Security Overview ix
Document Conventions ix
CHAPTER 1 Introduction 1-1
Cisco Unified Mobility Advantage Components 1-1

Cisco Unified Mobility Advantage Enterprise Server 1-1
Cisco Unified Mobility Advantage Proxy Server 1-1
Architecture 1-2
Enterprise Services 1-3
Mobile Data Network Service Providers 1-3
Cisco Unified Mobile Communicator 1-3
Overview of Installation Tasks 1-4
CHAPTER 2 Preinstallation Tasks 2-1
Install Cisco Media Convergence Servers 2-1

Verify Browser Requirements 2-2
Verify Enterprise Services 2-2

Configure the BlackBerry Enterprise Server 2-3
Configure IT Policies 2-3
Configure Software Configuration Policies 2-4
Obtain Enterprise Services Information 2-4
Microsoft Active Directory 2-4
Microsoft Exchange 2-5
Cisco Unity 2-6
Cisco Unified Communications Manager 2-6
Call Log Integration for Cisco Unified Mobility Advantage 2-7
Username and Password Considerations 2-7
Determine Communication and Firewall Ports 2-8

OL-15528-02 iii
Contents
Communication Ports 2-8

Managed Server Ports 2-8
Admin Server Ports 2-9
Node Manager Server Ports 2-10
Proxy Server Ports 2-11
Firewall Ports 2-12
External Firewall Ports 2-12
Internal Firewall Ports 2-12
CHAPTER 3 Installation 3-1
Install Cisco Unified Mobility Advantage Operating System 3-1
Install the Cisco Unified Mobility Advantage Enterprise Server 3-3
Verify Server Status 3-5

Admin Server 3-5
Node Manager Server 3-6
CHAPTER 4 Configuration 4-1
Log in to the Cisco Unified Mobility Advantage Admin Portal 4-1
Run the Configuration Wizard 4-2

SSL Certificate Management 4-2
Gather Required Information 4-2
Generate Keystore File and Self-Signed Certificate for Enterprise Server 4-3
Enterprise Configuration 4-4
Corporate Directory Server 4-4
Personal Contact Server 4-8
Call Control Server 4-10
System Configuration 4-13
Server Setup 4-14
Handset Platform Management 4-16
Summary 4-16
Start the Managed Server 4-17
Complete the SSL Certificate Process 4-17

Generate the Keystore File for the Proxy Server 4-17
Generate the CSR for the Proxy Server 4-17
Request a Signed Certificate From VeriSign 4-18
Download an Intermediate Certificate from VeriSign 4-18
Create Final SSL Certificate Files 4-19
Upload Final Certificate on the Enterprise Server 4-20
Upload Final Certificate on the Proxy Server 4-20

iv OL-15528-02
Contents
CHAPTER 5 Proxy Server Installation 5-1
Install the Cisco Unified Mobility Advantage Proxy Server 5-1
Verify the Proxy Server Status 5-3
Post-Installation Tasks 5-3
CHAPTER 6 Upgrade Cisco Unified Mobility Advantage 6-1
Upgrade Release 3.0.9 to Release 3.1.2 6-1

Complete Preinstallation Steps 6-1
Install the Server 6-3
Apply Changes 6-3
Complete Upgrade Tasks 6-4
Upgrade Release 3.0.4 to Release 3.0.9 6-5
Complete Preinstallation Steps 6-5
Install the Server 6-6
Apply Changes 6-6
Complete Upgrade Tasks 6-7
APPENDIX A Maintenance A-1
Manage the Servers A-1

Start Sequence for Cisco Unified Mobility Advantage Servers A-1
Stop Sequence for Cisco Unified Mobility Advantage Server A-1
Start or Stop the Admin Server A-2
Start or Stop the Node Manager Server A-2
Start or Stop the Managed Server A-3
Start or Stop the Proxy Server A-3
Uninstall Cisco Unified Mobility Advantage A-4
APPENDIX B SSL Certificate Process B-1
Understanding the Terminology B-1
Understanding the Process B-2

Part 1 Overview B-2
Part 2 Overview B-3
APPENDIX C Troubleshooting and FAQs C-1
Obtaining Log Files C-1
Solving Installation Problems C-2

All Problems C-2
Cisco Unified Mobility Advantage Enterprise Server Does Not Start C-2

OL-15528-02 v
Contents
Solving Problems with Cisco Unified Mobile Communicator C-3
FAQs C-3
Cisco Unified Mobility Advantage FAQs C-3
Cisco Unified Mobile Communicator FAQs C-5
INDEX

vi OL-15528-02
Preface
Cisco Unified Mobility Advantage Installation and Upgrade Guide provides the information you need
to understand, install, configure, and upgrade Cisco Unified Mobility Advantage.
Audience
Network engineers or system administrators should review this guide to learn the steps required to
properly set up Cisco Unified Mobility Advantage on the network.
Caution The tasks described are administration-level tasks. The person responsible for the installation should be
familiar with Cisco Unified Communications Manager, Microsoft Active Directory, and Microsoft
Exchange.
Organization
This manual is organized as follows:
Chapter 1, “Introduction” Provides an overview of Cisco Unified Mobility Advantage and how to
install it on the network
Chapter 2, “Preinstallation Tasks” Describes the tasks required prior to installation
Chapter 3, “Installation” Describes how to install the Cisco Unified Mobility Advantage Operating
System, and run the Installation Wizard to begin the Cisco Unified
Mobility Advantage installation
Chapter 4, “Configuration” Describes how to run the Configuration Wizard and configure Cisco
Unified Mobility Advantage
Chapter 5, “Proxy Server Installation” Describes how to install the Cisco Unified Mobility Advantage Proxy
Server
Chapter 6, “Upgrade Cisco Unified Mobility Describes how to upgrade the Cisco Unified Mobility Advantage
Advantage” Enterprise Server and Cisco Unified Mobility Advantage Proxy Server
from a previous release to a current release
Appendix A, “Maintenance” Describes how to start and stop Cisco Unified Mobility Advantage
servers and how to uninstall Cisco Unified Mobility Advantage

OL-15528-02 vii
Preface
Appendix B, “SSL Certificate Process” Provides an overview of the process required to obtain an SSL certificate
for Cisco Unified Mobility Advantage.
Appendix C, “Troubleshooting and FAQs” Describes how to troubleshoot installation problems and provides
answers to frequently asked questions
Related Documentation
For more information about Cisco Unified Mobility Advantage, refer to these publications:

These publications are available at the following URL:
http://www.cisco.com/en/US/products/ps7270/tsd_products_support_series_home.html
• Cisco Unified Mobility Advantage Installation and Upgrade Guide
• Cisco Unified Mobility Advantage Administration Guide
• Release Notes for Cisco Unified Mobility Advantage
• Release Notes for Cisco Unified Mobile Communicator for BlackBerry Devices
• Release Notes for Cisco Unified Mobile Communicator for Symbian OS Phones
Cisco Unified Mobile Communicator

• Cisco Unified Mobile Communicator Quick Start Guide for BlackBerry Devices
• Cisco Unified Mobile Communicator User Guide for BlackBerry Devices
• Cisco Unified Mobile Communicator Quick Start Guide for Symbian OS Phones
• Cisco Unified Mobile Communicator User Guide for Symbian OS Phones
• Cisco Unified Mobile Communicator Quick Reference for Symbian OS Phones
• Cisco Unified Mobile Communicator User Portal Guide
Cisco Unified Communications Manager Administration

http://www.cisco.com/en/US/products/sw/voicesw/ps556/tsd_products_support_series_home.html
• Cisco Unified Communications Manager Administration Guide
• Cisco Unified Communications Manager System Guide
• Cisco Unified Communications Manager Security Guide

viii OL-15528-02
Preface
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.
Document Conventions
This document uses the following conventions:
Convention Description
boldface font Commands and keywords are in boldface.
italic font Arguments for which you supply values are in italics.
[ ] Elements in square brackets are optional.
{x|y|z} Alternative keywords are grouped in braces and separated by vertical bars.
[x|y|z] Optional alternative keywords are grouped in brackets and separated by vertical bars.
string A nonquoted set of characters. Do not use quotation marks around the string or the string will
include the quotation marks.
screen font Terminal sessions and information the system displays are in screen font.
boldface screen font Information you must enter is in boldface screen font.
italic screen font Arguments for which you supply values are in italic screen font.
^ The symbol ^ represents the key labeled Control—for example, the key combination ^D in a
screen display means hold down the Control key while you press the D key.
< > Nonprinting characters, such as passwords are in angle brackets.

OL-15528-02 ix
Preface
Note Means reader take note. Notes contain helpful suggestions or references to material not covered in the
publication.
Caution Means reader be careful. In this situation, you might do something that could result in equipment
damage or loss of data.
Warnings use the following convention:
Warning IMPORTANT SAFETY INSTRUCTIONS
This warning symbol means danger. You are in a situation that could cause bodily injury. Before you
work on any equipment, be aware of the hazards involved with electrical circuitry and be familiar
with standard practices for preventing accidents. Use the statement number provided at the end of
each warning to locate its translation in the translated safety warnings that accompanied this
device. Statement 1071
SAVE THESE INSTRUCTIONS

x OL-15528-02
CH A P T E R 1
Introduction
Cisco Unified Mobility Advantage is part of the Cisco Unified Communications family of products.
Cisco Unified Mobility Advantage is the server in the enterprise that Cisco Unified Mobile
Communicator clients connect to, via a proxy server. Cisco Unified Mobility Advantage is deployed
behind the enterprise firewall and serves as the integration point for all enterprise services.
Cisco Unified Mobility Advantage Components

Cisco Unified Mobility Advantage consists of two servers:
• Cisco Unified Mobility Advantage Enterprise Server
• Cisco Unified Mobility Advantage Proxy Server
Note Both servers are required. The servers must be installed on a one-to-one basis (for each Cisco Unified
Mobility Advantage Enterprise Server installed, one Cisco Unified Mobility Advantage Proxy Server
must be installed).
Cisco Unified Mobility Advantage Enterprise Server

The Cisco Unified Mobility Advantage Enterprise Server consists of these components:
• Managed Server—this server manages the communication with Cisco Unified Mobile
Communicator and runs the Cisco Unified Mobile Communicator User Portal.
• Admin Server—this server runs the Cisco Unified Mobility Advantage Admin Portal for
management of Cisco Unified Mobility Advantage.
• Node Manager Server—this server is used for utility operations such as starting and stopping the
Managed Server.
• Cisco Unified Mobility Advantage Database
Cisco Unified Mobility Advantage Proxy Server

The Cisco Unified Mobility Advantage Proxy Server acts as a proxy and manages the secure
communications between Cisco Unified Mobile Communicator and the Cisco Unified Mobility
Advantage Enterprise Server. The Proxy Server is located on a separate machine within the DMZ.

OL-15528-02 1-1
Chapter 1 Introduction
Architecture
Architecture
Install Cisco Unified Mobility Advantage Enterprise Server on one of these platforms:
• Cisco MCS 7845-H2 Media Convergence Server
• Cisco MCS 7845-I2 Media Convergence Server
Install Cisco Unified Mobility Advantage Proxy Server on one of these platforms:
Warning The Cisco Media Convergence Servers must be installed in your network before you install Cisco
Unified Mobility Advantage. See Install Cisco Media Convergence Servers, page 2-1 for more
information.
Figure 1-1 shows how Cisco Unified Mobility Advantage works with components in the network.
Figure 1-1 Cisco Unified Mobility Advantage Architecture
DMZ Cisco Unified Enterprise Services

Mobility
Advantage
firewall
firewall
Outer
Inner
Enterprise
Server
MobileData
Network
MA
Directory
Cisco Unified
GPRS data Mobility Managed
channel Advantage Server
Proxy
Server
MA Voice
MA
mail
Admin
Server
Cisco Unifited Mobile Email
Communicator
MA Collaboration
PSTN Voice Node

Channel Manager Call Control
Server
183311

1-2 OL-15528-02
Architecture
Enterprise Services
The enterprise services that Cisco Unified Mobility Advantage integrates with must already be installed
within the network. See Obtain Enterprise Services Information, page 2-4 for the list of services that are
compatible with Cisco Unified Mobility Advantage.
Mobile Data Network Service Providers

Cisco Unified Mobility Advantage is designed to work with multiple service providers. For more
information, refer to the Cisco Unified Mobility Advantage URL:
Cisco Unified Mobile Communicator

Cisco Unified Mobile Communicator is installed on mobile phones. This release of Cisco Unified
Mobile Communicator supports the following client platforms:
• RIM BlackBerry devices
• Symbian OS phones
Future releases of Cisco Unified Mobile Communicator will support additional client platforms.
Note See the Release Notes for your client platform for the list of supported model numbers, and for important
information pertaining to installation.
After Cisco Unified Mobility Advantage installation is complete, Cisco Unified Mobile Communicator
can be installed and provisioned on a mobile phone.
For more information on Cisco Unified Mobile Communicator installation, see the Cisco Unified
Mobility Advantage Administration Guide and the Cisco Unified Mobile Communicator Quick Start
Guide for your specific mobile phone.

OL-15528-02 1-3
Overview of Installation Tasks
Overview of Installation Tasks

The following tasks are required to install Cisco Unified Mobility Advantage:
Task 1 Complete the preinstallation tasks (Chapter 2, “Preinstallation Tasks”):

a. Install the Cisco Media Convergence Servers that will be hosting the Cisco Unified Mobility
Advantage Enterprise Server and the Cisco Unified Mobility Advantage Proxy Server.
b. Verify browser requirements.
c. Verify enterprise services that integrate with Cisco Unified Mobility Advantage.
d. Configure the BlackBerry Enterprise Server (optional; required only if supporting Cisco Unified
Mobile Communicator on BlackBerry devices).
e. Obtain enterprise services information.
f. Choose communication and firewall ports.
Task 2 Install the Cisco Unified Mobility Advantage Enterprise Server:
a. Install the Cisco Unified Mobility Advantage Operating System on the Cisco Media Convergence
Server that will be hosting the Cisco Unified Mobility Advantage Enterprise Server (Chapter 3,
“Installation”).
b. Install the Cisco Unified Mobility Advantage Enterprise Server application (Chapter 3,
“Installation”).
c. Run the Configuration Wizard and configure the Cisco Unified Mobility Advantage Enterprise
Server (Chapter 4, “Configuration”).
Task 3 Install the Cisco Unified Mobility Advantage Proxy Server (Chapter 5, “Proxy Server Installation”):
a. Install the Cisco Unified Mobility Advantage Operating System on the Cisco Media Convergence
Server that will be hosting the Cisco Unified Mobility Advantage Proxy Server.
b. Copy the final certificate file for the Proxy Server to the system.
c. Install the Cisco Unified Mobility Advantage Proxy Server application.
Task 4 Install Cisco Unified Mobile Communicator on end user phones.
For instructions, see the Cisco Unified Mobility Advantage Administration Guide.

1-4 OL-15528-02
CH A P T E R 2
Preinstallation Tasks
This chapter describes the preinstallation tasks that you must complete before you install Cisco Unified
Mobility Advantage:
• Install Cisco Media Convergence Servers
• Verify Browser Requirements
• Verify Enterprise Services
• Configure the BlackBerry Enterprise Server
• Obtain Enterprise Services Information
• Determine Communication and Firewall Ports
Install Cisco Media Convergence Servers

The Cisco Unified Mobility Advantage Enterprise Server must be installed on one of these platforms:
The Cisco Unified Mobility Advantage Proxy Server must be installed on one of these platforms:
Warning You must install the Media Convergence Server(s) before you install Cisco Unified Mobility
Advantage. See the Cisco Media Convergence Server Documentation for more information.
Install the Cisco Unified Mobility Advantage Operating System on each Media Convergence Server. See
Install Cisco Unified Mobility Advantage Operating System, page 3-1.
After the Media Convergence Servers are installed, make sure that:
• Each Media Convergence Server has a static IP address

OL-15528-02 2-1
Chapter 2 Preinstallation Tasks
Verify Browser Requirements
• The Media Convergence Server hosting the Cisco Unified Mobility Advantage Proxy Server has an
Internet hostname that can be resolved by an external DNS server
Verify Browser Requirements

Verify that the computer that will be used to configure Cisco Unified Mobility Advantage after
installation has one of these browser versions:
• Microsoft Internet Explorer 6.0 or later
• Mozilla Firefox 1.5 or later
The browser must have Macromedia Flash plug-in version 8.0 or later.
Verify Enterprise Services

Verify that the enterprise services in your network meet these requirements:
Table 2-1 Enterprise Services
Enterprise Service Requirement

Corporate Directory Active Directory 2000 or 2003
E-mail/Groupware Microsoft Exchange 2000 or 2003
Corporate IP PBX Cisco Unified Communications Manager version 6.0 or 5.1,
or Cisco Unified CallManager version 4.x
Voicemail System Cisco Unity version 4.x or 5.x
Conferencing System Cisco MeetingPlace Express version 1.2
BlackBerry Enterprise Server For systems supporting BlackBerry devices, BlackBerry
Enterprise Server version 4.1 with these items configured for
use with Cisco Unified Mobility Advantage:
• IT Policies
• Software Configuration Policies
See Configure the BlackBerry Enterprise Server, page 2-3.

2-2 OL-15528-02
Configure the BlackBerry Enterprise Server
Configure the BlackBerry Enterprise Server

If your system is supporting Cisco Unified Mobile Communicator on BlackBerry devices, configure
these items on the BlackBerry Enterprise Server:
• IT Policies
• Software Configuration Policies
Configure IT Policies
Configure IT Policy settings on the BlackBerry Enterprise Server to enable the installation of third-party
applications.
Procedure
Step 1 Open the BlackBerry Manager and click BlackBerry domain.

Step 2 Click Global tab > Edit Properties link > IT Policy.
Step 3 Select affected IT Policy, and click Properties.
Step 4 Click Security Policy Group.
Step 5 Set Disallow Third Party Application Download to False.
Step 6 Click TCP Policy Group.
Step 7 Set the following values for each GSM carrier. In the U.S., these settings are:
T-Mobile:
• APN—wap.voicestream.com
• Username—leave blank
• Password—leave blank
AT&T/Cingular:
• APN—wap.cingular
• Username—wap@cingulargprs.com
• Password—leave blank
Note If you have multiple GSM carriers, you must create multiple IT policies with different values in this
field. For non-GSM carriers, these values can be set to any value.

OL-15528-02 2-3
Obtain Enterprise Services Information
Configure Software Configuration Policies

Configure the Software Configuration Policy settings on the BlackBerry Enterprise Server as shown in
Table 2-2.
Procedure
Step 1 Open the BlackBerry Manager and click BlackBerry domain.

Step 2 Click the Software Configurations tab.
Step 3 Click Manage Application Policies.
Step 4 Select Policy and click Properties
Step 5 Set these properties:
Table 2-2 Software Configuration Policies on the BlackBerry Enterprise Server
Policy Setting
Disposition Required
Internal Network Connection Allowed

Before you install Cisco Unified Mobility Advantage, obtain information for the enterprise services in
this section.
You must obtain the information for each service and record this information as per the tables below.
You must also be able to reference the information as needed during the installation and configuration.
Microsoft Active Directory

Determine the values you will be using for these Active Directory settings and enter your information
under Value in Table 2-3:
Table 2-3 Microsoft Active Directory Settings
Setting Description Value

Hostname/IP Address Hostname or IP address of the corporate directory server.
Port LDAP port of the corporate directory server. Cisco Unified
Mobility Advantage uses this port to connect to the corporate
directory for end user directory listing and searches.
Default is 389.
Admin DN Distinguished Name of a user in corporate directory server who
has at least “Read Only” permissions in the corporate directory
server.

2-4 OL-15528-02
Table 2-3 Microsoft Active Directory Settings (continued)

Admin Password Password of the above user in the corporate directory server.
Searchbase Level in corporate directory server at which the Cisco Unified
Mobility Advantage Enterprise Server will start a search for users
for all of its searches.
If you are deploying Cisco Unified Mobility Advantage for a
specific organizational unit, you may choose to have this be the
base level for this organizational unit in your corporate directory
server. For example:
OU=Sales,DC=example,DC=com
If you are deploying Cisco Unified Mobility Advantage for the
entire company, you should have this value set to the base level for
the company in your corporate directory server. For example:
DC=example,DC=com
Microsoft Exchange
Determine the values you will be using for these Microsoft Exchange settings and enter your information
under Value in Table 2-4:
Table 2-4 Microsoft Exchange Settings

Hostname Hostname or IP address of the Exchange server.
Port Outlook Web Access (OWA) port of the Exchange server. This port
changes depending on whether or not SSL is used.
Default for SSL—443
Default for non-SSL—80
Exchange Domain Domain for this instance of the Exchange server. For example, CORP.
This is the domain that end users use when logging into their Windows
desktops.
Use SSL Determine whether or not Cisco Unified Mobility Advantage should
use SSL to connect to the Exchange server.
Default is Yes

OL-15528-02 2-5
Cisco Unity
Determine the values you will be using for these Cisco Unity settings and enter your information under
Value in Table 2-5:
Table 2-5 Cisco Unity Settings

Voicemail System Enter the Cisco Unity e-mail regular expression that identifies the
E-mail e-mail account used in the “from” field in voicemail messages for
which the sender cannot be resolved by Unity.
Default is: .*?(UNITY|unity).*
Use SSL Determine whether or not to use SSL for security between the Cisco
Unified Mobility Advantage Enterprise Server and this instance of
Exchange.
Default is Yes.
Cisco Unified Communications Manager

If you plan to use the optional Call Log feature, determine the values you will be using for these
Cisco Unified Communications Manager settings, and enter your information under Value in Table 2-6.
Related Topics
• Call Log Integration for Cisco Unified Mobility Advantage, page 2-7
• Username and Password Considerations, page 2-7
Table 2-6 Cisco Unified Communications Manager Settings

Hostname Hostname or IP address of the Cisco Unified Communications
Manager server(s).
If you have more than one Cisco Unified Communications Manager
server, specify all the host names as a comma-separated list with no
spaces.
Make sure that CTI services is enabled and running on all the hosts
you enter in this field.
Version Version of Cisco Unified Communications Manager.
Username and Up to four sets of user names and passwords for Cisco Unified Username:
Password Communications Manager users. Password:
See “Username and Password Considerations” section on page 2-7 Username:

for more information. Password:
Username:
Password:
Username:
Password:

2-6 OL-15528-02
Call Log Integration for Cisco Unified Mobility Advantage

Call Logs are generated in Cisco Unified Communications Manager when a call is made to the desk
phone of a user.
To synchronize Mobile Communicator with a desk phone, Cisco Unified Mobility Advantage monitors
the desk phone using a CTI user. This CTI user is configured within Cisco Unified
Communications Manager and is associated with the phone line of the Mobile Communicator user.
For Cisco Unified Mobility Advantage to communicate with Cisco Unified Communications Manager,
Cisco Unified Mobility Advantage needs to be configured with at least one (and up to four) user accounts
that are CTI enabled and with the hostname of the Cisco Unified Communications Manager server
running the CTI service. Each user monitors up to 250 lines. This process works as follows:
1. A call comes in or is placed by a IP phone corresponding with a Mobile Communicator phone.
2. Cisco Unified Communications Manager generates an event for the Cisco Unified
Mobility Advantage server.
Note The Cisco Unified Mobility Advantage server generates call logs for calls placed from or received by
the IP Phone only. For calls that are placed from or received directly on the mobile phone, the mobile
phone generates a local call log. The call log includes sender name, contact phone number, read status
and length.
3. Cisco Unified Mobility Advantage uses the event to create a call log entry on the server and then
synchronizes these with Mobile Communicator.
4. The entry is sent to the Mobile Communicator client after the call is finished.
Cisco Unified Mobility Advantage references Active Directory to know which user the call log should
be sent to; therefore, it must be able to uniquely identify the directory number of a user in Active
Directory. Cisco Unified Mobility Advantage also uses the Telephone Number field to match the data
from the call log to a Mobile Communicator user. This means that you cannot have duplicate telephone
numbers configured inside Active Directory; otherwise, Unified Mobility Advantage will not be able to
uniquely identify the users.
Username and Password Considerations

Before the Cisco Unified Mobility Advantage Enterprise Server can talk to the Cisco Unified
Communications Manager server, the Cisco Unified Communications Manager server must be
configured to contain at least one (and at the most four) application user accounts that are CTI-enabled.
These user accounts should be associated with the office phones of the users that are being enabled to
use Cisco Unified Mobile Communicator. The Cisco Unified Mobility Advantage Enterprise Server uses
these accounts to monitor activities on the associated office phones to generate integrated call logs on
Cisco Unified Mobile Communicator.
The exact number of user accounts to create in Cisco Unified Communications Manager depends on how
many Cisco Unified Mobile Communicator users are activated on the system. Create one user account
per 250 Cisco Unified Mobile Communicator users. A maximum of four user accounts can be created.
Each user account can be assigned a maximum of 250 office phones to administer.
When creating a user on Cisco Unified CallManager version 4.x, in the Cisco Unified CallManager
Admin Portal, check the “Enable CTI Application Use” check box that is on the User Configuration
window for an existing or new user designated to be the Cisco Unified CallManager user.

OL-15528-02 2-7
Determine Communication and Firewall Ports
When creating a user on Cisco Unified Communications Manager 5.1 or 6.0, assign the user to the
“Standard CTI Enabled” group that is on the User Group Configuration window. Additionally, the user
should automatically be assigned the “Standard CCM End Users” group (also on the User Group
Configuration window). From the End User Configuration window, check the “Allow Control of Device
from CTI” check box for this user. (This is the default.)

Determine which communication and firewall ports the Cisco Unified Mobility Advantage Server and
Cisco Unified Mobility Advantage Proxy Server use, and record these settings in the tables in these
sections. You must be able to reference these settings as needed during the installation and configuration.
Communication Ports
Complete Table 2-7, Table 2-8, and Table 2-9 for each Cisco Unified Mobility Advantage Enterprise
Server component (Managed Server, Admin Server, and Node Manager Server).
Complete Table 2-10 on page 2-11 for the Cisco Unified Mobility Advantage Proxy Server.
Managed Server Ports

Determine the ports for the Managed Server, and record the ports you will be using under Value in this
table:
Table 2-7 Managed Server Ports

User Portal Port Port used by end users to access the Cisco Unified Mobile
Communicator User Portal.
For example, https://mycompany.com:8443
Default is 8443
Provisioning Port Port used for over-the-air downloads of Cisco Unified Mobile
Communicator.
Default is 8080
Naming Port Internal communication port used by the Cisco Unified Mobility
Advantage Managed Server.
Default is 1199
RMI Port Internal communication port used by the Cisco Unified Mobility
Default is 1198
RMI Object Port Internal communication port used by the Cisco Unified Mobility
Default is 4444

2-8 OL-15528-02
Table 2-7 Managed Server Ports (continued)

Server Bind Port Internal communication port used by the Cisco Unified Mobility
Default is 4445
Non SSL Client Port Internal communication port used by the Cisco Unified Mobility
Default is 5555
SSL Client Port Port that clients connect to for secure communication.
Default is 5443
Inter-Server SSL Port Port used by the Cisco Unified Mobility Advantage Managed
Server for server-to-server communications.
Default is 6443
Managed Server SSL Client Port Port that the Proxy Server connects to for secure client
communications.
Default is 5443
Managed Server Provisioning Port that is used for over-the-air downloads of Cisco Unified
Port Mobile Communicator.
Default is 8080
Admin Server Ports

Determine the ports for the Admin Server, and record the ports you will be using under Value in this
table:
Table 2-8 Admin Server Ports

Admin Portal Port Port used by a system administrator to access the Cisco Unified
Mobility Advantage Admin Portal.
This port is used by the Proxy Server to obtain configuration
information from the Admin Server.
Default is 7080
For example, http://mycompany.com:7080/adminportal
Note This value is HTTP, not HTTPS.
Advantage Admin Server.
Default is 7099
Default is 7098

OL-15528-02 2-9
Table 2-8 Admin Server Ports (continued)

Default is 7444
Default is 7445
Node Manager Server Ports

Determine the ports for the Node Manager Server, and record the ports you will be using under Value in
this table.
Note In most cases, you can use the default values.
Table 2-9 Node Manager Server Ports

HTTP Port Internal communication port used by the Node Manager Server.
Default is 3080
Advantage Node Manager Server.
Default is 3099
Default is 3098
Default is 3444
Default is 3445

2-10 OL-15528-02
Proxy Server Ports

Determine the ports for the Proxy Server, and record the ports you will be using under Value in this table:
Table 2-10 Proxy Server Ports

Admin Server HTTP Port Port used by a system administrator to access the Cisco Unified
This must be the same value you assigned to the Admin Server
“Admin Portal Port” setting.
Advantage Proxy Server.
Default is 5099
Default is 5098
Default is 5444.
Default is 5445.
Proxy Server Client Port Port that is used for secure client-server communication.
Default is 5443
Proxy Server Provisioning Port Port that is used for over-the-air downloads of Cisco Unified
Mobile Communicator.
Default is 8080

OL-15528-02 2-11
Firewall Ports
Of the communication ports you entered in Communication Ports, page 2-8, note the following ports that
must be opened in the external and internal firewalls.
Caution These ports must be TCP ports.
Figure 2-1 shows an example of the default firewall ports.
Figure 2-1 Firewall Ports
DMZ Enterprise Services

8080
firewall
firewall
Outer
Inner
MobileData 389
Network
5443 MA
Directory
80 Managed
80 3 Server
544
443 (SSL)
80 (non-SSL)
7080 MA Voice
MA
mail
Admin
Server Email
Proxy
Server
MA Collaboration
27
Voice 48
PSTN Node
Channel Manager Call Control
Server
183312
M
External Firewall Ports

The following ports must be opened in the external firewall:
• Proxy Server Client Port—Default value is 5443
• Proxy Server Provisioning Port—Default value is 8080
Internal Firewall Ports

The following ports must be opened in the internal firewall:
• Managed Server SSL Client Port—Default value is 5443
• Managed Server Provisioning Port—Default value is 8080
• Admin Portal Port—Default value is 7080

2-12 OL-15528-02
CH A P T E R 3
Installation
This chapter describes how to install the Cisco Unified Mobility Advantage Operating System and the
Cisco Unified Mobility Advantage Enterprise Server after you have completed the preinstallation tasks
outlined in Chapter 2.
Note The server on which you install Cisco Unified Mobility Advantage will be reformatted during the
installation. We suggest using an unformatted server.
Install Cisco Unified Mobility Advantage Operating System

Procedure
Step 1 Insert the Cisco Unified Mobility Advantage OS DVD into the DVD-ROM drive of the server on which
you are going to install Cisco Unified Mobility Advantage.
Step 2 Boot the computer from the DVD.
Step 3 The system checks that this is a valid platform. You do not see this check unless your platform is invalid.
• If your platform is invalid, the system displays an error message, aborts the installation, and displays
a log with information.
• If your platform is valid, the installation continues.
Step 4 The system checks that there is an existing operating system. You do not see this check unless you have
an existing operating system, in which case the system asks if you want to overwrite it.
• If you choose not to overwrite the existing operating system, the installation process aborts and the
DVD ejects.
• If you choose to continue the installation, the system overwrites the existing operating system and
any existing data will be lost. You have 30 seconds to choose to continue; otherwise, the system
aborts the installation and ejects the DVD.
If your system does not have an operating system, the installation continues.
Step 5 The computer performs a system check that inspects the hard drive, the RAID, and the BIOS.
• If the system does not need to reconfigure any part of the system, it displays a green check mark
next to each component name and continues.

OL-15528-02 3-1
Chapter 3 Installation
Install Cisco Unified Mobility Advantage Operating System
• If the system needs to reconfigure any part of the system, it displays two green circular arrows next
to the component name and automatically reboots after 15 seconds. During these 15 seconds, you
can hit any key to pause the check and read the message. After pausing, you must click Restart to
continue. After rebooting, the installation process continues from where it left off.
Depending on your system configuration, it may reboot up to three times. This happens automatically.
Step 6 The system continues to the media check screen. If the media check fails, you can either abort the
installation or continue. If you continue with the installation, there may be errors. The media check can
take up to 10 minutes.
Step 7 The Cisco Unified Mobility Advantage Operating System loads and installs from the DVD. This takes
approximately 10 to 15 minutes.
Step 8 After installation, the server reboots.
Step 9 The Cisco Unified Mobility Advantage system displays the Welcome page with an introductory message
informing you that there are a few more steps to take before your system is ready to use. Click Next.
Step 10 The Root Password page appears. Enter a root password for the system. The password must contain at
least:
• 8 characters
• One lowercase character (a-z)
• One uppercase character (A-Z)
• One numeric digit (0-9)
• One special character (!”#$%&’)*+,-./:;<=>?@[\]^_{}~)
Step 11 Click Next.
Step 12 On the Network Setup screen, enter values as described in Table 3-1. All fields are required.
Table 3-1 Network Setup Screen
Field Definition
DNS Information
Primary Primary DNS address
Secondary Secondary DNS address
Domain Name DNS search path
Ethernet Port 1 (device eth0): use for HTTP and VOICE access
Host Name Fully qualified domain name (FQDN) of the host
IP Address IP address assigned to the host
Subnet Mask Subnet mask for the host
Gateway Default gateway address for the host
Auto Negotiation Use the default value
Speed (Full Duplex) Use the default value
Step 13 Click Next.

Step 14 On the Timezone page, set the Time zone for the system by following these steps:
a. Scroll through the list of time zones.
b. Select the time zone that best represents where the system resides.

3-2 OL-15528-02
Install the Cisco Unified Mobility Advantage Enterprise Server
c. Ensure that the checkbox next to System clock uses UTC is checked.
d. Click Next.
Step 15 On the Date and Time page, set the date and time for the system.
Note We recommend synchronizing the date and time of the server automatically using Network Time
Protocol (NTP). A time server (computer that sends accurate date and time settings to other servers
through the network) must be available to use NTP.
Setting the Date and Time with NTP

a. Click the Network Time Protocol tab.
b. Click the check box next to Enable Network Time Protocol.
c. Enter the NTP server host name or IP address in the Server field.
d. Click Add,
e. Click Next.
f. The system attempts to contact the NTP server to obtain the correct date and time.
Manually Setting the Date and Time

a. Click the Date & Time tab.
a. In the Date box, select today’s date. Click the left and right arrows to move to a different month or
year.
b. In the Time box, set the hour, minute, and second to the current time.
c. Click Next.
When the Cisco Unified Mobility Advantage Operating System installation is complete, the DVD-ROM
drive ejects the DVD. The system displays a message informing you that the operating system
installation is complete.

The Cisco Unified Mobility Advantage Installation Wizard guides you through the required installation
steps. Default settings are provided. Use the default settings or the values you determined and recorded
during the preinstallation tasks.
Procedure
Step 1 When the system displays the Cisco Application DVD page, insert the Cisco Unified Mobility
Advantage application DVD.
Note If you downloaded the Cisco Unified Mobility Advantage ISO file from Cisco.com, use any
commercially available ISO file unpackaging program and expand the ISO file to the directory of your
choice on your local hard disk, or use any commercially available CD-ROM burner program, and burn
the file onto a CD.

OL-15528-02 3-3
Step 2 Click Install.
Note Wait for the Installation Wizard to start. This process may take several minutes.
Step 3 When the Installation Wizard begins, review the information on the Important screen.
Step 4 Click Next.
The License Agreement screen appears.
Step 5 Review the License information. To accept the license, click I accept the Terms of the License
Agreement, and click Next.
The Choose Install Set screen appears.
Step 6 Choose Cisco Unified Mobility Advantage as the type of installation, and click Next.
The Choose Install Folder screen appears.
Step 7 Enter or select the location where the Cisco Unified Mobility Advantage Enterprise Server will reside,
and click Next.
The default installation path is /opt/cuma.
The Managed Server Instance Name screen appears.
Step 8 Enter the name that you want to assign to this instance of the Managed Server, and then Next.
Note Each installation of the Cisco Unified Mobility Advantage Enterprise Server is considered an
instance. Use a name that identifies this instance, and that is easily remembered for future
reference. For example, the default name is cuma. The name is limited to 32 characters. The
name cannot be ‘admin,’ ‘node_manager,’ or ‘proxy.’
The Managed Server Configuration screen appears.

Step 9 Enter values for the Managed Server ports, and then Next.
The default values are shown in parenthesis. Use these values or the values you determined during the
preinstallation tasks. See Table 2-7 on page 2-8.
When complete, the Admin Portal Configuration screen appears.
Step 10 Enter values for the Admin Server (Admin Portal) ports, and then click Next.
preinstallation activities. See Table 2-8 on page 2-9.
When complete, the Admin Portal Password screen appears.
Step 11 Enter a password used for logging into the Cisco Unified Mobility Advantage Admin Portal, and click
Next.
By default, the username is admin and cannot be changed.
Note The password must be at least one character. Spaces are not allowed. The password can be
changed at a later time (after installation) by using the Admin Portal.
The Node Manager Server Configuration screen appears.

Step 12 Enter values for the Node Manager Server ports, and then click Next.

3-4 OL-15528-02
Verify Server Status
preinstallation activities. See Table 2-9 on page 2-10.
When complete, the Preinstallation Summary screen appears.
Step 13 Review the information on the summary screen and make sure all of the information is correct.
• If changes are required, click Previous and make the changes.
• If the information is correct, click Install.
The Cisco Unified Mobility Advantage Enterprise Server installs. When complete, the Install Complete
screen appears.
Step 14 Click Done.
The Cisco Unified Mobility Advantage Enterprise Server is installed.
Step 15 Click Reboot to restart the server.
After rebooting, the Admin Server and the Node Manager Server start automatically. Verify the server
status. See Verify Server Status, page 3-5.

After installing the Cisco Unified Mobility Advantage Enterprise Server, verify that the Admin Server
and the Node Manager Server are started, as described next. For more information about starting the
servers, see Maintenance, page A-1.
After the servers are started, configure the Cisco Unified Mobility Advantage Enterprise Server. See
Configuration, page 4-1.
Admin Server
To verify that the Admin Server is started:
Procedure
Step 1 Log in as root to the system that is hosting the Admin Server.
Step 2 Open a new terminal.
Step 3 Enter this command in the terminal window:
/sbin/service cuma_admin status
The status message should read: “cuma_admin is running”.
If the Admin Server is not running (the message reads “cuma_admin is stopped”), start the server using
the following command:
/sbin/service cuma_admin start
The Admin Server starts when the “OK” message appears.

OL-15528-02 3-5
Node Manager Server

To verify that the Node Manager Server is started:
Procedure
Step 1 Log in to the system that is hosting the Node Manager Server.
Step 3 Enter this command in the terminal window:
/sbin/service cuma_nm status
The status message should read: “cuma_nm is running”.
If the Node Manager Server is not running (the message reads “cuma_nm is stopped”), start the server
using the following command:
/sbin/service cuma_nm start
The Node Manager Server starts when the “OK” message appears.

3-6 OL-15528-02
CH A P T E R 4
Configuration
This chapter describes how to run the Configuration Wizard to configure the Cisco Unified Mobility
Advantage Enterprise Server.
Log in to the Cisco Unified Mobility Advantage Admin Portal

To start the Cisco Unified Mobility Advantage Configuration Wizard, log in to the Cisco Unified
Note In addition to running the Configuration Wizard to complete the Cisco Unified Mobility Advantage
installation, the Admin Portal is used for maintaining Cisco Unified Mobility Advantage and Cisco
Unified Mobile Communicator. For more information about using the Admin Portal, see the Cisco
Unified Mobility Advantage Administration Guide.
Procedure
Step 1 Verify that the Admin Server is started. See Verify Server Status, page 3-5.
Step 2 On the Cisco Unified Mobility Advantage Enterprise Server, enter the following URL into a supported
web browser:
http://hostname:port/adminportal
• hostname is the hostname of the Admin Server
• port is the port assigned to the Admin Server (default is 7080)
For example: http://mycompany.com:7080/adminportal
The Admin Portal log in screen appears.
Step 3 Enter the password and choose Login.
By default, the username is admin. The password was determined during the installation.
The Configuration Wizard starts.

OL-15528-02 4-1
Chapter 4 Configuration
Run the Configuration Wizard

The Configuration Wizard prompts you through the steps required to configure Cisco Unified Mobility
Advantage for your system.
To run the Configuration Wizard, click Next on the Welcome screen. The SSL Certificate Management
screen appears.
SSL Certificate Management

The SSL Certificate Management screens prompt you through the steps required to create an
SSL Certificate. The entire SSL certificate process is completed in two parts:
• Part 1 is completed during the Configuration Wizard and consists of these steps:
– Gather Required Information, page 4-2
– Generate Keystore File and Self-Signed Certificate for Enterprise Server, page 4-3
• Part 2 is completed after the Configuration Wizard and consists of these steps (see Complete the SSL
Certificate Process, page 4-17):
– Generate the Keystore File for the Proxy Server, page 4-17
– Generate the CSR for the Proxy Server, page 4-17
– Request a Signed Certificate From VeriSign, page 4-18
– Download an Intermediate Certificate from VeriSign, page 4-18
– Create Final SSL Certificate Files, page 4-19
– Upload Final Certificate on the Enterprise Server, page 4-20
– Upload Final Certificate on the Proxy Server, page 4-20
Note See SSL Certificate Process, page B-1 for additional information regarding this process.
Gather Required Information

Before you begin, gather this information:
Table 4-1 SSL Certificate Required Information
Field Definition
Server Name Fully qualified domain name for the Cisco Unified Mobility Advantage
Proxy Server. For example: cumapxy.cisco.com.
Department Name In most cases, this is the department name used when requesting
SSL certificates from VeriSign.
Company Name Your company name. In most cases, this is the company name used when
requesting SSL certificates from VeriSign
City The city where the department or company is located.

4-2 OL-15528-02
Table 4-1 SSL Certificate Required Information
Field Definition
State The state where the server will be deployed. The state name can not be
abbreviated. For example, California (not CA).
Country Code Enter the two-letter code for the country where the company is located. For
the United State, this is US (not USA).
Password The password entered by the administrator during keystore file generation.
It is utilized during creation of the final certificate, and must be at least six
characters in length.
Generate Keystore File and Self-Signed Certificate for Enterprise Server

Procedure
Step 1 Click Yes on the SSL Certificate Management screen to generate a new certificate.
The Generate Certificate Signing Request (CSR) screen appears.
Click Next and enter requested information. This form is required to generate the keystore file and the
CSR.
Complete all fields. Special characters cannot be used, and the name of the state cannot be abbreviated.
Step 2 Click Next.
The Generate Certificate Signing Request (CSR) screen appears with a hyperlink to download the
keystore file and the actual text of the CSR. The keystore file and CSR are two different objects; both
are required to proceed.
Step 3 Click the here link to download the keystore file. Save the file to your local computer with a descriptive
name such as cumaenterprise.keystore.
Step 4 Copy and paste the CSR text that is displayed below the download link and paste it into a text file.
Tip The text file can be created using any text editor.
Step 5 Save the file to your local computer (for example, cumaproxy-csr.txt).
Step 6 After saving the keystore and proxy files to your local computer, click Reset at the top of the
Configuration Wizard.
Step 7 Click Yes to return to the SSL Certificate Management screen (described in Generate Keystore File and
Self-Signed Certificate for Enterprise Server, page 4-3).
Step 8 Click No when prompted to create a new certificate.
Step 9 Click the Browse button and navigate to the keystore file you downloaded Step 3.
Step 10 Enter the password for the keystore file.
Step 11 Select JKS for type and click Next.
The file should import successfully. At this point, the Cisco Unified Mobility Advantage Enterprise
Server has a self-signed certificate.

OL-15528-02 4-3
Step 12 Continue to Enterprise Configuration, page 4-4 to complete the Configuration Wizard. When the
Configuration Wizard finishes, do not start the Cisco Unified Mobility Advantage Enterprise Server.
Follow the instructions to generate a keystore for the Proxy Server and complete the SSL certificate
process. See Complete the SSL Certificate Process, page 4-17.
Enterprise Configuration
The Enterprise Configuration screens allow you to configure the Cisco Unified Mobility Advantage
Enterprise Server to interface with these servers:
• Corporate directory server
• Personal contact server
• Call Control server
Corporate Directory Server

The Corporate Directory Server acts as both the repository for corporate contact information and the
authenticating authority for user sessions.
To configure the corporate directory server:
Procedure
Step 1 In the Corporate Directory Configuration screen, select and enter the corporate directory server
information as described in Table 4-2.
Table 4-2 Corporate Directory Configuration Screen
Field Definition
Corporate Directory Type Select the type of corporate directory your organization uses. For
example, Active Directory.
Adapter Name Enter a name you want to assign to the corporate directory adapter.
Description Enter a description for the corporate directory adapter.
Step 2 Click Next.

Step 3 Enter the host information of the corporate directory server as described in Table 4-3.
Field Definition
Host Name/IP Address Enter the hostname or IP address of the corporate directory server.
Step 4 Click Next.

4-4 OL-15528-02
Step 5 Select the Base DN information as described in Table 4-4.
Field Definition
Base DN Distinguished name of the root node in your corporate directory
server. For example:
DC=department,DC=example,DC=com
Choose Edit if the Base DN you want is not listed in the menu.
Step 6 Click Next.

Step 7 Verify the filter criteria, follow referral, and polling period as described in Table 4-5.
Field Definition
Filter Criteria Verify the criteria that will be used to distinguish corporate users
from other corporate resources within the corporate directory server.
In most cases, it is recommended that you use the default value.
Follow Referral Select whether or not you want the Cisco Unified Mobility
Enterprise Server to follow referrals from the corporate directory
server.
The default is Yes. It is recommended that you use the default value.
Polling Period (days) Enter the time (in days) that establishes how frequently the Cisco
Unified Mobility Advantage Enterprise Server polls the corporate
directory server for updates.
The default value is 1 day.
Step 8 Click Next.

Step 9 Enter the user information as described in Table 4-6.
Field Definition
User DN Enter the distinguished name of the account that Cisco Unified
Mobility Advantage Server uses to read data from your corporate
directory server. For example:
CN=CUMA Read Only
User,CN=Users,DC=department,DC=example,DC=com
This account needs to have read-only permissions in your corporate
directory server.
Append Base DN Select this check box to allow the Cisco Unified Mobility Advantage
Enterprise Server to append the base DN to the user’s DN (instead
of giving the complete distinguished name of the user above).
Password Enter the password of the account.

OL-15528-02 4-5
Step 10 Click Next.

Step 11 Review the mapping attribute information on the screen as described in Table 4-7. Click Edit to make
any changes, or click Next to proceed with the default settings.
Note It is recommended that you use the default settings.
Field Definition
Distinguished Name Enter the name of the attribute in Active Directory that represents a
user’s distinguished name. For example:
distinguishedName
First Name Enter the name of the attribute in Active Directory that represents a
user’s first name. For example:
givenName
Last Name Enter the name of the attribute in Active Directory that represents a
user’s last name. For example:
sn
Email Enter the name of the attribute in Active Directory that represents a
user’s e-mail address. For example:
mail
Step 12 Review the lookup information on the screen as described in Table 4-8. Click Edit to make any changes,
or click Next to proceed with the default settings.
Note It is recommended that you use the default settings.
Field Definition
Contact Adapter Enter the name of the attribute within the corporate directory that
identifies the logical Exchange server resource name for a user. For
example:
msExchHomeServerName
DNS Host Name Enter the name of the attribute within the corporate directory that
identifies the DNS host name of a server machine. For example:
dNSHostName

4-6 OL-15528-02
Table 4-8 Corporate Directory Configuration Screen (continued)
Field Definition
Contact Adapter DN Mask Enter the Contact Adapter DN Mask. The format of the DN Mask is:
??,CN=Computer,DC=department,DC=example,DC=com
The Cisco Unified Mobility Advantage Enterprise Server will use
the value of the Contact Adapter field (entered above) in
combination with this DN Mask to search for the DNS hostname of
a user’s Exchange Server.
?? is substituted with the CN=<hostname of the Exchange server>.
The following part is used to complete the DN. This complete string
is then used to retrieve details about the user’s Exchange host.
The hostname is retrieved from Active Directory using the “Contact
Adapter” attribute of the user entry. Contact Adapter
(msExchHomeServerName).
For example, if in Active Directory for user test1, the
msExchHomeServerName is “myExchange” and the DN Mask is
configured as ??, CN=Computer, DC=myDivision,
DC=somecompany, DC=com, then the Cisco Unified Mobility
Advantage Enterprise server will lookup the following entry in
Active Directory to get details about the Exchange server and use it
to store personal contacts of the test1 user:
CN=myExchange, CN=Computer, DC=myDivision,
DC=somecompany, DC=com
Contact Adapter Search Base Enter the Distinguished Name of the root node that contains your
Exchange Server’s information in your corporate directory. For
example:
CN=Computers,DC=department,DC=example,DC=com
The Cisco Unified Mobility Advantage Enterprise Server searches a
user’s Exchange Server from this root node.
The Corporate Directory Configuration Summary screen appears.

Step 13 Review the information. To change any setting, click Reset. Otherwise, click Next.
The Personal Contact Server Configuration screen appears.

OL-15528-02 4-7
Personal Contact Server

To configure the personal contact server:
Procedure
Step 1 Enter the personal contact server information as described in Table 4-9.
Table 4-9 Personal Contact Server Screen
Field Definition
Personal Contact Server Type Select the type of personal contact server that your company uses.
For example, Microsoft Exchange.
Adapter Name Enter a name that you want to assign to the personal contact adapter.
Description Enter a description for the personal contact adapter.
Step 2 Click Next

Step 3 Enter the Exchange server information as described in Table 4-10.
Field Definition
Hostname/IP Address Enter the hostname or IP address of the Exchange server.
Use SSL Specify whether or not Cisco Unified Mobility Advantage should
use SSL to connect to this Exchange server.
Default is Yes.
Step 4 Click Next

Step 5 Enter the port, Exchange domain, and user name suffix information as described in Table 4-11.
Field Definition
Port Enter the port used to connect the Cisco Unified Mobility Advantage
Enterprise Server to the Exchange server. This port changes
depending on whether or not SSL is used.
Exchange Domain Enter the domain for this instance of the Exchange server. For
example, CORP. This is the domain that end users use when logging
into their Windows desktops.
User Name Suffix Enter the suffix that is applied to a user to complete their corporate
e-mail address.
Note In most cases, this field should be blank; it is not used during
most installations.
Step 6 Click Next.

Step 7 Enter the voicemail configuration information as described in Table 4-12.

4-8 OL-15528-02
These values apply to systems that want to integrate Cisco Unified Mobility Advantage with their
voicemail system.
Caution Do not change these values without first contacting Cisco Support.
Table 4-12 Personal Contact Server—Voicemail Settings Screen
Field Definition
Filter Field Name Determines the field to be used to identify a corporate voicemail
from other types of messages. Select the value appropriate for your
organization.
Options are “class_id,” “subject”, “to”, “from”, and “cc”.
Filter Value Enter the value that is found in the field identified as “Filter Field
Name” when the message is a ‘corporate voicemail’ message.
Enter the specific value appropriate for your organization.
Voicemail System Email Enter the Cisco Unity e-mail regular expression that identifies the
e-mail account used in the “from” field in voicemail messages for
which the sender cannot be resolved by Unity.
Default is: .*?(UNITY|unity).*
Phone Number Search Field Enter the field to search for a caller’s phone number. For example:
Name
Subject
Phone Number Search Pattern Enter a regular expression for the search pattern that should be used
in the Phone Number Search Field Name field. For example:
[0-9]{4}
Step 8 Click Next.

Step 9 Select whether or not you want to enable the voicemail server as described in Table 4-13.
Table 4-13 Personal Contact Server Configuration—Voicemail Integration Screen
Field Definition
Enable Corporate Voicemail Determine whether or not the Cisco Unified Mobility Advantage
Integration Enterprise Server provides voicemail viewing and downloading
capabilities on Cisco Unified Mobile Communicator.
Maximum Expiry of Voicemails Indicates the maximum value that a user can select for the number
(days) of days within which voicemail messages will be visible on Cisco
Unified Mobile Communicator.
Step 10 Click Next.

OL-15528-02 4-9
Step 11 Select whether or not you want to integrate Cisco Unified Mobility Advantage with your corporate
conferencing system, as described in Table 4-14.
Table 4-14 Personal Contact Server Configuration—Conference Integration Screen
Field Definition
Enable Conference Integration Determine whether or not the Cisco Unified Mobility Advantage
Enterprise Server integrates with your corporate conferencing
system and provides conference notifications and viewing
capabilities on Cisco Unified Mobile Communicator.
Step 12 Click Next.

The Personal Contact Server Configuration Summary Screen appears.
Step 13 Review the information. To change any information, click Reset. Otherwise, click Next.
The Call Control Configuration screen appears.
Call Control Server

To configure the call control server:
Procedure
Step 1 Choose if you want to integrate Cisco Unified Mobility Advantage with a Call Control server, and click
Next.
• If yes, the Call Control Configuration screen appears. Go to Step 2 to configure the adapter.
• If no, click Next on the Call Control Configuration Summary screen. The Enterprise Configuration
Summary screen appears. To view configuration summaries for each server, click their respective
Host Name/IP Address, or click Next to go to the System Configuration screen. Go to System
Configuration, page 4-13 to continue the installation.
Step 2 Enter the Call Control adapter information as described in the Table 4-15.
Table 4-15 Call Control Configuration Screen
Field Definition
Call Control Server Type Select the type of call control server that your company uses. For
example, Cisco Unified Communications Manager.
Adapter Name Enter a name that you want to assign to the call control adapter.
Description Enter a description for the call control adapter.
Step 3 Click Next.

4-10 OL-15528-02
Step 4 Enter the hostname or IP address of the Call Control server and its user name and password details, as
described in Table 4-16.
Table 4-16 Call Control Configuration—Cisco Unified Communications Manager Screen
Field Definition
Hostname/IP Address Enter the hostname or IP address of the Cisco Unified
Communications Manager server(s).
If you have more than one Cisco Unified Communications Manager
server, specify all host names or IP addresses as a comma-separated
list with no spaces. For example: 172.22.100.1,172.22.101.1.
Make sure that CTI Manager service is enabled and running on all
the hosts you enter in this field. (This is accomplished from the
Cisco Unified service ability application, Service Activation
window - if the host is CCM.)
User Name Enter up to four pairs of Cisco Unified Mobile Communicator
usernames and passwords setup in Cisco Unified Communications
Manager.
See Username and Password Considerations, page 2-7 for more
information.
Password Enter up to four pairs of Cisco Unified Mobile Communicator
usernames and passwords setup in Cisco Unified Communications
Manager.
See Username and Password Considerations, page 2-7 for more
information.
CallManager Version Select the version of the Cisco Unified Communications Manager
Server.
Step 5 Click Next.

Step 6 Enter the dial plan configuration information for the Call Control server as described in Table 4-17.
Field Definition
Area Code Enter the area code corresponding to the local calling area of the call
control server.
Country Code (CC) Enter the assigned calling code for the country of the call control
server. In the U.S., this is 1.
Dial Out Prefix Enter the prefix configured in the call control server for dialing an
outside number. For example, 9.
National Direct Dialing Prefix Enter the prefix to dial a number within the same country, but
(NDD) outside of the local calling area. For example, in the U.S., this is 1.
International Direct Dialing Enter the prefix required to dial outside of the home country. In the
Prefix (IDD) U.S., this is 011.

OL-15528-02 4-11
Field Definition
Extension Regex Field used to search Active Directory. The regular expression
configured in this field is used for:
• Identifying an extension number that Cisco Unified Mobile
Communicator monitors for call control features.
• Identifying an incoming or outgoing call as an extension call.
The phone number (ANI/DNIS) received in incoming or
outgoing calls could be in extension-only format (internally
dialed calls) or complete local-number format (direct inward
dialing)
For example:
Assume that your area code is 408 (NPA = 408), and Direct Inward
Dialing Prefix is 625 (NXX = 625), and that the Directory Numbers
(extensions) defined in your Cisco Unified Communications
Manager server are in the form 3xxx or 4xxx. The DID for the user
would be 408-625-3xxx or 408-625-4xxx.
The regular expression to monitor extensions will be [3-4][0-9]{3}.
To match ANI/DNIS received in incoming or outgoing calls to an
extension, you must add a prefix pattern to the regular expression. In
this case, the prefix pattern is 625. For the server to extract the
extension-only portion for monitoring, a grouping of extension
pattern is required. Grouping is done by using parenthesis. Using the
above example, the extension regular expression should be written
as:
(?:625)?([3-4][0-9]{3})
• The "?" following the prefix group indicates this is optional.
• The "?:" after the opening parenthesis in the prefix group tells
the engine not to count this group. That way, whether the prefix
is present or not in the number, the engine can extract the first
group as the extension-only portion.
• The {3} means the number of digits of the previous expression,
such as [0-9] in the above example.
The server automatically matches additional variations of these
numbers using the previously configured prefixes. Thus, if the area
code is configured as 408, then the regular expression above would
allow the server to identify 4086253125, 6253125, and 3125 as an
extension number.
Local Number Regex Enter a regular expression for matching locally dialable numbers.
For North America, this is:
[2-9][0-9]{6}
National Number Regex Enter a regular expression for matching nationally dialable numbers.
(excluding NDD) The NDD is automatically included as part of this and does not need
to be specified as part of the expression. For North America, this is:
[2-9][0-8][0-9][2-9][0-9]{6}

4-12 OL-15528-02
Step 7 Click Next.

Step 8 Indicate whether or not to integrate with the corporate PBX system as describe in Table 4-18.
Table 4-18 Call Control Configuration—Corporate PBX Integration Screen
Field Definition
Enable Corporate PBX Determine whether or not the Cisco Unified Mobility Advantage
Integration Enterprise Server integrates with your corporate IP PBX system and
provides office phone call log viewing capabilities on Cisco Unified
Mobile Communicator.
Maximum Expiry of Call Logs Indicates the maximum value that a user can select for the number
(days) of days within which call logs will be sent to the client.
Default is 30.
Step 9 Click Next.

The Call Control Configuration Summary screen appears.
Step 10 Review the information. To change any information, click Reset. Otherwise, click Next.
The Enterprise Configuration Summary screen appears.
To view configuration summaries for each server, click their respective Hostname or IP Address.
Step 11 Click Next to continue with the configuration.
The System Configuration screen appears.
System Configuration
The System Configuration screen allows you to determine the Cisco Unified Mobility Advantage
Enterprise Server domain information and SMTP server information.
The SMTP Server must allow relaying from the Cisco Unified Mobility Advantage Server. The Cisco
Unified Mobility Advantage Enterprise Server uses the SMTP server to send out device provisioning and
‘melt’ messages.
To determine system configuration information:
Procedure
Step 1 Enter the information as described in Table 4-19.
Table 4-19 System Configuration Screen
Field Definition
General
Domain Enter a domain name for this instance of the Cisco Unified Mobility
Advantage Enterprise Server. This forms the user’s Cisco Unified
Mobile Communicator user address. For example:
cisco.com

OL-15528-02 4-13
Table 4-19 System Configuration Screen (continued)
Field Definition
Session Timeout (days) Enter the maximum time (in days) between required entry of Cisco
Unified Mobile Communicator passwords on end-users’ mobile
phones.
SMTP Server Configuration
Host Name Enter the hostname of your SMTP gateway. This must be the same
as your Exchange hostname if you use the Exchange server as your
SMTP gateway.
Port Enter the port number for the SMTP gateway. Usually, this is 25.
Authentication Required Identify whether or not your organization requires authentication on
the mail server. If the value for this field is True, you will need to
enter a password apart from an Admin E-mail address (see next two
fields).
Admin Email Enter the e-mail address for the administrator responsible for
management of Cisco Unified Mobility Advantage.
Cisco Unified Mobility Advantage uses this e-mail address to send
provisioning e-mails and SMS messages to end users.
SMTP Authentication Password Enter the password associated with the Admin Email address.
This field is needed only if the SMTP server requires authentication.
Step 2 Click Next.

The Server Setup screen appears.
Server Setup
The Server Setup screen allows you to choose to configure the Cisco Unified Mobility Advantage Proxy
Server and enter information about the Managed Server.
To configure the Proxy Server and then the Managed Server:
Procedure
Step 1 Choose Yes when prompted to configure a Proxy Server.
Note Although you have not yet installed the Cisco Unified Mobility Advantage Proxy Server, enter the
information you determined during the preinstallation tasks for the Proxy Server below. This information
is stored on the Admin Server and is required for the Proxy Server to start.
Step 2 Click Next.

The Proxy Server Configuration screen appears.

4-14 OL-15528-02
Step 3 Enter the information for the Proxy Server as described in Table 4-20.
Table 4-20 Proxy Server Configuration Screen
Field Definition
Host Name/IP Address Enter the hostname or IP address of the Proxy Server.
The hostname or IP address must be routable from the Internet.
Incoming Client Port Enter the port that is used for secure client-server communication.
Default is 5443.
Incoming Provisioning Port Enter the port that is used for over-the-air downloads of Cisco
Unified Mobile Communicator.
Default is 8080.
Certificate Location Enter the file name and location of the SSL Certificate for the Proxy
Server.
In most cases, use the default location:
$cuma_root/conf/orative.keystore
Certificate Password Enter the password that you assigned to the self-signed SSL
Certificate file for the Proxy Server. See Generate Keystore File and
Self-Signed Certificate for Enterprise Server, page 4-3 for more
information.
Step 4 Click Next.

The Managed Server Configuration screen appears.
Step 5 Enter the information for the Managed Server as described in Table 4-21.
Table 4-21 Managed Server Setup Screen
Field Definition
Host Name/IP Address Enter the hostname or IP address of the Managed Server.
Non SSL Client Port Enter the port that clients connect to.
Default is 5555.
SSL Client Port Enter the port that clients connect to for secure communication.
Default is 5443.
Inter-server SSL Port Enter the port used for server-to-server communications.
Default is 6443.
Step 6 Click Next.

The Server Setup Summary screen appears.
Step 7 Review the information. To change information, click Reset. Otherwise, click Next to continue the
installation.
The Handset Platform Management screen appears.

OL-15528-02 4-15
Handset Platform Management

The Handset Platform Management screen allows you to upload Cisco Unified Mobile Communicator
onto the Cisco Unified Mobility Advantage Enterprise Server.
After Cisco Unified Mobile Communicator is uploaded and the Cisco Unified Mobility Advantage
installation is complete, Cisco Unified Mobile Communicator can be installed and provisioned on
mobile phones. For more information about installing and provisioning, see the Cisco Unified Mobility
Advantage Administration Guide.
Note Cisco Unified Mobile Communicator is provided on a separate CD from Cisco Unified Mobility
Advantage, or it can be downloaded from Cisco.com. The CD or downloaded software file contains
Cisco Unified Mobile Communicator software for specific mobile phone technologies, and all of the
support information for configuring supported phones.
To upload Cisco Unified Mobile Communicator onto the Cisco Unified Mobility Advantage Enterprise
Server:
Procedure
Step 1 Browse or enter the location of the Cisco Unified Mobile Communicator software file.
Step 2 Click Next.
When the upload is successful, the Handset Platform Management Summary screen appears, displaying
the handset platforms and versions of Cisco Unified Mobile Communicator now installed on your
system.
Step 3 To change the settings, click Reset. Otherwise, click Next.
The Summary screen appears.
Summary
The Summary screen displays your Cisco Unified Mobility Advantage Enterprise Server settings.
To view summary information:
Procedure
Step 1 Review the configuration summary. Click Reset under any area to make changes to that area.
Step 2 To complete the configuration, click Finish.

4-16 OL-15528-02
Start the Managed Server
Start the Managed Server

Click No when prompted to start the Managed Server.
The next step is to complete the SSL certificate process. See “Complete the SSL Certificate Process”
section on page 4-17.
Complete the SSL Certificate Process

• Generate the Keystore File for the Proxy Server, page 4-17
• Generate the CSR for the Proxy Server, page 4-17
• Request a Signed Certificate From VeriSign, page 4-18
• Download an Intermediate Certificate from VeriSign, page 4-18
• Create Final SSL Certificate Files, page 4-19
• Upload Final Certificate on the Enterprise Server, page 4-20
Generate the Keystore File for the Proxy Server

Procedure
Step 1 Log into the Cisco Unified Mobility Advantage Admin Portal.
Step 2 Select SSL Certificate Management.
Step 3 Click Generate New Certificate.
Step 4 Enter the information for the Proxy Server.
Complete all fields. Special characters cannot be used, and the name of the state cannot be abbreviated.
Step 5 Click Submit.
The Generate Certificate Signing Request (CSR) screen appears with a hyperlink to download the
keystore file.
Step 6 Click the here link to download the keystore file. Save the file to your local computer with a descriptive
name such as cumapxy.keystore.
Generate the CSR for the Proxy Server

The following files have been generated:
• Keystore file for the Cisco Unified Mobility Advantage Enterprise Server (cumaenterprise.keystore)
• Keystore file for the Cisco Unified Mobility Advantage Proxy Server (cumapxy.keystore)
• CSR for the Cisco Unified Mobility Advantage Enterprise Server (cumaent-csr.txt)

OL-15528-02 4-17
Procedure
Step 3 Click Retrieve CSR.
Step 4 Locate and select the keystore file that was generated for the Proxy Server (cumapxy.keystore).
Step 5 Enter the password for the Proxy Server keystore file.
The Retrieve Certificate Signing Request (CSR) screen appears for the Proxy Server keystore file.
Step 7 Copy and paste the CSR into a text file.
Step 8 Save the file locally using an easily recognized name such as cumapxy-csr.txt.
Request a Signed Certificate From VeriSign

• Keystore file for the Cisco Unified Mobility Advantage Enterprise Server
(cumaenterprise.keystore)
• CSR for the Cisco Unified Mobility Advantage Proxy Server (cumapxy-csr.txt)
Procedure
Step 1 Go to the VeriSign web site (www.VeriSign.com) and purchase a signed certificate.
Step 2 Wait for the signed certificate to arrive from VeriSign.
Note This e-mail may take from a few minutes to a few days.
Step 3 After you receive the signed certificate, download an intermediate certificate from VeriSign. See
Download an Intermediate Certificate from VeriSign, page 4-18.
Download an Intermediate Certificate from VeriSign

To generate the final SSL Certificate, VeriSign requires an intermediate certificate.
Procedure
Step 1 Go to this VeriSign web site:

https://knowledge.VeriSign.com/support/ssl-certificates-support/index?page=content&id=AR657

4-18 OL-15528-02
Step 2 Click the Secure Site Certificate hyperlink.

Step 3 Copy and paste the text of the Intermediate Certificate into a text file. To properly format the certificates
in the text box, paste the certificates back-to-back: Intermediate Certificate, then Signed Certificate with
no spaces, as shown below:
~~~Intermediate~~~
4I63CYYPSAA4oH+QpNc/ftzoSJLNpQaSFdfbXddq8IsspRsPcCiVFVX9z8QvS
etc. ==
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
MIIEwDCCBCAoTDlZlcmlTaWdWfeIAdoGNs+XVGezANBgkqhkiG9w0BAQUFADCB
etc.
~~~signed~~~~
Step 4 Save the text file using a descriptive name (for example, cumaintermediate.txt).
Create Final SSL Certificate Files

• Keystore file for the Cisco Unified Mobility Advantage Enterprise Server
(cumaenterprise.keystore)
• CSR for the Cisco Unified Mobility Advantage Proxy Server (cumapxy-csr.txt)
• Signed certificate from VeriSign for the Cisco Unified Mobility Advantage Enterprise Server
• Signed certificate from VeriSign for the Cisco Unified Mobility Advantage Proxy Server
• Intermediate certificate used for both the Cisco Unified Mobility Advantage Enterprise Server and
Proxy Server (cumaintermediate.txt)
Procedure
Step 3 Click Import SSL Certificate.
Step 4 Enter the information as described in Table 4-22:
Table 4-22 Import SSL Certificate
Field Definition
Certificate File Navigate to and select the Keystore file.
Password Enter the password.

OL-15528-02 4-19
Table 4-22 Import SSL Certificate (continued)
Field Definition
Intermediate Certificate Choose False if you are importing a certificate chain that includes
an intermediate certificate. Generally, you will choose this option
for a VeriSign certificate.
Choose True to import a standalone intermediate certificate.
Certificate If you are importing a VeriSign certificate, paste the intermediate
certificate first, then the signed certificate directly below.
The first line should be ......BEGIN CERTIFICATE.....

Step 6 Download the final SSL Certificate file, giving it a descriptive name without any extension type (for
example, cumaproxy.final.keystore).
Step 7 Repeat these steps to generate a final SSL Certificate file for the Enterprise Server.
Upload Final Certificate on the Enterprise Server

Procedure
Step 3 Click Upload Certificate.
Step 4 Browse to the final SSL Certificate file for the Enterprise Server and select it.
Step 5 Enter the password for the certificate file. This is the same password that was entered for the original
keystore file.
Step 6 Select Server Controls > Cisco > Control Server.
Step 7 Stop and start the Managed Server.
Upload Final Certificate on the Proxy Server

Procedure
Step 1 Install the Cisco Unified Mobility Advantage operating system for the Proxy Server. See Proxy Server
Installation, page 5-1.
Step 2 Immediately after installing the operating system (before inserting the Cisco Unified
Mobility Advantage Application DVD), copy the final SSL Certificate file for the Proxy Server to the
root directory on the Proxy Server.

4-20 OL-15528-02
Step 3 During the installation of the Cisco Unified Mobility Advantage Proxy Server, navigate to the root
directory and select the final SSL certificate when prompted.
Step 4 If the SSL certificates were installed properly, the Cisco Unified Mobility Advantage Proxy Server starts
successfully.
If the Cisco Unified Mobility Advantage Proxy Server certificate needs to be reinstalled:
a. Log onto the Cisco Unified Mobility Advantage Proxy Server and make a backup of the current
keystore file by copying /opt/cuma/conf/orative.keystore to a backup location.
b. Stop the Proxy Server as root with the following command:
/sbin/service/cuma_proxy stop
c. Follow Steps 1 - 4 above to generate a new SSL Certificate file.
Be sure to name the final certificate orative.keystore.
d. Copy orative.keystore to the /opt/cuma/conf/ directory on the Proxy Server
Step 5 Login to the Admin Portal.
Step 6 Select Proxy Configuration > Listen Ports.
Step 7 Confirm the location and password of the keystore file on the Proxy Server. The location should be
/opt/cuma/conf/orative.keystore.
Step 8 Reboot the server, or enter the following command from the Proxy Server command line to start the
Proxy Server:
/sbin/service/cuma_proxy start

OL-15528-02 4-21

4-22 OL-15528-02
CH A P T E R 5
Proxy Server Installation
This chapter describes how to install and configure the Cisco Unified Mobility Advantage Proxy Server.
Note The server on which you install Cisco Unified Mobility Advantage will be reformatted during the
installation. We suggest using an unformatted server.
Install the Cisco Unified Mobility Advantage Proxy Server

Procedure
Step 1 Install the Cisco Unified Mobility Advantage Operating System on the server that is going to host the
Cisco Unified Mobility Advantage Proxy Server. See Install Cisco Unified Mobility Advantage
Operating System, page 3-1.
Caution Copy the final proxy certificate file to the system before you insert the Cisco Unified
Mobility Advantage application DVD. See Upload Final Certificate on the Proxy Server,
page 4-20.
Step 2 When the system displays the Cisco Application DVD page, copy the proxy certificate file to the /root
directory on the system using SSH file transfer protocol.
The credentials to copy the certificate file using SSH file transfer protocol are:
• User: root
• Password: the certificate password
The /root directory is the home directory of the root (administrative) user.
Step 3 After copying the certificate file, insert the Cisco Unified Mobility Advantage application DVD as
prompted by the Cisco Application DVD page.
Note If you downloaded the Cisco Unified Mobility Advantage ISO file from Cisco.com, use any
commercially available ISO file unpackaging program and expand the ISO file to the directory of your
choice on your local hard disk, or use any commercially available CD-ROM burner program, and burn
the file onto a CD.

OL-15528-02 5-1
Chapter 5 Proxy Server Installation
Install the Cisco Unified Mobility Advantage Proxy Server
Step 4 Click Install.
Note Wait for the Installation Wizard to start. This process may take several minutes.
Step 5 When the Installation Wizard begins, review the information on the Important screen.
Step 6 Click Next.
The License Agreement screen appears.
Step 7 Review the License information. To accept the license, click I accept the Terms of the License
Agreement, and click Next.
The Choose Install Set screen appears.
Step 8 Choose Cisco Unified Mobility Advantage Proxy as the type of installation, and click Next.
The Choose Install Folder screen appears.
Step 9 Enter or select the location where the Proxy Server software will reside, and click Next.
The default location is /opt/cuma.
The SSL Certificate and Password screen appears.
Step 10 Click Browse and locate the Proxy Server SSL Certificate file you copied to the Proxy Server.
Step 11 Enter the password associated with the certificate file, and click Next.
The Admin Server Information screen appears.
Step 12 Enter the information required for the Proxy Server to communicate with the Admin Server:
• Admin Server Host—Enter the Admin Server host name or IP address.
• Admin Server Portal Port—Enter the Admin Server http port that was specified during the Admin
Server installation. The default is 7080.
Step 13 Click Next.
The Proxy Server Configuration screen appears.
Step 14 Enter the values for the Proxy Server ports, or click Next to accept the default values.
The Pre-Installation Summary screen appears.
Step 15 Review the information in the summary screen and make sure all of the information is correct.
• If all of the information is correct, click Install.
• If any changes are required, click Previous and make the changes.
The Proxy Server installs. When complete, the Important Information screen appears.
Caution Make sure you record the location of the SSL Certificate keystore file described on this screen. When
the installation is complete, verify that this keystore file location is correct in the Admin Portal
(Proxy Configuration > Listen Ports).
Step 16 Click Next.

The Proxy Server is installed.

5-2 OL-15528-02
Verify the Proxy Server Status
Step 17 Click Reboot to restart the Proxy Server.

After the system reboots, verify that the Proxy Server is started, as described in the next section.
Verify the Proxy Server Status

To verify that the Proxy Server is started:
Procedure
Step 1 Log in to the system that is hosting the Proxy Server.

Step 3 Enter the following command in the terminal window:
/sbin/service cuma_proxy status
The status message should read: “cuma_proxy is running”.
If the Proxy Server is not running (the message reads “cuma_proxy is stopped”), start the server using
the following command:
/sbin/service cuma_proxy start
The Proxy Server starts when the “OK” message appears.
Post-Installation Tasks
After the Proxy Server installation is complete, install and provision Cisco Unified Mobile
Communicator on end users’ phones. See the Cisco Unified Mobility Advantage Administration Guide
for instructions.

OL-15528-02 5-3
Post-Installation Tasks

5-4 OL-15528-02
CH A P T E R 6
Upgrade Cisco Unified Mobility Advantage
This chapter describes how to upgrade Cisco Unified Mobility Advantage from an earlier release to
Release 3.1.2.
Caution If you are running Cisco Unified Mobility Advantage Release 3.0.4 and want to upgrade to
Release 3.1.2, you must first upgrade to Release 3.0.9. See Upgrade Release 3.0.4 to Release 3.0.9,
page 6-5. After upgrading to Release 3.0.9, upgrade to Release 3.1.2.
Upgrade Release 3.0.9 to Release 3.1.2

To upgrade Cisco Unified Mobility Advantage, upgrade the Cisco Unified Mobility Advantage
Enterprise Server and Cisco Unified Mobility Advantage Proxy Server applications only. Do not upgrade
the operating system.
• Complete Preinstallation Steps
• Install the Server
• Apply Changes
• Complete Upgrade Tasks
Complete Preinstallation Steps

Procedure
Step 1 Before you begin the upgrade, make sure you have up-to-date port configuration information for the
Cisco Unified Mobility Advantage Enterprise Server and the Cisco Unified Mobility Advantage Proxy
Server.
Step 2 Log in as root on the machine where the Proxy Server is installed.
Step 3 Open a command terminal.
Step 4 As root, stop the Proxy Server:
/sbin/service cuma_proxy stop

OL-15528-02 6-1
Chapter 6 Upgrade Cisco Unified Mobility Advantage
Step 5 Back up the orative.keystore file on the Proxy Server to a temporary location:
mkdir /tmp/cumabk
cp /opt/cuma/conf/orative.keystore /tmp/cumabk/
Step 6 Log in as root on the machine where the Cisco Unified Mobility Advantage Enterprise Server is
installed.
Step 8 Log in as an "informix" user and create a backup directory for the database export:
su - informix
mkdir /tmp/cumabk
Step 9 As root, stop the Cisco Unified Mobility Advantage Enterprise Server, Node Manager Server, and
Managed Server:
/sbin/service cuma_cuma stop
/sbin/service cuma_nm stop
/sbin/service cuma_admin stop
Step 10 Back up the configuration files located under $CUMAROOT/conf/admin/ directory.
The default $CUMAROOT is /opt/cuma. The following examples use /opt/cuma. Replace /opt/cuma
with your install directory.
cd /opt/cuma/conf
cp -R admin /tmp/cumabk/
Step 11 Back up the database startup script file /etc/init.d/cuma_db:
cp /etc/init.d/cuma_db /tmp/cumabk/
Step 12 Stop the Cisco Unified Mobility Advantage servers and take an export dump of the database by executing
the following commands as an "informix" user on the server where the database is installed:
su - informix
export INFORMIXDIR=/opt/cuma/informix
export INFORMIXSERVER=mcs
export PATH=$PATH:/opt/cuma/informix/bin
cd $INFORMIXDIR/bin
dbexport cumcsdb -ss -o /tmp/cumabk
Step 13 Back up the orative.keystore file on the Managed Server to a temporary location:
Step 14 Back up the .WAR files:
cp /opt/cuma/jboss-4.0.1sp1/server/admin/deploy/blackberry-admin.war /tmp/cumabk
cp /opt/cuma/jboss-4.0.1sp1/server/admin/deploy/symbian-admin.war /tmp/cumabk
cp /opt/cuma/jboss-4.0.1sp1/server/admin/deploy/blackberry-user.war /tmp/cumabk
cp /opt/cuma/jboss-4.0.1sp1/server/cuma/deploy/blackberry-user.war /tmp/cumabk
cp /opt/cuma/jboss-4.0.1sp1/server/cuma/deploy/symbian-user.war /tmp/cumabk

6-2 OL-15528-02
Install the Server

Procedure
Step 1 Log in as root and uninstall the Cisco Unified Mobility Advantage Enterprise Server Release 3.0.9
without uninstalling the underlying database by invoking the uninstaller program using the following
command:
/opt/cuma/Uninstall/uninstall -DIDS=false -i silent
Step 2 As root, install the Cisco Unified Mobility Advantage Enterprise Server Release 3.1.2 without
reinstalling the database:
Caution You must be running an X-client if you are installing remotely. If you need an X-client, use
WRQ Reflection.
cd $cd_image_root/Disk1
./install.bin -DIDS=false
Step 3 Restore the backed up configuration files to the new install location:
cd /tmp/cumabk
cp -R admin /opt/cuma/conf/
cp orative.keystore /opt/cuma/conf
cp cuma_db /etc/init.d/
Step 4 Restore the backed up .WAR files:
cp /tmp/cumabk/blackberry-admin.war /opt/cuma/jboss-4.0.1sp1/server/admin/deploy/
cp /tmp/cumabk/symbian-admin.war /opt/cuma/jboss-4.0.1sp1/server/admin/deploy/
cp /tmp/cumabk/blackberry-user.war /opt/cuma/jboss-4.0.1sp1/server/cuma/deploy/
cp /tmp/cumabk/symbian-user.war /opt/cuma/jboss-4.0.1sp1/server/cuma/deploy/
Step 5 Register the database so that is starts automatically, and then restart the database if it has not already
been started:
/sbin/chkconfig -add cuma_db
/sbin/service cuma_db start
Apply Changes
Procedure
Step 1 Log in as a root user on the server that is running Cisco Unified Mobility Advantage.
Step 2 Open a command terminal and edit the following file using the vi editor:
vi /opt/cuma/conf/admin/admin.xml

OL-15528-02 6-3
Step 3 Change the value of node <vm_system_email_pattern> in <voicemail_from_email_filter> for

 to:
.*?(UNITY|unity|VPIM|vpim) .*
Step 4 Add node after <move_on_delete>true</move_on_delete> in <voicemail_from_email_filter> for
:
<voice_introduction>introduction</voice_introduction>
Step 5 Open a command terminal and edit the following file using the vi editor:
vi /opt/cuma/conf/admin/managed_server.xml
Step 6 Change the value of node <vm_system_email_pattern> in <voicemail_from_email_filter> for
 to:
.*?(UNITY|unity|VPIM|vpim) .*
Step 7 --Add node after <move_on_delete>true</move_on_delete> in <voicemail_from_email_filter> for
:
<voice_introduction>introduction</voice_introduction>
Step 8 Start the Cisco Unified Mobility Advantage Admin Server and Node Manager Server. See Manage the
Servers, page A-1.
Complete Upgrade Tasks

Procedure
Step 1 Log in to the Cisco Unified Mobility Advantage Admin Portal.

For example, http://mycompany.com:7080/adminportal.
Step 2 Upload the orative.keystore file that you backed up earlier to the server.
You may need to download this file to your desktop machine first before uploading it to the server.
Step 3 Upload the Cisco Unified Mobile Communicator .OAR files in the Admin Portal. This must be done even
if there are no new .OAR files.
Step 4 Start the Managed Server.
Step 5 Uninstall Cisco Unified Mobility Advantage Release 3.0.9 from the Proxy Server, and then install
Release 3.1.2. Use the old SSL keystore file and ports that you originally used for the Proxy Server
installation.
Step 6 Make sure the Managed Server is running, and then start the Proxy Server.

6-4 OL-15528-02

To upgrade Cisco Unified Mobility Advantage from Release 3.0.4 to Release 3.0.9, upgrade the
Cisco Unified Mobility Advantage Enterprise Server and Cisco Unified Mobility Advantage Proxy
Server applications only. Do not upgrade the operating system.
• Complete Preinstallation Steps
• Install the Server
• Apply Changes
• Complete Upgrade Tasks
Complete Preinstallation Steps

Procedure
Step 1 Log in as root on the machine where Cisco Unified Mobility Advantage Enterprise Server is installed.
Step 3 Log in as an "informix" user and create a backup directory for the database export:
su - informix
mkdir /tmp/cumabk
Step 4 As root, stop the Cisco Unified Mobility Advantage servers (Proxy Server, Enterprise Server, Node
Manager Server, and Managed Server):
/sbin/service cuma_cuma stop
Step 5 Back up the configuration files located under $CUMAROOT/conf/admin/ directory.
The default $CUMAROOT is /opt/cuma. The following examples use /opt/cuma, Replace /opt/cuma
with your install directory.
cd /opt/cuma/conf
cp -R admin /tmp/cumabk/
Step 6 Back up the database startup script file /etc/init.d/cuma_db:
cp /etc/init.d/cuma_db /tmp/cumabk/
Step 7 Stop the Cisco Unified Mobility Advantage servers and take an export dump of the database by executing
the following commands as an "informix" user on the server where the database is installed:
su - informix
export INFORMIXDIR=/opt/cuma/informix
export INFORMIXSERVER=mcs
export PATH=$PATH:/opt/cuma/informix/bin
cd $INFORMIXDIR/bin
dbexport cumcsdb -ss -o /tmp/cumabk

OL-15528-02 6-5
Step 8 Back up the orative.keystore file on the Managed Server to a temporary location:
Install the Server

Procedure
Step 1 Log in as root and uninstall the Cisco Unified Mobility Advantage Enterprise Server Release 3.0.4
without uninstalling the underlying database by invoking the uninstaller program using the following
command:
/opt/cuma/Uninstall/uninstall -DIDS=false -i silent
Step 2 As root, install the Cisco Unified Mobility Advantage Enterprise Server Release 3.0.9 without
reinstalling the database:
Caution You must be running an X-client if you are installing remotely. If you need an X-client, use
WRQ Reflection.
cd $cd_image_root/Disk1
./install.bin -DIDS=false
Step 3 Restore the backed up configuration files to the new install location:
cd /tmp/cumabk
cp -R admin /opt/cuma/conf/
cp orative.keystore /opt/cuma/conf
cp cuma_db /etc/init.d/
Step 4 Register the database so that is starts automatically, and then restart the database if it has not already
been started:
/sbin/chkconfig -add cuma_db
/sbin/service cuma_db start
Apply Changes
Procedure
Step 1 Copy the jtapi jar file that corresponds to the version of Cisco Unified Communications Manager
(CallManager) installed in your system to the lib directory on the Managed Server.
The following example is for Cisco Unified Communications Manager version 6.0:
cp /opt/cuma/var/jtapi/6/cisco_jtapi-6.jar /opt/cuma/jboss-4.0.1sp1/server/cuma/lib/

6-6 OL-15528-02
Step 2 Start the Cisco Unified Mobility Advantage Admin Server and Node Manager Server. See Manage the
Servers, page A-1.
Complete Upgrade Tasks

Procedure
Step 1 Log in to the Cisco Unified Mobility Advantage Admin Portal.

For example, http://mycompany.com:7080/adminportal.
Step 2 Upload the orative.keystore file that you backed up earlier to the server.
You may need to download this file to your desktop machine first before uploading it to the server.
Step 3 Upload the Cisco Unified Mobile Communicator .OAR files in the Admin Portal. This must be done even
if there are no new .OAR files.
Step 4 Start the Managed Server.
Step 5 Uninstall Cisco Unified Mobility Advantage Release 3.0.4 from the Proxy Server, and then install
Release 3.0.9. Use the old SSL keystore file and ports that you originally used for the Proxy Server
installation.
Step 6 Make sure the Managed Server is running, and then start the Proxy Server.

OL-15528-02 6-7

6-8 OL-15528-02
A P P E N D I X A
Maintenance
This appendix describes how to manage the Cisco Unified Mobility Advantage servers, and uninstall
Cisco Unified Mobility Advantage.
Manage the Servers

This section describes the process for starting or stopping Cisco Unified Mobility Advantage servers.
For more information about managing the servers, see the Cisco Unified Mobility Advantage
Administration Guide.
Start Sequence for Cisco Unified Mobility Advantage Servers

Cisco Unified Mobility Advantage servers must be started in this sequence:
1. Admin Server—The Admin Server is responsible for starting and stopping the Managed Server.
2. Node Manager Server—The Admin Server starts the Managed Server with a command to the Node
Manager Server.
3. Managed Server—After the Admin Server is able to request the Node Manager to start the Managed
Server, and the Node Manager server has been started (so that it can carry out the request), the
Managed Server can be started.
4. Proxy Server—After the other servers are started, the Proxy Server can be started.
Stop Sequence for Cisco Unified Mobility Advantage Server

Cisco Unified Mobility Advantage servers must be stopped in this sequence:
1. Proxy Server
2. Managed Server
3. Node Manager Server
4. Admin Server

OL-15528-02 A-1
Appendix A Maintenance
Manage the Servers
Start or Stop the Admin Server

Do not stop the Admin Server until all other servers are stopped. See Stop Sequence for Cisco Unified
Mobility Advantage Server, page A-1 for the proper sequence for stopping Cisco Unified Mobility
Advantage servers.
To start or stop the Admin Server, follow the steps in Table A-1.
Table A-1 Start or Stop the Admin Server
Action Procedure
Start the Admin Server 1. Log in as root to the system that is hosting the Admin Server.
2. Open a new command terminal.
3. Enter this command in the terminal:
/sbin/service cuma_admin start
The Admin Server starts when the “OK” message appears.
Stop the Admin Server 1. Follow steps 1-2 above.
2. Enter this command in the terminal window:
The Admin Server stops when the “OK” message appears.
Start or Stop the Node Manager Server

Do not stop the Node Manager Server until the Proxy Server and Managed Server are stopped. See Stop
Sequence for Cisco Unified Mobility Advantage Server, page A-1 for the proper sequence for stopping
Cisco Unified Mobility Advantage servers.
To start or stop the Node Manager Server, follow the steps in Table A-2.
Table A-2 Start or Stop the Node Manager Server
Action Procedure
Start the Node Manager Server 1. Log in as root to the system that is hosting the Node Manager
Server.
/sbin/service cuma_nm start
The Node Manager Server starts when the “OK” message
appears.
Stop the Node Manager Server 1. Follow steps 1-2 above.
The Node Manager Server stops when the “OK” message
appears.

A-2 OL-15528-02
Manage the Servers
Start or Stop the Managed Server

Do not stop the Managed Server until the Proxy Server is stopped. See Stop Sequence for Cisco Unified
Mobility Advantage Server, page A-1 for the proper sequence for stopping Cisco Unified Mobility
Advantage servers.
To start or stop the Managed Server, follow the steps in Table A-3.
Table A-3 Start or Stop the Managed Server
Action Instructions
Start the Managed Server 1. Log in to the Cisco Unified Mobility Advantage Admin Portal.
2. Select Server Controls.
3. Select Control Server under Cisco.
4. Select Start next to Change Status.
The Managed Server starts when Server Status changes to
Running.
Stop the Managed Server 1. Follow steps 1-3 above.
2. Select Stop next to Change Status.
The Managed Server starts when Server Status changes to
Not Running.
Start or Stop the Proxy Server

To start or stop the Proxy Server, follow the steps in Table A-4.
Table A-4 Start or Stop the Proxy Server
Action Instructions
Start the Proxy Server 1. Log in as root to the system that is hosting the Proxy Server.
/sbin/service cuma_proxy start
The Proxy Server starts when the “OK” message appears.
Stop the Proxy Server 1. Follow steps 1-2 above.
The Proxy Server stops when the “OK” message appears.

OL-15528-02 A-3
Uninstall Cisco Unified Mobility Advantage
Uninstall Cisco Unified Mobility Advantage

Warning Removing Cisco Unified Mobility Advantage removes installer files and database and configuration
information.
The following instructions execute a standard graphical uninstaller program. To remove Cisco Unified
Mobility Advantage without using the graphical uninstaller program, add the following parameter to the
uninstall command: -i silent. (For example, $cuma_root/Uninstall/uninstall -i silent).
To uninstall Cisco Unified Mobility Advantage:
Procedure
Step 1 Make sure all Cisco Unified Mobility Advantage servers are stopped.
Step 2 Log in to the system that is hosting Cisco Unified Mobility Advantage.
Step 3 Open a new command terminal.
Step 4 Enter this command where $cuma_root is the install directory:
$cuma_root/Uninstall/uninstall
For example, if Cisco Unified Mobility Advantage is installed in /opt/cuma, enter:
/opt/cuma/Uninstall/uninstall
When Cisco Unified Mobility Advantage is removed, some files may remain. These include log files that
are created after installation. To remove these files, delete the install directory after uninstalling the
software.

A-4 OL-15528-02
A P P E N D I X B
SSL Certificate Process
This appendix provides additional information for installing SSL Certificates on

Cisco Unified Mobility Advantage release 3.1.2.
• Understanding the Terminology, page B-1
• Understanding the Process, page B-2
Understanding the Terminology

These terms are used in the SSL certificate installation process.
Table B-1 SSL Certificate Terminology
Field Definition
Keystore File File generated by the Cisco Unified Mobility Advantage Administrator
from the Cisco Unified Mobility Advantage Admin Portal. This file
requires organizational, location and password information. This file
contains the private key generated using the Admin Portal and can
optionally contain certificates issued by certificate authorities and any
certificate chains.
Certificate Signing Request File generated using the Keystore file and is copied into an online form
(CSR) at the VeriSign web site as part of the certificate generation process.
Intermediate Certificate File that is downloaded from the VeriSign web site. VeriSign requires that
all SSL certificate installations utilize an intermediate certificate.
Signed Certificate Certificate received in an e-mail from VeriSign after you have submitted
a CSR.
Final Certificate Certificate that is loaded onto the server that enables SSL security. It is
created from the Keystore, Intermediate and Signed Certificate files.

OL-15528-02 B-1
Appendix B SSL Certificate Process
Understanding the Process

The entire SSL certificate process is completed in two parts:
• Part 1 is completed during the Configuration Wizard and consists of these steps:
– Gather Required Information, page 4-2
– Generate Keystore File and Self-Signed Certificate for Enterprise Server, page 4-3
• Part 2 is completed after the Configuration Wizard and consists of these steps (see Complete the SSL
Certificate Process, page 4-17):
– Generate the Keystore File for the Proxy Server, page 4-17
– Generate the CSR for the Proxy Server, page 4-17
– Request a Signed Certificate From VeriSign, page 4-18
– Download an Intermediate Certificate from VeriSign, page 4-18
– Create Final SSL Certificate Files, page 4-19
– Upload Final Certificate on the Enterprise Server, page 4-20
– Upload Final Certificate on the Proxy Server, page 4-20
Part 1 Overview
This figure shows how SSL certificate terms relate to the options that appear during the first part of the
process (running the Configuration Wizard).

B-2 OL-15528-02
Part 2 Overview
This figure shows how SSL certificate terms relate to the options that appear during the second part of
the process (running the Admin Portal after installation and configuration is complete).

OL-15528-02 B-3

B-4 OL-15528-02
A P P E N D I X C
Troubleshooting and FAQs
• Obtaining Log Files, page C-1

• Solving Installation Problems, page C-2
• Solving Problems with Cisco Unified Mobile Communicator, page C-3
• FAQs, page C-3
Obtaining Log Files

You can view the log file associated with the Cisco Unified Mobility Advantage Admin server,
Node Manager server, or Managed Server to assist with troubleshooting issues.
Procedure
Step 1 Use a tool such as PuTTY to SSH to the Cisco Unified Mobility Advantage server as the platform
administrator using the login name and password you entered during the installation.
Step 2 Use the command line interface (CLI) to enter the file list command to see the list of available log files.
For This Server Use This Command

Admin server (runs the Admin Portal) file list admin *
Node Manager server file list node_manager *
Managed server file list cuma *
Cisco Unified Mobility Advantage Administration Guide

OL-15528-02 C-1
Appendix C Troubleshooting and FAQs
Solving Installation Problems
Step 3 View a log file:
To For This Server Use This Command

Download a log file Admin Server file get admin * admin.log
(You must use SFTP) Node Manager Server file get node_manager node_manager.log
Managed Server file get cuma cuma.log
Tail a log file Admin Server file tail admin admin.log
(View the last few lines Node Manager Server file tail node_manager node_manager.log
of a log file in real time) Managed Server file tail cuma cuma.log
End the tail All Press Control-C
(Stop viewing the tail)
Step 4 Search in the log file for exception until you find an exception associated with a keyword that indicates
the source of the problem.
Solving Installation Problems

• All Problems, page C-2
• Cisco Unified Mobility Advantage Enterprise Server Does Not Start, page C-2
All Problems
Problem All problems.
Solution Check the log files for errors. To find relevant information in the logs, search for “exception”
until you find one with a keyword that may be related to the problem you are experiencing. See Obtaining
Log Files, page C-1.
Cisco Unified Mobility Advantage Enterprise Server Does Not Start

Problem The Cisco Unified Mobility Advantage Enterprise Server does not start (the server status
changes from “Stopped” to “Starting” to “Stopped”).
Possible Cause The Cisco Unified Mobility Advantage Enterprise Server is unable to connect to
Active Directory. The most likely cause is a bad LDAP path or password for the read-only account.
It may also be a basic connectivity issue.
Solution Verify server address and port number. Obtain an LDAP browser and attempt to connect to the
OU using the same credentials.

C-2 OL-15528-02
Solving Problems with Cisco Unified Mobile Communicator
Solving Problems with Cisco Unified Mobile Communicator

See the Cisco Unified Mobility Advantage Administration Guide for troubleshooting information related
to user activation, installation, and Mobile Communicator problems.
FAQs
• Cisco Unified Mobility Advantage FAQs, page C-3
• Cisco Unified Mobile Communicator FAQs, page C-5
Cisco Unified Mobility Advantage FAQs

Q. How many users does the Cisco Unified Mobility Advantage server support? How many mobile
clients can attach to the Cisco Unified Mobility Advantage server?
A. The server supports up to 1,000 simultaneous users.
Q. Can Cisco Unified Mobility Advantage servers be clustered together?

A. No, Cisco Unified Mobility Advantage does not support redundancy or clustering capabilities in this
release.
Q. How many Cisco Unified Mobility Advantage servers can be attached to a Cisco Unified
Communications Manager cluster?
A. The Cisco Unified Mobility Advantage server can attach to a single Cisco Unified
Communications Manager cluster.
Q. Can Cisco Unified Mobility Advantage be deployed co-resident with

Cisco Unified Communications Manager or Cisco Unified Mobility?
A. Cisco Unified Mobility Advantage cannot be deployed co-resident with
Cisco Unified Communications Manager. For systems with Cisco Mobility Manager 4.x or 5.x
deployed on an external server (that is, earlier versions of Cisco Unified Mobility),
Cisco Unified Mobility Advantage may be deployed co-resident with Cisco Mobility Manager.
Q. Is the proxy server required?

A. Yes, the proxy server is required.
Q. Does Cisco Unified Mobility Advantage integrate with:

• Cisco Unified Presence?
• Cisco Unity Connection?
A. No, Cisco Unified Mobility Advantage does not integrate with the above systems in this release.

OL-15528-02 C-3
FAQs
Q. Is Cisco Unified Mobility Advantage compatible with:

• Cisco Unified Communications Manager Express?
• IBM Lotus Domino or Lotus Notes?
• Third-party IP-telephony systems?
• Third-party voice mail systems?
A. No, Cisco Unified Mobility Advantage is not compatible with the above systems in this release.
Q. I have users spread across various Exchange servers, do I have to configure them all on
Cisco Unified Mobility Advantage?
A. Yes, you must add and configure one Exchange adapter for each Exchange server.
Q. What version of MeetingPlace Express is supported?

A. MeetingPlace Express version 1.2 or higher. Cisco Unified Mobility Advantage does not rely on
MeetingPlace to send calendar notifications; instead, it scans a user's calendar in Exchange, looks
for a special MeetingPlace attribute, and, if found, sends an alert to Mobile Communicator.
Q. Is Cisco Unified Mobility Advantage supported with VMWare?

A. No, VMWare is not supported in this release.
Q. Is the Cisco Unified Mobility Advantage system secure?

A. Yes, Cisco Unified Mobility Advantage runs in the corporate data center securely behind the
firewall. Cisco Unified Mobile Communicator also utilizes robust security mechanisms such as
single sign on (SSO) authentication and SSL-based encryption to provide end-to-end protection for
both the user data and the corporate network. Other security mechanisms include administrative
capabilities that allow an IT manager to wipe out data on a remote handset in case a mobile phone
is ever lost or stolen.
Q. Does Cisco Unified Mobility Advantage support logging?

A. Yes, logs are available for message and communications traffic from the Cisco Unified
Mobility Advantage server. Third-party reporting tools are recommended for analysis and reporting.
Q. How long are text messages retained on the Cisco Unified Mobility Advantage server?
A. The Cisco Unified Mobility Advantage server keeps the complete text message along with its header
info (date, time, sender) in its database until the user deletes the message in Mobile Communicator.
Q. How do I configure the Active Directory adapter to bulk activate a large group of users present in
different Active Directory OUs?
A. In the search base of the Active Directory adapter, specify the parent of all the OUs, or add as many
Active Directory adapters as the number of OUs from which you are planning to activate users.

C-4 OL-15528-02
FAQs
Cisco Unified Mobile Communicator FAQs

Q. Where can I download Cisco Unified Mobile Communicator?
A. http://www.cisco.com/cgi-bin/tablebuild.pl/CUMC
Search under Unified Communications Applications.
Q. Where can I go to get information about Mobile Communicator?

A. http://www.cisco.com/en/US/products/ps7271/index.html
Q. Where are the user guides located?

A. http://www.cisco.com/en/US/products/ps7271/products_user_guide_list.html
Q. Where can I get information about handset and mobile operator support?
A. http://www.cisco.com/web/partners/downloads/partner/WWChannels/technology/ipc/downloads/
CUMC_Mobile_Operator_Support_Guide.pdf
A Cisco.com login ID is required to access this guide.
Q. Which mobile operating systems are supported by Cisco Unified Mobile Communicator?
A. Cisco Unified Mobile Communicator supports Symbian OS version 9.1 (S60 3rd Edition) mobile
phones and recent BlackBerry (8700 series or newer) devices running Java. Future releases will
support Microsoft Windows Mobile Standard Edition.
Q. Do employees need to use the same service provider?

A. No, Mobile Communicator supports multiple mobile service providers simultaneously.
Q. What type of wireless data plan is required?

A. Mobile Communicator requires that packet data service is enabled on the mobile phone. This allows
standard Internet Protocol service across the operator’s data network. Cisco recommends that users
subscribe to "unlimited" data service when available.
Q. How does Cisco Unified Mobile Communicator get deployed on a handset?

A. Cisco Unified Mobile Communicator is provisioned to the user handset from the User Portal.
Depending upon the type of handset, the Mobile Communicator software may be downloaded to the
handset using over-the-air methods or by using a data cable, Bluetooth or infrared technology. Once
installed on the handset, the configuration settings and preferences for a user are sent to
Mobile Communicator from the User Portal.
Q. Can a user have multiple mobile phones with Cisco Unified Mobile Communicator?
A. Yes, Mobile Communicator supports multiple mobile phones per user. These can be on the same or
different mobile operators.
Q. Does Cisco Unified Mobile Communicator work internationally?

A. Yes, users can travel internationally with Mobile Communicator. However, users must have packet
data service in the country into which they travel. Users should also be aware that data roaming
tariffs can vary widely between countries. Refer to the relevant support documentation section on
Cisco.com for specific compatibility information and currently supported mobile phones.

OL-15528-02 C-5
FAQs
Q. How can users download personal and corporate contacts and phone numbers to
Mobile Communicator?
A. Identify and select personal and corporate contacts from the Mobile Communicator User Portal.
These contacts are automatically synchronized with the Mobile Communicator Directory.
Q. How does the Directory access personal contacts?

A. Mobile Communicator accesses personal contact information from contacts stored in Outlook using
secure integration with Microsoft Exchange.
Q. Can users access contacts who are not currently on the mobile phone?
A. Yes, Mobile Communicator provides a remote search capability that allows users to access both
personal and corporate contacts from the mobile phone. Once the search is complete, users can call
or send a message to the person, or add the contact information to the Mobile Communicator
Directory.

C-6 OL-15528-02
INDEX
A Cisco Unified Mobility Advantage

Operating System, installation 3-1
Admin Portal, logging in to 4-1 Cisco Unified Mobility Advantage Proxy Server
Admin Server 1-1 1-1
ports 2-9 installation 5-1
starting A-2 starting 5-3, A-3
stopping A-2 Cisco Unified Mobility Advantage servers
architecture, Cisco Unified Mobility Advantage starting A-1
1-1, 1-2 stopping A-1
communication ports, determining 2-8
components, Cisco Unified Mobility Advantage
B 1-1
conferencing system, requirement 2-2
BlackBerry Enterprise Server Configuration Wizard, starting 4-1
configuring 2-3 corporate directory, requirement 2-2
requirement 2-2 corporate IP PBX, requirement 2-2
browser requirements 2-2
E
C
e-mail/groupware, requirement 2-2
Cisco Media Convergence Server(s) 2-1 Enterprise Server
Cisco Unified CallManager, requirement 2-2 configuration 4-1
Cisco Unified Communications Manager installation 3-3
preinstallation settings 2-6, 6-6 enterprise services, obtaining information 2-4
requirement 2-2 enterprise services, requirements 2-2
Cisco Unified Mobile Communicator 1-3
components 1-1 F
installing 3-3
uninstalling A-4 firewall ports, determining 2-12
upgrading 6-1
Cisco Unified Mobility Advantage Enterprise Serv-
er H
components 1-1
configuration 4-1 hardware, required platforms 1-2
installation 3-3

OL-15528-02 IN-1
Index
I ports 2-11
starting A-3
installation stopping A-3
Enterprise Server 3-3
Operating System 3-1
overview 1-4 R
Proxy Server 5-1
required platforms 1-2
requirements
M browser 2-2
enterprise services 2-2, 2-4
Managed Server 1-1
ports 2-8
starting A-3 S
stopping A-3
mobile data network service providers, overview service providers, mobile data network 1-3
1-3 SSL Certificates
overview 4-2
process overview B-1
N requirements 4-2
start servers A-1
Node Manager Server 1-1 stop servers A-1
ports 2-10
starting A-2
stopping A-2 U
uninstalling Cisco Unified Mobility Advantage A-4

O upgrading Cisco Unified Mobility Advantage 6-1
Operating System, installation 3-1

overview, Cisco Unified Mobility Advantage 1-1 V
overview, installation 1-4
voicemail system, requirement 2-2
ports
Admin Server 2-9
Managed Server 2-8
Node Manager Server 2-10
Proxy Server 2-11
ports, communication and firewall 2-8
preinstallation tasks 2-1
Proxy Server
installation 5-1

IN-2 OL-15528-02

Cisco Unified Mobility Advantage Installation and Upgrade Guide

Hochgeladen von

Dokumentinformationen

Originalbeschreibung:

Originaltitel

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Cisco Unified Mobility Advantage Installation and Upgrade Guide

Hochgeladen von

Copyright:

Verfügbare Formate

Cisco Unified Mobility Advantage

Installation and Upgrade Guide

Revised Date: April 10, 2009

Text Part Number: OL-15528-02