![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() |
Table Of Contents
Overview of Cisco Unity Express Voice Mail and Auto Attendant
Prerequisites for Implementing Cisco Unity Express on Cisco CallManager
Restrictions for Implementing Cisco Unity Express
Recording an Auto-Attendant Greeting or Prompt File
Configuring Auto-Attendant Scripts
Differences Between the AIM and NM
Software Licenses and Factory-Set Limits
Networking Cisco Unity Express with Other Voice-Mail Systems
Differences Between Cisco Unity Express and Cisco Unity
Interactions Between Cisco Unity Express and Cisco CallManager
Differences Between Cisco Unity Express and Cisco CallManager
Documents Related to Cisco Unity Express
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. Releases 2.1 and 2.2 support up to 100 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
•
Recording an Auto-Attendant Greeting or Prompt File
•
Configuring Auto-Attendant Scripts
•
Differences Between the AIM and NM
•
Software Licenses and Factory-Set Limits
•
Networking Cisco Unity Express with Other Voice-Mail Systems
•
Differences Between Cisco Unity Express and Cisco Unity
•
Interactions Between Cisco Unity Express and Cisco CallManager
•
Differences Between Cisco Unity Express and Cisco CallManager
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 Unity Express 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).
•
For the NM, verify that the enable LED is lit.
CautionIf 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 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.
On the Cisco CallManager, configure 16 CTI ports for a Cisco Unity Express system with a 512 MB NM. Configure 8 ports for a 256 MB NM.
For the AIM running at 300 MHz, configure 6 CTI ports on Cisco CallManager. For the 150 MHz AIM, configure 4 CTI ports. 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 Administration via Telephone [AVT]) 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 AVT, 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.
Restrictions for Implementing Cisco Unity Express
The following restrictions apply to Cisco Unity Express Releases 2.1 and 2.2.
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 Releases 2.1 and 2.2.
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 2.1/2.2 CLI Administrator Guide for Cisco CallManager and your NTP server CLI for more information.
•
Cisco Unity Express supports one language on the system at a time. See the Release Notes for Cisco Unity Express Release 2.2 for a list of available languages. 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 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 cannot be installed in slot 0 of the Cisco 3745 router chassis.
•
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 and 3845 routers. The replacement module must be the same type as the original module. OIR is not available for the AIM.
CautionIf 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.
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 mu-law, 8 kHz, 8 bit, Mono. The file cannot be larger than 500 KB. After recording the greeting, use the GUI option Voice Mail > Prompts > Upload or Cisco Unity Express CLI ccn copy command to copy the file in to the Cisco Unity Express system. See the GUI online help (OLH) or the Cisco Unity Express 2.1/2.2 CLI Administrator Guide for Cisco CallManager for the upload procedure.
•
Use the AVT on the TUI to record the greeting or prompt. Dial the AVT telephone number and select the option to record a greeting. When finished recording, save the file. AVT automatically saves the file in Cisco Unity Express.
The AVT 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.
Differences Between the AIM and NM
Cisco Unity Express is supported on both the AIM and the NM. Cisco Unity Express features work the same way on both modules with the following exceptions:
•
The AIM is a 4-port module that stores a maximum of 50 voice mailboxes and 8 hours of voice messages. The NM 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 automatically saves the data to the disk. On the AIM, 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 flash memory.
•
Cisco Unity Express tracks the use and wear activity of the AIM flash memory. This tracking is not necessary for the NM. 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 and NM-CUE-EC are shown in Table 2 and Table 3. 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 and NM-CUE-EC
Cisco Unity Express License/Software SKU Total Mailbox Storage (Hours) Default Mailbox Size (Minutes)1 Number of Concurrent VoiceMail and Auto Attendant Ports/Sessions Number of Scripts Number of PromptsSCUE-LIC-12CCM
SCUE-LIC-12CME100
353
8 (NM-CUE)
16 (NM-CUE-EC)8
50
SCUE-LIC-25CCM
SCUE-LIC-25CME100
171
8 (NM-CUE)
16 (NM-CUE-EC)8
50
SCUE-LIC-50CCM
SCUE-LIC-50CME100
92
8 (NM-CUE)
16 (NM-CUE-EC)8
50
SCUE-LIC-100CCM
SCUE-LIC-100CME100
50
8 (NM-CUE)
16 (NM-CUE-EC)8
50
1 The default mailbox size calculation includes the allocation for the General Delivery Mailboxes (GDMs).
Table 3 Maximum Number of Mailboxes, Groups, Owners, and Members on the NM-CUE and NM-CUE-EC
Cisco Unity Express License/Software SKU Default Number of Personal Mailboxes Default Number of General Delivery Mailboxes Total Number of Mailboxes Number of Groups1 Number of Owners1 Number of Members1SCUE-LIC-12CCM
SCUE-LIC-12CME12
5
17
20
400
880
SCUE-LIC-25CCM
SCUE-LIC-25CME25
10
35
20
400
1000
SCUE-LIC-50CCM
SCUE-LIC-50CME50
15
65
30
400
1000
SCUE-LIC-100CCM
SCUE-LIC-100CME100
20
100
40
400
1000
1 Per Cisco Unity Express system.
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)1 Default Mailbox Size (Minutes)2 Number of Concurrent VoiceMail and Auto Attendant Ports/Sessions Number of Scripts Number of PromptsSCUE-LIC-12CCM
SCUE-LIC-12CME14
45
4 (Cisco 2600XM, Cisco 2650XM,
Cisco 2651XM, Cisco 2691)
6 (Cisco 2800 series, Cisco 3700 series,
Cisco 3800 series)4
25
SCUE-LIC-25CCM
SCUE-LIC-25CME14
22
4 (Cisco 2600XM, Cisco 2650XM,
Cisco 2651XM, Cisco 2691)
6 (Cisco 2800 series, Cisco 3700 series,
Cisco 3800 series)4
25
SCUE-LIC-50CCM
SCUE-LIC-50CME14
12
4 (Cisco 2600XM, Cisco 2650XM,
Cisco 2651XM, Cisco 2691)
6 (Cisco 2800 series, Cisco 3700 series,
Cisco 3800 series)4
25
1 The storage value shown is for the AIM-CUE with the 1-GB compact flash. The earlier AIM-CUE version with the 512-MB compact flash supports 4.5 hours (270 minutes) of mailbox storage. To use Cisco Unity Express 2.1, Cisco recommends that older AIM-CUE modules with 512 MB compact be replaced with the 1-GB compact flash AIM-CUE module.
2 The default mailbox size calculation includes the allocation for the General Delivery Mailboxes (GDMs).
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 2.1/2.2 CLI Administrator Guide for Cisco CallManager.
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 2.1/2.2 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 "Overview of the Initialization Wizard" on page 23. 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 Releases 2.1 and 2.2 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.
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, 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 in the router containing the Cisco Unity Express module. Voice-mail and auto-attendant applications will function properly. Message waiting indicator (MWI) lights will not be updated. Once the WAN link becomes active, Cisco Unity Express will detect it and register back with the Cisco CallManager server.
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.
Additional References
The following sections provide references related to Cisco Unity Express.
Documents Related to Cisco Unity Express
Related Cisco IOS Documents
Related Topic Document TitleCisco IOS configuration
•
Cisco IOS Debug Command Reference, Release 12.4T
•
Cisco IOS Voice Command Reference
Note
For general voice configuration topics, refer to the Cisco IOS Voice Configuration Library, Release 12.4.
Cisco IOS configuration examples
Cisco Systems Technologies website at http://cisco.com/en/US/tech/index.html
Note
From the website, choose a technology category and subsequent hierarchy of subcategories, and then click Technical Documentation > Configuration Examples.
Cisco IOS voice troubleshooting information
Cisco IP Telephony
MIBs
MIBs MIBs Link•
CISCO-UNITY-EXPRESS-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
Technical Assistance
Posted: Fri Jan 13 04:20:19 PST 2006
All contents are Copyright © 1992--2006 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.