Cisco Unity Express 3.0 Voice-Mail and Auto-Attendant CLI Administrator Guide - Configuring VoiceView Express [Cisco Unity 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 NME-CUE, NM-CUE-EC, and NM-CUE.

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

VoiceView Express Session Count

The maximum number of simultaneous VoiceView Express sessions depends on the size of the nerwork modules:

•NME-CUE (512-MB): 24 sessions

•NM-CUE-EC (512-MB): 16 sessions

•NM-CUE (256-MB): 8 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 251 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 251.