0% found this document useful (0 votes)
424 views66 pages

Installation Guide For Cisco Unity Express Virtual 9.0.x: Americas Headquarters

Uploaded by

ابو الهش
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
424 views66 pages

Installation Guide For Cisco Unity Express Virtual 9.0.x: Americas Headquarters

Uploaded by

ابو الهش
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 66

Installation Guide for Cisco Unity Express Virtual 9.0.

x
First Published: 2016-12-24

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.

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: http://
www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership
relationship between Cisco and any other company. (1110R)

© 2017 Cisco Systems, Inc. All rights reserved.


CONTENTS

CHAPTER 1 Cisco Unity Express Virtual Feature Roadmap 1


Feature and Release Support 1

CHAPTER 2 Cisco Unity Express Virtual Software Overview 5


Cisco Unity Express Virtual on VMware ESXi 5
Cisco Unity Express Virtual on Cisco 4000 Series Integrated Service Routers KVM Service
Containers 6
Uninterruptible Power Supply Recommendations 6

CHAPTER 3 Prerequisites for Installing Cisco Unity Express Virtual 7


Prerequisites for Cisco Unified Communications Manager Express 7
Prerequisites for Cisco Unified Communications Manager 9

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

Installation Guide for Cisco Unity Express Virtual 9.0.x


iii
Contents

CHAPTER 5 Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers
KVM Service Containers 25
Overview of OVA Installation Steps on KVM Service Container 25
Hardware Requirements for Cisco Unity Express Virtual KVMs on Cisco 4000 Series Integrated
Services Routers 26
Install and Configure the Cisco Unity Express Virtual OVA on KVM Service Containers 26
Deactivate and Uninstall Cisco Unity Express Virtual from KVM Service Containers 30
Upgrade Cisco Unity Express Virtual 9.0 or 9.0.1 to 9.0.2 32
Example for Accessing and Configuring the Cisco Unity Express Virtual in Cisco 4000 Series
Integrated Services Routers Service Container 32

CHAPTER 6 Configure Cisco Unity Express Virtual Application 39


Configure Cisco Unity Express Virtual using GUI 39
Configure Cisco Unity Express Virtual using CLI 39

CHAPTER 7 Cisco Unity Express Virtual Licensing 41


Installation Sequence 41
Activate Evaluation Licenses 42
Installing Cisco Unity Express Virtual using Permanent Licenses 45
Installing Cisco Unity Express Virtual 9.0 using CLI 45

CHAPTER 8 Migrating Licenses to Cisco Unity Express Virtual 9.0.5 47


Migrate Cisco Software Licensing (CSL) to Cisco Smart Software Licensing 47
Migrate Cisco Unity Express 8.6.12 (SRE) to Cisco Unity Express Virtual 9.0.5 48
Migrate Cisco Unity Express Virtual 9.0.x to Cisco Unity Express Virtual 9.0.5 49

CHAPTER 9 Language Upgrade Preparation 51


Language Upgrade Preparation 51

CHAPTER 10 Manually Backing Up Files 53


Manually Backing Up Files 53
Numbering Scheme for Backup Files 53

CHAPTER 11 Restoring Files 55

Installation Guide for Cisco Unity Express Virtual 9.0.x


iv
Contents

Restoring Files 55

CHAPTER 12 Troubleshooting Cisco Unity Express Virtual Service on KVM Service Containers 57
Example for Verifying Installation Failure of Cisco Unity Express Virtual Service 57
Example for Verifying Activation Failure of Cisco Unity Express Virtual Service 59
Check Memory Present on Cisco 4000 Series Integrated Services Routers 60

Installation Guide for Cisco Unity Express Virtual 9.0.x


v
Contents

Installation Guide for Cisco Unity Express Virtual 9.0.x


vi
CHAPTER 1
Cisco Unity Express Virtual Feature Roadmap
This roadmap lists the features documented in the Cisco Unity Express Virtual Installation Guide 9.0.x and
maps them to the chapters in which they appear.
For the latest feature information and caveats, see Release Notes for Cisco Unity Express Virtual Release
9.0.

• Feature and Release Support , 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 9.0 or a
later version appear in the table.

Table 1: Supported Cisco Unity Express Virtual Features

Version Feature Name Feature Description Where Documented


Cisco Unity Express Virtual 9.0.5

9.0.5 Support for Cisco Smart Provides support for Cisco Unity Express
Software Licensing Cisco Smart Software Virtual Licensing, on
Licensing. CSL licensing page 41
is no longer supported.

Cisco Unity Express Virtual 9.0.3

9.0.3 Support for Cisco Unified Provides support for Cisco Unity Express
Communications Cisco Unified Virtual Compatibility
Manager 11.5 Communications Matrix
Manager 11.5 and later
versions.

Installation Guide for Cisco Unity Express Virtual 9.0.x


1
Cisco Unity Express Virtual Feature Roadmap
Feature and Release Support

Version Feature Name Feature Description Where Documented


9.0.3 Initial Setup Wizard Provides support to Configure Cisco Unity
Bypass bypass the initial setup Express Virtual after
wizard during post Deployment, on page 17
installation configuration
process.

9.0.3 End of Support for The commands license Cisco Unity Express
License Activation activate voicemail Virtual Licensing, on
Commands mailboxes, and license page 41
activate ports are not
supported from Cisco
Unity Express Virtual
9.0.3 onwards. The
license for mailboxes and
ports are enabled by
default.

