Configuring Cisco Visual Voicemail on Complex Systems with Failover, Clusters, and Multiple Servers
•Visual Voicemail Configuration on Complex Systems
•About Visual Voicemail Installation on Complex Cisco Unity Configurations
•About Visual Voicemail Installation on Complex Cisco Unity Connection Configurations
Visual Voicemail Configuration on Complex Systems
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 Configuring Cisco Visual Voicemail on Your Cisco Unified Communications System and Configuring Security for Cisco Visual Voicemail. You must repeat steps on different servers.
This chapter describes the configuration that is required in these complex configurations to ensure that Visual Voicemail functions correctly.
Use Table 4-1 to identify what part of this chapter corresponds to your complex configuration.
About Visual Voicemail Installation on Complex Cisco Unity Configurations
•Failover Configuration
•Configuration of Multiple Independent Cisco Unity Servers Integrated with One Cisco Unified Communications Manager Server
•Configuration of One Cisco Unity Server Integrated with Multiple Cisco Unified Communications Manager Servers
Failover Configuration
To configure Visual Voicemail on a system with failover where the primary and secondary Cisco Unity servers are integrated with one Cisco Unified Communications Manager server, you must do the following:
•Create only one Visual Voicemail pilot number.
•Install the web services on both the primary and secondary servers. The web services only install on an active server. To install the web services on the secondary server, do the following:
a. Run the Unity Failover Monitor on the primary server.
b. Failover to the secondary server.
c. Install the web services on the secondary server.
d. Run the Unity Failover Monitor on the secondary server.
e. Failback to the primary server.
•Configure the reverse TRaP rule on both the primary server and the secondary server. Use the same Visual Voicemail pilot number in the Dialled Number field for both servers.
•Create only one Visual Voicemail service on the Cisco Unified Communications Manager server. Enter the hostname of the primary server in the following fields:
–Service URL of the service
–Default Value of the voicemail_server parameter
Note When a user signs in to Visual Voicemail, the primary server automatically provides the hostname of the secondary server to the application. The hostname of the secondary server is cached locally by the application and is used in failover scenarios when the primary server is not available.
If you want to configure security for Visual Voicemail, you must do the following:
•Add the use_secure_https_connection parameter to the Visual Voicemail service on the Cisco Unified Communications Manager server.
•Obtain a certificate for Visual Voicemail on both the primary server and secondary server.
•Add the certificates for both the primary server and secondary server to Cisco Unified Communications Manager and to the phones.
Related Topics
•How to Create Voicemail Pilot Numbers, Hunt Pilots, Line Groups, and Hunt Lists, page 2-2
•How to Install and Configure Voicemail Web Services, page 2-5
•How to Configure Reverse TRaP Rules, page 2-7
•How to Add the Visual Voicemail Service in Cisco Unified Communications Manager, page 2-9
•Adding the Security Service Parameter to the Visual Voicemail Service, page 3-2
•How to Obtain a Certificate for Visual Voicemail on Cisco Unity, page 3-2
•Uploading Certificates to Cisco Unified Communications Manager, page 3-6
Configuration of Multiple Independent Cisco Unity Servers Integrated with One Cisco Unified Communications Manager Server
To configure Visual Voicemail on a system where multiple independent Cisco Unity servers are integrated with one Cisco Unified Communications Manager server, you must do the following:
•Create a unique Visual Voicemail pilot number for each Cisco Unity server. Each pilot number must use the correct set of voicemail ports for the particular Cisco Unity server.
•Install the web services on each Cisco Unity server.
•Configure the reverse TRaP rule on each Cisco Unity server. Use the appropriate Visual Voicemail pilot number for each server in the Dialled Number field.
•Create a Visual Voicemail service for each Cisco Unity server on the Cisco Unified Communications Manager server. For each Cisco Unity server, use the hostname of that server in the following fields:
–Service URL of the service
–Default Value of the voicemail_server parameter
Each service must have the same value in the Service Name field, because this value must match the value in the .jad file. Cisco Unified Communications Manager allows you to create multiple services with the same name. You can use the Service Description field to distinguish between the services.
If you want to configure security for Visual Voicemail, you must do the following:
•Add the use_secure_https_connection parameter to each Visual Voicemail service on the Cisco Unified Communications Manager server.
•Obtain a certificate for Visual Voicemail on each Cisco Unity server.
•Add the certificates for each Cisco Unity server to Cisco Unified Communications Manager and to the phones.
Related Topics
•How to Create Voicemail Pilot Numbers, Hunt Pilots, Line Groups, and Hunt Lists, page 2-2
•How to Install and Configure Voicemail Web Services, page 2-5
•How to Configure Reverse TRaP Rules, page 2-7
•How to Add the Visual Voicemail Service in Cisco Unified Communications Manager, page 2-9
•Adding the Security Service Parameter to the Visual Voicemail Service, page 3-2
•How to Obtain a Certificate for Visual Voicemail on Cisco Unity, page 3-2
•Uploading Certificates to Cisco Unified Communications Manager, page 3-6
Configuration of One Cisco Unity Server Integrated with Multiple Cisco Unified Communications Manager Servers
To configure Visual Voicemail on a system where one Cisco Unity server is integrated with multiple Cisco Unified Communications Manager servers, you must do the following:
•Create a Visual Voicemail pilot number on each Cisco Unified Communications Manager server. You must use the same directory number for the pilot number on each Cisco Unified Communications Manager server.
•Install the web services on the Cisco Unity server.
•Configure the reverse TRaP rule on the Cisco Unity server. Use the Visual Voicemail pilot number in the Dialled Number field on the server.
Because there is only one Cisco Unity server, there is only one reverse TRaP rule. The reverse TRaP rule can only match one directory number as the Dialled Number. This is the reason why you must use the same directory number for the pilot number on each Cisco Unified Communications Manager server.
•Create a Visual Voicemail service on each Cisco Unified Communications Manager server. On each server, use the hostname of the Cisco Unity server in the following fields:
–Service URL of the service
–Default Value of the voicemail_server parameter
If you want to configure security for Visual Voicemail, you must do the following:
•Add the use_secure_https_connection parameter to the Visual Voicemail service on each Cisco Unified Communications Manager server.
•Obtain a certificate for Visual Voicemail on the Cisco Unity server.
•Add the certificates for the Cisco Unity server to each Cisco Unified Communications Manager and to the phones.
Related Topics
•How to Create Voicemail Pilot Numbers, Hunt Pilots, Line Groups, and Hunt Lists, page 2-2
•How to Install and Configure Voicemail Web Services, page 2-5
•How to Configure Reverse TRaP Rules, page 2-7
•How to Add the Visual Voicemail Service in Cisco Unified Communications Manager, page 2-9
•Adding the Security Service Parameter to the Visual Voicemail Service, page 3-2
•How to Obtain a Certificate for Visual Voicemail on Cisco Unity, page 3-2
•Uploading Certificates to Cisco Unified Communications Manager, page 3-6
About Visual Voicemail Installation on Complex Cisco Unity Connection Configurations
•Cluster of Publisher and Subscriber Cisco Unity Connection Servers in an Active-Active Configuration with One Cisco Unified Communications Manager Server
•Configuration of Multiple Cisco Unity Connection Clusters Integrated with One Cisco Unified Communications Manager Server
•Configuration of One Cisco Unity Connection Server Integrated with Multiple Cisco Unified Communications Manager Servers
Cluster of Publisher and Subscriber Cisco Unity Connection Servers in an Active-Active Configuration with One Cisco Unified Communications Manager Server
To configure Visual Voicemail on a system where publisher and subscriber Cisco Unity Connection servers are integrated in an active-active configuration with one Cisco Unified Communications Manager server, you must do the following:
•Create a unique Visual Voicemail pilot number for each Cisco Unity Connection server in the cluster. Each pilot number must use the correct set of voicemail ports that corresponds to the particular Cisco Unity Connection server.
The set of voicemail ports for a server is contained in a line group. A hunt list refers to the line group, and a hunt pilot refers to the hunt list. Therefore the hunt pilot for a particular server must use a line group which has the correct ports for that server.
•Create a line group for each Cisco Unity Connection server in the cluster. 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.
For more information about how to create a line group, see (Active-Active Cisco Unity Connection Only) Creating a Line Group, page 2-4.
•Create a hunt list for each Cisco Unity Connection server in the cluster. 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 (Active-Active Cisco Unity Connection Only) Creating a Hunt List, page 2-4.
•Configure the Cisco Unity Connection settings for the web service on both the publisher and subscriber Cisco Unity Connection servers.
When you configure the voicemail web service, enter the appropriate pilot number for each Cisco Unity Connection server in the Pilot Number for TRAP Connections field. This setting has different values on the publisher server and subscriber server, because you created a different pilot number for each server.
•Configure two reverse TRaP rules on your Cisco Unity Connection publisher server, as follows:
–In the first rule, set the Dialled Number field of the routing condition to the Visual Voicemail pilot number for the publisher server.
–In the second rule, set the Dialled Number field of the routing condition to the Visual Voicemail pilot number for the subscriber server.
You do not need to do this configuration on the subscriber server because the rules are replicated to the subscriber server.
•Create one Visual Voicemail service on the Cisco Unified Communications Manager server. Use the cluster DNS alias as the hostname in the following fields:
–Service URL of the service
–Default Value of the voicemail_server parameter
The term cluster DNS alias refers to two Cisco Unity Connection servers that work together as a cluster, that is, both servers actively accept calls and web service requests from Visual Voicemail.
When you use the cluster DNS alias for the voicemail_server parameter, the Visual Voicemail application uses the Cisco Unity Connection servers in a round robin order. When a user signs in to the Visual Voicemail application, the Cisco Unity Connection server that is used automatically provides the hostname of the partner server to the Visual Voicemail application. The partner hostname is cached locally by the Visual Voicemail application and is used in failover scenarios when the original server is not available.
If you want to configure security for Visual Voicemail, you must do the following:
•Add the use_secure_https_connection parameter to the Visual Voicemail service on the Cisco Unified Communications Manager server.
•Obtain a certificate for Visual Voicemail on each Cisco Unity Connection server.
•Add the certificates for each Cisco Unity Connection server to Cisco Unified Communications Manager and to the phones.
For more information about clusters of publisher and subscriber Cisco Unity Connection servers in an active-active configuration, navigate to the Design Guide for Cisco Unity Connection from the following URL:
http://www.cisco.com/en/US/products/ps6509/tsd_products_support_design.html
For more information about using a Cisco Unity Connection cluster, as well as information on how a Connection cluster works, navigate to the Cluster Configuration and Administration Guide for Cisco Unity Connection from the following URL:
http://www.cisco.com/en/US/products/ps6509/prod_maintenance_guides_list.html
Balancing Web Service Requests Between Servers in an Active-Active Configuration
To balance web service requests equally between two Cisco Unity Connection servers, use DNS aliasing. To do this, you must add two DNS Host(A) records as follows:
•Host Name = unityCxnCluster IP Address : IP address of primary server
•Host Name = unityCxnCluster IP Address : IP address of secondary server
If you add these two records, DNS queries for the cluster DNS alias unityCxnCluster resolve alternately between the two IP addresses.
For more information about balancing web service requests between servers in an active-active configuration, navigate to the Design Guide for Cisco Unity Connection from the following URL:
http://www.cisco.com/en/US/products/ps6509/tsd_products_support_design.html
Use of Ports by Visual Voicemail
Visual Voicemail always works with the server that is assigned by the IP resolution of the cluster DNS alias. If all ports are busy on the server, Visual Voicemail does not attempt to use the ports on the partner server. Users might observe that their Cisco Unified IP Phone dials the voicemail pilot number, but then they hear the busy tone.
This behavior is different from the telephone user interface (TUI), where the ports from the partner server are used.
Related Topics
•How to Create Voicemail Pilot Numbers, Hunt Pilots, Line Groups, and Hunt Lists, page 2-2
•How to Install and Configure Voicemail Web Services, page 2-5
•How to Configure Reverse TRaP Rules, page 2-7
•How to Add the Visual Voicemail Service in Cisco Unified Communications Manager, page 2-9
•Adding the Security Service Parameter to the Visual Voicemail Service, page 3-2
•How to Obtain a Certificate for Visual Voicemail on Cisco Unity, page 3-2
•Uploading Certificates to Cisco Unified Communications Manager, page 3-6
Configuration of Multiple Cisco Unity Connection Clusters Integrated with One Cisco Unified Communications Manager Server
To configure Visual Voicemail on a system where multiple Cisco Unity Connection clusters are integrated with one Cisco Unified Communications Manager server, you must do the following:
•Create a unique Visual Voicemail pilot number for each Cisco Unity Connection server. Each pilot number must use the correct set of voicemail ports for the particular Cisco Unity Connection server.
•Configure the Cisco Unity Connection settings for the web service on both the publisher and subscriber Cisco Unity Connection servers in each cluster.
When you configure the voicemail web service, enter the appropriate pilot number for each Cisco Unity Connection server in the Pilot Number for TRAP Connections field. This setting has different values on each Cisco Unity Connection server, because you created a different pilot number for each server.
•Configure the reverse TRaP rule on each Cisco Unity Connection server. Use the same Visual Voicemail pilot number in the Dialled Number field on each server.
•Create one Visual Voicemail service on the Cisco Unified Communications Manager server for each cluster. For each Cisco Unified Communications Manager server, use the cluster DNS alias as the hostname of that server in the following fields:
–Service URL of the service
–Default Value of the voicemail_server parameter
Each service must have the same value in the Service Name field, because this value must match the value in the .jad file. Cisco Unified Communications Manager allows you to create multiple services with the same name. You can use the Service Description field to distinguish between the services.
When you use the cluster DNS alias for the voicemail_server parameter, the Visual Voicemail application uses the Cisco Unity Connection servers in that cluster in a round robin order. When a user signs in to the Visual Voicemail application, the Cisco Unity Connection server that is used automatically provides the hostname of the partner server to the Visual Voicemail application. The partner hostname is cached locally by the Visual Voicemail application and is used in failover scenarios when the original server is not available.
If you want to configure security for Visual Voicemail, you must do the following:
•Add the use_secure_https_connection parameter to each Visual Voicemail service on the Cisco Unified Communications Manager server.
•Obtain a certificate for Visual Voicemail on each Cisco Unity Connection server.
•Add the certificates for each Cisco Unity Connection server to Cisco Unified Communications Manager and to the phones.
Related Topics
•How to Create Voicemail Pilot Numbers, Hunt Pilots, Line Groups, and Hunt Lists, page 2-2
•How to Install and Configure Voicemail Web Services, page 2-5
•How to Configure Reverse TRaP Rules, page 2-7
•How to Add the Visual Voicemail Service in Cisco Unified Communications Manager, page 2-9
•Adding the Security Service Parameter to the Visual Voicemail Service, page 3-2
•How to Obtain a Certificate for Visual Voicemail on Cisco Unity, page 3-2
•Uploading Certificates to Cisco Unified Communications Manager, page 3-6
Configuration of One Cisco Unity Connection Server Integrated with Multiple Cisco Unified Communications Manager Servers
To configure Visual Voicemail on a system where one Cisco Unity Connection server is integrated with multiple Cisco Unified Communications Manager servers, you must do the following:
•Create a Visual Voicemail pilot number on each Cisco Unified Communications Manager server. You must use the same directory number for the pilot number on each Cisco Unified Communications Manager server.
•Configure the Cisco Unity Connection settings for the web service on the Cisco Unity Connection server.
•Configure the reverse TRaP rule on the Cisco Unity Connection server. Use the Visual Voicemail pilot number in the Dialled Number field on the server.
Because there is only one Cisco Unity Connection server, there is only one reverse TRaP rule. The reverse TRaP rule can only match one directory number as the Dialled Number. This is the reason why you must use the same directory number for the pilot number on each Cisco Unified Communications Manager server.
•Create a Visual Voicemail service on each Cisco Unified Communications Manager server. On each server, use the hostname of the Cisco Unity Connection server in the following fields:
–Service URL of the service
–Default Value of the voicemail_server parameter
If you want to configure security for Visual Voicemail, you must do the following:
•Add the use_secure_https_connection parameter to the Visual Voicemail service on each Cisco Unified Communications Manager server.
•Obtain a certificate for Visual Voicemail on the Cisco Unity Connection server.
•Add the certificate for the Cisco Unity Connection server to each Cisco Unified Communications Manager and to the phones.
Related Topics
•How to Create Voicemail Pilot Numbers, Hunt Pilots, Line Groups, and Hunt Lists, page 2-2
•How to Install and Configure Voicemail Web Services, page 2-5
•How to Configure Reverse TRaP Rules, page 2-7
•How to Add the Visual Voicemail Service in Cisco Unified Communications Manager, page 2-9
•Adding the Security Service Parameter to the Visual Voicemail Service, page 3-2
•How to Obtain a Certificate for Visual Voicemail on Cisco Unity, page 3-2
•Uploading Certificates to Cisco Unified Communications Manager, page 3-6