Installation Guide for Cisco Unity Express Virtual 10.0

First Published: 2019-06-14 Last Modified: 2020-05-01

Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 527-0883 THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

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

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

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

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: https://www.cisco.com/c/en/us/about/legal/trademarks.html. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1721R)

Full Cisco Trademarks with Software License ?

CHAPTER 1 Cisco Unity Express Virtual Feature Roadmap 1 Feature and Release Support 1

CHAPTER 2 Cisco Unity Express Virtual Software Overview 3 Cisco Unity Express Virtual on VMware ESXi 3 Cisco Unity Express Virtual on Cisco 4000 Series Integrated Service Routers KVM Service Containers 4 Uninterruptible Power Supply Recommendations 4

CHAPTER 3 Prerequisites for Installing Cisco Unity Express Virtual 5 Prerequisites for Cisco Unified Communications Manager Express 5 Prerequisites for Cisco Unified Communications Manager 7

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

Installation Guide for Cisco Unity Express Virtual 10.0 iii Contents

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

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

CHAPTER 6 Configure Cisco Unity Express Virtual Application 37 Configure Cisco Unity Express Virtual using GUI 37 Configure Cisco Unity Express Virtual using CLI 37

CHAPTER 7 Cisco Unity Express Virtual Licensing 39 Installation Sequence 39 Activate Evaluation Licenses 39

CHAPTER 8 Migrating Licenses to Cisco Unity Express Virtual 10.0 43 Migrate Cisco Software Licensing (CSL) to Cisco Smart Software Licensing 43 Migrate Cisco Unity Express 8.6.12 (SRE) to Cisco Unity Express Virtual 10.0 43 Migrate Cisco Unity Express Virtual 9.0.x to Cisco Unity Express Virtual 10.0 44

CHAPTER 9 Language Upgrade Preparation 47 Language Upgrade Preparation 47

CHAPTER 10 Manually Backing Up Files 49 Manually Backing Up Files 49 Numbering Scheme for Backup Files 49

Installation Guide for Cisco Unity Express Virtual 10.0 iv Contents

CHAPTER 11 Restoring Files 51 Restoring Files 51

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

Installation Guide for Cisco Unity Express Virtual 10.0 v Contents

Installation Guide for Cisco Unity Express Virtual 10.0 vi CHAPTER 1 Cisco Unity Express Virtual Feature Roadmap

This roadmap lists the features documented in the Cisco Unity Express Virtual Installation Guide 10.0 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 10.0. • Feature and Release Support, on page 1 Feature and Release Support The below table lists the Cisco Unity Express Virtual version that introduced support for a given feature or enhancement. Unless noted otherwise, subsequent versions of Cisco Unity Express Virtual software also support that feature. Only features that were introduced or modified in Cisco Unity Express Virtual 10.0 or a later version appear in the table.

Table 1: Supported Cisco Unity Express Virtual Features

Feature Name Feature Description

Cisco Unity Express Virtual 10.0

Operating System and third-party components Upgraded the foundation Operating System and the upgraded in Cisco Unity Express Virtual 10.0. third-party components to the latest stable version.

Updates to TLS Support. Cisco Unity Express Release 10.0 supports TLS version 1.2.

Additional steps for restoring the configuration from Updated the steps required to restore the configuration Cisco Unity Express Release 9.0.x to Cisco Unity from Cisco Unity Express Release 9.0.x to Cisco Express Release 10.0. Unity Express Release 10.0. Restoring Files, on page 51

Format of the Platform Logs. Platform logs are in plain text format.

Installation Guide for Cisco Unity Express Virtual 10.0 1 Cisco Unity Express Virtual Feature Roadmap Feature and Release Support

Installation Guide for Cisco Unity Express Virtual 10.0 2 CHAPTER 2 Cisco Unity Express Virtual Software Overview

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

