Custom Ring File Formats - Cisco 7821 Administration Manual

Custom Phone Rings
Procedure
Step 1 Create a PCM file for each custom ring (one ring per file). Ensure the PCM files comply with the format
guidelines that are listed in the Custom Ring File Formats section.
Step 2
Upload the new PCM files that you created to the Cisco TFTP server for each Cisco Unified Communications
Manager in your cluster. For more information, see the "Software Upgrades" chapter in Cisco Unified
Communications Operating System Administration Guide.
Step 3 Use a text editor to edit the Ringlist.xml file. See Custom Ring File Formats section for information about
how to format this file and for a sample Ringlist.xml file.
Step 4 Save your modifications and close the Ringlist.xml file.
Step 5 To cache the new Ringlist.xml file, stop and start the TFTP service by using Cisco Unified Serviceability or
disable and reenable the "Enable Caching of Constant and Bin Files at Startup" TFTP service parameter,
located in the Advanced Service Parameters area.

Custom Ring File Formats

The Ringlist-wb.xml file defines an XML object that contains a list of phone ring types. This file includes up
to 50 ring types. Each ring type contains a pointer to the PCM file that is used for that ring type and the text
that appears on the Ring Type menu on a Cisco IP Phone for that ring. The Cisco TFTP server for each Cisco
Unified Communications Manager contains this file.
The CiscoIPPhoneRinglist XML object uses the following simple tag set to describe the information:
<CiscoIPPhoneRingList>
<Ring>
</Ring>
</CiscoIPPhoneRingList>
The following characteristics apply to the definition names. You must include the required DisplayName and
FileName for each phone ring type.
• DisplayName specifies the name of the custom ring for the associated PCM file that displays on the
Ring Type menu of the Cisco IP Phone.
• FileName specifies the name of the PCM file for the custom ring to associate with DisplayName.
The DisplayName and FileName fields must not exceed 25 characters in length.
Note
This example shows a Ringlist-WB.xml file that defines two phone ring types:
<CiscoIPPhoneRingList>
<Ring>
</Ring>
Cisco IP Phone 7821, 7841, and 7861 Administration Guide for Cisco Unified Communications Manager 10.0
(SIP)
88
<DisplayName/>
<FileName/>
<DisplayName>Analog Synth 1</DisplayName>
<FileName>Analog1.raw</FileName>