Table Of Contents

Configuring Cisco Visual Voicemail on Your Cisco Unified Communications System

Configuration of Visual Voicemail on Your Cisco Unified Communications System

Visual Voicemail and Complex Configurations

Enabling Web Access on Phones

How to Create Voicemail Pilot Numbers, Hunt Pilots, Line Groups, and Hunt Lists

Creating a Voicemail Pilot Number for Visual Voicemail

Creating a Hunt Pilot for the Voicemail Pilot Number

Testing Your Visual Voicemail Pilot Number

(Active-Active Cisco Unity Connection Only) Creating a Line Group

(Active-Active Cisco Unity Connection Only) Creating a Hunt List

How to Install and Configure Voicemail Web Services

Installing the Cisco Unity Web Service

Configuring Cisco Unity Connection Settings for the Voicemail Web Service

Testing That the Voicemail Web Service Is Accessible

About the Visual Voicemail .Jad and .Jar Files

Testing the Visual Voicemail .Jad File on Your Voicemail Server

How to Configure Reverse TRaP Rules

Configuring a Reverse TRaP Rule on Cisco Unity

Configuring a Reverse TRaP Rule on Cisco Unity Connection

Testing Your Reverse TRaP Rule

How to Add the Visual Voicemail Service in Cisco Unified Communications Manager

Viewing the .Jad File

Service Parameters for Visual Voicemail

Adding the Visual Voicemail Service

Configuring Cisco Visual Voicemail on Your Cisco Unified Communications System

---

Revised: March 2, 2010

•Configuration of Visual Voicemail on Your Cisco Unified Communications System

•Enabling Web Access on Phones

•How to Create Voicemail Pilot Numbers, Hunt Pilots, Line Groups, and Hunt Lists

•How to Install and Configure Voicemail Web Services

•About the Visual Voicemail .Jad and .Jar Files

•How to Configure Reverse TRaP Rules

•How to Add the Visual Voicemail Service in Cisco Unified Communications Manager

Configuration of Visual Voicemail on Your Cisco Unified Communications System

Before you install Visual Voicemail, ensure that you plan appropriately for the installation. For more information, see Planning to Install Cisco Visual Voicemail.

When you install Visual Voicemail, you can re-use some elements of the existing configuration of your TUI voicemail system. For some configurations, you do not need to create new versions of the following configuration elements, you can re-use these items:

•Voicemail ports

•Line groups

•Hunt lists

For other configurations, for example Cisco Unity Connection servers in an active-active configuration, you must create a line group and a hunt list for each server.

Related Topics

•Visual Voicemail and Complex Configurations

Visual Voicemail and Complex Configurations

Your Cisco Unified Communications system might contain the following elements for failover, clustering, or to ensure that the system can be scaled:

•Multiple voicemail servers

•Multiple Cisco Unified Communications Manager servers

If your system contains these elements, you must repeat some of the installation steps described in this chapter. You must repeat steps on different servers.

For more information about how to configure Visual Voicemail on complex configurations, see Configuring Cisco Visual Voicemail on Complex Systems with Failover, Clusters, and Multiple Servers.

Related Topics

•Configuration of Visual Voicemail on Your Cisco Unified Communications System

Enabling Web Access on Phones

For Visual Voicemail to function correctly on Cisco Unified IP Phones, the phones must have web access enabled. To enable web access on the phones in your system, you can use the following Cisco Unified Communications Manager windows:

•Device Configuration window

•Common Phone Profile window

•Enterprise Phone Configuration window

For more information about these windows, see the Cisco Unified Communications Manager Administration Guide at the following URL:

http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_maintenance_guides_list.html

For more information about web access, see the Cisco Unified Communications Manager Security Guide at the same URL.

What to Do Next

•Creating a Voicemail Pilot Number for Visual Voicemail

How to Create Voicemail Pilot Numbers, Hunt Pilots, Line Groups, and Hunt Lists

•Creating a Voicemail Pilot Number for Visual Voicemail

•Creating a Hunt Pilot for the Voicemail Pilot Number

•Testing Your Visual Voicemail Pilot Number

•(Active-Active Cisco Unity Connection Only) Creating a Line Group

•(Active-Active Cisco Unity Connection Only) Creating a Hunt List

Creating a Voicemail Pilot Number for Visual Voicemail

Procedure

