Cisco Unity Express 1.1.2 CLI Administrator Guide for Cisco CallManager
Installing Cisco Unity Express Software
Downloads: This chapterpdf (PDF - 420.0KB) The complete bookPDF (PDF - 3.42MB) | Feedback

Installing Cisco Unity Express Software

Table Of Contents

Installing Cisco Unity Express Software

Prerequisites

Installing a New Cisco Unity Express Software Package

Activating IP Connectivity to Cisco Unity Express Software

Prerequisites

Example

What to Do Next

EXEC and Configuration Modes

Entering the Command Environment

Prerequisites

What to Do Next

Displaying Cisco Unity Express Hardware and Software Versions

Exiting the Command Environment

Sequence of Configuration Tasks

Upgrading the Software or License Version

Upgrading to a New License

Downloading the License Files

Installing a New Software License File

Upgrading to a New Software Image

Prerequisites

Sequence of Tasks

Downloading the Software Files

Entering Configuration Parameter Values

Installing a New Bootloader File

Installing the Software Image Files

What to Do Next


Installing Cisco Unity Express Software


Install Cisco Unity Express software after all Cisco CallManager and Cisco Unity Express hardware and Cisco CallManager software installations are complete. This chapter contains the following installation information and procedures:

Prerequisites

Installing a New Cisco Unity Express Software Package

Activating IP Connectivity to Cisco Unity Express Software

EXEC and Configuration Modes

Entering the Command Environment

Displaying Cisco Unity Express Hardware and Software Versions

Exiting the Command Environment

Sequence of Configuration Tasks

Upgrading the Software or License Version

Prerequisites

Before the Cisco Unity Express configuration can be started, the Cisco CallManager system must be installed. If you did not or are not performing the Cisco CallManager installation, contact the installer or other support personnel to ensure that the following procedures are completed:

1. Install all Cisco CallManager and Cisco Unity Express hardware and verify functionality.

a. Attach the telephones so that they register with the Cisco CallManager server.

b. Verify that the Cisco CallManager router is configured with Cisco IOS Release 12.3(4)T or a later release for the network module (NM) or with Cisco IOS Release 12.3(7)T or a later release for the advanced integration module (AIM).

c. For the NM, verify that the enable LED is lit.


Caution If you are installing an AIM-CUE in your Cisco 3745 router, you must install it in the AIM slot labeled AIM1. Installing this AIM in the AIM slot labeled AIM0 of Cisco 3745 routers can damage the AIM.


Note We highly recommend attaching an uninterruptible power supply (UPS) to the router housing the Cisco Unity Express module. Any reliable UPS unit provides continuous power to maintain the operation of the router and the Cisco Unity Express module. 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 Unity Express properly and then powers off the router.

Cisco IOS Release 12.3(4)T supports automatic switchover to the UPS device if the following configuration is added to the router:

line s 0
privilege level 15
modem Dialin
autocommand service-module service-engine slot/0 shutdown no-confirm

where slot is the Cisco Unity Express module's slot number.


2. Install and verify Cisco CallManager software functionality.

a. You should be able to access the Cisco CallManager configuration web page.

b. To configure the ip unnumbered command on the service-engine interface, use the Cisco IOS software commands on the router to create a static route to the Cisco Unity Express module, for example:

ip route 0.0.0.0 0.0.0.0 91.91.19.1
ip route 10.3.6.128 255.255.255.255 Service-Engine1/0

In this example, 10.3.6.128 is the IP address of the Cisco Unity Express module and Service-Engine1/0 is the router slot hosting the Cisco Unity Express module.

c. For the NM, configure 8 CTI ports on Cisco CallManager. For the AIM, configure 4 CTI ports on Cisco CallManager. Use the Cisco CallManager option Device > Phones > Add new Phone. These ports will be assigned to the Cisco Unity Express applications (voice mail, auto attendant, and greeting management system [GMS]) to terminate calls.


Note Do not configure extra CTI ports on Cisco CallManager. Doing so will impact the scalability of your Cisco CallManager and will limit the number of other devices Cisco CallManager can support.


d. Configure at least two route points on Cisco CallManager using the Device > CTI Route Point option. The Cisco Unity Express voice mail application uses one route point and the auto attendant application uses the other route point. If you plan to use the Cisco Unity Express GMS, configure a third route point on Cisco CallManager.


Note Do not configure extra route points on Cisco CallManager. Doing so will impact the scalability of your Cisco CallManager and will limit the number of other devices Cisco CallManager can support.


e. Create a Cisco CallManager JTAPI user using the User > Add new user option. Use the Device Association option to associate the CTI ports and route points with this JTAPI user. (The JTAPI user is not assigned a Cisco Unity Express voice mailbox. It is a placeholder for Cisco Unity Express to establish connection with Cisco CallManager.) Verify that the Enable CTI Application use box is checked for this JTAPI user.

f. During the Cisco Unity Express software installation, create the Cisco Unity Express administrator user ID and password and specify the IP addresses for the DNS server and NTP server. This user ID and password is needed to log in to the initialization wizard.

g. For efficient call processing, configure access lists on the Cisco Unity Express router to prioritize JTAPI traffic. For example:

class-map match-all jtapi
  match access-group 110
class-map match-all voice
  match access-group 100

policy-map jtapi
  class jtapi
    set dscp cs3
    bandwidth 20
  class voice
    set dscp af31
    priority 320
  class class-default
    fair-queue

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

