Installation and Configuration Guide for Visual Voicemail Release 8.5
Installing Cisco Visual Voicemail on Phones

Table Of Contents

Installing Cisco Visual Voicemail on Phones

How to Install the Visual Voicemail Service on Phones

Enabling Service Provisioning on the Cisco Unified Communications System

Installing by Enterprise Subscription

Subscribing Individual Phones to Visual Voicemail

How to Install by Bulk Administration

Creating a BAT Phone Template

Using Bulk Administration to Update the Phones

Scheduling the Update of Phones

How to Install Visual Voicemail to Device Profiles for Extension Mobility

Creating a UDP File Format

Creating a UDP Template

Exporting Profile Information

Importing Profile Information

Verifying That the Profiles Are Subscribed to the Visual Voicemail Service

How Visual Voicemail Interoperates with Audio Voicemail

Changing the Audio Voicemail Service to Non-Enterprise Subscription

Disabling the Audio Voicemail Service

Restarting the TFTP Services and Devices


Installing Cisco Visual Voicemail on Phones


How to Install the Visual Voicemail Service on Phones

Disabling the Audio Voicemail Service

Restarting the TFTP Services and Devices

How to Install the Visual Voicemail Service on Phones

The following table lists the installation methods available for Visual Voicemail:

Installation Method
Advantages
Disadvantages

Enterprise subscription

This method replaces audio voicemail service with Visual Voicemail on all phones that support Visual Voicemail. This is a simple method of installation.

You cannot customize the installation for users with exceptional requirements.

Individual subscription

You can customize the installation for users with exceptional requirements.

If you use this method for every user, the installation might be very time-consuming.

Bulk administration

You can customize the installation for users with exceptional requirements, for example, a user who can only use the audio voicemail service.

The installation process is more complex.


If you change any of the service parameters for the Visual Voicemail service, you must delete the service then recreate the service. For more information on this topic, see Updating Visual Voicemail Service Parameters.

Related Topics

Enabling Service Provisioning on the Cisco Unified Communications System

Installing by Enterprise Subscription

Subscribing Individual Phones to Visual Voicemail

How to Install by Bulk Administration

How to Install Visual Voicemail to Device Profiles for Extension Mobility

Changing the Audio Voicemail Service to Non-Enterprise Subscription

Disabling the Audio Voicemail Service

Enabling Service Provisioning on the Cisco Unified Communications System

Before you install Visual Voicemail on the Cisco Unified Communications system, you must enable the phones to receive services from Cisco Unified Communications Manager. You must allow for internal service provisioning.

Procedure


Step 1 In Cisco Unified Communications Manager Administration, select System > Enterprise Parameters.

Step 2 Set the value in the Services Provisioning list box, as shown in the following table.

If the Current Value Is...
Change To...

Both

Do not change the setting.

Internal

Do not change the setting.

External URL

Both


Step 3 Select Save.

Step 4 Select Device > Device Settings > Common Phone Profile in Cisco Unified Communications Manager Administration.

Step 5 Search for the profile in the Find and List Common Phone Profiles window.

Step 6 Select your common phone profile.

Step 7 Set the value of the Services Provisioning parameter as shown in the following table.

If the Current Value Is...
Change To...

Both

Do not change the setting.

Default

Do not change the setting.

External

Both

Internal

Do not change the setting.


Step 8 Select Save.

This allows the changes you made to propagate to all phones that have the Service Provisioning value set to Default.

Step 9 Set the Services Provisioning parameter to Default on each phone on which you want to install Visual Voicemail.

For example, you can use the Bulk Administration Tool (BAT) to set the Services Provisioning parameter on each phone. For more information about BAT, see the Cisco Unified Communications Manager Bulk Administration Guide at the following URL:

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


Installing by Enterprise Subscription

It is only appropriate to install Visual Voicemail by enterprise subscription for systems that have the following characteristics:

All users of phones in the system that support Visual Voicemail, will use Visual Voicemail. You cannot exclude any phones that support Visual Voicemail from the installation of Visual Voicemail if you use enterprise subscription.

If a Visual Voicemail user wants to use the audio voice message service, you can add that service to their phone. For more information about this topic, see How Visual Voicemail Interoperates with Audio Voicemail.

For information about which phones support Visual Voicemail, see the release notes at the following URL:

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

