Cue Install Book

You might also like

Download as pdf or txt
Download as pdf or txt
You are on page 1of 62

Installation Guide for Cisco Unity Express Virtual 10.

2
First Published: 2019-11-25
Last Modified: 2021-11-10

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

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network
topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional
and coincidental.

All printed copies and duplicate soft copies of this document are considered uncontrolled. See the current online version for the latest version.

Cisco has more than 200 offices worldwide. Addresses and phone numbers are listed on the Cisco website at www.cisco.com/go/offices.

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:
https://www.cisco.com/c/en/us/about/legal/trademarks.html. 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. (1721R)
© 2019–2020 Cisco Systems, Inc. All rights reserved.
CONTENTS

Full Cisco Trademarks with Software License ?

CHAPTER 1 Cisco Unity Express Virtual Feature Roadmap 1


Feature and Release Support 1

CHAPTER 2 Cisco Unity Express Virtual Software Overview 3

Cisco Unity Express Virtual on VMware ESXi 3


Cisco Unity Express Virtual on Cisco 4000 Series-Integrated Service Routers KVM Service Containers
4

Uninterruptible Power Supply Recommendations 4

CHAPTER 3 Prerequisites for Installing Cisco Unity Express Virtual 5

Prerequisites for Cisco Unified Communications Manager Express 5


Prerequisites for Cisco Unified Communications Manager 7

CHAPTER 4 Cisco Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server
Modules 11
Overview of Installation Steps 11
Hardware Requirements for Cisco Unity Express Virtual 12
Virtual Machine Requirements for Cisco Unity Express Virtual 12
Set up the VMware ESXi Environment 12
VMware Tools 12
Download the Cisco Unity Express Virtual OVA file 13
Deploy the Cisco Unity Express Virtual OVA 13
Configure Cisco Unity Express Virtual after Deployment 14
Example for Configuring the Cisco Unity Express Virtual 15

Installation Guide for Cisco Unity Express Virtual 10.2


iii
Contents

Verify Cisco Unified Communication Manager Express and Cisco Unity Express Virtual on ESXi
20

Verify Cisco Unified Communication Manager and Cisco Unity Express Virtual on ESXi 21

CHAPTER 5 Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM
Service Containers 23
Overview of OVA Installation Steps on KVM Service Container 23
Hardware Requirements for Cisco Unity Express Virtual KVMs on Cisco 4000 Series Integrated Services
Routers 24
Install and Configure the Cisco Unity Express Virtual OVA on KVM Service Containers 24
Deactivate and Uninstall Cisco Unity Express Virtual from KVM Service Containers 28
Upgrade Cisco Unity Express Virtual 9.0.6 to 10.2 29

Example for Accessing and Configuring the Cisco Unity Express Virtual in Cisco 4000 Series Integrated
Services Routers Service Container 30

CHAPTER 6 Configure Cisco Unity Express Virtual Application 37

Configure Cisco Unity Express Virtual using GUI 37


Configure Cisco Unity Express Virtual using CLI 37

CHAPTER 7 Cisco Unity Express Virtual Licensing 39

Installation Sequence 39
Activate Evaluation Licenses 39

CHAPTER 8 Migrating to Cisco Unity Express Virtual 10.2 43

Migrate Cisco Software Licensing (CSL) to Cisco Smart Software Licensing 43


Migrate Cisco Unity Express Virtual 8.6.12 (SRE) to Cisco Unity Express Virtual 10.2 43

Migrate Cisco Unity Express Virtual 9.0.x to Cisco Unity Express Virtual 10.2 45

Migrate Cisco Unity Express Virtual 10.0.x to Cisco Unity Express Virtual 10.2 46

CHAPTER 9 Language Upgrade Preparation 47


Language Upgrade Preparation 47

CHAPTER 10 Manually Backing Up Files 49

Manually Backing Up Files 49

Installation Guide for Cisco Unity Express Virtual 10.2


iv
Contents

Numbering Scheme for Backup Files 49

CHAPTER 11 Restoring Files 51

Restoring Files 51

CHAPTER 12 Troubleshooting Cisco Unity Express Virtual Service on KVM Service Containers 55

Example for Verifying Installation Failure of Cisco Unity Express Virtual Service 55
Example for Verifying Activation Failure of Cisco Unity Express Virtual Service 55
Check Memory Present on Cisco 4000 Series Integrated Services Routers 56

Installation Guide for Cisco Unity Express Virtual 10.2


v
Contents

Installation Guide for Cisco Unity Express Virtual 10.2


vi
CHAPTER 1
Cisco Unity Express Virtual Feature Roadmap
• Feature and Release Support, on page 1

Feature and Release Support


The below table lists the Cisco Unity Express Virtual version that introduced support for a given feature or
enhancement. Unless noted otherwise, subsequent versions of Cisco Unity Express Virtual software also
support that feature. Only features that were introduced or modified in Cisco Unity Express Virtual 10.2 or
a later version appear in the table.

Table 1: Supported Cisco Unity Express Virtual Features

Feature Name Feature Description

Cisco Unity Express Virtual 10.2

The command no web session security keylabel HTTPS is enabled by default. You need not manually
labelname is disabled. generate a crypto key and pass it to the web session
security to enable HTTPS.
Cisco Unified SIP Proxy 10.2 supports only TLS v1.2
for HTTPS.
The command no web session security keylabel
labelname is disabled. Therefore all the HTTP
requests will be redirected to HTTPS. Only the latest
connection is retained and the remaining connections
are logged out.

Smart Agent version upgrade Smart Agent is upgraded to latest version 3.0.9.

Installation Guide for Cisco Unity Express Virtual 10.2


1
Cisco Unity Express Virtual Feature Roadmap
Feature and Release Support

Installation Guide for Cisco Unity Express Virtual 10.2


2
CHAPTER 2
Cisco Unity Express Virtual Software Overview
The Cisco Unity Express Virtual software supports the voicemail, auto-attendant, and the IVR features. Cisco
Unity Express Virtual voicemail and auto-attendant applications work with Cisco Unified Communications
Manager Express (Cisco Unified CME, formerly known as Cisco Unified CallManager Express) or Cisco
Unified Communications Manager (formerly known as Cisco Unified CallManager) to provide small and
medium-sized companies with the capability to:
• Create and maintain voice mailboxes for onsite or remote telephone subscribers. The maximum number
of mailboxes depends on the resources available in the Cisco UCS and Cisco UCS E-Series Servers and
the Cisco 4000 Series Integrated Services Routers deployed. Mailboxes numbers are also dependent on
the license agreement purchased for Cisco Unity Express Virtual.
• Record and upload messages for callers to hear when they dial the company’s telephone number and
prompts to guide the callers to specific extensions or employees.
• Cisco Unity Express Virtual supports Interactive Voice Response (IVR) as a major component of the
system in addition to Voice-Mail and Auto-Attendant. The Interactive Voice Response (IVR) option is
a separate, add-on license package that integrates with Cisco Unity Express Virtual. The functionality
described for IVR is only available if you purchase a separate IVR software license.

Cisco Unity Express Virtual application supports all the features that were supported on a bare-metal installation
of Cisco Unity Express on the SRE Module. You can install the Cisco Unity Express Virtual application in
the following ways:
• Cisco Unity Express Virtual on VMware ESXi, on page 3
• Cisco Unity Express Virtual on Cisco 4000 Series-Integrated Service Routers KVM Service Containers,
on page 4

Cisco Unity Express Virtual on VMware ESXi


For information about installing Cisco Unity Express Virtual within a VMWare ESXi environment, see Cisco
Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server Modules,
on page 11.

Installation Guide for Cisco Unity Express Virtual 10.2


3
Cisco Unity Express Virtual Software Overview
Cisco Unity Express Virtual on Cisco 4000 Series-Integrated Service Routers KVM Service Containers

Cisco Unity Express Virtual on Cisco 4000 Series-Integrated


Service Routers KVM Service Containers
Cisco Unity Express Virtual also supports operating within the Kernel Virtual Machine (KVM) Service
Container on Cisco 4000 Series-Integrated Service Routers (Cisco 4000 Series ISR), also called virtual service
containers.
A virtual service container is a virtualized environment on the Cisco 4000 Series ISR router. It is also referred
to as a virtual machine (VM), virtual service, or container. You can install an application within a virtual
service container which runs within the operating system of a device. The application runs in the virtual
services container of the operating system of a device. The application is delivered as an open virtual application
(OVA), which is a tar file with an .ova extension. The OVA package is installed and enabled on a device
through the device CLI. For more information on virtual service containers, see Virtual Services Container.
For information about installing Cisco Unity Express Virtual on Cisco 4000 Series ISRs, see Cisco Unity
Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers,
on page 23.

Note Cisco Unity Express Virtual 10.2.1 release included the support of Cisco IOS XE Release 17.3.2 and later.
vCUE 10.2.0 and lower version support Cisco IOS XE Release 17.3.1 or lower releases.

Uninterruptible Power Supply Recommendations


We highly recommend protecting the router or server that hosts Cisco Unity Express Virtual with an
uninterruptible power supply (UPS).

Installation Guide for Cisco Unity Express Virtual 10.2


4
CHAPTER 3
Prerequisites for Installing Cisco Unity Express
Virtual
This section describes the prerequisites for installing the Cisco Unity Express Virtual on your system and
contains the following sections:
• Prerequisites for Cisco Unified Communications Manager Express, on page 5
• Prerequisites for Cisco Unified Communications Manager , on page 7

Prerequisites for Cisco Unified Communications Manager


Express

Note This section applies to a new installation of Cisco Unity Express Virtual.

If you are using Cisco Unified Communications Manager Express (Cisco Unified CME) with your Cisco
Unity Express Virtual system, Cisco Unified CME must be installed before you configure Cisco Unity Express
Virtual. If you did not perform the Cisco Unified CME installation, contact the designated installer to ensure
that the following procedures are completed:

Step 1 Verify that the version of Cisco Unified CME is compatible with Cisco Unity Express Virtual. See the Cisco Unity
Express Compatibility Matrix.
Step 2 Install all Cisco Unified CME and Cisco Unity Express Virtual hardware and verify functionality.
a) Attach the IP Phones so that they register with the Cisco Unified CME router. Configure the IP Phones and subscribers
and save them to the Cisco Unified CME database. The Cisco Unity Express Virtual initialization wizard allows you
to copy this data to the Cisco Unity Express Virtual database. You can create more subscribers and IP Phones later
using the Cisco Unity Express Virtual CLI commands or GUI options.
Use the following sample voice register dn and voice register pool configurations to configure the IP Phones and
subscribers manually:

voice register dn 24
number 8124
shared-line max-calls 6
!

Installation Guide for Cisco Unity Express Virtual 10.2


5
Prerequisites for Installing Cisco Unity Express Virtual
Prerequisites for Cisco Unified Communications Manager Express

voice register pool 124


id mac 0017.E033.0284
type 7965
number 1 dn 24
!

b) Verify that Cisco Unity Express Virtual will be installed and configured on a router that supports the hardware modules
that you are using.
Step 3 Install and verify Cisco Unified CME software functionality.
Depending on the version of Cisco Unified CME, you can perform some configuration using the Cisco Unified CME
graphical user interface. If the version of Cisco Unified CME does not support the GUI, see Cisco Unified Communications
Manager Express Administrator Guide. If your version of Cisco Unified CME supports the GUI, proceed with the
following steps:
Note The GUI is fully deprecated as of CME 12.6.

Note Cisco Unified CME does not support SIP phones via the GUI.

a) Verify that you have web connectivity to the Cisco Unified CME configuration web page. For example,
http://cisco-unified-cme-router-ipaddress/ccme.html.
b) Verify that the Cisco Unified CME router flash memory has the following files, which control the functionality of
the Cisco Unity Express Virtual GUI:
• CiscoLogo.gif
• Delete.gif
• Plus.gif
• Tab.gif
• admin_user.html
• admin_user.js
• dom.js
• downarrow.gif
• ephone_admin.html
• logohome.gif
• normal_user.html
• normal_user.js
• sxiconad.gif
• telephony_service.html
• uparrow.gif
• xml-test.html
• xml.template