access-list 100 permit udp host 10.3.6.128 any range 16383 32727
access-list 110 permit tcp host 10.3.6.128 any eq 2748

where 10.3.6.128 is the IP address of the module containing Cisco Unity Express.

The output from a command should indicate that the marked packets number is increasing. For example:

Match: access-group 110
QoS Set
  dscp cs3
  Packets marked 334   <-----This number should increase.

3. The FTP server that communicates with Cisco Unity Express must support passive FTP requests. To configure this functionality on the FTP server, refer to the FTP server documentation.

4. (Optional) If no users were created in the Cisco CallManager interface, create a list of all users, groups, and their extensions. Having this list eases the task of configuring many users and extensions.

5. (Optional) Create an alternate welcome message for the auto attendant application. A default welcome message comes with auto attendant. You can create a different message in a .wav file and install it as part of the auto attendant configuration. See "Recording an Auto Attendant Greeting or Prompt File" for more information.

6. (Optional) Customize the auto attendant prompt sequence to meet your business requirements. See "Configuring Auto Attendant Scripts" for more information.

7. (Required) Record the IP address of the Cisco Unity Express module. Accessing the GUI to configure the system requires this IP address.

Installing a New Cisco Unity Express Software Package

When you order Cisco Unity Express, Cisco Unity Express software and the purchased license are installed on the module at the factory. Spare modules also ship with the software and license installed.

Installation of a new package requires the following procedures:

1. Configure the IP addressing between the module and the router. See "Activating IP Connectivity to Cisco Unity Express Software".

2. Begin configuring the Cisco Unity Express software. See "Sequence of Configuration Tasks".

Activating IP Connectivity to Cisco Unity Express Software

After installing the Cisco Unity Express module, activate the IP communication link between Cisco CallManager and the Cisco Unity Express application.

Prerequisites

The following information is required for activating the software:

Slot and unit numbers of the Cisco Unity Express module on the Cisco IOS router hosting Cisco Unity Express.

IP address and subnet mask of the Cisco IOS router hosting Cisco Unity Express or the unnumbered interface type and number.

IP address of the Cisco Unity Express module. This IP address must be on the same subnet as the Cisco IOS router hosting Cisco Unity Express.

IP address of the default gateway of the Cisco Unity Express router. This IP address must be the same IP address as the Cisco IOS router hosting Cisco Unity Express.

SUMMARY STEPS

From the Cisco IOS router hosting Cisco Unity Express configuration mode:

1. interface Service-Engine slot/unit

2. ip address router-ipaddr subnet-mask
or
ip unnumbered type number

3. service-module ip address cue-side-ipaddr subnet-mask

4. service-module ip default-gateway gw-ipaddr

5. exit

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

Router(config)# interface Service-Engine slot/unit
Example:
Router(config)# interface Service-Engine 2/0

Enters interface configuration mode.

Step 2 

Router(config-if)# ip address router-ipaddr 
subnet-mask
Example:
Router(config)# ip address 172.16.231.195 
255.255.0.0

or

Router(config-if)# ip unnumbered type number
Example:
Router(config)# ip unnumbered FastEthernet 0/0

Specifies the IP address and subnet mask of the Cisco IOS router hosting Cisco Unity Express.




Specifies the interface type and number for the Cisco IOS router hosting Cisco Unity Express.

Step 3 

Router(config-if)# service-module ip address 
cue-side-ipaddr subnet-mask
Example:
Router(config)# service-module ip address 
172.16.231.190 255.255.0.0

Specifies the IP address of the Cisco Unity Express module interface. This IP address must be on the same subnet as the Cisco IOS router hosting Cisco Unity Express.

Step 4 

Router(config-if)# service-module ip default-gateway 
gw-ipaddr
Example:
Router(config)# service-module ip default-gateway 
172.16.231.195

Specifies the IP address the Cisco IOS router hosting Cisco Unity Express.

Step 5 

Router(config-if)# exit
Example:

Router(config-if)# exit

Exits interface configuration mode.

Example

The following example illustrates the IP connectivity activation procedure:

Router(config)# interface Service-Engine 1/0
Router(config-if)# ip address 10.0.0.9 255.0.0.0
Router(config-if)# service-module ip address 10.0.0.10 255.0.0.0
Router(config-if)# service-module ip default-gateway 10.0.100.10
Router(config-if)# exit

What to Do Next

After activating the connectivity to the Cisco Unity Express module, enter the Cisco Unity Express command environment and start configuring the applications. See "Entering the Command Environment".

EXEC and Configuration Modes

The Cisco Unity Express CLI has two implementation modes for the commands: EXEC and configuration. Although these two modes operate similarly to the EXEC and configuration modes for Cisco IOS CLI commands, Cisco Unity Express EXEC mode permits some parameters to be configured or modified, which is not allowed in Cisco IOS EXEC mode. This Cisco Unity Express capability saves the configured parameters to flash memory so that the system has some minimum information available if a catastrophic failure, such as a disk crash, occurs. The description for each command in this guide indicates the command mode.

Entering the Command Environment

After the Cisco Unity Express software is installed and active, use this procedure to enter the command environment.

Prerequisites

For a new Cisco Unity Express software installation, see Prerequisites and the Activating IP Connectivity to Cisco Unity Express Software before beginning this procedure.

The following information is required to enter the command environment:

IP address of the router containing the Cisco Unity Express module

Username and password to log in to the router

Slot number of the module