Cisco Unity Express Virtual application supports all the features that were supported on a bare-metal installation of Cisco Unity Express on the SRE Module. You can install the Cisco Unity Express Virtual application in the following ways: • Cisco Unity Express Virtual on VMware ESXi, on page 3 • Cisco Unity Express Virtual on Cisco 4000 Series Integrated Service Routers KVM Service Containers, on page 4 Cisco Unity Express Virtual on VMware ESXi 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. For information about installing Cisco Unity Express Virtual within a VMWare ESXi environment, see Cisco Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server Modules, on page 11.

Installation Guide for Cisco Unity Express Virtual 10.0 3 Cisco Unity Express Virtual Software Overview Cisco Unity Express Virtual on Cisco 4000 Series Integrated Service Routers KVM Service Containers

Cisco Unity Express Virtual on Cisco 4000 Series Integrated Service Routers KVM Service Containers Cisco Unity Express Virtual also supports operating within the Kernel Virtual Machine (KVM) Service Container on Cisco 4000 Series Integrated Service Routers (Cisco 4000 Series ISR), also called virtual service containers. A virtual service container is a virtualized environment on the Cisco 4000 Series ISR router. It is also referred to as a virtual machine (VM), virtual service, or container. You can install an application within a virtual service container which runs within the operating system of a device. The application runs in the virtual services container of the operating system of a device. The application is delivered as an open virtual application (OVA), which is a tar file with 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 23.

Note Cisco Unity Express Virtual supports Cisco IOS XE Release 16.12.x or lower releases.

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 10.0 4 CHAPTER 3 Prerequisites for Installing Cisco Unity Express Virtual

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

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

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

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

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

Installation Guide for Cisco Unity Express Virtual 10.0 5 Prerequisites for Installing Cisco Unity Express Virtual Prerequisites for Cisco Unified Communications Manager Express

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

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

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

See Download Software for downloading Cisco Unified CME files.

Installation Guide for Cisco Unity Express Virtual 10.0 6 Prerequisites for Installing Cisco Unity Express Virtual Prerequisites for Cisco Unified Communications Manager

c) Configure the following path in Cisco Unified CME configuration mode: Example: Router(config)# ip http path flash: d) Verify the path with the show running-config command. e) Verify that a SIP dial peer is configured to point to the Cisco Unity Express Virtual module, that it specifies G.711 u-law and SIP Notify for DTMF Relay, and that VAD is turned off. This step is required to have an incoming call directed to Cisco Unity Express Virtual. The following is an example configuration: dial-peer voice 6000 voip ! SIP dial peer pointing to Cisco Unity Express Virtual destination-pattern 6... session protocol sipv2 dtmf-relay sip-notify session target ipv4:172.16.0.1 ! Cisco Unity Express Virtual IP address codec g711ulaw no vad f) Configure the appropriate number of SIP dial peers to support your dial plan. g) Verify that a Cisco Unified CME web administrator is configured with a username and password, for example: voice register global . . . web admin system name admin password user1

web admin system name admin secret 5 encrypted-password

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

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

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

Installation Guide for Cisco Unity Express Virtual 10.0 7 Prerequisites for Installing Cisco Unity Express Virtual Prerequisites for Cisco Unified Communications Manager

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

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

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

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

access-list 100 permit udp host 172.16.0.1 any range 16383 32727 access-list 110 permit tcp host 172.16.0.1 any eq 2748 where 172.16.0.1 is the IP address of the module that contains Cisco Unity Express Virtual software. The output from the show policy-map interface command should indicate that the marked packets number is increasing. For example: Match: access-group 110 QoS Set dscp cs3 Packets marked 334 <-----This number should increase.

Installation Guide for Cisco Unity Express Virtual 10.0 8 Prerequisites for Installing Cisco Unity Express Virtual Prerequisites for Cisco Unified Communications Manager

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

Installation Guide for Cisco Unity Express Virtual 10.0 9 Prerequisites for Installing Cisco Unity Express Virtual Prerequisites for Cisco Unified Communications Manager

