Cisco Unified Communications Manager System Guide, Release 7.1(2)
Annunciator
Downloads: This chapterpdf (PDF - 143.0KB) The complete bookPDF (PDF - 13.12MB) | Feedback

Annunciator

Table Of Contents

Annunciator

Annunciator Configuration Checklist

Understanding Annunciators

Planning Your Annunciator Configuration

Annunciator System Requirements and Limitations

Supported Tones and Announcements

Dependency Records

Annunciator Performance Monitoring and Troubleshooting

Where to Find More Information


Annunciator


An annunciator, an SCCP device that uses the Cisco IP Voice Media Streaming Application service, enables Cisco Unified Communications Manager to play prerecorded announcements (.wav files) and tones to Cisco Unified IP Phones, gateways, and other configurable devices. The annunciator, which works with Cisco Unified Communications Manager Multilevel Precedence and Preemption, enables Cisco Unified Communications Manager to alert callers as to why the call fails. Annunciator can also play tones for some transferred calls and some conferences.

This section covers the following topics:

Annunciator Configuration Checklist

Understanding Annunciators

Planning Your Annunciator Configuration

Annunciator System Requirements and Limitations

Supported Tones and Announcements

Dependency Records

Annunciator Performance Monitoring and Troubleshooting

Where to Find More Information

Annunciator Configuration Checklist

An annunciator, an SCCP device that uses the Cisco IP Voice Media Streaming Application service, enables Cisco Unified Communications Manager to play prerecorded announcements (.wav files) and tones to Cisco Unified IP Phones, gateways, and other configurable devices. The annunciator, which works with Cisco Unified Communications Manager Multilevel Precedence and Preemption, enables Cisco Unified Communications Manager to alert callers as to why the call fails. Annunciator can also play tones for some transferred calls and some conferences.

Table 24-1 provides a checklist to configure an annunciator. For more information, see the "Where to Find More Information" section.

Table 24-1 Annunciator Configuration Checklist 

Configuration Steps
Procedures and Related Topics

Step 1 

Determine the number of annunciator streams that are needed and the number of annunciators that are needed to provide these streams.

Planning Your Annunciator Configuration

Step 2 

Verify that you have activated the Cisco IP Voice Media Streaming Application service on the server where you want the annunciator to exist.

Cisco Unified Serviceability Administration Guide

Step 3 

Perform additional annunciator configuration tasks if you want to change the default settings.

Annunciator Configuration, Cisco Unified Communications Manager Administration Guide

Step 4 

Add the new annunciators to the appropriate media resource groups and media resource lists.

Media Resource Management, page 23-1

Deleting a Media Resource Group, Cisco Unified Communications Manager Administration Guide

Step 5 

Reset or restart the individual annunciator or all devices that belong to the media resource group/list.

Annunciator System Requirements and Limitations


Understanding Annunciators

In conjunction with Cisco Unified Communications Manager, the annunciator device provides multiple, one-way, RTP stream connections to devices, such as Cisco Unified IP Phones and gateways.

To automatically add an annunciator to the Cisco Unified Communications Manager database, you must activate the Cisco IP Voice Media Streaming Application service on the server where you want the annunciator to exist in the cluster.


Note When you add a server, the annunciator device automatically gets added for the new server. It will remain inactive until the Cisco IP Voice Media Streaming Application service is activated for the new server.


Cisco Unified Communications Manager uses SCCP messages to establish a RTP stream connection between the annunciator and the device. The annunciator plays the announcement or tone to support the following conditions:

Announcement—Devices configured for Cisco Multilevel Precedence and Preemption

Barge tone—Before a participant joins an ad hoc conference

Ring back tone—When you transfer a call over the PSTN through an IOS gateway

Annunciator plays the tone because the gateway cannot play the tone when the call is active.

Ring back tone—When you transfer calls over an H.323 intercluster trunk

Ring back tone—When you transfer calls to the SIP client from a phone that is running SCCP


Tip For specific information about supported announcements and tones, see the "Supported Tones and Announcements" section.


Before the announcement/tone plays, the annunciator reads the following information from the annunciator.xml file in the Cisco Unified Communications Manager database:

The TypeAnnouncements database table, which is read into memory cache to identify each announcement or tone that the annunciator supports.