SUMMARY STEPS

1. Open a Telnet session.

2. telnet ip-address

3. Enter the user ID and password of the router.

4. service-module service-engine slot/port session


Note If the message "Trying ip-address port ...
Connection refused by remote host
appears, enter the command service-module service-engine slot/port session clear
and try Step 4 again.


5. enable

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

Open a Telnet session.

Use a DOS window, secure shell, or a software emulation tool such as Reflection.

Step 2 

C:\>telnet ip-address
Example:
C:\>telnet 172.16.231.195

Specifies the IP address of the Cisco CallManager router.

Step 3 

Username:
Password:

Enter your user ID and password for the router.

Step 4 

Router# service-module service-engine slot/port 
session
Example:
Router# service-module service-engine 1/0 
session

Enters the Cisco Unity Express command environment using the module located in slot and port. The prompt changes to "se" with the IP address of the Cisco Unity Express module.

If the message
"Trying ip-address slot/port ...
Connection refused by remote host
appears, enter the command
service-module service-engine slot/port session clear
and try Step 4 again.

Step 5 

se-10-0-0-0# enable

Enters Cisco Unity Express EXEC mode. You are ready to begin the configuration tasks.

What to Do Next

Review "Sequence of Configuration Tasks".

Displaying Cisco Unity Express Hardware and Software Versions

To display the versions and serial numbers of the installed Cisco Unity Express hardware components, use the show version command.

To display the versions of the installed Cisco Unity Exprss software components, use the show software versions command.

Exiting the Command Environment

To exit the Cisco Unity Express Release 1.1.2 command environment, follow these steps:

1. Return to the Cisco Unity Express EXEC mode.

2. Press the CTRL-SHIFT-6 keys simultaneously.

3. Press the lowercase x key separately.

The router prompt appears.

Sequence of Configuration Tasks

After completing the prerequisite activities, begin the configuration tasks. Table 6 lists the configuration tasks, the chapter that contains the procedure, and additional information needed for each task.

Configuring the System Using the CLI Commands

If you will configure one or more Cisco Unity Express systems exclusively using CLI scripts, enter the command environment as described in "Entering the Command Environment". Proceed with the scripts, using Table 6 as a guideline for configuring the system components. When entering the GUI for the first time and the initialization wizard appears, choose the skip option to avoid reconfiguring the system.

Configuring the System Using the GUI and the Initialization Wizard

The Cisco Unity Express GUI provides the initialization wizard software tool to configure the basic system parameters and import any users configured with the Cisco CallManager interface.

If you log in to the GUI web interface after installation, the initialization wizard is the first screen to appear. You cannot activate it again except by reinstalling Cisco Unity Express software. All the parameters configured through the initialization wizard are available through GUI screens and CLI commands. Refer to Chapter 2, "Configuring the System for the First Time," in the Cisco Unity Express GUI Administration Guide for Cisco CallManager for more information about the initialization wizard.

Table 6 Configuration Task Sequence  

Task and Procedure Location
Additional Information Needed

1. Configuring JTAPI Parameters

JTAPI user ID, password, and credentials.

CTI ports.

Cisco CallManager server hostname or IP address.

2. Configuring the Voice Mail Application

Maximum number of users who can access voice mail simultaneously. This number is limited by the number of ports purchased with Cisco Unity Express. Check your license agreement and see "Feature Overview" for this maximum number.

Telephone number to access the voice-mail system.

3. Configuring and Managing the Auto Attendant Application

To use your own welcome greeting, create a .wav file containing the prerecorded welcome greeting. This file must be uploaded to Cisco Unity Express module so that it can be located and saved in the auto attendant script. Alternatively, you can use the greeting management system (GMS) to record the welcome greeting. See "Recording an Auto Attendant Greeting or Prompt File" for guidelines on recording a greeting.

Number of times the auto attendant will replay instructions to a caller before the call is disconnected. This count begins when the caller moves past the main menu and starts to hear instructions for a submenu. The main menu will play five times and then, if the caller makes no choice or incorrect choices, will transfer to the operator.

Extension number of the operator. Auto attendant dials this extension when the caller presses the zero ("0") button.

Telephone number that the caller must dial to reach the auto attendant. In many cases, this number is your company telephone number.

Maximum number of callers that auto attendant can handle simultaneously. This number is limited by the number of ports purchased with Cisco Unity Express. Check your license agreement and see "Feature Overview" for this maximum number.

4. Configuring the Greeting Management System Application

Telephone number for accessing the GMS.

5. Configuring and Managing the Auto Attendant Application

Prerecorded prompt files in .wav format. Use the GMS to record the prompts.

Prompt filenames.

6. Configuring Auto Attendant Scripts

Preconfigured script files. Use the Cisco Unity Express script editor to create the files. Refer to the Cisco Unity Express Script Editor Guide for more information.

Script filenames.

7. Configuring JTAPI Triggers for the Applications

Telephone number that invokes the application. This number must be different for voice mail, auto attendant, and greeting management system.

Maximum number of callers, or sessions, the application can handle simultaneously. The total for all applications must not exceed the maximum number of ports for the system. (See Table 2 for the maximum number of ports.) The applications need not have the same maximum number; for example, voice mail might need three sessions while auto attendant needs five sessions.

8. Configuring System-Wide Mailbox Default Values

Capacity—The total amount of storage time in hours allowed for all mailboxes in the system. The factory default is the maximum allowed storage for your system.