Cisco Unity Express Virtual 9.0.2

9.0.2 Support of Second Provides support of Install and Configure the


Interface second interface for IP Cisco Unity Express
configuration on Cisco Virtual OVA on KVM
4000 Series Integrated Service Containers, on
Services Routers KVM page 26
Service Containers.

9.0.2 License Enforcement The requirement to install Activate Evaluation


Removal permanent license is Licenses, on page 42
removed. Cisco Unity
Express Virtual continues
to function normally even
after the evaluation
license expires.

Cisco Unity Express Virtual 9.0

9.0 Configure Cisco Unity Provides support to Install and Configure the
Express Virtual using CLI configure Cisco Unity Cisco Unity Express
Express Virtual using the Virtual OVA on KVM
Command Line Interface Service Containers, on
(CLI), with your SSH page 26
user credentials. For
example: ssh adminUser
@CUE-IP.

Installation Guide for Cisco Unity Express Virtual 9.0.x


2
Cisco Unity Express Virtual Feature Roadmap
Feature and Release Support

Version Feature Name Feature Description Where Documented


9.0 New Hardware Supported Provides Cisco Unity Overview of Installation
in Cisco Unity Express Express Virtual Software Steps, on page 13
Virtual 9.0 support for ESXi on
Cisco Unified Computing
System (Cisco UCS) and
Cisco UCS E-Series
Server modules.

9.0 New Software Supported Provides support for Overview of OVA


in Cisco Unity Express installing Cisco Unity Installation Steps on
Virtual 9.0 Express Virtual software KVM Service Container,
on the Cisco 4000 Series on page 25
Integrated Services
Routers KVM Service
Containers.

Installation Guide for Cisco Unity Express Virtual 9.0.x


3
Cisco Unity Express Virtual Feature Roadmap
Feature and Release Support

Installation Guide for Cisco Unity Express Virtual 9.0.x


4
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, page 5


• Cisco Unity Express Virtual on Cisco 4000 Series Integrated Service Routers KVM Service Containers,
page 6

Cisco Unity Express Virtual on VMware ESXi


Cisco Unity Express Virtual software supports operating within a VMware ESXi virtualized environment.
The software is packaged as an OVA for installation within the ESXi environment (5.1 and above). For more
information about the ESXi environment, see: http://www.vmware.com/products/vsphere/esxi-and-esx/
overview.html.

Installation Guide for Cisco Unity Express Virtual 9.0.x


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

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

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

Note Cisco Unity Express Virtual is supported starting on Cisco IOS XE Release 3.17 and later.

Uninterruptible Power Supply Recommendations


We highly recommend attaching an Uninterruptible power supply (UPS) to the router that houses the Cisco
Unity Express Virtual module. Any reliable UPS unit provides continuous power to maintain the operation
of the router and the Cisco Unity Express Virtual module.

Installation Guide for Cisco Unity Express Virtual 9.0.x


6
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, page 7


• Prerequisites for Cisco Unified Communications Manager , page 9

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

Installation Guide for Cisco Unity Express Virtual 9.0.x


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

number 8124
shared-line max-calls 6
!
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 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.


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

Installation Guide for Cisco Unity Express Virtual 9.0.x


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

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.

Installation Guide for Cisco Unity Express Virtual 9.0.x


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

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

Installation Guide for Cisco Unity Express Virtual 9.0.x


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

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.

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


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

Installation Guide for Cisco Unity Express Virtual 9.0.x


12
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, page 13


• Hardware Requirements for Cisco Unity Express Virtual, page 14
• Set up the VMware ESXi Environment, page 15
• Download the Cisco Unity Express Virtual OVA file, page 15
• Deploy the Cisco Unity Express Virtual OVA, page 16
• Configure Cisco Unity Express Virtual after Deployment, page 17
• Example for Configuring the Cisco Unity Express Virtual, page 18
• Verify Cisco Unified Communication Manager Express and Cisco Unity Express Virtual on ESXi,
page 23
• Verify Cisco Unified Communication Manager and Cisco Unity Express Virtual on ESXi, page 23

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

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


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

Installation Guide for Cisco Unity Express Virtual 9.0.x


13
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

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

Step 4 Deploy the OVA on the server.


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

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

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

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.1, 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 Platform, on page 14 provides hardware
recommendations for Cisco UCS platform.

Table 2: Virtual Machine Requirements for Cisco UCS Platform

Mailboxes CPU RAM Hard Disk External Recording hours


Interface
1-100 1.1 GHz, 1 core 1 GB 100 GB 1 Gigabit 60
Interface

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


cores Interface

Table 3: Virtual Machine Requirements for Cisco UCS E-Series Servers Platform, on page 15 provides
hardware recommendations for Cisco Unity Express Virtual on Cisco UCS E-Series servers platform.

Installation Guide for Cisco Unity Express Virtual 9.0.x


14
Cisco Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server Modules
Set up the VMware ESXi Environment

Table 3: Virtual Machine Requirements for Cisco UCS E-Series Servers Platform

Mailboxes CPU RAM Hard Disk External Recording hours


Interface
1-100 1.1 GHz, 1 core 1 GB 100 GB 1 Gigabit 60
Interface

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


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
VMware tools are drivers installed in a guest operating system, providing support for a variety of system
functions. The VMware tools are included in the OVA template used for installing Cisco Unity Express
Virtual.

