Cisco Unity Express 2.3 CLI Administrator Guide
Configuration Tasks

Table Of Contents

Configuration Tasks

Configuring the System Using CLI Commands

Configuring the System Using the GUI

Initial Tasks

Ongoing Tasks

As-Needed Tasks


Configuration Tasks


Last Update: July 25, 2006

This chapter lists the tasks for configuring and maintaining Cisco Unity Express and contains the following sections:

Configuring the System Using CLI Commands

Configuring the System Using the GUI

Initial Tasks

Ongoing Tasks

As-Needed Tasks

Configuring the System Using 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" on page 19. Proceed with the scripts, using the sections in this chapter 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

The Cisco Unity Express GUI provides the initialization wizard software tool to configure the basic system parameters and import any subscribers configured on Cisco Unified CallManager or Cisco Unified CME.

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. See "Configuring the System for the First Time," in the Cisco Unity Express 2.3 GUI Administrator Guide for more information about the initialization wizard.

Initial Tasks

Table 8 lists the initial configuration tasks, the section describing each procedure, and additional information needed for each task.

Table 8 Configuration Task Sequence  

Task and Procedure Location
Additional Information Needed

1. Configuring the SIP Proxy Server Location for Cisco Unity Express, page 34

Hostname or IP address of the SIP proxy server.

UDP or TCP port on the SIP proxy server.

2. Configuring the Call Transfer Mode, page 36

Select a transfer mode: attended, semi-attended, or blind.

3. Configuring DTMF Options, page 38

Select a DTMF relay option: rtp-nte, sub-notify, sip-notify, or info.

4. Configuring the MWI Notification Option, page 41

Choose an MWI notification option: outcall, sub-notify, or unsolicited.

5. Configuring the MWI Notification Option, page 41

MWI on and off extension numbers.

Cisco Unity Express uses these extensions with the affected telephone extension to generate a SIP call to Cisco Unified CME, which changes the status of the telephone's MWI light.

6. Configuring Cisco Unified CME SIP Options for RFC Compliance, page 46

Cisco IOS software release running on the Cisco Unified CME platform.

7. Configuring JTAPI Parameters (Cisco Unified CallManager Only), page 48

IP address or hostname for the primary, secondary, and tertiary Cisco Unified CallManager servers

JTAPI user ID and password from Cisco Unified CallManager. The password is case sensitive. These values must match the JTAPI user ID and password that were configured on Cisco Unified CallManager.

List of CTI ports

8. Configuring the Voice-Mail Application, page 52

Maximum number of subscribers 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 "Software Licenses and Factory-Set Limits" on page 9 for this maximum number.

Telephone number to access the voice-mail system.

9. Configuring the Administration via Telephone Application, page 55

Telephone number for accessing the Administration via Telephone (AvT).

10. Configuring and Managing the Auto-Attendant Application, page 55

To use your own welcome greeting, create a .wav file that contains the prerecorded welcome greeting. This file must be uploaded to the Cisco Unity Express module so that it can be located and saved in the auto-attendant script. Alternatively, you can use the AvT to record the welcome greeting. See "Recording an Auto-Attendant Greeting or Prompt File" on page 61 and "Uploading the Auto-Attendant Script File" on page 63 for guidelines on recording and uploading 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 "Software Licenses and Factory-Set Limits" on page 9 for this maximum number.

11. Configuring Auto-Attendant Prompts, page 60

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

Prompt filenames.

12. Configuring Auto-Attendant Scripts, page 63

Preconfigured script files. Use the Cisco Unity Express script editor to create the files. See the Cisco Unity Express 2.3 Guide to Writing Auto-Attendant Scripts for more information.

Script filenames.

13. Configuring SIP Triggers for the Applications, page 64

Telephone number that invokes the application. This number must be different for voice-mail, auto-attendant, and AvT.

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 "Software Licenses and Factory-Set Limits" on page 9 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.

14. Configuring JTAPI Triggers for the Applications (Cisco Unified CallManager Only), page 66

Telephone number that invokes the application. The number must not be the same for both voice mail and auto attendant.

Number of seconds the system must wait for a caller response before it times out and drops the call.

Language to use for the prompts. Cisco Unity Express supports several languages. Only one can be installed on the system. See the Release Notes for Cisco Unity Express 2.3 for a list of available languages.

