-
Cisco Unity Express 2.3 CLI Administrator Guide
-
Cisco Unity Express Features
-
Overview of Cisco Unity Express Voice Mail and Auto Attendant
-
Entering and Exiting the Command Environment
-
Configuration Tasks
-
Configuring System Components
-
Configuring Users and Groups
-
Configuring Mailboxes
-
Configuring Distribution Lists
-
Configuring Security
-
Configuring SNMP Monitoring
-
Configuring Broadcast Messages
-
Configuring Integrated Messaging
-
Configuring Message Notification
-
Configuring VoiceView Express
-
Advanced Configuration
-
Networking Cisco Unity Express
-
Monitoring the System
-
Backing Up and Restoring Data
-
Troubleshooting
-
Index
-
Table Of Contents
Networking Cisco Unity Express
Overview of Cisco Unity Express Networking
Spoken Name Confirmation for Remote Subscribers
Required Data for This Procedure
Downloading and Uploading Network Location Spoken Names
Required Data for This Procedure
Downloading the Location Spoken Name
Uploading the Location Spoken Name
Adding Remote Subscribers to the Local Directory
Configuring the Local Directory with Remote Subscribers
Displaying All Remote Subscribers
Displaying a Specific Remote Subscriber
Deleting Remote Subscriber Information
Deleting a Remote Subscriber Entry in Local Directory
Downloading and Uploading Remote Subscriber Spoken Names
Required Data for This Procedure
Downloading the Remote Subscriber Spoken Name
Uploading the Remote Subscriber Spoken Name
Configuring Caller ID for Incoming Messages
Enabling Caller ID on the Local System
Disabling Caller ID on the Local System
Configuring a Location with vCard Information
Enabling and Disabling vCard Information
Displaying vCard Status For a Specific Location
Displaying vCard Status For the Local System
Enabling and Disabling the LRU Cache
Configuring the Broadcast Message VPIM ID for a Network Location
Required Data for This Procedure
Networking Cisco Unity Express
Last Updated: July 25, 2006
This chapter describes the procedures for configuring the networking capability on the local Cisco Unity Express voice-mail system and contains the following sections:
•
Overview of Cisco Unity Express Networking
•
•
•
•
•
•
•
Overview of Cisco Unity Express Networking
Cisco Unity Express supports the Voice Profile for Internet Mail (VPIM) version 2 protocol to permit voice-mail message networking between Cisco Unity Express and Cisco Unity voice-mail systems that are not co-located on the same router or server. The voice-mail systems can reside on Cisco Unified CallManager or Cisco Unified CallManager Express call control platforms. Supported networked voice-mail configurations include:
•
•
•
Cisco Unity Express must be installed and configured at each remote location.
Cisco Unity 4.0.4 is supported. You must configure VPIM networking on Cisco Unity, including the primary location for Cisco Unity and the delivery locations for remote Cisco Unity Express locations. See the documentation in the "Additional References" section on page 14 for more information.
Types of Remote Addressing
Cisco Unity Express supports the following types of remote addressing:
•
•
Blind Addressing
A subscriber can send a message to another subscriber on a remote location, which must be configured on the local (sender's) system. The sender addresses the message using the location ID of the remote system plus the recipient's extension number at the remote location.
When the message is sent to the remote subscriber, the sender will not hear a confirmation of the recipient's name or extension. This is blind addressing.
Spoken Name Confirmation for Remote Subscribers
Administrators can assign user IDs and extensions in the local Cisco Unity Express directory for subscribers at existing remote locations. Additionally, administrators or other privileged subscribers can record spoken names for these subscribers using the Administration via Telephone (AvT) feature.
If the local system has vCard information enabled, incoming vCard information updates the remote subscriber information on the local system. The vCard information may contain the remote subscriber's first name, last name, and spoken name. This information is stored in the least recently used (LRU) cache.
A sender on the local system can address a message to a remote subscriber using dial-by-name or dial-by-extension. If a spoken name for the recipient is recorded, the sender hears the spoken name as confirmation. If the recipient does not exist in the local directory but is in the LRU cache, the sender hears the LRU cache information as confirmation. If the remote subscriber is not in the directory or the cache, the sender receives the recipient's location ID and extension.
Delivery Notifications
Cisco Unity Express supports the following message delivery notification types:
•
•
Non-Delivery Receipt (NDR)
If the system cannot deliver a message to a remote site after 6 hours, the local sender receives a non-delivery receipt (NDR) indicating the message was not sent or that the message was not delivered to the recipient's mailbox.
This receipt indicates the reason for nondelivery. If nondelivery is due to the recipient's mailbox being full, nonexistent, or disabled, the nondelivery message includes the sender's original message. When the sender plays the NDR, the sender can readdress and resend the original message or delete the message.
Each NDR counts against the sender's mailbox capacity.
Delayed Delivery Record (DDR)
Cisco Unity Express sends a delayed delivery record (DDR) to the local sender's mailbox after 60 minutes of trying to deliver the original message. Unlike the NDR, the DDR does not contain the original message as an attachment and does not count against the sender's mailbox capacity.
The DDR cannot be saved, only deleted.
The system stores only one copy of a DDR for a particular message in the sender's mailbox. The sender must delete the existing DDR in order to receive an updated DDR for the same message.
Configuring Network Locations
Follow this procedure to configure the network locations.
Prerequisites
•
•
•
Required Data for This Procedure
The following information is required to configure networking on Cisco Unity Express:
•
Note
•
•
•
•
•
•
•
•
•
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
DETAILED STEPS
Examples
The following examples illustrate the output from the show network commands on company Mycompany's call control system in San Jose with remote voice-mail provided by six remote Cisco Unity Express sites.
se-10-0-0-0# show network locationsID NAME ABBREV DOMAIN101 'San Jose' SJC sjc.mycompany.com102 'Dallas/Fort Worth' DFW dfw.mycompany.com201 'Los Angeles' LAX lax.mycompany.com202 'Canada' CAN can.mycompany.com301 'Chicago' CHI chi.mycompany.com302 'New York' NYC nyc.mycompany.com401 'Bangalore' BAN bang.mycompany.comse-10-0-0-0# show network detail location id 102Name: Dallas/Fort WorthAbbreviation: DFWEmail domain: dfw.mycompany.comMinimum extension length: 2Maximum extension length: 15Phone prefix:VPIM encoding: G726Send spoken name: enabledSent msg count: 10Received msg count: 110se-10-0-0-0# show network detail localLocation Id: 101Name: San JoseAbbreviation: SJCEmail domain: sjc.mycompany.comMinimum extension length: 2Maximum extension length: 15Phone prefix:VPIM encoding: dynamicSend spoken name: enabledThe following example illustrates output from the show network queues command. The output includes the following fields:
•
•
•
se-10-0-0-0# show network queuesRunning Job Queue=================ID TYPE TIME RETRY SENDER RECIPIENT107 VPIM 06:13:26 20 jennifer 1001@sjc.mycompany.com106 VPIM 06:28:25 20 jennifer 1001@sjc.mycompany.comUrgent Job Queue=================ID TYPE TIME RETRY SENDER RECIPIENT123 VPIM 16:33:39 1 andy 9003@lax.mycompany.comNormal Job Queue=================ID TYPE TIME RETRY SENDER RECIPIENT122 VPIM 16:33:23 1 andy 9001@lax.mycompany.com124 VPIM 16:34:28 1 andy 9003@lax.mycompany.com125 VPIM 16:34:57 1 andy 9002@lax.mycompany.com126 VPIM 16:35:43 1 andy 9004@lax.mycompany.comDisabling a Network Location
Cisco Unity Express supports disabling a location in the Cisco Unity Express network from sending or receiving Cisco Unity Express voice-mail messages. The system does not delete the network location from the Cisco Unity Express database.
To reestablish voice-mail message transmission to and from the network location, use the enable command.
Note
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
DETAILED STEPS
Examples
The following example displays the details for network location 15 with networking disabled:
se-10-0-0-0# config tse-10-0-0-0(config)# network location id 15se-10-0-0-0(config-location)# no enable!!!WARNING!!!:Disabling location will disablenetworking to/from this location.Do you wish to continue[n]?:yse-10-0-0-0(config-location)# endse-10-0-0-0(config)# exitse-10-0-0-0#se-10-0-0-0# show network detail location id 15Name: houstonAbbreviation: houEmail domain: hou.mycompany.comMinimum extension length: 2Maximum extension length: 15Phone prefix: 4VPIM encoding: dynamicSend spoken name: enabledSend vCard: enabledState: disabledVPIM broadcast ID: vpim-broadcastSent msg count: 1Received msg count: 1The following example re-establishes voice-mail transmission to and from network location 15.
se-10-0-0-0# config tse-10-0-0-0(config)# network location id 15se-10-0-0-0(config-location)# enablese-10-0-0-0(config-locationDownloading and Uploading Network Location Spoken Names
Use the Administration via Telephone (AvT) options to record the spoken names. You can download these spoken names from a Cisco Unity Express module to an external server or upload them from an external server to a Cisco Unity Express module.
The following sections describe this feature:
•
•
•
Required Data for This Procedure
•
•
•
Downloading the Location Spoken Name
To download the network location spoken name, use the following command in Cisco Unity Express EXEC mode:
network copy spokenname url url location id location-id loginname server-login password server-password
where the command arguments are defined as:
url
URL to the spoken name file on the server.
location-id
Network location ID.
server-login
Server login.
server-password
Server password.
The following example uploads the spoken name file rename.wav for location 500:
se-10-0-0-0# network copy spokenname url ftp://10.4.51.66/rename.wav location id 500 loginname admin password testUploading the Location Spoken Name
To upload the network location spoken name, use the following command in Cisco Unity Express EXEC mode:
network copy spokenname location id location-id url url loginname server-login password server-password
where the command arguments are defined as:
location-id
Network location ID.
url
URL to the spoken name file on the server.
server-login
Server login.
server-password
Server password.
The following example uploads the spoken name file rename.wav for location 500:
se-10-0-0-0# network copy spokenname location id 500 url ftp://10.4.51.66/rename.wav loginname admin password test)# endse-10-0-0-0(config)# exitAdding Remote Subscribers to the Local Directory
Cisco Unity Express permits the addition of remote subscribers to the local voice- mail directory.
The local Cisco Unity Express directory allows inclusion of frequently addressed remote subscribers. This capability allows a local voice-mail sender to address a remote recipient using dial-by-name. Additionally, the system provides the sender with a spoken name confirmation of the remote recipient so that the sender can verify that the name and location are correct.
Regardless of the license level, the CUE-NM-EC supports a maximum of 100 remote subscribers, the CUE-NM supports a maximum of 50 remote subscribers, and the AIM-CUE supports a maximum of 20 remote subscribers.
Use the AvT to record the spoken name for the remote subscribers. If a remote subscriber does not have a spoken name recorded, the system uses the remote extension number and location as confirmation to the local sender.
If the vCard option is configured, the remote subscriber's vCard updates the local system with the remote subscriber's first name, last name, or extension.
The following sections describe this feature:
•
•
•
Configuring the Local Directory with Remote Subscribers
Configuring remote subscribers requires the following procedures:
•
CLI commands exist to configure the local and remote sites in the system. GUI screens are available to configure the location parameters.
•
See the chapter "Configuring a Location with vCard Information" for that procedure.
•
This section describes this procedure.
•
The administrator uses the TUI to record a spoken name for the remote subscriber and a spoken name for the remote location.
Configuring the remote subscriber can be done in the Cisco Unity Express configuration mode and the EXEC mode. Both modes permit adding the remote subscriber to the local directory but have different capabilities for other subscriber information. Use the remote username location command once, in either mode, to associate the remote subscriber with a network location.
Configuration Mode
Use this Cisco Unity Express configuration mode procedure to configure remote subscribers on the local system.
Required Data for This Procedure
The following information is required to configure remote subscribers on the local system:
•
•
•
SUMMARY STEPS
1.
2.
3.
4.
DETAILED STEPS
EXEC Mode
Use this Cisco Unity Express EXEC mode procedure to configure remote subscribers on the local system.
Required Data for This Procedure
The following information is required to configure remote subscribers on the local system:
•
•
•
SUMMARY STEPS
1.
2.
3.
4.
DETAILED STEPS
Examples
The following example configures several remote subscribers.
se-10-0-0-0# config tse-10-0-0-0(config)# remote username user2 location sjc createse-10-0-0-0(config)# remote username user2 phonenumber 84444se-10-0-0-0(config)# remote username user5 location sjc createse-10-0-0-0(config)# remote username user5 phonenumber 81111se-10-0-0-0(config)# remote username user3 location nyc createse-10-0-0-0(config)# remote username user3 phonenumber 92222se-10-0-0-0(config)# remote username user4 location nyc createse-10-0-0-0(config)# remote username user4 phonenumber 93333se-10-0-0-0(config)# endse-10-0-0-0# remote username user2 fullname display "User 2"se-10-0-0-0# remote username user2 fullname first Userse-10-0-0-0# remote username user2 fullname last 2se-10-0-0-0# remote username user5 fullname display "User 5"se-10-0-0-0# remote username user5 fullname first Userse-10-0-0-0# remote username user5 fullname last 5se-10-0-0-0# remote username user3 fullname display "User" 3se-10-0-0-0# remote username user3 fullname first Userse-10-0-0-0# remote username user3 fullname last 3se-10-0-0-0# remote username user4 fullname display "User 4"se-10-0-0-0# remote username user4 fullname first Userse-10-0-0-0# remote username user4 fullname last 4se-10-0-0-0#Displaying Remote Subscribers
Several commands are available to display remote subscribers.
Displaying All Remote Subscribers
The following command displays all remote subscribers configured on the local system:
show remote users
The output for this command may appear similar to the following:
se-10-0-0-0# show remote usersuser2user5user3user4Displaying a Specific Remote Subscriber
The following command displays the details for a specific remote subscriber:
show remote user detail username username
where username is the specific remote subscriber.
The output for this command may appear similar to the following:
se-10-0-0-0# show remote user detail username user2
Full Name: User 2First Name: UserLast Name: 2Nick Name:Extension: 84444Location Id: sjcDeleting Remote Subscriber Information
Several commands are available to delete remote subscriber information from the local directory.
Deleting an Extension Number
The following configuration mode command deletes a remote subscriber's extension number:
no remote username username phonenumber extension-number
where username is the name of the remote subscriber and extension-number is the remote subscriber's extension.
The following example deletes extension 75555 from remote subscriber User 2:
se-10-0-0-0# config tse-10-0-0-0(config)# no remote username user2 phonenumber 84444se-10-0-0-0(config)# endDeleting a Remote Subscriber Entry in Local Directory
The following EXEC mode command deletes the remote subscriber from the local directory:
remote username username delete
where username is the name of the remote subscriber.
The following example deletes the remote subscriber User 2:
se-10-0-0-0# remote username user2 deleteDeleting a Remote Username
The following EXEC mode commands delete the remote subscriber's name:
no remote username username fullname display display-name
no remote username username fullname first first-name
no remote username username fullname last last-name
where username is the name of the remote subscriber, display-name is the remote subscriber's display name, first-name is the remote subscriber's first name, and last-name is the remote subscriber's last name.
The following example deletes the display name from remote subscriber User 2:
se-10-0-0-0# no remote username user2 fullname display "User 2"The following example deletes the first name from remote subscriber User 2:
se-10-0-0-0# no remote username user2 fullname first UserThe following example deletes the last name from remote subscriber User 2:
se-10-0-0-0# no remote username user2 fullname last 2Downloading and Uploading Remote Subscriber Spoken Names
Use the Administration via Telephone (AvT) options to record the spoken names. You can download these spoken names from the Cisco Unity Express module to an external server or upload the names from an external server to the Cisco Unity Express module.
The following sections describe this feature:
•
•
•
Required Data for This Procedure
•
•
•
Downloading the Remote Subscriber Spoken Name
To download the remote subscriber spoken name, use the following command in Cisco Unity Express EXEC mode:
remote copy spokenname url url username username loginname server-login password server-password
where the command arguments are defined as:
url
URL to the spoken name file on the server.
username
Remote subscriber ID.
server-login
Server login.
server-password
Server password.
The following example uploads the spoken name file user1.wav for remote subscriber user1:
se-10-0-0-0# remote copy spokenname url ftp://10.4.51.66/user1.wav username user1 loginname admin password testUploading the Remote Subscriber Spoken Name
To upload the network location spoken name, use the following command in Cisco Unity Express EXEC mode:
remote copy spokenname username username url url loginname server-login password server-password
where the command arguments are defined as:
username
Remote user ID.
url
URL to the spoken name file on the server.
server-login
Server login.
server-password
Server password.
The following example uploads the spoken name file user1.wav for remote subscriber user1:
se-10-0-0-0# remote copy spokenname username user1 url ftp://10.4.51.66/user1.wav loginname admin password testConfiguring Caller ID for Incoming Messages
Cisco Unity Express supports caller ID information for incoming voice-mail messages.
When receiving an incoming voice-mail message from an external caller, the system attempts to match the associated caller ID information with an entry in the local directory. If a match is not found and the system is configured to play caller ID information, the system plays the sender's telephone number in the message envelope when the recipient listens to that message. If the system is not configured to play caller ID information, the system plays "Unknown Caller" in the message envelope.
Cisco Unity Express does not verify that the caller ID information is valid. That function is dependent on the central office (CO) and the incoming trunk setup. Additionally, the local system plays caller ID information for Cisco Unified CallManager Express or Cisco Unified CallManager extensions that are not configured in the local Cisco Unity Express directory.
The default caller ID status is disabled. Use the GUI Defaults > Voice Mail option or the CLI command described below to enable or disable playing of caller ID information.
Note
The following sections describe this feature:
•
•
Enabling Caller ID on the Local System
Use the following Cisco Unity Express configuration mode command to enable the playing of caller ID information in the message envelope of incoming external calls.
voicemail callerid
The following example illustrates enabling caller ID information on local system:
se-10-0-0-0# config tse-10-0-0-0(config)# voicemail calleridse-10-0-0-0(config)# exitDisabling Caller ID on the Local System
Use the following Cisco Unity Express configuration mode command to disable the playing of caller ID information in the message envelope of incoming external calls.
no voicemail callerid
The following example illustrates disabling caller ID information on local system:
se-10-0-0-0# config tse-10-0-0-0(config)# no voicemail calleridse-10-0-0-0(config)# exitConfiguring a Location with vCard Information
Cisco Unity Express supports sending and receiving vCard information in voice-mail messages. A remote subscriber's vCard information contains the subscriber's first name, last name, and extension. Cisco Unity Express uses the vCard information from incoming voice profile for Internet mail (VPIM) messages and the recorded spoken name to populate and update a least recent used (LRU) cache with the remote subscriber information. (For more information about configuring the spoken name, see "Adding Remote Subscribers to the Local Directory".)
When addressing a message to a remote subscriber, the local sender hears the spoken name as a confirmation of the intended recipient. The LRU cache is a source of the spoken name.
The maximum length of the LRU cache is 100 subscribers on the NM-CUE-EC, 50 subscribers on the NM-CUE, and 20 subscribers on the AIM-CUE.
The following sections describe this feature:
•
Enabling and Disabling vCard Information
The remote location numeric ID is required to enable the location to receive vCard information.
The system default is to send the vCard information.
SUMMARY STEPS
1.
2.
3.
4.
5.
DETAILED STEPS