Expiration date—The number of days a message is saved in the mailbox before the voice-mail system deletes it. The factory default value is 30 days.

Language—The language used for voice-mail prompts. In Release 1.0, U.S. English is the only language available.

Mailbox size—The maximum number of seconds of storage for voice messages in a mailbox. The factory default value is determined by dividing the maximum storage capacity by the maximum number of mailboxes (personal plus general delivery).

Message length—The maximum number of seconds for any one stored message in a mailbox. The factory default is 60 seconds.

Recording time—The maximum amount of time for a user's recorded mailbox greeting.

Operator extension—The extension of the voice-mail operator.

9. Adding and Modifying a User

Username—The user ID. The username must be at least 3 and no more than 32 characters in length. Users IDs must start with a letter. Do not use spaces in the username.

(Optional) Full name—First and last name of the user. Enter this name in quotation marks (" ").

(Optional) Group—Name of a group in which this user is a member. If the group does not exist, this procedure will create it.

If you create a user or group with the CLI, you must provide a password and PIN.

Password—Temporary password for this user. The password must be at least 3 and no more than 32 characters in length. Spaces are not allowed. When the user logs in to the GUI for the first time, the application requires the user to change the password. In Release 1.0, the user's password does not expire.

PIN—Personal identification number. The PIN must be at least 3 and no more than 16 digits in length. When the user logs in to the voice-mail system for the first time, the application requires the user to change the PIN. In Release 1.0, the PIN does not expire.

If you create a user or group with the GUI, you must decide the policy for handling passwords and PINs.

Tip You must determine the level of security for your voice-mail system. Requiring a new user to have a password to access the GUI and a PIN to access a voice mailbox helps discourage unauthorized personnel from gaining entry to the system or to another user's mailbox. However, not assigning a password and PIN makes it easier for a user to enter the system or mailbox the first time.

Decide whether Cisco Unity Express should generate a random password and a random PIN for each new user or if the password and PIN should be blank.

Regardless of the method you use for creating a user, each new user and each user copied from Cisco CallManager is required to change the password and the PIN when logging in to the voice-mail system for the first time.

10. Adding and Modifying a Group

EXEC mode:

Name of the group.

(Optional) Description of the group.

(Optional) Full name of the group.

Configuration mode:

Name of the group.

(Optional) One or more member user IDs.

(Optional) User ID of the owner.

(Optional) Extension or telephone number of the group.

(Optional) Full E.164 telephone number of the group.

The group need not have a mailbox associated with it.

Note If a user must access a general delivery mailbox (GDM), the user must have a personal mailbox assigned first.

11. Creating and Modifying a Voice Mailbox

The default mailbox size.

The mailbox size represents the total number of seconds from all messages stored in a user's voice mailbox. Cisco Unity Express calculates a default value based on the maximum number of mailboxes and the maximum storage space on the system. Optionally, you can change the size value for individual users.

The default message storage time.

The message storage time is the number of days that the system will save old messages. As a message approaches this storage time, the system alerts the user to resave or delete the message. If the user takes no action when the maximum storage time is reached, the message is deleted from the system.

The default message length.

The message length represents the maximum number of seconds for any message stored in a voice mailbox. Callers who try to leave a longer message will be cut off when the maximum time is reached. Cisco Unity Express calculates a default value based on the default storage space for a mailbox. You can change the length value for individual users.

Telephone numbers for the voice-mail system, auto attendant, and operator extension

Note The voice-mail telephone number and the voice-mail operator's telephone number should not be the same. If they are, then a user trying to call the operator while in the voice-mail system will be directed back to the voice-mail system. Also, an outside caller who presses the button for the operator will be connected to the voice-mail system.

Whether the mailbox uses the standard greeting or an alternate greeting.


Upgrading the Software or License Version

Cisco Unity Express allows you to upgrade to new software versions in the combinations described in the following sections:

Upgrading to a New License—Use your current software version but increase the number of supported mailboxes.


Note If you are changing to a smaller mailbox license, verify that the system meets the new license limit before downloading the new license. For example, if you are downgrading from a 50 mailbox license to a 12 mailbox license, ensure that your system does not have more than 12 configured mailboxes. If you have more than 12 mailboxes, delete the extra mailboxes before downgrading the license.


Upgrading to a New Software Image—Use your current licensed number of mailboxes on a new software image.


Note If you are upgrading from Cisco Unity Express Release 1.0, upgrade the bootloader file before installing a new software image.



Caution Always do a shutdown of the module before power cycling the router to prevent file corruption and possible data loss.

Upgrading to a New License

Upgrading to a new license requires the following sequence of activities:

1. Order the license SKU from the Configurator. Choose a package from the following list:

12-mailbox package: SCUE-12CCM-1.1.2=

25-mailbox package: SCUE-25CCM-1.1.2=

50-mailbox package: SCUE-50CCM-1.1.2=

100-mailbox package: SCUE-100CCM-1.1.2=

2. Download the license files from Cisco.com. See "Downloading the License Files".

3. Back up your data and configuration files. See "Backing Up Files".

4. Install the new license file. See "Installing a New Software License File".

5. Restore the data and configuration files. See "Restoring Files".

6. Reboot the system.

Downloading the License Files

After ordering the appropriate license SKU, download the corresponding license file and installer file.

Prerequisites

Have available the IP address or name of the TFTP server that will store the downloaded files. This may be the same as the FTP server. Verify that the TFTP server is accessible.