Note The VMware Tools included in the Cisco Unity Express Virtual installation OVA template are the correct
version for the Cisco Unity Express Virtual release. Do not upgrade the VMware Tools.

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.

Installation Guide for Cisco Unity Express Virtual 9.0.x


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

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

Installation Guide for Cisco Unity Express Virtual 9.0.x


16
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

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 Platform, on page 14.
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 Platform, on page 14.
Step 14 Select Memory and change the reservation value as provided mentioned in the Table 2: Virtual Machine Requirements
for Cisco UCS Platform, on page 14.
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.
• n: From Cisco Unity Express Virtual Release 9.0.3 onwards, if you select n, the initial setup wizard is skipped,
and you are prompted to enter the administrator user ID and password. The default call agent is set to Unified CME.
• 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.

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.

Installation Guide for Cisco Unity Express Virtual 9.0.x


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

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.
Prior to Cisco Unity Express Virtual Release 9.0.3, if you enter n, the system halts. From Cisco Unity Express
Virtual Release 9.0.3 onwards, 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::

Installation Guide for Cisco Unity Express Virtual 9.0.x


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

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: 172.16.0.1
Please enter the netmask of your Module: 255.255.0.0
Please enter the default gateway for your Module: 172.31.255.254

The following IP configuration is set:

IP : 172.16.0.1
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): 172.16.0.1
Found server 172.16.0.1

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 172.16.0.1): 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 27) Honduras
2) Antigua & Barbuda 28) Jamaica
3) Argentina 29) Martinique
4) Aruba 30) Mexico
5) Bahamas 31) Montserrat

Installation Guide for Cisco Unity Express Virtual 9.0.x


19
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

6) Barbados 32) Netherlands Antilles


7) Belize 33) Nicaragua
8) Bolivia 34) Panama
9) Brazil 35) Paraguay
10) Canada 36) Peru
11) Cayman Islands 37) Puerto Rico
12) Chile 38) St Barthelemy
13) Colombia 39) St Kitts & Nevis
14) Costa Rica 40) St Lucia
15) Cuba 41) St Martin (French part)
16) Dominica 42) St Pierre & Miquelon
17) Dominican Republic 43) St Vincent
18) Ecuador 44) Suriname
19) El Salvador 45) Trinidad & Tobago
20) French Guiana 46) Turks & Caicos Is
21) Greenland 47) United States
22) Grenada 48) Uruguay
23) Guadeloupe 49) Venezuela
24) Guatemala 50) Virgin Islands (UK)
25) Guyana 51) Virgin Islands (US)
26) Haiti
#? 47
Please select one of the following time zone regions.
1) Eastern Time
2) Eastern Time - Michigan - most locations
3) Eastern Time - Kentucky - Louisville area
4) Eastern Time - Kentucky - Wayne County
5) Eastern Time - Indiana - most locations
6) Eastern Time - Indiana - Daviess, Dubois, Knox & Martin Counties
7) Eastern Time - Indiana - Pulaski County
8) Eastern Time - Indiana - Crawford County
9) Eastern Time - Indiana - Pike County
10) Eastern Time - Indiana - Switzerland County
11) Central Time
12) Central Time - Indiana - Perry County
13) Central Time - Indiana - Starke County
14) Central Time - Michigan - Dickinson, Gogebic, Iron & Menominee Counties
15) Central Time - North Dakota - Oliver County
16) Central Time - North Dakota - Morton County (except Mandan area)
17) Mountain Time
18) Mountain Time - south Idaho & east Oregon
19) Mountain Time - Navajo
20) Mountain Standard Time - Arizona
21) Pacific Time
22) Alaska Time
23) Alaska Time - Alaska panhandle
24) Alaska Time - Alaska panhandle neck
25) Alaska Time - west Alaska
26) Aleutian Islands
27) 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 Jun 23 11:20:17 PDT 2016.


Universal Time is now: Thu Jun 5 23:20:17 UTC 2016.
executing app post_install
executing app post_install done
Configuring the system. Please wait...
Changing owners and file permissions.
Tightening file permissions ...
Change owners and permissions complete.
Creating Postgres database .... done.
INIT: Switching to runlevel: 4
INIT: Sending processes the TERM signal
==> Starting CDP

Installation Guide for Cisco Unity Express Virtual 9.0.x


20
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

STARTED: cli_server.sh
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: /bin/products/cusp/smartAgent_startup.sh

Waiting 49 ...

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 (9.0.0)
Technical Support: http://www.cisco.com/techsupport Copyright (c) 1986-2016 by Cisco Systems,
Inc.

Router# show software packages

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

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

The following is a sample configuration if n is selected (applicable to Cisco Unity Express Virtual Release
9.0.3 and later):
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...

Installation Guide for Cisco Unity Express Virtual 9.0.x