See Download Software for downloading Cisco Unified CME files.

Installation Guide for Cisco Unity Express Virtual 10.2


6
Prerequisites for Installing Cisco Unity Express Virtual
Prerequisites for Cisco Unified Communications Manager

c) Configure the following path in Cisco Unified CME configuration mode:


Example:
Router(config)# ip http path flash:
d) Verify the path with the show running-config command.
e) Verify that a SIP dial peer is configured to point to the Cisco Unity Express Virtual module, that it specifies G.711
u-law and SIP Notify for DTMF Relay, and that VAD is turned off. This step is required to have an incoming call
directed to Cisco Unity Express Virtual. The following is an example configuration:
dial-peer voice 6000 voip ! SIP dial peer pointing to Cisco Unity Express Virtual
destination-pattern 6...
session protocol sipv2
dtmf-relay sip-notify
session target ipv4:172.16.0.1 ! Cisco Unity Express Virtual IP address
codec g711ulaw
no vad

f) Configure the appropriate number of SIP dial peers to support your dial plan.
g) Verify that a Cisco Unified CME web administrator is configured with a username and password, for example:
voice register global
.
.
.
web admin system name admin password user1

OR

web admin system name admin secret 5 encrypted-password

Step 4 The FTP server that communicates with Cisco Unity Express Virtual must support passive FTP requests. To configure
this functionality on the FTP server, see your FTP server documentation.
Step 5 (Optional) If no subscribers were created in the Cisco Unified CME interface, create a list of all subscribers, groups, and
their extensions to simplify the task of configuring many subscribers and extensions.

Prerequisites for Cisco Unified Communications Manager


If you are using Cisco Unified Communications Manager with the Cisco Unity Express Virtual system, Cisco
Unified Communications Manager must be installed before the Cisco Unity Express Virtual configuration
can be started.
If you did not perform the Cisco Unified Communications Manager installation, contact the designated installer
to ensure that the following procedures are completed:

Step 1 Verify that the version of Cisco Unified Communications Manager is compatible with Cisco Unity Express Virtual. See
Cisco Unity Express Compatibility Matrix.
Step 2 Install all Cisco Unified Communications Manager and Cisco Unity Express Virtual hardware and verify functionality.
See Cisco Unity Express Documentation for the hardware installation documentation for your module.
a) Attach the telephones so that they register with the Cisco Unified Communications Manager server.
b) On the Cisco Unified Communications Manager, configure up to 32 CTI ports for a Cisco Unity Express Virtual
system with a Cisco UCS E-Series module. You can configure up to 20 ports for the Cisco 4000 Series Integrated

Installation Guide for Cisco Unity Express Virtual 10.2


7
Prerequisites for Installing Cisco Unity Express Virtual
Prerequisites for Cisco Unified Communications Manager

Services Routers configured with Kernel Virtual Machine Service Containers. Use the Cisco Unified Communications
Manager option Device > Phones > Add new Phone. These ports will be used by the Cisco Unity Express Virtual
applications (voice mail, auto attendant, and Administration through Telephone [AvT]) to terminate calls.
Note Do not configure extra CTI ports on Cisco Unified Communications Manager. Doing so will impact the
scalability of your Cisco Unified Communications Manager and will limit the number of other devices it
can support.

c) Configure at least two Cisco Unified Communications Manager route points on Cisco Unified Communications
Manager using Device > CTI Route Point. The Cisco Unity Express Virtual voicemail application uses one route
point, and the auto attendant application uses one route point. If you plan to use the Cisco Unity Express Virtual AvT,
configure a third route point on Cisco Unified Communications Manager. You need as many route points as the
number of call-in numbers on Cisco Unity Express Virtual.
Note Do not configure extra route points on Cisco Unified Communications Manager. Doing so will impact the
scalability of your Cisco Unified Communications Manager and will limit the number of other devices that
Cisco Unified Communications Manager can support.

d) Create a Cisco Unified Communications Manager JTAPI user by choosing User > Add new user. Use the Device
Association option to associate the CTI ports and route points with this JTAPI user. (The JTAPI user is not assigned
a Cisco Unity Express Virtual voice mailbox. It is a placeholder for Cisco Unity Express Virtual to establish a
connection with Cisco Unified Communications Manager.) Verify that the Enable CTI Application Use check box
is checked for this JTAPI user. Verify that the JTAPI user is able to perform Standard CTI Enable by selecting the
appropriate option or group on the Unified Communications Manager.
e) Verify that the AXL service is active. To do this, go to the Cisco Unified Communications Manager serviceability
website, click Tools > Service Activation. Look for Cisco AXL Web service.
f) For efficient call processing, configure access lists on the default router of Cisco Unity Express Virtual to prioritize
JTAPI traffic. For example:
class-map match-all jtapi
match access-group 110
class-map match-all voice
match access-group 100
policy-map jtapi
class jtapi
set dscp cs3
bandwidth 20
class voice
set dscp af31
priority 320
class class-default
fair-queue

interface Serial0/1
ip address 172.16.0.1 255.255.0.0
service-policy output jtapi
clockrate 256000
no cdp enable

access-list 100 permit udp host 172.16.0.1 any range 16383 32727
access-list 110 permit tcp host 172.16.0.1 any eq 2748

where 172.16.0.1 is the IP address of the module that contains Cisco Unity Express Virtual software. The output from
the show policy-map interface command should indicate that the marked packets number is increasing. For example:
Match: access-group 110
QoS Set
dscp cs3
Packets marked 334 <-----This number should increase.

Installation Guide for Cisco Unity Express Virtual 10.2


8
Prerequisites for Installing Cisco Unity Express Virtual
Prerequisites for Cisco Unified Communications Manager

Step 3 The FTP server that communicates with Cisco Unity Express Virtual must support passive FTP requests. To configure
this functionality on the FTP server, see your FTP server documentation.
Step 4 (Optional) If no subscribers were created in the Cisco Unified Communications Manager interface, create a list of all
subscribers, groups, and their extensions to simplify the task of configuring many subscribers and extensions.

Installation Guide for Cisco Unity Express Virtual 10.2


9
Prerequisites for Installing Cisco Unity Express Virtual
Prerequisites for Cisco Unified Communications Manager

Installation Guide for Cisco Unity Express Virtual 10.2


10
CHAPTER 4
Cisco Unity Express Virtual Software Support for
ESXi on Cisco UCS and Cisco UCS E-Series
Server Modules
Cisco Unity Express Virtual is supported on ESXi on Cisco Unified Computing System (Cisco UCS) and
Cisco UCS E-Series Server modules. If required, you can choose to buy the Cisco UCS or the Cisco UCS
E-Series Server module to install the Cisco Unity Express Virtual application.
• Overview of Installation Steps, on page 11
• Hardware Requirements for Cisco Unity Express Virtual, on page 12
• Set up the VMware ESXi Environment, on page 12
• Download the Cisco Unity Express Virtual OVA file, on page 13
• Deploy the Cisco Unity Express Virtual OVA, on page 13
• Configure Cisco Unity Express Virtual after Deployment, on page 14
• Example for Configuring the Cisco Unity Express Virtual, on page 15
• Verify Cisco Unified Communication Manager Express and Cisco Unity Express Virtual on ESXi, on
page 20
• Verify Cisco Unified Communication Manager and Cisco Unity Express Virtual on ESXi, on page 21

Overview of Installation Steps


The following steps provide an overview of how to set up Cisco Unity Express Virtual software.

Step 1 Select and install a server on which to operate the Cisco Unity Express Virtual.
See Hardware Requirements for Cisco Unity Express Virtual, on page 12.

Step 2 Set up the VMware ESXi environment on the server.


See Set up the VMware ESXi Environment, on page 12.

Step 3 Download the Cisco Unity Express Virtual OVA file from: http://www.cisco.com.
See Download the Cisco Unity Express Virtual OVA file, on page 13.

Step 4 Deploy the OVA on the server.

Installation Guide for Cisco Unity Express Virtual 10.2


11
Cisco Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server Modules
Hardware Requirements for Cisco Unity Express Virtual

See Deploy the Cisco Unity Express Virtual OVA, on page 13.

Step 5 Configure the networking and other Cisco Unity Express Virtual settings, according to the details of your network.
See Configure Cisco Unity Express Virtual after Deployment, on page 14.

Step 6 Set up communication between Cisco Unity Express Virtual and the Unified Communications Manager.
See Cisco Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server Modules, on
page 11.

Hardware Requirements for Cisco Unity Express Virtual


This section provides information about the hardware requirements.

Virtual Machine Requirements for Cisco Unity Express Virtual


Cisco Unity Express Virtual software requires VMware ESXi 5.5, and above. For details about VMware
feature support, see the VMware Feature Guide. After configuring the server hardware, install VMware
vSphere ESXi.
Table 2: Virtual Machine Requirements for Cisco UCS and Cisco UCS E-Series server Platforms , on page
12 provides hardware recommendations for Cisco UCS platform and Cisco UCS E-Series server platforms.

Table 2: Virtual Machine Requirements for Cisco UCS and Cisco UCS E-Series server Platforms

Mailboxes CPU RAM Hard Disk External Recording hours Maximum


Interface Voice Ports

1-100 1.1 GHz, 1 4 GB 100 GB 1 Gigabit 60 32


core Interface

101-500 1.9 GHz, 2 4 GB 100 GB 1 Gigabit 600 32


cores Interface

Set up the VMware ESXi Environment


After configuring the server hardware, install VMware vSphere ESXi. For instructions, see Implementing
Virtualization Deployments.

VMware Tools
Cisco Unity Express Virtual Software Release 10.2 does not support installation of VMware Tools or any
third-party tools in a Linux environment.

Installation Guide for Cisco Unity Express Virtual 10.2


12
Cisco Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server Modules
Download the Cisco Unity Express Virtual OVA file

Download the Cisco Unity Express Virtual OVA file


The Open Virtualization Archive (OVA) file contains a compressed, installable version of the virtual machine.
To download the Cisco Unity Express Virtual (OVA) file (virtual machine template), perform the following
steps:

Step 1 Open the Cisco Unity Express Virtual Server site: https://software.cisco.com/download/
navigator.html?mdfid=278535672&selMode=null.
Step 2 If prompted, log in using your Cisco.com user name and password.
Step 3 Locate the OVA in “Download Software” section and download the file.

Deploy the Cisco Unity Express Virtual OVA


After downloading the Cisco Unity Express Virtual OVA, use the following procedure to deploy OVA or the
virtual machine template.

Before you begin


• Download Cisco Unity Express Virtual OVA for installation
• Have your server installed on a VMware ESXi environment
• Have VMware vSphere Client installed and functional on your system

Step 1 In the vSphere Client GUI, select File > Deploy OVF Template…
The Deploy OVF Template dialog box appears.

Step 2 Browse to the location where Cisco Unity Express Virtual server OVA file is downloaded. Click Next.
Step 3 Review and confirm the OVF Template details. Click Next.
Step 4 Enter the name of the device in Name field. The name provided determines how the device appears in the left pane of
the vSphere window.
Step 5 Click Next.
Note If there are multiple server hosts running ESXi, select the host on which you want Cisco Unity Express Virtual
server to run.

Step 6 Select any of the following Thick provisioning format and click Next.
• Thick Provision Lazy Zeroed
• Thick Provision Eager Zeroed

Step 7 Click Next.


The Deploy OVF Template dialog box displays the available networks.

Installation Guide for Cisco Unity Express Virtual 10.2


13
Cisco Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server Modules
Configure Cisco Unity Express Virtual after Deployment