Maximum number of callers that can access the trigger simultaneously. See the "Sharing Ports Among Applications and Triggers" section on page 52 for guidelines on assigning this value.

15. (Optional) Configuring System-Wide Voice-Mail Parameters, page 77

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. Cisco Unity Express supports several languages. Only one can be installed on the system. See the Release Notes for Cisco Unity Express 2.3 for a list of available languages.

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 subscriber's recorded mailbox greeting.

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

Destination mailbox for forwarded calls—Choose either the original called number or last redirected number where you want to store the voice message of a forwarded call.

16. (Optional) Configuring System-Wide Voice-Mail Parameters, page 77

Turn this feature on or off.

17. Configuring Password and PIN Parameters, page 82

Password length and expiry time

PIN length and expiry time

18. (Optional) Configuring a Holiday List, page 85

Month, day, year, and description of each holiday.

19. (Optional) Configuring Business Hours, page 89

Schedule name

The maximum length of the name is 31 alphanumeric characters, including uppercase letters A to Z, lowercase letters a to z, digits 0 to 9, underscore (_), and dash (-). The first character of the name must be a letter.

If a schedule with this name does not exist, the system will create it. If the schedule already exists, any changes will modify the schedule. If the maximum number of schedules exists and you request another one, the system displays an error message.

Day of the week

Starting and ending clock times when the business is open and when the business is closed

Use the 24-hour clock format for the hours. Valid minute values are 00 and 30 only.

For a new schedule, specify the closed hours; the remaining hours are open because a newly created schedule has 24 hours open each day by default.

20. Adding and Modifying a User, page 98

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

(Optional) Group—Name of a group in which this subscriber is a member.

Extension—Phone extension for the subscriber.

If you create a subscriber or group with the CLI, you may choose to provide a password and PIN.

Password—Password for this subscriber for accessing the Cisco Unity Express GUI.

PIN—Personal identification number for this subscriber for accessing the Cisco Unity Express telephone user interface (TUI).

21. Adding and Modifying a Group, page 104

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 subscriber must access a general delivery mailbox (GDM), the subscriber must have a personal mailbox assigned first.

22. Configuring Mailboxes, page 114

Mailbox owner

(Optional) Mailbox size—Total number of seconds from all messages stored in a subscriber's voice mailbox.

(Optional) Message storage time—Number of days that the system will save old messages.

(Optional) Message length—Maximum number of seconds for any message stored in a voice mailbox.

(Optional) Telephone numbers for the voice-mail system, auto-attendant, and operator extension.

23. (Optional) Configuring SNMP Monitoring, page 137

SNMP community strings (passwords) that permit users to read and write SNMP MIB objects (variables). Specify whether these community strings will have read-only or read-write privileges. The system supports a maximum of 5 read-only community strings and 5 read-write community strings. Each community string may have a maximum of 15 alphanumeric characters, including letters A to Z, letters a to z, digits 0 to 9, underscore (_), and hyphen (-).

IP address and community string of the host server that will receive SNMP traps from Cisco Unity Express. If no host is defined, the system discards the trap. The system supports a maximum of 5 hosts (trap receivers).

No host is considered the primary host. The system sends the SNMP notifications to all enabled hosts.

(Optional) SNMP server contact information for this managed node.

(Optional) SNMP server location information for this managed node.

Threshold values for the following activities:

Entering a login user name.

Entering a password.

Entering a personal identification number (PIN) user ID.

Entering a PIN password.

Resetting a PIN.

24. (Optional) Configuring Integrated Messaging, page 153

Maximum number of simultaneous IMAP client sessions permitted by the Cisco Unity Express IMAP server. The default is 50 concurrent sessions.

Number of minutes an IMAP session can be idle after which the system automatically logs out the session.

Type of connections that are permitted. Options include SSL only, non-SSL only, or both SSL and non-SSL. The default is non-SSL only.

Note The system must have a default security certificate and private key before SSL connections are permitted on Cisco Unity Express. Use the show crypto key command to display the system default certificate-key pair. If no default certificate-key pair exists, follow the procedure in "Configuring Security" on page 133.

Name of the group with the privilege to use IMAP.

25. Configuring Integrated Messaging, page 153