21
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

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 8.39.19.15 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 8.39.19.14
(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-8-39-19-15
se-8-39-19-15(config)# end
se-8-39-19-15# wr
se-8-39-19-15#

Installation Guide for Cisco Unity Express Virtual 9.0.x


22
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

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

Installation Guide for Cisco Unity Express Virtual 9.0.x


23
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

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


24
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, page 25


• Hardware Requirements for Cisco Unity Express Virtual KVMs on Cisco 4000 Series Integrated Services
Routers, page 26
• Install and Configure the Cisco Unity Express Virtual OVA on KVM Service Containers, page 26
• Deactivate and Uninstall Cisco Unity Express Virtual from KVM Service Containers, page 30
• Upgrade Cisco Unity Express Virtual 9.0 or 9.0.1 to 9.0.2, page 32
• Example for Accessing and Configuring the Cisco Unity Express Virtual in Cisco 4000 Series Integrated
Services Routers Service Container, page 32

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

Installation Guide for Cisco Unity Express Virtual 9.0.x


25
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

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

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 4: Kernel Virtual Machine Requirements for Cisco 4000 Series ISR Service Container, on page 26
provides the Kernel Virtual Machine recommendations on Cisco 4000 Series ISR Service Container.

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

Mailboxes CPU RAM Hard Disk Flash External Interface Recording hours
1-200 As per Cisco 8 GB 50 GB 8 GB 1 Gigabit Interface 120
4000 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.

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


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

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

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: Enter your password if prompted.
telnet 172.16.0.1

Step 2 enable Enters the privileged EXEC mode.

Example:
Router> enable

Installation Guide for Cisco Unity Express Virtual 9.0.x


27
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
Example: location on your local hard disk or a boot
Router# copy tftp flash: flash drive.
Address or name of remote host [202.153.144.25]? Select the filename and press Enter to confirm
Source filename [/tftp/labtest/CUE-Virtual-9-0-ISR4K.ova]? the Destination filename.
Destination filename [CUE-Virtual-9-0-ISR4K.ova]?
Accessing
tftp://202.153.144.25//tftp/labtest/CUE-Virtual-9-0-ISR4K.ova...
Loading /tftp/labtest/CUE-Virtual-9-0-ISR4K.ova from
/tftp/labtest/CUE-Virtual-9-0-ISR4K.ova (via
GigabitEthernet0/0/0)!!!!! [OK 334479360 bytes]
334479360 bytes copied in 385.578 secs(867475 bytes/sec)]

Step 4 virtual-service install name service-name package uri/package-location: Installs the virtual service.
.ova Note The command virtual-service name
is case-sensitive. For example, if you
Example: configure virtual-service vCUE and
Router# virtual-service install name cue package
bootflash:CUE-Virtual-9-0-ISR4K.ova virtual-service vcue, two different
instances of Cisco Unity Express
Installing package 'bootflash:/CUE-Virtual-9-0-ISR4K.ova' for Virtual is created.
virtual-service 'cue'.
Once the install has finished, the VM may be activated.
Use 'show virtual-service list' for progress.

Step 5 show virtual-service list Lists the service package name and the
installation status.
Example:
Router# show virtual-service list

Virtual Service List:


Name Status Package Name
--------------------------------------
cue Installed CUE-Virtual-9-0-ISR4K.ova

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
Example: interfaces.
Router(config)# interface VirtualPortGroup 1
Note From Cisco Unity Express Virtual
9.0.2 Release onwards, you must
configure two VirtualPortGroup
interfaces. For example,
Router(config)# interface
VirtualPortGroup 1
Router(config)# interface
VirtualPortGroup 2
The VirtualPortGroup forms a bridge and is
configured as the default gateway between
the installed VM and the host router.

Installation Guide for Cisco Unity Express Virtual 9.0.x


28
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 8 ip unnumbered type number Enables IP processing on an interface without
assigning an explicit IP address to that
Example: interface, where:
Router(config-if)# ip unnumbered GigabitEthernet 0/0/0
• type—Type of interface on which the
router has an 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
Router(config)# virtual-service cue
memory to configure the
virtual-service commands.
Step 10 vnic gateway VirtualPortGroup instance-number Associates the VirtualPortGroup interface
with the virtual service.
Example: Note VirtualPortGroup 1 is mapped to
Router(config-virt-serv)# vnic gateway VirtualPortGroup 1
FastEthernet0 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 172.16.0.1

Step 12 end Exits the virtual service configuration vnic


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

Installation Guide for Cisco Unity Express Virtual 9.0.x


29
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 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: The VirtualPortGroup forms a bridge and a
Router(config)# ip route 10.0.25.64 255.255.255.255
VirtualPortGroup1 gateway 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.


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

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
Example: given in the 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:

Installation Guide for Cisco Unity Express Virtual 9.0.x


30
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

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 Enters the privileged EXEC mode.

Example:
Router# enable

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

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
Example: virtual service configuration.
Router# show virtual-service list

Virtual Service List:


Name Status Package Name
-----------------------------------
cue Installed vCUE-9-0-ISR4K.ova

Installation Guide for Cisco Unity Express Virtual 9.0.x


31
Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers
Upgrade Cisco Unity Express Virtual 9.0 or 9.0.1 to 9.0.2

Command or Action Purpose


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 or 9.0.1 to 9.0.2


Before You Begin
• To upgrade the Cisco Unity Express Virtual from Release version 9.0 or 9.0.1 to 9.0.2, you must configure
two virtual port group interfaces and associate both the interfaces to the virtual-service.

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 30.
Step 3 Use the virtual-service upgrade command in Privileged EXEC mode to upgrade the Cisco Unity Express Virtual from
Release version 9.0 or 9.0.1 to 9.0.2.

Example:
Router# virtual-service upgrade name cue package bootflash:CUE-Virtual-9-0-2-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.

Installation Guide for Cisco Unity Express Virtual 9.0.x


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