The user locale identifier for the phone, which is added to the database if you install the Cisco Unified Communications Manager Locale Installer on every server in the cluster

The network locale identifier for the phone or gateway, which is added to the database if you install the Cisco Unified Communications Manager Locale Installer on every server in the cluster

The device settings

The user-configured service parameters

Planning Your Annunciator Configuration

Consider the following information before you plan your annunciator configuration. Use this information in conjunction with the "Annunciator System Requirements and Limitations" section.

Annunciator supports IPv4. If annunciator connects to a device with an IP Addressing Mode of IPv6 Only, Cisco Unified Communications Manager inserts an MTP that can translate IPv4 to IPv6. If no MTP that can translate IP address versions is available, no announcement plays on the phone. For more information on IPv6, refer to "Internet Protocol Version 6 (IPv6)" in the Cisco Unified Communications Manager Features and Services Guide.

For a single annunciator, Cisco Unified Communications Manager sets the default to 48 simultaneous streams, as indicated in the annunciator service parameter for streaming values.


Caution Cisco recommends that you do not exceed 48 annunciator streams on a coresident server where the Cisco Unified Communications Manager and Cisco IP Voice Media Streaming Application services run.

You can change the default to best suit your network. For example, a 100-MB Network/NIC card can support 48 annunciator streams, while a 10-MB NIC card supports up to 24 annunciator streams. The exact number of annunciator streams that are available depends on the factors, such as the speed of the processor and network loading.

If the annunciator runs on a standalone server where the Cisco CallManager service does not run, the annunciator can support up to 255 simultaneous announcement streams.

If the standalone server has dual CPU and a high-performance disk system, the annunciator can support up to 400 simultaneous announcement streams.

Consider the following formula to determine the approximate number of annunciators that you need for your system. This formula assumes that the server can handle the default number of streams (48); you can substitute the default number for the number of streams that your server supports.

n/number of annunciator devices that your server supports

where:

n represents the number of devices that require annunciator support


Tip If a remainder exists in the quotient, consider adding another server to support an additional annunciator device. To perform this task, activate the Cisco IP Voice Media Streaming Application service on another server and update the configuration of the device, if you do not want to use the default settings.


Annunciator System Requirements and Limitations

The following system requirements and limitations apply to annunciator devices:

For one annunciator device, activate only one Cisco IP Voice Media Streaming Application service in the cluster. To configure additional annunciators, you must activate the Cisco IP Voice Media Streaming Application service on additional Cisco Media Convergence Servers or Cisco-approved, third-party servers where Cisco Unified Communications Manager is installed in the cluster.


Caution Cisco strongly recommends that you do not activate the Cisco IP Voice Media Streaming Application service on a Cisco Unified Communications Manager with a high call-processing load.

Annunciator supports IPv4. If annunciator connects to a device with an IP Addressing Mode of IPv6 Only, Cisco Unified Communications Manager inserts an MTP that can translate IPv4 to IPv6. If no MTP that can translate IP address versions is available, no announcement plays on the phone. For more information on IPv6, refer to "Internet Protocol Version 6 (IPv6)" in the Cisco Unified Communications Manager Features and Services Guide.

Each annunciator registers with only one Cisco Unified Communications Manager at a time. The system may have multiple annunciators, depending on your configuration, each of which may register with different Cisco Unified Communications Manager servers.

Each annunciator belongs to a device pool. The device pool associates the secondary (backup) Cisco Unified Communications Manager and the region settings.

Each annunciator can support G.711 a-law, G.711 mu-law, wideband, and G.729 codec formats.

For information on the number of streams that are available for use, see the "Planning Your Annunciator Configuration" section.

To manage the media resources in the cluster, you can add the annunciator to a Media Resource Group, and likewise, a Media Resource List.

When you update the annunciator, the changes automatically occur when the annunciator becomes idle, when no active announcements are played.

Cisco Unified Communications Manager provides annunciator resource support to a conference bridge under the following circumstances:

If the media resource group list that contains the annunciator is assigned to the device pool where the conference bridge exists.

If the annunciator is configured as the default media resource, which makes it available to all devices in the cluster.

Cisco Unified Communications Manager does not provide annunciator resource support for a conference bridge if the media resource group list is assigned directly to the device that controls the conference.