For phones that are behind Cisco Virtual Office routers, or behind any other type of hardware VPN device, the address of the Cisco Unity or Cisco Unity Connection server must not be blocked. In some cases, particular traffic might be prevented from leaving or entering the voice Virtual Local Area Network (VLAN). Check with your administrator to ensure there are no access control lists or firewall devices that block the address of the Cisco Unity or Cisco Unity Connection server.

When you use enterprise subscription, enter any service parameter into the URL of the service structured as follows:

http://<IP-address-or-host-name-of-server>/midlets/VisualVoicemail/VisualVoicemail.jad?<name-of-parameter-1>=<value-of-parameter-1>&<name-of-parameter-2>=<value-of-parameter-2>

For example, if you want to enter the following service parameter values:

Parameter
Value

use_secure_https_connection

1

voicemail_server

example_hostname

vmserver_is_unity_connection

1


To enter the above values, you would use the following URL:

http://209.165.200.225/midlets/VisualVoicemail/VisualVoicemail.jad?use_secure_https_connection=1&voicemail_server=example_hostname&vmserver_is_unity_connection=1


Note The Enterprise Subscription check box displays only when you configure a service for the first time. After you save the service, the check box does not display in the IP Phone Services Configuration window in Cisco Unified Communications Manager Administration.


For more information about IP Phone Service Configuration Settings, see 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

Subscribing Individual Phones to Visual Voicemail

Procedure


Step 1 Select Device > Phone.

Step 2 Search for the phone in the Find and List Phones window.

Step 3 Select the phone.

Step 4 Select Subscribe/Unsubscribe Services from Related Links, then select Go.

Step 5 Select the Visual Voicemail service from the Select a Service dialog box.

Step 6 Select Next.

Step 7 Select Subscribe.

To unsubscribe from the service, select Unsubscribe.


How to Install by Bulk Administration

To install the Visual Voicemail MIDlet by bulk administration, you must do the following:

1. Create a BAT phone template.

2. Subscribe the Visual Voicemail service to a phone template.

The Bulk Administration Tool (BAT) performs bulk updates to the Cisco Unified Communications Manager database. For more information about BAT, see the Cisco Unified Communications Manager Bulk Administration Guide at the following URL:

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

See the following sections

Creating a BAT Phone Template

Using Bulk Administration to Update the Phones

Scheduling the Update of Phones

Creating a BAT Phone Template

For more information about BAT phone templates, see Cisco Unified Communications Manager Bulk Administration Guide at the following URL:

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

Procedure


Step 1 In Cisco Unified Communications Manager Administration, select Bulk Administration > Phones > Phone Template.

Step 2 Select Add New.

Step 3 Select the desired phone type, then select Next.

Step 4 If you selected a 7900 series phone type in Step 3, select the device protocol for the phone type you selected, then select Next.

Step 5 Enter the required information for the phone template in the Phone Template Configuration window, then select Save.

Step 6 Select Subscribe/Unsubscribe Services from Related Links, then select Go.

Step 7 Select the Visual Voicemail service from the Select a Service dialog box.

Step 8 Select Next.

Step 9 Select Subscribe.


Using Bulk Administration to Update the Phones

Use the BAT query function to update the phones that support Visual Voicemail with the Visual Voicemail service.

Before You Begin

Identify the phones in your site that support Visual Voicemail. For information about the phones that support Visual Voicemail see the release notes at the following URL:

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

Procedure


Step 1 In Cisco Unified Communications Manager Administration, select Bulk Administration > Phones > Update Phones > Query.

Step 2 Compose a query to specify the phones to which you want to add the Visual Voicemail service.

For example, you can specify phones that have a device type that contains 9971, 9951, 8961, and so on.

Step 3 Select Next.

Step 4 Select Restart phones.

Step 5 In the Assign IP Phone Services section, select Add all services from this template then select the BAT phone template you created from the list box.

Step 6 Select Run later in the Job Information section.

Step 7 Select Submit.

For more information about how to use queries to perform bulk administration, see Cisco Unified Communications Manager Bulk Administration Guide at the following URL:

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


Scheduling the Update of Phones

Procedure


Step 1 In Cisco Unified Communications Manager Administration, select Bulk Administration > Job Scheduler.

Step 2 Search for the job in the Find and List Jobs window.

Step 3 To start the job, select the checkbox to the left of the job ID, then select Activate Selected.