Prior to Cisco Unity Express Virtual Release 9.0.3, if you enter n, the system halts. From Cisco Unity Express
Virtual Release 9.0.3 onwards, 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: 172.16.0.1
Please enter the netmask of your Module: 255.255.0.0
Please enter the default gateway for your Module: 172.31.255.254

The following IP configuration is set:

IP : 172.16.0.1
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): 172.16.0.1
Found server 172.16.0.1

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 172.16.0.1): 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 9.0.x


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

(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 27) Honduras
2) Antigua & Barbuda 28) Jamaica
3) Argentina 29) Martinique
4) Aruba 30) Mexico
5) Bahamas 31) Montserrat
6) Barbados 32) Netherlands Antilles
7) Belize 33) Nicaragua
8) Bolivia 34) Panama
9) Brazil 35) Paraguay
10) Canada 36) Peru
11) Cayman Islands 37) Puerto Rico
12) Chile 38) St Barthelemy
13) Colombia 39) St Kitts & Nevis
14) Costa Rica 40) St Lucia
15) Cuba 41) St Martin (French part)
16) Dominica 42) St Pierre & Miquelon
17) Dominican Republic 43) St Vincent
18) Ecuador 44) Suriname
19) El Salvador 45) Trinidad & Tobago
20) French Guiana 46) Turks & Caicos Is
21) Greenland 47) United States
22) Grenada 48) Uruguay
23) Guadeloupe 49) Venezuela
24) Guatemala 50) Virgin Islands (UK)
25) Guyana 51) Virgin Islands (US)
26) Haiti
#? 47
Please select one of the following time zone regions.
1) Eastern Time
2) Eastern Time - Michigan - most locations
3) Eastern Time - Kentucky - Louisville area
4) Eastern Time - Kentucky - Wayne County
5) Eastern Time - Indiana - most locations
6) Eastern Time - Indiana - Daviess, Dubois, Knox & Martin Counties
7) Eastern Time - Indiana - Pulaski County
8) Eastern Time - Indiana - Crawford County
9) Eastern Time - Indiana - Pike County
10) Eastern Time - Indiana - Switzerland County
11) Central Time
12) Central Time - Indiana - Perry County
13) Central Time - Indiana - Starke County
14) Central Time - Michigan - Dickinson, Gogebic, Iron & Menominee Counties
15) Central Time - North Dakota - Oliver County
16) Central Time - North Dakota - Morton County (except Mandan area)
17) Mountain Time
18) Mountain Time - south Idaho & east Oregon
19) Mountain Time - Navajo
20) Mountain Standard Time - Arizona
21) Pacific Time
22) Alaska Time
23) Alaska Time - Alaska panhandle
24) Alaska Time - Alaska panhandle neck
25) Alaska Time - west Alaska
26) Aleutian Islands
27) 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

Installation Guide for Cisco Unity Express Virtual 9.0.x


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

#? 1

Local time is now: Thu Jun 23 11:20:17 PDT 2016.


Universal Time is now: Thu Jun 5 23:20:17 UTC 2016.
executing app post_install
executing app post_install done
Configuring the system. Please wait...
Changing owners and file permissions.
Tightening file permissions ...
Change owners and permissions complete.
Creating Postgres database .... done.
INIT: Switching to runlevel: 4
INIT: Sending processes the TERM signal
==> Starting CDP
STARTED: cli_server.sh
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: /bin/products/cusp/smartAgent_startup.sh

Waiting 49 ...

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 (9.0.0)
Technical Support: http://www.cisco.com/techsupport Copyright (c) 1986-2016 by Cisco Systems,
Inc.

Router# show software packages

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

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

The following is a sample configuration if n is selected (applicable to Cisco Unity Express Virtual Release
9.0.3 and later):
IMPORTANT::

