Step 2
Use a text editor to edit the DistinctiveRinglist.xml file. See
Custom Ring File Formats, on page 80
for
information about how to format this file and for a sample DistinctiveRinglist.xml file.
Step 3
Save your modifications and close the DistinctiveRinglist.xml file.
Step 4
To cache the new DistinctiveRinglist.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).
Custom Ring File Formats
The DistinctiveRinglist.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>
<DisplayName/>
<FileName/>
</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 DistinctiveRinglist.xml file that defines two phone ring types:
<CiscoIPPhoneRingList>
<Ring>
<DisplayName>Analog Synth 1</DisplayName>
<FileName>Analog1.raw</FileName>
</Ring>
<Ring>
<DisplayName>Analog Synth 2</DisplayName>
<FileName>Analog2.raw</FileName>
</Ring>
</CiscoIPPhoneRingList>
The PCM files for the rings must meet the following requirements for proper playback on Cisco IP Phones:
•
Raw PCM (no header)
•
8000 samples per second
Cisco Unified IP Phone 8941 and 8945 Administration Guide for Cisco Unified Communications Manager 10.0
(SCCP and SIP)
80
Custom Phone Rings