Have available the IP address or name of the FTP server that will store the Cisco Unity Express applications. Verify that the FTP server is accessible.

PROCEDURE

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

2. Download the appropriate license file from the following list:

cue-vm-12-license.1.1.2.ccm.pkg

cue-vm-25-license.1.1.2.ccm.pkg

cue-vm-50-license.1.1.2.ccm.pkg

cue-vm-100-license.1.1.2.ccm.pkg

3. Copy the file to the FTP server.

4. Download the installer file: cue-installer.1.1.2

5. Copy the installer file to the TFTP server.

What to Do Next

Back up your data and configuration files. See "Backing Up Files".

After the backup, install the new license file. See "Installing a New Software License File".

Installing a New Software License File

After downloading the appropriate software files and backing up your configuration and system data, use this procedure to install the new license files.

Prerequisites

The following information is required to install the software license file:

FTP server user ID

FTP server password

License package name (See Table 2 for the list of license packages.)

SUMMARY STEPS

Starting from EXEC mode on the Cisco Unity Express module:

1. reload

2. Type *** quickly when the boot configuration prompt appears.

3. boot helper

4. software install package url ftp://ftp_server_ip_address/license_package.pkg
[username username password password]

5. Restart the system.

DETAILED STEPS


Step 1 Reload (shutdown and startup) the Cisco Unity Express module. Interrupt the startup to get the bootloader prompt. You may see output similar to the following:

se-172.16.0.0# reload

se-172.16.0.0
MONITOR SHUTDOWN...
EXITED: SQL_startup.sh exit status 0
EXITED: LDAP_startup.sh exit status 0

MONITOR EXIT...
INIT: Switching to runlevel: 6
Restarting system.
.
.
System Now Booting ...
Booting from flash..., please wait.
[BOOT-ASM]
7      


Step 2 Type *** quickly to change to boot configuration, as shown in the following output:


Please enter '***' to change boot configuration:***

ServicesEngine Bootloader Version : 1.1.X

Step 3 Boot the system from the helper image (cue-installer.1.1.2) located on the TFTP server in the /tftpboot directory. By default, the system boots from the disk.

The boot is complete when the "Welcome to Cisco Service Engine" message appears. You may see output similar to the following:

ServicesEngine boot-loader> boot helper

Probing...
.
.
.
INIT: version 2.84 booting
Started device management daemon v1.3.25 for /dev

Remounting the root filesystem read-only...
/dev/root: clean, 653/5688 files, 61894/67100 blocks

FILESYSTEM CLEAN
Remounting the root filesystem read-write...

kernel.sem = 16384 32000 32 128

		Welcome to Cisco Service Engine
.
.
.
se-172.20.231.191installer#>

Step 4 Install the license package software from the FTP server using the following command:

se-172.20.231.191installer#> software install package url ftp://ftp_server_ip_address/license_package.pkg [username username password password]

The following example installs the 25-mailbox package on the FTP server at IP address 192.168.10.0 with an FTP server user ID admin and password voice.

se-172.20.231.19installer#> software install package url ftp://192.168.10.0/cue-vm-25-license.1.1.2.ccm.pkg username admin password voice

The following output appears:

umount: /dev/hda1: not mounted

/dev/hda1: clean, 3866/2443200 files, 139430/4883752 blocks

Found Valid Partition.

Connecting to host...

% Total % Received % Xferd Average Speed Time Curr.

Dload Upload Total Current Left Speed

100 2298 100 2298 0 0 21277 0 0:00:00 0:00:00 0:00:00 60666

signed value is [1]

Calculated MD5 is: 9981469138d7da7d76b32d3e0735e470

Calculated File Header is: filename: licenses.tgz

filetype: tgz

id: license

signed: 0

checksum: 9981469138d7da7d76b32d3e0735e470

size: 855

sig_ba length is : 975

out_ba length is : 65536

A change has occurred that requires the system to be restarted.

Step 5 Restart the system as shown in the following sample output:

Do you wish to restart now (y,n) [y]y


What to Do Next

Restore the data and configuration files. See "Restoring Files".

After the restore, reboot the system.

Upgrading to a New Software Image

This section describes the procedures for upgrading to a new release of Cisco Unity Express software.

Prerequisites

Ensure that the TFTP and FTP servers are configured and active. If the TFTP and FTP servers reside on the same PC, ensure that the TFTP and FTP programs are activated.

Ensure that you can ping the Cisco Unity Express module from the TFTP and FTP servers.

A DNS server is optional for initializing the new software. If DNS is desired, install and activate a DNS server on the PC or server before proceeding.

Sequence of Tasks

Upgrading to a new software image entails the following sequence of tasks:

1. Download the software image files. See "Downloading the Software Files".


Note If you are upgrading from Cisco Unity Express Release 1.0, download the bootloader file in addition to the software files.


2. Back up your data and configuration files. See "Backing Up Files".

3. Enter several configuration parameter values. See "Entering Configuration Parameter Values".

4. If you are upgrading from Cisco Unity Express Release 1.0, upgrade the bootloader. See "Installing a New Bootloader File".

5. Install the software files. See "Installing the Software Image Files".

6. Restore the data and configuration files. See "Restoring Files".

7. Reboot the system.

Downloading the Software Files

Downloading the Cisco Unity Express software files is the first software upgrade task. Review the prerequisites listed above to ensure that all servers and modules are active and available.

SUMMARY STEPS

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

2. Download the following software files.