To schedule the job for later, select the job ID. Enter the job details in the Job Scheduler window, then select Activate Job.

For more information about scheduling bulk administration jobs, see Cisco Unified Communications Manager Bulk Administration Guide at the following URL:

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


How to Install Visual Voicemail to Device Profiles for Extension Mobility

When you install the Visual Voicemail service on phones in a system that requires extension mobility, ensure that Visual Voicemail is installed on the following:

All phones to which the extension mobility service is subscribed. If the Visual Voicemail MIDlet is installed on the phones, users are less likely to experience errors.

All device profiles associated with extension mobility profiles.

Do the following:

Creating a UDP File Format

Creating a UDP Template

Exporting Profile Information

Importing Profile Information

Verifying That the Profiles Are Subscribed to the Visual Voicemail Service

If you want to install Visual Voicemail on both SIP and SCCP phones in the phone system, you must perform each of the above procedures separately for each protocol.

Creating a UDP File Format

Procedure


Step 1 In Cisco Unified Communications Manager Administration, select Bulk Administration > User Device Profiles > UDP File Format > Create UDP File Format.

Step 2 Select Add New.

Step 3 Enter a unique name for the file format in the Format Name field.

Step 4 Add all of the fields in the Device Fields list box to the Selected Device Fields list box.

Step 5 Ensure that the following list boxes are empty:

Selected Line Fields

Selected Intercom DN Fields

Step 6 Ensure that the value of all fields in the IP Phone Service Maximums section is set to zero (0).

Step 7 Select Save.


Creating a UDP Template

Procedure


Step 1 In Cisco Unified Communications Manager Administration, select Bulk Administration > User Device Profiles > UDP Template.

Step 2 Select Add New.

Step 3 Select your desired phone model from the Device Profile Type list box, then select Next.

Step 4 If you selected a 7900 series phone type in Step 3, select SCCP or SIP from the Device Protocol list box, depending on the protocol of the profiles on which you want to install Visual Voicemail, then select Next.

Step 5 Enter a unique name for the template in the User Device Profile Template Name field.

Step 6 Select the standard phone button template from the Phone Button Template list box.

Step 7 Select Save.

Step 8 Select Subscribe/Unsubscribe Services from Related Links, then select Go.

Step 9 Select the Visual Voicemail service from the Select a Service dialog box, then select Next.

Step 10 Select Subscribe.


Note Do not make any changes to the default values of the UDP template, other than those specified in this procedure.



Exporting Profile Information

Procedure


Step 1 In Cisco Unified Communications Manager Administration, select Bulk Administration > User Device Profiles > Export UDP > Specific Details.

Step 2 Compose a query to specify the profiles to which you want to add the Visual Voicemail service.

Ensure that the query finds only the profiles to which you want to add the Visual Voicemail service. VPN routers are not supported by Visual Voicemail, so ensure that you exclude profiles that connect to the system by VPN from the query.

To unsubscribe services from profiles is difficult, so ensure that the query finds only the profiles to which you want to add the Visual Voicemail service.

For example, you can specify profiles that have a device type that contains 8961, 9951, 9971, and so on.

Step 3 Add a criterion to the query so that the query specifies only SIP or only SCCP profiles. To do this, compose the criterion as follows:

Field
Setting

Find User Device Profile where list box

Select Device Protocol.

Condition list box

Select is exactly.

Value text box

Type either SIP or SCCP.


For more information about how to use queries to perform bulk administration, see Cisco Unified Communications Manager Bulk Administration Guide at the following URL:

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

Step 4 Select Find.

Review the list of profiles that the query finds, and ensure that the query finds only the profiles to which you want to add the Visual Voicemail service.

Step 5 Select Next.

Step 6 Enter information in the Export User Device Profiles window, as follows:

Field
Setting

File Name

Enter a name for the file to export.

File Format

Select the file format that you created in Creating a UDP File Format.


Step 7 Select Run Immediately in the Job Information section.

Step 8 Select Submit.

Step 9 Select Bulk Administration > Job Scheduler.

Verify that the export operation performed successfully. You can select the Job Id to view the details of the operation, including the filename that you specified.


Importing Profile Information

Procedure


Step 1 In Cisco Unified Communications Manager Administration, select Bulk Administration > Upload/Download Files.

Step 2 Search for the file created in Exporting Profile Information in the Find and List Files window.