---

Step 1 Select Voice Mail > Voice Mail Pilot in Cisco Unified Communications Manager Administration.

Step 2 Select Add New.

Step 3 Enter a directory number for the voicemail pilot for Visual Voicemail in the Voice Mail Pilot Number field.

Step 4 Select the same calling search space that you use for the TUI voicemail system from the Calling Search Space list box.

Step 5 (Optional) Enter a description in the Description field, for example, enter Visual Voicemail Reverse Trap Pilot.

Step 6 Select Save.

---

Related Topics

•How to Configure Reverse TRaP Rules

What to Do Next

•Creating a Hunt Pilot for the Voicemail Pilot Number

Creating a Hunt Pilot for the Voicemail Pilot Number

A hunt pilot is a string of digits and a set of associated digit manipulations that route calls to a hunt list. For more information about hunt pilots, see the Cisco Unified Communications Manager Administration Guide at the following URL:

http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_maintenance_guides_list.html

Procedure

---

Step 1 Select Call Routing > Route/Hunt > Hunt Pilot in Cisco Unified Communications Manager Administration.

Step 2 Select Add New.

Step 3 Enter the number of the Visual Voicemail pilot number in the Hunt Pilot field.

Step 4 (Optional) Enter a description in the Description field, for example, enter Visual Voicemail Reverse Hunt Pilot.

Step 5 Select the same hunt list that is associated with your telephone user interface (TUI) voicemail system from the Hunt List list box.

Step 6 Select Save.

---

Related Topics

•Creating a Voicemail Pilot Number for Visual Voicemail

What to Do Next

•Testing Your Visual Voicemail Pilot Number

Testing Your Visual Voicemail Pilot Number

Call the Visual Voicemail pilot number. If you hear prompts from the TUI, you have successfully created the Visual Voicemail pilot number.

Related Topics

•Creating a Voicemail Pilot Number for Visual Voicemail

•Creating a Hunt Pilot for the Voicemail Pilot Number

What to Do Next

•(Active-Active Cisco Unity Connection Only) Creating a Hunt List

•How to Install and Configure Voicemail Web Services

(Active-Active Cisco Unity Connection Only) Creating a Line Group

If you want to configure Visual Voicemail in a cluster of publisher and subscriber Cisco Unity Connection servers in an active-active configuration with one Cisco Unified Communications Manager server, you must create a line group for each Cisco Unity Connection server.

The directory numbers that are listed for the ports for the publisher server must be added to the line group for the publisher server. Similarly, the directory numbers that are listed for the ports for the subscriber server must be added to the line group for the subscriber server.

To view a list of ports and associated directory numbers , select Voice Mail > Cisco Voice Mail Port in Cisco Unified Communications Manager Administration.

For more information about how to create a line group, see the Cisco Unified Communications Manager Administration Guide at the following URL:

http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_maintenance_guides_list.html

For more information about ports in Cisco Unity Connection, see the System Administration Guide for Cisco Unity Connection at the following URL:

http://www.cisco.com/en/US/products/ps6509/prod_maintenance_guides_list.html

What to Do Next

•(Active-Active Cisco Unity Connection Only) Creating a Hunt List

(Active-Active Cisco Unity Connection Only) Creating a Hunt List

If you want to configure Visual Voicemail in a cluster of publisher and subscriber Cisco Unity Connection servers in an active-active configuration with one Cisco Unified Communications Manager server, you must create a hunt list for each Cisco Unity Connection server.

You must add the line group for the publisher server to the hunt list for the publisher server. Similarly, you must add the line group for the subscriber server to the hunt list for the subscriber server.

For more information about how to create a hunt list, see the Cisco Unified Communications Manager Administration Guide at the following URL:

http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_maintenance_guides_list.html

What to Do Next

•How to Install and Configure Voicemail Web Services

How to Install and Configure Voicemail Web Services

•Installing the Cisco Unity Web Service

•Configuring Cisco Unity Connection Settings for the Voicemail Web Service

•Testing That the Voicemail Web Service Is Accessible

Installing the Cisco Unity Web Service

Procedure

---

Step 1 Download the .msi installation file for the Cisco Unity web service to the Cisco Unity server. For information about where to get the .msi installation file, see the release notes at the following URL:

http://www.cisco.com/en/US/products/ps9829/prod_release_notes_list.html