If you are upgrading from Cisco Unity Express Release 1.0, download the bootloader file.

3. copy cue-installer.1.1.2 tftp:/tftpboot

4. Copy the other software files to the FTP server using the following commands:

a. copy cue-vm.1.1.2.manifest ftp:/var/ftp

b. copy cue-vm.1.1.2.prt1 ftp:/var/ftp

c. copy cue-vm-YY-ZZZ.pkg ftp:/var/ftp

d. (Optional) copy cue-bootloader.1.0.17.pkg ftp:/var/ftp

DETAILED STEPS


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

Step 2 Download the Cisco Unity Express software files.

cue-vm.1.1.2.pkg

cue-vm.1.1.2.manifest

cue-vm.1.1.2.prt1

cue-installer.1.1.2

cue-vm-YYZZZ.pkg


Note YY represents the number of voice-mail users, and ZZZ represents either Cisco CallManager or Cisco CallManager Express.


If you are upgrading from Cisco Unity Express Release 1.0, download the bootloader file: cue-bootloader.1.0.17.pkg.

Step 3 Copy the cue-installer.1.1.2 file to the TFTP server in the /tftpboot directory with the command:
copy cue-installer.1.1.2 tftp:/tftpboot

If you download the files to a different server, copy the cue-installer.1.1.1 file to the TFTP server before beginning the installation procedure.

Step 4 Copy the other software files and the bootloader file (if you downloaded this file) to the FTP server (such as the /var/ftp directory) using the following commands. The installation procedure requires the pathname to the files.

a. copy cue-vm.1.1.2.manifest ftp:/var/ftp

b. copy cue-vm.1.1.2.prt1 ftp:/var/ftp

c. copy cue-vm-YYZZZ.pkg ftp:/var/ftp

d. (Optional) copy cue-bootloader.1.0.17.pkg ftp:/var/ftp


What to Do Next

Back up your data and configuration files. See "Backing Up Files".

After backing up the files, configure several parameter values. See "Entering Configuration Parameter Values".

Entering Configuration Parameter Values

SUMMARY STEPS

1. reload

2. Type "***" to go into the boot loader mode.

3. config t

4. Enter the values for the following parameters:

Network module's IP address

Subnet mask

TFTP server address

Gateway router address

Ethernet interface is internal

Default helper image is cue-installer.1.1.1

Default boot is helper

5. Enter boot helper mode.

DETAILED STEPS


Step 1 Type reload to restart the system.

Step 2 Type "***" to go into the boot loader mode.

Step 3 Type config t to go into configuration mode.

Step 4 Enter the values for the following parameters:

Network module's IP address

Subnet mask

TFTP server address

Gateway router address

Ethernet interface: internal

Default helper image: cue-installer.1.1.1

Default boot: helper

Step 5 Enter boot helper mode.


What to Do Next

If you are upgrading from Cisco Unity Express Release 1.0, upgrade the bootloader file. See "Installing a New Bootloader File".

If you are not installing the bootloader file, install the software files. See "Installing the Software Image Files".

Installing a New Bootloader File

If you have downloaded a new Cisco Unity Express bootloader file, use this procedure to install the file.

Prerequisites

The following information is required to install the bootloader file:

FTP server IP address

FTP server user ID

FTP server password

Directory location of the bootloader file on the FTP server.

SUMMARY STEPS

Starting from the bootloader mode on the Cisco Unity Express module:

1. software install package url ftp://ftp_server_ip_address/cue-bootloader.1.0.17.pkg
[username username password password]

2. Update the primary bootloader.

3. Set the default bootloader.

4. Do not reboot the system.

DETAILED STEPS


Step 1 Install the bootloader software from the FTP server using the following command:
software install package url ftp://ftp_ser_ip_address/cue-bootloader.1.0.17.pkg [username username password password]

You may see output similar to the following:

ServicesEngine boot-loader> boot helper

Probing...
.
.
.
		Welcome to Cisco Service Engine
.
.
.
se-172.20.231.191installer#>

se-172.20.231.191installer#> software install package url ftp://ftp_server_ip_address/cue-bootloader.1.0.17.pkg [username username password password]

Connecting to host... 
  % Total    % Received % Xferd Average    Speed              Time                 Curr. 
                                        Dload Upload      Total   Current   Left   Speed 
100 60936     100 60936    0     0       804k      0     0:00:00  0:00:00  0:00:00 4391k 

Step 2 Update the primary bootloader.

Would you like to update the primary or secondary Bootloader (p,s) [s] p 

WARNING:DO NOT POWER OFF ROUTER DURING UPDATE! 

Updating...complete. 

Step 3 Make the primary bootloader the default bootloader.

The primary bootloader is not the default bootloader boot option. Would you like to make 
the primary bootloader the default boot option?

(y,n) [y] 
Change default bootloader from secondary to primary completed. 

Cleaning up...complete. 

A change has occurred that requires the system to be restarted.

Step 4 Do not restart the system, as shown in the following sample output:

Do you wish to restart now (y,n) [y]n


What to Do Next

Upgrade the software image files. See "Installing the Software Image Files".

Installing the Software Image Files

After downloading the software files, backing up your data, and installing the bootloader file, if required, you are ready to install the software image files.

Prerequisites

Installing the software image files requires the following information:

TFTP server IP address

FTP server IP address

FTP server user ID

FTP server password

License package name

Software package name

Install the new software files after backing up current system configurations and data.