Step 8 Select the network under Destination Networks option. The selected network is used to communicate with the remote
sites.
Note Ensure that the VM is connected to physical adapter of the ESXi.

Step 9 Click Next.


The Deployment Settings dialog box displays a summary of the options that you have configured.
Step 10 Click Finish to deploy Cisco Unity Express Virtual Server.
A dialog box indicates when the deployment is complete.
Step 11 Select the VM instance, right click and choose Edit Settings....
The Virtual Machine Properties dialog box appears.
Step 12 Click the Hardware tab and set the values for memory and vCPU. See Table 2: Virtual Machine Requirements for
Cisco UCS and Cisco UCS E-Series server Platforms , on page 12.
Step 13 Click the Resources Tab and select CPU. Adjust the Reservation and Shares to the value as provided in Table 2: Virtual
Machine Requirements for Cisco UCS and Cisco UCS E-Series server Platforms , on page 12.
Step 14 Select Memory and change the reservation value as provided mentioned in the Table 2: Virtual Machine Requirements
for Cisco UCS and Cisco UCS E-Series server Platforms , on page 12.
Step 15 Save the settings of the virtual machine.
Step 16 Select Resource Allocation and confirm the resource reservations.

Configure Cisco Unity Express Virtual after Deployment


After deploying the OVA template, perform the following procedure to configure Cisco Unity Express Virtual.

Before you begin


• VMware vSphere Client installed and operating
• Cisco Unity Express Virtual Software OVA template deployed

Step 1 In the vSphere Client GUI, in the left pane, select the Cisco Unity Express Virtual device. The name of the device is
the name configured during installation.
Step 2 To open the console, click the Console icon in the vSphere toolbar.
A console window appears for the selected CUE instance.

Step 3 In the console window, click the Power On icon (appears as a green “Play” button).
The device boots, displaying the boot output in the console. When the start-up is complete, the console displays a
message, prompting you to start configuration.

Step 4 At the prompt in the console window, confirm that you want to start the configuration process.
• y: If you enter y, the system asks you to confirm, then begin the interactive post installation configuration process.
• Timeout: If you do not enter any input for two minutes, the initial setup wizard is skipped, and you are prompted
to enter the IP address, netmask, and default gateway address. Once you enter the information, the Cisco Unity
Express Virtual Express system is online.

Installation Guide for Cisco Unity Express Virtual 10.2


14
Cisco Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server Modules
Example for Configuring the Cisco Unity Express Virtual

Step 5 When prompted, enter IP address and netmask of the device.


Note Cisco Unity Express Virtual requires IP communication access to the Cisco Unified Communications Manager
and Remote sites.

Step 6 When prompted, enter the default gateway address. Confirm that the configuration is correct.
Step 7 When prompted for the host name, enter the name by which Cisco Unity Express Virtual appears within your network.
Use a name that conforms to the fully qualified domain name (FQDN) rules.
Step 8 When prompted for a domain, enter a domain.
Note Configuring DNS server is optional. If DNS server is not configured, Cisco Unity Express Virtual gets the
mapping of IP address to hostname and vice-versa, from “Extension: SubjectAltName” section of Unified
Communications Manager certificate.

Step 9 When prompted regarding using DNS, enter y to configure Cisco Unity Express Virtual to use DNS.
Step 10 Enter the IP for the primary DNS server.
Step 11 Enter the IP for a secondary DNS server, if one is available. Otherwise, press Enter.
Step 12 When prompted for the primary network time protocol (NTP) server, enter the server domain name or the IP address.
In some Cisco Unity Express Virtual software cases, a default server IP address appears automatically, and press Enter.
Note Cisco Unity Express Virtual requires a NTP server.

Step 13 When prompted for the secondary NTP server, enter the server domain name or IP if you have a secondary NTP.
Otherwise, press Enter.
Step 14 When prompted for time zone information, use the menus to set your local time zone, and confirm when prompted.
Cisco Unity Express Virtual restarts.

Step 15 When prompted, enter an administrator user ID.


Step 16 Enter a password for the account, and confirm.
Note Ensure that you use this username and password to access Cisco Unity Express Virtual through SSH after
installation.

When this procedure is complete, Cisco Unity Express Virtual indicates that the system is online and displays a command
line prompt. For example:
SYSTEM ONLINE
CUE#

Example for Configuring the Cisco Unity Express Virtual


When you open the first session, the system launches the post installation configuration tool, and asks you if
you want to start configuration immediately.
Enter the appropriate response, y or n. If you enter y, the system asks you to confirm, then begin the interactive
post installation configuration process.
If you do not enter any input for two minutes, the initial setup wizard is skipped, and you are prompted to
enter the IP address, netmask, and default gateway address.

Installation Guide for Cisco Unity Express Virtual 10.2


15
Cisco Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server Modules
Example for Configuring the Cisco Unity Express Virtual

The following is a sample configuration if y is selected:


IMPORTANT::
IMPORTANT:: Welcome to Cisco Systems Service Engine
IMPORTANT:: post installation configuration tool.
IMPORTANT::
IMPORTANT:: This is a one time process which will guide
IMPORTANT:: you through initial setup of your Service Engine.
IMPORTANT:: Once run, this process will have configured
IMPORTANT:: the system for your location.
IMPORTANT::
IMPORTANT:: If you do not wish to continue, the system will be halted
IMPORTANT:: so it can be safely removed from the router.
IMPORTANT::

Do you wish to start configuration now (y,n)? y


Are you sure (y,n)? y

***********************************
* Service Engine IP configuration *
***********************************
Please enter the IP address of your Module: 192.0.2.10
Please enter the netmask of your Module: 255.255.0.0
Please enter the default gateway for your Module: 192.0.2.20

The following IP configuration is set:

IP : 192.0.2.10
NETMASK:255.255.0.0
GATEWAY: 255.255.0.0

Do you wish to use this configuration (y, n) [n]: y

Enter Hostname
(my-hostname, or enter to use Router): Enter
Using Router as default

Enter Domain Name


(mydomain.com, or enter to use local domain): Enter
Using localdoamin as default

IMPORTANT:: DNS Configuration:


IMPORTANT::
IMPORTANT:: This allows the entry of hostnames, for example foo.cisco.com, instead
IMPORTANT:: of IP addresses like 1.123.45.678 for application configuration. In order
IMPORTANT:: to set up DNS you must know the IP address of at least one of your
IMPORTANT:: DNS Servers.

Would you like to use DNS (y,n)?y

Enter IP Address of the Primary DNS Server


(IP address): 192.0.2.10
Found server 192.0.2.10

Enter IP Address of the Secondary DNS Server (other than Primary)


(IP address, or enter to bypass): Enter

Enter Fully Qualified Domain Name(FQDN: e.g. myhost.mydomain.com)


or IP address of the Primary NTP server
(FQDN or IP address, or enter for 192.0.2.10): demo.cisco.com
Found server cantor.cisco.com

Enter Fully Qualified Domain Name(FQDN: e.g. myhost.mydomain.com)


or IP address of the Secondary NTP Server

Installation Guide for Cisco Unity Express Virtual 10.2


16
Cisco Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server Modules
Example for Configuring the Cisco Unity Express Virtual

(FQDN or IP address, or enter to bypass): Enter

Please identify a location so that time zone rules can be set correctly.
Please select a continent or ocean.
1) Africa 4) Arctic Ocean 7) Australia 10) Pacific Ocean
2) Americas 5) Asia 8) Europe
3) Antarctica 6) Atlantic Ocean 9) Indian Ocean
#? 2
Please select a country.
1) Anguilla 29) Honduras
2) Antigua & Barbuda 30) Jamaica
3) Argentina 31) Martinique
4) Aruba 32) Mexico
5) Bahamas 33) Montserrat
6) Barbados 32) Netherlands Antilles
7) Belize 34) Nicaragua
8) Bolivia 35) Panama
9) Brazil 36) Paraguay
10) Canada 37) Peru
11) Caribbean NL 38) Puerto Rico
12) Cayman Islands 39) St Barthelemy
13) Chile 40) St Kitts & Nevis
14) Colombia 41) St Lucia
15) Costa Rica 42) St Maarten (Dutch)
16) Cuba 43) St Martin (French)
17) Curacao 44) St Pierre & Miquelon
18) Dominica 45) St Vincent
19) Dominican Republic 46) Suriname
20) Ecuador 47) Trinidad & Tobago
21) El Salvador 48) Turks & Caicos Is
22) French Guiana 49) United States
23) Greenland 50) Uruguay
24) Grenada 51) Venezuela
25) Guadeloupe 52) Virgin Islands (UK)
26) Guatemala 53) Virgin Islands (US)
27) Guyana
28) Haiti
#? 49
Please select one of the following time zone regions.
1) Eastern (most areas)
2) Eastern - MI (most areas)
3) Eastern - KY (Louisville area)
4) Eastern - KY (Wayne)
5) Eastern - IN (most areas)
6) Eastern - IN (Da, Du, K, Mn)
7) Eastern - IN (Pulaski)
8) Eastern - IN (Crawford)
9) Eastern - IN (Pike)
10) Eastern - IN (Switzerland)
11) Central (most areas)
12) Central - IN (Perry)
13) Central - IN (Starke)
14) Central - MI (Wisconsin border)
15) Central - ND (Oliver)
16) Central - ND (Morton rural)
17) Mountain (most areas)
18) Mountain - ID (south); OR (east)
19) Mountain Time - Navajo
20) MMST - Arizona (except navajo)
21) Pacific
22) Alaska (most areas)
23) Alaska - Juneau area
24) Alaska - Sitka area
25) Alaska - Annette Island

Installation Guide for Cisco Unity Express Virtual 10.2


17
Cisco Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server Modules
Example for Configuring the Cisco Unity Express Virtual

26) Alaska - Yakutat


27) Alaska (west)
28) Aleutian Islands
29) Hawaii
#? 21
The following information has been given:
United States
Pacific Time

Therefore TZ='America/Los_Angeles' will be used.


Is the above information OK?
1) Yes
2) No
#? 1

Local time is now: Thu May 16 17:12:11 PDT 2019.


Universal Time is now: Fri May 17 00:12:11 UTC 2019.
No NTP servers configured.
Would you like to manually adjust the system time (y,n)? n executing app post_install
Enter Call Agent
1) Cisco Unified Communications Manager (CUCM)
2) Cisco Unified Communications Manager Express (CUCME)
-- default #? 2
Setting Call Agent to CUCME
executing app post_install done postinstall2 - starting all the services
Created symlink from /etc/systemd/system/multi-user.target.wants/tomcat.service to
/usr/lib/systemd/system/tomcat.service.
Created symlink from /etc/systemd/system/multi-user.target.wants/superthread.service to
/usr/lib/systemd/system/superthread.service.
Created symlink from /etc/systemd/system/multi-user.target.wants/wfengine.service to
/usr/lib/systemd/system/wfengine.service.
Created symlink from /etc/systemd/system/multi-user.target.wants/media_ums.service to
/usr/lib/systemd/system/media_ums.service.
Created symlink from /etc/systemd/system/multi-user.target.wants/smartagent.service to
/usr/lib/systemd/system/smartagent.service.
Created symlink from /etc/systemd/system/default.target.wants/monit.service to
/usr/lib/systemd/system/monit.service.
Created symlink from /etc/systemd/system/default.target.wants/monitEnableAll.service to
/usr/lib/systemd/system/monitEnableAll.service.
Removed symlink /etc/systemd/system/serial-getty@ttyS0.service.
Created symlink from /etc/systemd/system/getty.target.wants/serial-getty@ttyS0.service to
/usr/lib/systemd/system/serial-getty@.service.

waiting for all services to come online ... 50

IMPORTANT::
IMPORTANT:: Administrator Account Creation
IMPORTANT::
IMPORTANT:: Create an administrator account.
IMPORTANT:: With this account, you can log in to the
IMPORTANT:: Cisco Unity Express Virtual
IMPORTANT:: GUI and run the initialization wizard.
IMPORTANT::