Step 2 Run the .msi installation file.

Step 3 Follow the instructions in the installation wizard to install the Cisco Unity web service.

---

Related Topics

•How to Install and Configure Voicemail Web Services

•Configuring Cisco Unity Connection Settings for the Voicemail Web Service

What to Do Next

•Testing That the Voicemail Web Service Is Accessible

Configuring Cisco Unity Connection Settings for the Voicemail Web Service

When you install the Engineering Special (ES) for Cisco Unity Connection, the voicemail web service is also installed. You must configure the voicemail web service in Cisco Unity Connection.

Procedure

---

Step 1 Select System Settings > Advanced > Connection Administration in Cisco Unity Connection Administration.

Step 2 Enter values for the following Voice Mail Web Service settings:

Field	Setting
Applications Can Cache the Cisco Unity Connection Password	Select this option to enable Visual Voicemail to cache the extension and numeric password of users. This is required if you want to enable your users to use the sign-in option Keep me signed in.
Session Timeout (in Seconds)	Ensure that this value is set to 300.
Pilot Number for Voice Mail	Enter the directory number of your TUI voicemail service.
Pilot Number for TRAP Connections	Enter the Visual Voicemail pilot number.

Step 3 Select Save.

---

Related Topics

•How to Install and Configure Voicemail Web Services

What to Do Next

•Testing That the Voicemail Web Service Is Accessible

Testing That the Voicemail Web Service Is Accessible

Procedure

---

Step 1 Start a browser.

Step 2 Use the HTTP protocol to access the URL of the voicemail web service on the Cisco Unity or Cisco Unity Connection server.

You can access the URL structured as follows:

•Cisco Unity: http://<domain-name-of-Cisco Unity-server>/vmws/vmws.dll?Handler=GenAuthenticationWSDL

•Cisco Unity Connection: http://<domain-name-of-Cisco Unity Connection-server>/vmws/services/Authentication?wsdl

For example, access a URL similar to the following:

•Cisco Unity: http://unityserver/vmws/vmws.dll?Handler=GenAuthenticationWSDL

•Cisco Unity Connection: http://unityconnectionserver/vmws/services/Authentication?wsdl

If the source of an XML file is displayed, the voicemail web service has been correctly installed.

---

Related Topics

•How to Install and Configure Voicemail Web Services

What to Do Next

•About the Visual Voicemail .Jad and .Jar Files

About the Visual Voicemail .Jad and .Jar Files

Before you install Visual Voicemail, you must update your Cisco Unity or Cisco Unity Connection server to the release required for Visual Voicemail, as listed in the release notes at the following URL:

http://www.cisco.com/en/US/products/ps9829/prod_release_notes_list.html

During the installation of the updates, the following files are copied to the server:

•VisualVoicemail.jad

•VisualVoicemail.jar

VisualVoicemail.jad is a Java Application Descriptor (JAD) file. When you update the servers, the MIME type for .jad files is automatically set to the following value:

text/vnd.sun.j2me.app-descriptor

Related Topics

•Testing the Visual Voicemail .Jad File on Your Voicemail Server

Testing the Visual Voicemail .Jad File on Your Voicemail Server

Procedure

---

Step 1 Start a browser.

Step 2 Access the URL of the .jad file on the voicemail server.

You can access the URL structured as follows:

http://<IP-address-of-voicemail-server>/midlets/VisualVoicemail/VisualVoicemail.jad

For example, access:

http://209.165.200.225/midlets/VisualVoicemail/VisualVoicemail.jad

Depending on the browser you use, a dialog that prompts you to open or to save the VisualVoicemail.jad file is displayed.

---

Related Topics

•About the Visual Voicemail .Jad and .Jar Files

What to Do Next

•How to Configure Reverse TRaP Rules

How to Configure Reverse TRaP Rules

•Configuring a Reverse TRaP Rule on Cisco Unity

•Configuring a Reverse TRaP Rule on Cisco Unity Connection

•Testing Your Reverse TRaP Rule

Configuring a Reverse TRaP Rule on Cisco Unity

Procedure

---

Step 1 Start a browser on the Cisco Unity server.

Step 2 Access the system administration web page of the Cisco Unity server.

You can access the URL structured as follows:

http://<localhost>/Web/SA

For example, access:

http://unityserver/Web/SA

