Cisco CallManager Administration Guide, Release 3.1(1)
Music On Hold Configuration

Table Of Contents

Music On Hold Configuration

Configuring Music On Hold Audio Sources

Adding a Music On Hold Audio Source

Updating a Music On Hold Audio Source

Copying a Music On Hold Audio Source

Deleting a Music On Hold Audio Source

Configuring the Music On Hold Fixed Audio Source

Music On Hold Audio Source Configuration Settings

Configuring Music On Hold Servers

Adding a Music On Hold Server

Updating a Music On Hold Server

Copying a Music On Hold Server

Deleting a Music On Hold Server

Resetting a Music On Hold Server

Music On Hold Server Configuration Settings


Music On Hold Configuration


The integrated Music On Hold feature provides the ability to place on-net and off-net users on hold with music streamed from a streaming source. This feature includes the following actions:

End user hold

Network hold, which includes transfer hold, conference hold, and park hold

Music On Hold configuration comprises configuration of Music On Hold audio sources and Music On Hold servers.

Use the following topics to configure Music On Hold:

Configuring Music On Hold Audio Sources

Configuring Music On Hold Servers

Related Topics

Chapter 28, "Media Resource Group Configuration"

Chapter 29, "Media Resource Group List Configuration"

Configuring Music On Hold Audio Sources

Use the following topics to configure Music On Hold audio sources:

Adding a Music On Hold Audio Source

Updating a Music On Hold Audio Source

Copying a Music On Hold Audio Source

Deleting a Music On Hold Audio Source

Configuring the Music On Hold Fixed Audio Source

Music On Hold Audio Source Configuration Settings

Related Topics

Configuring Music On Hold Servers

Adding a Music On Hold Audio Source

Perform the following procedure to add a Music On Hold audio source.

Procedure


Step 1 Open Cisco CallManager Administration.

Step 2 Choose Service > Music On Hold.

The Music On Hold (MOH) Audio Source Configuration window displays. The MOH Audio Source: New (New) title displays with a Status: Ready indicator.

Step 3 Choose <Add new MOH Audio Source> in the MOH Audio Sources list.

Step 4 Enter the appropriate settings as described in Table 27-2. At any point, click the Cancel Changes button to clear all input if necessary.

Step 5 Click Insert.

The Status changes from Ready to Insert completed. The MOH Audio Sources list now includes the new Music On Hold audio source.


Note The MOH Audio Source File Status pane tells you about the MOH audio translation status for the added source.



Related Topics

Updating a Music On Hold Audio Source

Copying a Music On Hold Audio Source

Deleting a Music On Hold Audio Source

Music On Hold Audio Source Configuration Settings

Audio Sources for Music On Hold, Cisco CallManager System Guide

Music On Hold Configuration Checklist, Cisco CallManager System Guide

Updating a Music On Hold Audio Source

Perform the following procedure to update an existing Music On Hold audio source.


Note If a new version of an audio source file is available, you must perform this update procedure to use the new version.


Procedure


Step 1 Open Cisco CallManager Administration.

Step 2 Choose Service > Music On Hold.

The Music On Hold (MOH) Audio Source Configuration window displays. The MOH Audio Source: New (New) title displays with a Status: Ready indicator.

Step 3 From the MOH Audio Sources list, choose an existing Music On Hold audio source.

The MOH Audio Source title displays the name of the chosen Music On Hold Audio Source. The fields below the MOH Audio Source title display the previously defined values for this Music On Hold audio source.

Step 4 Update the desired settings as described in Table 27-2. At any point, click the Cancel Changes button to clear all new input and revert to the previous settings if necessary.

Step 5 Click Update.

The Status changes from Ready to Update completed. The MOH Audio Sources list shows the updated Music On Hold audio source as highlighted.


Related Topics

Adding a Music On Hold Audio Source

Copying a Music On Hold Audio Source

Deleting a Music On Hold Audio Source

Music On Hold Audio Source Configuration Settings

Audio Sources for Music On Hold, Cisco CallManager System Guide

Music On Hold Configuration Checklist, Cisco CallManager System Guide

Copying a Music On Hold Audio Source

Perform the following procedure to copy an existing Music On Hold audio source.

Procedure


Step 1 Open Cisco CallManager Administration.

Step 2 Choose Service > Music On Hold.

The Music On Hold (MOH) Audio Source Configuration window displays. The MOH Audio Source: New (New) title displays with a Status: Ready indicator.

Step 3 From the MOH Audio Sources list, choose an existing Music On Hold audio source.