Enter administrator user ID:


(user ID): test
Enter password for test:
(password):
Confirm password for test by reentering it:
(password):

SYSTEM ONLINE

Installation Guide for Cisco Unity Express Virtual 10.2


18
Cisco Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server Modules
Example for Configuring the Cisco Unity Express Virtual

Router# show software versions


Cisco Unity Express Virtual version (10.2.0)
Components:

- CUE Voicemail Language Support version 10.2.0


- Netconf version 10.2.0

Router# show software packages

Installed Packages:
- Installer (Installer application) (10.2)
- Thirdparty (Service Engine Thirdparty Code) (10.2)
- Infrastructure (Service Engine Infrastructure) (10.2)
- Global (Global manifest) (10.2)
- GPL Infrastructure (Service Engine GPL Infrastructure) (10.2)
- Voice Mail (Voicemail application) (10.2)
- Bootloader (Primary) (Service Engine Bootloader) (10.2)
- Core (Service Engine OS Core) (10.2)
- Auto Attendant (Service Engine Telephony Infrastructure) (10.2)

Installed Plug-ins:
- CUE Voicemail Language Support (Languages global pack) (10.2)
- CUE Voicemail US English (English language pack) (10.2)
Router-Module>

The following is a sample configuration if n is selected:


IMPORTANT::
IMPORTANT:: Welcome to Cisco Systems Service Engine
IMPORTANT:: post installation configuration tool.
IMPORTANT::
IMPORTANT:: This is a one time process which will guide
IMPORTANT:: you through initial setup of your Service Engine.
IMPORTANT:: Once run, this process will have configured
IMPORTANT:: the system for your location.
IMPORTANT::
IMPORTANT:: If you do not wish to continue, initial setup will be skipped
IMPORTANT:: and you need to manually configure the system
IMPORTANT::

Do you wish to start configuration now (y,n)? n


Autoconfig: Skipping post install...
executing app post_install
Skipping product specific post install... defaulting values
Setting Call Agent to CUCME
executing app post_install done
Creating Postgres database .... done.
INIT: Switching to runlevel: 4
INIT: Sending processes the TERM signal
STARTED: ntp_startup.sh
STARTED: LDAP_startup.sh
STARTED: SQL_startup.sh
STARTED: dwnldr_startup.sh
STARTED: HTTP_startup.sh
STARTED: probe
STARTED: fndn_udins_wrapper
STARTED: superthread_startup.sh
STARTED: /usr/wfavvid/run-wfengine.sh
STARTED: /usr/bin/launch_ums.sh
STARTED: /bin/products/cue/nesla_licensing.sh

Waiting 49 ...

Installation Guide for Cisco Unity Express Virtual 10.2


19
Cisco Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server Modules
Verify Cisco Unified Communication Manager Express and Cisco Unity Express Virtual on ESXi

IMPORTANT::
IMPORTANT:: Administrator Account Creation
IMPORTANT::
IMPORTANT:: Create an administrator account. With this account,
IMPORTANT:: you can log in to the Cisco Unity Express GUI and
IMPORTANT:: run the initialization wizard.
IMPORTANT::

Enter administrator user ID:


(user ID): admin
Enter password for admin:
(password):
Confirm password for admin by reentering it:
(password):

(INIT)se-0-0-0-0#
(INIT)se-0-0-0-0#
INIT)se-0-0-0-0#
(INIT)se-0-0-0-0# conf t
Enter configuration commands, one per line. End with CNTL/Z.
(INIT)se-0-0-0-0(config)# inter
(INIT)se-0-0-0-0(config)# interface Fast
(INIT)se-0-0-0-0(config)# interface FastEthernet 0
(INIT)se-0-0-0-0(config-interface)# ip add
(INIT)se-0-0-0-0(config-interface)# ip address 192.0.2.20 255.255.0.0
(INIT)se-0-0-0-0(config-interface)# exit
(INIT)se-0-0-0-0(config)# def
(INIT)se-0-0-0-0(config)# default gat
(INIT)se-0-0-0-0(config)# ip de
(INIT)se-0-0-0-0(config)# ip default-gateway 192.0.2.30
(INIT)se-0-0-0-0(config)# end
SYSTEM ONLINE
se-0-0-0-0# conf t
Enter configuration commands, one per line. End with CNTL/Z.
se-0-0-0-0(config)# hostn
se-0-0-0-0(config)# hostname se-192.0.2.20
se-192.0.2.20(config)# end
se-192.0.2.20# wr
se-192.0.2.20#

Verify Cisco Unified Communication Manager Express and


Cisco Unity Express Virtual on ESXi
Step 1 Verify that the Cisco Unified Communication Manager Express is configured to support the Cisco Unity Express Virtual
software.
Step 2 Configure IP connectivity between the router and the Cisco Unity Express Virtual module. Use the following procedure
to configure Cisco Unity Express Virtual module with a double-wide E-Series Server: Configuration Options.
Note This step is applicable only for the Cisco UCS E-Series Servers.

Step 3 To configure IP connectivity between the router and the Cisco Unity Express Virtual module, perform the following step
to configure Cisco Unity Express Virtual module with a Cisco UCS Server: ip route cue-ip-address subnet mask
FastEthernetslot/port—creates a static route for the Cisco UCS Series Server.
Example:

Installation Guide for Cisco Unity Express Virtual 10.2


20
Cisco Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server Modules
Verify Cisco Unified Communication Manager and Cisco Unity Express Virtual on ESXi

Router# configure terminal


Router(config)# interface FastEthernet0/0
Router(config-if)# ip address 10.0.0.1 255.0.0.0
Router(config-if)# no shut
Router(config-if)# end

Router# configure terminal


Router(config)# ip route 10.0.0.2 255.255.255.255 FastEthernet0/0
Router(config)# end

Note This step is applicable only for the Cisco UCS Series Servers.

Verify Cisco Unified Communication Manager and Cisco Unity


Express Virtual on ESXi
Step 1 After installing and verifying Cisco Unified Communications Manager software functionality, you must be able to access
the Cisco Unified Communications Manager configuration web page.
Step 2 Configure IP connectivity between the router and the Cisco Unity Express Virtual module. Use the following procedure
to configure Cisco Unity Express Virtual module with a double-wide E-Series Server: Configuration Options.
Note This step is applicable only for the Cisco UCS E-Series Servers.

Step 3 To configure IP connectivity between the router and the Cisco Unity Express Virtual module, perform the following step
to configure Cisco Unity Express Virtual module with a Cisco UCS Server: ip route cue-ip-address subnet mask
FastEthernetslot/port—creates a static route for the Cisco UCS Series Server.
Example:

Router# configure terminal


Router(config)# interface FastEthernet0/0
Router(config-if)# ip address 10.0.0.1 255.0.0.0
Router(config-if)# no shut
Router(config-if)# end

Router# configure terminal


Router(config)# ip route 10.0.0.2 255.255.255.255 FastEthernet0/0
Router(config)# end

Note This step is applicable only for the Cisco UCS Series Servers.

Installation Guide for Cisco Unity Express Virtual 10.2


21
Cisco Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server Modules
Verify Cisco Unified Communication Manager and Cisco Unity Express Virtual on ESXi

Installation Guide for Cisco Unity Express Virtual 10.2


22
CHAPTER 5
Cisco Unity Express Virtual Software Support on
Cisco 4000 Series Integrated Services Routers
KVM Service Containers
The Cisco Unity Express Virtual software release adds support for installing Cisco Unity Express Virtual
software on the Cisco 4000 Series Integrated Services Routers KVM Service Containers.
• Overview of OVA Installation Steps on KVM Service Container, on page 23
• Hardware Requirements for Cisco Unity Express Virtual KVMs on Cisco 4000 Series Integrated Services
Routers, on page 24
• Install and Configure the Cisco Unity Express Virtual OVA on KVM Service Containers, on page 24
• Deactivate and Uninstall Cisco Unity Express Virtual from KVM Service Containers, on page 28
• Upgrade Cisco Unity Express Virtual 9.0.6 to 10.2, on page 29
• Example for Accessing and Configuring the Cisco Unity Express Virtual in Cisco 4000 Series Integrated
Services Routers Service Container, on page 30

Overview of OVA Installation Steps on KVM Service Container


The following steps provide an overview of Cisco Unity Express Virtual software installation on the Kernel
Virtual Machine Service Container.

Step 1 Download and copy the Cisco Unity Express Virtual software OVA file from the FTP server to Cisco 4000 Series
Integrated Services Routers (Cisco 4000 Series ISR) hard disk or boot flash drive.
Step 2 Install, Configure, and Activate virtual service.
Step 3 Connect to the installed virtual service.
For more information on how to install and configure, see Install and Configure the Cisco Unity Express Virtual OVA
on KVM Service Containers, on page 24.
If you want to re-install the OVA, you must first deactivate the installed virtual service and then uninstall the Cisco Unity
Express Virtual. For more information on deactivating and uninstalling Cisco Unity Express Virtual, see Deactivate and
Uninstall Cisco Unity Express Virtual from KVM Service Containers, on page 28.

Installation Guide for Cisco Unity Express Virtual 10.2


23
Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers
Hardware Requirements for Cisco Unity Express Virtual KVMs on Cisco 4000 Series Integrated Services Routers

Hardware Requirements for Cisco Unity Express Virtual KVMs


on Cisco 4000 Series Integrated Services Routers
Cisco Unity Express Virtual Software requires Cisco 4000 Series Integrated Services Routers (Cisco 4000
Series ISR) configured with Kernel Virtual Machine Service Container.
Table 3: Kernel Virtual Machine Requirements for Cisco 4000 Series ISR Service Container, on page 24
provides the Kernel Virtual Machine recommendations on Cisco 4000 Series ISR Service Container.

Table 3: Kernel Virtual Machine Requirements for Cisco 4000 Series ISR Service Container

Mailboxes CPU RAM Hard Flash External Interface Recording hours Maximum
Disk Voice
Ports

1-200 As per 8 GB Minimum 8 GB 1 Gigabit 120 20


Cisco 4000 50 GB Interface
Series ISR
platform

Note The Cisco Unity Express Virtual uses hard disk with a maximum ceiling limit of 20 GB only. Hence, when
you execute the show version CLI command on the Cisco Unity Express Virtual prompt, the hard disk capacity
displays as 20 GB, even when your router hard disk capacity may be 50 GB or higher.

Note You need a minimum of 8 GB memory to configure the virtual-service commands while installing and
configuring the Cisco Unity Express Virtual Software.

Note The above-mentioned hardware requirements are applicable exclusively for installing and configuring Cisco
Unity Express and its resources. However, you must provision additional memory in the router to configure
other features like Cisco Unified CME.

Install and Configure the Cisco Unity Express Virtual OVA on


KVM Service Containers
The Open Virtualization Archive (OVA) file contains a compressed, installable version of the virtual machine.
To download the Cisco Unity Express Virtual server (OVA) file from the FTP server and then, install and
configure the Cisco Unity Express Virtual virtual service use the following procedure.

Installation Guide for Cisco Unity Express Virtual 10.2


24
Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers
Install and Configure the Cisco Unity Express Virtual OVA on KVM Service Containers

Note Note that the virtual service upgrade and installation procedures are the same for Cisco Unity Express Virtual.
Ensure that you take backup of the system if you want to upgrade or re-install. For more information, see
Manually Backing Up Files, on page 49.

Before you begin


• Cisco Unity Express Virtual OVA file downloaded to your local drive or to a boot flash drive
• Command Line Interface to interact with the router
• SSH client to configure Cisco Unity Express Virtual