Step 3 Select Call Routing in the Call Management section.

Step 4 Select Direct Calls in the left pane.

Step 5 Change the rule order in the Routing Table so that the Route to Reverse TRaP rule is before the Attempt Sign-In rule.

Step 6 Set the status of the Route to Reverse TRaP rule to Enabled.

Step 7 Enter the number of the Visual Voicemail pilot number in the Dialed number (DNIS) field.

Step 8 Select Reverse TRaP from the Send calls to list box.

Step 9 Select Save.

---

Note Do not add any other reverse TRaP rules for Visual Voicemail. Also, do not rename the existing reverse TRaP rule. If you change the name of the reverse TRaP rule from Route to Reverse TRaP, Visual Voicemail does not function correctly.

---

---

What to Do Next

•Testing Your Reverse TRaP Rule

Configuring a Reverse TRaP Rule on Cisco Unity Connection

Procedure

---

Step 1 Select Call Management > Call Routing > Direct Routing Rules in Cisco Unity Connection Administration.

Step 2 Select Add New.

Step 3 Enter a name for the rule in the Display Name field, for example, enter Visual Voicemail Reverse Trap Rule.

Step 4 Select Save to save the name.

Step 5 Follow these steps to create a condition:

a. Select Add New in the Routing Rule Conditions section.

b. Select the Dialed Number option.

c. Select Equals from the list box of condition operators.

d. Enter the number of the Visual Voicemail pilot number in the value field.

e. Select Save to save the condition.

Check that the new rule is displayed in the Routing Rule Conditions section.

Step 6 Select the Edit Direct Routing Rule link at the top of the window.

Step 7 Select the Conversation option on the Edit Direct Routing Rule window, then select Reverse Trap from the list box.

Step 8 Select Save to save the rule.

---

Note Do not add any other reverse TRaP rules for Visual Voicemail.

---

---

What to Do Next

•Testing Your Reverse TRaP Rule

Testing Your Reverse TRaP Rule

Call the Visual Voicemail pilot number. If you hear five or six seconds of silence followed by termination of the call, you have successfully created the reverse TRaP rule.

Related Topics

•Configuring a Reverse TRaP Rule on Cisco Unity

•Configuring a Reverse TRaP Rule on Cisco Unity Connection

What to Do Next

•How to Add the Visual Voicemail Service in Cisco Unified Communications Manager

How to Add the Visual Voicemail Service in Cisco Unified Communications Manager

•Viewing the .Jad File

•Service Parameters for Visual Voicemail

•Adding the Visual Voicemail Service

Viewing the .Jad File

To add the Visual Voicemail service, you must first obtain information about the service from the VisualVoicemail.jad file. To obtain this information, you must view the content of the file.

Procedure

---

Step 1 Follow the procedure in Testing the Visual Voicemail .Jad File on Your Voicemail Server.

Step 2 Save the .jad file.

Step 3 Open VisualVoicemail.jad in a text editor

---

Related Topics

•Adding the Visual Voicemail Service

•About the Visual Voicemail .Jad and .Jar Files

Service Parameters for Visual Voicemail

To update a Visual Voicemail service parameter, you must delete the Visual Voicemail service then recreate the service. Therefore, you must decide which service parameters you want to use before you create the Visual Voicemail service.

You can use the following parameters with the Visual Voicemail service:

Parameter	Description
call_connect_delay	Specifies in milliseconds the delay that Visual Voicemail allows for a call to be automatically answered and connected to the voicemail server. This call is then used to play or record a message. The default value is 1000, but this value might need to be adjusted if there is significant network latency between the IP Phones running Visual Voicemail and the voicemail server. If this value is not large enough, then calls created by Visual Voicemail to play or record messages might be disconnected after five or six seconds. Only modify the value of this parameter if establishing calls to the voicemail server is unreliable. Suggested maximum value: 2500 Suggested minimum value: 500
log_level	Specifies the degree of detail that you want to appear for the phones that subscribe to the Visual Voicemail service.
never_save_localization_data	(Optional) Specifies whether to save localized user interface text in the memory of the phones.
tui_key_mappings_file_url	(Optional) Specifies the HTTP location of the key mappings file. For more information about this parameter, see Configuring Key Mappings in Visual Voicemail.
tui_key_mappings_file_version	(Optional) Specifies the version number of the key mappings file. For more information about this parameter, see Configuring Key Mappings in Visual Voicemail.
use_secure_https_connection	(Optional) Specifies whether to implement security in the Visual Voicemail service, that is whether to use HTTPS instead of HTTP to transmit voice messages. Set the value of this parameter to Yes to implement security in the Visual Voicemail service.
voicemail_server	Specifies the hostname of the voicemail server.