Caution Always do a shutdown of the module before power cycling the router to prevent file corruption and possible data loss.

SUMMARY STEPS

Starting from EXEC mode on the router:

1. Load the software. Type software install package url ftp://ftp_ipaddress/cue-vm.1.1.2.pkg {username username password ftp_password} or
software Install package url ftp://ftp_ipaddress /cue-vm.1.1.2.pkg

2. Remove the old installation.

3. Do not reboot the system.

4. Install the license information. Type software install package url ftp://ftp_ipaddress/license_pkg_name

5. Restart and go to the boot configuration.

6. Type config to change the default boot source from helper to disk.

Accept all the default values except Default Boot. At that prompt, type disk.


Note An AIM can be configured to use primary or secondary BIOS. If primary BIOS is configured as the default, the Cisco Unity Express module boots up normally. If secondary BIOS is configured as the default, the Cisco Unity Express module boots up using primary BIOS, looks for the secondary BIOS location, verifies the checksum, then uses the secondary BIOS.


7. Type boot disk to boot the newly installed software and license from the disk.

8. Post-installation configuration starts. Configure one or more DNS servers, NTP servers, the time zone, and the administrator user ID and password.


Note Cisco Unity Express automtically changes to daylight savings time on the basis of the selected time zone.


9. Log in to Cisco Unity Express.

10. show software version

11. show software license

DETAILED STEPS


Step 1 Load the software using one of the following commands:

software install package url ftp://ftp_ipaddress /cue-vm.1.1.2.pkg {username username password ftp_password}

or

software Install package url ftp://ftp_ipaddress /cue-vm.1.1.2.pkg

where

install—Install with FTP username and password

Install—Install without FTP username and password

ftp_ipaddress—FTP server IP address

/cue-vm.1.1.2.pkgName of the software package. Use the slash mark (/) before the package name.

username—User ID on the FTP server

ftp_password—User's password on the FTP server


The following examples illustrate the commands:

se-172.20.231.191installer#> software install package url 
ftp://10.3.61.16/cue10.0.0.18.pkg username admin password ftpvoice

or


se-172.20.231.191installer#> software Install package url 
ftp://10.3.61.16/cue10.0.0.18.pkg

The following example illustrates the output:


mount: /dev/hda1: not mounted
/dev/hda1: clean, 3844/262144 files, 46290/524278 blocks
Found Valid Partition.
Connecting to host...
.
.
.

After the manifest is loaded, the following messages appear:

Manifest Version matches package version
WARNING: This is an unrecoverable operation!
WARNING: This will erase all data on the Service Engine and install new software.
WARNING: Configuration and user data must be restored after the system restarts.

Caution This step cleans the disk. All configuration and voice messages will be lost after this step. For future upgrades and installations, verify that a backup has been done. If it has not, abort at this step and do a backup first.

Do you wish to continue (y,n) [n]

Step 2 Remove the old installation, if any. The output is similar to the following:

Do you wish to continue (y,n) [n] y

Removing old installation...done.
Retrieving cue10.0.0.18.prt1 from 10.3.61.16
Connecting to host...
.
.
.
100% complete.
Done.
.
.
.
Restoring License from Flash...
Flash license payload verified.
Restore License from Flash complete.
A change has occurred that requires the system to be restarted.
Do you wish to restart now (y,n) [y]

Step 3 Do not reboot the system. The output is similar to the following:

Do you wish to restart now (y,n) [y] n


		Welcome to Cisco Service Engine
.
.
.
********** rc.post_install ****************
INIT: Switching to runlevel: 4
INIT: Sending processes the TERM signal
STARTED: cli_server.sh
.
.
.
se-172.20.231.191installer#>

Step 4 Install the license information using the following command:

software install package url  ftp://ftp_ipaddress/cue-vm-YYZZZ.1.1.2.pkg

where

ftp_ipaddress—IP address of the FTP server

/cue-vm-YYZZZ.1.1.2.pkg—Name of the Cisco Unity Express license package. Use the slash mark (/) before the package name.

The following example installs the 50 mailbox package on FTP server 10.3.61.16:

se-172.20.231.191installer#> software install package url 
ftp://10.3.61.16/cue-vm-50ccm.1.1.2.pkg



The output is similar to the following:

checksum: 8d8839c790efaf49d6619d4eb0918fca
size: 858
sig_ba length is : 978
out_ba length is : 65536
A change has occurred that requires the system to be restarted.

Do you wish to restart now (y,n) [y] 

Step 5 Restart the system and go to the boot configuration. The output is similar to the following:

Do you wish to restart now (y,n) [y] y
INIT: Restarting system.
.
.
.
System Now Booting ...
Booting from flash..., please wait.
[BOOT-ASM]
7      

Type *** quickly to interrupt the boot and get to the bootloader prompt.


Please enter '***' to change boot configuration:***
ServicesEngine Bootloader Version : 1.0.5

ServicesEngine boot-loader>

Step 6 Change the default boot source from helper to disk using the config command. Use the show config command first to display the current settings, then use the config command to change the values.

The following example illustrates the output:

ServicesEngine boot-loader> show config

2w5d: %LINEPROTO-5-UPDOWN: Line protocol on Interface Service-Engine1/0, changed 
state to up
IP addr:		172.20.231.191
Netmask:		255.255.0.0
TFTP server :		10.3.61.16
GW IP addr:		172.16.231.40
eth int:		internal
Default boot:		helper
Bootloader Version:	1.0.5
Default Helper-file:	cue_helper
Default BIOS:         primary
Default bootloader:   primary
Default cpu throttle: 50%