The MOH Audio Source title displays the name of the chosen Music On Hold audio source. The fields below the MOH Audio Source title display the previously defined values for this Music On Hold audio source.

Step 4 Click the Copy button.

The MOH Audio Source title changes to indicate that a new MOH audio source is being added and is a copy of an existing MOH audio source.

Step 5 Update the desired settings as described in Table 27-2. At any point, click the Cancel Changes button to clear all new input and revert to the previous settings if necessary.


Note You must change the MOH Audio Source Name to a unique name and choose a new MOH Audio Stream Number.


Step 6 Click Update.

The Status changes from Ready to Insert completed. The MOH Audio Sources list shows the new Music On Hold audio source as highlighted.


Related Topics

Adding a Music On Hold Audio Source

Updating a Music On Hold Audio Source

Deleting a Music On Hold Audio Source

Music On Hold Audio Source Configuration Settings

Audio Sources for Music On Hold, Cisco CallManager System Guide

Music On Hold Configuration Checklist, Cisco CallManager System Guide

Deleting a Music On Hold Audio Source

Perform the following procedure to delete an existing Music On Hold audio source.


Note You cannot delete an audio source that is used by a device pool or by an individual device.


Procedure


Step 1 Open Cisco CallManager Administration.

Step 2 Choose Service > Music On Hold.

The Music On Hold (MOH) Audio Source Configuration window displays. The Music On Hold Audio Source: New (New) title displays with a Status: Ready indicator.

Step 3 From the MOH Audio Sources list, choose an existing Music On Hold audio source.

The Music On Hold Audio Source title displays the name of the chosen Music On Hold audio source. The fields below the MOH Audio Source title display the previously defined values for this Music On Hold audio source.

Step 4 Click the Delete button.

A popup window displays the following warning:

You are about to permanently delete this Music On Hold Audio Source. This action cannot be undone.

Continue?

Step 5 Click OK.

The chosen Music On Hold audio source no longer appears on the MOH Audio Sources list. The Status changes from Ready to Delete completed.


Related Topics

Adding a Music On Hold Audio Source

Updating a Music On Hold Audio Source

Copying a Music On Hold Audio Source

Music On Hold Audio Source Configuration Settings

Audio Sources for Music On Hold, Cisco CallManager System Guide

Music On Hold Configuration Checklist, Cisco CallManager System Guide

Configuring the Music On Hold Fixed Audio Source

Perform the following procedure to configure the Music On Hold fixed audio source.

Procedure


Step 1 Open Cisco CallManager Administration.

Step 2 Choose Service > Music On Hold.

The Music On Hold (MOH) Audio Source Configuration window displays. The MOH Audio Source: New (New) title displays with a Status: Ready indicator.

Step 3 From the MOH Audio Sources list, choose the Fixed Audio Source.


Note The list always shows Fixed Audio Source as the last audio source in the list of MOH Audio Sources and always as audio source 51.


The Music On Hold (MOH) Fixed Audio Source Configuration window displays. The MOH Fixed Audio Source title displays with a Status: Ready indicator. The MOH Fixed Audio Source title displays the name of the Music On Hold Fixed Audio Source. The fields below the MOH Audio Source title display the previously defined values for the Music On Hold fixed audio source.

Step 4 Update the desired settings as described in Table 27-1. At any point, click the Cancel Changes button to clear all new input and revert to the previous settings if necessary.

Table 27-1 Music On Hold Fixed Audio Source Configuration Settings 

Field
Description

MOH Fixed Audio Source Information

MOH Fixed Audio Source Name

Enter a unique name in this required field for the MOH fixed audio source. This name can comprise up to 50 characters. Valid characters include letters, numbers, spaces, dashes, dots (periods), and underscores.

MOH Fixed Audio Source Device

Enter the name for the audio device interface on a PC that is used to play the fixed audio source.

Note The name must match exactly the device name of the device that is already installed.

Allow Multicasting

To specify that the MOH fixed audio source allows multicasting, check this check box.

Note Changes to the multicast setting take effect immediately if at least one MOH server has already been configured for multicast. Otherwise, changes take effect only after you reset MOH servers by clicking the Reset MOH Servers button. If no MOH servers are configured for multicast, resetting has no effect.

MOH Server Reset Information

To reset all MOH Servers, click the Reset MOH Servers button.

Cisco CallManager makes Music On Hold unavailable while the servers reset.


Step 5 Click Update to update the Music On Hold fixed audio source or click Delete to disable the Music On Hold fixed audio source.