Installation Guide for Cisco Unity Express Virtual 10.0 10 CHAPTER 4 Cisco Unity Express Virtual Software Support for ESXi on Cisco UCS and Cisco UCS E-Series Server Modules

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

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

Step 2 Set up the VMware ESXi environment on the server. See Set up the VMware ESXi Environment, on page 12.

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

Step 4 Deploy the OVA on the server.

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

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

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

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

Hardware Requirements for Cisco Unity Express Virtual This section provides information about the hardware requirements.

Virtual Machine Requirements for Cisco Unity Express Virtual Cisco Unity Express Virtual software requires VMware ESXi 5.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 and Cisco UCS E-Series server Platforms , on page 12 provides hardware recommendations for Cisco UCS platform and Cisco UCS E-Series server platforms.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Step 7 Click Next. The Deploy OVF Template dialog box displays the available networks.

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

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

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

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

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

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

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

Step 4 At the prompt in the console window, confirm that you want to start the configuration process. • y: If you enter y, the system asks you to confirm, then begin the interactive post installation configuration process. • n: 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.

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

• Timeout: If you do not enter any input for two minutes, the initial setup wizard is skipped, and you are prompted to enter the IP address, netmask, and default gateway address. Once you enter the information, the Cisco Unity Express Virtual Express system is online.

Step 5 When prompted, enter IP address and netmask of the device. Note Cisco Unity Express Virtual requires IP communication access to the Cisco Unified Communications Manager and Remote sites.

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

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

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

Step 15 When prompted, enter an administrator user ID. Step 16 Enter a password for the account, and confirm. Note Ensure that you use this username and password to access Cisco Unity Express Virtual through SSH after installation.

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

Example for Configuring the Cisco Unity Express Virtual When you open the first session, the system launches the post installation configuration tool, and asks you if you want to start configuration immediately.

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

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

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

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

The following IP configuration is set:

IP : 192.0.2.10 NETMASK:255.255.0.0 GATEWAY: 255.255.0.0

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

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

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

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

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

Enter IP Address of the Primary DNS Server (IP address): 192.0.2.10 Found server 192.0.2.10

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

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

(IP address, or enter to bypass): Enter

Enter Fully Qualified Domain Name(FQDN: e.g. myhost.mydomain.com) or IP address of the Primary NTP server (FQDN or IP address, or enter for 192.0.2.10): demo.cisco.com Found server cantor.cisco.com

Enter Fully Qualified Domain Name(FQDN: e.g. myhost.mydomain.com) or IP address of the Secondary NTP Server (FQDN or IP address, or enter to bypass): Enter

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

Installation Guide for Cisco Unity Express Virtual 10.0 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

17) Mountain (most areas) 18) Mountain - ID (south); OR (east) 19) Mountain Time - Navajo 20) MMST - Arizona (except navajo) 21) Pacific 22) Alaska (most areas) 23) Alaska - Juneau area 24) Alaska - Sitka area 25) Alaska - Annette Island 26) Alaska - Yakutat 27) Alaska (west) 28) Aleutian Islands 29) Hawaii #? 21 The following information has been given: United States Pacific Time

Therefore TZ='America/Los_Angeles' will be used. Is the above information OK? 1) Yes 2) No #? 1

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

waiting for all services to come online ... 50

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

Installation Guide for Cisco Unity Express Virtual 10.0 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

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

SYSTEM ONLINE

Router# show software versions Cisco Unity Express Virtual version (10.0.0) Components:

- CUE Voicemail Language Support version 10.0.0 - Netconf version 10.0.0

Router# show software packages

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

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

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