Step 3 Select the file, then select Download Selected.

Step 4 Rename the downloaded file.

Step 5 Select Add New.

Step 6 Enter information in the File Upload Configuration window, as follows:

Field
Setting

File

Select the file that you downloaded and renamed.

Select The Target

Select UDP.

Select Transaction Type

Select Insert UDP - Specific Details.


Step 7 Select Save.

Step 8 Select Bulk Administration > User Device Profiles > Insert UDP.

Step 9 Enter information in the Insert User Device Profiles Configuration window, as follows:

Field
Setting

Insert User Device Profiles Specific Details

Select this option.

File Name

Select the file that you specified in Step 6.

User Device Profiles Template Name

Select the file format that you created in Creating a UDP File Format.

Override the existing configuration

Select this option.


Step 10 Select Run Immediately in the Job Information section.

Step 11 Select Submit.


Verifying That the Profiles Are Subscribed to the Visual Voicemail Service

Procedure


Step 1 In Cisco Unified Communications Manager Administration, select Device > Device Settings > Profile.

Step 2 Search for a device profile in the Find and List Device Profiles window.

Step 3 Select any device profile.

Step 4 Select Subscribe/Unsubscribe Services from Related Links, then select Go.

Verify that the Visual Voicemail service is subscribed to the device profile.

Step 5 Sign in to a phone that is used for extension mobility, then press the Messages button.

Verify that the Visual Voicemail application starts.


What to Do Next

Restarting the TFTP Services and Devices

How Visual Voicemail Interoperates with Audio Voicemail

The standard Cisco Unity and Cisco Unity Connection audio voicemail service is configured in Cisco Unified Communications Manager as a phone service called Voicemail. The service is enabled as an enterprise subscription, so all phones are subscribed to this service.

Visual Voicemail can coexist with the audio voicemail service. You can choose the following options when you deploy Visual Voicemail:

Do not change the existing audio voicemail service. Subscribe all phones to the Visual Voicemail service. When the user presses the Messages button a list of services is displayed, as follows:

Voicemail

VisualVoicemail

Users can select which service to use.

Change the existing audio voicemail service so that it is not an enterprise subscription. Then subscribe some phones to the audio voicemail service only, and subscribe some phones to the Visual Voicemail service only. When a user presses the Messages button, the service to which the phone is subscribed starts.

Disable the audio voicemail service, and subscribe all phones to the Visual Voicemail service. When a user presses the Messages button, Visual Voicemail starts.

Related Topics

Changing the Audio Voicemail Service to Non-Enterprise Subscription

Disabling the Audio Voicemail Service

Changing the Audio Voicemail Service to Non-Enterprise Subscription

Before You Begin

To change the existing audio voicemail service so that it is not an enterprise subscription, you must delete the service, then add it again.

Procedure


Step 1 In Cisco Unified Communications Manager Administration, select Device > Device Settings > Phone Services.

Step 2 Search for the service called Voicemail in the Find and List IP Phone Services window.

Step 3 Select the check box for the Voicemail service.

Step 4 Select Delete Selected, then select OK to confirm.

Step 5 Select Add New.

Step 6 Enter values for the fields in the IP Phone Services Configuration window, as shown in the following table:

Field
Value

Service Name

Enter Voicemail.

ASCII Service Name

Enter Voicemail.

Service URL

Enter Application:Cisco/Voicemail.

Service Category

Select XML Service.

Service Type

Select Messages.


Leave the other fields blank.

Step 7 Select Save.


Disabling the Audio Voicemail Service

Before You Begin

You might choose to disable the audio voicemail service after you install Visual Voicemail. If you enable the audio voicemail service again after you disable it, when the users press the Messages button, a list of services is displayed including the audio voicemail service and Visual Voicemail.

Procedure


Step 1 Select Device > Device Settings > Phone Services.

Step 2 Find the audio voicemail service.

Step 3 Select the service.

Step 4 Deselect Enable.

Step 5 Select Save.


Restarting the TFTP Services and Devices

After you update subscriptions, restart all of the TFTP services in the cluster, then restart all of the devices in Cisco Unified Communications Manager.

For information about how to restart TFTP services, see Cisco Unified Serviceability Administration Guide at the following URL:

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

To restart the devices, reset the devices for each device pool in the cluster. For information about how to restart devices in Cisco Unified Communications Manager, see 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