Networking Cisco Unity Express
Available Languages
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 Communications Manager or Cisco Unified Communications Manager 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 NM-CUE-EC supports a maximum of 100 remote subscribers, the NM-CUE 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 Communications Manager Express or Cisco Unified Communications Manager 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
Examples
The following example enables receipt of vCard information to network locations 23 and nyc:
se-10-0-0-0# config tse-10-0-0-0(config)# network location 23se-10-0-0-0(config-location)# voicemail vcardse-10-0-0-0(config-location)# endse-10-0-0-0(config)# network location nycse-10-0-0-0(config-location)# voicemail vcardse-10-0-0-0(config-location)# endse-10-0-0-0(config)# exitThe following command disables receipt of vCard information to network location nyc:
se-10-0-0-0# config tse-10-0-0-0(config)# network location nycse-10-0-0-0(config-location)# no voicemail vcardse-10-0-0-0(config-location)# endse-10-0-0-0(config)# exitDisplaying vCard Status
Several commands are available to display vCard status.
Displaying vCard Status For a Specific Location
The following Cisco Unity Express EXEC mode command displays details about a specific remote location:
show network detail location id location-id
where location-id is the remote location number.
The following example displays details about network location 15, which has vCard enabled:
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: enabledVPIM broadcast ID: vpim-broadcastSent msg count: 0Received msg count: 0Displaying vCard Status For the Local System
The following EXEC mode command displays details for the local Cisco Unity Express system:
show network detail local
The following example displays details for the local system with vCard enabled:
se-10-0-0-0# show network detail localLocation ID: 10Name: SanJoseCAAbbreviation: sjcEmail domain: sjc.mycompany.comMinimum extension length: 2Maximum extension length: 15Phone prefix:VPIM encoding: G726Send spoken name: enabledSend vCard: enabledState: enabledVPIM broadcast ID: vpim-broadcastConfiguring the LRU Cache
Cisco Unity Express supports a least recently used (LRU) cache that contains vCard information about remote subscribers. An LRU cache is a database of remote subscribers' first names, last names, and spoken names. These remote subscribers are not configured in the Remote User Directory. The subscribers contained in the cache are referred to as cached users.
Network messages update the contents of the LRU cache. When a local sender addresses a voice-mail message to a remote subscriber, the system accesses this information to send a spoken name confirmation about the remote subscriber to the local sender. Each time a network message arrives from a cached user or each time a local sender sends a voice message to a cached user, the system updates the timestamp of the cached user's entry in the LRU cache.
The maximum capacity of the LRU cache is 100 subscribes on the NM-CUE-EC, 50 subscribers on the NM-CUE, and 20 subscribers on the AIM-CUE. When the LRU cache reaches its maximum capacity, a new entry erases the existing entry with the oldest timestamp. This means that the next time a local sender calls a remote subscriber, the sender will not receive a spoken name confirmation if the remote subscriber is no longer in the LRU cache.
Do one or both of the following to avoid the inconsistent confirmation response:
•
•
The LRU cache contents are saved after system reloads.
By default, the LRU cache is enabled on the local system. Use the GUI Defaults > Voice Mail option or the CLI commands described below to change the status of the LRU cache.
The following sections describe this feature:
•
Enabling and Disabling the LRU Cache
Use the following Cisco Unity Express configuration mode command to enable the LRU cache on the local system:
remote cache enable
The following example illustrates enabling the LRU cache on the local system:
se-10-0-0-0# config tse-10-0-0-0(config)# remote cache enablese-10-0-0-0(config)# exitUse the following Cisco Unity Express configuration mode command to disable the LRU cache on the local system. Disabling the cache clears all cache entries and prevents storage of new subscriber entries.
no remote cache enable
The following example illustrates disabling the LRU cache on the local system:
se-10-0-0-0# config tse-10-0-0-0(config)# no remote cache enablese-10-0-0-0(config)# exitDisplaying LRU Cache Data
Use the following Cisco Unity Express EXEC mode command to display the local system's LRU cache data:
show remote cache
The system displays the location ID, location name , extension, and last accessed time for each cached user.
se-10-0-0-0# show remote cacheRemote user cache is enabledID LOCATION EXTENSION LAST ACCESSED TIME3014001 sjc 5555 Tue Sep 21 10:38:28 PDT 20046661005 nyc 1111 Tue Sep 21 14:55:11 PDT 2004Configuring the Broadcast Message VPIM ID for a Network Location
Use the following procedure to configure the VPIM ID for broadcast messages for a network location.
Required Data for This Procedure
•
•
SUMMARY STEPS
1.
2.
3.
4.
5.
DETAILED STEPS
Examples
The following example sets the VPIM ID to ny-270 for network location 150:
se-10-0-0-0# config tse-10-0-0-0(config)# network location id 150se-10-0-0-0(config-location)# voicemail broadcast vpim-id ny-270se-10-0-0-0(config-location)# endse-10-0-0-0(config)# exitTroubleshooting Commands
To troubleshoot network configuration in Cisco Unity Express, use the following commands in EXEC mode.
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
DETAILED STEPS
Feedback