Installation Guide for Cisco Unity Express Virtual 9.0.x


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

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

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 8.39.19.15 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 8.39.19.14
(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-8-39-19-15

Installation Guide for Cisco Unity Express Virtual 9.0.x


36
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-8-39-19-15(config)# end
se-8-39-19-15# wr
se-8-39-19-15#

Installation Guide for Cisco Unity Express Virtual 9.0.x


37
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 9.0.x


38
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, page 39


• Configure Cisco Unity Express Virtual using CLI, page 39

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


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

Installation Guide for Cisco Unity Express Virtual 9.0.x


40
CHAPTER 7
Cisco Unity Express Virtual Licensing
From Cisco Unity Express Virtual Release 9.0.5 onwards, only Cisco Smart Software Licensing is supported.
For information on configuring Cisco Smart Licenses, see Cisco Unity Express VoiceMail and Auto Attendant
CLI Administrator Guide for 3.0 and Later Versions, and Configuring Cisco Unity Express 9.0.x Using the
GUI.
For Cisco Unity Express Virtual Releases 9.0 to 9.0.3, Cisco Unity Express Virtual software licenses are
based on the Cisco Software Licensing (CSL) system. With CSL licenses, the mailbox license count includes
both personal mailboxes and GDMs. The type of the mailbox is determined when it is configured. Also, the
call-agent is no longer specified using licenses and can be configured either as part of post-install process
or during bootup.

• Installation Sequence, page 41


• Activate Evaluation Licenses, page 42
• Installing Cisco Unity Express Virtual using Permanent Licenses, page 45
• Installing Cisco Unity Express Virtual 9.0 using CLI, page 45

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

Note From Cisco Unity Express Virtual Release 9.0.3 onwards, the licenses for mailboxes and ports are enabled
by default. Moreover, the number of licenses for mailboxes and ports are set to platform maximum.

For activating your evaluation license, see Activate Evaluation Licenses, on page 42.

Installation Guide for Cisco Unity Express Virtual 9.0.x


41
Cisco Unity Express Virtual Licensing
Activate Evaluation Licenses

Activate Evaluation Licenses


Cisco Unity Express Virtual release software image includes evaluation license. Evaluation license allows
you to evaluate the feature before you purchase a permanent license, but will expire after 60 days. To see
when a license will expire, use the show license evaluation command. The following procedure enables you
to:
• Display the evaluation licenses present on the service module
• Activate the mailbox evaluation license, accept EULA
• Activate the port evaluation license
• Activate the IVR session evaluation license
• Verify which evaluation licenses 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
will be disabled.

Caution If you do not use the IVR functionality, then make sure to either disable the IVR license or set the count
to 0. To disable the IVR session license, use the command no license activate ivr sessions. If you wish
to set the IVR count to 0, then use the command license activate ivr sessions 0.

Note We recommend that you install and activate the permanent licenses before the expiration of your evaluation
licenses. From Cisco Unity Express Virtual 9.0.2 Release onwards, you do not need to install permanent
license.

SUMMARY STEPS

1. show license evaluation


2. license activate voicemail mailboxes
3. license activate ports
4. license activate ivr sessions
5. reload
6. show license in-use

Installation Guide for Cisco Unity Express Virtual 9.0.x


42
Cisco Unity Express Virtual Licensing
Activate Evaluation Licenses

DETAILED STEPS

Command or Action Purpose


Step 1 show license evaluation Use this command to display which evaluation
licenses are on your system. This command is not
Example: applicable for Cisco Unity Express 9.0.5 and later
cue# show license evaluation versions. Use show license status command to view
StoreIndex: 0 Feature: VMIVR-VM-MBX Version: 1.0 the license status.
License Type: Evaluation
License State: Active, Not in Use, EULA not accepted
Evaluation total period: 8 weeks 4 days
Evaluation period left: 8 weeks 4 days
License Count: 600 / 0
License Priority: None
StoreIndex: 1 Feature: VMIVR-PORT Version: 1.0
License Type: Evaluation
License State: Active, Not in Use, EULA not accepted
Evaluation total period: 8 weeks 4 days
Evaluation period left: 8 weeks 4 days
License Count: 60 / 0
License Priority: None
StoreIndex: 2 Feature: VMIVR-IVR-SESS Version: 1.0
License Type: Evaluation
License State: Active, Not in Use, EULA accepted
Evaluation total period: 8 weeks 4 days
Evaluation period left: 8 weeks 4 days
License Count: 60 / 0
License Priority: Low

Step 2 license activate voicemail mailboxes Use this command to activate the license for
mailboxes. It presents the End User License
Example: Agreement if it was not accepted earlier.
cue# license activate voicemail mailboxes 275
Note The license activate voicemail mailboxes
Evaluation licenses are being activated in the device for command is not supported from Cisco Unity
the following feature(s): Express Virtual Release 9.0.3 onwards. The
Feature Name: VMIVR-VM-MBX
license for mailboxes are enabled by default.
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

Installation Guide for Cisco Unity Express Virtual 9.0.x


43
Cisco Unity Express Virtual Licensing
Activate Evaluation Licenses

Command or Action Purpose


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

License activation count saved for use at next reload

Step 3 license activate ports Use this command to activate the license for ports.
The output is similar to the output for activating the
Example: license for mailboxes as shown in the previous step.
cue# license activate ports 4
Note The license activate ports command is not
supported from Cisco Unity Express Virtual
Release 9.0.3 onwards. The license for ports
are enabled by default.
Step 4 license activate ivr sessions Use this command to activate the license for IVR
sessions. The output is similar to the output for
Example: activating the license for mailboxes as shown in the
cue# license activate ivr sessions 2 previous step.

Step 5 reload Reloads the system.


Note From Cisco Unity Express Virtual Release
9.0.5 onwards, reload is not required for
activating the licenses for IVR sessions. You
need to log out from the Cisco Unity Express
GUI, and log in again to view the IVR pages.
Step 6 show license in-use Use this command to verify that the evaluation license
is being active. This command is not applicable for
Example: Cisco Unity Express 9.0.5 and later versions. Use
cue# show license in-use show license status command to view the license
StoreIndex: 0 Feature: VMIVR-VM-MBX Version: 1.0 status.
License Type: Evaluation
License State: Active, In Use
Evaluation total period: 8 weeks 4 days
Evaluation period left: 8 weeks 3 days
Expiry date: Sun Jul 5 16:08:06 2016
License Count: 600 /275
License Priority: Low

Installation Guide for Cisco Unity Express Virtual 9.0.x


44
Cisco Unity Express Virtual Licensing
Installing Cisco Unity Express Virtual using Permanent Licenses

Installing Cisco Unity Express Virtual using Permanent Licenses


Follow these steps to provide permanent license for Cisco Unity Express Virtual 9.0.

Step 1 Go to www.cisco.com/go/ordering and choose one of the ordering processes (via partner, Cisco direct, etc.) to order
licenses. The SKU is used in the ordering process to specify the desired licenses for the Cisco Unity Express Virtual
features that you want. When you purchase a license, you will receive a product activation key (PAK), which is an
alphanumeric string that represents the purchase.
Step 2 To get your license file, go to the Cisco Product License Registration Portal at www.cisco.com/go/license and enter the
appropriate information.
You must enter the PAK and the unique device identifier (UDI) of the device where the license will be installed. The
UDI can be viewed via software using the show license udi command in privileged EXEC mode. The UDI has two main
components: the product ID (PID) and the serial number (SN).

Step 3 Download the license file or receive the license file by e-mail.
Step 4 Repeat the appropriate steps above for each device you want to obtain a license.
Step 5 Copy the license file(s) to a FTP or TFTP server.

Installing Cisco Unity Express Virtual 9.0 using CLI


Follow these steps to install the licenses for Cisco Unity Express Virtual 9.0.

Step 1 Log in to the CLI.


Step 2 Enter license install URL: (ftp://username:password@ip_address/path/license_file), where URL is the URL where you
copied the license.
Step 3 Activate the new license by entering license activate.
Step 4 Reload the module.
Step 5 Verify the license by entering one or more of the following, depending on what licenses were installed:
• show license all
• show license in-use
• show license status application

Installation Guide for Cisco Unity Express Virtual 9.0.x


45
Cisco Unity Express Virtual Licensing
Installing Cisco Unity Express Virtual 9.0 using CLI

Installation Guide for Cisco Unity Express Virtual 9.0.x


46
CHAPTER 8
Migrating Licenses to Cisco Unity Express Virtual
9.0.5
This chapter describes the procedures to migrate the previous versions of Cisco Unity Express to Cisco Unity
Express Virtual Release 9.0.5.

• Migrate Cisco Software Licensing (CSL) to Cisco Smart Software Licensing, page 47
• Migrate Cisco Unity Express 8.6.12 (SRE) to Cisco Unity Express Virtual 9.0.5, page 48
• Migrate Cisco Unity Express Virtual 9.0.x to Cisco Unity Express Virtual 9.0.5, page 49

Migrate Cisco Software Licensing (CSL) to Cisco Smart Software


Licensing
You must convert your CSL license to Cisco Smart license in order to use Cisco Unity Express Virtual 9.0.5.
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. Once you get 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.

Installation Guide for Cisco Unity Express Virtual 9.0.x


47
Migrating Licenses to Cisco Unity Express Virtual 9.0.5
Migrate Cisco Unity Express 8.6.12 (SRE) to Cisco Unity Express Virtual 9.0.5

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


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

Step 1 Back up your Cisco Unity Express 8.6.12 configurations.


Step 2 Install the Cisco Unity Express Virtual 9.0.5 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 9.0.5. has same hostname, and then
restore the backup to the newly installed Cisco Unity Express.
Step 5 Once the Cisco Unity Express Virtual 9.0.5 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.

Installation Guide for Cisco Unity Express Virtual 9.0.x


48
Migrating Licenses to Cisco Unity Express Virtual 9.0.5
Migrate Cisco Unity Express Virtual 9.0.x to Cisco Unity Express Virtual 9.0.5

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


Virtual 9.0.5
Perform the following steps to migrate Cisco Unity Express Virtual 9.0.x (9.0 or 9.0.1 or 9.0.2 or 9.0.3) to
Cisco Unity Express Virtual 9.0.5.

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


Step 2 Uninstall the Cisco Unity Express Virtual 9.0.x.
Step 3 Reinstall and configure the Cisco Unity Express Virtual 9.0.5 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 9.0.5.
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 9.0.x


49
Migrating Licenses to Cisco Unity Express Virtual 9.0.5
Migrate Cisco Unity Express Virtual 9.0.x to Cisco Unity Express Virtual 9.0.5

Installation Guide for Cisco Unity Express Virtual 9.0.x


50
CHAPTER 9
Language Upgrade Preparation
• Language Upgrade Preparation, page 51

Language Upgrade Preparation


After installation of Cisco Unity Express Virtual 9.0 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 9.0.x


51
Language Upgrade Preparation
Language Upgrade Preparation

Installation Guide for Cisco Unity Express Virtual 9.0.x


52
CHAPTER 10
Manually Backing Up Files
• Manually Backing Up Files, page 53

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 for 3.0 and Later Versions 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

Installation Guide for Cisco Unity Express Virtual 9.0.x


53
Manually Backing Up Files
Numbering Scheme for Backup Files

might be 4. Performing an “all” backup might result in a backup ID of 5 for data, historical data, and
configuration.
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 for 3.0 and Later Versions 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 | data} Specifies the type of data to be backed up and stored.

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


54
CHAPTER 11
Restoring Files
• Restoring Files, page 55

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 From Cisco Unity Express 9.0.5 Release onwards, if you are using Interactive Voice Response (IVR)
applications, and you need to restore Cisco Unity Express 9.0.5 backup on a new Cisco Unity Express
9.0.5, 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 for 3.0 and Later Versions and the GUI online help.

SUMMARY STEPS

1. show backup server


2. offline
3. restore id backupid category {all | configuration | data}
4. reload
5. show backup history

Installation Guide for Cisco Unity Express Virtual 9.0.x


55
Restoring Files
Restoring Files

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 | Specifies the backup ID backupid value and the file type to
data} 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 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 9.0.x


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

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:


Router# show virtual-service list

Virtual Service List:

Name Status Package Name


------------------------------------------------------------------------------
vcue Activated CUE-Virtual-9-0-ISR4K.ova

Router# virtual-service install name cue package bootflash:CUE


Router# $ll name cue package bootflash:CUE-Virtual-9-0-ISR4K.ova
Installing package 'bootflash:/CUE-Virtual-9-0-ISR4K.ova' for virtual-service 'cue'. Once
the install has finished, the VM may be activated. Use 'show virtual-service list' for
progress.

Router# show virtual-service list


System busy installing virtual-service 'cue'. The request may take several minutes...
Virtual Service List:

Name Status Package Name


------------------------------------------------------------------------------
vcue Activated CUE-Virtual-9-0-ISR4K.ova

Installation Guide for Cisco Unity Express Virtual 9.0.x


57
Troubleshooting Cisco Unity Express Virtual Service on KVM Service Containers
Example for Verifying Installation Failure of Cisco Unity Express Virtual Service

cue Installing CUE-Virtual-9-0-ISR4K.ova

...................................
...................................

Router# show virtual-service list


System busy installing virtual-service 'cue'. The request may take several minutes...
Virtual Service List:

Name Status Package Name


------------------------------------------------------------------------------
vcue Activated CUE-Virtual-9-0-ISR4K.ova
cue Installing CUE-Virtual-9-0-ISR4K.ova