Integrated Messaging is disabled by default. Enable it to use its capabilities.

26. (Optional) Configuring Message Notification, page 159

System-wide parameters:

User IDs or group names if a subset of subscribers or groups will have access to message notification

Notification preference

Number of seconds for the connection timeout

If you want to add phone numbers to the restriction table:

Minimum and maximum number of digits in a dial-string

At least one dial-string pattern

SMTP server hostname and authentication values (user ID and password or credential string)

Permission for subscribers to log into their voice mailboxes during notification calls

Permission for subscribers to attach voice messages to e-mail messages

Subscriber or group parameters for cell phones, home phones, work phones, or numeric pagers:

Phone number

Extra digits, if any

Notification preference

Days and times when notification is active

E-mail parameters:

E-mail address

Status of attaching voice messages to e-mail notifications

Message text

Notification preference

Days and times when notification is active

Text message parameters:

E-mail address

Message text

Notification preference

Days and times when notification is active

27. (Optional) Configuring VoiceView Express, page 189

For Cisco Unified CallManager systems: ensure that all phones configured to use VoiceView Express are controlled by the JTAPI user configured on Cisco Unity Express.

For Cisco Unified CME systems: ensure that the Cisco Unified CME authentication server URL points to Cisco Unity Express.

Number of minutes a VoiceView Express session can be inactive before the system disconnects the session.

(Optional) URL for the fallback authentication server (for Cisco Unified CME systems)

28. (Optional) Configuring Network Locations, page 219

Network location ID number—Unique ID number for each location used by the voice-mail sender to send a remote message. The maximum length of the number is 7 digits. Cisco Unity Express supports a maximum of 500 locations.

E-mail domain name—E-mail domain name or IP address for the local Cisco Unity Express system that is attached to the local voice-mail originator's extension when sending a VPIM message. The local system's e-mail domain name must be configured to receive remote voice-mail messages.

(Optional) Location name—Descriptive name of the network location.

(Optional) Abbreviated location name—Abbreviated description of the network location.

(Optional) Voice-mail system telephone number prefix—Phone number prefix that is added to a local voice-mail originator's extension to create a VPIM address. A prefix is required only if an e-mail domain services multiple locations, and extensions between the locations are not unique. The maximum length of the prefix is 15 digits.

(Optional) Length of the voice-mail system extensions.

(Optional) VPIM encoding scheme—Encoding scheme options for translating voice-mail messages at the local Cisco Unity Express system are dynamic, G.711ulaw, or G.726.

(Optional) Voice-mail spoken name capability—Enabling this functionality permits receipt of a voice-mail originator's spoken name, which is played at the beginning of the received voice-mail message.

29. (Optional) Configuring Distribution Lists, page 121

The following information is required to create a public distribution list:

List name and number

(Optional) List owner

(Optional) List description—The description can have a maximum of 64 characters.

The following information is required to add members to a distribution list:

Member type (user, group, GDM, list, remote, or blind)

Member name or extension


Note Local and remote subscribers must be previously defined on the system.



Ongoing Tasks


Perform the tasks listed in Table 9 on a regular basis.

As-Needed Tasks

Perform the tasks listed in Table 10 on an as-needed basis.

Table 10 As-Needed Configuration Tasks

Task
Location

Add, display, modify, and delete voice mailboxes.

Configuring Mailboxes, page 114

Unlock a voice mailbox.

Unlocking a Voice Mailbox, page 119

Add, display, modify, and delete subscribers.

Adding and Modifying a User, page 98

Add, display, modify, and delete groups.

Adding and Modifying a Group, page 104

Change a subscriber's voice-mail password.

Adding and Modifying a User, page 98

Change the voice mailbox size or storage time.

Configuring System-Wide Voice-Mail Parameters, page 77

Modify the auto-attendant application properties.

Configuring and Managing the Auto-Attendant Application, page 55

Add, modify, and delete the auto-attendant prompts.

Configuring Auto-Attendant Prompts, page 60

Add, modify, and delete the auto-attendant scripts.

Configuring Auto-Attendant Scripts, page 63

Troubleshoot software problems.

Troubleshooting Guidelines, page 269



Tip Bookmark the Cisco Unity Express documentation home page for easy access to all the documents. Print out and have available the documentation for these Ongoing and As-Needed tasks.