Table Of Contents
Overview of Cisco Unity Express Voice Mail and Auto Attendant
Contents
Prerequisites for Implementing Cisco Unity Express on Cisco CallManager
Recording an Auto Attendant Greeting or Prompt File
Configuring Auto Attendant Scripts
Restrictions for Implementing Cisco Unity Express
Information about Cisco Unity Express
Differences Between the AIM-CUE and NM-CUE
Software Licenses and Factory-Set Limits
Administration Interfaces
Differences Between Cisco Unity Express and Cisco Unity
Interactions Between Cisco Unity Express and Cisco CallManager
Differences Between Cisco Unity Express and Cisco CallManager
Networking Cisco Unity Express with Other Voice Mail Systems
Additional References
Documents Related to Cisco Unity Express
Related Cisco IOS Documents
MIBs
RFCs
Technical Assistance
Overview of Cisco Unity Express Voice Mail and Auto Attendant
The Cisco Unity Express voice mail and auto attendant applications work with Cisco CallManager to provide small- and medium-sized companies with the capability to:
•
Create and maintain voice mailboxes for onsite or remote telephone users. Release 2.0 supports up to 100 mailboxes; earlier releases support up to 50 mailboxes. The maximum number of mailboxes depends on the hardware module and license agreement purchased for Cisco Unity Express.
•
Record and upload messages for callers to hear when they dial the company's telephone number, and prompts to guide the callers to specific extensions or employees.
Contents
•
Prerequisites for Implementing Cisco Unity Express on Cisco CallManager
•
Restrictions for Implementing Cisco Unity Express
•
Information about Cisco Unity Express
–
Differences Between the AIM-CUE and NM-CUE
–
Software Licenses and Factory-Set Limits
–
Administration Interfaces
–
Differences Between Cisco Unity Express and Cisco Unity
–
Interactions Between Cisco Unity Express and Cisco CallManager
–
Differences Between Cisco Unity Express and Cisco CallManager
•
Additional References
Prerequisites for Implementing Cisco Unity Express on Cisco CallManager
Before starting Cisco Unity Express configuration, the Cisco CallManager system must be installed. If you did not or are not performing the Cisco CallManager installation, please 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.
•
Attach the telephones so that they register with the Cisco CallManager server.
•
Verify that the Cisco CallManager server is configured with Cisco IOS Release 12.3(4)T or a later release to support a network module (NM) configuration or with Cisco IOS Release 12.3(7)T or a later release to support an advanced integration module (AIM) configuration.
•
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 Unity Express module supports 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 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 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
class-map match-all voice
ip address 192.168.10.0 255.255.255.0
service-policy output jtapi
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:
Packets marked 334 <-----This number should increase.
3.
Cisco Unity Express, (CUE) uses an FTP server to download CUE license and software files. The FTP server that communicates with CUE 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 adding many users and extensions in CCM.
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.
Recording an Auto Attendant Greeting or Prompt File
Two methods are available to create auto attendant greeting and prompt files:
•
Create a .wav file with the following format: G.711 U-law, 8 kHz, 8 bit, Mono. The file cannot be larger than 500 KB. After recording the greeting, use the GUI or Cisco Unity Express CLI ccn copy command to copy the file in to the Cisco Unity Express system. See the next section, "Recording an Auto Attendant Greeting or Prompt File," for the upload procedure.
•
Use the GMS on the TUI to record the greeting or prompt. Dial the GMS telephone number and select the option to record a greeting. When finished recording, save the file. GMS automatically saves the file in Cisco Unity Express.
The GMS prompt filename has the format UserPrompt_DateTime.wav, for example: UserPrompt_11152003144055.wav. You may want to use CLI commands or GUI options to download the file to a PC, rename the file with a meaningful name, then upload the file back to Cisco Unity Express.
Configuring Auto Attendant Scripts
Cisco Unity Express provides a set of auto attendant prompts and a process, called a script, for handling callers' responses to the prompts. You can modify this script so that specific caller responses are handled in a different way. For example, callers can be directed to leave a voice message in a specific mailbox if they call after business hours.
Use the Microsoft Windows software-based script editor software that comes with Cisco Unity Express to modify the script or create a new script. Refer to the Cisco Unity Express Script Editor Guide for guidelines and procedures.
The file cannot be larger than 1 MB.
After creating the script file, save the file on your PC. Use the CLI interface or the GUI option Voice Mail > Scripts to upload the script file to the auto attendant application.
Restrictions for Implementing Cisco Unity Express
The following restrictions apply to Cisco Unity Express Release 2.0.
Networking
•
Cisco Unity Express supports voice mail networking only with other Cisco Unity Express and Cisco Unity voice mail systems. Networking support for other voice mail systems is not available in Release 2.0.
System Functionality
•
For the NM, only one person with administrator privileges and four people with user privileges may log in to the GUI simultaneously. For the AIM, only one administrator and two users may log in to the GUI simultaneously.
•
Date and time are determined by the NTP server and cannot be set in the Cisco Unity Express software. Cisco Unity Express can be configured as a network transfer protocol (NTP) client. See the NTP configuration section in Cisco Unity Express CLI Administrator Guide for Cisco CallManager, Release 2.0 and your NTP server CLI for more information.
•
Cisco Unity Express supports one language on the system at a time. The language selections are English, French, German, and European Spanish. This language controls the telephone user interface (TUI) system prompts and greetings. The administrative interfaces (GUI and CLI) are available only in U.S. English. Cisco CallManager Express controls the telephone displays, which may be available in multiple languages, and are independent of the Cisco Unity Express supported languages.
Voice Mail Application
•
Cisco Unity Express does not support broadcast messaging.
•
Cisco Unity Express does not support distribution lists.
•
Cisco Unity Express supports two greetings per user, one standard greeting and one alternate greeting. The greetings' time is included in the user's allotted mailbox storage space.
Hardware Limitations
•
Only one Cisco Unity Express module per router chassis is permitted, regardless of the number of module slots in the chassis.
•
The AIM must only be installed in slot 1 of the Cisco 3745 router chassis, installing it in slot 0 may damage the AIM module.
•
The NM's front panel Fast Ethernet 0 port is not used by the Cisco Unity Express applications and is disabled. The Fast Ethernet 1 port connects the Cisco Unity Express network module to the router and is the only active Fast Ethernet port on the network module.
•
The hard disk on the NM cannot be replaced. If the network module's hard disk crashes, the network module must be replaced.
•
Online insertion and removal (OIR) of the Cisco Unity Express NM is available only on the Cisco 3745 router. The replacement module must be the same type as the original module. OIR is not available for the AIM.
Caution 
If the network module or AIM flash memory card must be replaced, manually shut down the Cisco Unity Express application before removing the module from the chassis to prevent file corruption and data loss.
Backup and Restore
Cisco Unity Express does not support the following backup and restore capabilities:
•
Scheduled backup and restore operations. The backup and restore procedures begin when you enter the appropriate command.
•
Centralized message storage arrangement. The Cisco Unity Express backup files cannot be used or integrated with other message stores.
•
Selective backup and restore. Only full backup and restore functions are available. Individual voice mail messages or other specific data cannot be stored or retrieved.
Other Restrictions
•
Cisco Unity Express is an embedded system and provides no access to the Linux system. Users cannot add other Linux-based applications to the Cisco Unity Express module.
•
Cisco Unity Express does not support managing and configuring using Simple Network Management Protocol (SNMP) except for hardware inventory.
•
Cisco Unity Express does not support Cisco Networking Services (CNS) or Subnetwork Access Protocol (SNAP) autoprovisioning.
•
Cisco Unity Express does not support CiscoWorks configmaker.
Information about Cisco Unity Express
The following sections describe general information about Cisco Unity Express.
Differences Between the AIM-CUE and NM-CUE
Cisco Unity Express is supported on both the AIM-CUE and the NM-CUE. Cisco Unity Express features work the same way on both modules with the following exceptions:
•
The AIM-CUE is a 4-port module with 1GB flash memory that stores a maximum of 50 voice mailboxes and 14 hours of voice messages. The NM-CUE is an 8-port module that stores a maximum of 100 voice mailboxes and 100 hours of voice messages.
•
A trace or log command issued on the NM-CUE automatically saves the data to the disk. On the AIM-CUE, the trace and log data are not saved to flash memory. A Cisco Unity Express CLI command is available to save the data to the AIM-CUE flash memory.
•
Cisco Unity Express tracks the use and wear activity of the AIM-CUE flash memory. This tracking is not necessary for the NM-CUE. The CLI command show interface ide 0 and the GUI option Reports > System displays the flash memory wear data.
Software Licenses and Factory-Set Limits
Factory-set system limits are determined by the ordered license. Limits for the NM-CUE are shown in Table 2 and Table 4. Limits for the AIM-CUE are shown in Table 4 and Table 5.
Table 2 System Capacities for Mailboxes, Storage Hours, Ports, Scripts, and Prompts on the NM-CUE
Cisco Unity Express License/Software SKU
|
Total Mailbox Storage (Hours)
|
Default Mailbox Size (Minutes)
|
Number of Ports
|
Number of Automated Attendant Scripts
|
Number of Automated Attendant Prompts
|
SCUE-LIC-12CCM
|
100
|
353
|
8
|
8
|
50
|
SCUE-LIC-25CCM
|
100
|
171
|
8
|
8
|
50
|
SCUE-LIC-50CCM
|
100
|
92
|
8
|
8
|
50
|
SCUE-LIC-100CCM
|
100
|
50
|
8
|
8
|
50
|
Table 3 Maximum Number of Mailboxes, Groups, Owners, and Members on the NM-CUE
Cisco Unity Express License/Software SKU
|
Number of Personal Mailboxes
|
Number of General Delivery Mailboxes
|
|
|
|
SCUE-LIC-12CCM
|
12
|
5
|
20
|
400
|
880
|
SCUE-LIC-25CCM
|
25
|
10
|
20
|
400
|
1000
|
SCUE-LIC-50CCM
|
50
|
15
|
30
|
400
|
1000
|
SCUE-LIC-100CCM
|
100
|
20
|
40
|
400
|
1000
|
Table 4 System Capacities for Mailboxes, Storage Hours, Ports, Scripts, and Prompts on the AIM-CUE
Cisco Unity Express License/Software SKU
|
Total Mailbox Storage (Hours)
|
Default Mailbox Size (Minutes)
|
Number of Ports
|
Number of Automated Attendant Scripts
|
Number of Automated Attendant Prompts
|
SCUE-LIC-12CCM
|
14
|
28
|
4
|
4
|
25
|
SCUE-LIC-25CCM
|
14
|
13
|
4
|
4
|
25
|
SCUE-LIC-50CCM
|
14
|
7
|
4
|
4
|
25
|
Table 5 Maximum Number of Mailboxes, Groups, Owners, and Members on the AIM
Cisco Unity Express License/Software SKU
|
Number of Personal Mailboxes
|
Number of General Delivery Mailboxes
|
|
|
|
SCUE-LIC-12CCM
|
12
|
5
|
20
|
100
|
200
|
SCUE-LIC-25CCM
|
25
|
10
|
20
|
100
|
200
|
SCUE-LIC-50CCM
|
50
|
15
|
20
|
100
|
200
|
Administration Interfaces
Cisco Unity Express offers two administration interfaces:
•
Graphical user interface (GUI)—This user-friendly, web-based interface permits administration of all voice mail and auto attendant functions.
The GUI is targeted for administrators familiar with web-based applications and who have little or no experience with Cisco IOS command structure.
•
Command-line interface (CLI)—This text-based interface has the same administration and configuration capabilities as the GUI. Installation, upgrade, and troubleshooting functions are available only through the CLI commands. The administrator accesses this interface through a Telnet session to the router.
The CLI is targeted for installers, resellers, support personnel, and others familiar with Cisco IOS command structure and routers. For them, accessing the system using the CLI may be easier than using the GUI, especially for troubleshooting, scripting, and bulk provisioning of many sites. Refer to the Cisco Unity Express CLI Administrator Guide for Cisco CallManager for more information about CLI configuration.
The GUI and CLI are accessible from a PC or server anywhere in the IP network. To access the GUI, use Microsoft Internet Explorer Version 6.0 or a later release. See "Using the Initialization Wizard". Cisco Unity Express does not support the Netscape browser. To access the CLI, Telnet to the router, then use the service-module command.
Differences Between Cisco Unity Express and Cisco Unity
Cisco Unity Express is not the same application as Cisco Unity, although both of them are in the Cisco family of voice messaging products, and the differences are:
•
Cisco Unity is a Microsoft Windows-based application and uses the Microsoft Windows operating system's messaging infrastructure. Cisco Unity Express is a Linux-based application.
•
Cisco Unity is usually deployed in a central location that can be networked with multiple sites. Cisco Unity Express Release 2.0 can be deployed in standalone locations that serve the local users.
However, a Cisco Unity Express system can be administered from any location that has IP connectivity with the router housing the Cisco Unity Express application. If several sites in a network use Cisco Unity Express, they can be administered individually from a single PC or server. The administrator opens a browser on a PC or server to the GUI at each site or opens a Telnet session to the CLI at each site.
•
Cisco Unity supports 100 or more mailboxes and Cisco Unity Express supports 100 or fewer mailboxes.
•
Cisco Unity has a larger set of features than does Cisco Unity Express Release 2.0.
Cisco Unity Express uses Cisco Unity Release 3.1 voice mail prompt recordings and prompt flow, which provides the end user with the same voice mail look-and-feel.
Interactions Between Cisco Unity Express and Cisco CallManager
Cisco CallManager is the software that controls the telephony functions. Cisco CallManager accepts incoming and outgoing calls to your network and decides where an incoming or outgoing call should be sent. Cisco Unity Express accepts calls sent from Cisco CallManager over JTAPI and can accept H.323 and Media Gateway Control Protocol (MGCP) calls if Cisco CallManager routes them over the JTAPI interface.
Cisco Unity Express is an application that enhances Cisco CallManager by providing the voice messaging and automated attendant capabilities. The Cisco Unity Express module contains the voice mail and auto attendant software.
Cisco CallManager has a database that contains the telephone hardware identifications, extension numbers associated with the telephones, users on the system, logins, routing destinations, call handling features, and other system-wide parameters.
The Cisco Unity Express database contains information about the voice mailboxes, directory numbers associated with voice mailboxes, auto attendant prompts, and voice messages. As you go through the initialization and configuration procedures, be sure to save your data so that both databases have current information.
The Cisco Unity Express GUI software allows you to configure the voice mail and auto attendant parameters and to specify some of the Cisco CallManager parameters, such as servers, JTAPI user, and computer telephony integration (CTI) ports. The GUI accepts up to three Cisco CallManager servers: a primary server and two backup servers in the event the primary server is not available.
If the WAN link goes down between Cisco CallManager and Cisco Unity Express, Cisco Unity Express will not be able to accept calls from Cisco CallManager. However, the Session Initiation Protocol (SIP) subsystem on the Cisco Unity Express module can accept calls from the Cisco Survivable Remote Site Telephony (SRST) engine. Voice mail and auto attendant applications will function properly. Once the WAN link becomes active, Cisco Unity Express will detect it and register back with the Cisco CallManager server and message waiting indicator (MWI) lights will be updated.
Differences Between Cisco Unity Express and Cisco CallManager
Although Cisco Unity Express works closely with Cisco CallManager, Cisco Unity Express and Cisco CallManager define users and administrators differently:
•
Cisco CallManager requires a web administrator to configure Cisco CallManager parameters and other system components. Cisco CallManager users and administrators are stored in the Cisco CallManager database. Cisco CallManager does not treat the web administrator as a telephone user.
Cisco Unity Express permits configured Cisco CallManager users to be copied to the Cisco Unity Express database. The Cisco CallManager administrator ID cannot be copied to the Cisco Unity Express database and, therefore, cannot be assigned as the administrator ID for Cisco Unity Express.
•
Cisco Unity Express allows only uppercase letters A to Z, lowercase letters a to z, digits 0 to 9, underscore (_), dot (.), and dash (-) in user IDs. User IDs must start with a letter. Any Cisco CallManager user IDs that contain other characters cannot be copied into the Cisco Unity Express database.
•
Spaces are not allowed in passwords. Acceptable password characters are lowercase letters a to z, uppercase letters A to Z, digits 0 to 9, and the following symbols: - , . + = _ ! @ # $ ^ * ( ) ? / ~ < > & %
•
User IDs and passwords are case sensitive.
Networking Cisco Unity Express with Other Voice Mail Systems
Cisco Unity Express supports the capability to network Cisco Unity Express with a voice-mail system located at a different site. Users can send and receive messages from subscribers on remotely located, compatible voice-mail systems configured on Cisco CallManager or Cisco CallManager Express call control platforms. Supported configurations include:
•
Cisco Unity Express to Cisco Unity Express
•
Cisco Unity to Cisco Unity Express
•
Cisco Unity Express to Cisco Unity
For more information about configuring the networking capability, see Cisco Unity Express CLI Administrator Guide for Cisco CallManager, Release 2.0.
Additional References
The following sections provide references related to Cisco Unity Express.
Documents Related to Cisco Unity Express
Related Topic
|
Document Title
|
Cisco Unity Express administration
|
• Cisco Unity Express GUI Administrator Guide for Cisco CallManager, Release 2.0 (this document)
• Cisco Unity Express CLI Administrator Guide for Cisco CallManager, Release 2.0
• Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 2.0
• Cisco Unity Express GUI Administrator Guide for Cisco CallManager Express, Release 2.0
|
Cisco Unity Express commands
|
• Cisco Unity Express Command Reference
|
Cisco Unity Express voice-mail scripts
|
Cisco Unity Express Script Editor Guide
|
Cisco Unity Express voice-mail end user information
|
Cisco Unity Express Voice Mail System - Quick Start Guide
|
Cisco module hardware installation
|
• Cisco Network Modules Hardware Installation Guide
• Installing Advanced Integration Modules in Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
• Advanced Integration Module Quick Start Guide
• Replacing Compact Flash Memory on Cisco AIM-CUE Advanced Integration Modules
• AIM-CUE Slot Restriction on Cisco 3745 Routers
• Installing Network Modules in Cisco 2800 Series Routers
• Installing Network Modules in Cisco 3800 Series Routers
• Installing the AIM-CUE CompactFlash Memory Card
|
Cisco Unity Express software copyrights and licenses
|
• "Appendix A: Software Copyrights and Licenses" on page 63
|
Technical Assistance Center support documentation for Cisco Unity Express
|
Technical Notes for Cisco Unity Express
|
Cisco CallManager 3.3(3)
|
• Cisco CallManager Administration Guide, Release 3.3(3)
• Cisco CallManager System Guide, Release 3.3(3)
• Cisco CallManager Features and Services Guide, Release 3.3(3)
|
Cisco CallManager 4.0(1)
|
• Cisco CallManager Administration Guide, Release 4.0(1)
• Cisco CallManager System Guide, Release 4.0(1)
• Cisco CallManager Features and Services Guide, Release 4.0(1)
|
Cisco Unity
|
• Networking in Cisco Unity Guide
|
Cisco hardware platforms
|
• Cisco 2600 Series Hardware Installation Guide
• Cisco 2600 series hardware configuration notes
• Voice features on Cisco 2600 series routers
• Cisco 2800 Series Hardware Installation
• Cisco 3700 Series Hardware Installation Guide
• Cisco 3700 series hardware configuration notes
• Software Configuration Guide
• Cisco 3800 Series Hardware Installation
|
Related Cisco IOS Documents
MIBs
MIBs
|
MIBs Link
|
• CISCO-CUE-MIB
|
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL: http://www.cisco.com/go/mibs
|
RFCs
RFCs
|
Title
|
1869
|
SMTP Service Extensions
|
1893
|
Enhanced Mail System Status Codes
|
2045
|
Multipurpose Internet Mail Extensions Part One: Format of Internet Message Bodies, RFC
|
2421
|
Voice Profile for Internet Mail - Version 2
|
2821
|
Simple Mail Transfer Protocol
|
Technical Assistance
Description
|
Link
|
Technical Assistance Center (TAC) home page, containing 30,000 pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.
|
http://www.cisco.com/public/support/tac/home.shtml
|