Table Of Contents
VoiceView Express Session Count
Configuring Cisco Unified Communications Manager for VoiceView Express
Configuring Cisco Unified Communications Manager Express for VoiceView Express
Required Data for This Procedure
Configuring the Phone-Authentication Service
Required Data for This Procedure
Displaying and Terminating VoiceView Express Sessions
Configuring VoiceView Express
Last Updated: July 25, 2006
This chapter describes the procedures for configuring VoiceView Express on Cisco Unity Express and includes the following sections:
•
Overview of VoiceView Express
•
Configuring VoiceView Express
•
Configuring the Phone-Authentication Service
To configure this feature from the GUI, use the Voice Mail > VoiceView Express option.
Overview of VoiceView Express
The VoiceView Express feature allows voice-mail subscribers to browse, listen, send messages, and manage their voice mail messages from their Cisco IP phone display and soft keys. This feature is an alternative to the telephone user interface (TUI) for performing common tasks.
VoiceView Express is available on the Cisco advanced integration module (AIM) and on the network modules NM-CUE and NM-CUE-EC.
VoiceView Express is available for Cisco Unified Communications Manager Express and Cisco Unified Communications Manager systems. VoiceView is not available in Cisco Unified Communications Manager SRST mode.
Only Cisco IP phones 7940, 7941, 7960, 7961, 7970, and 7971 support VoiceView Express.
VoiceView Express is enabled by default.
For details on using the VoiceView Express features, see the Cisco Unity Express VoiceView Express Quick Start Guide- Release 3.1.
VoiceView Express Session Count
The maximum number of simultaneous VoiceView Express sessions depends on the size of the nerwork modules:
•
NM-CUE (256-MB): 8 sessions
•
NM-CUE-EC (512-MB): 16 sessions
•
NME-CUE: 24 sessions
•
AIM (1-GB): 3 sessions
The system counts VoiceView Express sessions separately from graphical user interface (GUI) sessions.
When a subscriber is listening to or recording a voice message or greeting with VoiceView Express, the system counts the session as a VoiceView Express session and a TUI session.
If the subscriber is browsing through voice messages on the VoiceView Express phone screen, the system counts the session as a VoiceView Express session.
Configuring Cisco Unified Communications Manager for VoiceView Express
The VoiceView Express service URL configured on Cisco Unified Communications Manager must be as follows: http://Cisco-Unity-Express-hostname/voiceview/common/login.do.
The Cisco Unified Communications Manager administrator must ensure that all phones configured to use VoiceView Express are owned by the JTAPI user configured on Cisco Unity Express. VoiceView Express uses the JTAPI username and password to become a trusted phone client. Use the following procedures to add the VoiceView Express service to the phones:
1.
Create an IP phone service—In the Cisco Unified Communications Manager administration screen, click Feature > Cisco IP Phone Services. Click Add a New IP Phone Service. Enter the name that you want the voice-mail subscribers to see on their phone screens. Enter the description that you want to appear on the subscribers's phone message when they subscribe to VoiceView Express. Enter the IP phone service URL described above. Click Insert.
2.
Add the IP phone service to a phone— Locate a phone in the Cisco Unified Communications Manager system. Click on the phone to open the phone's configuration page. Click Subscribe/Unsubscribe Services in the upper-right corner of the screen. In the drop-down menu, find the IP phone service name that you created earlier. Click Continue. Click Subscribe.
3.
Assign the phone to the JTAPI user—Go to the JTAPI user's configuration page. Click Device Association. Associate the phone as a controlled device.
4.
Repeat procedures 2 and 3 for each phone that requires VoiceView Express service.
Configuring Cisco Unified Communications Manager Express for VoiceView Express
The Authentication Manager is a network server that handles authentication requests for IP phone tasks. The IP phone learns the authentication server URL during the phone's registration process.
Cisco Unified Communications Manager Express (Cisco Unified CME) does not have an authentication server. Cisco Unity Express starts an authentication server that acts as the primary authentication server for VoiceView Express.
The Cisco Unified CME administrator must ensure that Cisco Unified CME authentication server URL points to Cisco Unity Express authentication server. The URL format is http://Cisco-Unity-Express-hostname/voiceview/authentication/authenticate.do.
![]()
Note
To activate the URL configuration, reboot the phones.
Session Termination
The administrator can configure the maximum number of minutes a VoiceView Express session can remain idle. The timeout is a system-wide parameter and cannot be configured for individual subscribers or groups. The default limit per session is 5 minutes.
Active VoiceView Express sessions are terminated under the following scenarios:
•
A new TUI or VoiceView Express session preempts and terminates an existing VoiceView Express session.
•
An active VoiceView Express session can be terminated using the CLI command service voiceview session terminate mailbox-id in Cisco Unity Express EXEC mode. See "Monitoring Active IMAP and VoiceView Express Sessions" on page 318 for more information.
Configuring VoiceView Express
Use the following procedure to configure system-wide VoiceView Express parameters.
VoiceView Express is enabled by default.
Prerequisites
•
For Cisco Unified Communications Manager systems: ensure that all phones configured to use VoiceView Express are owned by the JTAPI user configured on Cisco Unity Express.
•
For Cisco Unified Communications Manager Express systems: ensure that the Cisco Unified Communications Manager Express authentication server URL points to Cisco Unity Express.
Required Data for This Procedure
Number of minutes a VoiceView Express session can be inactive before the system disconnects the session.
SUMMARY STEPS
1.
config t
2.
service voiceview
3.
enable
4.
session idletimeout minutes
5.
end
6.
end
7.
(Optional) show voiceview configuration
8.
(Optional) show voiceview sessions
DETAILED STEPS
Examples
The following is sample output for the show voiceview configuration command:
se-10-0-0-0# show voiceview configurationPhone service URL: http://<CUE-hostname>/voiceview/common/login.doEnabled: YesIdle Timeout (minutes): 10The following is sample output for the show voiceview sessions command:
se-10-0-0-0# show voiceview sessionsMailbox RTP User ID Phone MAC Address1013 Yes user1 0015.C68E.6C1E1016 No user5 0015.629F.87061015 No user3 0015.63EE.37901014 Yes user6 0015.629F.888B1009 No user9 0015.6269.57D21012 No user10 0016.4676.4FCA1001 No user8 0009.B7F7.57031004 Yes user11 000C.30DE.5EA88 session(s)3 active RTP stream(s)
Configuring the Phone-Authentication Service
The phone authentication service on Cisco Unity Express handles VoiceView Express authentication requests from the IP phones during the playback and recording of voice messages and greetings. This service is available only when Cisco Unity Express is working with Cisco Unified CME.
This service is enabled by default and cannot be disabled.
If you are integrating Cisco Unity Express with Cisco Unified CME and your network has multiple IP phone services that need authentication, then Cisco Unity Express must act as the primary authentication service and must relay non-Cisco Unity Express service requests to other servers.
Prerequisites
Two URLs must be configured:
•
The Cisco Unified CME authentication URL must point to Cisco Unity Express. This URL has the format http://cue-ip-address/voiceview/authentication/authenticate.do.
•
The Cisco Unity Express fallback authentication URL must point to the third-party fallback server. This URL has the format http://servername/path/filename. Authentication requests from non-Cisco Unity Express services are relayed to this third-party server.
Required Data for This Procedure
URL for the Cisco Unity Express third-party fallback authentication server
SUMMARY STEPS
1.
config t
2.
service phone-authentication
3.
fallback-url fallback-url
4.
end
5.
show phone-authentication configuration
DETAILED STEPS
Example
The following is sample output for the show phone-authentication configuration command:
se-10-0-0-0# show phone-authentication configurationAuthentication service URL: http://<CUE-hostname>/voiceview/authentication/authenticate.doAuthentication Fallback Server URL: http://172.16.10.10/auth-server/authenticate.aspDisplaying and Terminating VoiceView Express Sessions
To terminate an active VoiceView Express session, see "Monitoring Active IMAP and VoiceView Express Sessions" on page 318.