Note The Default BIOS, Default bootloader, and Default cpu throttle appear if an AIM is installed in the router. The cpu throttle value is factory set and cannot be changed.



Note An AIM can be configured to use primary or secondary BIOS. If primary BIOS is configured as the default, the Cisco Unity Express module boots up normally. If secondary BIOS is configured as the default, the Cisco Unity Express module boots up using primary BIOS, looks for the secondary BIOS location, verifies the checksum, then uses the secondary BIOS.


ServicesEngine boot-loader>

ServicesEngine boot-loader> config
IP Address [172.20.231.191] >
Subnet mask [255.255.0.0] > 
TFTP server [10.3.61.16] >
Gateway [172.16.231.40] >
Default Helper-file [cue_helper] >
Ethernet interface [internal] > 
Default Boot [helper] > disk

Updating flash with bootloader configuration

ServicesEngine boot-loader>

Step 7 Boot the newly installed software and license from the disk using the boot disk command. The following example illustrates the output:

ServicesEngine boot-loader> boot disk

Filesystem type is ext2fs, partition type 0x83
kf: a1 : (hd0,0)/bzImage root=/dev/hda1 ro plat=nm
kf: a2 : (hd0,0)/bzImage root=/dev/hda1 ro plat=nm
in grub_open: (hd0,0)/bzImage root=/dev/hda1 ro plat=nm
.
.
.
FILESYSTEM CLEAN
Remounting the root filesystem read-write...

kernel.sem = 16384 32000 32 128


		Welcome to Cisco Service Engine
.
.
.
********** rc.post_install ****************
Trace store to HD started

IMPORTANT:: Welcome to Cisco Systems Service Engine post installation
IMPORTANT:: configuration tool. This is a one time process which
IMPORTANT:: will guide you through the set up the Service Engine.
IMPORTANT:: Once run the system must be configured and started.

IMPORTANT:: If you do not wish to continue, the system will be halted
IMPORTANT:: so it can be safely removed from the router.

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

Step 8 Begin configuring Cisco Unity Express.

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

Are you sure (y,n)?y

Enter the IP address of the primary and secondary (if any) DNS servers.

IMPORTANT:: DNS Configuration:
IMPORTANT:: 
IMPORTANT:: This allows the entry of hostnames, for example foo.mycompany.com, instead 
IMPORTANT:: of IP addresses like 10.100.10.205 for servers used by Cisco Unity Express. 
IMPORTANT:: In order to configure DNS you must know the IP address of at least one of your
IMPORTANT:: DNS Servers.  

Would you like to use DNS for CUE (y,n)?y
Enter IP Address of the Primary DNS Server
  (IP address): 172.68.226.120
Found server 172.68.226.120
Enter IP Address of the Secondary DNS Server
  (IP address, or enter to bypass): 
Enter hostname of the Primary NTP Server
  (hostname, or enter for 172.100.26.1): 
Enter hostname of the Secondary NTP Server
  (hostname, or enter to bypass): 

Select the correct time zone.

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:
Please select a country.
 1) Anguilla		  18) Ecuador		    35) Paraguay
 2) Antigua & Barbuda	  19) El Salvador	    36) Peru
 3) Argentina		  20) French Guiana	    37) Puerto Rico
 4) Aruba		  21) Greenland		    38) St Kitts & Nevis
 5) Bahamas		  22) Grenada		    39) St Lucia
.
.
.
When the software has updated the time zone, the software switches to a new run level and displays 
the Cisco Unity Express module prompt.

Changing owners and file permissions.
Change owners and permissions complete.
INIT: Switching to runlevel: 4
INIT: Sending processes the TERM signal
STARTED: DNS_startup.sh
STARTED: cli_server.sh
STARTED: ntp_startup.sh
STARTED: LDAP_startup.sh
STARTED: usermanager_startup.sh
STARTED: SQL_startup.sh
STARTED: HTTP_startup.sh
STARTED: ${ROOT}/usr/wfavvid/wfsysdb_startup.sh
STARTED: ${ROOT}/usr/wfavvid/run
STARTED: start_backuprestore.sh
STARTED: syslog_startup.sh
 waiting 1 ...
 waiting 2 ... 
 waiting 3 ... 
 waiting 4 ...
.
.
.

Enter the user ID and password for the system administrator.


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

Step 9 Log in to the system. Press Enter for the password, as shown in the following example:

se-172.30.231.191> enable
Password:

Step 10 Display the software version using the show software version command. The following example illustrates the output:

se-172.30.231.191> show software version

Installed Packages:

- Core 1.1.2

- Auto Attendant 1.1.2

- Voice Mail 1.1.2

- Boot Loader 1.0.17

Installed Languages:

- US English 1.1.2

se-172.30.231.191#

Step 11 Display the software license using the show software license command. The following example illustrates the output:

se-172.30.231.191> show software license

Core:

- application mode: ccm

Voicemail:

- max message size: 6000

- max gdm: 15

- max mailboxes: 50

Auto Attendant:

- max ports: 8

Languages:

- max installed languages: unlimited

- max enabled languages: 1

se-172.30.231.191#


What to Do Next

1. Restore the data and configuration files. See "Restoring Files".

2. Reboot the system.

3. Enter the Cisco Unity Express command environment. See "Entering the Command Environment".