Caution If you configured redundancy between Cisco Unified Communications Manager servers, all announcements that are playing during the failover drop. The annunciator does not preserve announcement streams during Cisco Unified Communications Manager failover.

Supported Tones and Announcements

Cisco Unified Communications Manager automatically provides a set of recorded annunciator announcements when you activate the Cisco IP Media Streaming Application service. No configuration exists to customize these announcements or to add new announcements.

Annunciator announcements, which comprise one or two wav files, support localization if you have installed the Cisco Unified Communications Manager Locale Installer and configured the locale settings for the Cisco Unified IP Phone or, if applicable, the device pool. Each announcement plays in its entirety.

Cisco Unified Communications Manager supports only one announcement per conference. During a conference, if the system requests a new announcement while another announcement currently plays, the new announcement preempts the other announcement.

Annunciator supports the announcements in Table 24-2.

Table 24-2 Announcements 

Condition
Announcement

An equal or higher precedence call is in progress.

Equal or higher precedence calls have prevented the completion of your call. Please hang up and try again. This is a recording.

A precedence access limitation exists.

Precedence access limitation has prevented the completion of your call. Please hang up and try again. This is a recording.

Someone attempted an unauthorized precedence level.

The precedence used is not authorized for your line. Please use an authorized precedence or ask your operator for assistance. This is a recording.

The call appears busy, or the administrator did not configure the directory number for call waiting or preemption.

The number you have dialed is busy and not equipped for call waiting or preemption. Please hang up and try again. This is a recording.

The system cannot complete the call.

Your call cannot be completed as dialed. Please consult your directory and call again or ask your operator for assistance. This is a recording.

A service interruption occurred.

A service disruption has prevented the completion of your call. In case of emergency call your operator. This is a recording.


Annunciator supports the following tones:

Busy tone

Alerting/Ring back tone

Conference barge-in tone

Dependency Records

To find which media resource groups include an annunciator device, choose Dependency Records from the Related Links drop-down list box and click Go. The Dependency Records Summary window displays information about media resource groups that use the annunciator device. To find out more information about the media resource group, click the media resource group, and the Dependency Records Details window displays. If the dependency records are not enabled for the system, the dependency records summary window displays a message.

For more information about Dependency Records, refer to "Accessing Dependency Records" and "Deleting a Media Resource Group" in the Cisco Unified Communications Manager Administration Guide.

Annunciator Performance Monitoring and Troubleshooting

Performance Monitor counters for annunciator allow you to monitor the number of streams that are used, the streams that are currently active, the total number of streams that are available for use, the number of failed annunciator streams, the current connections to the Cisco Unified Communications Manager, and the total number of times a disconnection occurred from the Cisco Unified Communications Manager. When an annunciator stream is allocated or de-allocated, the performance monitor counter updates the statistic. For more information about performance monitor counters, refer to the Cisco Unified Serviceability Administration Guide.

Cisco Unified Communications Manager writes all errors for the annunciator to the Event Viewer. In Cisco Unified Communications Manager Serviceability, you can set traces for the Cisco IP Voice Media Streaming Application service; to troubleshoot most issues, you must choose the Significant or Detail option for the service, not the Error option. Reset trace level to the Error option after you troubleshoot the issue.

Cisco Unified Communications Manager generates registration and connection alarms for annunciator in Cisco Unified Serviceability. For more information on alarms, refer to the Cisco Unified Serviceability Administration Guide.

If you need technical assistance, use the Real-Time Monitoring Tool to retrieve the cms/sdi trace log files before you contact your Cisco Partner or the Cisco Technical Assistance Center (TAC).

Where to Find More Information

Related Topics

Annunciator Configuration Checklist

Understanding Annunciators

Planning Your Annunciator Configuration

Annunciator System Requirements and Limitations

Supported Tones and Announcements

Dependency Records

Annunciator Performance Monitoring and Troubleshooting

Media Resource Management, page 23-1

Internet Protocol Version 6 (IPv6), Cisco Unified Communications Manager Features and Services Guide

Media Resource Group Configuration, Cisco Unified Communications Manager Administration Guide

Multilevel Precedence and Preemption, Cisco Unified Communications Manager Features and Services Guide

Annunciator Configuration, Cisco Unified Communications Manager Administration Guide