SUMMARY STEPS
1. telnet ip-address
2. enable
3. copy tftp {flash | harddisk}
4. virtual-service install name service-name package uri/package-location: .ova
5. show virtual-service list
6. configure terminal
7. interface VirtualPortGroup number
8. ip unnumbered type number
9. virtual-service service-name
10. vnic gateway VirtualPortGroup instance-number
11. guest ip address vm ip-address
12. end
13. configure terminal
14. ip route vm-ip | subnet mask | VirtualPortGroup Interface
15. virtual-service service-name
16. activate
17. virtual-service connect name service-name console

DETAILED STEPS

Command or Action Purpose


Step 1 telnet ip-address Log in to the router terminal using your telnet or ssh log
in credentials.
Example:
telnet 10.65.125.154 Enter your password if prompted.

Step 2 enable Enters the privileged EXEC mode.


Example:
Router> enable

Installation Guide for Cisco Unity Express Virtual 10.2


25
Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers
Install and Configure the Cisco Unity Express Virtual OVA on KVM Service Containers

Command or Action Purpose


Step 3 copy tftp {flash | harddisk} Allows you to access the tftp file server and to copy the
OVA package to a desired location on your local hard disk
Example:
or a boot flash drive.
Select the filename and press Enter to confirm the
Destination filename.

Step 4 virtual-service install name service-name package Installs the virtual service.
uri/package-location: .ova
Note The command virtual-service name is
case-sensitive. For example, if you configure
virtual-service vCUE and virtual-service vcue,
two different instances of Cisco Unity Express
Virtual is created.

Step 5 show virtual-service list Lists the service package name and the installation status.
Example:
Step 6 configure terminal Enters the router configuration mode.
Example:
Router# configure terminal

Step 7 interface VirtualPortGroup number To configure the installed service, you must first configure
the VirtualPortGroup interfaces.
Example:
Router(config)# interface VirtualPortGroup 1 The VirtualPortGroup forms a bridge and is configured as
the default gateway between the installed VM and the host
router.

Step 8 ip unnumbered type number Enables IP processing on an interface without assigning


an explicit IP address to that interface, where:
Example:
Router(config-if)# ip unnumbered GigabitEthernet • type—Type of interface on which the router has an
0/0/0 assigned IP address.
• number—Number of the interface and sub-interface
on which the router has an assigned IP address.

Note The unnumbered interface must be unique. It


cannot be another unnumbered interface.

Step 9 virtual-service service-name Enters the virtual service in configuration mode.


Example: Note You need a minimum of 8 GB memory to
Router(config)# virtual-service cue configure the virtual-service commands.

Step 10 vnic gateway VirtualPortGroup instance-number Associates the VirtualPortGroup interface with the virtual
service.
Example:

Installation Guide for Cisco Unity Express Virtual 10.2


26
Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers
Install and Configure the Cisco Unity Express Virtual OVA on KVM Service Containers

Command or Action Purpose


Router(config-virt-serv)# vnic gateway Note VirtualPortGroup 1 is mapped to FastEthernet0
VirtualPortGroup 1
interface, and VirtualPortGroup 2 is mapped to
FastEthernet1 interface of Cisco Unity Express
Virtual. Hence, you must associate both the
VirtualPortGroup interfaces with the virtual
service in correct sequence for Cisco Unity
Express Virtual 9.0.2 and later releases. For
example,

virtual-service cue
vnic gateway VirtualPortGroup 1
vnic gateway VirtualPortGroup 2

Step 11 guest ip address vm ip-address Allows you to specify ip address of the virtual machine.
Example:
Router(config-virt-serv-vnic)# guest ip address
10.65.125.155

Step 12 end Exits the virtual service configuration vnic mode.


Example:
Router(config-virt-serv-vnic)# end

Step 13 configure terminal Enters the router configuration mode.


Example:
Router# configure terminal

Step 14 ip route vm-ip | subnet mask | VirtualPortGroup Interface Allows you to add static IP route for the guest VM
instance.
Example:
Router(config)# ip route 10.65.125.155 The VirtualPortGroup forms a bridge and a gateway
255.255.255.255 VirtualPortGroup1 between the host router and the installed VM using this ip
route.

Step 15 virtual-service service-name Enters the virtual-service configuration mode.


Example:
Router(config)# virtual-service cue

Step 16 activate Activates the virtual service.


Example: Note To view the service activation status, enter the
Router(config-virt-serv)# activate show virtual-service list command after exiting
from the virtual service configuration.
% Activating virtual-service 'cue', this might
take a few minutes.
Use 'show virtual-service list' for progress.

Installation Guide for Cisco Unity Express Virtual 10.2


27
Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers
Deactivate and Uninstall Cisco Unity Express Virtual from KVM Service Containers

Command or Action Purpose


Step 17 virtual-service connect name service-name console Allows you to connect to the virtual service. The
service-name is the same service name given in the
Example:
previous step.
Router# virtual-service connect name cue console
Connected to appliance. Exit using ^c^c^c

Deactivate and Uninstall Cisco Unity Express Virtual from KVM


Service Containers
If you want to reinstall or uninstall the Cisco Unity Express Virtual virtual service from the KVM Service
Container, you must to first deactivate the virtual service. To uninstall Cisco Unity Express virtual service,
perform the following procedure:

SUMMARY STEPS
1. enable
2. configure terminal
3. virtual-service service-name
4. no activate
5. end
6. show virtual-service list
7. virtual-service uninstall name service-name
8. exit

DETAILED STEPS

Command or Action Purpose


Step 1 enable Note We recommend you to unregister from smart
licensing server before uninstalling CUE.
Example:
Router# enable Enters the privileged EXEC mode.

Step 2 configure terminal Enters the router configuration mode.


Example:
Router# configure terminal

Step 3 virtual-service service-name Enters the virtual-service configuration mode.


Example:
Router(config)# virtual-service cue

Step 4 no activate Deactivates the virtual service.


Example:
Router(config-virt-serv)# no activate

Installation Guide for Cisco Unity Express Virtual 10.2


28
Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers
Upgrade Cisco Unity Express Virtual 9.0.6 to 10.2

Command or Action Purpose


Step 5 end Exits the virtual service mode.
Example:
Router(config-virt-serv)# end

Step 6 show virtual-service list To view the service activation status, enter the show
virtual-service list command after exiting from the virtual
service configuration.

Step 7 virtual-service uninstall name service-name Enter this command to uninstall the virtual service.
Example:
Router# virtual-service uninstall name cue

Step 8 exit Exits the current mode.


Example:
Router# exit

Upgrade Cisco Unity Express Virtual 9.0.6 to 10.2


Before you begin
• To upgrade the Cisco Unity Express Virtual from Release version 9.0.6 to 10.2, you must configure two
virtual port group interfaces and associate both the interfaces to the virtual-service. For details on
configuration, see Install and Configure the Cisco Unity Express Virtual OVA on KVM Service Containers,
on page 24.

SUMMARY STEPS
1. Log in to Cisco Unity Express Virtual.
2. Deactivate the virtual service. For details on deactivating the virtual service, see Deactivate and Uninstall
Cisco Unity Express Virtual from KVM Service Containers, on page 28.
3. Use the virtual-service upgrade command in Privileged EXEC mode to upgrade the Cisco Unity Express
Virtual from Release version 9.0.6 to 10.2.

DETAILED STEPS

Step 1 Log in to Cisco Unity Express Virtual.


Step 2 Deactivate the virtual service. For details on deactivating the virtual service, see Deactivate and Uninstall Cisco Unity
Express Virtual from KVM Service Containers, on page 28.
Step 3 Use the virtual-service upgrade command in Privileged EXEC mode to upgrade the Cisco Unity Express Virtual from
Release version 9.0.6 to 10.2.
Example:

Installation Guide for Cisco Unity Express Virtual 10.2


29
Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers
Example for Accessing and Configuring the Cisco Unity Express Virtual in Cisco 4000 Series Integrated Services Routers Service Container

Router# virtual-service upgrade name cue package bootflash:CUE-Virtual-10-1-0-ISR4K.ova

Example for Accessing and Configuring the Cisco Unity Express


Virtual in Cisco 4000 Series Integrated Services Routers Service
Container
When you access virtual-service for the first time, the system automatically launches the post installation
configuration procedure, and asks you if you want to start configuration immediately.
Enter the appropriate response, y or n. If you enter y, the system asks you to confirm, then begin the interactive
post installation configuration process.
If you enter n, the initial setup wizard is skipped, and you are prompted to enter the administrator user ID and
password.
If you do not enter any input for two minutes, the initial setup wizard is skipped, and you are prompted to
enter the IP address, netmask, and default gateway address.
The following is a sample configuration if y is selected:
IMPORTANT::
IMPORTANT:: Welcome to Cisco Systems Service Engine
IMPORTANT:: post installation configuration tool.
IMPORTANT::
IMPORTANT:: This is a one time process which will guide
IMPORTANT:: you through initial setup of your Service Engine.
IMPORTANT:: Once run, this process will have configured
IMPORTANT:: the system for your location.
IMPORTANT::
IMPORTANT:: If you do not wish to continue, the system will be halted
IMPORTANT:: so it can be safely removed from the router.
IMPORTANT::

Do you wish to start configuration now (y,n)? y


Are you sure (y,n)? y

***********************************
* Service Engine IP configuration *
***********************************
Please enter the IP address of your Module: 192.0.2.10
Please enter the netmask of your Module: 255.255.0.0
Please enter the default gateway for your Module: 192.0.2.20

The following IP configuration is set:

IP : 192.0.2.10
NETMASK:255.255.0.0
GATEWAY: 255.255.0.0

Do you wish to use this configuration (y, n) [n]: y

Enter Hostname
(my-hostname, or enter to use Router): Enter
Using Router as default

Installation Guide for Cisco Unity Express Virtual 10.2


30
Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers
Example for Accessing and Configuring the Cisco Unity Express Virtual in Cisco 4000 Series Integrated Services Routers Service Container

Enter Domain Name


(mydomain.com, or enter to use local domain): Enter
Using localdoamin as default

IMPORTANT:: DNS Configuration:


IMPORTANT::
IMPORTANT:: This allows the entry of hostnames, for example foo.cisco.com, instead
IMPORTANT:: of IP addresses like 1.123.45.678 for application configuration. In order
IMPORTANT:: to set up DNS you must know the IP address of at least one of your
IMPORTANT:: DNS Servers.

Would you like to use DNS (y,n)?y

Enter IP Address of the Primary DNS Server


(IP address): 192.0.2.10
Found server 192.0.2.10

Enter IP Address of the Secondary DNS Server (other than Primary)


(IP address, or enter to bypass): Enter

Enter Fully Qualified Domain Name(FQDN: e.g. myhost.mydomain.com)


or IP address of the Primary NTP server
(FQDN or IP address, or enter for 192.0.2.10): demo.cisco.com
Found server cantor.cisco.com

Enter Fully Qualified Domain Name(FQDN: e.g. myhost.mydomain.com)


or IP address of the Secondary NTP Server
(FQDN or IP address, or enter to bypass): Enter

Please identify a location so that time zone rules can be set correctly.
Please select a continent or ocean.
1) Africa 4) Arctic Ocean 7) Australia 10) Pacific Ocean
2) Americas 5) Asia 8) Europe
3) Antarctica 6) Atlantic Ocean 9) Indian Ocean
#? 2
Please select a country.
1) Anguilla 29) Honduras
2) Antigua & Barbuda 30) Jamaica
3) Argentina 31) Martinique
4) Aruba 32) Mexico
5) Bahamas 33) Montserrat
6) Barbados 32) Netherlands Antilles
7) Belize 34) Nicaragua
8) Bolivia 35) Panama
9) Brazil 36) Paraguay
10) Canada 37) Peru
11) Caribbean NL 38) Puerto Rico
12) Cayman Islands 39) St Barthelemy
13) Chile 40) St Kitts & Nevis
14) Colombia 41) St Lucia
15) Costa Rica 42) St Maarten (Dutch)
16) Cuba 43) St Martin (French)
17) Curacao 44) St Pierre & Miquelon
18) Dominica 45) St Vincent
19) Dominican Republic 46) Suriname
20) Ecuador 47) Trinidad & Tobago
21) El Salvador 48) Turks & Caicos Is
22) French Guiana 49) United States
23) Greenland 50) Uruguay
24) Grenada 51) Venezuela
25) Guadeloupe 52) Virgin Islands (UK)
26) Guatemala 53) Virgin Islands (US)
27) Guyana
28) Haiti