Do you wish to start configuration now (y,n)? n Autoconfig: Skipping post install... executing app post_install Skipping product specific post install... defaulting values Setting Call Agent to CUCME executing app post_install done Creating Postgres database .... done. INIT: Switching to runlevel: 4 INIT: Sending processes the TERM signal STARTED: ntp_startup.sh STARTED: LDAP_startup.sh STARTED: SQL_startup.sh STARTED: dwnldr_startup.sh STARTED: HTTP_startup.sh STARTED: probe

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

STARTED: fndn_udins_wrapper STARTED: superthread_startup.sh STARTED: /usr/wfavvid/run-wfengine.sh STARTED: /usr/bin/launch_ums.sh STARTED: /bin/products/cue/nesla_licensing.sh

Waiting 49 ...

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

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

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

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

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

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

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.

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

Router# configure terminal Router(config)# ip route 10.0.0.2 255.255.255.255 FastEthernet0/0 Router(config)# end Note This step is applicable only for the Cisco UCS Series Servers.

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

Installation Guide for Cisco Unity Express Virtual 10.0 22 CHAPTER 5 Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers

The Cisco Unity Express Virtual software release adds support for installing Cisco Unity Express Virtual software on the Cisco 4000 Series Integrated Services Routers KVM Service Containers. • Overview of OVA Installation Steps on KVM Service Container, on page 23 • Hardware Requirements for Cisco Unity Express Virtual KVMs on Cisco 4000 Series Integrated Services Routers, on page 24 • Install and Configure the Cisco Unity Express Virtual OVA on KVM Service Containers, on page 24 • Deactivate and Uninstall Cisco Unity Express Virtual from KVM Service Containers, on page 28 • Upgrade Cisco Unity Express Virtual 9.0.6 to 10.0, on page 29 • Example for Accessing and Configuring the Cisco Unity Express Virtual in Cisco 4000 Series Integrated Services Routers Service Container, on page 30 Overview of OVA Installation Steps on KVM Service Container The following steps provide an overview of Cisco Unity Express Virtual software installation on the Kernel Virtual Machine Service Container.

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

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

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

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

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

1-200 As per 8 GB Minimum 8 GB 1 Gigabit 120 20 Cisco 4000 50 GB Interface Series ISR platform

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

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

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

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

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

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

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

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

DETAILED STEPS

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

Step 2 enable Enters the privileged EXEC mode. Example: Router> enable

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

Command or Action Purpose Step 3 copy tftp {flash | harddisk} Allows you to access the tftp file server and to copy the OVA package to a desired location on your local hard disk Example: or a boot flash drive. Router# copy tftp flash: Select the filename and press Enter to confirm the Address or name of remote host [202.153.144.25]? Destination filename. Source filename [/tftp/labtest/CUE-Virtual-10-0-0-ISR4K.ova]? Destination filename [CUE-Virtual-10-0-0-ISR4K.ova]? Accessing tftp://202.153.144.25//tftp/labtest/CUE-Virtual-10-0-0-ISR4K.ova... Loading /tftp/labtest/CUE-Virtual-10-0-0-ISR4K.ova from /tftp/labtest/CUE-Virtual-10-0-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 Installs the virtual service. uri/package-location: .ova Note The command virtual-service name is Example: case-sensitive. For example, if you configure Router# virtual-service install name cue package virtual-service vCUE and virtual-service vcue, bootflash:CUE-Virtual-10-0-0-ISR4K.ova two different instances of Cisco Unity Express Virtual is created. Installing package 'bootflash:/CUE-Virtual-10-0-0-ISR4K.ova' for 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-10-0-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 interfaces. Example: Router(config)# interface VirtualPortGroup 1 Note You must configure two VirtualPortGroup interfaces. For example, Router(config)# interface VirtualPortGroup 1 Router(config)# interface VirtualPortGroup 2

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

Command or Action Purpose The VirtualPortGroup forms a bridge and is configured as the default gateway between the installed VM and the host router.

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

Note The unnumbered interface must be unique. It cannot be another unnumbered interface.