Router# show virtual-service list


Virtual Service List:

Name Status Package Name


------------------------------------------------------------------------------
vcue Activated CUE-Virtual-9-0-ISR4K.ova

Router# show logg


Syslog logging: enabled (0 messages dropped, 2 messages rate-limited, 0 flushes, 0 overruns,
xml disabled, filtering disabled)

No Active Message Discriminator.

No Inactive Message Discriminator.

Console logging: disabled


Monitor logging: level debugging, 0 messages logged, xml disabled,
filtering disabled
Buffer logging: level debugging, 1727 messages logged, xml disabled,
filtering disabled
Exception Logging: size (4096 bytes)
Count and timestamp logging messages: disabled
Persistent logging: disabled

No active filter modules.

Trap logging: level informational, 1714 message lines logged


Logging Source-Interface: VRF Name:

Log Buffer (999999999 bytes):

Aug 11 09:50:17.489 IST: %VMAN-5-PACKAGE_SIGNING_LEVEL_ON_INSTALL: SIP2: vman: Package


'CUE-Virtual-9-0-ISR4K.ova' for service container 'cue' is 'Cisco signed', signing level
cached on original install is 'Cisco signed'
Aug 11 09:50:23.494 IST: %VMAN-3-GENERAL_FAILURE: SIP2: vman: Virtual
Service[cue]::Activate::Container preparation::Unable to prepare container::Application
limit verify failed; Installation attempt of vm 'ISR-CUE' vendor 'Cisco Systems, Inc.'
exceeds maximum limit of 1
Router#
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 9.0.x


58
Troubleshooting Cisco Unity Express Virtual Service on KVM Service Containers
Example for Verifying Activation Failure of Cisco Unity Express Virtual Service

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:


Router# show run | sec virtual-service
virtual-service vcue
vnic gateway VirtualPortGroup1
guest ip address 8.39.23.194

Router# show virtual-service list

Virtual Service List:

Name Status Package Name


------------------------------------------------------------------------------
vcue Installed CUE-Virtual-9-0-ISR4K.ova

Router# configure terminal


Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# virtual-service vcue
Router(config-virt-serv)# vnic gateway VirtualPortGroup 3
Router(config-virt-serv-vnic)# do clear logg
Clear logging buffer [confirm]

Router(config-virt-serv-vnic)# activate
% Activating virtual-service 'vcue', this might take a few minutes. Use 'show virtual-service
list' for progress.

Router(config-virt-serv)# end
Router# show virtual-service list
Virtual Service List:

Name Status Package Name


------------------------------------------------------------------------------
vcue Activate Failed CUE-Virtual-9-0-ISR4K.ova

Router# show logg


Syslog logging: enabled (0 messages dropped, 2 messages rate-limited, 0 flushes, 0 overruns,
xml disabled, filtering disabled)

No Active Message Discriminator.

No Inactive Message Discriminator.

Console logging: disabled


Monitor logging: level debugging, 0 messages logged, xml disabled,
filtering disabled
Buffer logging: level debugging, 1740 messages logged, xml disabled,
filtering disabled
Exception Logging: size (4096 bytes)
Count and timestamp logging messages: disabled
Persistent logging: disabled

Installation Guide for Cisco Unity Express Virtual 9.0.x


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

No active filter modules.

Trap logging: level informational, 1727 message lines logged


Logging Source-Interface: VRF Name:

Log Buffer (999999999 bytes):

Aug 11 09:58:29.270 IST: %SYS-5-CONFIG_I: Configured from console by console


Aug 11 09:58:30.698 IST: %VMAN-3-VIRT_INST_INTERFACE: SIP2: vman: Virtual
Service[vcue]::Network interfaces::The number of network interfaces required do not match
the number configured::Number defined: 1, number configured: 2
Aug 11 09:58:30.872 IST: %VIRT_SERVICE-5-ACTIVATION_STATE: Failed to activate virtual service
vcue
Router#
Use the debug virtual-service all command to enable and view more debugging details shown in the show
logg command.

Check Memory Present on Cisco 4000 Series Integrated Services


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


60

You might also like