Installation Guide for Cisco Unity Express Virtual 10.2


31
Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers
Example for Accessing and Configuring the Cisco Unity Express Virtual in Cisco 4000 Series Integrated Services Routers Service Container

#? 49
Please select one of the following time zone regions.
1) Eastern (most areas)
2) Eastern - MI (most areas)
3) Eastern - KY (Louisville area)
4) Eastern - KY (Wayne)
5) Eastern - IN (most areas)
6) Eastern - IN (Da, Du, K, Mn)
7) Eastern - IN (Pulaski)
8) Eastern - IN (Crawford)
9) Eastern - IN (Pike)
10) Eastern - IN (Switzerland)
11) Central (most areas)
12) Central - IN (Perry)
13) Central - IN (Starke)
14) Central - MI (Wisconsin border)
15) Central - ND (Oliver)
16) Central - ND (Morton rural)
17) Mountain (most areas)
18) Mountain - ID (south); OR (east)
19) Mountain Time - Navajo
20) MMST - Arizona (except navajo)
21) Pacific
22) Alaska (most areas)
23) Alaska - Juneau area
24) Alaska - Sitka area
25) Alaska - Annette Island
26) Alaska - Yakutat
27) Alaska (west)
28) Aleutian Islands
29) Hawaii
#? 21
The following information has been given:
United States
Pacific Time

Therefore TZ='America/Los_Angeles' will be used.


Is the above information OK?
1) Yes
2) No
#? 1
Local time is now: Thu May 16 17:12:11 PDT 2019.
Universal Time is now: Fri May 17 00:12:11 UTC 2019.
No NTP servers configured.
Would you like to manually adjust the system time (y,n)? n executing app post_install
Enter Call Agent
1) Cisco Unified Communications Manager (CUCM)
2) Cisco Unified Communications Manager Express (CUCME)
-- default #? 2
Setting Call Agent to CUCME
executing app post_install done postinstall2 - starting all the services
Created symlink from /etc/systemd/system/multi-user.target.wants/tomcat.service to
/usr/lib/systemd/system/tomcat.service.
Created symlink from /etc/systemd/system/multi-user.target.wants/superthread.service to
/usr/lib/systemd/system/superthread.service.
Created symlink from /etc/systemd/system/multi-user.target.wants/wfengine.service to
/usr/lib/systemd/system/wfengine.service.
Created symlink from /etc/systemd/system/multi-user.target.wants/media_ums.service to
/usr/lib/systemd/system/media_ums.service.
Created symlink from /etc/systemd/system/multi-user.target.wants/smartagent.service to
/usr/lib/systemd/system/smartagent.service.
Created symlink from /etc/systemd/system/default.target.wants/monit.service to
/usr/lib/systemd/system/monit.service.
Created symlink from /etc/systemd/system/default.target.wants/monitEnableAll.service to

Installation Guide for Cisco Unity Express Virtual 10.2


32
Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers
Example for Accessing and Configuring the Cisco Unity Express Virtual in Cisco 4000 Series Integrated Services Routers Service Container

/usr/lib/systemd/system/monitEnableAll.service.
Removed symlink /etc/systemd/system/serial-getty@ttyS0.service.
Created symlink from /etc/systemd/system/getty.target.wants/serial-getty@ttyS0.service to
/usr/lib/systemd/system/serial-getty@.service.

waiting for all services to come online ... 50

IMPORTANT::
IMPORTANT:: Administrator Account Creation
IMPORTANT::
IMPORTANT:: Create an administrator account.
IMPORTANT:: With this account, you can log in to the
IMPORTANT:: Cisco Unity Express Virtual
IMPORTANT:: GUI and run the initialization wizard.
IMPORTANT::

Enter administrator user ID:


(user ID): test
Enter password for test:
(password):
Confirm password for test by reentering it:
(password):

SYSTEM ONLINE
Router# show software versions
Cisco Unity Express Virtual version (10.2.0)
Components:

- CUE Voicemail Language Support version 10.2.0


- Netconf version 10.2.0

Router# show software packages

Installed Packages:
- Installer (Installer application) (10.2)
- Thirdparty (Service Engine Thirdparty Code) (10.2)
- Infrastructure (Service Engine Infrastructure) (10.2)
- Global (Global manifest) (10.2)
- GPL Infrastructure (Service Engine GPL Infrastructure) (10.2)
- Voice Mail (Voicemail application) (10.2)
- Bootloader (Primary) (Service Engine Bootloader) (10.2)
- Core (Service Engine OS Core) (10.2)
- Auto Attendant (Service Engine Telephony Infrastructure) (10.2)

Installed Plug-ins:
- CUE Voicemail Language Support (Languages global pack) (10.2)
- CUE Voicemail US English (English language pack) (10.2)
Router-Module>

The following is a sample configuration if n is selected:

IMPORTANT::
IMPORTANT:: Welcome to Cisco Systems Service Engine
IMPORTANT:: post installation configuration tool.
IMPORTANT::
IMPORTANT:: This is a one time process which will guide
IMPORTANT:: you through initial setup of your Service Engine.
IMPORTANT:: Once run, this process will have configured
IMPORTANT:: the system for your location.
IMPORTANT::
IMPORTANT:: If you do not wish to continue, initial setup will be skipped

Installation Guide for Cisco Unity Express Virtual 10.2


33
Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers
Example for Accessing and Configuring the Cisco Unity Express Virtual in Cisco 4000 Series Integrated Services Routers Service Container

IMPORTANT:: and you need to manually configure the system


IMPORTANT::

Do you wish to start configuration now (y,n)? n


Autoconfig: Skipping post install...
executing app post_install
Skipping product specific post install... defaulting values
Setting Call Agent to CUCME
executing app post_install done
Creating Postgres database .... done.
INIT: Switching to runlevel: 4
INIT: Sending processes the TERM signal
STARTED: ntp_startup.sh
STARTED: LDAP_startup.sh
STARTED: SQL_startup.sh
STARTED: dwnldr_startup.sh
STARTED: HTTP_startup.sh
STARTED: probe
STARTED: fndn_udins_wrapper
STARTED: superthread_startup.sh
STARTED: /usr/wfavvid/run-wfengine.sh
STARTED: /usr/bin/launch_ums.sh
STARTED: /bin/products/cue/nesla_licensing.sh

Waiting 49 ...

IMPORTANT::
IMPORTANT:: Administrator Account Creation
IMPORTANT::
IMPORTANT:: Create an administrator account. With this account,
IMPORTANT:: you can log in to the Cisco Unity Express GUI and
IMPORTANT:: run the initialization wizard.
IMPORTANT::

Enter administrator user ID:


(user ID): admin
Enter password for admin:
(password):
Confirm password for admin by reentering it:
(password):

(INIT)se-0-0-0-0#
(INIT)se-0-0-0-0#
INIT)se-0-0-0-0#
(INIT)se-0-0-0-0# conf t
Enter configuration commands, one per line. End with CNTL/Z.
(INIT)se-0-0-0-0(config)# inter
(INIT)se-0-0-0-0(config)# interface Fast
(INIT)se-0-0-0-0(config)# interface FastEthernet 0
(INIT)se-0-0-0-0(config-interface)# ip add
(INIT)se-0-0-0-0(config-interface)# ip address 192.0.2.35 255.255.0.0
(INIT)se-0-0-0-0(config-interface)# exit
(INIT)se-0-0-0-0(config)# def
(INIT)se-0-0-0-0(config)# default gat
(INIT)se-0-0-0-0(config)# ip de
(INIT)se-0-0-0-0(config)# ip default-gateway 192.0.2.36
(INIT)se-0-0-0-0(config)# end
SYSTEM ONLINE
se-0-0-0-0# conf t
Enter configuration commands, one per line. End with CNTL/Z.
se-0-0-0-0(config)# hostn
se-0-0-0-0(config)# hostname se-192.0.2.35

Installation Guide for Cisco Unity Express Virtual 10.2


34
Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers
Example for Accessing and Configuring the Cisco Unity Express Virtual in Cisco 4000 Series Integrated Services Routers Service Container

se-192-0-2-35(config)# end
se-192-0-2-35# wr
se-192-0-2-35#

Installation Guide for Cisco Unity Express Virtual 10.2


35
Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers
Example for Accessing and Configuring the Cisco Unity Express Virtual in Cisco 4000 Series Integrated Services Routers Service Container

Installation Guide for Cisco Unity Express Virtual 10.2


36
CHAPTER 6
Configure Cisco Unity Express Virtual Application
Cisco Unity Express Virtual can be configured in the following ways:
• Configure Cisco Unity Express Virtual using GUI, on page 37
• Configure Cisco Unity Express Virtual using CLI, on page 37

Configure Cisco Unity Express Virtual using GUI


Cisco Unity Express Virtual can be configured using Graphical User Interface (GUI). The GUI can be accessed
by using the IP address provided during installation.

Configure Cisco Unity Express Virtual using CLI


Cisco Unity Express Virtual can be configured using the Command Line Interface (CLI). Log in to Cisco
Unity Express Virtual using your ssh user credentials, that was created during Cisco Unity Express Virtual
installation. This User ID is automatically assigned admin privileges. Example: ssh adminUser @CUE-IP.
The Cisco Unity Express Virtual software CLI prompt displays.

Note Configuring Cisco Unity Express Virtual using service-module command from Unified CME is not supported.

Installation Guide for Cisco Unity Express Virtual 10.2


37
Configure Cisco Unity Express Virtual Application
Configure Cisco Unity Express Virtual using CLI

Installation Guide for Cisco Unity Express Virtual 10.2


38
CHAPTER 7
Cisco Unity Express Virtual Licensing
Cisco Unity Express Virtual Release 10.2 supports only Cisco Smart Software Licensing. For information on
configuring Cisco Smart Licenses, see Cisco Unity Express VoiceMail and Auto Attendant CLI Administrator
Guide, and Configuring Cisco Unity Express 10.2 Using the GUI.
• Installation Sequence, on page 39
• Activate Evaluation Licenses, on page 39

Installation Sequence
Cisco Unity Express Virtual software licenses are installed in the following order:
1. Mailbox licenses
2. IVR licenses

Note These steps are applicable for Cisco Unity Express release v 9.0.0 through 9.0.3. The process is different from
release 9.0.5 with Smart Licensing.

Activate Evaluation Licenses


Cisco Unity Express Virtual release software image includes the evaluation license. Evaluation license allows
you to evaluate the feature. Evaluation License expires after 60 days. The following procedure enables you
to:
• Activate the mailbox evaluation license, accept EULA.
• Activate the IVR session evaluation license.
• Verify the licenses that are active.

Caution If you use the IVR functionality, then make sure to enable the number of total ports license is more than the
IVR sessions license. If the number of ports is equal to or less than the IVR sessions, then voicemail is disabled.

Installation Guide for Cisco Unity Express Virtual 10.2


39
Cisco Unity Express Virtual Licensing
Activate Evaluation Licenses

SUMMARY STEPS
1. license activate voicemail mailboxes
2. license activate ivr sessions
3. If you have already logged in to Cisco Unity Express Virtual GUI, log out from Cisco Unity Express
Virtual GUI and log in again.
4. show license all

DETAILED STEPS

Command or Action Purpose


Step 1 license activate voicemail mailboxes Use this command to activate the license for mailboxes. It
presents the End User License Agreement if it was not
Example:
accepted earlier.
cue# license activate voicemail mailboxes 275

Evaluation licenses are being activated in the