Step 9 virtual-service service-name Enters the virtual service in configuration mode. Example: Note You need a minimum of 8 GB memory to Router(config)# virtual-service cue configure the virtual-service commands.

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

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

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

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

Step 13 configure terminal Enters the router configuration mode. Example: Router# configure terminal

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

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

Step 15 virtual-service service-name Enters the virtual-service configuration mode. Example: Router(config)# virtual-service cue

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

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

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

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

Installation Guide for Cisco Unity Express Virtual 10.0 28 Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM Service Containers Upgrade Cisco Unity Express Virtual 9.0.6 to 10.0

DETAILED STEPS

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

Step 2 configure terminal Enters the router configuration mode. Example: Router# configure terminal

Step 3 virtual-service service-name Enters the virtual-service configuration mode. Example: Router(config)# virtual-service cue

Step 4 no activate Deactivates the virtual service. Example: Router(config-virt-serv)# no activate

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

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

Virtual Service List: Name Status Package Name ------cue Installed vCUE-10-0-0-ISR4K.ova

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

Step 8 exit Exits the current mode. Example: Router# exit

Upgrade Cisco Unity Express Virtual 9.0.6 to 10.0

Before you begin • To upgrade the Cisco Unity Express Virtual from Release version 9.0.6 to 10.0, you must configure two virtual port group interfaces and associate both the interfaces to the virtual-service. For details on

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

configuration, see Install and Configure the Cisco Unity Express Virtual OVA on KVM Service Containers, on page 24.

Step 1 Log in to Cisco Unity Express Virtual. Step 2 Deactivate the virtual service. For details on deactivating the virtual service, see Deactivate and Uninstall Cisco Unity Express Virtual from KVM Service Containers, on page 28. Step 3 Use the virtual-service upgrade command in Privileged EXEC mode to upgrade the Cisco Unity Express Virtual from Release version 9.0.6 to 10.0. Example: Router# virtual-service upgrade name cue package bootflash:CUE-Virtual-10-0-0-ISR4K.ova

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

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

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

Please enter the default gateway for your Module: 192.0.2.20

The following IP configuration is set:

IP : 192.0.2.10 NETMASK:255.255.0.0 GATEWAY: 255.255.0.0

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

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

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

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

Enter IP Address of the Primary DNS Server (IP address): 192.0.2.10 Found server 192.0.2.10

Enter IP Address of the Secondary DNS Server (other than Primary) (IP address, or enter to bypass): Enter

Enter Fully Qualified Domain Name(FQDN: e.g. myhost.mydomain.com) or IP address of the Primary NTP server (FQDN or IP address, or enter for 192.0.2.10): demo.cisco.com Found server cantor.cisco.com

Enter Fully Qualified Domain Name(FQDN: e.g. myhost.mydomain.com) or IP address of the Secondary NTP Server (FQDN or IP address, or enter to bypass): Enter

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

15) Costa Rica 42) St Maarten (Dutch) 16) Cuba 43) St Martin (French) 17) Curacao 44) St Pierre & Miquelon 18) Dominica 45) St Vincent 19) Dominican Republic 46) Suriname 20) Ecuador 47) Trinidad & Tobago 21) El Salvador 48) Turks & Caicos Is 22) French Guiana 49) United States 23) Greenland 50) Uruguay 24) Grenada 51) Venezuela 25) Guadeloupe 52) Virgin Islands (UK) 26) Guatemala 53) Virgin Islands (US) 27) Guyana 28) Haiti #? 49 Please select one of the following time zone regions. 1) Eastern (most areas) 2) Eastern - MI (most areas) 3) Eastern - KY (Louisville area) 4) Eastern - KY (Wayne) 5) Eastern - IN (most areas) 6) Eastern - IN (Da, Du, K, Mn) 7) Eastern - IN (Pulaski) 8) Eastern - IN (Crawford) 9) Eastern - IN (Pike) 10) Eastern - IN (Switzerland) 11) Central (most areas) 12) Central - IN (Perry) 13) Central - IN (Starke) 14) Central - MI (Wisconsin border) 15) Central - ND (Oliver) 16) Central - ND (Morton rural) 17) Mountain (most areas) 18) Mountain - ID (south); OR (east) 19) Mountain Time - Navajo 20) MMST - Arizona (except navajo) 21) Pacific 22) Alaska (most areas) 23) Alaska - Juneau area 24) Alaska - Sitka area 25) Alaska - Annette Island 26) Alaska - Yakutat 27) Alaska (west) 28) Aleutian Islands 29) Hawaii #? 21 The following information has been given: United States Pacific Time

