Professional Documents
Culture Documents
Cue Install Book
Cue Install Book
Cue Install Book
2
First Published: 2019-11-25
Last Modified: 2021-11-10
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,
INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH
THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,
CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version of
the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS.
CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT
LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network
topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional
and coincidental.
All printed copies and duplicate soft copies of this document are considered uncontrolled. See the current online version for the latest version.
Cisco has more than 200 offices worldwide. Addresses and phone numbers are listed on the Cisco website at www.cisco.com/go/offices.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL:
https://www.cisco.com/c/en/us/about/legal/trademarks.html. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a
partnership relationship between Cisco and any other company. (1721R)
© 2019–2020 Cisco Systems, Inc. All rights reserved.
CONTENTS
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
Verify Cisco Unified Communication Manager Express and Cisco Unity Express Virtual on ESXi
20
Verify Cisco Unified Communication Manager and Cisco Unity Express Virtual on ESXi 21
CHAPTER 5 Cisco Unity Express Virtual Software Support on Cisco 4000 Series Integrated Services Routers KVM
Service Containers 23
Overview of OVA Installation Steps on KVM Service Container 23
Hardware Requirements for Cisco Unity Express Virtual KVMs on Cisco 4000 Series Integrated Services
Routers 24
Install and Configure the Cisco Unity Express Virtual OVA on KVM Service Containers 24
Deactivate and Uninstall Cisco Unity Express Virtual from KVM Service Containers 28
Upgrade Cisco Unity Express Virtual 9.0.6 to 10.2 29
Example for Accessing and Configuring the Cisco Unity Express Virtual in Cisco 4000 Series Integrated
Services Routers Service Container 30
Installation Sequence 39
Activate Evaluation Licenses 39
Migrate Cisco Unity Express Virtual 9.0.x to Cisco Unity Express Virtual 10.2 45
Migrate Cisco Unity Express Virtual 10.0.x to Cisco Unity Express Virtual 10.2 46
Restoring Files 51
CHAPTER 12 Troubleshooting Cisco Unity Express Virtual Service on KVM Service Containers 55
Example for Verifying Installation Failure of Cisco Unity Express Virtual Service 55
Example for Verifying Activation Failure of Cisco Unity Express Virtual Service 55
Check Memory Present on Cisco 4000 Series Integrated Services Routers 56
The command no web session security keylabel HTTPS is enabled by default. You need not manually
labelname is disabled. generate a crypto key and pass it to the web session
security to enable HTTPS.
Cisco Unified SIP Proxy 10.2 supports only TLS v1.2
for HTTPS.
The command no web session security keylabel
labelname is disabled. Therefore all the HTTP
requests will be redirected to HTTPS. Only the latest
connection is retained and the remaining connections
are logged out.
Smart Agent version upgrade Smart Agent is upgraded to latest version 3.0.9.
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
Note Cisco Unity Express Virtual 10.2.1 release included the support of Cisco IOS XE Release 17.3.2 and later.
vCUE 10.2.0 and lower version support Cisco IOS XE Release 17.3.1 or lower releases.
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
!
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
f) Configure the appropriate number of SIP dial peers to support your dial plan.
g) Verify that a Cisco Unified CME web administrator is configured with a username and password, for example:
voice register global
.
.
.
web admin system name admin password user1
OR
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.
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
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.
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.
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 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.
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.
Table 2: Virtual Machine Requirements for Cisco UCS and Cisco UCS E-Series server Platforms
VMware Tools
Cisco Unity Express Virtual Software Release 10.2 does not support installation of VMware Tools or any
third-party tools in a Linux environment.
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.
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 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 1 In the vSphere Client GUI, in the left pane, select the Cisco Unity Express Virtual device. The name of the device is
the name configured during installation.
Step 2 To open the console, click the Console icon in the vSphere toolbar.
A console window appears for the selected CUE instance.
Step 3 In the console window, click the Power On icon (appears as a green “Play” button).
The device boots, displaying the boot output in the console. When the start-up is complete, the console displays a
message, prompting you to start configuration.
Step 4 At the prompt in the console window, confirm that you want to start the configuration process.
• y: If you enter y, the system asks you to confirm, then begin the interactive post installation configuration process.
• Timeout: If you do not enter any input for two minutes, the initial setup wizard is skipped, and you are prompted
to enter the IP address, netmask, and default gateway address. Once you enter the information, the Cisco Unity
Express Virtual Express system is online.
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.
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#
***********************************
* 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
IP : 192.0.2.10
NETMASK:255.255.0.0
GATEWAY: 255.255.0.0
Enter Hostname
(my-hostname, or enter to use Router): Enter
Using Router as default
Please identify a location so that time zone rules can be set correctly.
Please select a continent or ocean.
1) Africa 4) Arctic Ocean 7) Australia 10) Pacific Ocean
2) Americas 5) Asia 8) Europe
3) Antarctica 6) Atlantic Ocean 9) Indian Ocean
#? 2
Please select a country.
1) Anguilla 29) Honduras
2) Antigua & Barbuda 30) Jamaica
3) Argentina 31) Martinique
4) Aruba 32) Mexico
5) Bahamas 33) Montserrat
6) Barbados 32) Netherlands Antilles
7) Belize 34) Nicaragua
8) Bolivia 35) Panama
9) Brazil 36) Paraguay
10) Canada 37) Peru
11) Caribbean NL 38) Puerto Rico
12) Cayman Islands 39) St Barthelemy
13) Chile 40) St Kitts & Nevis
14) Colombia 41) St Lucia
15) Costa Rica 42) St Maarten (Dutch)
16) Cuba 43) St Martin (French)
17) Curacao 44) St Pierre & Miquelon
18) Dominica 45) St Vincent
19) Dominican Republic 46) Suriname
20) Ecuador 47) Trinidad & Tobago
21) El Salvador 48) Turks & Caicos Is
22) French Guiana 49) United States
23) Greenland 50) Uruguay
24) Grenada 51) Venezuela
25) Guadeloupe 52) Virgin Islands (UK)
26) Guatemala 53) Virgin Islands (US)
27) Guyana
28) Haiti
#? 49
Please select one of the following time zone regions.
1) Eastern (most areas)
2) Eastern - MI (most areas)
3) Eastern - KY (Louisville area)
4) Eastern - KY (Wayne)
5) Eastern - IN (most areas)
6) Eastern - IN (Da, Du, K, Mn)
7) Eastern - IN (Pulaski)
8) Eastern - IN (Crawford)
9) Eastern - IN (Pike)
10) Eastern - IN (Switzerland)
11) Central (most areas)
12) Central - IN (Perry)
13) Central - IN (Starke)
14) Central - MI (Wisconsin border)
15) Central - ND (Oliver)
16) Central - ND (Morton rural)
17) Mountain (most areas)
18) Mountain - ID (south); OR (east)
19) Mountain Time - Navajo
20) MMST - Arizona (except navajo)
21) Pacific
22) Alaska (most areas)
23) Alaska - Juneau area
24) Alaska - Sitka area
25) Alaska - Annette Island
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::
SYSTEM ONLINE
Installed Packages:
- Installer (Installer application) (10.2)
- Thirdparty (Service Engine Thirdparty Code) (10.2)
- Infrastructure (Service Engine Infrastructure) (10.2)
- Global (Global manifest) (10.2)
- GPL Infrastructure (Service Engine GPL Infrastructure) (10.2)
- Voice Mail (Voicemail application) (10.2)
- Bootloader (Primary) (Service Engine Bootloader) (10.2)
- Core (Service Engine OS Core) (10.2)
- Auto Attendant (Service Engine Telephony Infrastructure) (10.2)
Installed Plug-ins:
- CUE Voicemail Language Support (Languages global pack) (10.2)
- CUE Voicemail US English (English language pack) (10.2)
Router-Module>
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::
(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#
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:
Note This step is applicable only for the Cisco UCS 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:
Note This step is applicable only for the Cisco UCS Series Servers.
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.
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
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.
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.
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
Step 4 virtual-service install name service-name package Installs the virtual service.
uri/package-location: .ova
Note The command virtual-service name is
case-sensitive. For example, if you configure
virtual-service vCUE and virtual-service vcue,
two different instances of Cisco Unity Express
Virtual is created.
Step 5 show virtual-service list Lists the service package name and the installation status.
Example:
Step 6 configure terminal Enters the router configuration mode.
Example:
Router# configure terminal
Step 7 interface VirtualPortGroup number To configure the installed service, you must first configure
the VirtualPortGroup interfaces.
Example:
Router(config)# interface VirtualPortGroup 1 The VirtualPortGroup forms a bridge and is configured as
the default gateway between the installed VM and the host
router.
Step 10 vnic gateway VirtualPortGroup instance-number Associates the VirtualPortGroup interface with the virtual
service.
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 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.
SUMMARY STEPS
1. enable
2. configure terminal
3. virtual-service service-name
4. no activate
5. end
6. show virtual-service list
7. virtual-service uninstall name service-name
8. exit
DETAILED STEPS
Step 6 show virtual-service list To view the service activation status, enter the show
virtual-service list command after exiting from the virtual
service configuration.
Step 7 virtual-service uninstall name service-name Enter this command to uninstall the virtual service.
Example:
Router# virtual-service uninstall name cue
SUMMARY STEPS
1. Log in to Cisco Unity Express Virtual.
2. Deactivate the virtual service. For details on deactivating the virtual service, see Deactivate and Uninstall
Cisco Unity Express Virtual from KVM Service Containers, on page 28.
3. Use the virtual-service upgrade command in Privileged EXEC mode to upgrade the Cisco Unity Express
Virtual from Release version 9.0.6 to 10.2.
DETAILED STEPS
***********************************
* 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
IP : 192.0.2.10
NETMASK:255.255.0.0
GATEWAY: 255.255.0.0
Enter Hostname
(my-hostname, or enter to use Router): Enter
Using Router as default
Please identify a location so that time zone rules can be set correctly.
Please select a continent or ocean.
1) Africa 4) Arctic Ocean 7) Australia 10) Pacific Ocean
2) Americas 5) Asia 8) Europe
3) Antarctica 6) Atlantic Ocean 9) Indian Ocean
#? 2
Please select a country.
1) Anguilla 29) Honduras
2) Antigua & Barbuda 30) Jamaica
3) Argentina 31) Martinique
4) Aruba 32) Mexico
5) Bahamas 33) Montserrat
6) Barbados 32) Netherlands Antilles
7) Belize 34) Nicaragua
8) Bolivia 35) Panama
9) Brazil 36) Paraguay
10) Canada 37) Peru
11) Caribbean NL 38) Puerto Rico
12) Cayman Islands 39) St Barthelemy
13) Chile 40) St Kitts & Nevis
14) Colombia 41) St Lucia
15) Costa Rica 42) St Maarten (Dutch)
16) Cuba 43) St Martin (French)
17) Curacao 44) St Pierre & Miquelon
18) Dominica 45) St Vincent
19) Dominican Republic 46) Suriname
20) Ecuador 47) Trinidad & Tobago
21) El Salvador 48) Turks & Caicos Is
22) French Guiana 49) United States
23) Greenland 50) Uruguay
24) Grenada 51) Venezuela
25) Guadeloupe 52) Virgin Islands (UK)
26) Guatemala 53) Virgin Islands (US)
27) Guyana
28) Haiti
#? 49
Please select one of the following time zone regions.
1) Eastern (most areas)
2) Eastern - MI (most areas)
3) Eastern - KY (Louisville area)
4) Eastern - KY (Wayne)
5) Eastern - IN (most areas)
6) Eastern - IN (Da, Du, K, Mn)
7) Eastern - IN (Pulaski)
8) Eastern - IN (Crawford)
9) Eastern - IN (Pike)
10) Eastern - IN (Switzerland)
11) Central (most areas)
12) Central - IN (Perry)
13) Central - IN (Starke)
14) Central - MI (Wisconsin border)
15) Central - ND (Oliver)
16) Central - ND (Morton rural)
17) Mountain (most areas)
18) Mountain - ID (south); OR (east)
19) Mountain Time - Navajo
20) MMST - Arizona (except navajo)
21) Pacific
22) Alaska (most areas)
23) Alaska - Juneau area
24) Alaska - Sitka area
25) Alaska - Annette Island
26) Alaska - Yakutat
27) Alaska (west)
28) Aleutian Islands
29) Hawaii
#? 21
The following information has been given:
United States
Pacific Time
/usr/lib/systemd/system/monitEnableAll.service.
Removed symlink /etc/systemd/system/serial-getty@ttyS0.service.
Created symlink from /etc/systemd/system/getty.target.wants/serial-getty@ttyS0.service to
/usr/lib/systemd/system/serial-getty@.service.
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::
SYSTEM ONLINE
Router# show software versions
Cisco Unity Express Virtual version (10.2.0)
Components:
Installed Packages:
- Installer (Installer application) (10.2)
- Thirdparty (Service Engine Thirdparty Code) (10.2)
- Infrastructure (Service Engine Infrastructure) (10.2)
- Global (Global manifest) (10.2)
- GPL Infrastructure (Service Engine GPL Infrastructure) (10.2)
- Voice Mail (Voicemail application) (10.2)
- Bootloader (Primary) (Service Engine Bootloader) (10.2)
- Core (Service Engine OS Core) (10.2)
- Auto Attendant (Service Engine Telephony Infrastructure) (10.2)
Installed Plug-ins:
- CUE Voicemail Language Support (Languages global pack) (10.2)
- CUE Voicemail US English (English language pack) (10.2)
Router-Module>
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
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::
(INIT)se-0-0-0-0#
(INIT)se-0-0-0-0#
INIT)se-0-0-0-0#
(INIT)se-0-0-0-0# conf t
Enter configuration commands, one per line. End with CNTL/Z.
(INIT)se-0-0-0-0(config)# inter
(INIT)se-0-0-0-0(config)# interface Fast
(INIT)se-0-0-0-0(config)# interface FastEthernet 0
(INIT)se-0-0-0-0(config-interface)# ip add
(INIT)se-0-0-0-0(config-interface)# ip address 192.0.2.35 255.255.0.0
(INIT)se-0-0-0-0(config-interface)# exit
(INIT)se-0-0-0-0(config)# def
(INIT)se-0-0-0-0(config)# default gat
(INIT)se-0-0-0-0(config)# ip de
(INIT)se-0-0-0-0(config)# ip default-gateway 192.0.2.36
(INIT)se-0-0-0-0(config)# end
SYSTEM ONLINE
se-0-0-0-0# conf t
Enter configuration commands, one per line. End with CNTL/Z.
se-0-0-0-0(config)# hostn
se-0-0-0-0(config)# hostname se-192.0.2.35
se-192-0-2-35(config)# end
se-192-0-2-35# wr
se-192-0-2-35#
Note Configuring Cisco Unity Express Virtual using service-module command from Unified CME is not supported.
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.
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.
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
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
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
Product Information
===================
UDI: PID:UC_VCUE,SN:TZnZJUz7kZS
Agent Version
=============
Smart Agent for Licensing: 3.0.9
MigrateCiscoSoftwareLicensing(CSL)toCiscoSmartSoftware
Licensing
This feature applies for any release up to 9.0.3 migrating to anything 9.0.5 onwards.
Perform the following steps to convert your CSL license to Cisco Smart license.
Step 1 Request for a Smart Account and a virtual account using the Cisco portal, http://www.cisco.com/go/smartlicensing. If
you already have a Smart Account, proceed to step 2.
Step 2 Add your devices in your virtual account using the SRE or Cisco Unity Express Virtual product activation keys (PAKs)
in the Product License Registration portal.
Step 3 Select the PAKs that you have added, and convert them to smart license entitlements.
You can view the licenses in your virtual account.
SUMMARY STEPS
1. Back up your Cisco Unity Express 8.6.12 configurations.
2. Install the Cisco Unity Express Virtual 10.2 on ISR 4000 series KVM container or Cisco UCS or UCS
E-series server modules.
3. Smart Licensing is enabled by default. If you need to use IVR feature, enable IVR license using license
activate ivr sessions CLI.
4. Ensure that both Cisco Unity Express 8.6.12 (SRE) and Cisco Unity Express Virtual 10.2. has same
hostname, and then restore the backup to the newly installed Cisco Unity Express.
5. Once the Cisco Unity Express Virtual 10.2 reboots, the system comes up in INIT mode. Configure the IP
address and default gateway address, and save the configuration.
6. Smart agent is enabled by default. The Cisco Unity Express enters an evaluation period of 90 days, as
there are active mailboxes or IVR sessions in the Cisco Unity Express backup. After the evaluation period
expires, the Cisco Unity Express stops functioning normally.
7. Log in to your Smart Account in Cisco Smart Software Manager, and generate a token ID.
8. Register your Cisco Unity Express product instance using the token ID.
9. Once the Cisco Unity Express product instance is registered and authorized, the voicemail and IVR count
gets updated in the Cisco licensing portal.
DETAILED STEPS
Note If you are on Cisco Unity Express Release 8.6.1, you must first upgrade it to version 8.12.1. After upgrading
to Cisco Unity Express Release 8.12.1, take a backup and upgrade to Cisco Unity Express Release 10.2.
SUMMARY STEPS
1. Back up your Cisco Unity Express Virtual 9.0.x configurations.
2. If you are using Smart Licensing Version 9, unregister from CSSM.
3. Uninstall the Cisco Unity Express Virtual 9.0.x.
4. Reinstall and configure the Cisco Unity Express Virtual 10.2 on Cisco UCS or UCS E-series server
modules. For ISR 4000 series KVM containers, use virtual-service upgrade CLI command to upgrade
the Cisco Unity Express Virtual from version 9.0.x to 10.2.
5. Restore the backup to the newly installed Cisco Unity Express.
6. Smart agent is enabled by default. The Cisco Unity Express enters an evaluation period of 90 days. After
the evaluation period expires, register the product instance with the CSSM, otherwise Cisco Unity Express
stops functioning normally.
7. Log in to your Smart Account in Cisco Smart Software Manager, and generate a token ID.
8. Register your Cisco Unity Express product instance using the token ID.
9. Once the Cisco Unity Express product instance is registered and authorized, the voicemail and IVR count
gets updated in the Cisco Licensing portal.
DETAILED STEPS
MigrateCiscoUnityExpressVirtual10.0.xtoCiscoUnityExpress
Virtual 10.2
Perform the following steps to migrate Cisco Unity Express Virtual 10.0.x to Cisco Unity Express Virtual
10.2.
SUMMARY STEPS
1. Back up your Cisco Unity Express Virtual 10.0.x configurations.
2. Uninstall the Cisco Unity Express Virtual 10.0.x.
3. Reinstall and configure the Cisco Unity Express Virtual 10.2 on Cisco UCS or UCS E-series server
modules. For ISR 4000 series KVM containers, use virtual-service upgrade CLI command to upgrade
the Cisco Unity Express Virtual from version 10.0.x to 10.2.
4. Restore the backup to the newly installed Cisco Unity Express.
5. Smart agent is enabled by default. The Cisco Unity Express enters an evaluation period of 90 days. After
the evaluation period expires, register the product instance with the CSSM, otherwise Cisco Unity Express
stops functioning normally.
6. Log in to your Smart Account in Cisco Smart Software Manager, and generate a token ID.
7. Register your Cisco Unity Express product instance using the token ID.
8. Once the Cisco Unity Express product instance is registered and authorized, the voicemail and IVR count
gets updated in the Cisco Licensing portal.
DETAILED STEPS
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.
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.
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.
SUMMARY STEPS
1. backup category {all | configuration | historicaldata | data}
2. continue
3. show backup history
4. show backup server
DETAILED STEPS
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
Restoring Files
After the backup files are created, you can restore them when needed. Restoring is done in offline mode.
Active calls, IMAP, and VoiceView sessions are terminated, and no new calls are accepted (auto attendant
calls are permitted). You should consider doing the restore when telephone subscribers are least likely to be
on the telephone.
Use the show backup server command to locate the backup ID of the file to restore.
Note If you are using Interactive Voice Response (IVR) applications, and you need to restore Cisco Unity Express
10.0 backup on a new Cisco Unity Express 10.2, perform the following steps:
1. Enable IVR license.
2. Restore the backup files. You will be prompted for a reload.
3. Register the Cisco Unity Express product instance with the Cisco Smart Software Manager or Smart
Software Manager satellite using the license smart register idtoken force CLI command.
If you are not using IVR, you do not need to register the product instance again.
For more detailed information about restoring files, see Cisco Unity Express Voice-Mail and Auto-Attendant
CLI Administrator Guide and the GUI online help.
SUMMARY STEPS
1. show backup server
2. offline
3. restore id backupid category {all | configuration | data}
4. reload
5. Create a new administrator after restore.
6. Reset the password for all the restored users.
7. Enable licenses on Cisco Unity Express Virtual 10.2.
DETAILED STEPS
Step 2 offline Enters offline mode. All active voicemail calls are
terminated.
Example:
Router# offline
Step 3 restore id backupid category {all | configuration | data} Specifies the backup ID backupid value and the file type to
be restored.
Example:
Router(offline)# restore id 22 category all
Router(offline)# restore id 8 category
configuration
Router(offline)# restore id 3 category data
Step 4 reload Resets the Cisco Unity Express Virtual module so that the
restored values take effect.
Example:
Router(offline)# reload
Step 5 Create a new administrator after restore. Maintain the same administrator on Cisco Unity Express
Virtual 9.0.x and Cisco Unity Express Virtual 10.2. If the
Cisco Virtual Unity Express 10.2 administrator is different
from Cisco Virtual Unity Express 9.0.x administrator, then
create a new administrator after the restore. For information
on creating an administrator, see Configure Cisco Unity
Express 10.2 Using the GUI.
Step 6 Reset the password for all the restored users. Reset the password for all the restored users. After the
restore and reload of the Cisco Unity Express Virtual 10.2,
use the administrator credentials of Cisco Unity Express
Virtual 10.2 to reset the passwords of Cisco Unity Express
Virtual 9.0.x users. For information on changing your
password, see Configure Cisco Unity Express 10.2 Using
the GUI.
Step 7 Enable licenses on Cisco Unity Express Virtual 10.2. If Cisco Unity Express Virtual 9.0.x has IVR and EDBS
licenses (if applicable) enabled, then ensure to enable these
licenses on Cisco Unity Express Virtual 10.2 before the
restore.
Step 8 Enable the IMAP on Cisco Unity Express Virtual 10.2. If Cisco Unity Express Virtual 9.0.x has IMAP enabled,
then you must manually enable the IMAP on Cisco Unity
Express Virtual 10.2 after the restore.
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%)