Cisco Unity Connection User Manual
Install, Upgrade, and Maintenance Guide
for Cisco Unity Connection
Release 10.x
Published November, 2014
Cisco Systems, Inc.
www.cisco.com
Cisco has more than 200 offices worldwide.
Addresses, phone numbers, and fax numbers
are listed on the Cisco website at
www.cisco.com/go/offices.
Text Part Number:
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.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this
URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned 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. (1110R)
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
© 2014 Cisco Systems, Inc. All rights reserved.
CONTENTS
1
Preface i
Audience and Use i
Documentation Conventions i
Cisco Unity Connection Documentation ii
Obtaining Documentation and Submitting a Service Request ii
Cisco Business Edition References in Documentation ii
Cisco Product Security Overview iii
CHAPTER
1 Installing Cisco Unity Connection 1-1
Methods of Installation 1-1
Important Considerations for Installation 1-2
Pre-Installation Tasks 1-2
Creating a Virtual Machine 1-3
Changing the Boot Order of Virtual Machine 1-4
Verifying DNS Settings 1-4
Gathering Information for Installation 1-4
Installation Scenarios 1-10
Installation Tasks 1-10
Navigating Within the Installation Wizard 1-11
Installing the Publisher Server 1-11
Configuring Subscriber Server on the Publisher Server 1-14
Installing the Subscriber Server 1-14
Generating Answer File for Unattended Installation 1-15
Task List for Creating Answer File and Floppy Image 1-15
Touchless Installation for Virtual Machine 1-17
Methods for Touchless Installation 1-17
Applying a Patch 1-18
Verifying the Installation 1-21
Cisco Unity Connection Survivable Remote Site Voicemail Installation 1-22
Post-Installation Tasks 1-22
Troubleshooting Installation Issues 1-23
Text Part Number:
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
1
Contents
CHAPTER
CHAPTER
2 Backing Up and Restoring Cisco Unity Connection Components 2-1
About COBRAS 2-1
About Disaster Recovery System 2-1
Components Supported for DRS Backup 2-2
Backup Files in DRS 2-2
Configuring DRS Backup 2-3
Configuring a Backup Schedule 2-4
Configuring a Manual Backup 2-5
Viewing the Backup Status 2-5
Viewing the Backup History 2-5
Configuring DRS Restore 2-6
Viewing the Restore Status 2-7
Viewing the Restore History 2-8
3 Upgrading Cisco Unity Connection 3-1
Upgrade Types 3-1
Status of Unity Connection Cluster During L2 Upgrade 3-3
Status of Unity Connection Cluster During RU 3-3
CHAPTER
Duration of Upgrade 3-4
Prerequisites for Upgrade 3-4
Task list to Upgrade to Unity Connection Shipping Version 10.x 3-5
Upgrading the Unity Connection Server 3-7
Switching to the Upgraded Version of Unity Connection Software 3-8
Applying COP file from a Network Location 3-8
Rollback of Unity Connection 3-9
Important Considerations for Rollback 3-9
Rollback Scenarios 3-10
4 Configuring Cisco Unity Connection Cluster 4-1
Task List for Configuring a Unity Connection Cluster 4-1
Administering a Unity Connection Cluster 4-2
Checking the Cluster Status 4-2
Managing Messaging Ports in a Cluster 4-2
Stopping All Ports from Taking New Calls 4-4
Restarting All Ports to Take Calls 4-5
Server Status and its Functions in a Unity Connection Cluster 4-5
Changing Server Status in a Cluster and its Effects 4-7
Manually Changing the Server Status from Secondary to Primary 4-7
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
2
Manually Changing from the Server Status from Secondary to Deactivated 4-8
Manually Activating a Server with Deactivated Status 4-8
Effect on Calls in Progress When Server Status Changes in a Unity Connection Cluster 4-9
Effect on Unity Connection Web Applications When the Server Status Changes 4-9
Effect of Stopping a Critical Service on a Unity Connection Cluster 4-10
Shutting Down a Server in a Cluster 4-10
Replacing Servers in a Cluster 4-11
Understanding Cluster in Detail 4-11
How a Unity Connection Cluster Works 4-12
Effects of Split Brain Condition in a Unity Connection Cluster 4-13
Contents
CHAPTER
5 Maintaining Cisco Unity Connection Server 5-1
Migrating a Physical Server to a Virtual Machine 5-1
Replacing a Publisher Server 5-2
Replacing a Subscriber Server 5-3
Migrating from Cisco Unity 4.x and Later to Unity Connection 7.x and Later 5-4
Replacing the Non-Functional Server 5-5
Changing the IP Address or Hostname of a Unity Connection Server 5-6
Determine Whether Unity Connection is Defined by Hostname or IP Address 5-6
Important Considerations before Changing the Hostname or IP Address of a Unity Connection
Server
5-7
Changing the IP Address or Hostname of a Unity Connection Server or Cluster 5-8
Adding or Removing Unity Connection Languages 5-9
Task List for Adding Languages to a Standalone Unity Connection Server 5-9
Installing Unity Connection Language Files 5-10
Installing Unity Connection Language Files from a Disk 5-11
Installing Unity Connection Language Files from Network Location or Remote Server 5-11
Removing Unity Connection Language Files 5-13
CHAPTER
6 Managing Licenses 6-1
Installing Licenses on the PLM server 6-1
Status of Licenses 6-1
Licenses in Unity Connection Cluster 6-2
Migrating Licenses 6-2
Migrating Licenses from Cisco Unity 6-3
Migrating Licenses from Unity Connection 8.6 and Earlier Releases 6-3
Using COBRAS Tool 6-3
Using Upgrade Process 6-4
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
3
Contents
Viewing Reports for Licenses 6-4
Viewing the License Usage 6-4
Viewing the Last Connectivity Time with the PLM Server 6-5
Viewing the Hostname or IP Address of the Connected PLM Server 6-5
Viewing the Last Compliance Time 6-5
License Parameters for Unity Connection Features 6-5
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
4
Preface
Audience and Use
The Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x explains the
installation or upgrade scenarios of Cisco Unity Connection in various supported deployments. This
guide also covers the steps for different migration scenarios, such as migrating a Cisco Unity server to
a Unity Connection server and migrating a Unity Connection server running on a physical server to a
virtual machine. In addition, this guide explains the procedure to take backup of a Unity Connection
server using the supported tools.
Documentation Conventions
Table 1 Conventions in the Installation, Upgrade, and Maintenance Guide for Cisco Unity
Connection
Convention Description
boldfaced text Boldfaced text is used for:
< >
(angle brackets)
(hyphen)
>
(right angle
bracket)
• Key and button names. (Example: Select OK.)
• Information that you enter. (Example: Enter Administrator in the Username
box.)
Angle brackets are used around parameters for which you supply a value.
(Example: In your browser, go to https://<Cisco Unity Connection server IP
address>/cuadmin.)
Hyphens separate keys that must be pressed simultaneously. (Example: Press
Ctrl-Alt-Delete.)
A right angle bracket is used to separate selections that you make on menus.
(Example: On the Windows Start menu, select Settings > Control Panel > Phone
and Modem Options.)
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
i
The Installation, Upgrade, and Maintenance Guide for Cisco Unity Connection also uses the following
conventions:
Note Means reader take note. Notes contain helpful suggestions or references to material not covered in the
document.
Caution Means reader be careful. In this situation, you might do something that could result in equipment damage
or loss of data.
Warning
Means reader be warned. In this situation, you might perform an action that could result in
bodily injury.
(For translations of safety warnings listed in this guide, see Regulatory Compliance and Safety
Information for Cisco Unity Connection at
http://www.cisco.com/en/US/docs/voice_ip_comm/connection/regulatory/compliance/ucwarns.html.)
Cisco Unity Connection Documentation
For descriptions and URLs of Unity Connection documentation on Cisco.com, see the Documentation
Guide for Cisco Unity Connection Release 10.x. The document is shipped with Unity Connection
Release 10.x, available at
http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/roadmap/10xcucdg.html.
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional
information, see the monthly What’s New in Cisco Product Documentation, which also lists all new and
revised Cisco technical documentation, at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the What’s New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed
and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free
service and Cisco currently supports RSS Version 2.0.
Cisco Business Edition References in Documentation
In Unity Connection 10.x documentation set, all the references to “Cisco Business Edition” apply on
Business Edition 6000/7000 only. The references do not apply on any other Business Editions.
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
ii
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. 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.
Further information regarding U.S. export regulations may be found at
http://www.access.gpo.gov/bis/ear/ear_data.html.
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
iii
iv
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
Installing Cisco Unity Connection
Cisco Unity Connection can be deployed in either of the following ways:
• Standalone Deployment: Involves the installation of a Unity Connection as a single server.
• Cluster Deployment: Involves the installation of same version of two Unity Connection servers in
an active-active or high availability mode. During the installation of Unity Connection as a cluster,
the first server is referred to as publisher server and the second server as the subscriber server. For
more information on cluster configuration, see the Configuring Cisco Unity Connection Cluster
chapter.
Note Unity Connection 10.0(1) and later releases can only be installed on virtual machines. For more
information, see the http://docwiki.cisco.com/wiki/Virtualization_for_Cisco_Unity_Connection.
Methods of Installation
CHA P T ER
1
You can use either of the following methods to install standalone or cluster server:
• Standard Installation: Allows you to manually specify the installation information, such as
hostname and IP address using installation wizard.
• Unattended Installation: Allows you to install Unity Connection using an installation disk and a
pre-configured answer file floppy diskette. The answer file has all the information required for
unattended installation. With Unity Connection 10.5(2) release, a seamless process of installation
has been introduced, which allows you to start installation on both the publisher and subscriber
servers simultaneously. The subscriber installation continues when the publisher is successfully
installed. This type of unattended installation is Touchless Installation. For more information on
Touchless Installation, see the Touchless Installation for Virtual Machine, page 1-18.
Note • You can also perform fresh installation of Unity Connection10.x and later using Cisco Prime
Collaboration Deployment. For more information on Cisco PCD, see
http://www.cisco.com/c/en/us/products/cloud-systems-management/prime-collaboration/index.htm
l.
• The answer file supports only fresh installs and does not support upgrades.
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
1-1
Important Considerations for Installation
Important Considerations for Installation
Before you proceed with the installation, consider the following points:
• Verify the system requirements, such as licensing and phone integration requirements necessary for
the Unity Connection server in the System Requirements for Cisco Unity Connection guide at
http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/10x/requirements/10xcucsysreq
s.html.
• Be aware that when you install on an existing Unity Connection server, the hard drive gets formatted
and all existing data on the drive gets overwritten.
• Ensure that you connect each Unity Connection server to an uninterruptible power supply (UPS) to
provide power backup and protect your system. Failure to do so may result in damage to physical
media and require a new installation.
• For a Unity Connection cluster:
–
Install the Unity Connection software first on the publisher server and then on the subscriber
server (applicable to only standard installation scenarios). For more information on installation
scenarios, see Installation Scenarios.
–
Note down the Security password that you mention at the time of installing publisher server.
You need to specify the same password when installing the subscriber server in a cluster.
–
Do not run Network Address Translation (NAT) or Port Address Translation (PAT) between the
publisher and subscriber servers.
• Verify that DNS server is properly configured before installing Unity Connection. For more
information, see the “Verifying DNS Settings” section on page 1-5.
Chapter 1 Installing Cisco Unity Connection
• Do not perform any configuration changes during the installation.
• Be aware that the directory names and filenames that you enter during the installation are
case-sensitive.
Pre-Installation Tasks
Before installing a Unity Connection server, you need to understand all the pre-installation steps as well.
The Table 1-1 contains a list of pre-installation tasks that you must consider to ensure successful
installation of Unity Connection server.
Table 1-1 Pre-Installation Tasks
Task Important Notes
Step 1
Step 2
Step 3
Ensure that your servers are listed as supported hardware and
sized appropriately to support the load of the cluster.
Create the virtual machine using the correct OVA template. For more information, see the Creating a Virtual
Change the boot order of the virtual machine to update the
BIOS settings.
For information about the capacity of server models,
see the link
http://docwiki.cisco.com/wiki/Virtualization_for_Ci
sco_Unity_Connection.
Machine, page 1-3 section.
For more information, see the Changing the Boot
Order of Virtual Machine, page 1-4 section.
1-2
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
Chapter 1 Installing Cisco Unity Connection
Table 1-1 Pre-Installation Tasks
Task Important Notes
Step 4
Configure an external NTP server during a Unity Connection
server installation.
For a Unity Connection cluster, the NTP server helps to
synchronize time between publisher and subscriber server.
Ensure the external NTP server is stratum 9 or higher
(meaning stratums 1-9). The subscriber server will get its
time from the publisher server.
To verify the NTP status of the publisher server, log into the
Command Line Interface on the publisher server and enter
the following command:
utils ntp status
Step 5
Record the network interface card (NIC) speed and duplex
settings of the switch port that connects to the new server.
Step 6
Record the configurations settings for each server that you
plan to install.
Step 7
Download the signed .iso file of required Unity Connection
version from Cisco.com.Upload it on a data store or burn a
disk image of the downloaded software.
Pre-Installation Tasks
For more information, see the Command Line
Interface Reference Guide for Cisco Unified
Solutions for the latest release, available at
http://www.cisco.com/c/en/us/support/unified-comm
unications/unity-connection/products-maintenance-g
uides-list.html.
Caution If the publisher server fails to synchronize
with an NTP server, installation of a
subscriber server can also fail.
Enable PortFast on all switch ports that are connected
to Cisco servers. With PortFast enabled, the switch
immediately brings a port from the blocking state into
the forwarding state by eliminating the forwarding
delay [the amount of time that a port waits before
changing from its Spanning-Tree Protocol (STP)
learning and listening states to the forwarding state].
To record your configuration settings, see the
Gathering Information for Installation, page 1-5
section.
Download from the given link:
http://software.cisco.com/download/navigator.html?
mdfid=280082558&i=rm.
Creating a Virtual Machine
To download the OVA template for creating virtual machines, open the following link, select Unity
Connection Software, and then select the appropriate release number:
http://software.cisco.com/download/type.html?mdfid=283062758&flowid=45673.
To Create a Virtual Machine:
Step 1 To deploy the OVA template in a supported VMware client, from the File menu, select Deploy OVA
template.
Step 2 Next, browse the OVA template from the URL or file location on the system.
Step 3 Follow on-screen instructions to create the virtual machine.
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
1-3
Pre-Installation Tasks
Changing the Boot Order of Virtual Machine
To Change the Boot Order of the Unity Connection Virtual Machine
Step 1 In VMware client, power off the virtual machine that has the deployed OVA template.
Step 2 In the left pane of VMware client, right-click the name of the virtual machine, and select Edit Settings.
Step 3 In the Virtual Machine Properties dialog box, select the Options tab.
Step 4 In the Settings column, from the Advanced menu, select Boot Options.
Step 5 In the Force BIOS Setup, check the The next time the virtual machine boots, force entry into the
BIOS setup screen. check box.
Step 6 Select OK to close the Virtual Machine Properties dialog box.
Step 7 Power on the virtual machine.
The virtual machine will boot into the BIOS menu.
Step 8 Navigate to the Boot menu and change the boot device order so the CD-ROM device is listed first and
the Hard Drive device is listed second.
Step 9 Save the change and exit BIOS setup.
Chapter 1 Installing Cisco Unity Connection
Changing Reservation on Virtual Machines Running with E7 or E5440 Processors
Added February, 2015
The CPU reservations are now included in OVAs, which are based on the Xeon 7500 processor. If the
customer wants to run virtual machine on the E7 or E5440 processor, the CPU reservation numbers are
higher than available cycles on 1 virtual CPU.
Based on the lab tests, we see that the 2.4 GHz reservation on E7 or E5540 processor has the same
performance as a 2.53 GHz Xeon 7500 processor. Therefore, it is fine to change the reservation numbers
on the virtual machine manually when running them on the E7 or E5440 processors for 5000, 10,000, or
20,000 deployment options.
For more on the reservations for the E7 or E5440 processor, see the docwiki available at
http://docwiki.cisco.com/wiki/Virtualization_for_Cisco_Unity_Connection.
To Change the Reservation Value of the Unity Connection 8.6(2) or Later Virtual Machine
Step 1 In VMware vSphere Client, select the host on which virtual machine is created.
Step 2 Click the Summary tab, under CPU, note the available CPU cycles for 1 virtual CPU in GHz.
Step 3 Power off the virtual machine on which you deployed the OVA template
Step 4 In the left pane of vSphere Client, right-click the name of the virtual machine and select Edit Settings.
Step 5 In the Virtual Machine Properties dialog box, select the Resources tab.
Step 6 In the Settings column, select CPU.
Step 7 Under Resource Allocation, enter the new reservation value in the Reservation textbox. The new
reservation value is calculated as the number of CPUsX2.4GHz (for E5440 processor) and the number
of CPUs multiplied by the 1 virtual CPU cycles in GHz (from step 2) (for E7 processor).
1-4
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
Chapter 1 Installing Cisco Unity Connection
Step 8 Click OK to close the Virtual Machine Properties dialog box.
Step 9 Power ON the virtual machine.
Verifying DNS Settings
To Verify DNS Settings
Step 1 Login to command prompt.
Step 2 To ping each server by its DNS name, enter ping DNS_name.
Step 3 To look up each server by IP address, enter nslookup IP_address.
Gathering Information for Installation
Pre-Installation Tasks
Use the Table 1-2 to record the information about your server. Gather this information for a single Unity
Connection server or for both the servers in a Unity Connection cluster. You should make copies of this
table and record your entries for each server in a separate table.
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
1-5
Chapter 1 Installing Cisco Unity Connection
Pre-Installation Tasks
Table 1-2 Gathering Information for Installation
Configuration Setting Description Can Setting Be Changed After Installation?
Time Zone: _____________________ Sets the local time zone and offset
from Greenwich Mean Time (GMT).
Yes, using the CLI command
CLI > set timezone
Select the time zone that most closely
matches the location of your server.
Caution In a cluster, you must set
the subscriber server to the
same time zone as the
publisher server.
MTU Size: ______________________ Sets the largest packet, in bytes, that
this host will transmit on the network.
By default, MTU is set to the size
defined in the operating system.
Selecting a different packet size
would be more prevalent where a
VPN or IPsec tunnel is used with a
custom packet size. Web access over
VPN can cause web pages not to load
because of an improper MTU
configuration.
The MTU size that you configure
must not exceed the lowest MTU size
that is configured on any link in your
network.
Note In clustered server pairs, the
MTU setting must be the
same on both servers.
Yes, using the CLI command
CLI > set network mtu
1-6
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
Chapter 1 Installing Cisco Unity Connection
Pre-Installation Tasks
Table 1-2 Gathering Information for Installation
Configuration Setting Description Can Setting Be Changed After Installation?
Hostname and IP addresses:
DHCP (Yes/No): ______
If DHCP is No:
Hostname: _________________
IP Address: _________________
IP Mask: ___________________
Gateway (GW) Address:________
Sets whether to use DHCP to
automatically configure the network
settings on your server.
If you select No, you must enter a
hostname, IP address, IP address
mask, and the gateway IP address.
The hostname can contain up to 64
alphanumeric characters, hyphens,
underscores, and period. The first
Yes, using the CLI command
CLI > set network dhcp
CLI > set network gateway
CLI > set network ip eth0
character cannot be a hyphen.
We recommend you use static
Dynamic Host Control Protocol
(DHCP) host configuration to ensure
the DHCP server always provides the
same IP address settings to the server
Domain Name Server:
DNS: (Yes/No): ______
If DNS is Ye s:
Domain: ____________________
DNS Primary: _________________
DNS Secondary: _______________
Note If you do not have a gateway,
you must still set this field to
255.255.255.255. Not
specifying a gateway may
limit you to only being able to
communicate with devices on
your subnet.
Caution Make sure not
to use
ciscounity in
the hostname
of the server
else enterprise
replication
will break.
Sets whether a DNS server resolves a
hostname and IP address.
Note Unity Connection enables the
use of a domain name server
to locate other Cisco Unity
servers and devices. This is
necessary when configuring
digital networking and
clustered server pairs. We
recommend you to configure
a secondary DNS server to
avoid any loss of connectivity
or service.
Yes, using the CLI commands
CLI > set network dns
CLI > set network domain
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
1-7
Chapter 1 Installing Cisco Unity Connection
Pre-Installation Tasks
Table 1-2 Gathering Information for Installation
Configuration Setting Description Can Setting Be Changed After Installation?
Administrator Account Credentials:
Login: ____________________
Password: _________________
Sets the administrator credentials for
secure shell access to the CLI and for
logging into Cisco Unified
Communications Operating System
and Disaster Recovery System.
The administrator account should be
shared only with installers and
Login: No.
Password: yes, using the CLI command
CLI > set password user admin
Note You can create additional
administrator accounts after
installation.
engineers who have a thorough
understanding and are responsible for
platform administration and
upgrades, and backup and restore
operations.
Note Ensure the password is at
least six characters long; it
can contain alphanumeric
characters, hyphens, and
underscore.
Certificate Information:
Organization: ____________________
Unit: ______________________
Location: _________________
State: ____________________
Sets information used by the server to
generate certificate signing requests
(CSRs) that are used to obtain
third-party certificates.
Tip To enter more than one
business unit name, separate
Yes, using the CLI command
CLI > set web-security
the entries with a comma. For
Country: _________________
entries that already contain a
comma, enter a backslash
before the comma that is
included as part of the entry.
Cluster:
First server in cluster (Yes/No): ____
If First server is No:
Publisher hostname: ____________
Publisher IP address: ____________
Publisher security password: ______
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
1-8
For location, you can enter any
setting that is meaningful within your
organization. Examples include the
state or the city where the server is
located.
First server refers to the publisher
server. During the installation of
second or subscriber server, enter the
details of the first server.
Chapter 1 Installing Cisco Unity Connection
Pre-Installation Tasks
Table 1-2 Gathering Information for Installation
Configuration Setting Description Can Setting Be Changed After Installation?
NTP Servers:
NTP Server 1: __________________
NTP Server 2: __________________
NTP Server 3: __________________
NTP Server 4: __________________
NTP Server 5: __________________
Sets the hostname or IP address of
one or more network time protocol
(NTP) servers that synchronizes with
your Unity Connection server.
The NTP service ensures that the
time synchronized is accurate for
date/timestamps of messages,
reports, and various tools, such as
Yes, using Cisco Unified Operating
System Administration:
Settings > NTP Servers
Using the CLI command
CLI > using the CLI command
logs and traces.
All Unity Connection servers require
an external NTP source that are
accessible during installation. The
source can be a corporate head-end
router synchronized with a public
NTP time server or it can be the
public NTP time server itself.
Note To avoid potential
compatibility, accuracy, and
network jitter problems, the
external NTP servers should
be NTP v4 (version 4). If you
are usingIPv6 addressing,
external NTP servers must be
NTP v6.
Note The NTP server that you
specify for the publisher
server is automatically
applied for the subscriber
server.
Security Password Sets the password used by a
subscriber server to communicate
with a publisher server.
The security password is also used by
the Disaster Recovery System to
encrypt backups.
The password must contain at least
six alphanumeric characters. It can
contain hyphens and underscores, but
it must start with an alphanumeric
character.
Yes, using the CLI command
CLI > set password user security
Caution If you are changing the security
password in a clustered server
pair, you must change the
security password on both
servers and reboot both servers.
For more information, see the
description of this command in
the Command Line Interface
Reference Guide for Cisco
Unified Solutions.
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
1-9
Chapter 1 Installing Cisco Unity Connection
Pre-Installation Tasks
Table 1-2 Gathering Information for Installation
Configuration Setting Description Can Setting Be Changed After Installation?
SMTP Server Sets the hostname or IP address for
the SMTP server that is used for
outbound e-mail, intrasite links,
Yes, using the CLI command:
CLI > set smtp
Voice Profile for Internet Mail
(VPIM), and HTTPS networking.
The hostname can contain
alphanumeric characters, hyphens, or
periods but it must start with an
alphanumeric character.
Note You must specify an SMTP
server if you plan to use
electronic notification.
Application Account Credentials:
Login: ____________________
Password: _________________
Sets the default credentials for the
Unity Connection applications,
including Cisco Unity Connection
Administration and Cisco Unity
Yes, using Cisco Unity Connection
Administration and the CLI command:
CLI > utils cuc reset password
Connection Serviceability.
1-10
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
Chapter 1 Installing Cisco Unity Connection
Installation Scenarios
Table 1-3 Installation Scenarios
Installation
Scenarios Installation Method
Standalone
Deployment
Cluster Deployment Standard
Installation Scenarios
Standard
• Installing the Publisher Server, page 1-12
• Verifying the Installation, page 1-22
Unattended
• Generating Answer File for Unattended Installation, page 1-16
• Installing the Publisher Server, page 1-12
• Verifying the Installation, page 1-22
• Installing the Publisher Server, page 1-12
Installation Tasks
Depending on the type of installation scenario, you need to perform the following tasks to install the
Unity Connection software:
• Navigating Within the Installation Wizard, page 1-12
• Installing the Publisher Server, page 1-12
• Configuring Subscriber Server on the Publisher Server, page 1-15
• Installing the Subscriber Server, page 1-15
• Generating Answer File for Unattended Installation, page 1-16
• Configuring Subscriber Server on the Publisher Server, page 1-15
• Installing the Subscriber Server, page 1-15
• Verifying the Installation, page 1-22
Unattended
• Generating Answer File for Unattended Installation, page 1-16
• Installing the Publisher Server, page 1-12
• Configuring Subscriber Server on the Publisher Server, page 1-15
• Installing the Subscriber Server, page 1-15
• Verifying the Installation, page 1-22
• Touchless Installation for Virtual Machine, page 1-18
• Applying a Patch, page 1-19
• Verifying the Installation, page 1-22
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
1-11
Installation Tasks
Navigating Within the Installation Wizard
For instructions on how to navigate within the installation wizard, see Tab le 1-4 .
Table 1-4 Installation Wizard Navigation
To Do This Press This
Move to the next field Tab
Move to the previous field Alt-Tab
Select an option Space bar or Enter
Scroll up or down in a list Up or down arrow
Go to the previous window Space bar or Enter to select Back (when available)
Get help information on a window Space bar or Enter to select Help (when available)
Installing the Publisher Server
Chapter 1 Installing Cisco Unity Connection
While installing a Unity Connection server, you are prompted to enter different configuration
information. Refer the table mentioned in the Gathering Information for Installation, page 1-5 section
wherever applicable.
To Install a Unity Connection Publisher Server
Step 1 Prepare the virtual machine to install Unity Connection:
a. Select Edit virtual machine settings to select the ISO image from CD/DVD drive using client
device or from data store.
b. Navigate to the Console tab. A screen prompting you to check the integrity of the DVD appears.
c. Select Ye s to perform the media check or Skip to move to the next step.
Note If you select media check and it fails, either download another copy from Cisco.com or obtain
another DVD directly from Cisco.
d. After performing the hardware check, you get a prompt to restart the system. You need to select Ye s
to continue installation. After the system restarts, the Product Deployment Selection window
displays.
Step 2 In the Product Deployment Selection window, select Cisco Unity Connection and select OK. The
Proceed with Install window appears.
Step 3 In the Proceed with Install window, select Yes to continue the installation.
1-12
Caution If you select Ye s on the Proceed with Install window, all existing data on your hard drive gets
overwritten and destroyed.
The Platform Installation Wizard window appears.
Step 4 In the Platform Installation Wizard window, select the applicable option:
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
Chapter 1 Installing Cisco Unity Connection
• If you want to perform a standard installation, select Proceed, and continue with this procedure.
• If you want to perform an unattended installation, select Skip. Connect the answer file image on a
virtual floppy diskette and select Continue. The installation wizard will read the configuration
information during the installation process and then follow the steps mentioned in the
Post-Installation Tasks, page 1-24 section.
Step 5 If you select Proceed in the previous window, the Apply Patch window appears:
• Select Ye s to upgrade to a later Service Release of the software during installation and follow the
process mentioned in the Applying a Patch, page 1-19 section.
• Select No to skip this step and the Basic Install window appears.
Step 6 In the Basic Install window, select Continue to install the software version or configure the pre-
installed software. The Timezone Configuration window appears.
Step 7 In the Timezone Configuration window, select the appropriate time zone for the server and then select
OK. The Auto Negotiation Configuration window appears.
Caution In a cluster, the subscriber server must be configured to use the same time zone as the
publisher server. The replication will not work if the timezone is not same.
Installation Tasks
Step 8 In the Auto Negotiation Configuration window, select Continue. The MTU Configuration window
appears.
Step 9 In the MTU Configuration window, select the applicable option:
• Select No to accept the default value (1500 bytes).
• Select Ye s to change the MTU size, enter the new MTU size, and select OK.
Caution If you configure the MTU size incorrectly, your network performance can be affected.
The DHCP Configuration window appears.
Step 10 In the DHCP Configuration window, select the applicable option:
• Select Ye s to use DHCP server that is configured in your network.The network restarts and the
Administrator Login Configuration window appears.
• Select No to configure a static IP address for the server and continue with this procedure. The Static
Network Configuration window appears.
Step 11 In the Static Network Configuration window, enter the static network configuration information.
The DNS Client Configuration window displays.
Step 12 To e n a ble DNS, choose Ye s, enter the DNS client information and select OK.
The network restarts using the new configuration information and the Administrator Login
Configuration window appears.
Step 13 Enter the administrator login and password.
The Certificate Information window appears.
Step 14 Enter your certificate signing request information and select OK.
The First Node Configuration window appears.
Step 15 In the First Node Configuration window, select the applicable option:
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
1-13
Installation Tasks
Step 16 In the Network Time Protocol Client Configuration window, enter the hostname or IP address of the
Step 17 In the Security Configuration window, enter the security password.
Step 18 In the SMTP Host Configuration window:
Chapter 1 Installing Cisco Unity Connection
• Select Yes to configure this server as the publisher server or as a standalone server and continue this
procedure. The Network Time Protocol Client Configuration window appears.
• Select No to configure this server as the subscriber server.
NTP server(s) and select OK. The Security Configuration window appears.
Note Cisco recommends that you use an external NTP server to ensure accurate system time on the
publisher server. However, you can configure multiple NTP servers based on your requirements.
Note The system uses this password to authorize communications between the publisher and
subscriber servers; you must ensure this password is identical on the two servers.
The SMTP Host Configuration window appears.
a. Select Ye s to configure an SMTP server and enter the SMTP server name or IP address.
b. Select OK. The Application User Configuration window appears.
Note You must configure an SMTP server to use certain platform features; however, you can also
configure an SMTP server later using the platform GUI or the command line interface.
Step 19 In the Application User Configuration window:
a. Enter the Application User name and password and confirm the password by entering it again.
Note Do not use the system application name as the Application User name. Using a system
application name causes the installation to fail with an unrecoverable error during the
installation of the database. The system application names are operator, replication,
undeliverablemessagesmailbox, and Unity Connection.
b. Select OK. The Platform Configuration Confirmation window appears.
Step 20 In the Platform Configuration Confirmation window, select OK to continue the installation. The
system installs and configures the software.
Step 21 When the installation process completes, you are prompted to log in using the Administrator account
and password.
Step 22 Complete the post-installation tasks listed in the Post-Installation Tasks, page 1-24 section.
1-14
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
Chapter 1 Installing Cisco Unity Connection
Configuring Subscriber Server on the Publisher Server
To Configure Subscriber server on the publisher server
Step 1 Sign in to Cisco Unity Connection Administration.
Step 2 Expand System Settings and select Cluster.
Step 3 On the Find and List Servers page, select Add New.
Step 4 On the New Server Configuration page, in the Hostname or IP Address field, enter the hostname or IP
address of the second server in the cluster.
Step 5 (Optional) In the MAC Address field, enter the MAC address of the second server.
Step 6 In the Description field, enter a description for the second server and select Save.
Installing the Subscriber Server
Installation Tasks
To install the subscriber server, follow the steps of installing publisher server until the First Node
Configuration window appears and then continue the following procedure.
While installing a Unity Connection server, you are prompted to enter different configuration
information. Refer the table mentioned in the Gathering Information for Installation, page 1-5 section
wherever applicable.
To Install a Subscriber Server
Step 1 In the Console tab, on the First Node Configuration window, select No to continue the installation of
the subscriber server and select OK.
The Network Connectivity Test Configuration window displays.
Step 2 During installation of a subscriber server, the system checks to ensure that the subscriber server can
connect to the publisher server.
• To pause the installation after the system successfully verifies network connectivity, select Ye s.
• To continue the installation, select No.
The First Node Access Configuration window displays.
Step 3 Enter the connectivity information for the publisher server and select OK.
The system checks for network connectivity.
If you select to pause the system after the system successfully verifies network connectivity, the
Successful Cisco Unity Connection to First Node window displays. Select Continue.
Note If the network connectivity test fails, the system stops and allows you to go back and re-enter
the parameter information.
The SMTP Host Configuration window displays.
Step 4 If you want to configure an SMTP server, select Ye s and enter the SMTP server name.
The Platform Configuration Confirmation window displays.
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
1-15
Installation Tasks
Step 5 Select OK to start installing the software.
Step 6 When the installation process completes, you are prompted to log in using the Administrator account
and password.
Step 7 Complete the post-installation tasks that are listed in the Post-Installation Tasks, page 1-24 section.
Generating Answer File for Unattended Installation
You can generate answer files using Cisco Unified Communications Answer File Generator web
application. To use the answer file during installation, you need to save the answer file to the root
directory of a floppy diskette, browse to the file during installation, and leave the installation to
complete.
In case of Unity Connection cluster:
• You need to generate separate answer files for publisher and subscriber servers.
• You are not required to enter details of the publisher server manually on the subscriber server during
subscriber server installation.
Chapter 1 Installing Cisco Unity Connection
Note The Cisco Unified Communications Answer File Generator supports Internet Explorer version 11.0 or
higher and Mozilla version 28.0 or higher.
Task List for Unattended Installation
You need to perform the following tasks to generate answer file and create floppy image for unattended
installation.
1. Generate and download answer files that includes the platformConfig.xml files for both the publisher
and the subscriber server. For more information on how to generate answer files, see To Ge n e rate
and Download Answer Files using AFG, page 1-16.
2. After generating the answer files, create a floppy image. For more information, see
http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&exter
nalId=1739.
3. Deploy and configure the servers in the cluster, publisher and subscriber. For more information, see
the To Configure the Publisher Server on Virtual Machine, page 1-17 and To Configure the
Subscriber Server on Virtual Machine, page 1-17 section.
4. To install the publisher and subscriber server, see the Installing the Publisher Server, page 1-12 and
Installing the Subscriber Server, page 1-15 section.
To Generate and Download Answer Files using AFG
1-16
Step 1 Log in to the Unity Connection Answer File Generator application. The answer file can be generated
using the following link: http://www.cisco.com/web/cuc_afg/index.html.
Step 2 Enter details in the Clusterwide Configuration section.
Step 3 Enter details for the primary node in the Primary Node Configuration section.
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
Chapter 1 Installing Cisco Unity Connection
Step 4 (Optional) If you want to enable Dynamic Cluster Configuration, enter a value in the
Dynamic-cluster-config-timer field.
Note Step 4 is mandatory when you are using Dynamic-cluster-configuration process for Touchless
installation.
Step 5 Enter details for the secondary node in the Secondary Node Configuration section.
Step 6 In the List of Secondary Nodes list box, select Add Secondary Node. The node that you add as
secondary node appears in this list box.
Step 7 Click Generate Answer Files. A dialog box appears showing the details for the primary node, the
secondary node, and the clusterConfig file.
Step 8 In the Communications Answer File Generator dialog box, follow the download instructions, and then
click the Download File button to download the answer files to your computer.
To Configure the Publisher Server on Virtual Machine
Installation Tasks
Step 1 Log in to the virtual machine to start the cluster installation.
Step 2 From the VM menu, choose Edit settings to mount the floppy image that you have created from the
Answer File Generator tool. The Virtual Machine Properties dialog box appears.
Step 3 From the available hardware list, select Floppy drive 1.
Step 4 In the Device Type section, select Use the existing floppy image in the database, and then click
Browse to navigate to the floppy image.
Step 5 Click OK. The floppy image is attached.
Step 6 Select the CD/DVD Drive 1 > Connect to ISO image on local disk option from the toolbar and choose
CD/DVD Drive1 > Connect to ISO image on a datastore, navigate to the data store to select the ISO
image, and click OK. The ISO image is attached and the installation starts.
Step 7 (Optional) If you want to test the media before the installation, click OK in the Disc Found message
box, or select Skip to skip testing the media before the installation. The installation proceeds without
any manual intervention. The publisher is installed and the subscribers is added to the publisher.
To Configure the Subscriber Server on Virtual Machine
Step 1 You can install the subscriber only after the publisher is installed.(Applicable to only unattended
installation, not valid for Touchless install).
Step 2 Perform Step 1 to Step 6 of the To Configure the Publisher Server on Virtual Machine, page 1-17
procedure.
Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 10.x
1-17
Loading...