Therefore TZ='America/Los_Angeles' will be used. Is the above information OK? 1) Yes 2) No #? 1 Local time is now: Thu May 16 17:12:11 PDT 2019. Universal Time is now: Fri May 17 00:12:11 UTC 2019. No NTP servers configured. Would you like to manually adjust the system time (y,n)? n executing app post_install Enter Call Agent 1) Cisco Unified Communications Manager (CUCM) 2) Cisco Unified Communications Manager Express (CUCME) -- default #? 2 Setting Call Agent to CUCME

Installation Guide for Cisco Unity Express Virtual 10.0 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

executing app post_install done postinstall2 - starting all the services Created symlink from /etc/systemd/system/multi-user.target.wants/tomcat.service to /usr/lib/systemd/system/tomcat.service. Created symlink from /etc/systemd/system/multi-user.target.wants/superthread.service to /usr/lib/systemd/system/superthread.service. Created symlink from /etc/systemd/system/multi-user.target.wants/wfengine.service to /usr/lib/systemd/system/wfengine.service. Created symlink from /etc/systemd/system/multi-user.target.wants/media_ums.service to /usr/lib/systemd/system/media_ums.service. Created symlink from /etc/systemd/system/multi-user.target.wants/smartagent.service to /usr/lib/systemd/system/smartagent.service. Created symlink from /etc/systemd/system/default.target.wants/monit.service to /usr/lib/systemd/system/monit.service. Created symlink from /etc/systemd/system/default.target.wants/monitEnableAll.service to /usr/lib/systemd/system/monitEnableAll.service. Removed symlink /etc/systemd/system/[email protected]. Created symlink from /etc/systemd/system/getty.target.wants/[email protected] to /usr/lib/systemd/system/[email protected].

waiting for all services to come online ... 50

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

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

- CUE Voicemail Language Support version 10.0.0 - Netconf version 10.0.0

Router# show software packages

Installed Plug-ins: - CUE Voicemail Language Support (Languages global pack) (10.0) - CUE Voicemail US English (English language pack) (10.0)

Installation Guide for Cisco Unity Express Virtual 10.0 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

Router-Module>

The following is a sample configuration if n is selected:

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

Waiting 49 ...

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

Installation Guide for Cisco Unity Express Virtual 10.0 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

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

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

Installation Guide for Cisco Unity Express Virtual 10.0 36 CHAPTER 6 Configure Cisco Unity Express Virtual Application

Cisco Unity Express Virtual can be configured in the following ways: • Configure Cisco Unity Express Virtual using GUI, on page 37 • Configure Cisco Unity Express Virtual using CLI, on page 37 Configure Cisco Unity Express Virtual using GUI Cisco Unity Express Virtual can be configured using Graphical User Interface (GUI). The GUI can be accessed by using the IP address provided during installation.

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

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

Installation Guide for Cisco Unity Express Virtual 10.0 37 Configure Cisco Unity Express Virtual Application Configure Cisco Unity Express Virtual using CLI

Installation Guide for Cisco Unity Express Virtual 10.0 38 CHAPTER 7 Cisco Unity Express Virtual Licensing

