Installation and Upgrade Guide for
Cisco Unified Messaging Gateway
Release 8.0
September 3, 2010
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
Text Part Number: OL-22339-02
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 following information is for FCC compliance of Class A devices: This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant
to part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial
environment. This equipment generates, uses, and can radiate radio-frequency energy and, if not installed and used in accordance with the instruction manual, may cause
harmful interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful interference, in which case users will be required
to correct the interference at their own expense.
The following information is for FCC compliance of Class B devices: The equipment described in this manual generates and may radiate radio-frequency energy. If it is not
installed in accordance with Cisco’s installation instructions, it may cause interference with radio and television reception. This equipment has been tested and found to
comply with the limits for a Class B digital device in accordance with the specifications in part 15 of the FCC rules. These specifications are designed to provide reasonable
protection against such interference in a residential installation. However, there is no guarantee that interference will not occur in a particular installation.
Modifying the equipment without Cisco’s written authorization may result in the equipment no longer complying with FCC requirements for Class A or Class B digital
devices. In that event, your right to use the equipment may be limited by FCC regulations, and you may be required to correct any interference to radio or television
communications at your own expense.
You can determine whether your equipment is causing interference by turning it off. If the interference stops, it was probably caused by the Cisco equipment or one of its
peripheral devices. If the equipment causes interference to radio or television reception, try to correct the interference by using one or more of the following measures:
• Turn the television or radio antenna until the interference stops.
• Move the equipment to one side or the other of the television or radio.
• Move the equipment farther away from the television or radio.
• Plug the equipment into an outlet that is on a different circuit from the television or radio. (That is, make certain the equipment and the television or radio are on circuits
controlled by different circuit breakers or fuses.)
Modifications to this product not authorized by Cisco Systems, Inc. could void the FCC approval and negate your authority to operate the product.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public
domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be found at
www.cisco.com/go/trademarks. Third party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership
relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the
document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
© 2010 Cisco Systems, Inc. All rights reserved.
CONTENTS
Overview of Cisco Unified Messaging Gateway Release 8.0 Installation 1
About Cisco Unified Messaging Gateway (Cisco UMG)
About VPIM Functionality 1
About SRSV Functionality 2
Overview of Installing Cisco UMG Release 8.0
1
2
Obtaining Documentation and Submitting a Service Request
Technical Assistance
4
4
Prerequisites and Restrictions for Installing Cisco Unified Messaging Gateway Release 8.0 7
Prerequisites 7
About Power Supplies
Restrictions 8
Hardware 8
System Functionality
7
8
Installing Cisco UMG Release 8.0 9
Activating IP Connectivity to Cisco UMG
Prerequisites 9
Summary Steps 10
Detailed Steps 11
9
Opening and Closing a Session with the Module
Summary Steps 13
Detailed Steps 14
13
How to Download and Install the Software 15
Installing the Cisco UMG Software on Cisco SRE Service Modules 15
About Using the Clean Install Command 16
Installing the Software 16
Example of Installing the Software 17
Using the Postinstallation Configuration Tool 20
Uninstalling Cisco UMG Software on the Cisco SRE Service Module 24
Installing the Software Licenses 25
About the Cisco UMG Release 8.0 SRSV Licenses
Installing the Cisco UMG Release 8.0 Licenses
25
25
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
iii
Contents
Obtaining New or Additional Licenses 26
Required Information 26
Using the Licensing Portal to Obtain Licenses for Additional Features or Applications
Using the CLI to Install the Cisco UMG Release 8.0 Licenses 27
26
Preparing Cisco UMG Release 8.0 to Support VPIM Functionality 29
Adding a DNS Server: Systems with Cisco Unity
29
Adding a DNS Server: Systems without Cisco Unity
29
Preparing Cisco UMG Release 8.0 to Support SRSV Functionality 31
Prerequisites 31
How to Enable SMTP Support for Cisco UMG on Cisco Unity Connection
32
About Security for Cisco Unified SRSV-UMG 32
About Security 32
About Security Certificates 32
Retrieving Security Certificates from Cisco Unity Connection and Cisco Unified Communications
Manager 33
Installing the Security Certificates 33
Upgrading Cisco UMG from Release 8.0 to a Later Release 35
Task List for Using the Software Install Upgrade Command
35
Prerequisites for Using the Software Install Upgrade Command
Downloading and Installing an Upgrade Image
36
36
Index
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
iv
OL-22339-02
Overview of Cisco Unified Messaging Gateway
Release 8.0 Installation
Last updated: September 3, 2010
•
About Cisco Unified Messaging Gateway (Cisco UMG), page 1
•
Overview of Installing Cisco UMG Release 8.0, page 2
•
Obtaining Documentation and Submitting a Service Request, page 4
•
Technical Assistance, page 4
About Cisco Unified Messaging Gateway (Cisco UMG)
Cisco UMG is an application that resides on a module that plugs into a host Cisco router running Cisco
IOS software.
Cisco UMG Release 1.0 consisted of Voice Profile for Internet Mail (VPIM) functionality only.
Cisco UMG Release 8.0 adds support for Cisco Unified Survivable Remote Site Voicemail (SRSV)
functionality.
While Cisco UMG 8.0 provides support for both VPIM and SRSV, because of the nature of how these
solutions are deployed, you would typically deploy either a VPIM solution or an SRSV solution, but not
both on the same Cisco UMG system at the same time. For example, VPIM is used for distributed
messaging deployments, while SRSV is used as a centralized survivable remote site voicemail solution.
For more information, see the following sections:
•
About VPIM Functionality, page 1
•
About SRSV Functionality, page 2
About VPIM Functionality
The VPIM functionality in Cisco UMG delivers the end-to-end message networking functionality
required by large distributed enterprises seamlessly migrating to the Cisco IP telephony solution. The
majority of larger distributed enterprises consist of various legacy voice messaging products that do not
support open standards. The Cisco UMG solution fulfills a gateway function for these networks,
providing a method of intelligently routing messages, exchanging subscriber and directory information,
and providing interoperability within a messaging network. It acts as a central hub for distributed
messaging deployments, specifically:
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
1
Overview of Cisco Unified Messaging Gateway Release 8.0 Installation
Overview of Installing Cisco UMG Release 8.0
•
Cisco Unity Express
•
Cisco Unity Release 4.2 and higher releases for Microsoft Exchange only
•
Avaya Interchange Release 5.4
Cisco UMG enables the messaging network to scale as required for the largest of implementations and
simplifies configuration of all the endpoints. In particular, it enables Cisco Unity Express Release 3.1
and later to autoregister with the system.
About SRSV Functionality
Cisco Unified SRSV is an application that adds support for a survivability architecture to Cisco Unity
Connection voicemail solutions. It works with the various Cisco Unity Connection components to
provide an enhanced user experience in the branch office.
The Cisco Unified SRSV solution requires the installation of two components:
•
Survivable Remote Site Voicemail—Unified Messaging Gateway (SRSV-UMG) component
This is the component covered in this guide, and is installed on the central UMG node.
•
Survivable Remote Site Voicemail—Cisco Unity Express (SRSV-CUE) component
This component is a separate product available from Cisco and is installed on a branch voicemail
server. For documentation on installing Cisco SRSV-CUE, see
http://www.cisco.com/en/US/products/ps10769/tsd_products_support_series_home.html
Overview of Installing Cisco UMG Release 8.0
You can install Cisco UMG Release 8.0 either as a new customer or as an existing customer who is
moving from Cisco UMG Release 1.0 to Release 8.0. If you are upgrading from one version of Release
8.0.x to another, see the “Upgrading Cisco UMG from Release 8.0 to a Later Release” section on
page 35.
Note
We do not support upgrading from Release 1.0 to Release 8.0. If you are currently running Release 1.0
and want to move to Release 8.0, you must do a fresh installation. However, you can skip some of the
steps, as described in Table 1.
To install Cisco UMG Release 8.0, follow these steps.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
2
OL-22339-02
Overview of Cisco Unified Messaging Gateway Release 8.0 Installation
Overview of Installing Cisco UMG Release 8.0
Table 1
Installation Steps
Task
For more information, see
Applicable for
new
Cisco UMG 8.0
customers?
Physically install the
network module or SRE
service module.
NME-UMG and NME-UMG-EC:
Yes
No
Perform the prerequisites and Prerequisites and Restrictions for
review the restrictions.
Installing Cisco Unified Messaging
Gateway Release 8.0, page 7
Yes
Yes
Activate the IP connectivity
to Cisco UMG.
Activating IP Connectivity to
Cisco UMG, page 9
Yes
No
Open a session into Cisco
UMG.
Opening and Closing a Session with
the Module, page 13
Yes
Yes
Back up the existing
installation.
CLI Administration Guide for Cisco
Unified Messaging Gateway
Release 8.0
No
Yes
Download and install the
Cisco UMG software.
How to Download and Install the
Software, page 15
No1
Yes
Run the postinstallation tool. Using the Postinstallation
Configuration Tool, page 20
Yes
Yes
Install the licenses.
Installing the Software Licenses,
page 25
No1
Yes
Restore the backup.
CLI Administration Guide for Cisco
Unified Messaging Gateway
Release 8.0
No
Yes
Preparing the Cisco UMG
system to support VPIM
functionality.
Preparing Cisco UMG Release 8.0 to Yes, if
Support VPIM Functionality, page 29 deploying
VPIM
•
http://www.cisco.com/en/US/docs/r
outers/access/3800/hardware/inst
allation/guide/hw.html
•
http://www.cisco.com/en/US/docs/r
outers/access/3800/hardware/inst
allation/guide/38netmod.html
Applicable for
existing
Cisco UMG 1.0
customers?
SM-SRE-700-K9 and
SM-SRE-900-K9:
•
http://www.cisco.com/en/US/docs/r
outers/access/interfaces/software/
feature/guide/ism-sm-sre.html
Note
The SM-SRE-700-K9 and
SM-SRE-900-K9 are
supported beginning with
UMG release 8.0.2.
No
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
3
Overview of Cisco Unified Messaging Gateway Release 8.0 Installation
Obtaining Documentation and Submitting a Service Request
Table 1
Installation Steps
Applicable for
new
Cisco UMG 8.0
customers?
Applicable for
existing
Cisco UMG 1.0
customers?
Task
For more information, see
Preparing the Cisco UMG
system to support SRSV
functionality.
Preparing Cisco UMG Release 8.0 to Yes, if
Support SRSV Functionality, page 31 deploying
SRSV
Yes, if
deploying
SRSV
Install the SRSV-CUE
software.
Installation and Administration
Guide for Cisco Unified Survivable
Remote Site Voicemail-Cisco Unity
Express (SRSV-CUE) Release 8.0
Yes, if
deploying
SRSV
Yes, if
deploying
SRSV
1. When you order Cisco UMG Release 8.0, the software and licenses are installed on the module at the factory.
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional
information, see the monthly What’s New in Cisco Product Documentation, which also lists all new and
revised Cisco technical documentation, at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the What’s New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed
and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free
service and Cisco currently supports RSS Version 2.0.
Technical Assistance
Description
Link
The Cisco Support website provides extensive online resources, http://www.cisco.com/techsupport
including documentation and tools for troubleshooting and
resolving technical issues with Cisco products and technologies.
To receive security and technical information about your
products, you can subscribe to various services, such as the
Product Alert Tool (accessed from Field Notices), the Cisco
Technical Services Newsletter, and RSS Feeds.
Access to most tools on the Cisco Support website requires a
Cisco.com username and password.
Cisco Feature Navigator website
http://www.cisco.com/go/cfn
Use Cisco Feature Navigator to find
information about platform support
and Cisco IOS and Catalyst OS
software image support. An account
on Cisco.com is not required.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
4
OL-22339-02
Overview of Cisco Unified Messaging Gateway Release 8.0 Installation
Technical Assistance
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
5
Overview of Cisco Unified Messaging Gateway Release 8.0 Installation
Technical Assistance
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
6
OL-22339-02
Prerequisites and Restrictions for Installing
Cisco Unified Messaging Gateway Release 8.0
Last updated: September 3, 2010
•
Prerequisites, page 7
•
Restrictions, page 8
Prerequisites
Complete the following tasks before you install Cisco UMG Release 8.0.
Task
For more information, see
Configure the ISR or ISR G2 for
Cisco Unity Express.
•
http://www.cisco.com/en/US/products/sw/voice
sw/ps5520/tsd_products_support_series_hom
e.html
Verify that your download FTP and TFTP servers FTP server documentation
are accessible. You will need the FTP server for
installations, backups, and restores, and the TFTP
file server (on the FTP-file-server machine) for
boothelper operations to recover if the installation
fails.
Note
The FTP server that communicates with
Cisco UMG must support passive FTP
requests.
Attach an uninterruptible power supply (UPS) to
the router that houses the Cisco UMG module.
About Power Supplies, page 7
About Power Supplies
Any reliable UPS unit provides continuous power to maintain the operation of the router and the
Cisco UMG module.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
7
Prerequisites and Restrictions for Installing Cisco Unified Messaging Gateway Release 8.0
Restrictions
When installing a UPS, consider the unit’s capacity and run time, because power consumption differs
among Cisco platforms. Ideally, a UPS should include a signaling mechanism that directs the router to
shut down Cisco UMG properly and then powers off the router.
Cisco IOS Release 12.3(4)T and later releases support automatic switchover to the UPS device if the
following configuration is added to the router:
line aux 0
privilege level 15
modem Dialin
autocommand service-module service-engine slot/0 shutdown no-confirm
where slot is the Cisco UMG module’s slot number in the host router.
Restrictions
•
Hardware, page 8
•
System Functionality, page 8
•
You cannot replace the hard disk on the NME-UMG, SM-SRE-700-K9, SM-SRE-900-K9 modules.
If the module’s hard disk crashes, you must replace the module.
•
The front panel Fast Ethernet 0 port on the NME-UMG, SM-SRE-700-K9, SM-SRE-900-K9 module
is not used by Cisco UMG and is disabled. The Fast Ethernet 1 port connects the Cisco UMG
module to the router and is the only active Fast Ethernet port on the module.
•
The USB port on the rear of the NME-UMG, SM-SRE-700-K9, and SM-SRE-900-K9 module is not
used by Cisco UMG and is disabled.
Hardware
System Functionality
Cisco UMG does not support CiscoWorks Configmaker.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
8
OL-22339-02
Installing Cisco UMG Release 8.0
Last updated: September 3, 2010
•
Activating IP Connectivity to Cisco UMG, page 9
•
Opening and Closing a Session with the Module, page 13
•
How to Download and Install the Software, page 15
Activating IP Connectivity to Cisco UMG
After installing the module in the router, activate the IP communication link between the system and the
Cisco UMG application.
•
Prerequisites, page 9
•
Summary Steps, page 10
•
Detailed Steps, page 11
Prerequisites
Gather the following information before activating the software:
•
Slot and port numbers of the Cisco UMG module on the Cisco router that hosts Cisco UMG.
•
IP address and subnet mask of the Cisco router that hosts Cisco UMG or the unnumbered interface
type and number.
•
IP address of the Cisco UMG module. This IP address must be on the same subnet as the Cisco
router that hosts Cisco UMG.
•
IP address of the default gateway of the Cisco UMG router. This IP address must be the same IP
address as the Cisco router that hosts Cisco UMG.
Figure 1 shows the router and module interfaces for the NME-UMG module. Figure 2 shows the router
and module interfaces for the SM-SRE modules.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
9
Installing Cisco UMG Release 8.0
Activating IP Connectivity to Cisco UMG
Figure 1
Router and Module Interfaces for NME-UMG
Host Router (Top View)
2 Router interface to module (FastEthernet 0/0)
3 Module interface to router
1 Router interface to external link
4 Module interface to external link
Figure 2
230616
Network Module
Router and Cisco SM-SRE Interfaces
Host Router (Top View)
MGF
PCIe
2
Service Module
251942
1
3
Summary Steps
For internal router interface to module:
1.
enable
2.
config t
3.
Choose one of the following:
– For the NME-UMG and NME-UMG-EC, enter:
interface integrated-Service-Engine slot/port
– For the SM-SRE-700-K9 and SM-SRE-900-K9, enter:
interface sm slot/0
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
10
OL-22339-02
Installing Cisco UMG Release 8.0
Activating IP Connectivity to Cisco UMG
4.
ip address router-ip-addr subnet-mask
or
ip unnumbered type number
5.
service-module ip address umg-side-ip-addr subnet-mask
6.
service-module ip default-gateway gw-ip-addr
7.
ip route umg-side-ip-addr subnet-mask integrated-Service-Engine slot/port
or
ip route umg-side-ip-addr subnet-mask sm slot/0
8.
exit
9.
exit
10. ping umg-side-ip-addr
Detailed Steps
Step 1
Command or Action
Purpose
enable
Enters EXEC mode.
Example:
Router> enable
Step 2
Enters configuration mode.
config t
Example:
Router# config t
Step 3
Choose one of the following:
interface integrated-Service-Engine slot/port
Enters interface configuration mode on the
NME-UMG and NME-UMG-EC.
Example:
Router(config)# interface Service-Engine 2/0
Enters interface configuration mode on the
SM-SRE-700-K9 and SM-SRE-900-K9.
interface sm slot/0
Example:
Router(config)# interface sm 1/0
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
11
Installing Cisco UMG Release 8.0
Activating IP Connectivity to Cisco UMG
Step 4
Command or Action
Purpose
ip address router-ip-addr subnet-mask
Specifies the IP address and subnet mask of the
Cisco IOS router hosting Cisco UMG.
Example:
Router(config-if)# ip address 172.18.12.28
255.255.255.0
or
ip unnumbered type number
Specifies the interface type and number for the
Cisco IOS router hosting Cisco UMG.
Example:
Router(config-if)# ip unnumbered FastEthernet 0/0
Step 5
service-module ip address umg-side-ip-addr
subnet-mask
Specifies the IP address of the Cisco UMG module
interface. This IP address must be on the same subnet
as the Cisco router that hosts Cisco UMG.
Example:
Router(config-if)# service-module ip address
172.18.12.26 255.255.255.255
Step 6
service-module ip default-gateway gw-ip-addr
Specifies the default gateway for Cisco UMG.
Example:
Router(config-if)# ip default-gateway 172.18.12.1
Step 7
ip route umg-side-ip-addr subnet-mask
integrated-Service-Engine slot/port
Specifies the IP route on the Cisco UMG side.
or
ip route umg-side-ip-addr subnet-mask sm slot/0
Example:
Router(config-if)# ip route 172.18.12.26
255.255.255.255 integrated-Service-Engine 2/0
Step 8
Exits interface configuration mode.
exit
Example:
Router(config-if)# exit
Step 9
Exits configuration mode.
exit
Example:
Router(config)# exit
Step 10
Verifies IP connectivity is activated.
ping
Example:
Router# ping 172.18.12.26
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
12
OL-22339-02
Installing Cisco UMG Release 8.0
Opening and Closing a Session with the Module
Opening and Closing a Session with the Module
After you set up the module interfaces, you can open and close a session on the Cisco UMG. The first
time that you access the Cisco UMG module, its hostname will be the factory default, probably
SE-Module.
•
Summary Steps, page 13
•
Detailed Steps, page 14
Summary Steps
From the Host-Router CLI
1.
enable
2.
On the NME-UMG and NME-UMG-EC, enter:
service-module integrated-Service-Engine slot/port status
On the SM-SRE-700-K9 and SM-SRE-900-K9, enter:
service-module sm slot/port status
3.
On the NME-UMG and NME-UMG-EC, enter:
service-module integrated-Service-Engine slot/port session
On the SM-SRE-700-K9 and SM-SRE-900-K9, enter:
service-module sm slot/port session
From the Service-Module Interface
4.
Do configuration or other procedures.
– The first time that you open a session, the system launches the postinstallation configuration
tool. See the “Using the Postinstallation Configuration Tool” section on page 20.
– To see which other configurations are available, see the Cisco Unified Messaging Gateway
Release 1.0 CLI Administrator Guide.
5.
Choose one of the following:
– exit to exit the session
– Control-Shift-6 x to suspend the session
From the Host-Router CLI
6.
If you suspended the session using Control-Shift-6 x, enter one of the following commands:
– On the NME-UMG and NME-UMG-EC, enter:
service-module integrated-Service-Engine slot/port session clear
– On the SM-SRE-700-K9 and SM-SRE-900-K9, enter:
service-module sm slot/port session clear
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
13
Installing Cisco UMG Release 8.0
Opening and Closing a Session with the Module
Detailed Steps
Command or Action
Purpose
From the Host-Router CLI
Step 1
Enters privileged EXEC mode on the host router. Enter your
password if prompted.
enable
Example:
Router> enable
Step 2
On the NME-UMG and NME-UMG-EC, enter:
service-module integrated-service-engine
slot/port status
Displays the status of the network module, so that you can
ensure that the module is running (that is, in steady state).
Note
On the SM-SRE-700-K9 or SM-SRE-900-K9, enter:
If the module is not running, start it with one of the
startup commands listed in the Command Reference
for Cisco Unified Messaging Gateway Release 8.0.
service-module sm slot/port status
Example:
Router# service-module
integrated-service-engine 2/0 status
Step 3
On the NME-UMG and NME-UMG-EC, enter:
service-module integrated-service-engine
slot/port session
Begins a session on the network module. Do one of the
following:
•
To interrupt the autoboot sequence and access the
bootloader, quickly type ***.
•
To start a configuration session, press Enter.
On the SM-SRE-700-K9 or SM-SRE-900-K9, enter:
service-module sm slot/port session
Example:
Router# service-module
integrated-service-engine 1/0 session
From the Service-Module Interface
Step 4
configure terminal
Enter configuration commands on the module as needed.
Example:
Configuration command choices are similar to those that are
available on the router. Access global configuration mode
by using the configure terminal command. Enter
configuration commands.
SE-Module> configure terminal
SE-Module(config)>
.
.
.
Step 5
Choose one of the following:
Exit global configuration mode with the exit command and
save your new configuration with the write command.
exit
write
SE-Module(config)> exit
SE-Module> write
If you entered the exit command, then you do not need to
proceed to the steps below.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
14
OL-22339-02
Installing Cisco UMG Release 8.0
How to Download and Install the Software
Command or Action
Purpose
Press Control-Shift-6 x.
Suspends the active service-module session and returns to
the router CLI.
Note
The service-module session stays up until you clear
it in the next step. While it remains up, you can
return to it from the router CLI by pressing Enter.
From the Host-Router CLI
Step 6
On the NME-UMG and NME-UMG-EC, enter:
service-module integrated-service-engine slot/0
session clear
On the SM-SRE-700-K9 or SM-SRE-900-K9, enter:
Clears the active service-module session for the specified
module. When prompted to confirm this command, press
Enter.
Note
service-module sm slot/0 session clear
This command removes all hung sessions and any
previous sessions suspended by entering
Control-Shift-6 x.
Example:
Router# service-module
integrated-service-engine 1/0 session clear
How to Download and Install the Software
This section describes how to install the Cisco UMG software on the supported modules, and is divided
into the following sections:
Tip
•
Installing the Cisco UMG Software on Cisco SRE Service Modules, page 15
•
About Using the Clean Install Command, page 16
•
Installing the Software, page 16
•
Example of Installing the Software, page 17
•
Using the Postinstallation Configuration Tool, page 20
•
Uninstalling Cisco UMG Software on the Cisco SRE Service Module, page 24
If you lose power or connection during any of the following procedures, the system usually detects the
interruption and tries to recover. If it fails to recover, reinstall the system using the boothelper.
Installing the Cisco UMG Software on Cisco SRE Service Modules
Cisco Unified Messaging Gateway 8.0 is a Cisco-authorized application supported on the Cisco SRE
service modules SM-SRE-700-K9 and SM-SRE-900-K9. The application software may be pre-installed
on the Cisco SRE service modules when ordered. For information on installing Cisco UMG and other
Cisco-authorized applications on the Cisco SRE service modules, see the Cisco SRE Service Module
Configuration and Installation Guide. When following the instructions in that guide, install the
umg-k9.sme.8.0.x.pkg file.
The installation procedure described in that guide is the preferred method of installing applications on
the Cisco SRE service modules. The clean installation procedure described in the “About Using the
Clean Install Command” section on page 16 and “Installing the Software” section on page 16 is also
supported.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
15
Installing Cisco UMG Release 8.0
How to Download and Install the Software
About Using the Clean Install Command
The system is offline while you are using this clean installation process. The clean installation erases
and repartitions the disk before loading the new files on the disk.
However, your previous configuration is usually saved to the flash memory. After the new files are
loaded, the system offers to restore the configuration it finds in flash, if any. You can choose to restore
this configuration into the new image. A stored configuration contains some of the data from a previous
installation, but not as much as a backup.
If you are recovering from a disaster and do not have a backup, you can restore the saved configuration.
If you choose not to restore the saved configuration, it is erased from flash.
Installing the Software
Before You Begin
•
If you are an existing Cisco UMG customer and moving from Release 1.0 to Release 8.0, be sure to
back up your configuration before you install the software. See the CLI Administration Guide for
Cisco Unified Messaging Gateway Release 8.0 for information.
•
Gather the following information:
– FTP server hostname or IP address. If the Cisco UMG is configured to use DNS, use the
hostname. If the Cisco UMG is not configured to use DNS, use the IP address.
– FTP server username
– FTP server password
– Software package name
•
Ensure that the FTP server is configured and active.
•
Ensure that you can ping the Cisco UMG module from the FTP server.
Procedure
Step 1
Log in to Cisco.com and go to the Cisco UMG page at
http://www.cisco.com/en/US/products/ps8605/index.html.
Step 2
Download all the Cisco UMG software files.
Step 3
Copy the files to the FTP server.
Step 4
Starting from Cisco UMG EXEC mode, enter the following to validate connectivity to the FTP server:
ping <ftp_server_ip_address>
Step 5
Install the software by entering one of the following:
For the NME-UMG and NME-UMG-EC, enter:
software install clean url ftp://<ftp_server_ip_address>/umg-k9.nmx.8.0.<x>.pkg username
<user_name> password <password>
For the SM-SRE-700-K9 and SM-SRE-900-K9, enter:
software install clean url ftp://<ftp_server_ip_address>/umg-k9.sme.8.0.<x>.pkg username
<user_name> password <password>
Step 6
Enter y to confirm installation.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
16
OL-22339-02
Installing Cisco UMG Release 8.0
How to Download and Install the Software
Step 7
Enter y to begin postinstallation configuration immediately.
Step 8
Enter y to confirm immediate configuration.
Step 9
Enter y to restore the configuration saved in memory or n to use your backup to restore your
configuration.
Step 10
If you entered y in step 9 enter y again to confirm restoration of the saved configuration.
Step 11
Use the show software version command to verify the reinstallation.
Related Topics
Refer to the Command Reference for Cisco Unified Messaging Gateway Release 8.0 for information
about the CLI commands.
Example of Installing the Software
The following output illustrates the online installation process for the NME-UMG or NME-UMG-EC,
from ensuring the FTP server is reachable, to configuration using the data found in memory and finally,
verifying the version.
se-10-50-30-125# software install clean url ftp://10.50.10.25/dir/umg-k9.nmx.8.0.1.pkg
WARNING:: This command will install the necessary software to
WARNING:: complete a clean install. It is recommended that a backup be done
WARNING:: before installing software.
Would you like to continue?[confirm]
Downloading ftp umg-k9.nmx.8.0.1.pkg
Bytes downloaded : 147082
Validating package signature ... done
- Parsing package manifest files... complete.
Validating installed manifests ........complete.
- Checking Package dependencies... complete.
- Checking Manifest dependencies for subsystems in the install candidate list...
complete
Starting payload download
Starting payload download
File : umg-full-k9.nmx.8.0.1.prt1 Bytes : 83865859
Downloading payload(s) complete
Validating payloads match registered checksums...
- umg-full-k9.nmx.8.0.1.prt1
................................................................................verified
Validating installed manifests ........complete.
Clearing previous downgrade files ... complete.
Performing Hot install ...starting_phase:
install_files.sh /dwnld/.hot_work_order
install_file: /dwnld/pkgdata/umg-full-k9.nmx.8.0.1.prt1 0 __PRIMARY_BOOTLOADER__ gz
add_file /dwnld/pkgdata/umg-k9.nmx.8.0.1.pkg 1 /
/sw/installed/manifest/bootloader_prim_manifest.sig none
install_file: /dwnld/pkgdata/umg-full-k9.nmx.8.0.1.prt1 5 __SECONDARY_BOOTLOADER__ gz
add_file /dwnld/pkgdata/umg-k9.nmx.8.0.1.pkg 4 /
/sw/installed/manifest/bootloader_sec_manifest.sig none
WARNING sysdb util exit (Protocol error) Probable leak of evtsrc @b704f1b0 by: python
InstMain.py
.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
17
Installing Cisco UMG Release 8.0
How to Download and Install the Software
superthread:
INFO superthread server output END
starting_phase:
install_files.sh /dwnld/.work_order
Mon Apr 5 18:20:48 UTC 2010
Remove: ///
root directory
removing INSTALLER_WORK_ORDER
removing INSTALL_COMPLETE
removing application
removing data
removing database
removing home
removing ldap
removing name(s)
removing opt
removing scratch
removing sw
clearing ////tmp/
removing usr
add_file /dwnld/pkgdata/umg-full-k9.nmx.8.0.1.prt1 4 / tgz
add_file /dwnld/pkgdata/umg-full-k9.nmx.8.0.1.prt1 7 / tgz
add_file /dwnld/pkgdata/umg-full-k9.nmx.8.0.1.prt1 9 / tgz
cdp:
INFO cdp server output WARNING sysdb evt provider (Operation canceled) event
handler is dead: event=get, attr=/sw/dns/host/name, sender=1554'/bin/cdpd', state=0,
deadline=11:28:24=+450, provider=dns@1634'?'
cdp:
INFO cdp server output WARNING sysdb evt provider (Operation canceled) event
handler is dead: event=get, attr=/sw/dns/host/domain, sender=1554'/bin/cdpd', state=0,
deadline=18:28:24=+450, provider=dns@1634'?'
extract_mv_file: /dwnld/pkgdata/umg-full-k9.nmx.8.0.1.prt1 2 / lib tgz
extract_mv_file: /dwnld/pkgdata/umg-full-k9.nmx.8.0.1.prt1 2 / bin tgz
extract_mv_file: /dwnld/pkgdata/umg-full-k9.nmx.8.0.1.prt1 2 / etc tgz
extract_mv_file: /dwnld/pkgdata/umg-full-k9.nmx.8.0.1.prt1 2 / sbin tgz
install_file:
n/KpXrE2b444jrkSlT6Kcu3co1adzDK+EGgoG/EwPX5rIY20ST+kRKYH5ulF28p7AIESITDsyssW3XBa6kI3wgeCEN
EL8x5mEtKWGoDL4HzlyK7j3q5Gr7G9P81JGRPA0b77iuFj1QPBWiv931EOA3teCPfg6ZLnSlhFA3s2hmQ=
__BZ_SIGNATURE__
bzsig ldbl -m bryce -t bzsig
n/KpXrE2b444jrkSlT6Kcu3co1adzDK+EGgoG/EwPX5rIY20ST+kRKYH5ulF28p7AIESITDsyssW3XBa6kI3wgeCEN
EL8x5mEtKWGoDL4HzlyK7j3q5Gr7G9P81JGRPA0b77iuFj1QPBWiv931EOA3teCPfg6ZLnSlhFA3s2hmQ=
add_file /dwnld/pkgdata/umg-full-k9.nmx.8.0.1.prt1 2 / bzImage tgz
add_file /dwnld/pkgdata/umg-k9.nmx.8.0.1.pkg 3 /
sw/installed/manifest/umg_infrastructure_manifest.sig none
add_file /dwnld/pkgdata/umg-k9.nmx.8.0.1.pkg 1 /
sw/installed/manifest/bootloader_prim_manifest.sig none
add_file /dwnld/pkgdata/umg-k9.nmx.8.0.1.pkg 7 /
sw/installed/manifest/infrastructure_manifest.sig none
add_file /dwnld/pkgdata/umg-k9.nmx.8.0.1.pkg 8 / sw/installed/manifest/global_manifest.sig
none
add_file /dwnld/pkgdata/umg-k9.nmx.8.0.1.pkg 4 /
sw/installed/manifest/bootloader_sec_manifest.sig none
add_file /dwnld/pkgdata/umg-k9.nmx.8.0.1.pkg 6 /
sw/installed/manifest/installer_manifest.sig none
add_file /dwnld/pkgdata/umg-k9.nmx.8.0.1.pkg 2 / sw/installed/manifest/oscore_manifest.sig
none
add_file /dwnld/pkgdata/umg-k9.nmx.8.0.1.pkg 5 /
sw/installed/manifest/gpl_infrastructure_manifest.sig none
Remove: //dwnld/pkgdata/umg-k9.nmx.8.0.1.pkg
Remove: //dwnld/pkgdata/umg-full-k9.nmx.8.0.1.prt1
Creating new nodes.
Performing final moves mnt_dir: /
INIT: fndn_udins_wrapper:
INFO fndn_udins_wrapper server output END
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
18
OL-22339-02
Installing Cisco UMG Release 8.0
How to Download and Install the Software
cdp:
INFO cdp server output END
Rebooting ...
shutdown: sending all processes the TERM signal...
rbcp:
INFO rbcp daemon output END
platform.config:
trace:
INFO platform.config server output END
INFO trace daemon output END
shutdown: sending all processes the KILL signal.
shutdown: turning off swap
shutdown: unmounting all file systems
Please stand by while rebooting the system.
Restarting system.
Nmi Npx0 Dly P92 Sha0 Kbd0 Cmos Pci Dma0 PrtB Tim Exp Rfsh Geom
Initializing memory.
Media LowBios Brd2
Please wait. Mem0 Mem1 Ebda Sha1 CacheE Admgr1 Memmgr1 AdmgrEbda
Swap to secondary BIOS ... Mem1 Ebda Sha1 CacheE Admgr1 Memmgr1 AdmgrEbda Media LowBios
Brd2 Cache0 Driver PostDrv Dma1 Irq1 Vec Brd4 Time0 Kbd1 Speed Com Vid0 Par PciEnum Vid1
Redir Brd6 Com KbdBuf SMM
General Software Firmbase[r] SMM Kernel 1.3.2 Feb 11 2005 11:51:07
Intel(R) E7320 Performance Development Platform
EIST: Enhanced Intel Speedstep Driver, V3.0.
EIST: Copyright (C) 2003-2006 General Software, Inc.
EIST: Built Mar 3 2006, 14:49:27
UsbHid Pwd Msg0 Msg1 Cache1 Mem2 Prot Cache2 Flg Siz0 Msg2 Ata Dsk Npx1 Apm Err Dbg Enb
App MemReduce MemSync1 Ext MemSync2 PciRom MemSync3 Setup Time1 Mfg Brd8 Com Admgr2 Cfg
Brd10
DDR2 Memory 2047 MB with ECC detected
Intel(R) Celeron(R) M processor
1.00GHz
BIOS ISE 5.00, Build date: 05/05/06
System Now Booting ...
704 832 968 1040 1172 1184 1196 1208 1220 1228 1240 1260 1276 1288 1304 1320 1332 1348
1368 1380 1644 1784 2060 2204 2344 2860 3376 3640 3904 4168 RSA decrypt returned:33
a434d0dc915ae14f5477ff3cf44c7d22
Booting from Secure secondary boot loader..., please wait.
[BOOT-ASM]
Updating flash with bootloader configuration: 1
Please wait ...
.............done.
Please enter '***' to change boot configuration:
Loading disk:/bzImage ... Verifying ... done.
Starting Kernel.
Platform: nme
Cisco init
INIT: version 2.86 booting
mounting proc fs ...
mounting sys fs ...
mounting /dev/shm tmpfs ...
reiser root fs ...
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
19
Installing Cisco UMG Release 8.0
How to Download and Install the Software
Reiserfs super block in block 16 on 0x801 of format 3.6 with standard journal
Blocks (total/free): 19537040/19481910 by 4096 bytes
Filesystem is clean
Filesystem seems mounted read-only. Skipping journal replay.
Checking internal tree..finished
FILESYSTEM CLEAN
Remounting the root filesystem read-write...
kernel.sem = 1900 4000 32 100
vm.overcommit_memory = 1
Welcome to Cisco Service Engine
Power button monitor started
Setting the system time from hardware clock
********** rc.aesop ****************
Populating resource values from /etc/bryce_rsrc_file
attribute ios_rbcp/app_cookie_id exists
Populating resource values from /etc/default_rsrc_file
Populating resource values from /etc/products/umg/default_rsrc_file
Processing manifests . . . . . . . . complete
==> Management interface is eth0
==> Management interface is eth0
Serial Number: FOC11424VUM
INIT: Entering runlevel: 2
********** rc.post_install ****************
Using the Postinstallation Configuration Tool
When you open the first session, the system launches the post installation configuration tool, and asks
you if you want to start configuration immediately.
Enter the appropriate response, y or n. If you enter n, the system will halt. If you enter y, the system will
ask you to confirm, then begin the interactive postinstallation configuration process.
The following is an example:
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
Welcome to Cisco Systems Service Engine
post installation configuration tool.
This is a one time process which will guide
you through initial setup of your Service Engine.
Once run, this process will have configured
the system for your location.
If you do not wish to continue, the system will be halted
so it can be safely removed from the router.
Do you wish to start configuration now (y,n)? yes
Are you sure (y,n)? yes
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
A configuration has been found in flash. You can choose
to restore this configuration into the current image.
A stored configuration contains some of the data from a
previous installation, but not as much as a backup.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
20
OL-22339-02
Installing Cisco UMG Release 8.0
How to Download and Install the Software
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
If you are recovering from a disaster and do not have a
backup, you can restore the saved configuration.
If you choose not to restore the saved configuration, it
will be erased from flash.
Would you like to restore the saved configuration? (y,n) n
Erasing old configuration...done.
IMPORTANT::
IMPORTANT:: The old configuration has been erased.
IMPORTANT:: As soon as you finish configuring the system please use the
IMPORTANT:: "write memory" command to save the new configuration to flash.
IMPORTANT::
Enter Hostname
(my-hostname, or enter to use se-10-50-30-125):
Using se-10-50-30-125 as default
Enter Domain Name
(mydomain.com, or enter to use localdomain): srsv.cue
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
DNS Configuration:
This allows the entry of hostnames, for example foo.cisco.com, instead
of IP addresses like 1.100.10.205 for application configuration. In order
to set up DNS you must know the IP address of at least one of your
DNS Servers.
Would you like to use DNS (y,n)?y
Enter IP Address of the Primary DNS Server
(IP address): 180.180.180.50
Found server 180.180.180.50
Enter IP Address of the Secondary DNS Server (other than Primary)
(IP address, or enter to bypass):
E
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 10.50.30.1): 10.50.10.1
Found server 10.50.10.1
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):
Please identify a location so that time zone rules can be set correctly.
Please select a continent or ocean.
1) Africa
4) Arctic Ocean
7) Australia
10) Pacific Ocean
2) Americas
5) Asia
8) Europe
3) Antarctica
6) Atlantic Ocean
9) Indian Ocean
#? 2
Please select a country.
1) Anguilla
27) Honduras
2) Antigua & Barbuda
28) Jamaica
3) Argentina
29) Martinique
4) Aruba
30) Mexico
5) Bahamas
31) Montserrat
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
21
Installing Cisco UMG Release 8.0
How to Download and Install the Software
6) Barbados
32) Netherlands Antilles
7) Belize
33) Nicaragua
8) Bolivia
34) Panama
9) Brazil
35) Paraguay
10) Canada
36) Peru
11) Cayman Islands
37) Puerto Rico
12) Chile
38) St Barthelemy
13) Colombia
39) St Kitts & Nevis
14) Costa Rica
40) St Lucia
15) Cuba
41) St Martin (French part)
16) Dominica
42) St Pierre & Miquelon
17) Dominican Republic
43) St Vincent
18) Ecuador
44) Suriname
19) El Salvador
45) Trinidad & Tobago
20) French Guiana
46) Turks & Caicos Is
21) Greenland
47) United States
22) Grenada
48) Uruguay
23) Guadeloupe
49) Venezuela
24) Guatemala
50) Virgin Islands (UK)
25) Guyana
51) Virgin Islands (US)
26) Haiti
#? 47
Please select one of the following time zone regions.
1) Eastern Time
2) Eastern Time - Michigan - most locations
3) Eastern Time - Kentucky - Louisville area
4) Eastern Time - Kentucky - Wayne County
5) Eastern Time - Indiana - most locations
6) Eastern Time - Indiana - Daviess, Dubois, Knox & Martin Counties
7) Eastern Time - Indiana - Pulaski County
8) Eastern Time - Indiana - Crawford County
9) Eastern Time - Indiana - Pike County
10) Eastern Time - Indiana - Switzerland County
11) Central Time
12) Central Time - Indiana - Perry County
13) Central Time - Indiana - Starke County
14) Central Time - Michigan - Dickinson, Gogebic, Iron & Menominee Counties
15) Central Time - North Dakota - Oliver County
16) Central Time - North Dakota - Morton County (except Mandan area)
17) Mountain Time
18) Mountain Time - south Idaho & east Oregon
19) Mountain Time - Navajo
20) Mountain Standard Time - Arizona
21) Pacific Time
22) Alaska Time
23) Alaska Time - Alaska panhandle
24) Alaska Time - Alaska panhandle neck
25) Alaska Time - west Alaska
26) Aleutian Islands
27) Hawaii
#? 21
The following information has been given:
United States
Pacific Time
Therefore TZ='America/Los_Angeles' will be used.
Is the above information OK?
1) Yes
2) No
#? 1
Local time is now:
Mon Apr
5 11:20:17 PDT 2010.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
22
OL-22339-02
Installing Cisco UMG Release 8.0
How to Download and Install the Software
Universal Time is now: Mon Apr 5 18:20:17 UTC 2010.
executing app post_install
executing app post_install done
Configuring the system. Please wait...
Changing owners and file permissions.
Tightening file permissions ...
Change owners and permissions complete.
Creating Postgres database .... done.
INIT: Switching to runlevel: 4
INIT: Sending processes the TERM signal
==> Starting CDP
STARTED: cli_server.sh
STARTED: ntp_startup.sh
STARTED: LDAP_startup.sh
STARTED: SQL_startup.sh
STARTED: dwnldr_startup.sh
STARTED: HTTP_startup.sh
STARTED: probe
STARTED: fndn_udins_wrapper
STARTED: superthread_startup.sh
STARTED: /bin/products/umg/umg_startup.sh
Waiting 49 ...
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
Administrator Account Creation
Create an administrator account.
With this account, you can log in to the
Cisco Unified Messaging Gateway
GUI and run the initialization wizard.
Enter administrator user ID:
(user ID): test
tesEnter password for test:
(password):
Confirm password for test by reentering it:
(password):
SYSTEM ONLINE
se-10-50-30-125# show software versions
Cisco Unified Messaging Gateway version (8.0.1)
Technical Support: http://www.cisco.com/techsupport Copyright (c) 1986-2010 by Cisco
Systems, Inc.
se-10-50-30-125# show sof
se-10-50-30-125# show software p
se-10-50-30-125# show software packages
Installed Packages:
- Installer (Installer application) (8.0.1.0)
- UMG (Cisco Unified Messaging Gateway) (8.0.1)
- Bootloader (Primary) (Service Engine Bootloader) (2.1.23)
- Infrastructure (Service Engine Infrastructure) (2.3.2.2)
- Global (Global manifest) (8.0.1)
- Bootloader (Secondary) (Service Engine Bootloader) (2.1.23.0)
- Core (Service Engine OS Core) (2.4.0.4)
- GPL Infrastructure (Service Engine GPL Infrastructure) (2.2.1.1)
SE-Module>
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
23
Installing Cisco UMG Release 8.0
How to Download and Install the Software
Uninstalling Cisco UMG Software on the Cisco SRE Service Module
Cisco Unified Messaging Gateway 8.0 is a Cisco-authorized application supported on the Cisco SRE
service modules SM-SRE-700-K9 and SM-SRE-900-K9. You can uninstall the Cisco UMG application
from the service module and replace it with a different Cisco-authorized application.
For more information, see the Cisco SRE Service Module Configuration and Installation Guide.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
24
OL-22339-02
Installing the Software Licenses
Last updated: May 25, 2010
Note
For a conceptual overview of the Cisco software activation process, see the Software Activation Guide
for Cisco Unity Express 7.1 and Later Versions.
•
About the Cisco UMG Release 8.0 SRSV Licenses, page 25
•
Installing the Cisco UMG Release 8.0 Licenses, page 25
About the Cisco UMG Release 8.0 SRSV Licenses
The Cisco Unified SRSV features are enabled through a set of licenses installed on both the Cisco UMG
and Cisco Unified SRSV-CUE components. Cisco UMG licenses are required for each site. Cisco
Unified SRSV-CUE licenses are required for voicemail subscribers and telephony ports. For information
about the Cisco UMG and Cisco Unified SRSV-CUE licenses, see the Release Notes for Cisco Unified
Messaging Gateway Release 8.0 and the Release Notes for Cisco Unified Survivable Remote Site
Voicemail-Cisco Unity Express (SRSV-CUE) Release 8.0. The Release Notes provide detailed
information on the licenses that may be used on the various supported devices.
Installing the Cisco UMG Release 8.0 Licenses
Beginning with Cisco UMG Release 8.0, a new type of license called Cisco Software License (CSL)
licensing is supported.
You have two choices for installing and activating the Cisco UMG software:
•
If you ordered a new network module with Cisco UMG Release 8.0 included, it is shipped with the
Cisco UMG image and the corresponding licenses preinstalled for the packages and features that
you specified. You do not need to activate or register the software prior to use. The network module
stores the software license file on the flash memory. You do not need to do anything.
•
Manually install the Cisco UMG licenses using the following process:
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
25
Installing the Software Licenses
Installing the Cisco UMG Release 8.0 Licenses
Procedure
Step 1
Determine what functionality you want and which licenses you need. For a detailed description of the
licenses, see the Release Notes for Cisco Unified Messaging Gateway Release 8.0 and/or the Release
Notes for Cisco Unified Survivable Remote Site Voicemail-Cisco Unity Express (SRSV-CUE)
Release 8.0.
Step 2
Obtain the license files. See the “Obtaining New or Additional Licenses” section on page 26.
Step 3
Install the license and reload the device. See the “Using the CLI to Install the Cisco UMG Release 8.0
Licenses” section on page 27.
Obtaining New or Additional Licenses
•
Required Information, page 26
•
Using the Licensing Portal to Obtain Licenses for Additional Features or Applications, page 26
Required Information
Gather the following information before you obtain new or additional CSL licenses:
•
The software SKU for the features that you need. The SKU is used in the ordering process to specify
the desired licenses for the Cisco UMG features that you want. See the Release Notes for Cisco
Unified Messaging Gateway Release 8.0 and if implementing the SRSV solution, the Release Notes
for Cisco Unified Survivable Remote Site Voicemail-Cisco Unity Express (SRSV-CUE) Release 8.0.
•
The Product ID (PID) and the Serial Number (SN) from the device. Together, these form the unique
device identifier (UDI). The UDI is printed on a label located on the back of most Cisco hardware
devices or on a label tray visible on the front panel of field-replaceable motherboards. The UDI can
also be viewed via software using the show license udi command in privileged EXEC mode on the
UMG module.
Using the Licensing Portal to Obtain Licenses for Additional Features or Applications
Note
You must have a Cisco.com password to access some of the URLs in the following procedure.
Follow these steps to obtain additional licenses for Cisco UMG Release 8.0 features.
Procedure
Step 1
Go to www.cisco.com/go/ordering and choose one of the ordering processes (via partner, Cisco direct,
etc.) to order licenses. When you purchase a license, you will receive a product activation key (PAK),
which is an alphanumeric string that represents the purchase.
Step 2
To get your license file, return to the Cisco Product License Registration Portal at
www.cisco.com/go/license. When prompted, enter the PAK and the unique device identifier (UDI) of the
device where the license will be installed.
Step 3
Download the license file or receive the license file by email.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
26
OL-22339-02
Installing the Software Licenses
Installing the Cisco UMG Release 8.0 Licenses
Step 4
Repeat the appropriate steps above for each device you want to obtain a license.
Step 5
Copy the license file(s) to a FTP or TFTP server.
Using the CLI to Install the Cisco UMG Release 8.0 Licenses
Follow these steps to install the licenses for Cisco UMG Release 8.0.
Procedure
Step 1
Log in to the CLI.
Step 2
To install the license, enter license install URL, where URL is the URL where you copied the license to
in Step 5 of Using the Licensing Portal to Obtain Licenses for Additional Features or Applications.
Step 3
Reload the module.
Step 4
Verify the license by entering the following:
show license status application srsv
show license status application vpim
Related Topics
Refer to the Command Reference for Cisco Unified Messaging Gateway Release 8.0 for information
about the CLI commands.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
27
Installing the Software Licenses
Installing the Cisco UMG Release 8.0 Licenses
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
28
OL-22339-02
Preparing Cisco UMG Release 8.0 to Support
VPIM Functionality
Last updated: May 25, 2010
If you want to configure your Cisco UMG system for VPIM functionality, add a DNS server to your
system by following one of these procedures:
Note
•
Adding a DNS Server: Systems with Cisco Unity, page 29
•
Adding a DNS Server: Systems without Cisco Unity, page 29
Before performing these procedures, install the Cisco UMG Release 8.0 software. See “Installing Cisco
UMG Release 8.0” on page 9.
Adding a DNS Server: Systems with Cisco Unity
If you are using Cisco UMG with Cisco Unity, you will need to have a DNS server for failover support.
The primary/secondary Cisco UMG is transparent to Cisco Unity; however, because this information is
configured only on the DNS server, Cisco Unity relies on Microsoft Exchange SMTP to determine to
which Cisco UMG it should send outgoing messages. Cisco Unity should be able to receive messages
from both primary and secondary Cisco UMGs if they share the same domain name. Map the
Cisco UMG domain name to two IP addresses (primary Cisco UMG and secondary Cisco UMG) in
DNS.
Cisco UMG uses a cache-only DNS server that listens on port 53 for both UDP and TCP packets. The
DNS-server cache policy is to automatically revalidate a cached entry when its Time To Live (TTL)
expires, and to discard an entry only when the parent DNS server is accessible and no longer contains
the name. Most DNS caches simply discard an entry when the TTL expires.
Adding a DNS Server: Systems without Cisco Unity
If you are not using Cisco Unity, we recommend that you do not use DNS servers. This improves
message exchanging performance, allowing Cisco UMG and endpoints to use IP addresses to address
each other instead of by using DNS hostnames. This can be achieved by provisioning peers with IP
addresses, or by having each entity cache the resolved IP addresses from the DNS name.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
29
Preparing Cisco UMG Release 8.0 to Support VPIM Functionality
Adding a DNS Server: Systems without Cisco Unity
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
30
OL-22339-02
Preparing Cisco UMG Release 8.0 to Support
SRSV Functionality
Last updated: May 25, 2010
If you want to configure your Cisco UMG system for SRSV functionality, follow these procedures:
Note
•
Prerequisites, page 31
•
About Security for Cisco Unified SRSV-UMG, page 32
Before performing these procedures, install the Cisco UMG Release 8.0 software. See “Installing Cisco
UMG Release 8.0” on page 9.
Prerequisites
Complete the following tasks before you configure your Cisco UMG for SRSV.
Table 2
Prerequisites for Configuring the SRSV Functionality for Cisco UMG Release 8.0
Task
For more information, see
Install Cisco Unified Communications Manager,
including security certificates.
http://www.cisco.com/en/US/products/sw/voicesw
/ps556/prod_installation_guides_list.html
Install Cisco Unity Connection, including
security certificates.
http://www.cisco.com/en/US/products/ps6509/pro
d_installation_guides_list.html
Enable SMTP support on the
Cisco Unity Connection.
How to Enable SMTP Support for Cisco UMG on
Cisco Unity Connection, page 32
Install a Cisco Unified SRST system (either
Cisco Unified Communications Manager Express
as SRST or original SRST), including security
certificates.
•
http://www.cisco.com/en/US/docs/voice_ip_co
mm/cucme/admin/configuration/guide/cmesrs
t.html
•
http://www.cisco.com/en/US/docs/voice_ip_co
mm/cusrst/admin/srst/configuration/guide/srst
sa.html
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
31
Preparing Cisco UMG Release 8.0 to Support SRSV Functionality
About Security for Cisco Unified SRSV-UMG
How to Enable SMTP Support for Cisco UMG on Cisco Unity Connection
You must configure the Cisco Unity Connection system to allow Cisco Unified SRSV-UMG to upload
messages to it. There are two basic configurations to allow Cisco Unified SRSV-UMG to work with
Cisco Unity Connection:
•
Add Cisco Unified SRSV-UMG addresses to the SMTP access list.
•
Allow untrusted connections to Cisco Unity Connection SMTP.
The quickest setup is to allow untrusted SMTP connections on Cisco Unity Connection but this
configuration is also the most unsecure. Adding devices to the trusted list requires manually entering
Cisco Unified SRSV-UMG addresses into all Cisco Unity Connections systems by using the System
Settings > SMTP Configuration > Server page of the Cisco Unity Connection administration
application.
For more information about Cisco Unity Connection SMTP configuration, see the following:
•
Interface Reference Guide for Cisco Unity Connection Administration: System Settings: SMTP
Server
•
Interface Reference Guide for Cisco Unity Connection Administration: System Settings: Search IP
Address Access List
About Security for Cisco Unified SRSV-UMG
•
About Security, page 32
•
About Security Certificates, page 32
•
Retrieving Security Certificates from Cisco Unity Connection and Cisco Unified Communications
Manager, page 33
•
Installing the Security Certificates, page 33
About Security
Security certificates play an essential role in the protection of voicemail messages as they are transferred
from the branch site to the central office across the WAN network. Security certificates are required to
provide a secure connection between systems. Security is needed for the following:
•
Between Cisco Unity Connection and Cisco Unified Communications Manager.
•
Between Cisco Unified Communications Manager and the Cisco UMG.
•
Between the Cisco Unified SRSV-CUE and Cisco Unified SRSV-UMG components of the
Cisco UMG.
About Security Certificates
Use one of these methods to generate and sign security certificates:
•
Trust chains. Trust chains use Certificate Authorities (CAs) to simplify large deployments. You
install security certificates for the Cisco Unified Communications Manager,
Cisco Unity Connection, and Cisco UMG that were all signed by a CA and the connections are all
part of a trusted chain.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
32
OL-22339-02
Preparing Cisco UMG Release 8.0 to Support SRSV Functionality
About Security for Cisco Unified SRSV-UMG
•
Self-signed certificates. You use self-signed certificates for each device. In this case, the Cisco UMG
needs the security certificate from each device to which it connects.
There are two kinds of security certificates: DER (distinguished encoding rules) and PEM
(privacy-enhanced mode).
Retrieving Security Certificates from Cisco Unity Connection and Cisco Unified
Communications Manager
Use this method to retrieve the certificates from the Cisco Unity Connection and Cisco Unified
Communications Manager systems. You will later add these certificates to the Cisco UMG system.
Note
Described below is one method, using the Firefox browser, that you can follow to retrieve certificates in
the PEM format. There may be other methods to retrieve security certificates.
Procedure
Step 1
Using Firefox, open a web browser.
Step 2
Navigate to the Cisco Unity Connection home page. It is not necessary to log in.
Step 3
Select Edit > Preferences.
Step 4
Click Advanced.
Step 5
Click the Encryption tab.
Step 6
Click View Certificates.
Step 7
Click the Servers tab.
Step 8
Locate the servers from Cisco and click the arrow to expand the list of servers. Find the system name of
the Cisco Unity Connection system.
Step 9
Highlight the row with the Cisco Unity Connection system.
Step 10
Click Export....
Step 11
Save the certificate file to a convenient location.
Step 12
Use Notepad to open the certificate file.
Step 13
Ensure that it has text that include lines with ---- BEGIN CERTIFICATE ----- and ---- END
CERTIFICATE -----.
Step 14
Repeat this procedure on the Cisco Unified Communications Manager system.
Installing the Security Certificates
Cisco Unified SRSV-UMG needs both the Cisco Unity Connection and Cisco Unified Communications
Manager public certificates installed to enable it to communicate securely with Cisco Unity Connection
and Cisco Unified Communications Manager over the REST and AXL interfaces respectively.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
33
Preparing Cisco UMG Release 8.0 to Support SRSV Functionality
About Security for Cisco Unified SRSV-UMG
Before You Begin
Download the security certificates from Cisco Unity Connection and Cisco Unified Communications
Manager. See the “Retrieving Security Certificates from Cisco Unity Connection and Cisco Unified
Communications Manager” section on page 33.
Note
The following procedure installs security certificates in the PEM format. Your experience may be
slightly different if you are using security certificates in the DER format.
Procedure
Step 1
Enter the following CLI command:
crypto key import trustcacert label LABEL terminal
where LABEL is the name of the security certificate.
The system displays the following:
Enter certificate...
End with a blank line or "quit" on a line by itself
Step 2
Paste the contents of the security certificate, starting with the line -------- BEGIN CERTIFICATE------and ending with the line ------------- END CERTIFICATE --------.
The system displays the following:
Certificate info
*******************************************
Owner: C=US, ST=MA, L=BXB, O=Cisco, OU=None, CN=CCM-7
Issuer: C=US, ST=MA, L=BXB, O=Cisco, OU=None, CN=CCM-7
Valid from: Thu Dec 18 14:34:23 EST 2008 until: Wed Dec 18 14:34:23 EST 2013
Certificate fingerprint (MD5): AD:B2:7F:7A:BB:91:08:0B:5A:59:51:45:BE:F1:CA:42
Do you want to continue to import this certificate, additional validation will be
perfomed? [y/n]:
Step 3
Enter y to import the certificate.
Step 4
Repeat steps 1 to 3 for the security certificate for Cisco Unified Communications Manager.
Step 5
At the prompt, enter the following to exit config mode:
exit
Step 6
At the prompt, enter the following to reload the system:
reload
The system asks you if you really want to reload.
Step 7
Enter y to confirm that you really want to reload the system.
Related Topics
Refer to the Command Reference for Cisco Unified Messaging Gateway Release 8.0 for information
about the CLI commands.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
34
OL-22339-02
Upgrading Cisco UMG from Release 8.0 to a Later
Release
Last Updated: September 3, 2010
Note
This chapter describes how to upgrade the Cisco UMG from Release 8.0.x to a later 8.0.x release, for
example from release 8.0.1 to 8.0.2. It does not describe how to upgrade from Cisco UMG Release 1.0
to Cisco UMG Release 8.0. That upgrade path is not supported. If you are currently on Release 1.0 and
want to move to Release 8.0, follow the instructions for a new installation.
Upgrade Cisco UMG with the software install upgrade command. This procedure does not erase any
existing configuration or data. You do not need to back up your current configuration and data files
because the disk is not cleaned.
This chapter contains the following sections:
•
Task List for Using the Software Install Upgrade Command, page 35
•
Prerequisites for Using the Software Install Upgrade Command, page 36
•
Downloading and Installing an Upgrade Image, page 36
Task List for Using the Software Install Upgrade Command
Table 3
Task List for Upgrading Cisco UMG Using the Software Install Upgrade Command
Task
For more information, see
Perform the prerequisites.
Prerequisites for Using the Software Install
Upgrade Command, page 36
(Recommended) Back up your data and
configuration files.
CLI Administration Guide for Cisco Unified
Messaging Gateway Release 8.0
Download and install the software image files.
Downloading and Installing an Upgrade Image,
page 36
Restore the data and configuration files, if required. CLI Administration Guide for Cisco Unified
Messaging Gateway Release 8.0.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
35
Upgrading Cisco UMG from Release 8.0 to a Later Release
Prerequisites for Using the Software Install Upgrade Command
Prerequisites for Using the Software Install Upgrade Command
•
Gather the following information:
– FTP server hostname or IP address. If the Cisco UMG is configured to use DNS, use the
hostname. If the Cisco UMG is not configured to use DNS, use the IP address.
– FTP server username
– FTP server password
– Software package name
•
Ensure that the FTP server is configured and active.
•
Ensure that you can ping the Cisco UMG module from the FTP server.
Downloading and Installing an Upgrade Image
Procedure
Step 1
Log in to Cisco.com and go to the Cisco UMG product page at
http://www.cisco.com/en/US/products/ps8605/index.html.
Step 2
Download the following:
•
Installer payload
•
For the NME-UMG and NME-UMG-EC:
umg-k9.nmx.<x.y.z>.pkg,
where x.y.z is the placeholder for the version to which you are upgrading.
•
Upgrade payload, containing all the data and executable files associated with a Cisco UMG upgrade.
For the exact filenames, see the Release Notes for Cisco Unified Messaging Gateway 8.0.
Step 3
Copy the files to the FTP server.
Step 4
To install the software, use the following commands:
For the NME-UMG or NME-UMG-EC, enter:
software install upgrade url ftp://<ftp_server_ip_address>/umg-k9.nmx.<x.y.z>.pkg
or
software install upgrade url ftp://<ftp_server_ip_address>/umg-k9.nmx.<x.y.z>.pkg username
<user_name> password <password>
Step 5
When prompted, enter y to begin the upgrade:
WARNING:: This command will install the necessary software to
WARNING:: complete an upgrade. It is recommended that a backup be done
WARNING:: before installing software.
Would you like to continue? [n] y
The system reloads after the upgrade is complete.
Step 6
Use the show software version command to verify the upgrade.
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
36
OL-22339-02
Upgrading Cisco UMG from Release 8.0 to a Later Release
Downloading and Installing an Upgrade Image
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
37
Upgrading Cisco UMG from Release 8.0 to a Later Release
Downloading and Installing an Upgrade Image
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
38
OL-22339-02
INDEX
A
F
Avaya Interchange version 5.4
Fast Ethernet ports
12
C
G
Cisco IOS command
graceful shutdown
interface Service-Engine
Cisco Unity Express
Cisco Unity version 4.2 and up
H
12
18
hard disk
command
replacing restrictions
enable
exit
18
113
111
integrated-Service-Engine
interface Service-Engine
ip route
I
113
111
interface Service-Engine Cisco IOS command
111
interface Service-Engine command
ip unnumbered
ping
17
110
12
CiscoWorks configmaker
18
111
ip address Cisco IOS command
111
ip route command
service-module integrated-Service-Engine
service-module ip address
111
ip unnumbered command
111
111
117, 136
network module
command (Cisco IOS)
ip address command
111
N
113
show software versions
111
111
service-module ip default-gateway
service-module sm
113
110
restrictions
18
open standards
11
111
O
E
enable command
exit command
113
111
P
ping command
111
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
OL-22339-02
39
Index
ports
Fast Ethernet
restrictions
18
18
power supply, uninterruptible
17
R
restrictions
CiscoWorks configmaker
replacing hard disk
18
18
S
service-module integrated-Service-Engine command
service-module ip address command
111
service-module ip default-gateway command
service-module sm command
standards, open
111
113
show software versions command
shutdown, graceful
113
117, 136
17
11
U
uninterruptible power supply
UPS
17
17
Installation and Upgrade Guide for Cisco Unified Messaging Gateway Release 8.0
40
OL-22339-02