If you clicked Update, the Status changes from Ready to Update completed, and the MOH Audio Sources list shows the updated Music On Hold fixed audio source as highlighted. If you clicked Delete, the MOH Audio Sources list shows the MOH fixed audio source labeled as (Disabled).


Related Topics

Adding a Music On Hold Audio Source

Updating a Music On Hold Audio Source

Copying a Music On Hold Audio Source

Deleting a Music On Hold Audio Source

Music On Hold Audio Source Configuration Settings

Audio Sources for Music On Hold, Cisco CallManager System Guide

Music On Hold Configuration Checklist, Cisco CallManager System Guide

Music On Hold Audio Source Configuration Settings

Table 27-2 describes the configuration settings used for configuring Music On Hold Audio Sources.

Table 27-2 Music On Hold Audio Source Configuration Settings 

Field
Description

MOH Audio Source Information

MOH Audio Stream Number

Use this required field to choose the stream number for this MOH audio source. To do so, click the drop-down arrow and choose a value from the list displayed. For existing MOH audio sources, this value displays in the MOH Audio Source title.

MOH Audio Source File

Use this required field to choose the file for this MOH audio source. To do so, click the drop-down arrow and choose a value from the list displayed.

MOH Audio Source Name

Enter a unique name in this required field for the MOH audio source. This name can comprise up to 50 characters. Valid characters include letters, numbers, spaces, dashes, dots (periods), and underscores.

Play continuously (repeat)

To specify continuous play of this MOH audio source, check this check box.

Note Cisco recommends checking this check box. If continuous play of an audio source is not specified, only the first party placed on hold, not additional parties, will receive the MOH audio source.

Allow Multicasting

To specify that this MOH audio source allows multicasting, check this check box.

MOH Audio Source File Status

Display only. This pane displays information about the source file for a chosen MOH audio source. For an MOH audio source, the following attributes display:

Input File Name

Error Code

Error Text

Low Date Time

High Date Time

Output File List

ULAW wav file name and status

ALAW wav file name and status

G.729 wav file name and status

Wideband wav file name and status

Time MOH Audio Translation completed

MOH Server Reset Information

To reset all MOH servers, click the Reset MOH Servers button.

Note Cisco CallManager makes Music On Hold unavailable while the servers reset.


Related Topics

Adding a Music On Hold Audio Source

Updating a Music On Hold Audio Source

Copying a Music On Hold Audio Source

Audio Sources for Music On Hold, Cisco CallManager System Guide

Music On Hold Configuration Checklist, Cisco CallManager System Guide

Configuring Music On Hold Servers

Use the following topics to configure Music On Hold servers:

Adding a Music On Hold Server

Updating a Music On Hold Server

Copying a Music On Hold Server

Deleting a Music On Hold Server

Resetting a Music On Hold Server

Music On Hold Server Configuration Settings

For any Music On Hold server that you configure, you may trace the configuration of that server. Refer to the Cisco CallManager Serviceability Administration Guide for more information.

Related Topics

Configuring Music On Hold Audio Sources

Cisco CallManager Serviceability Administration Guide

Adding a Music On Hold Server

Perform the following procedure to add a Music On Hold server.

Procedure


Step 1 Open Cisco CallManager Administration.

Step 2 Choose Service > Music On Hold.

The Music On Hold (MOH) Audio Source Configuration window displays.

Step 3 Click Configure Music On Hold Servers.

The Music On Hold (MOH) Server Configuration window displays. The Music On Hold Server: New title displays with a Status: Ready indicator.

Step 4 Choose <Add new Music On Hold Server> in the MOH Servers list.

Step 5 Enter the appropriate settings as described in Table 27-3. At any point, click the Cancel Changes button to clear all input if necessary.

Step 6 Click Insert.

The Status changes from Ready to Insert completed. The MOH Servers list now includes the new Music On Hold server.


Related Topics

Updating a Music On Hold Server

Copying a Music On Hold Server

Deleting a Music On Hold Server

Resetting a Music On Hold Server

Music On Hold Server Configuration Settings

Understanding Music On Hold, Cisco CallManager System Guide

Music On Hold Server, Cisco CallManager System Guide

Music On Hold Configuration Checklist, Cisco CallManager System Guide

Cisco CallManager Serviceability Administration Guide

Updating a Music On Hold Server

Perform the following procedure to update an existing Music On Hold server.

Procedure


Step 1 Open Cisco CallManager Administration.

Step 2 Choose Service > Music On Hold.

The Music On Hold (MOH) Audio Source Configuration window displays.

Step 3 Click Configure Music On Hold Servers.