Related Topics

•Updating Visual Voicemail Service Parameters, page 7-2

Adding the Visual Voicemail Service

Procedure

---

Step 1 Select Device > Device Settings > Phone Services in Cisco Unified Communications Manager Administration.

Step 2 Select Add New.

Step 3 Enter information in the IP Phone Services Configuration window, as follows:

Field	Setting
Service Name	Enter the name of the service exactly as it appears in the VisualVoicemail.jad file. This name is displayed in the list of available services when you subscribe a phone to a service. Note You must enter the name of the service exactly as it appears in the VisualVoicemail.jad file. For example, if there are no spaces in the name of the service in the VisualVoicemail.jad file, do not include spaces in the name in this field.
ASCII Service Name	Enter a name for the service in ASCII characters. This name is displayed on a phone if the phone cannot display Unicode characters.
Service URL	Enter a URL that points to the service target .jad file. For example, enter a URL similar to the following URL: http://209.165.200.225/midlets/VisualVoicemail/VisualVoicemail.jad
Service Category	Select Java MIDlet.
Service Type	Select Messages to associate the service with the Messages button on the phone.
Service Vendor	Enter the name of the service vendor as it appears in VisualVoicemail.jad.
Service Version	Leave this field blank.
Enable	Select this to enable the service.
Enterprise Subscription	Do not select this. This method of installing the Visual Voicemail service on phones is suitable for only the most simple phone systems.

Step 4 Select Save.

Step 5 Select New Parameter to add a parameter to the service.

Field	Setting
Parameter Name	Enter the following text in this field: voicemail_server
Parameter Display Name	Enter a name for the parameter. This name is used in the Cisco Unified Communications Manager user interface. For example, enter Voicemail server.
Default Value	Cisco Unity: Enter the hostname of the primary server. Cisco Unity Connection: If you have a Cisco Unity Connection cluster, enter the cluster DNS alias. Otherwise, enter the hostname of your Cisco Unity Connection server. This value is displayed to administrators when they subscribe phones to this service. When a user signs in to Visual Voicemail, the hostname of any partner server that is available is cached by the Visual Voicemail MIDlet for use during failover. For this reason, only one hostname is needed for this parameter.
Parameter Description	Enter a description. For example, enter Hostname of voicemail server.
Parameter is Required	Select this option.
Parameter is a Password	Do not select this option.

For more information about service administration, see Cisco Unified Communications Manager System Guide and Cisco Unified Communications Manager Administration Guide at the following URL:

http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_maintenance_guides_list.html

Step 6 Select Save.

Step 7 Select Add New to add another parameter to the service.

Field	Setting
Parameter Name	Enter the following text in this field: call_connect_delay
Parameter Display Name	Enter a name for the parameter. For example, enter Call Connect Delay.
Default Value	Enter 1000.
Parameter Description	Enter a description. For example, enter Default call connect delay.
Parameter is Required	Select this option.
Parameter is a Password	Do not select this option.

Step 8 Select Add New to add another parameter to the service.

Field	Setting
Parameter Name	Enter the following text in this field: log_level
Parameter Display Name	Enter a name for the parameter. For example, enter Log Level.
Default Value	Enter the following text in this field: info
Parameter Description	Enter a description. For example, enter Level of logging.
Parameter is Required	Select this option.
Parameter is a Password	Do not select this option.

Step 9 Select Save And Close.

---

Related Topics

•Viewing the .Jad File

•Service Parameters for Visual Voicemail

•About the Visual Voicemail .Jad and .Jar Files

•Installing by Enterprise Subscription, page 5-3

•How to Add the Visual Voicemail Service in Cisco Unified Communications Manager

What to Do Next

•(Optional) Configuring Security for Cisco Visual Voicemail

•(Optional) Configuring Cisco Visual Voicemail on Complex Systems with Failover, Clusters, and Multiple Servers

•Installing Cisco Visual Voicemail on Phones