Jun 02

Migrating IP Phone Background Images

During CUCM upgrades we must ensure we migrate all the background images that were available on the existing CUCM to the new. The List.xml will tell us how many images and their file names are currently in use. For every type of phone, there is a List.xml file, tis is becuase of the different screen sizes for the phones. So ensure you  download all images and List.xml files for all your phone types.

1. Find and download the List.xml file for each of the phone types. To do this we need an SFTP Server on the network.

Log into the CLI on the Pub CUCM and for 7945/7965 phones type the following:

admin: file list tftp /Desktops/320x212x16

This verifies that there is a List.xml file and also contains image files.

Now download the List.xml. I have included the wizards steps to complete the transfer.

admin:file get tftp Desktops/320x212x16/List.xml

Please wait while the system is gathering files info …done.

Sub-directories were not traversed.

Number of files affected: 1

Total size in Bytes: 167

Total size in Kbytes: 0.16308594

Would you like to proceed [y/n]? y

SFTP server IP: 10.1.1.1

SFTP server port [22]: {ENTER}

User ID: cucm

Password: *********

Download directory: /

The authenticity of host ’10.98.231.126 (10.1.1.1)’ can’t be established. RSA key fingerprint is 85:27:6e:f4:e2:71:8a:c5:70:f4:38:c0:f2:aa:c9:76. Are you sure you want to continue connecting (yes/no)? yes .

Transfer completed

2. Lets open the List.xml File to view the contents.

- <CiscoIPPhoneImageList>

<ImageItem Image=”TFTP:Desktops/320x212x16/phone-pic-tn.png” URL=”TFTP:Desktops/320x212x16/phone-pic.png” />

</CiscoIPPhoneImageList>

From this xml we can see there is only a single background image. Each background image contain two files. The first referenced image is the thumbnail image 80×53 and the second is the Full 320×212 image.

3. Download the background images.

admin: file get tftp /Desktops/320x212x16/phone-pic-tn.png
admin: file get tftp /Desktops/320x212x16/phone-pic.png

4. Upload the List.xml to the new CUCM. If background images wre already configured on the new CUCM, you would need to download the List.xml and add the above XML lines to the List.xml file. This would then give the phone users additional background images to select from. We perform the upload action from CUCM OS Administration Page under Software Upgrades -> TFTP File Management

Ensure the Directory is /Desktops/320x212x16

5. Restart the TFTP Server for the background images to be displayed on the IP Phones. This is done on the Cisco Unified Serviceability Page -> Tools -> Control Center – Feature Services.

6. Select the background image from the IP Phone by selecting Settings -> User Preferences -> Background Images.

A full list of the exact background image sizes can be found on the Cisco.com website.