The Music On Hold (MOH) Server Configuration window displays. The Music On Hold Server: New title displays with a Status: Ready indicator.

Step 4 Choose an existing Music On Hold server from the MOH Servers list.

The Music On Hold Server title displays the name of the chosen Music On Hold server. The fields below display the previously defined values for this Music On Hold server.

Step 5 Update the desired settings as described in Table 27-3. At any point, click the Cancel Changes button to clear all new input and revert to the previous settings if necessary.

Step 6 Click Update.

The Status changes from Ready to Update completed. The MOH Servers list shows the updated Music On Hold server as highlighted.


Related Topics

Adding a Music On Hold Server

Copying a Music On Hold Server

Deleting a Music On Hold Server

Resetting a Music On Hold Server

Music On Hold Server Configuration Settings

Understanding Music On Hold, Cisco CallManager System Guide

Music On Hold Server, Cisco CallManager System Guide

Music On Hold Configuration Checklist, Cisco CallManager System Guide

Cisco CallManager Serviceability Administration Guide

Copying a Music On Hold Server

Perform the following procedure to copy an existing Music On Hold server.

Procedure


Step 1 Open Cisco CallManager Administration.

Step 2 Choose Service > Music On Hold.

The Music On Hold (MOH) Audio Source Configuration window displays.

Step 3 Click Configure Music On Hold Servers.

The Music On Hold (MOH) Server Configuration window displays. The Music On Hold Server: New title displays with a Status: Ready indicator.

Step 4 Choose an existing Music On Hold server from the MOH Servers list.

The Music On Hold Server title displays the name of the chosen Music On Hold server. The fields below the Music On Hold server title display the previously defined values for this Music On Hold server.

Step 5 Click the Copy button.

Step 6 Update the desired settings as described in Table 27-3. At any point, click the Cancel Changes button to clear all new input and revert to the previous settings if necessary.


Note You must change at least the Music On Hold Server Name. You must also select a different server (node).


Step 7 Click Insert.

The Status changes from Ready to Insert completed. The MOH Servers list shows the new Music On Hold server as highlighted.


Related Topics

Adding a Music On Hold Server

Updating a Music On Hold Server

Deleting a Music On Hold Server

Resetting a Music On Hold Server

Music On Hold Server Configuration Settings

Understanding Music On Hold, Cisco CallManager System Guide

Music On Hold Server, Cisco CallManager System Guide

Music On Hold Configuration Checklist, Cisco CallManager System Guide

Cisco CallManager Serviceability Administration Guide

Deleting a Music On Hold Server

Perform the following procedure to delete an existing Music On Hold server.


Note You must remove a Music On Hold server from any media resource groups that include the server before you can delete the Music On Hold server.


Procedure


Step 1 Open Cisco CallManager Administration.

Step 2 Choose Service > Music On Hold.

The Music On Hold (MOH) Audio Source Configuration window displays.

Step 3 Click Configure Music On Hold Servers.

The Music On Hold (MOH) Server Configuration window displays. The Music On Hold Server: New title displays with a Status: Ready indicator.

Step 4 Choose an existing Music On Hold server from the MOH Servers list.

The Music On Hold Server title displays the name of the chosen Music On Hold server. The fields below the Music On Hold server title display the previously defined values for this Music On Hold server.

Step 5 Click the Delete button.

A popup window displays the following warning:

You are about to permanently delete this Music On Hold Server. This action cannot be undone.

Continue?

Step 6 Click OK.

The chosen Music On Hold server no longer appears on the MOH Servers list. The Status changes from Ready to Delete completed.


Related Topics

Adding a Music On Hold Server

Updating a Music On Hold Server

Copying a Music On Hold Server

Resetting a Music On Hold Server

Music On Hold Server Configuration Settings

Understanding Music On Hold, Cisco CallManager System Guide

Music On Hold Server, Cisco CallManager System Guide

Music On Hold Configuration Checklist, Cisco CallManager System Guide

Cisco CallManager Serviceability Administration Guide

Resetting a Music On Hold Server

Perform the following procedure to reset an existing Music On Hold server.

Procedure


Step 1 Open Cisco CallManager Administration.

Step 2 Choose Service > Music On Hold.

The Music On Hold (MOH) Audio Source Configuration window displays.

Step 3 Click Configure Music On Hold Servers.

The Music On Hold (MOH) Server Configuration window displays. The Music On Hold Server: New title displays with a Status: Ready indicator.

Step 4 Choose an existing Music On Hold server from the MOH Servers list.

