Configuring VoiceView Express

Table Of Contents

Configuring VoiceView Express

Overview of VoiceView Express

VoiceView Express Session Count

Configuring Cisco Unified Communications Manager for VoiceView Express

Configuring Cisco Unified Communications Manager Express for VoiceView Express

Session Termination

Configuring VoiceView Express

Prerequisites

Required Data for This Procedure

Examples

Configuring the Phone-Authentication Service

Prerequisites

Required Data for This Procedure

Example

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

	Command or Action	Purpose
Step 1	config t Example: se-10-0-0-0# config t	Enters configuration mode.
Step 2	service voiceview Example: se-10-0-0-0(config)# service voiceview	Enters VoiceView Express configuration mode.
Step 3	enable Example: se-10-0-0-0(config-voiceview)# enable	Enables the VoiceView Express feature for all the subscribers served by the Cisco Unity Express system. The default state is enabled.
Step 4	session idletimeout minutes Example: se-10-0-0-0(config-voiceview)# session idletimeout 10	Specifies the number of minutes a VoiceView Express session can be idle. After this maximum is reached, the system automatically disconnects the session. Valid values are 5 to 30 minutes. The default is 5 minutes.
Step 5	end Example: se-10-0-0-0(config-voiceview)# end	Exits VoiceView Express configuration mode.
Step 6	end Example: se-10-0-0-0(config)# end	Exits configuration mode.
Step 7	show voiceview configuration Example: se-10-0-0-0# show voiceview configuration	(Optional) Displays the VoiceView Express configuration parameters.
Step 8	show voiceview sessions Example: se-10-0-0-0# show voiceview sessions	(Optional) Displays all active VoiceView Express sessions.

Examples

The following is sample output for the show voiceview configuration command:

se-10-0-0-0# show voiceview configuration

Phone service URL:       http://<CUE-hostname>/voiceview/common/login.do

Enabled:                 Yes

Idle Timeout (minutes):  10

The following is sample output for the show voiceview sessions command:

se-10-0-0-0# show voiceview sessions

Mailbox      RTP     User ID      Phone MAC Address

1013         Yes     user1        0015.C68E.6C1E

1016         No      user5        0015.629F.8706

1015         No      user3        0015.63EE.3790

1014         Yes     user6        0015.629F.888B

1009         No      user9        0015.6269.57D2

1012         No      user10       0016.4676.4FCA

1001         No      user8        0009.B7F7.5703

1004         Yes     user11       000C.30DE.5EA8

8 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

	Command or Action	Purpose
Step 1	config t Example: se-10-0-0-0# config t	Enters configuration mode.
Step 2	service phone-authentication Example: se-10-0-0-0(config)# service phone-authentication	Enters authentication mode.
Step 3	fallback-url fallback-url Example: se-10-0-0-0(config-phone-authentication)# fallback-url http://172.16.10.10/auth-server/authenticate.asp	Specifies the URL of the fallback authentication server. Note Do not use this command for Cisco Unified Communications Manager systems.
Step 4	end Example: se-10-0-0-0(config-phone-authentication)# end	Exits authentication mode.
Step 5	end Example: se-10-0-0-0(config)# end	Exits configuration mode.
Step 6	show phone-authentication configuration Example: se-10-0-0-0# show phone-authentication configuration	(Optional) Displays the VoiceView Express authentication parameters.

Example

The following is sample output for the show phone-authentication configuration command:

se-10-0-0-0# show phone-authentication configuration

Authentication service URL: http://<CUE-hostname>/voiceview/authentication/authenticate.do

Authentication Fallback Server URL: http://172.16.10.10/auth-server/authenticate.asp

Displaying and Terminating VoiceView Express Sessions

To terminate an active VoiceView Express session, see "Monitoring Active IMAP and VoiceView Express Sessions" on page 318.