Cisco Unity Express Virtual Release 10.0 supports only Cisco Smart Software Licensing. For information on configuring Cisco Smart Licenses, see Cisco Unity Express VoiceMail and Auto Attendant CLI Administrator Guide, and Configuring Cisco Unity Express 10.0 Using the GUI. • Installation Sequence, on page 39 • Activate Evaluation Licenses, on page 39 Installation Sequence Cisco Unity Express Virtual software licenses are installed in the following order: 1. Mailbox licenses 2. IVR licenses

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

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

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

Installation Guide for Cisco Unity Express Virtual 10.0 39 Cisco Unity Express Virtual Licensing Activate Evaluation Licenses

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

DETAILED STEPS

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

Evaluation licenses are being activated in the device for the following feature(s): Feature Name: VMIVR-VM-MBX

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

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

Installation Guide for Cisco Unity Express Virtual 10.0 40 Cisco Unity Express Virtual Licensing Activate Evaluation Licenses

Command or Action Purpose

License activation count saved for use at next reload

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

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

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

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

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

Utility: Status: DISABLED

Transport: Type: TransportCallHome

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

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

Installation Guide for Cisco Unity Express Virtual 10.0 41 Cisco Unity Express Virtual Licensing Activate Evaluation Licenses

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

Description: Cisco Unity Express voicemail box license Count: 1 Version: 10.0 Status: InCompliance

Unity Express 10.x IVR Session (regid.2019-01.com.cisco.CUE_IVR,10.0_50fbd88c-8120-4b14-af19-52355fdae940)

Description: Cisco Unity Express IVR session license Count: 2 Version: 10.0 Status: InCompliance

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

Agent Version ======Smart Agent for Licensing: 2.0.10

Installation Guide for Cisco Unity Express Virtual 10.0 42 CHAPTER 8 Migrating Licenses to Cisco Unity Express Virtual 10.0

This chapter describes the procedures to migrate the previous versions of Cisco Unity Express to Cisco Unity Express Virtual Release 10.0. • Migrate Cisco Software Licensing (CSL) to Cisco Smart Software Licensing, on page 43 • Migrate Cisco Unity Express 8.6.12 (SRE) to Cisco Unity Express Virtual 10.0, on page 43 • Migrate Cisco Unity Express Virtual 9.0.x to Cisco Unity Express Virtual 10.0, on page 44 MigrateCiscoSoftwareLicensing(CSL)toCiscoSmartSoftware Licensing You must convert your CSL license to Cisco Smart license in order to use Cisco Unity Express Virtual 10.0. This feature applies for any release up to 9.0.3 migrating to anything 9.0.5 onwards. Perform the following steps to convert your CSL license to Cisco Smart license.

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

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

Installation Guide for Cisco Unity Express Virtual 10.0 43 Migrating Licenses to Cisco Unity Express Virtual 10.0 Migrate Cisco Unity Express Virtual 9.0.x to Cisco Unity Express Virtual 10.0

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

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

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

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 10.0 on Cisco UCS or UCS E-series server modules. For ISR 4000 series KVM containers, use virtual-service upgrade CLI command to upgrade the Cisco Unity Express Virtual from version 9.0.x to 10.0. 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.

Installation Guide for Cisco Unity Express Virtual 10.0 44 Migrating Licenses to Cisco Unity Express Virtual 10.0 Migrate Cisco Unity Express Virtual 9.0.x to Cisco Unity Express Virtual 10.0

Step 8 Once the Cisco Unity Express product instance is registered and authorized, the voicemail and IVR count gets updated in the Cisco Licensing portal. Note If the device exceeds the number of purchased licenses, then the license goes out of compliance, but Cisco Unity Express continues to function normally. You must purchase more licenses or limit the number of voicemail or IVR sessions.

Installation Guide for Cisco Unity Express Virtual 10.0 45 Migrating Licenses to Cisco Unity Express Virtual 10.0 Migrate Cisco Unity Express Virtual 9.0.x to Cisco Unity Express Virtual 10.0