device for the following feature(s):
Feature Name: VMIVR-VM-MBX

PLEASE READ THE FOLLOWING TERMS CAREFULLY.


INSTALLING THE LICENSE OR
LICENSE KEY PROVIDED FOR ANY CISCO PRODUCT FEATURE
OR USING SUCH
PRODUCT FEATURE CONSTITUTES YOUR FULL ACCEPTANCE
OF THE FOLLOWING
TERMS. YOU MUST NOT PROCEED FURTHER IF YOU ARE NOT
WILLING TO BE BOUND
BOUND BY ALL THE TERMS SET FORTH HEREIN.

You hereby acknowledge and agree that the product


feature license
is terminable and that the product feature enabled
by such license
may be shut down or terminated by Cisco after
expiration of the
applicable term of the license (e.g., 30-day trial
period). Cisco
reserves the right to terminate or shut down any
such product feature
electronically or by any other means available.
While alerts or such
messages may be provided, it is your sole
responsibility to monitor
your terminable usage of any product feature
enabled by the license
and to ensure that your systems and networks are
prepared for the shut
down of the product feature. You acknowledge and
agree that Cisco will
not have any liability whatsoever for any damages,
including, but not
limited to, direct, indirect, special, or
consequential damages related
to any product feature being shutdown or
terminated. By clicking the
"accept" button or typing "yes" you are indicating
you have read and
agree to be bound by all the terms provided herein.
ACCEPT? [y/n]? yes

Installation Guide for Cisco Unity Express Virtual 10.2


40
Cisco Unity Express Virtual Licensing
Activate Evaluation Licenses

Command or Action Purpose

License activation count saved for use at next


reload

Step 2 license activate ivr sessions Use this command to activate the license for IVR sessions.
The output is similar to the output for activating the license
Example:
for mailboxes as shown in the previous step.
cue# license activate ivr sessions 2

Step 3 If you have already logged in to Cisco Unity Express Virtual If you have already logged in to Cisco Unity Express Virtual
GUI, log out from Cisco Unity Express Virtual GUI and GUI, log out from Cisco Unity Express Virtual GUI and
log in again. log in again to view the IVR pages.
Step 4 show license all Use this command to verify the information related to Smart
Licensing.
Example:
cue# show license all
Smart Licensing Status
=======================
Smart Licensing is ENABLED

Registration:
Status: REGISTERED
Smart Account: BU Production Test
Virtual Account: CUBE Sat Test
Export-Controlled Functionality: Allowed
Initial Registration: SUCCEEDED on May 21 08:32:38
2019 IST
Last Renewal Attempt: SUCCEEDED on May 21 08:32:38
2019 IST
Next Renewal Attempt: Nov 17 08:32:38 2019 IST
Registration Expires: May 20 08:27:55 2020 IST

License Authorization:
Status: AUTHORIZED on May 21 08:32:53 2019 IST
Last Communication Attempt: SUCCEEDED on May 21
08:32:53 2019 IST
Next Communication Attempt: Jun 20 08:32:53 2019
IST
Communication Deadline: Aug 19 08:28:03 2019 IST

License Conversion:
Automatic Conversion Enabled: true
Status: NOT STARTED

Utility: Status: DISABLED

Transport: Type: TransportCallHome

Evaluation Period:
Evaluation Mode: Not In Use
Evaluation Period Remaining: 89 days, 23 hr, 29
min, 1 sec

License Usage
=============
License Authorization Status: AUTHORIZED as of May
21 08:32:53 2019 IST

Installation Guide for Cisco Unity Express Virtual 10.2


41
Cisco Unity Express Virtual Licensing
Activate Evaluation Licenses

Command or Action Purpose


Unity Express 10.x Voicemail Box
(regid.2019-01.com.cisco.CUE_VM,10.0_f68bed0a-611d-47c8-8fd6-0f6673cb4c45)

Description: Cisco Unity Express voicemail box


license
Count: 1
Version: 10.2
Status: InCompliance

Unity Express 10.x IVR Session


(regid.2019-01.com.cisco.CUE_IVR,10.0_50fbd88c-8120-4b14-af19-52355fdae940)

Description: Cisco Unity Express IVR session


license
Count: 2
Version: 10.2
Status: InCompliance

Product Information
===================
UDI: PID:UC_VCUE,SN:TZnZJUz7kZS

Agent Version
=============
Smart Agent for Licensing: 3.0.9

Installation Guide for Cisco Unity Express Virtual 10.2


42
CHAPTER 8
Migrating to Cisco Unity Express Virtual 10.2
This section provides details on migrating to Cisco Unity Express Virtual 10.2
• Migrate Cisco Software Licensing (CSL) to Cisco Smart Software Licensing, on page 43
• Migrate Cisco Unity Express Virtual 8.6.12 (SRE) to Cisco Unity Express Virtual 10.2, on page 43
• Migrate Cisco Unity Express Virtual 9.0.x to Cisco Unity Express Virtual 10.2, on page 45
• Migrate Cisco Unity Express Virtual 10.0.x to Cisco Unity Express Virtual 10.2, on page 46

MigrateCiscoSoftwareLicensing(CSL)toCiscoSmartSoftware
Licensing
This feature applies for any release up to 9.0.3 migrating to anything 9.0.5 onwards.
Perform the following steps to convert your CSL license to Cisco Smart license.

Step 1 Request for a Smart Account and a virtual account using the Cisco portal, http://www.cisco.com/go/smartlicensing. If
you already have a Smart Account, proceed to step 2.
Step 2 Add your devices in your virtual account using the SRE or Cisco Unity Express Virtual product activation keys (PAKs)
in the Product License Registration portal.
Step 3 Select the PAKs that you have added, and convert them to smart license entitlements.
You can view the licenses in your virtual account.

Migrate Cisco Unity Express Virtual 8.6.12 (SRE) to Cisco Unity


Express Virtual 10.2
Perform the following steps to migrate Cisco Unity Express 8.6.12 (SRE) to Cisco Unity Express Virtual
10.2.

SUMMARY STEPS
1. Back up your Cisco Unity Express 8.6.12 configurations.

Installation Guide for Cisco Unity Express Virtual 10.2


43
Migrating to Cisco Unity Express Virtual 10.2
Migrate Cisco Unity Express Virtual 8.6.12 (SRE) to Cisco Unity Express Virtual 10.2

2. Install the Cisco Unity Express Virtual 10.2 on ISR 4000 series KVM container or Cisco UCS or UCS
E-series server modules.
3. Smart Licensing is enabled by default. If you need to use IVR feature, enable IVR license using license
activate ivr sessions CLI.
4. Ensure that both Cisco Unity Express 8.6.12 (SRE) and Cisco Unity Express Virtual 10.2. has same
hostname, and then restore the backup to the newly installed Cisco Unity Express.
5. Once the Cisco Unity Express Virtual 10.2 reboots, the system comes up in INIT mode. Configure the IP
address and default gateway address, and save the configuration.
6. Smart agent is enabled by default. The Cisco Unity Express enters an evaluation period of 90 days, as
there are active mailboxes or IVR sessions in the Cisco Unity Express backup. After the evaluation period
expires, the Cisco Unity Express stops functioning normally.
7. Log in to your Smart Account in Cisco Smart Software Manager, and generate a token ID.
8. Register your Cisco Unity Express product instance using the token ID.
9. Once the Cisco Unity Express product instance is registered and authorized, the voicemail and IVR count
gets updated in the Cisco licensing portal.

DETAILED STEPS

Step 1 Back up your Cisco Unity Express 8.6.12 configurations.


Step 2 Install the Cisco Unity Express Virtual 10.2 on ISR 4000 series KVM container or Cisco UCS or UCS E-series server
modules.
Step 3 Smart Licensing is enabled by default. If you need to use IVR feature, enable IVR license using license activate ivr
sessions CLI.
Step 4 Ensure that both Cisco Unity Express 8.6.12 (SRE) and Cisco Unity Express Virtual 10.2. has same hostname, and then
restore the backup to the newly installed Cisco Unity Express.
Step 5 Once the Cisco Unity Express Virtual 10.2 reboots, the system comes up in INIT mode. Configure the IP address and
default gateway address, and save the configuration.
Step 6 Smart agent is enabled by default. The Cisco Unity Express enters an evaluation period of 90 days, as there are active
mailboxes or IVR sessions in the Cisco Unity Express backup. After the evaluation period expires, the Cisco Unity
Express stops functioning normally.
Step 7 Log in to your Smart Account in Cisco Smart Software Manager, and generate a token ID.
Step 8 Register your Cisco Unity Express product instance using the token ID.
Step 9 Once the Cisco Unity Express product instance is registered and authorized, the voicemail and IVR count gets updated
in the Cisco licensing portal.
Note If the device exceeds the number of purchased licenses, then the license goes out of compliance, but the Cisco
Unity Express continues to function normally. You must purchase more licenses or limit the number of voicemail
or IVR sessions.

Note If you are on Cisco Unity Express Release 8.6.1, you must first upgrade it to version 8.12.1. After upgrading
to Cisco Unity Express Release 8.12.1, take a backup and upgrade to Cisco Unity Express Release 10.2.

Installation Guide for Cisco Unity Express Virtual 10.2


44
Migrating to Cisco Unity Express Virtual 10.2
Migrate Cisco Unity Express Virtual 9.0.x to Cisco Unity Express Virtual 10.2

Migrate Cisco Unity Express Virtual 9.0.x to Cisco Unity Express


Virtual 10.2
Perform the following steps to migrate Cisco Unity Express Virtual 9.0.x to Cisco Unity Express Virtual 10.2.

SUMMARY STEPS
1. Back up your Cisco Unity Express Virtual 9.0.x configurations.
2. If you are using Smart Licensing Version 9, unregister from CSSM.
3. Uninstall the Cisco Unity Express Virtual 9.0.x.
4. Reinstall and configure the Cisco Unity Express Virtual 10.2 on Cisco UCS or UCS E-series server
modules. For ISR 4000 series KVM containers, use virtual-service upgrade CLI command to upgrade
the Cisco Unity Express Virtual from version 9.0.x to 10.2.
5. Restore the backup to the newly installed Cisco Unity Express.
6. Smart agent is enabled by default. The Cisco Unity Express enters an evaluation period of 90 days. After
the evaluation period expires, register the product instance with the CSSM, otherwise Cisco Unity Express
stops functioning normally.
7. Log in to your Smart Account in Cisco Smart Software Manager, and generate a token ID.
8. Register your Cisco Unity Express product instance using the token ID.
9. Once the Cisco Unity Express product instance is registered and authorized, the voicemail and IVR count
gets updated in the Cisco Licensing portal.

DETAILED STEPS

Step 1 Back up your Cisco Unity Express Virtual 9.0.x configurations.


Step 2 If you are using Smart Licensing Version 9, unregister from CSSM.
Step 3 Uninstall the Cisco Unity Express Virtual 9.0.x.
Step 4 Reinstall and configure the Cisco Unity Express Virtual 10.2 on Cisco UCS or UCS E-series server modules. For ISR
4000 series KVM containers, use virtual-service upgrade CLI command to upgrade the Cisco Unity Express Virtual
from version 9.0.x to 10.2.
Step 5 Restore the backup to the newly installed Cisco Unity Express.
Step 6 Smart agent is enabled by default. The Cisco Unity Express enters an evaluation period of 90 days. After the evaluation
period expires, register the product instance with the CSSM, otherwise Cisco Unity Express stops functioning normally.
Step 7 Log in to your Smart Account in Cisco Smart Software Manager, and generate a token ID.
Step 8 Register your Cisco Unity Express product instance using the token ID.
Step 9 Once the Cisco Unity Express product instance is registered and authorized, the voicemail and IVR count gets updated
in the Cisco Licensing portal.
Note If the device exceeds the number of purchased licenses, then the license goes out of compliance, but Cisco
Unity Express continues to function normally. You must purchase more licenses or limit the number of voicemail
or IVR sessions.