The Music On Hold Server title displays the name of the chosen Music On Hold server. The fields below the Music On Hold server title display the previously defined values for this Music On Hold server.

Step 5 Click the Reset button.

A popup window displays the following warning:

This will reset the MOH Server. Calls currently on Hold using this MOH Server will no longer hear the audio. Continue?

Step 6 Click OK.

A popup window displays the following message:

The MOH Server is being reset.

Step 7 Click OK.

Cisco CallManager resets the chosen Music On Hold server. The MOH Servers list shows the reset Music On Hold server as highlighted.


Related Topics

Adding a Music On Hold Server

Updating a Music On Hold Server

Copying a Music On Hold Server

Deleting a Music On Hold Server

Music On Hold Server Configuration Settings

Understanding Music On Hold, Cisco CallManager System Guide

Music On Hold Server, Cisco CallManager System Guide

Music On Hold Configuration Checklist, Cisco CallManager System Guide

Cisco CallManager Serviceability Administration Guide

Music On Hold Server Configuration Settings

Table 27-3 describes the configuration settings used for configuring Music On Hold servers.

Table 27-3 Music On Hold Server Configuration Settings 

Field
Description

Device Information

Host Server

Use this required field to choose a host server for the Music On Hold server. To do so, click the drop-down arrow and choose a server from the list displayed. For existing Music On Hold servers, this field is display only.

Music On Hold Server Name

Enter a unique name in this required field for the Music On Hold server. This name can comprise up to 15 characters. Valid characters include letters, numbers, spaces, dashes, dots (periods), and underscores.

Description

Enter a description for the Music On Hold server. This description can comprise up to 50 characters. Ensure Description does not contain ampersand (&), double quotes ("), brackets ([]), less than (<), greater than (>), or the percent sign (%).

Device Pool

Use this required field to choose a device pool for the Music On Hold server. To do so, click the drop-down arrow and choose a device pool from the list displayed.

Maximum Half Duplex Streams

Enter a number in this required field for the maximum number of half-duplex streams that this Music On Hold server supports. Valid values range from 0 to 500.

Maximum Multicast Connections

Enter a number in this required field for the maximum number of multicast connections that this Music On Hold server supports. Valid values range from 0 to 999999.

Fixed Audio Source Device

Enter the device name of the fixed audio source device. This device serves as the per-server override used if the server has a special sound device installed.

Run Flag

Use this required field to choose a run flag for the Music On Hold server. To do so, click the drop-down arrow and choose Yes or No.

Multicast Audio Source Information

Enable Multicast Audio Sources on this MOH Server

Check or uncheck this check box to enable or disable multicast of audio sources for this Music On Hold server.

Note If this MOH server belongs to a multicast media resource group, a message asks you to enable multicast on this MOH server or to update the specified media resource group(s) either by removing this MOH server or by changing the multicast setting of each group listed.

Base Multicast IP Address

If multicast support is needed, enter the base multicast IP address in this field. Valid IP addresses for multicast range from 224.0.1.0 to 239.255.255.255.

Note IP addresses between 224.0.1.0 and 238.255.255.255 fall in the reserved range of IP multicast addresses for public multicast applications. Use of such addresses may interfere with existing multicast applications on the Internet. Cisco strongly recommends using IP addresses in the range reserved for administratively controlled applications on private networks (239.0.0.0 - 239.255.255.255).

Note Multicast by IP address is preferable in firewall situations.

Base Multicast Port Number

If multicast support is needed, enter the base multicast port number in this field. Valid multicast port numbers include even numbers that range from 16384 to 32767.

Increment Multicast on

Click Port Number to increment multicast on port number.

Click IP Address to increment multicast on IP address.

Selected Multicast Audio Sources

Note Only audio sources for which the Allow Multicasting check box was checked appear in this listing.

No.

Display only. This field designates Music On Hold audio stream number associated with a particular multicast audio source. Only audio sources defined as allowing multicasting display.

Audio Source Name

Display only. This field designates name of audio source defined as allowing multicasting.

Max Hops

For each multicast audio source, enter the maximum number of router hops through which multicast packets should pass. Valid values range from 1 to 15.

Note Using high values can lead to network saturation. This field is also known as Time to Live.


Related Topics

Adding a Music On Hold Server

Updating a Music On Hold Server

Copying a Music On Hold Server

Resetting a Music On Hold Server

Understanding Music On Hold, Cisco CallManager System Guide

Music On Hold Server, Cisco CallManager System Guide

Music On Hold Configuration Checklist, Cisco CallManager System Guide

Cisco CallManager Serviceability Administration Guide