Cisco Unity Express 3.2 Installation and Upgrade Guide - Upgrading Cisco Unity Express [Cisco Unity Express]

Table Of Contents

Upgrading Cisco Unity Express

Prerequisites

Upgrading to Cisco Unity Express 3.2 Using Clean Install

Task List

Downloading and Installing a New Software Image

Upgrading Cisco Unity Express Using Software Install Upgrade

Task List

Downloading and Installing an Upgrade Image

What to Do Next

Upgrading Cisco Unity Express

Last Updated: September 24, 2009

This chapter describes procedures for upgrading to Cisco Unity Express 3.2 software.

Use one of two upgrade procedures depending on

•whether or not you want to back up your configuration before the procedure and restore it afterward:

•what your platform is.

Upgrading to Cisco Unity Express 3.2 Using Clean Install

This is a clean installation that `cleans' the disk by erasing any existing configuration and voice-mail data, repartitioning the disk, and loading all new files on the disk. You must back up your configuration and data files before starting the clean installation, and then restore the configuration and data files after the installation.

Upgrading Cisco Unity Express Using Software Install Upgrade

Use this procedure to upgrade to version 3.2:

–From version 2.3.1 and its maintenance versions 2.3.2, 2.3.3, 2.3.4

–From version 3.0.1 and its maintenance versions 3.0.2, 3.0.3, 3.0.4

–From versions 3.1.1 and 3.1.2

Use the matrices in the Release Notes for Cisco Unity Express 3.2, Cisco Unity Express Software 3.2 and 3.1 Upgrade Process Matrix (NME-CUE, NM-CUE-EC, NM-CUE, and AIM-CUE) or Cisco Unity Express Software Upgrade Process Matrix (Cisco 1861), to determine whether your platform will support this type of upgrade.

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. Your current installation is upgraded.

This section includes:

•Prerequisites

•Upgrading to Cisco Unity Express 3.2 Using Clean Install

•Upgrading Cisco Unity Express Using Software Install Upgrade

•What to Do Next

Caution Cisco Unity Express 3.2 does not support versions of Cisco Unified Communications Manager earlier than 4.2. It also does not support Cisco Unified Communications Manager 5.0. If you are using a version of Cisco Unified Communications Manager earlier than 4.2, you must upgrade to 4.2 or a higher version to interoperate with Cisco Unity Express 3.2.

Note These procedures are available to systems with a network module (NM-CUE, NM-CUE-EC, or NME-CUE) or 1 GB advanced integration module (AIM-CUE). Cisco Unity Express 3.2 does not support the 512 MB AIM-CUE.

Prerequisites

•The following information is required:

–FTP server IP address

–FTP server username

–FTP server password

–Software package name

•If you are installing a language, see the Cisco Unity Express Compatibility Matrix for a list of available languages.

•Ensure that the FTP server is configured and active.

•Ensure that you can ping the Cisco Unity Express network module from the FTP server.

•If Cisco Unity Express is configured to use DNS, use hostnames to identify the FTP server. If Cisco Unity Express is not configured to use DNS, use the IP address of the FTP server.

Upgrading to Cisco Unity Express 3.2 Using Clean Install

This section describes the "clean" procedure for upgrading to Cisco Unity Express 3.2. Because this procedure erases any existing configuration and voice-mail data, you must first backup your data, and then restore it following the software installation.

Note If you are upgrading from Cisco Unity Express 2.3.x, 3.0.x, or 3.1.x, you have the option of upgrading without backing up the system data and then restoring it after the software installation. For more information, see the "Upgrading Cisco Unity Express Using Software Install Upgrade" section.

Task List

Upgrading to Cisco Unity Express 3.2. entails the following sequence of tasks:

Table 4 Task List for Upgrading to Cisco Unity Express 3.2 Using Clean Install Method

Checklist

Checkoff

1. Back up your data and configuration files. See "Appendix A: Backing Up Files" on page 57.

2. Download and install the software image files. See "Downloading and Installing a New Software Image".

3. Restore the data and configuration files. See "Appendix B: Restoring Files" on page 59.

4. Reboot the system.

Downloading and Installing a New Software Image

Use this procedure to install a new Cisco Unity Express software image.

Caution If you have not already done so, back up your data and configuration files before starting the installation. See "Appendix A: Backing Up Files" on page 57. The disk is wiped clean before the new image is installed.

SUMMARY STEPS

1. Log in and go to the Cisco Unity Express page on the Cisco Software Center website at http://www.cisco.com/public/sw-center/sw-voice.shtml.

2. Download the Cisco Unity Express software files, one zip file and one language package file for each language.

3. Extract the five core files from the zip file.

4. Copy the extracted files and the language package file(s) to the FTP server.

5. (Optional) Enter the software download clean command to download the new software from the FTP server.

Note Although the software download clean command is optional, it is useful for staging the installation. The command stores the software files on the hard disk, which can save time during any subsequent installation or upgrade.

6. (Required for Step 4.) Enter y to continue the installation.

7. Select the language version from the language selection menu.

8. Enter x when you finish with the language selection menu.

9. Enter the software download status command to check that the software has downloaded.

10. Enter the software install clean command to install the new software.

The system automatically reloads after the installation is complete.

11. Enter y to begin the initial configuration.

12. Enter y to restore the configuration saved in flash memory or n to use your backup to restore your configuration.

13. Enter the Cisco Unity Express administrator ID. This is the username to log in to the Cisco Unity Express GUI.

DETAILED STEPS

Step 1 Log in and go to the Cisco Unity Express page on the Cisco Software Center website at http://www.cisco.com/public/sw-center/sw-voice.shtml.

Step 2 Download the appropriate Cisco Unity Express software files.

•cue-vm-k9.plat.ver.zip (application package file)

•cue-vm-lang-langpack.plat.ver.pkg (language package file)

The key to the placeholders in the above-mentioned filenames is in Table 3 on page 21.

Step 3 From the zip file, extract the core files:

For NM-CUE, NM-CUE-EC, and AIM-CUE (cue-vm-k9.nm-aim.3.2.x.tar)

•cue-installer.nm-aim.3.2.x

•cue-vm-k9.nm-aim.3.2.x.pkg

•cue-vm-full-k9.nm-aim.3.2.x.prt1

•cue-vm-installer-k9.nm-aim.3.2.x.prt1

•cue-vm-langpack.nm-aim.3.2.x.pkg

For NME-CUE (cue-vm-k9.nme.3.2.x.tar)

•cue-installer.nme.3.2.x

•cue-vm-k9.nme.3.2.x.pkg

•cue-vm-full-k9.nme.3.2.x.prt1

•cue-vm-installer-k9.nme.3.2.x.prt1

•cue-vm-langpack.nme.3.2.x.pkg

Step 4 Copy the core files and the language package file to the FTP server.

Step 5 (Optional) Enter the software download clean command to download the new software from the FTP server:
se-172-16-0-0# software download clean url 
ftp://ftp_server_ip_address/cue-vm-k9.plat.ver.pkg username username password password
or, if the FTP server has been configured:
se-172-16-0-0# software download clean cue-vm-k9.plat.ver.pkg
Note If the FTP server was set in configuration mode, you do not need to use the FTP parameters. To set the FTP server, see the software download server command in the Cisco Unity Express 3.2 Command Reference.

Step 6 (Required for Step 4.) Enter y to continue the download:
WARNING:: This command will download 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? [n] y
Step 7 Select the language version from the language selection menu:

Note Select the language that was previously configured as the system default on the system running the earlier version. To change the language support as part of the upgrade, additional preparation is required. For example, users, audio prompts, triggers and some custom scripts might be defined with a language other than the system default. If these are not updated correctly, then audio prompts for users defined with other languages might not work. For more information, see "Appendix C: Language Upgrade Preparation" section on page 61.
#  Selected   SKU     Language Name (version)
----------------------------------------------------------------------
1 PTB CUE Voicemail Brazilian Portuguese (3.2.1.0) 
2 RUS CUE Voicemail Russian (3.2.1.0) 
3 DEU CUE Voicemail German (3.2.1.0) 
4 NLD CUE Voicemail Dutch (3.2.1.0) 
5 FRC CUE Voicemail Canadian French (3.2.1.0) 
6 KOR CUE Voicemail Korean (3.2.1.0) 
7 CHS CUE Voicemail Mandarin Chinese (3.2.1.0) 
8 ESO CUE Voicemail Latin American Spanish (3.2.1.0) 
9 ITA CUE Voicemail Italian (3.2.1.0) 
10 ESM CUE Voicemail Mexican Spanish (3.2.1.0) 
11 ESP CUE Voicemail European Spanish (3.2.1.0) 
12 TUR CUE Voicemail Turkish (3.2.1.0) 
13 ENG CUE Voicemail UK English (3.2.1.0) 
14 ARA CUE Voicemail Arabic (3.2.1.0) 
15 SVE CUE Voicemail Swedish (3.2.1.0) 
16 FRA CUE Voicemail European French (3.2.1.0) 
17 DAN CUE Voicemail Danish (3.2.1.0) 
18 JPN CUE Voicemail Japanese (3.2.1.0) 
----------------------------------------------------------------------
Available commands are:
# - enter the number for the language to select one
r # - remove the language for given #
i # - more information about the language for given #
x - Done with language selection
>12
Step 8 Your choice appears as an "*" in the language selection menu. Use the menu to add, remove, or get information about languages. Enter x when finished. The example below shows that Italian and Danish are selected.
#  Selected   SKU     Language Name (version)
----------------------------------------------------------------------
1 PTB CUE Voicemail Brazilian Portuguese (3.2.1.0) 
2 RUS CUE Voicemail Russian (3.2.1.0) 
3 DEU CUE Voicemail German (3.2.1.0) 
4 NLD CUE Voicemail Dutch (3.2.1.0) 
5 FRC CUE Voicemail Canadian French (3.2.1.0) 
6 KOR CUE Voicemail Korean (3.2.1.0) 
7 CHS CUE Voicemail Mandarin Chinese (3.2.1.0) 
8 ESO CUE Voicemail Latin American Spanish (3.2.1.0) 
9 * ITA CUE Voicemail Italian (3.2.1.0) 
10 ESM CUE Voicemail Mexican Spanish (3.2.1.0) 
11 ESP CUE Voicemail European Spanish (3.2.1.0) 
12 TUR CUE Voicemail Turkish (3.2.1.0) 
13 ENG CUE Voicemail UK English (3.2.1.0) 
14 ARA CUE Voicemail Arabic (3.2.1.0) 
15 SVE CUE Voicemail Swedish (3.2.1.0) 
16 FRA CUE Voicemail European French (3.2.1.0) 
17 * DAN CUE Voicemail Danish (3.2.1.0) 
18 JPN CUE Voicemail Japanese (3.2.1.0) 
----------------------------------------------------------------------
Available commands are:
# - enter the number for the language to select one
r # - remove the language for given #
i # - more information about the language for given #
x - Done with language selection
>x
At this point the new software is downloaded from the FTP server.

Note When you download the software, there are no other prompts for user input. The software package is downloaded from the FTP server to the Cisco Unity Express module.

Step 9 Enter the software download status command to check the download status:
se-172-16-0-0# software download status 
Download request in progress.
downloading file : cue-vm-k9.plat.ver.pkg
bytes downloaded : 18612224
se-172-16-0-0# 
se-172-16-0-0# software download status
Download request completed successfully.
se-172-16-0-0# 
Note You can enter the show software directory download command to show the downloaded files.

Step 10 After the software is downloaded, enter the software install clean command to install the new software:

Caution This step cleans the disk. All configuration and voice messages are lost after this step. Verify that a backup was done. If it has not, abort at this step and do a backup first. See "Appendix A: Backing Up Files" section on page 57.
se-172-16-0-0# software install clean cue-vm-k9.nme.3.2.1.pkg
Note If the package is not found in the download section, it is downloaded from the configured FTP server.

Note To set the FTP server, see the software download server command in the Cisco Unity Express 3.2 Command Reference.

At this point, the new software is installed on the system and the system restarts.

Step 11 Enter y to begin the initial configuration:
IMPORTANT::
IMPORTANT::    Welcome to Cisco Systems Service Engine
IMPORTANT::     post installation configuration tool.
IMPORTANT::
IMPORTANT:: This is a one time process which will guide
IMPORTANT:: you through initial setup of your Service Engine.
IMPORTANT:: Once run, this process will have configured
IMPORTANT:: the system for your location.
IMPORTANT::
IMPORTANT:: If you do not wish to continue, the system will be halted
IMPORTANT:: so it can be safely removed from the router.
IMPORTANT::
Do you wish to start configuration now (y,n)? y
Step 12 Enter the appropriate response y or n. See the output below to determine your configuration needs.

Note If this is a new install or the flash has been erased, this output is not displayed.
IMPORTANT::
IMPORTANT:: A Cisco Unity Express configuration has been found in flash.
IMPORTANT:: You can choose to restore this configuration into the
IMPORTANT:: current image.
IMPORTANT::
IMPORTANT:: A stored configuration contains some of the data from a
IMPORTANT:: previous installation, but not as much as a backup. For
IMPORTANT:: example: voice messages, user passwords, user PINs, and
IMPORTANT:: auto attendant scripts are included in a backup, but are
IMPORTANT:: not saved with the configuration.
IMPORTANT::
IMPORTANT:: If you are recovering from a disaster and do not have a
IMPORTANT:: backup, you can restore the saved configuration.
IMPORTANT::
IMPORTANT:: If you are going to restore a backup from a previous
IMPORTANT:: installation, you should not restore the saved configuration.
IMPORTANT::
IMPORTANT:: If you choose not to restore the saved configuration, it
IMPORTANT:: will be erased from flash.
IMPORTANT::
Would you like to restore the saved configuration? (y,n)
Caution If you answer n, the configuration is deleted and you are asked to configure the hostname, DNS location, NTP server, and timezone.

Step 13 Enter the Cisco Unity Express administrator ID. This is the username to log in to the Cisco Unity Express GUI.
IMPORTANT::
IMPORTANT::        Administrator Account Creation
IMPORTANT::
IMPORTANT:: Create an administrator account. With this account,
IMPORTANT:: you can log in to the Cisco Unity Express GUI and
IMPORTANT:: run the initialization wizard.
IMPORTANT::
Enter administrator user ID:
  (user ID): Admin
Enter password for admin:
  (password): ******
Confirm password for admin by reentering it:
  (password): ******
SYSTEM ONLINE
se-172-16-0-0>
Upgrading Cisco Unity Express Using Software Install Upgrade

This section describes the procedure to upgrade files by simply adding them to your existing Cisco Unity Express installation. Using this procedure, you upgrade your software version without having to backup your system data before the software installation and restore it afterward. Whether you can use this type of upgrade depends on the version you are upgrading from. To see which version combinations this method supports, see the Release Notes for Cisco Unity Express 3.2.

Task List

Upgrading Cisco Unity Express using this method entails the following tasks for downloading and installing an upgrade image.

Table 5 Task List for Upgrading Cisco Unity Express Using Software Install Upgrade Method

Checklist

Checkoff

1. (Recommended) Backing up your data and configuration files. See "Appendix A: Backing Up Files" section on page 57.

2. Downloading and installing the software image files. See "Downloading and Installing an Upgrade Image".

3. Restoring the data and configuration files, if required. See "Appendix B: Restoring Files" on page 59.

4. Rebooting the system.

Use this procedure to download and install an upgrade image.

Note We recommend that you back up your data and configuration files before starting the upgrade. See "Appendix A: Backing Up Files" on page 57.

Note To change your language selections, see the "Adding or Removing Languages" section on page 20.

Downloading and Installing an Upgrade Image

SUMMARY STEPS

1. Go to the Cisco Unity Express page on the Cisco Software Center website at http://www.cisco.com/public/sw-center/sw-voice.shtml.

2. Download the appropriate Cisco Unity Express software files.

3. Extract the core files from the zip file.

4. Copy the files to the FTP server.

5. (Optional) Enter the software download upgrade command to download the new software.

Note Although the software download upgrade command is optional, it is useful for staging the installation. The command stores the software files on the hard disk, which can save time during any subsequent installation or upgrade.

6. (Required for Step 4.) Enter y to continue the download.

7. (Optional) Enter the software download status command to verify the download.

8. Enter the software install upgrade command to install the new software.

9. Enter y to install the upgrade or n to stop the installation procedure.

The system automatically reloads after the upgrade is complete.

10. Enter the show software versions command to verify the upgrade.

DETAILED STEPS

Step 1 Go to the Cisco Unity Express page on the Cisco Software Center website at http://www.cisco.com/public/sw-center/sw-voice.shtml.

Step 2 Download the appropriate Cisco Unity Express software files.

•cue-vm-k9.plat.ver.zip (application package file)

•cue-vm-lang-langpack.plat.ver.pkg (language package file)

The key to the placeholders in the above-mentioned filenames is in Table 3 on page 21.

Step 3 From the zip file, extract the core files:

For NM-CUE, NM-CUE-EC, and AIM-CUE (cue-vm-k9.nm-aim.3.2.x.tar)

•cue-installer.nm-aim.3.2.x

•cue-vm-k9.nm-aim.3.2.x.pkg

•cue-vm-full-k9.nm-aim.3.2.x.prt1

•cue-vm-installer-k9.nm-aim.3.2.x.prt1

•cue-vm-langpack.nm-aim.3.2.x.pkg

For NME-CUE (cue-vm-k9.nme.3.2.x.tar)

•cue-installer.nme.3.2.x

•cue-vm-k9.nme.3.2.x.pkg

•cue-vm-full-k9.nme.3.2.x.prt1

•cue-vm-installer-k9.nme.3.2.x.prt1

•cue-vm-langpack.nme.3.2.x.pkg

Step 4 Copy the core files and the language package file to the FTP server.

Note To install the files without first downloading, use the command software install clean url ftp://ftp-server-ip-address/cue-vm-k9.nme.3.2.1.pkg username username password password.

Step 5 (Optional) Enter the software download upgrade command to download the software from the FTP server:
se-172-16-0-0# software download upgrade url 
ftp://ftp-server-ip-address/cue-vm-k9.plat.ver.pkg
Note This example uses the default anonymous FTP user.

or, if the FTP server is configured:
se-172-16-0-0# software download upgrade cue-vm-k9.plat.ver.pkg
Note If the FTP server was set in configuration mode, you do not need to use the FTP parameters.

Step 6 (Required for Step 4.) Enter y to begin the download:
WARNING:: This command will download 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
Downloading  software install upgrade cue-vm-k9.nme.3.2.1.pkg
Bytes downloaded :  63648 
Validating package signature ... done
Validating installed manifests ..........complete.
Note When you download the upgrade software, there are no other prompts for user input. The software package is downloaded from the FTP server to the Cisco Unity Express network module.

Step 7 Enter the software download status command to check the download status:
se-172-16-0-0# software download status 
Download request in progress.
downloading file : cue-vm-k9.nme.3.2.1.pkg bytes downloaded : 18612224
se-172-16-0-0# 
se-172-16-0-0# software download status
Download request completed successfully.
se-172-16-0-0# 
Note Enter the show software directory download command to show the downloaded files.

Step 8 When the download is complete, enter the software install upgrade command to install the new software:

Note This example uses the default anonymous FTP user.
se-172-16-0-0# software install upgrade cue-vm-k9.nme.3.2.1.pkg
In this example, the command upgrades the software using the package just downloaded. If the package is not found in the downloaded directory, it is downloaded from the configured FTP server.

Note To install the package without first downloading, use the command software install upgrade url ftp://ftp_server_ip_address/software install upgrade cue-vm-k9.plat.ver.pkg.

Step 9 Enter y to begin the upgrade:

Caution An upgrade does not replace everything on the disk, just the files necessary to make the upgrade. We recommend that you do a backup before any software installation.

Note When upgrading the Cisco Unity Express software, you are not prompted for a language. The language will stay as configured.
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 10 Use the show software version command to verify the upgrade.
se-172-16-0-0# show software version
Cisco Unity Express version (3.2.1)
Components:
 - CUE Voicemail Language Support version  3.2.1.0
se-172-16-0-0# 
To see all the details, use the show software version detail command.
se-172-16-0-0# sh soft ver detail 
Cisco Unity Express version (3.2.1)
Applications:
 Name: Installer (3.2.1)
 Desc: Installer application
   id: a0fb9f0a-fa5c-4b21-a64c-0cb9d6379573
 Type: (installer)
 Name: Thirdparty (3.2.1.0)
 Desc: Service Engine Thirdparty Code
   id: a3442277-7890-4782-9e6b-9d19efc1e0d8
 Type: (application)
 Name: Bootloader (Primary) (2.1.14)
 Desc: Service Engine Bootloader
   id: 13b08c00-19f7-4b81-97c7-f1d7fb7a8fd5
 Type: (bootloader)
 Name: Infrastructure (3.2.1.0)
 Desc: Service Engine Infrastructure
   id: a36e1be1-ce8a-4f53-ace7-1844262aa0b9
 Type: (application)
 Name: Global (3.2.1)
 Desc: Global manifest
   id: edceaf0b-a890-4045-9086-5452fac85eba
 Type: (application)
 Name: Service Engine license (2.1.2.0)
 Desc: License for the Service Engine
   id: d1ba3d34-06c2-4461-8600-a0c244ef8457
 Type: (license)
 Name: Auto Attendant (3.2.1.0)
 Desc: Service Engine Telephony Infrastructure
   id: e3db91b0-f47d-460c-ad22-65001a5d45a9
 Type: (application)
 Name: Voice Mail (3.2.1.0)
 Desc: Voicemail application
   id: 8e7823e2-0e92-4470-8860-653246345f9d
 Type: (application)
 Name: Bootloader (Secondary) (2.1.15.14)
 Desc: Service Engine Bootloader
   id: 9d7b26fb-21b2-416e-8b65-425c2f8da5d8
 Type: (bootloader)
 Name: Core (3.2.1.0)
 Desc: Service Engine OS Core
   id: 430f25f9-0fed-48a4-b362-823937138501
 Type: (application)
 Name: GPL Infrastructure (3.2.1.0)
 Desc: Service Engine GPL Infrastructure
   id: 9f112eb1-6f58-4dd4-8faa-8530467af3b9
 Type: (application)
Components:
 Name: CUE Voicemail Language Support (3.2.1.0)
 Desc: Languages global pack
   id: e2e81cc6-39b5-47e1-9f83-b83c897fc50c
 Type: (plug-in)
 Name: CUE Voicemail US English (3.2.1.0)
 Desc: English language pack
   id: 27e5e2ab-1622-4c02-8a0a-cfad0d932148
 Type: (plug-in)
 Name: CUE Voicemail UK English (3.2.1.0)
 Desc: British English language pack
   id: fa803d25-9c89-4171-a14c-ec12d6ed6b8c
 Type: (plug-in)
se-172-16-0-0# 
What to Do Next

1. If required, restore the data and configuration files. See "Appendix B: Restoring Files" on page 59. This step is not required if you used the upgrade process in "Upgrading Cisco Unity Express Using Software Install Upgrade".

Note If you do not have any backup files for your system and cannot do a restore of the data, run the initialization wizard. See the "Configuring the Cisco Unity Express Software Using the Initialization Wizard" section in the Cisco Unity Express 3.2 GUI Administrator Guide.

Note To use CLI commands to perform the configuration tasks covered by the initialization wizard (for example, if you want to use a configuration script), skip the initialization wizard by using the web skipinitwizard command in Cisco Unity Express EXEC mode.
This command turns off the initialization wizard. You cannot restart it unless you reimage the Cisco Unity Express module.

2. Install the license files, making sure they are the same version as the software package. See the "Upgrading or Downgrading the Cisco Unity Express License in the Same Version" section on page 49.

3. Configure new system features. See the Cisco Unity Express 3.2 VoiceMail and Auto-Attendant CLI Administrator Guide, the Cisco Unity Express 3.2 Interactive Voice Response CLI Administrator Guide, and the Cisco Unity Express 3.2 GUI Administrator Guide.