Installation Guide for Cisco Unity Express Virtual 10.2


45
Migrating to Cisco Unity Express Virtual 10.2
Migrate Cisco Unity Express Virtual 10.0.x to Cisco Unity Express Virtual 10.2

MigrateCiscoUnityExpressVirtual10.0.xtoCiscoUnityExpress
Virtual 10.2
Perform the following steps to migrate Cisco Unity Express Virtual 10.0.x to Cisco Unity Express Virtual
10.2.

SUMMARY STEPS
1. Back up your Cisco Unity Express Virtual 10.0.x configurations.
2. Uninstall the Cisco Unity Express Virtual 10.0.x.
3. Reinstall and configure the Cisco Unity Express Virtual 10.2 on Cisco UCS or UCS E-series server
modules. For ISR 4000 series KVM containers, use virtual-service upgrade CLI command to upgrade
the Cisco Unity Express Virtual from version 10.0.x to 10.2.
4. Restore the backup to the newly installed Cisco Unity Express.
5. Smart agent is enabled by default. The Cisco Unity Express enters an evaluation period of 90 days. After
the evaluation period expires, register the product instance with the CSSM, otherwise Cisco Unity Express
stops functioning normally.
6. Log in to your Smart Account in Cisco Smart Software Manager, and generate a token ID.
7. Register your Cisco Unity Express product instance using the token ID.
8. Once the Cisco Unity Express product instance is registered and authorized, the voicemail and IVR count
gets updated in the Cisco Licensing portal.

DETAILED STEPS

Step 1 Back up your Cisco Unity Express Virtual 10.0.x configurations.


Step 2 Uninstall the Cisco Unity Express Virtual 10.0.x.
Step 3 Reinstall and configure the Cisco Unity Express Virtual 10.2 on Cisco UCS or UCS E-series server modules. For ISR
4000 series KVM containers, use virtual-service upgrade CLI command to upgrade the Cisco Unity Express Virtual
from version 10.0.x to 10.2.
Step 4 Restore the backup to the newly installed Cisco Unity Express.
Step 5 Smart agent is enabled by default. The Cisco Unity Express enters an evaluation period of 90 days. After the evaluation
period expires, register the product instance with the CSSM, otherwise Cisco Unity Express stops functioning normally.
Step 6 Log in to your Smart Account in Cisco Smart Software Manager, and generate a token ID.
Step 7 Register your Cisco Unity Express product instance using the token ID.
Step 8 Once the Cisco Unity Express product instance is registered and authorized, the voicemail and IVR count gets updated
in the Cisco Licensing portal.
Note If the device exceeds the number of purchased licenses, then the license goes out of compliance, but Cisco
Unity Express continues to function normally. You must purchase more licenses or limit the number of voicemail
or IVR sessions.

Installation Guide for Cisco Unity Express Virtual 10.2


46
CHAPTER 9
Language Upgrade Preparation
• Language Upgrade Preparation, on page 47

Language Upgrade Preparation


After installation of Cisco Unity Express Virtual 10.2 software version, you can change the default system
language supported. By default, English is the only language supported.
You can add or remove additional languages after completing installation of the Cisco Unity Express Virtual
software. For more information, see Adding or Removing Languages.

Installation Guide for Cisco Unity Express Virtual 10.2


47
Language Upgrade Preparation
Language Upgrade Preparation

Installation Guide for Cisco Unity Express Virtual 10.2


48
CHAPTER 10
Manually Backing Up Files
• Manually Backing Up Files, on page 49

Manually Backing Up Files


Enter backup commands in EXEC mode after moving the system offline. System configuration is not allowed
when the system is in an offline state.

Note We recommend that you back up your configuration files whenever changes are made to the system or
application files. Because data files contain voice messages, back them up daily to minimize data loss, such
as from a hardware failure.

For more detailed information about backing up files, including configuring scheduled backups, see Cisco
Unity Express Voice-Mail and Auto-Attendant CLI Administrator Guide and the GUI online help.

Numbering Scheme for Backup Files


Four types of backup requests are available: data only, configuration only, historical data, or all.
• Data—Backs up voicemail messages.
• Configuration—Backs up the running configuration, greetings, recorded names, and custom scripts and
prompts. Use the show run command to display the current running configuration.
• Historical Data—Backs up historical information about call and application activities that have occurred
on the module.
• All—Backs up all data and configuration information.

Cisco Unity Express Virtual automatically numbers and dates the backup files and identifies the revision
number in a backupid field.
Performing different backup types at various times causes different backup IDs for data backups and
configuration backups. For example, the last data backup ID might be 3, and the last configuration backup
might be 4. Performing an “all” backup might result in a backup ID of 5 for data, historical data, and
configuration.

Installation Guide for Cisco Unity Express Virtual 10.2


49
Manually Backing Up Files
Numbering Scheme for Backup Files

When restoring the files, see the backup ID for the backup file that you want to use. Use the show backup
server command for a list of backup IDs.

Before you begin


• Before you can back up your data, you must have a configured backup server. See Cisco Unity Express
Voice-Mail and Auto-Attendant CLI Administrator Guide and the GUI online help.

SUMMARY STEPS
1. backup category {all | configuration | historicaldata | data}
2. continue
3. show backup history
4. show backup server

DETAILED STEPS

Command or Action Purpose


Step 1 backup category {all | configuration | historicaldata | Specifies the type of data to be backed up and stored.
data}
Example:
Router(offline)# backup category all
Router(offline)# backup category configuration
Router(offline)# backup category data
Router(offline)# backup category historicaldata

Step 2 continue Exits offline mode and enters EXEC mode.


Example:
Router(offline)# continue

Step 3 show backup history Displays the backup and restore procedures and the success
or failure of those attempts.
Example:
Router# show backup history

Step 4 show backup server Displays the backup files available on the backup server,
the date of each backup, and the backup file ID.
Example:
Router# show backup server

Installation Guide for Cisco Unity Express Virtual 10.2


50
CHAPTER 11
Restoring Files
• Restoring Files, on page 51

Restoring Files
After the backup files are created, you can restore them when needed. Restoring is done in offline mode.
Active calls, IMAP, and VoiceView sessions are terminated, and no new calls are accepted (auto attendant
calls are permitted). You should consider doing the restore when telephone subscribers are least likely to be
on the telephone.
Use the show backup server command to locate the backup ID of the file to restore.

Note If you are using Interactive Voice Response (IVR) applications, and you need to restore Cisco Unity Express
10.0 backup on a new Cisco Unity Express 10.2, perform the following steps:
1. Enable IVR license.
2. Restore the backup files. You will be prompted for a reload.
3. Register the Cisco Unity Express product instance with the Cisco Smart Software Manager or Smart
Software Manager satellite using the license smart register idtoken force CLI command.

If you are not using IVR, you do not need to register the product instance again.

For more detailed information about restoring files, see Cisco Unity Express Voice-Mail and Auto-Attendant
CLI Administrator Guide and the GUI online help.

SUMMARY STEPS
1. show backup server
2. offline
3. restore id backupid category {all | configuration | data}
4. reload
5. Create a new administrator after restore.
6. Reset the password for all the restored users.
7. Enable licenses on Cisco Unity Express Virtual 10.2.

Installation Guide for Cisco Unity Express Virtual 10.2


51
Restoring Files
Restoring Files

8. Enable the IMAP on Cisco Unity Express Virtual 10.2.


9. show backup history

DETAILED STEPS

Command or Action Purpose


Step 1 show backup server Lists the data and configuration backup files. Look at the
backup ID field for the revision number of the file that you
Example:
want to restore.
Router# show backup server

Step 2 offline Enters offline mode. All active voicemail calls are
terminated.
Example:
Router# offline

Step 3 restore id backupid category {all | configuration | data} Specifies the backup ID backupid value and the file type to
be restored.
Example:
Router(offline)# restore id 22 category all
Router(offline)# restore id 8 category
configuration
Router(offline)# restore id 3 category data

Step 4 reload Resets the Cisco Unity Express Virtual module so that the
restored values take effect.
Example:
Router(offline)# reload

Step 5 Create a new administrator after restore. Maintain the same administrator on Cisco Unity Express
Virtual 9.0.x and Cisco Unity Express Virtual 10.2. If the
Cisco Virtual Unity Express 10.2 administrator is different
from Cisco Virtual Unity Express 9.0.x administrator, then
create a new administrator after the restore. For information
on creating an administrator, see Configure Cisco Unity
Express 10.2 Using the GUI.

Step 6 Reset the password for all the restored users. Reset the password for all the restored users. After the
restore and reload of the Cisco Unity Express Virtual 10.2,
use the administrator credentials of Cisco Unity Express
Virtual 10.2 to reset the passwords of Cisco Unity Express
Virtual 9.0.x users. For information on changing your
password, see Configure Cisco Unity Express 10.2 Using
the GUI.

Step 7 Enable licenses on Cisco Unity Express Virtual 10.2. If Cisco Unity Express Virtual 9.0.x has IVR and EDBS
licenses (if applicable) enabled, then ensure to enable these
licenses on Cisco Unity Express Virtual 10.2 before the
restore.

Step 8 Enable the IMAP on Cisco Unity Express Virtual 10.2. If Cisco Unity Express Virtual 9.0.x has IMAP enabled,
then you must manually enable the IMAP on Cisco Unity
Express Virtual 10.2 after the restore.

Installation Guide for Cisco Unity Express Virtual 10.2


52
Restoring Files
Restoring Files

Command or Action Purpose


Step 9 show backup history Displays the backup and restore procedures and the success
or failure of those attempts.
Example:
Router# show backup history

Installation Guide for Cisco Unity Express Virtual 10.2


53
Restoring Files
Restoring Files

Installation Guide for Cisco Unity Express Virtual 10.2


54
CHAPTER 12
Troubleshooting Cisco Unity Express Virtual
Service on KVM Service Containers
• Example for Verifying Installation Failure of Cisco Unity Express Virtual Service, on page 55
• Example for Verifying Activation Failure of Cisco Unity Express Virtual Service, on page 55
• Check Memory Present on Cisco 4000 Series Integrated Services Routers, on page 56

Example for Verifying Installation Failure of Cisco Unity Express


Virtual Service
You can use the following commands for debugging installation failure:
• show logg
• debug virtual-service all

Below is a sample to debug installation failure using show logg command:


Use the debug virtual-service all command to enable and view more debugging details shown in the show
logg command.

Example for Verifying Activation Failure of Cisco Unity Express


Virtual Service
You can use the following commands for debugging activation failure:
• show logg
• debug virtual-service all

Below is a sample to debug activation failure using show logg command:


Use the debug virtual-service all command to enable and view more debugging details shown in the show
logg command.

Installation Guide for Cisco Unity Express Virtual 10.2


55
Troubleshooting Cisco Unity Express Virtual Service on KVM Service Containers
Check Memory Present on Cisco 4000 Series Integrated Services Routers

CheckMemoryPresentonCisco4000SeriesIntegratedServices
Routers
To check the current system memory usage on Cisco IOS XE and Cisco IOS XE Denali releases, use the
following commands:
Router# show version
.....
.....
cisco ISR4451-X/K9 (2RU) processor with 7796953K/6147K bytes of memory.
Processor board ID FJC2021D0XG
1 Virtual Ethernet interface
4 Gigabit Ethernet interfaces
32768K bytes of non-volatile configuration memory.
16777216K bytes of physical memory.

OR
Router# show platform software status control-processor brief
Load Average
Slot Status 1-Min 5-Min 15-Min
RP0 Healthy 0.01 0.07 0.11
Memory (kB)
Slot Status Total Used (Pct) Free (Pct) Committed (Pct)
RP0 Healthy 16262244 2304168 (14%) 13958076 (86%) 1919520 (12%)

Installation Guide for Cisco Unity Express Virtual 10.2


56

You might also like