Installation Guide for Cisco Unity Express Virtual 10.0 46 CHAPTER 9 Language Upgrade Preparation

• Language Upgrade Preparation, on page 47 Language Upgrade Preparation After installation of Cisco Unity Express Virtual 10.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 10.0 47 Language Upgrade Preparation Language Upgrade Preparation

Installation Guide for Cisco Unity Express Virtual 10.0 48 CHAPTER 10 Manually Backing Up Files

• Manually Backing Up Files, on page 49 Manually Backing Up Files Enter backup commands in EXEC mode after moving the system offline. System configuration is not allowed when the system is in an offline state.

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

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

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

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

Installation Guide for Cisco Unity Express Virtual 10.0 49 Manually Backing Up Files Numbering Scheme for Backup Files

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

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

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

DETAILED STEPS

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

Step 2 continue Exits offline mode and enters EXEC mode. Example: Router(offline)# continue

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

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

Installation Guide for Cisco Unity Express Virtual 10.0 50 CHAPTER 11 Restoring Files

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

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

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

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

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

Installation Guide for Cisco Unity Express Virtual 10.0 51 Restoring Files Restoring Files

8. Enable the IMAP on Cisco Unity Express Virtual 10.0. 9. show backup history

DETAILED STEPS

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

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

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

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

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

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

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

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

Installation Guide for Cisco Unity Express Virtual 10.0 52 Restoring Files Restoring Files

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

Installation Guide for Cisco Unity Express Virtual 10.0 53 Restoring Files Restoring Files

Installation Guide for Cisco Unity Express Virtual 10.0 54 CHAPTER 12 Troubleshooting Cisco Unity Express Virtual Service on KVM Service Containers

• Example for Verifying Installation Failure of Cisco Unity Express Virtual Service, on page 55 • Example for Verifying Activation Failure of Cisco Unity Express Virtual Service, on page 57 • Check Memory Present on Cisco 4000 Series Integrated Services Routers, on page 58 ExampleforVerifyingInstallationFailureofCiscoUnityExpress 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-10-0-0-ISR4K.ova

Router# virtual-service install name cue package bootflash:CUE Router# $ll name cue package bootflash:CUE-Virtual-10-1-0-ISR4K.ova Installing package 'bootflash:/CUE-Virtual-10-0-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-10-0-0-ISR4K.ova

Installation Guide for Cisco Unity Express Virtual 10.0 55 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-10-0-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-10-0-0-ISR4K.ova cue Installing CUE-Virtual-10-0-0-ISR4K.ova

Router# show virtual-service list Virtual Service List:

Name Status Package Name ------vcue Activated CUE-Virtual-10-0-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 10.0 56 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-10-0-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-10-0-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

Installation Guide for Cisco Unity Express Virtual 10.0 57 Troubleshooting Cisco Unity Express Virtual Service on KVM Service Containers Check Memory Present on Cisco 4000 Series Integrated Services Routers

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

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.

CheckMemoryPresentonCisco4000SeriesIntegratedServices Routers To check the current system memory usage on Cisco IOS XE and Cisco IOS XE Denali releases, use the following commands: Router# show version ...... cisco ISR4451-X/K9 (2RU) processor with 7796953K/6147K bytes of memory. Processor board ID FJC2021D0XG 1 Virtual Ethernet interface 4 Gigabit Ethernet interfaces 32768K bytes of non-volatile configuration memory. 16777216K bytes of physical memory. OR Router# show platform software status control-processor brief Load Average Slot Status 1-Min 5-Min 15-Min RP0 Healthy 0.01 0.07 0.11 Memory (kB) Slot Status Total Used (Pct) Free (Pct) Committed (Pct) RP0 Healthy 16262244 2304168 (14%) 13958076 (86%) 1919520 (12%)

Installation Guide for Cisco Unity Express Virtual 10.0 58